Using a Custom Workforce Template to Support Workforce Customizations

Workforce provides a custom template, OWP_Custom Template, with three blank script blocks for each supported rule, which allows you to customize the supported rules. For example, use the script blocks to include custom employee properties when you transfer an employee or change an employee's job.

OWP_Custom Template is not considered for updates, so you can write and maintain your custom, flexible code in one place. For example, the custom template ensures that any custom Employee Properties you may have added in the Account dimension are copied to the target job when you run the Change Job or two-step Transfer rules. Because you make your customizations in OWP_Custom Template, you don’t need to edit the other provided rules or templates. This makes the other provided rules and templates easier to maintain during updates because you don’t need to reapply any customizations you have made.

The following rules support OWP_Custom Template and will read any of the modifications you make to the custom script blocks:

  • OWP_Change Job
  • OWP_Transfer
  • OWP_Transfer In
  • OWP_Transfer Out

You don't need to make changes to any of the following templates to copy your custom properties. Use OWP_Custom Template instead.

  • OWP_Assign Target Defaults
  • OWP_Change Job
  • OWP_Transfer_T
  • OWP_Transfer In_T
  • OWP_Transfer Out_T
  • OWP_Calculate Employee Compensation_Te
  • OWP_Process Loaded Data_T
  • OWP_Synchronize Defaults_T
  • OWP_Synchronize Definition_T

Note:

After adding a new custom property, make sure you added it as a shared member under the parent OWP_Workforce Planning Accounts for Forms so it shows up on forms. Refresh the database after making your changes. For more information, see About Adding Employee Properties.

To use the custom template, OWP_Custom Template:

  1. From the Navigator, click Rules under Create and Manage to open Calculation Manager.
  2. Open OWP_Custom Template to make your custom changes to the script blocks associated with the rule you want to customize.

    The descriptions in the script blocks give you more information about how to use the script blocks.

  3. Click the custom script block for the rule you want to customize, enter your custom code, and save your changes.

    For example, to customize the OWP_Change Job rule to support a custom employee property, Hire Date, make changes in Change Job Script 1:

    
    FIX("No Property")
            "OWP_Action" ( 
                IF ( @ISMBR( {Year})) 
                  IF ( "Fiscal TP-Index" >= @MEMBER(@CONCATENATE("HSP_ID_", @HspNumToString({StartMonth})))->"Fiscal TP-Index") 
                    "Hire Date"->{TargetJob} = "Hire Date";
                   ENDIF 
                ELSE
                    "Hire Date"->{TargetJob} = "Hire Date";
                ENDIF 
                ;
            ) 
            ENDFIX
  4. Validate and deploy the associated rule or rules.