Product documentation Docs
    • English
    • Deutsch
    • 日本語
    • 한국어
    • Français
  • More Sites
    • Now Community
    • Developer Site
    • Knowledge Base
    • Product Information
    • ServiceNow.com
    • Training
    • Customer Success Center
    • ServiceNow Support Videos
  • Log in

Product documentation

  • Home
How search works:
  • Punctuation and capital letters are ignored
  • Special characters like underscores (_) are removed
  • Known synonyms are applied
  • The most relevant topics (based on weighting and matching to search terms) are listed first in search results
Topics are ranked in search results by how closely they match your search terms
  • A match on the entire phrase you typed
  • A match on part of the phrase you typed
  • A match on ALL of the terms in the phrase you typed
  • A match on ANY of the terms in the phrase you typed

Note: Matches in titles are always highly ranked.

  • Release version
    Table of Contents
    • HR Service Delivery
Table of Contents
Choose your release version
    Home Orlando HR Service Delivery HR Service Delivery Safe Workplace suite Employee Readiness Core Employee Health and Safety Status Create a health and safety requirement

    Create a health and safety requirement

    • Save as PDF Selected topic Topic & subtopics All topics in contents
    • Unsubscribe Log in to subscribe to topics and get notified when content changes.
    • Share this page

    Create a health and safety requirement

    Create requirements to track when employees are ready to return to the workplace. You can also create requirements that visitors must complete before entering the workplace.

    Before you begin

    Role required: sn_imt_core.admin

    About this task

    Use health and safety requirements to define the requirements that employees must fulfill before they can return to the workplace, or that visitors must fulfill before entering the workplace. Create separate requirements for employees and visitors. A requirement must apply to either employees or visitors, not both. Employee Readiness Core provides some pre-built requirements. However, you can create additional requirements using data from any of the Safe Workplace suite or Emergency Response Management apps.

    Health and safety requirements are built with Flow Designer. Before creating a requirement, make sure that you're familiar with the basics of ServiceNow®Flow Designer.

    The following steps show how to create a requirement using the pre-built Employee Health Verification Requirement as an example.

    Procedure

    1. In Flow Designer, create an action to check the requirement status for an employee or visitor.
      1. Create an action. Save the action in the Employee Readiness Core application.
      2. In the Inputs section of the Action Outline, create an input for the type of record that you will use to check if the employee or visitor has fulfilled the requirement.

        For example, to fulfill the Employee Health Verification Requirement, employees must have a health verification record in the Employee Health Verification table [sn_imt_monitoring_health_verification].

        Table 1. Inputs
        Label Name Type Mandatory
        Employee Health Verification health_verification Reference.Employee Health Verification [sn_imt_monitoring_health_verification] Yes
      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 enables you to use the input for the action in a script.

        Table 2. Input Variables
        Name Value
        health_verification Employee Health Verification input that you created in the Inputs section.
      6. In the Script field, add a script to define the conditions when an employee's or visitor's requirement status is cleared or not_cleared.

        For the Employee Health Verification Requirement, the requirement is cleared for an employee if their health verification response is yes, and not_cleared for any other response.

        (function execute(inputs, outputs) {
        	outputs.requirement_status = inputs.health_verification.response == 'yes'
            	? 'cleared'
            	: 'not_cleared';
        })(inputs, outputs);
      7. Create an output variable for the requirement status.

        This defines the requirement_status variable that you used in the script.

        Table 3. Output Variables
        Label Name Type Mandatory Choice (Advanced options)
        requirement_status requirement_status Choice Yes Dropdown with --None--
      8. In the Outputs section of the Action Outline, create an output for the requirement status.

        Creating this output enables you to use the requirement_status output variable from the script as an output returned by the action.

        Table 4. Output Variables
        Label Name Type Mandatory Choice (Advanced options)
        Requirement status requirement_status Choice No Dropdown with --None--
      9. Assign the requirement_status value to the output.
        Table 5. Output Variables
        Label Value
        Requirement Status requirement_status output variable from the script step.

        The action returns the value of the requirement_status for the employee or visitor (cleared or not_cleared) as an output.

      10. Click Publish.
    2. Create a health and safety requirement.
      1. Navigate to Employee Health and Safety Status > Health 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 or visitors who complete the requirement before it is activated have their requirement status set to Cleared.

        Table 6. Health and Safety Requirement form
        Field Description
        Name Unique name for the requirement. For example, Employee Health Verification Requirement.
        Requirement for Who the requirement applies to. The options are Employee and Visitor. A requirement must apply to either employees or visitors, not both.

        For example, the Employee Health Verification requirement only applies to employees.

        Requirement flow 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 is assigned to health and safety users 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 health verification record are assigned a default status of Not Cleared for the Employee Health Verification Requirement.

        Use duration Option to set a time limit that the requirement status is valid for.
        Valid for Time limit that the requirement status is valid for.

        For example, the Employee Health Verification Requirement status is valid for seven days. Employees must resubmit their health verification weekly to continue fulfilling the requirement.

        This field appears only when the Use duration field is selected.

        Actionable Option to add a link for employees to complete the requirement on the Health and Safety Status page.
        Action name The name of the action for the employee to complete the requirement. For example, Submit self-report. This name is shown on the Health and Safety Status page.

        This field appears only when the Actionable field is selected.

        Action URL The URL of the Service Catalog item that employees use to complete the requirement. For example, the Employee Health Verification Requirement is completed by submitting the Health Verification form, which has the URL ?id=sc_cat_item&sys_id=9c578864ed111010fa9b395e35885545.

        This field appears only when the Actionable field is selected.

        Action visibility Sets when the link to complete the requirement is displayed on the Health and Safety Status page. Select Visible when false to only show the link when the employee hasn't completed the requirement, or select Always visible to always show the link.

        This field appears only when the Actionable field is selected.

        Include previous applicable records
        Table Table to look for previously created records that will trigger the requirement flow.

        For example, the Employee Health Verification Requirement uses the Employee Health Verification table [sn_imt_monitoring_health_verification].

        Condition Add conditions to filter the records from the table that will trigger the flow.
      4. Click Submit.
    3. In Flow Designer, create a flow to update the requirement status for an employee or visitor.
      1. Create a new flow. Save the flow 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 the requirement status is created or updated.

        For example, for the Employee Health Verification Requirement, the flow runs whenever a health verification record is created or updated.

        Table 7. Trigger
        Trigger Table Condition Run Trigger
        Created or Updated Employee Health Verification [sn_imt_monitoring_health_verification] None. For each unique change
      3. Add the action that you created to the flow. Add the record from the trigger as the input.
        For example, for the Employee Health Verification input, add the Employee Health Verification 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.
        Table 8. Update User Requirement inputs
        User [User] Health and safety requirement [Health and Safety Requirement] Requirement status Trigger datetime
        Employee or User field from the trigger record. For example, the Employee field from the Employee Health Verification record. Health and safety requirement you created. requirement_status returned by the action that you created. Created field from the trigger record. Only use this input if you set a value for the Valid for field on the requirement.
      5. Click Activate.
    4. Complete the health and safety requirement.
      1. Navigate to Employee Health and Safety Status > Health and Safety Requirements.
      2. Click the requirement that you created earlier.
      3. In the Requirement flow field, add the flow that you created to update the requirement status for employees or visitors.
      4. Click Update.

    What to do next

    When you create the requirement, it's not active by default. You must activate the requirement before you can track whether employees or visitors have fulfilled the requirement. For instructions, see Activate a health and safety requirement.

    Tags:

    Feedback
    On this page

    Previous topic

    Next topic

    • Contact Us
    • Careers
    • Terms of Use
    • Privacy Statement
    • Sitemap
    • © ServiceNow. All rights reserved.

    Release version
    Choose your release version

      Create a health and safety requirement

      • Save as PDF Selected topic Topic & subtopics All topics in contents
      • Unsubscribe Log in to subscribe to topics and get notified when content changes.
      • Share this page

      Create a health and safety requirement

      Create requirements to track when employees are ready to return to the workplace. You can also create requirements that visitors must complete before entering the workplace.

      Before you begin

      Role required: sn_imt_core.admin

      About this task

      Use health and safety requirements to define the requirements that employees must fulfill before they can return to the workplace, or that visitors must fulfill before entering the workplace. Create separate requirements for employees and visitors. A requirement must apply to either employees or visitors, not both. Employee Readiness Core provides some pre-built requirements. However, you can create additional requirements using data from any of the Safe Workplace suite or Emergency Response Management apps.

      Health and safety requirements are built with Flow Designer. Before creating a requirement, make sure that you're familiar with the basics of ServiceNow®Flow Designer.

      The following steps show how to create a requirement using the pre-built Employee Health Verification Requirement as an example.

      Procedure

      1. In Flow Designer, create an action to check the requirement status for an employee or visitor.
        1. Create an action. Save the action in the Employee Readiness Core application.
        2. In the Inputs section of the Action Outline, create an input for the type of record that you will use to check if the employee or visitor has fulfilled the requirement.

          For example, to fulfill the Employee Health Verification Requirement, employees must have a health verification record in the Employee Health Verification table [sn_imt_monitoring_health_verification].

          Table 1. Inputs
          Label Name Type Mandatory
          Employee Health Verification health_verification Reference.Employee Health Verification [sn_imt_monitoring_health_verification] Yes
        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 enables you to use the input for the action in a script.

          Table 2. Input Variables
          Name Value
          health_verification Employee Health Verification input that you created in the Inputs section.
        6. In the Script field, add a script to define the conditions when an employee's or visitor's requirement status is cleared or not_cleared.

          For the Employee Health Verification Requirement, the requirement is cleared for an employee if their health verification response is yes, and not_cleared for any other response.

          (function execute(inputs, outputs) {
          	outputs.requirement_status = inputs.health_verification.response == 'yes'
              	? 'cleared'
              	: 'not_cleared';
          })(inputs, outputs);
        7. Create an output variable for the requirement status.

          This defines the requirement_status variable that you used in the script.

          Table 3. Output Variables
          Label Name Type Mandatory Choice (Advanced options)
          requirement_status requirement_status Choice Yes Dropdown with --None--
        8. In the Outputs section of the Action Outline, create an output for the requirement status.

          Creating this output enables you to use the requirement_status output variable from the script as an output returned by the action.

          Table 4. Output Variables
          Label Name Type Mandatory Choice (Advanced options)
          Requirement status requirement_status Choice No Dropdown with --None--
        9. Assign the requirement_status value to the output.
          Table 5. Output Variables
          Label Value
          Requirement Status requirement_status output variable from the script step.

          The action returns the value of the requirement_status for the employee or visitor (cleared or not_cleared) as an output.

        10. Click Publish.
      2. Create a health and safety requirement.
        1. Navigate to Employee Health and Safety Status > Health 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 or visitors who complete the requirement before it is activated have their requirement status set to Cleared.

          Table 6. Health and Safety Requirement form
          Field Description
          Name Unique name for the requirement. For example, Employee Health Verification Requirement.
          Requirement for Who the requirement applies to. The options are Employee and Visitor. A requirement must apply to either employees or visitors, not both.

          For example, the Employee Health Verification requirement only applies to employees.

          Requirement flow 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 is assigned to health and safety users 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 health verification record are assigned a default status of Not Cleared for the Employee Health Verification Requirement.

          Use duration Option to set a time limit that the requirement status is valid for.
          Valid for Time limit that the requirement status is valid for.

          For example, the Employee Health Verification Requirement status is valid for seven days. Employees must resubmit their health verification weekly to continue fulfilling the requirement.

          This field appears only when the Use duration field is selected.

          Actionable Option to add a link for employees to complete the requirement on the Health and Safety Status page.
          Action name The name of the action for the employee to complete the requirement. For example, Submit self-report. This name is shown on the Health and Safety Status page.

          This field appears only when the Actionable field is selected.

          Action URL The URL of the Service Catalog item that employees use to complete the requirement. For example, the Employee Health Verification Requirement is completed by submitting the Health Verification form, which has the URL ?id=sc_cat_item&sys_id=9c578864ed111010fa9b395e35885545.

          This field appears only when the Actionable field is selected.

          Action visibility Sets when the link to complete the requirement is displayed on the Health and Safety Status page. Select Visible when false to only show the link when the employee hasn't completed the requirement, or select Always visible to always show the link.

          This field appears only when the Actionable field is selected.

          Include previous applicable records
          Table Table to look for previously created records that will trigger the requirement flow.

          For example, the Employee Health Verification Requirement uses the Employee Health Verification table [sn_imt_monitoring_health_verification].

          Condition Add conditions to filter the records from the table that will trigger the flow.
        4. Click Submit.
      3. In Flow Designer, create a flow to update the requirement status for an employee or visitor.
        1. Create a new flow. Save the flow 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 the requirement status is created or updated.

          For example, for the Employee Health Verification Requirement, the flow runs whenever a health verification record is created or updated.

          Table 7. Trigger
          Trigger Table Condition Run Trigger
          Created or Updated Employee Health Verification [sn_imt_monitoring_health_verification] None. For each unique change
        3. Add the action that you created to the flow. Add the record from the trigger as the input.
          For example, for the Employee Health Verification input, add the Employee Health Verification 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.
          Table 8. Update User Requirement inputs
          User [User] Health and safety requirement [Health and Safety Requirement] Requirement status Trigger datetime
          Employee or User field from the trigger record. For example, the Employee field from the Employee Health Verification record. Health and safety requirement you created. requirement_status returned by the action that you created. Created field from the trigger record. Only use this input if you set a value for the Valid for field on the requirement.
        5. Click Activate.
      4. Complete the health and safety requirement.
        1. Navigate to Employee Health and Safety Status > Health and Safety Requirements.
        2. Click the requirement that you created earlier.
        3. In the Requirement flow field, add the flow that you created to update the requirement status for employees or visitors.
        4. Click Update.

      What to do next

      When you create the requirement, it's not active by default. You must activate the requirement before you can track whether employees or visitors have fulfilled the requirement. For instructions, see Activate a health and safety requirement.

      Tags:

      Feedback

          Share this page

          Got it! Feel free to add a comment
          To share your product suggestions, visit the Idea Portal.
          Please let us know how to improve this content

          Check any that apply

          To share your product suggestions, visit the Idea Portal.
          Confirm

          We were unable to find "Coaching" in Jakarta. Would you like to search instead?

          No Yes
          • Contact Us
          • Careers
          • Terms of Use
          • Privacy Statement
          • Sitemap
          • © ServiceNow. All rights reserved.

          Subscribe Subscribed Unsubscribe Last updated: Tags: January February March April May June July August September October November December No Results Found Versions Search preferences successfully updated My release version successfully updated My release version successfully deleted An error has occurred. Please try again later. You have been unsubscribed from all topics. You are now subscribed to and will receive notifications if any changes are made to this page. You have been unsubscribed from this content Thank you for your feedback. Form temporarily unavailable. Please try again or contact  docfeedback@servicenow.com  to submit your comments. The topic you requested does not exist in the release. You were redirected to a related topic instead. The available release versions for this topic are listed There is no specific version for this documentation. Explore products Click to go to the page. Release notes and upgrades Click to open the dropdown menu. Delete Remove No selected version Reset This field is required You are already subscribed to this topic Attach screenshot The file you uploaded exceeds the allowed file size of 20MB. Please try again with a smaller file. Please complete the reCAPTCHA step to attach a screenshot
          Log in to personalize your search results and subscribe to topics
          No, thanks Login