Blogs

Welcome to the KBACE blogs where KBACE experts and non-employees exchange views about customer requirements and best practices for using Oracle and industry-standard technologies


The best resolution for recording...

Screen resolution is important to consider for the end user, developer and trainer. 

Recording at the lowest screen resolution available within UPK (1024 x 768) will enable end users still utilizing a low screen resolution the ability to view the simulations without having to scroll left to right or up and down.  Simulations will be viewed in full screen on machines with low resolutions while the content will display within a border on machines with higher resolutions.  This way neither user type is negatively impacted.

Frames cannot be copied into topics recorded using a different resolution so this is an important consideration for maintaining content. 

It is also important to consider how simulations will be used in content delivery.  If an instructor intends to display content to end users on a projector the best resolution is also 1024 x 768 for optimal readability.

How to solve a UPK conflict with SnagIt

Many of us have used some sort of image capturing software like SnagIt, only to run into problems when trying to record in UPK. The reason for the conflict is that both SnagIt and UPK use the same default Print Screen capture command (or "hotkey") The easiest thing to do is exit the SnagIt program if you're using UPK, or vice versa. You could also change the setting in UPK, but I didn't want to do that since I use UPK much more than SnagIt. However, I like having both programs available, and so I changed my SnagIt settings so that they wouldn't conflict with UPK. Here's how to change the hotkey in SnagIt: Go to the Tools menu, and select the Program Preferences command. The Program Preferences window displays with the Hotkeys tab active by default. At this point, you may select any combination of keys as long as it is different from the UPK Print Screen command. As you can see from the image, I use the combination of the CTRL + Print Screen keys when I want to capture an image using SnagIt. After making your changes in the Global Capture hotkey section, click the OK button, and you should be able to record in UPK without launching SnagIt.

Enhancing Tutor Content with Links to UPK Topic Simulations

 

If you've worked with Oracle Tutor, you know that you can enhance the content by adding attachments within Tutor processes, sub-processes and procedures.  To enhance the experience for the end-user, links can be created to learning content created using the User Productivity Kit (UPK).  Linking UPK content within Tutor procedures allows the end-user to review the business process from a high level down to the precise system steps.

For example, within a Tutor procedure, decide where the user touches the system and would benefit by viewing a UPK topic simulating the system steps.  Add a refer to statement to link to the UPK topic playback mode(s) of your choice.  Once you add the link and convert the Tutor documents to HTML, the end-user has the ability to launch the simulation.

Below are three screenshots to show the end to end process. 

1.  The Tutor procedure flow where the end-user has the ability to click on the Update Personal Information image to;

2.  access the refer to statement within the procedure where two playback modes to a UPK topic are linked; and after selecting a playback mode (in this example Try It)

3.  to the UPK Try It mode of that topic.

 

 

 

 

Editing for Know It Mode

In very general terms, Know It mode aims to quiz users on their knowledge of a topic (ideally, the users have reviewed the topic several times in See It and Try It modes). 

Bubble Properties

We want to give users clues and information in order to complete a topic, and the key is to prompt users--not stump them or give the answer outright.  Adding a scenario in the concept pane works as an introduction, but we have found that providing the information as appropriate for each frame works best.  As you might imagine, this is time intensive, so we have developed standard verbiage to accompany many of the actions.

This is a brief introduction to Know It mode, so please email us with any questions.

Happy UPK'ing!

Editing for Try It and Do It Modes

 

 Bubble Properties

When editing UPK content, keep in mind the different playback modes.  Depending on the modes being published, you must edit bubble properties to display appropriate instructions in each mode. 

In Do It mode, text needs to be specific to the step, but general enough for a person to be able to follow the instructions and complete the task using their specific, real data. 

When users select a gender from a drop down list or LOV, they may choose from one or more options.  In Try It mode, users might select the "Male" value to complete the simulation, but in real-life (using Do It mode), they may not select "Male", so we instruct users to select the appropriate gender instead.

Template or Standard Text
Sample See It / Try It Text
Sample Do It Text
Sample Know It Text

Select the Male list item.

In this example,

Select the Male list item.

Select the appropriate gender from the list.

Click the appropriate selection to indicate that this employee is a Male.

Next time, I'll cover Know It mode, in the meantime, Happy UPK'ing!

Self Service Entitlement Balances

After some additional testing, the Entitlement Balances functionality is working fine.  One of our testers discovered note 473272.1 on Metalink which appeared to be similar to our problem.  The issue was resolved by extending our payroll calendar out by another two years. Oracle has logged Bug 5743838 in which part of this issue is described.

The screen shot below show a successful calculation in June 2010 after the extension of the payroll calendar.

Leave Accrual Calculation

  Release 12.1 includes a useful addition to Absence Management. Employees and Managers can now use Self Service to calculate leave accruals based on an effective date. The new tab in the Absence Management function, named "Entitlement Balances", is shown below.

A user simply inputs the desired date and hits the "Go" button.  The accrual is calculated as of the date entered.  This is useful for both employees and managers wishing to view accrual balances on a given date.

This new functionality appears to work well within the current plan year.  Curious to see what would happen if I entered a date in the next year, I tried 01-Jan-2010.  I immediately received an error indicating a problem with a user defined function in the accrual formula "PTO_PAYROLL_CALCULATION". We'll have to take a closer look at this to see what is happening.  I would fully expect someone to try a date far into the future, so we'll need a more graceful ending than a framework error page.

Even with that small issue, the new Entitlement Balances functionality looks like a useful addition to both Employee and Manager Self Service.

Appraisals SR Update

There has been a lot of back and forth between our DBA's and Oracle Support overnight, but so far, we are not much closer to a resolution.  Our initial problem was escalated to development and a bug was logged ( Bug 8553240 ). After our OWC session with development, Oracle sent us a file to place in the Class Path of our test instance.  The idea is that the supplied file will create extra debug statements to help track down the issue.  Unfortunately, the supplied file has not so far generated any information.Luckily, our DBA's have been working closely with our internal Java developers and have passed some suggestions back to Oracle.  We are now waiting for Oracle Development to supply a new Java class file incorporating some of those suggestions.

Desupported libraries (JDBC)

While validating few of our self service customisations after the R12.1 upgrade, we encountered a runtime error, java.lang.IllegalAccessError: tried to access class oracle.jdbc.driver.OraclePreparedStatement from class... 

On little Googling and surfing around Metalink, we landed on Metalink note 335754.1 which stated the reason quite clearly.

"The Oracle Database 10g Release 2 (10.2) will be the last major release to offer the following feature/libraries: classes12.jar, oracle.jdbc.drivers.* and OracleConnectionCacheImpl. In other words these features/libraries will not be available in the next major database release"

With an upgrade to R12.1 tech stack, which includes Oracle Database 11.1.0.7 and JDK6, this was bound to happen.

The best fix to the issue at hand was to edit>recompile>deploy the Java source files after removing/altering the desupported JDBC code. And so we did!

For instance, the following import statement,
import oracle.jdbc.driver.*;

was replaced by 

import oracle.jdbc.*;

 

Appraisals in 12.1 are moving along…sort of

Testing the Appraisals functionality in 12.1 started out smoothly.  I selected the appraisal template, updated competencies, entered performance ratings and goals.  Then I clicked the submit button and it all stopped. I received the standard framework error  "You have encountered an unexpected error. Please contact the System Administrator for assistance. "

A few more tries with a different responsibility, different user, turned off personalizations, etc. Same error on submit.  I have an SR open with Oracle and conducted an OWC session with development today. This is the first "Show Stopper" (for Appraisals)  as far as my testing in 12.1 is concerned. The frustrating part is that the appraisal itself appears to work fine, it might be workflow related. 

I'm hoping for a quick resolution now that Oracle Development is involved and I'll let you know more as the SR progresses. 

Pages