SAP Knowledge Base Article - Public

3523870 - [Onboarding] New York WTPA Compliance Form Not Getting Triggered

Symptom

New York WTPA form is not triggering even after the filterkey1 fieldmetaoverride configuration is maintained as per the SAP documentation - Configuring Wage Theft Protection Act (WTPA) Forms

Image/data in this KBA is from SAP internal systems, sample data, or demo systems. Any resemblance to real data is purely coincidental.

Environment

SAP SuccessFactors Onboarding

Reproducing the Issue

  1. Initiate the Onboarding Process for the candidate with the Job Location/workState as New York.
  2. Completed the Data Collection Steps for the Candidate
  3. Wage Theft Protection Act (WTPA) Form is not getting triggered.

Cause

  • The fieldmetaoverride for workstate is not returning the expected value as 'NY'
  • Incorrect fieldType is used in the overrideFieldMeta under FieldMetaOverrideConfiguration.

Resolution

  • The WTPA form would get assigned only when all matching criteria are met : formname , workstate (NY) work country(USA).
  • If you are using 'Dropdown or picklist field for filterkey 1, use the below overrideFieldsMeta for workstate. See sample configuration screenshot below:

    {
    "entity": "jobInfo",
    "entityPath": "jobInfoNav/locationNav/addressNavDEFLT/stateNav",
    "fieldType": "picklist",
    "field": "externalCode"
    }



  • If you are using a 'string' field, use the below overrideFieldsMeta for workstate. See sample configuration in screenshot:

    {
    "entity": "jobInfo",
    "entityPath": "jobInfoNav",
    "fieldPath": "",
    "fieldType": "",
    "field": "[customstring where WTPA Form Name was configured in BCUI]"   


    NOTE: Notice the field has not hyphen but written as 'customString3'

See Also

Keywords

WTPA Compliance Form, New York, WTPA, Compliance forms, Onboarding ,Wage Theft Protection Act (WTPA) Forms, Compliance, workState, filterkey1, fieldsOverrideMeta, FieldMetaOverrideConfiguration, NY WTPA, Onboarding, OBX, ONB2 , KBA , LOD-SF-OBX-FRM , Compliance 2.0 Country Forms (except i9&EV) , Problem

Product

SAP SuccessFactors HCM Core all versions