Configure Contact Tracing data retention settings

  • Release version: Zurich
  • Updated July 31, 2025
  • 2 minutes to read
  • Configure the data retention settings for the data collected for contact tracing such as badge swipe data, employee daily contact logs, and cases.

    Before you begin

    Role required: admin

    About this task

    Employers remain solely responsible for complying with their legal obligations under applicable law, including data protection laws on collection, use, disclosure, and retention of personal data, and should enable, choose not to enable, or customize any functionality available within the application to meet the Employers’ specific requirements.
    A system property and scheduled jobs control the data retention policy for contact tracing data.
    • The sn_imt_tracing.data_retention_period system property determines the number of days the contact tracing data will be available in the system before it is deleted automatically.
    • The Data Retention Job For Contact Tracing scheduled job checks for records that have an updated date that is past the defined retention period, and deletes them.
      The data retention policy applies to the following contact tracing data:
      Badge swipe data
      Table impacted: Badge Access Register [sn_imt_tracing_badge_access_register]
      Closed and canceled cases and associated records
      Tables impacted: Case [sn_imt_tracing_case], Case Task [sn_imt_tracing_case_task], Exposed Contacts [sn_imt_tracing_exposed_contact], Diagnostic Request [sn_imt_diagnosis_diagnostic_request], Diagnostics Events [sn_imt_diagnosis_diagnostics_event], and Potential Workplace Exposure [sn_imt_diagnosis_potential_workplace_exposure]

      The Diagnostic Request and Diagnostics Events tables are installed with the Emergency Exposure Management application.

      Note:
      A survey associated with cases that are eligible for deletion after the retention period is not deleted because surveys have their own retention period. For more information, see Clean up assessment data.
      Employee daily contact logs
      Tables impacted: Daily Contact Logs [sn_imt_tracing_daily_contact_log], Daily Log Acknowledgements [sn_imt_tracing_daily_log_acknowledgement], and Daily Log Notes [sn_imt_tracing_daily_log_note]
      Wi-Fi access data
      Tables impacted: WiFi Access Register [sn_imt_tracing_wifi_access_register]and Wi-Fi Access Register Job [sn_imt_tracing_wifi_access_register_job]
    • The Purge Contact Tracing Deleted Records (Data Retention) scheduled job purges all deleted records of contact tracing from the Audit Deleted Record [sys_audit_delete] table. All deleted records with an updated date past the defined retention period are purged.

    Procedure

    1. Set the period for which you want to keep the contact tracing data.
      1. Navigate to Contact Tracing > Administration > Properties.
      2. Enter a value in the Contact Tracing data retention period (in days) property.
        The default value is 90 days.
      3. Click Save.
    2. Configure the scheduled job to determine when the job runs to check for and delete the contact tracing data.
      1. Navigate to System Definition > Scheduled Jobs.
      2. Open the Data Retention Job For Contact Tracing scheduled job.
      3. Configure the job settings and click Save.
        For more information, see Configure a scheduled job.
    3. Download, import, and configure the Purge Contact Tracing Deleted Records (Data Retention) schedule job in the Global scope to purge deleted records.
      1. Download the Purge Contact Tracing Deleted Records (Data Retention) XML file from the Contact Tracing application page on the ServiceNow® Store.
      2. Navigate to System Definition > Scheduled Jobs.
      3. Import the downloaded XML file into the Scheduled Job [sysauto] table.
        For more information on importing, see Import a record from the template.
      4. Search and open the Purge Contact Tracing Deleted Records (Data Retention) record.
      5. Select Active to activate the job.
      6. In the Run field, set the schedule for the job to run.
      7. Click Update.