Configuring the Attribute Sections

Objective

After completing this lesson, you will be able to configure the attribute sections.

Types of Attributes in a Section

The attribute section is one of the main working sections of a performance management form. It lists all attributes (competencies and skills) to be evaluated during a review.

A form can have one or more attributes sections, but each attribute ID can only appear once in a form. If there is an overlap, the attribute only appears in the first (topmost) section of the performance form.

Attribute sections can begin in one of the following ways:

  • Blank, in which case the user manually adds the attributes to be reviewed.
  • With relevant attributes already identified and listed in the form.

Attributes can automatically be populated into a performance form or added manually by the user. Depending on the way an attribute is populated in a section of the performance form, there are four different attribute types:

Note

In the context of the type of attributes explained below, it refers to both Competencies and/or Skills, which are supported in Performance forms. However, Skills in attribute sections are only available with Talent Intelligence Hub enabled in the instance.
Job Specific Attributes

Attributes that are mapped to the role or job code of the employee can be automatically populated in an attribute section. When the form is launched, the relevant attributes will default based on the employee’s role. 

If a user’s job code changes and new attributes should appear in the form, a new form must be created. These attributes can be further filtered by the group in which they reside, giving the option to pull only the job specific competencies within specific groups.

Caution

Unlike changes in Goal Plan that are dynamic and will reflect on the goal sections, the attribute content becomes native to the form on launch. That means, if an employee has a new skill or competency mapped to the Job Role after the form was created, the attribute section will NOT display this change. The form would need to be relaunched.

Core Attributes

Skills and/or Competencies with the Core tag, can be automatically populated in an attribute section. When the form is launched, the core attributes will default on all employees’ forms. 

Custom Attributes

Skills and/or Competencies can be hard-coded into a performance form template as Custom Attributes, so they always appear for all employees. 

Ad Hoc Attributes

You can allow the addition of Skills and/or Competencies on an ad hoc basis in any of these section types (Job Specific / Core / Custom). In Manage Templates, an administrator can enable the option Allow users to add skills or Allow users to add competencies, depending on the Attribute Type. With this option, users will display an Add Skills or Add Competencies button in that section and can add attributes from the Talent Intelligence Hub.  

Configuration of Job Specific Attribute Section

Before the attributes (competencies and skills) can be populated by job code, you must ensure the following three prerequisites are met: 

  • The Employee Data (UDF) file must have job codes for each employee. 
  • Job Roles must be mapped with these exact Job Codes as appear in the data file. 
  • Skills and Competencies can then be mapped to these Job Roles.  

Note

These prerequisites will be slightly different when your customer/organization has Employee Central enabled. With EC, the Job Role - Job Code mapping should be done with the Job Classification (FO).
  • The Basic Import (UDF) file must have the job codes for each employee.
  • The Job Classifications store the information about each job code and the employee is assigned to a Job Classification.
  • The Job Information Import will include the job-code value (from the Job Classification) which will map to the jobCode standard element (added in UDF/ Basic Import).
  • When mapping Job Codes with each Job Role, customers with Employee Central should use the job code that includes FO, like: ACC-MGR - FO rather than the jobCode without FO, like: ACC-MGR. The Job Code mapping type will display as JOBCLASSIFICATION. An example on the image below shows how the Account Manager Job Classification has a code ACC-MGR, but when mapping in Manage Job Profile Content, this Job Classification code will display as ACC-MGR - FO.
  • Skills and Competencies can then be mapped to these Job Roles.  
Example shows on an EC instance the job codes with -FO should be used to map to the job roles.

With these prerequisites met, either on an EC or non-EC environment, attribute sections of type Job Specific can be configured and will pull into the form the Skills/Competencies assigned to the subject's Job Role.

Configure a Job Specific Attribute Section using Manage Templates

Watch this video to learn how to configure a job specific attribute section in Manage Templates. 

In the Attribute section, the Job Specific checkbox needs to be selected in the Section Type as illustrated in the figure shown below. In the Attribute Type dropdown, select Competency or Skill depending on whether the section should populate with competencies or skills.

The Role Specific Competencies section is displayed and the Job Specific checkbox is selected and highlighted.

Configure Attributes Based on Job Code using XML

In the <competency-sect> attribute list, add the following code: use-jobcode="true". This populates all the subject’s job-specific attributes.

Attributes can be further filtered by categories. To add only the job-specific attributes from certain categories, set the category-filter-opt into "specified-category" and add the <comp-category> sub-element under </fm-sect-scale>. Remember that the category name is case and space sensitive and can be retrieved from the competency library or the attribute libraries in Manage Talent Intelligence Hub

Screenshot of Filter by Category where category-filter-opt and <comp-category> are highlighted.

Configuration of the Core Attribute Section

Before core competencies or skills can be populated on a performance form they must be tagged as Core in Manage Talent Intelligence Hub.  

Configuration of Core Competency Section using Manage Templates

Watch this video to learn how to configure the core competency section in Manage Templates.

In the Attribute section, the Core checkbox needs to be selected in the Section Type as illustrated in figure Populate Core Competencies. In the Attribute Type dropdown, select Competency or Skill depending on whether the section should populate with competencies or skills.

In the Attributes section, the Core checkbox is selected and highlighted.

Configuration of Core Attribute Section using XML

In the <competency-sect> general settings, set use-core-comp="true", and attribute-type="competency" or attribute-type="skill" depending on the attribute type.

Configuration of Custom Attribute Sections

Custom competencies and/or skills can be hard coded in an attribute section of the form template. This can be configured from Manage Templates or from XML. 

Configure Custom Attribute Sections using Manage Templates

Watch this video to learn how to configure the custom attribute section in Manage Template

  1. Select the Attribute Type, as Competency or Skill.
  2. Select the Custom checkbox.
  3. Choose the Show Advanced Options... and scroll down to the bottom of the section.The image shows the first 3 steps when adding custom attributes.
  4. Select the 0 Custom Skill defined
  5. Select the Tag to display Skills under that category and additionally, you can specify the weight and whether the skill will be removable or not.
  6. When saving, the section will show the Custom Skills. The image shows the last 3 steps when adding custom attributes.

Configure Custom Attribute Sections using XML

When hard coding attributes, add sub-element <fm-competency> to the <competency-sect> element, below </fm-sect-scale>, as shown in the figure shown below.

The image shows an example of code to hardcode attributes in XML. The fm-competency element applies to both competencies and skills

Elements and Attributes:

The table titled Hard Coding in XML: Elements and Attributes shows the XML elements and attributes of most relevance to hard coding.

Hard Coding in XML: Elements and Attributes

Element or AttributeDescription
IndexIndex refers to the location of the section in the template; in this case, a competency or skill with index="0" appears first in the list of competencies or skills within that attribute section.
RemovableWhen the removable attribute is set to "true", any permissioned user is able to remove the competency or skill from the form using the Remove Competency or Remove Skill buttons on the form. When the attribute is set to "false", no user can remove that attribute. 
<fm-comp-id>This is the ID of the attribute to be hard coded. It can be found in Manage Talent Intelligence Hub.
<fm-comp-name>The name of the attribute as it appears in the attribute library is populated to the form. This field can be used to add more details, but does not display in the instance.
<fm-comp-desc>Similar to <fm-comp-name>, this element allows for additional details about the attribute that do not display in the instance. 

Caution

Weights can also be added to each <fm-competency> sub-element, but this is not recommended practice as weighting individual attributes causes the overall calculated rating to be too granular. 

Populate Ad Hoc Attributes

Attributes can be manually added on a form. The Add Competency or Add Skill button needs to be enabled for the end user. This can be configured in both Manage Templates and in XML. 

Watch this video to learn how to enable users to add competencies in a competency section using Manage Templates

To populate ad hoc attributes in Manage Templates, navigate to the form to be updated, select the Attribute section and under the Show advanced options link, select the Allow users to add competencies or Allow users to add skills checkbox as illustrated in the figure that appears below.

In the Hide advanced options section, the Allow users to add competencies checkbox is highlighted.

Populate Ad Hoc Attributes using XML

To populate ad hoc attributes with XML, add the following code in the <competency- sect> attribute list: configurable="true"

Configuration of Advanced Options in Manage Templates

The example shows advanced options configurable in an attribute section.

You can make advanced settings to an attribute section using the following options in Manage Templates:

  • Allow users to add competencies or Allow users to add skills.

    Select this to allow users to add competencies or skills to the review being rated.

  • Show behaviors

    Select this option to allow users to display the behaviors associated with a competency on the form, if available. These behaviors should also be mapped to the Job Roles' competencies in order to display in a job-specific attribute section type.

  • Include the ability to rate

    Select this option to allow the rating options for the users working in the form, using the rating scale selected in General Settings or a specific one for the section. If this option is selected, the rating option needs to be determined (see the rating-opt table below which shows every possible combination).

  • Include a comment for each item

    Select this to allow users to comment on each item in the section. If you do not select this option, there is no item level comment box for users to fill in.

  • Include an Overall Comment

    Select this to allow users to make a comment at the bottom of the section.

  • Show expected competency rating or Show expected skill rating.

    This option would display the expected ratings if defined in the Job Role - Attribute mapping in Manage Job Profile Content.

  • Include in overall performance summary section rating To include the section for the overall summary rating calculation.
  • Include the ability to enter in a weight. To allow to enter individual weights per each attribute.
  • Display Section in Summary. To show this section in the summary.
  • Show Calculated Section Rating. Display calculated section rating in the summary.
  • Rating Scale. To select a specific rating scale in the section if different from the general one.
  • Hide numeric rating values (only show text labels). To display the rating labels only.
  • Default Rating. To determine the label when no rating has been selected yet.
  • Choose an alternate label for the rating field. To determine the label for the official rating.

Configuration of General Settings in the XML Template

Screenshot of Configure General Settings for the competency-sect In XML code format.

Set Ability to Rate

There are a couple of attributes that control ability to rate: no-rate and rating-opt.

If you set the no-rate attribute to "false", all users can rate the item within the section.

The rating-opt attribute controls how the rating box appears, as shown in the table, Rating-Opt Settings, which is identical as in the Goal sections. Each of the options can be further controlled by permissions.

Rating-Opt Settings

CodeFeatures
rating-opt="0"Only one rating appears, and is accessible by everyone with access to the form. It is the rating of record and also the item-rating.
rating-opt="1"The employee additionally has a rating that only they can access, the item-cmt-rating. The top rating is still accessible by everyone, and is the rating of record and the item-rating.
rating-opt="2"Everyone who has access to the form in edit mode has their own rating box item-cmt-rating or user-item-cmt-rating. The top rating box still appears, and is the rating of record and the item-rating, but is normally accessible only to the manager.

Note

In the rating option 2, there are two types of Unofficial User Rating:
  • Unofficial User Rating (user-item-cmt-rating) controls the visibility of the unofficial rating field only.
  • Unofficial User Rating (Legacy) (item-cmt-rating) controls the visibility of both the unofficial rating field and others' unofficial ratings shown on the Ratings from Others tab. This legacy field was previously named "Unofficial User Rating" in the permission configuration dialog.
Since users can potentially rate in two fields, Unofficial User Rating and Item Rating, and that would show two "duplicated" rating fields on the form, however, hiding the Unofficial User Rating (Legacy) hides the Ratings from Others tab. Now it is possible to hide only the rating field but still display others ratings on the form.
rating-opt="3"(Side-by-side rating) The manager rating is the rating of record and the item-rating. The manager rating does not need to be permissioned because only the manager can edit the manager rating, and only the employee can edit the employee rating (subject-item-rating). This is the recommended configuration.

Individual and Overall Comments

You control individual and overall comments using the same attribute: cmt-opt.

XML to Show or Hide Comments

XMLDescription
cmt-opt="0"Show both item and section comments
cmt-opt="1"Show section comments only, no item comments
cmt-opt="2"Show item comments only, no section comments
cmt-opt="3"Do not show any comments for items or sections

Available Elements and Attributes in General Settings (XML)

The attributes described in the table are available for general settings (XML).

Available Attributes

AttributeDescription
category-filter-optThis attribute determines whether skills and/or competencies are pulled from one or more categories (Tags), as follows:
  • category-filter-opt="no-filter"

    All applicable attributes are pulled.

  • category-filter-opt="specified-category"

    Only applicable attributes within a specific tag are pulled. If you use this option, you must also add the <fm-comp-cat> element to specify the tag name.

in-summ-displayThis attribute determines if a summary of the section appears in the Summary section. If set to "true", the summary appears.
in-overall-ratingThis attribute determines if the ratings/weights of the section are included in the Calculated Overall Rating. If set to "true", they are included.
hide-wacaThis attribute determines if the Writing Assistant is available in the section for competencies. If set to "true", the Writing Assistant is not available.
min-competencies-required

and

max-competencies-allowed
These attributes determine the minimum and maximum number of skills or competencies within the section.

You can use the elements described in the table to change labels or phrasing in an attribute section.

XML ElementDescription
<rating-label>The manager rating label (usually)
<rating-label-others>The subject (employee) rating label (usually)
<default-rating>The null value that shows by default in the ratings scale; this has neither a positive or negative impact on overall rating calculations
<section-manager-comments-label>What shows with the overall section comments provided by the manager
<section-subject-comments-label>What shows with the overall section comments provided by the subject
<manager-comments-label>What shows with item comments
<subject-comments-label>What shows with the section comments provided by the subject

Expected Ratings for Competencies, Behaviors and Skills

Screenshot of Accepting Responsibility is displayed along with Expected Rating of 75.0%.

Expected ratings provide insight into how the employee should be performing based on a defined job role or job profile. It is used to help calculate the gap between expected and actual performance. Expected ratings were previously available only in the Summary section.

You configure expected ratings in the Performance Management form XML template, using the following tags:

<show-comp-expected-rating="true" show-behavior-expected-rating="true">

Note

You can enable "Show expected Competency rating" from Manage Templates, to display expected ratings. However, if you rate at the behavior level and want to display expected ratings per behavior, you will need to set show-behavior-expected-rating="true" (default value is "false") from XML, as the option is not available in Manage Templates.

The format for the expected rating can be displayed as a percentage or number. The attribute that controls the format is comp-expected-rating-format and behavior-expected-rating-format. The possible values are 0 (as %) or 1 (converts % to a score normalized to the section scale)

Caution

Expected skill ratings can only be shown in the format of normalized scores, such as 4.0. The percentage format isn't supported.

Configuration of Item Weights for Attribute Sections

As mentioned previously, it is not recommended to assign item weights within attribute sections because it makes the overall rating too granular. However, if a customer requests that items within the section are weighted, you can accommodate this request.

The following two <competency-sect> attributes control weight configuration in an attribute section: 

  • no-weight
    • If no-weight="true", all items are weighted equally in the section. 
    • If no-weight="false", items are weighted according to the weights that you enter for each item. 
  • lock-item-weights
    • If lock-item-weights="true", you cannot edit the weights. 
    • If lock-item-weights="false", you can edit the weights. 

You can set item weights to have a minimum ("floor") and maximum ("ceiling") acceptable value within a section or enforce or warn if the total sum of weights is exceeded or not met, just like in the Goal Sections. You can review the previous lesson that explains how to configure these options, if applicable.

Configure the Attribute Section

Business Example

You need to configure the attribute sections of the Performance Management form.

Learn how to configure the Attribute sections from Manage Templates and XML.

Task 1: Configure a Custom Competency Section

Steps

  1. Designate the competencies Showing Community and Social Responsibility and Leveraging Opportunities as custom competencies in the instance.

    1. Navigate to Manage Templates using Action Search. Select the Performance Review tab, to display your performance form template list.

    2. Select your Performance Management form.

    3. Select to expand Edit Fields and Sections from the menu on the left-hand side of the screen, and select Core Values.

    4. In the Section Type:, select the Custom checkbox, and unselect the Core checkbox, not needed.

    5. Select Show advanced options..., and select 0 Custom Competency defined. Click to modify.

      Result

      A dialog box appears.
    6. Select +Add Another.

    7. For each custom competency, in the Tag field, select SuccessFactors Premium Library from the dropdown menu.

    8. In the Competency field, select Showing Community and Social Responsibility and Leveraging Opportunities respectively.

    9. Do not add any weights, and ensure the Removable checkbox is not selected, and select Done.

    10. Choose Save to save your changes.

    11. Select to expand Edit Fields and Sections again, and choose Core Values.

    12. Select Show advanced options... and scroll down to the end of the page.

    13. On the Choose an alternate label for the rating field:, type Official Rating.

    14. Choose Save to save your changes.

Task 2: Configure a Job-Specific Skill section

This task relies on the skills mapped to the job roles on the Human Resources family, that was completed in a previous exercise.

Steps

  1. Configure the job-specific skill section, and enable the following advanced options:

    • Allow users to add skills
    • Show expected skill rating
    • Choose an alternate label for the rating field:, type Official Rating.
    1. Expand Edit Fields and Sections from the menu on the left-hand side of the screen, and select Role-Specific Competencies.

    2. Change the Attribute Type from Competency to Skill.

    3. In the Section Name, enter Skills and Aspirations.

    4. On the description, change Competencies to Skills.

    5. Choose Show advanced options... and select the options as indicated above.

    6. Choose Save to save all your changes.

Summary

  • The attribute section is one of the main working sections and lists all attributes (competencies and skills) to be evaluated during a review.
  • A form can have one or more attributes sections, but each attribute ID can only appear once in a form.
  • Expected ratings provide insight into how the employee should be performing based on a defined job role or job profile.
  • it It not recommended to assign item weights within attribute sections because it makes the overall rating too granular but the request can be fulfilled should the customer request it.