Configuring the Career Worksheet XML

There are seven available standard fields to include in the Career Worksheet, listed in the table below. All field configurations are done through Provisioning in XML, giving you full configuration control. Career Worksheet template configuration is not available in Admin Center.

All fields will have a label, a field ID, and a field type. Labels can be localized to any language you have enabled in the system. Configurable items for the standard fields are as follows:

• Field label modifications
• Inclusion or exclusion of fields: For example, you can remove the gap_graph field if you don't want to include the gap graph analysis.
• Rating-scale-id in the last_rating field definition (This is the normalized scale used for displaying rating comparisons.)
• Permissions for functions and fields
• Maximum number of roles that a user can add, with the max-per-category attribute (recommended max: 20)
• Instructions for top of page, with the text-replacement tag

The Career Worksheet template has the same attributes and elements as the Development Plan template because they share the same objective-template_4_0.dtd file. Therefore, element and attribute configuration are syntactically the same. Details such as field IDs can be different.

Adding new fields through Provisioning using XML follows a three-step process:

1. Define the field.
2. Permission the field.
3. Add the field to the layout.

The XML for a standard field follows a repeatable pattern. Here’s an example of the competency_name field that we can break down to see the various attributes.

12345678

<field-definition id="competency_name" type="text" 
required="true" detail="false" viewdefault="on" showlabel="false" 
field-show-coaching-advisor="false" cascade-update="push-down">
    <field-label>Required Competencies</field-label>
    <field-description></field-description>
  </field-definition>

Certain attributes are required for any field definition. For example, the id attribute and the type attribute must be defined or the file will fail to validate against the DTD. Some attributes are not required, such as detail or showlabel.

There is also one required child element: field-label. All other child elements are optional.

In addition to configuring fields on the Career Worksheet, the customer needs to decide which business roles can work with the worksheet. Career Worksheet permissions are different than Role-Based Permissions, but both are used to grant access to users.

Role-Based Permissions allow access to the Career Worksheet. Once users have access to the worksheet, all other permissions are governed by the XML plan permissions.

Action permissions define the roles that have the ability to perform specific actions on a Career Worksheet, such as adding or viewing roles.

The only access permissions available for Career Worksheets are Private access, Create, and Delete.

In order for fields to be visible or editable, Field permissions must be put in place.

The Field permissions available for Career Worksheets are as follows:

• Read - The user with Read permission can see, but not edit the field.
• None - The user cannot see (or edit) the field at all.

Additional information about Action and Field permissions is available in the Development Goal Plan unit.

After you have configured and permissioned fields, the next step is to decide which fields should be placed on the plan layout.

For Career Worksheets, the plan layout does not actually impact the Career Worksheet screen, but you must have a plan layout in the XML file for it to validate and to upload the file in Provisioning. The layout of the Career Worksheet screen cannot be changed.

The Career Worksheet V12 includes a Readiness Meter for future roles (Job Roles I'm Considering).

The Readiness Meter is optional. To include it, make sure this field is defined in your template and referenced in the field permissions and plan layout.

The role readiness score is calculated as a percentage based on the number of competencies met for a future role against the total number of competencies/attributes required for that role. A competency that is met is worth a full point and each competency that is not met is worth zero.

The readiness value is calculated as A/B where this criterion is used as shown in the Readiness Criteria table.

If you have Job Profile Builder enabled, you can access the full Role Details directly from the Readiness Meter of the Career Worksheet. Just hover over the "i" in the header of the role, and the details will open. The role details can be printed, but not edited, from the Career Worksheet.

Customers can choose a proportional calculation in which each competency rating is weighted as a percentage of the expected rating. A role readiness score calculated proportionally could more accurately show how close a user is to full readiness for a role.

A switch has to be included in the Career Worksheet XML template configuration for the proportional calculation. Switches are used to enable or disable features in a Career Worksheet template and would be placed after the <obj-plan-due> in the XML (code placement does matter). The switch shown in the screen below can be used to enable the new role readiness calculation.

Depending on whether the new calculation option is used or not, the role readiness result can be very different.

To attach a Role Readiness form to the Career Worksheet, the following XML element needs to be added to your Career Worksheet template: <self-assessment>. It gets placed after the text-replacement section and before the first <field­-definition>.

The screen above shows two samples of the code. The code in red has not had the form IDs entered yet, but it shows where in the XML the code would be placed. The second code sample shows that form ID 22 will be launched for US users and form ID 23 will be launched for French Canadian users, demonstrating that you can launch different Role Readiness forms for different locales.

To locate the form template ID, go to Form Template Administration within Provisioning. Once you find your Role Readiness form listed in the Template Name list, the form ID is in the Type ID column.

To learn more about the Role Readiness Form ID, watch this video:

The form must be permissioned for the employee to create and self-assess. When properly coded and permissioned, the user will see a link to the form for Job Roles I'm Considering.

The form will be created, and the user will be taken directly to the form, bypassing the usual form creation steps. When the form launched for a particular role is in progress, the system will tell the user, as shown in the figure.

Once the form is complete, the updated ratings will be used on the Career Worksheet, and the display will once again allow a Role Readiness form to be launched. Users can launch Role Readiness forms again for the same role as many times as they want.

• It is critical that customers have a complete understanding of how the Career Worksheet and other parts of the system handle competency ratings of record before implementing this feature.
• The latest rating of record from any form is the one used on the Career Worksheet (assuming assessment filters are not included - new ratings eclipse old ones).
• Competency ratings are not differentiated by role, that is, a rating of 5 on Communications will apply to both my current role and a future role, if they share that competency.
• Some functions can differentiate ratings by form, such as Dashboards, List Views, the Employee Scorecard, and Live Profile.
• Other functions, however, cannot differentiate by form. These include the Career Worksheet, Talent Search, and Side-by-Side Comparison.

Therefore, even though the system will allow a variety of form configurations, the following configuration is strongly recommended:

• Do not calculate an overall performance rating with this form.
• Route the form to a manager for a final manual rating (do not rely on the employee to enter a rating of record). The route map should be E → EM → Complete.
• Exclude this form from Dashboard processes used for current performance reporting.
• Make sure succession planners understand that this form could provide competency ratings that override the last performance review.

Alternate configurations may not be supported and should be deployed with extreme care.

There are two different ways to have form names displayed. One option supports translations, and one does not. The option that does not include translations does allow the future role name to be included.

These settings are controlled in Company System and Logo Settings and impact all Performance Management forms including Role Readiness forms. For this reason, Performance Management consultants and CDP consultants will need to coordinate their form settings.

Users can also launch Role Assessment forms for their current roles directly in the Career Worksheet. In order to create this link to the current role, you will need to place the following switch code into the XML of the Career Worksheet. Sample code is below:

After adding the switch code, add the following <current-self-assessment> code after the closing tag of the <self­-assessment> code as seen below:

Be sure to replace the number in the code (764) with the desired form template ID. To locate the form template ID, follow the same procedure you used for the future role readiness assessment. Once you’ve entered the code and uploaded your template, you should be able to see the additional link in the current role.

The default behavior is for the rating on the Career Worksheet to come from the last-rated and last-completed form (Role Readiness form, Performance Review form, whichever form was last completed).

It is possible to identify a specific form or a number of forms as the only source of existing ratings. For example, customers might not want performance reviews to be considered for ratings on the Career Worksheet. That form ID would NOT be included in the code below.

The above figure shows an example of the code to add in red (placed right before the first field definition). This code is specifying exactly which forms to be used, by Form ID, for competency ratings on the Career Worksheet.

If you need to delete the completed Role Readiness forms and start over, use action search to navigate to Delete Form. Select the radio button for Advanced Search, and in the field for Form Template, choose the link for Select. Select the checkbox for THR95 Future Role Readiness Form Template and choose Done to close that window. Then choose Search and select and delete any forms that appear.

The Career Worksheet has the ability to populate the gap graph. This is a graph depicting the gap between a competency rating and the expected rating. In the figure, the rating exceeds the expectation, so the competency has been "met."

To make sure that the gap graph shows on the Career Worksheet, it is important that the last_rating field in the XML points to an existing rating scale in Admin Center. In the XML, the syntax must be exactly the same as the name of the rating scale in Admin Center. This reference to a valid rating scale is also a condition for the Readiness Meter.

Ratings come from completed Performance Management (PM) forms, 360 forms, or a modified PM form called the Role Readiness form. The last rating will be used in the Career Worksheet; no averaging is supported at this time.

Gaps are calculated using the Expected Rating set up in Admin Center → Company Settings → Families & Roles and the last rating from the form mentioned in the figure.

To configure Expected Ratings, complete the following steps:

1. Navigate to Manage Job Profile Content (with JPB) or Manage Job Roles (with JDM).

2. Access the desired Family and Role.

3. Edit the Expected Rating.

   1. With JPB, select the Mapped Competencies tab, then choose the calculator next to the rating.
   2. With JDM, choose the Expected Rating % number for the desired competency.

4. Enter the Expected Rating percent.

   Enter the Lowest, Highest, and Expected scores to have the system compute the proper Expected Rating %.

5. Choose Save Edits.

Development goal information can be included within the Career Worksheet to help users work toward their future roles. The development goals are populated and linked to a competency on the Development Goal Plan.

To add the ability to link development goals to the Career Worksheet, you’ll need to add a line of XML code after the text replacement section:

<behaviors hide="true" hide-ratings="true" use-in-readiness="false"/>

Once the code has been added to the XML, based on the competencies for the role, you’ll see if any development goals have been added for those competencies. The plus sign (+) gives you the ability to add new development goals linked to that competency.

Other configurations must be made as follows:

• The Read and Write permissions for the user are derived from the Development Plan template configuration.

• The link to add development goals always adds goals to the default development plan.

• The Development Plan must include a Competencies field, which links development goals to specific competencies. Because a goal can be linked to more than one competency, the same goal may be counted more than once in the Career Worksheet. The same goal can also be represented in more than one job role.

Users can add roles to their Career Worksheet using a Role search as well as browsing the Family and Role library.

All users will have access to the Role search in the search bar. Simply start typing the role name and the autocomplete search will suggest appropriate matches.

Choose the role name to add it to your worksheet.

Customers also have an option to enable a Suggested Roles tab. This tab proactively suggests roles to the user.

The Suggested Roles are based on a formula that combines the following attributes selected in Admin Center → Development → Manage Suggested Roles:

• Competency association

• Common job family

• Open positions

• Proximity of role in career path

• Peer popularity

• Filters

When utilizing the Suggested Roles tab as an end user, competencies are weighed the most. Because of that, roles with significant competency matches will most likely surface to the top of the list.

To add roles from the Suggested Roles tab to the Career Worksheet V12, complete the following steps:

1. Choose the "+" icon.

2. Select the Role Title for details.