VMS Sync Rule Example: Ignore Fields Without Values

VMS Sync's Rules engine allows administrators to apply client-specific business logic to positions during the sync process. Rules are structured as If/Then statements and run after company, skill, and flex mappings have been applied. Rules can be assigned either account wide or at the credential level, and each rule is assigned a priority number that determines the order in which rules are applied.

Administrators with elevated permissions can create, edit, and delete rules directly in VMS Sync Admin Tools without contacting VMS Sync Support.

This article outlines how to create a rule to ignore records that enter VMS Sync without values in specific fields.

Use Case

There are many reasons you may want to create a rule that ignores records without values in specific fields.

For example, you may want to set up a rule to ignore records without ATS IDs, as these denote jobs that don't already exist in your system. In this example, you might want to set up a credential and generate position data for rules and mapping, such as populating your skill and company mapping, but you don't want anything to go over to the ATS.

Rule Creation Steps

Do the following to create a rule that ignores fields that enter VMS Sync without values in a specific field:

1. Open the Rules Dashboard.

2. Click Create +.
   

3. From the top navigation bar, if appropriate:

   1. Select the Credential (Optional) dropdown, and choose a Credential.

   2. Select the Priority dropdown, and increase or decrease the Priority.

      • See Rules Best Practices for more information on Priority.
        

4. In the IF section, select notDefined from the Type dropdown.

5. Select the field you don't want to be empty from the Field dropdown.

6. In the THEN section, select setIgnore from the Type dropdown.
   

7. Click Test Rule.

   • The preview will show the recent positions the rule was applied to.

   • Click a result to view the JSON with highlighted values (IF = Blue, THEN = yellow).

   • You can use the Specific Position field to test a specific req ID.

     The rule would look like this if you want to ignore records without ATS IDs.
     
     

8. Click Create Rule.

9. In the Purpose section of the pop-up, enter text to describe the rule and click Add Purpose.

   • Example: Ignore new reqs
     

Positions without ATS IDs will automatically be ignored in VMS Sync.

You can configure this rule to ignore fields without other values, such as rates.billRateMax. Whatever value you select in the Field dropdown will be ignored if it enters VMS Sync without a value.