People Management Workflow | Create a new field in the HR Request object

Sage People supports fields with the following data types in People Management Workflow: 

  • lookup. Lookup fields display as picklists where you can also search to filter the options

  • checkbox

  • date

  • email

  • number

  • percent

  • phone

  • picklist. People Management Workflow continues to support dependent picklists

  • text

  • text area

  • text area (long)

  • text area (rich)

  • URL

Note Sage People only supports fields with the fHCM2 namespace in People Management Workflow.

Text fields added to the Combo Fields field set display as closed combo boxes. This is where the text you enter matches to previously entered values that the user can select, similar to picklists.

Note

At the time of Sage People Y23.3 release, text fields aren't available to select for adding to the Combo Fields field set directly. But you can create an alternative field set and use fieldset mapping to override the Combo Fields field set.

Tip

This section uses the example of creating a request to modify the Cost Code field on the Employment Record object. By default, Cost Code doesn’t exist as a field on the HR Request object.

The new field must have the same name and type as the field on the host object.

Note

Take care when naming fields you use for employment details change requests and use unique field names. If you create a custom field with the same name as a managed‑package HR Request field, People Management Workflow can't access it.

It can only access the field that comes from the managed package.

For example, you can create a Cost Code field on the HR Request object. This lets managers make employment change requests to modify the Cost Code field on the Employment Record:

  1. Go to Setup > Object Manager.

  2. To find the correct name and type of field you're going to set up, select the Field Label for the Employment Record.

    Sage People displays the Custom Object page for the Employment Record.

  3. In the sidebar, select Fields & Relationships and scroll down to the Cost Code field.

  4. Copy the API Name of the Cost Code field:

    fHCM2__Cost_Code__c

    and note the Data Type of the field:

    Text(128)

  5. Return to the object list and select the Field Label for the HR Request object.

    Sage People displays the Custom Object page for the HR Request.

  6. On the top of the page select New.

    Sage People displays the New Custom Field page, Step 1, Choose the field type.

  7. Select the Data Type corresponding to the field on the host object, in this case Text.

  8. Select Next.

    Sage People displays the New Custom Field page, Step 2, Enter the details.

  9. Complete the fields as follows. Exact details vary depending on the Data Type of the field. For example, for a Picklist field The system prompts you to enter the picklist values. In all cases, replicate the values the host field on the host object holds. In this case, the page displays the fields for a Text Data Type.

    Tip We recommend using Yes or No picklists rather than checkboxes. You can leave these blank if you're not changing the Request.
    Field Description
    Field Label

    The label you want to display in the employment details change request for this field. Use the name you use in the host object unless you have a good reason to use a different name.

    In this case, enter:

    Cost Code

    Length

    The maximum length for the text field. Use the same length as the host field.

    In this case, enter:

    128

    Field Name

    The field name must correspond with the field name of the host field on the host object. you need to remove the fHCM2__ prefix and __c suffix, and add a prefix to indicate the host object:

    • B_ for Bonus
    • E_ for Employment Record
    • S_ for Salary
    • T_ for Team Member

    In this case enter:

    E_Cost_Code

    Description

    A brief description of the field's purpose. Include a reference to the host object and field.

    In this case, enter:

    Enables the Employment Record Cost Code field to be updated by HR Request

    Help Text Any help text you want to display for HR Managers completing an employment details change request.
    Required Checkbox. Leave unchecked. Use the Required checkbox on the field in the Field Set. this ensures users complete the field on an employment details change request before they can save it.
    Unique

    Checkbox. If you check this, the content you enter must be unique. You can select for case sensitivity or case insensitivity.
    External ID Checkbox. Leave unchecked.
    Default Value The default value for this field. Leave blank if you don't want to specify a default value.

  10. Select Next.

    Sage People displays the New Custom Field page, Step 3. Establish field-level security.

  11. Check the boxes to apply the level of access you require for this field.

  12. Select Next.

    Sage People displays the New Custom Field page, Step 4. Add to page layouts.

  13. Typically, you want to add the new field to the HR Request record page layout, so accept the default setting.

    If you don't want to add the new field to the HR Request record page layout, uncheck the Add Field checkbox.

  14. Select Save.

    Sage People adds the new field to the list of Fields & Relationships.

  15. Check the Field Label, API Name, and Data Type are correct.

    The API Name must be as you entered it, with __c added as a suffix. In this case:

    E_Cost_Code__c

    If you need to edit any details, select Edit.

ERROR: Fetch Operation Data Failed

On occasion, the system can display an error when the People Management Workflow or HR Request Type fails in WX. Try one of the following fixes:

  • The error can be related to a field in a fieldset that failed. This can be because the field is from a cross object

  • Check you don't have a field in the HR request object with a prefix that's looking for a fields that doesn't exist on the prefixed object