---
sourceDocument: Yokohama Employee Service Management
sourceDocumentLink: https://www.servicenow.com/docs/r/yokohama/employee-service-management

 Release :

    - yokohama

ft:locale :

    - en-US

ft:publication_title :

    - Yokohama Employee Service Management

ft:clusterId :

    - emplsm

bundleId :

    - emplsm

workflow :

    - Employee


---

# Create a requirement for employees to acknowledge the privacy consent request

# Create a requirement for employees to acknowledge the privacy consent request {#ariaid-title1}

* Release version: Yokohama
* 
* Updated January 30, 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 5 minutes to read

Create a requirement for your employees to respond to the privacy consent request
before entering the workplace to facilitate the use of their data for contact
tracing.

## Before you begin

* Requirements are available in the ServiceNow® Employee Readiness Core application, which must be installed.
* Privacy Consent requirement is built with ServiceNow® Workflow Studio, so make sure you're familiar with the [Flow Designer](https://www.servicenow.com/docs/access?context=flow-designer&version=yokohama&pubname=yokohama-application-development&ft:locale=en-US) basics.

{#create-privacy-consent-requirement__ul_g1f_crj_kmb}

Role required: sn_imt_core.admin

## About this task

Define the privacy consent requirement for employees to return to work. Employees who agree to the use of their data for contact tracing fulfill the privacy consent requirement and are eligible to return to the workplace. Employees who disagree do not fulfill the privacy consent requirement and are not eligible to return to the workplace. For more information, see [Respond to a request for privacy consent in Contact Tracing](https://www.servicenow.com/docs/ENtW0ElLo~w3H4PuN4LPeA#submit-privacy-consent "When you receive an email or mobile notification for privacy consent, read the privacy policy statement and submit a response indicating whether you agree to the usage of your data for contact tracing.").  
Note:  
This procedure describes how to create a requirement using the base system Privacy Consent Requirement as an example.

## Procedure

1. In Workflow Studio, create an action to add or update the requirement status for an employee who responds to the privacy consent request.
   1. Create an action and save it in the Employee Readiness Core application.
   2. In the Inputs section of the Action Outline, create an input for the type of record to use to check whether the employee meets the requirement.  
      {#create-privacy-consent-requirement__table_up4_byt_zlb__entry__4}

      | Label | Name | Type | Mandatory |
      |-|-|-|-|
      | preference | preference | String | Yes |
      [ ]

      {#create-privacy-consent-requirement__table_up4_byt_zlb}
   3. Add a Script Step to the Action Outline.
   4. In the Required Runtime field, select Instance.
   5. Create an input variable using the input that you created for the action as the value.  
      This variable enables you to use the input for the action in a
      script.
      {#create-privacy-consent-requirement__table_yyf_ld5_zlb__entry__2}

      | Name | Value |
      |-|-|
      | preference | preference input that you created in the Inputs section. |
      [Table 1. Input Variables]

      {#create-privacy-consent-requirement__table_yyf_ld5_zlb}
   6. In the Script field, add a script to define the conditions when an employee's requirement status is `cleared` or `not_cleared`.  
      For the Privacy Consent Requirement, the requirement is
      `not_cleared` for an employee if the employee
      disagrees to the privacy consent request, and
      `cleared` if the employee agrees.

          (function execute(inputs, outputs) {
              if (inputs.preferences == "agree") {
                  outputs.requirement_status = "cleared";
              } else if (inputs.preferences == "withdraw_consent") {
                  outputs.requirement_status = "not_cleared";
              }

          })(inputs, outputs);

   7. Create an output variable for the requirement status.  
      This output variable defines the
      <var class="keyword varname">requirement_status</var> variable that you used in
      the script.
      {#create-privacy-consent-requirement__table_lxm_325_zlb__entry__5}

      | Label | Name | Type | Mandatory | Choice (Advanced options) |
      |-|-|-|-|-|
      | requirement_status | requirement_status | Choice | Yes | Dropdown with --None-- |
      [Table 2. Output Variables]

      {#create-privacy-consent-requirement__table_lxm_325_zlb}
   8. In the Outputs section of the Action Outline, create an output for the requirement status.  
      Creating this output enables you to use the
      <var class="keyword varname">requirement_status</var> output variable from the
      script as an output returned by the action.
      {#create-privacy-consent-requirement__table_n45_pc5_zlb__entry__5}

      | Label | Name | Type | Mandatory | Choice (Advanced options) |
      |-|-|-|-|-|
      | Requirement status | requirement_status | Choice | No | Dropdown with --None-- |
      [Table 3. Output Variables]

      {#create-privacy-consent-requirement__table_n45_pc5_zlb}
   9. Assign the <var class="keyword varname">requirement_status</var> value to the output.  
      {#create-privacy-consent-requirement__table_p2f_wo5_zlb__entry__2}

      | Label | Value |
      |-|-|
      | Requirement Status | <var class="keyword varname">requirement_status</var> output variable from the script step. |
      [Table 4. Output Variables]

      {#create-privacy-consent-requirement__table_p2f_wo5_zlb}

      The action returns the value of the
      <var class="keyword varname">requirement_status</var> for the employee
      (`cleared` or `not_cleared`) as an
      output.
   10. Click Publish.
   {#create-privacy-consent-requirement__substeps_lqn_iwt_zlb}
2. Create a privacy consent requirement.
   1. Navigate to Employee Health and Safety StatusHealth and Safety Requirements.
   2. Click New.
   3. On the form, fill in the fields.  
      The Include previous applicable records section defines a set of
      records that have already been created but should still trigger the
      requirement flow. Including previous records ensures that employees
      who complete the requirement before it is activated have their
      requirement status set to Cleared.
      {#create-privacy-consent-requirement__table_wxk_x2n_2mb__entry__2}

      | Field | Description |
      |-|-|
      | Name | Unique name for the requirement. |
      | Requirement flow | Flow to update the requirement status for an employee. Leave this field empty. You will return to the requirement record and fill in this field after you create the flow. |
      | Active | This field is read-only. Once you update all fields for the requirement, you can use the Activate button to activate the requirement. |
      | Default status | The default status assigned to employees who don't have any activity towards completing the requirement. The options are Cleared and Not Cleared. For example, employees who don't have a record in the User Privacy Notice and Consents \[sn_imt_tracing_user_privacy_consent\] table are assigned a default status of Not Cleared for the Privacy Consent Requirement. |
      | Use duration | Option for setting a time limit for the validity of the requirement status. Do not select this field because the employee's status is automatically updated when the employee responds to the privacy consent request. |
      | Include previous applicable records ||
      | Table | Table to consult for previously created records that will trigger the requirement flow. For example, the Privacy Consent Requirement uses the User Privacy Notice and Consents table. |
      | Condition | Conditions to filter the records from the table that will trigger the flow. |
      [Table 5. Health and Safety Requirement form]

      {#create-privacy-consent-requirement__table_wxk_x2n_2mb}
   4. Click Submit.
   {#create-privacy-consent-requirement__substeps_ret_mm5_zlb}
3. In Workflow Studio, create a flow to update the requirement status for an employee.
   1. Create a flow and save it in the Employee Readiness Core application.
   2. Add a trigger so that the flow runs whenever the type of record that you're using to check that the requirement status is created or updated.  
      For example, for the Privacy Consent Requirement, the flow runs
      whenever a user privacy notice and consent record is created or
      updated.
      {#create-privacy-consent-requirement__table_j2h_lh5_zlb__entry__4}

      | Trigger | Table | Condition | Run Trigger |
      |-|-|-|-|
      | Created or Updated | User Privacy Notice and Consents \[sn_imt_tracing_user_privacy_consent\] | \[Preferences\] \[changes to\] \[I Agree\] OR \[Preferences\] \[changes to\] \[Withdraw Consent\] | Only if not currently running |
      [Table 6. Trigger]

      {#create-privacy-consent-requirement__table_j2h_lh5_zlb}
   3. Add the action that you created to the flow, with the record from the trigger as the input.  
      For example, for the preference input, add the User Privacy Notice and Consent record that was created or updated in the trigger event.
   4. Add the Update User Requirement action provided in Employee Readiness Core to the flow.  
      {#create-privacy-consent-requirement__table_ncn_xl8_zlb__entry__4}

      | User \[User\] | Health and safety requirement \[Health and Safety Requirement\] | Requirement status | Trigger datetime |
      |-|-|-|-|
      | User field from the trigger record. For example, the User field from the User Privacy Notice and Consent record. | Health and safety requirement you created for the privacy consent. | `requirement_status` returned by the action you created. | Leave the field blank. |
      [Table 7. Update User Requirement inputs]

      {#create-privacy-consent-requirement__table_ncn_xl8_zlb}
   5. Click Activate.
   {#create-privacy-consent-requirement__substeps_epf_io5_zlb}
4. Complete the health and safety requirement.
   1. Navigate to Employee Health and Safety StatusHealth and Safety Requirements.
   2. Open the Privacy Consent Requirement record.
   3. In the Requirement flow field, add the flow that you created to update the requirement status for employees.
   4. Click Update.
   {#create-privacy-consent-requirement__substeps_nyu_3wt_zlb}

## What to do next

You must activate the requirement before you can track whether employees have
fulfilled it. For instructions, see [Activate a health and safety requirement](https://www.servicenow.com/docs/5Y4rI8rH5a3RhsFYufIVgA "Activate requirements to track when employees are ready to return to the workplace or to safely travel to another site. You can also activate requirements that visitors must complete before entering the workplace.").

*[\>]: and then