System properties for tracing systems in Emergency Exposure Management

  • Freigeben Version: Australia
  • Aktualisiert 12. März 2026
  • 9 Minuten Lesedauer

    • System properties associated with tracing systems that are available in the Emergency Exposure Management application.

    To configure the system properties available for a tracing system, navigate to Emergency Exposure Management > Administration > Tracing Systems and open the tracing system record.

    For more information on setting up or modifying a tracing system, see Set up a tracing system for an exposure data source.

    System properties for tracing systems installed with Contact Tracing

    For more information, see Setting up Contact Tracing.
    Hinweis:
    To configure the system properties for KINEXON SafeZone, you must navigate to Contact Tracing > Properties and set the values for each property there.

    For more information, see Configure KINEXON integration.

    Tabelle : 1. Properties for Contact Tracing
    Property Description
    Tracing system: Badge reader
    sn_imt_tracing.badge_data_page_size Number of records to process at a time for badge reader data. The default value is 500.
    sn_imt_tracing.badge_reader_location The field in the Badge Access Register [sn_imt_tracing_badge_access_register] table that refers to the location of the badge reader when the Use badge reader option is selected on the Diagnostic Request form. You can also specify a dot-walked field, for example, floor.floor_name. The default value is the floor_name field in the [sn_imt_tracing_badge_reader] table.
    sn_imt_tracing.badge_owner_field The field in the Badge Access Register [sn_imt_tracing_badge_access_register] table that refers to the badge owner when the Use badge reader option is selected on the Diagnostic Request form. You can also specify a dot-walked field, for example, user.user_name. The default value is the user field in the [sn_imt_tracing_user_badge] table.
    Tracing system: Wi-Fi access log
    sn_imt_tracing.wifi_client_table The CMDB Class table to look up to identify the device and owner matching the Wi-Fi client in Wi-Fi access logs. The default value is cmdb_ci_computer.
    sn_imt_tracing.wifi_client_mac_field The field in the CMDB Class [cmdb_ci_computer] table that stores the mac address of the Wi-Fi client. The default value is mac_address.
    sn_imt_tracing.wifi_client_owner_field The field in the CMDB Class [cmdb_ci_computer] table that identifies the owner of the Wi-Fi client from the Wi-Fi access logs. The default value is assigned_to.
    sn_imt_tracing.wifi_client_identification_fields The fields in the CMDB Class [cmdb_ci_computer] table that identify the Wi-Fi client matching the Wi-Fi client in the Wi-Fi access log. The default values are mac_address, name.
    sn_imt_tracing.wifi_ble_client_table The CMDB Class table to look up to identify the device and owner matching the Wi-Fi Bluetooth LE (BLE) client in the Wi-Fi access logs. The default value is cmdb_ci_wearable.
    Hinweis:
    The Wearable Technology table [cmdb_ci_wearable] is installed with the CMDB CI Class Models application available through the ServiceNow Store. For more information, see CMDB CI Class Models.
    sn_imt_tracing.wifi_ble_client_mac_field The field in the CMDB Class [cmdb_ci_wearable] table that stores the mac address of the Wi-Fi BLE client. The default value is mac_address.
    sn_imt_tracing.wifi_ble_client_owner_field The field in the CMDB Class [cmdb_ci_wearable] table that identifies the owner of the Wi-Fi BLE client from the Wi-Fi access logs. The default value is assigned_to.
    sn_imt_tracing.wifi_ble_client_identification_fields The fields in the CMDB Class [cmdb_ci_wearable] table that identify the Wi-Fi asset matching the Wi-Fi BLE client in the Wi-Fi access log. The default values are mac_address,asset_tag.
    Tracing system: Mist systems
    sn_imt_tracing.mist_api API that accesses the Wi-Fi access logs from Mist Systems. The default value is https://api.mist.com/api/v1.
    Hinweis:
    This property applies only if you collect Wi-Fi access logs using Mist Systems.
    sn_imt_tracing.mist_visits_page_size Maximum number of records to process by Mist Systems API calls. The default value is 1000.
    Hinweis:
    This property applies only if you collect Wi-Fi access logs using Mist Systems.
    Tracing system: Cisco DNA Spaces
    sn_imt_tracing.wifi_proximity_preference Level of proximity to consider employee interaction with an affected employee as potential exposure. The available options are 30ft, Floors, or Buildings. The default value is 30ft.
    Hinweis:
    This property applies only if you collect proximity reports using Cisco DNA Spaces.
    Properties that apply only if you collect Wi-Fi raw data from Cisco DNA Spaces using Wi-Fi raw data files
    sn_imt_tracing.wifi_log_sftp_server URL or IP Address (for example, 192.168.1.1) of the secured FTP (SFTP) server from which to access the Wi-Fi raw data files imported into the Wi-Fi Access Register [sn_imt_tracing_wifi_access_register] table.
    sn_imt_tracing.wifi_log_sftp_port Port on the SFTP server to allow an FTP connection to access the files.
    sn_imt_tracing.wifi_log_sftp_file_path File path on the SFTP server where the Wi-Fi access data files from Cisco DNA Spaces are stored.

    For example, in the file path /upload/Visit Data/Daily/ServiceNow_Daily_Visits_:

    • /upload/Visit Data/Daily/ is the folder location on the SFTP server where the files are stored.

    • ServiceNow_Daily_Visits_ is the first part of the default file name that Cisco DNA Spaces uses, followed by the date and the upload time.

    For example, the default file name for the Wi-Fi access data for 19 August 2020 at 0100 UCT would be ServiceNow_Daily_Visits_2020-08-19 0100 UTC.csv:
    • ServiceNow_Daily_Visits_ is a fixed value
    • 2020-08-19 is the date the Wi-Fi access data was captured
    • 0100 UTC is the time scheduled by you for Cisco DNA Spaces to upload the file
    Hinweis:
    Make sure that only a limited number of users have read and write access to this location.
    sn_imt_tracing.wifi_log_sftp_load_time Time in HH:mm format when the Cisco DNA Spaces system uploads the day's Wi-Fi access data files on the SFTP server. This timestamp is the last part of the name of the Wi-Fi access data file.
    sn_imt_tracing.wifi_log_sftp_username User name required to log in to the SFTP server.
    Hinweis:
    Make sure that the SFTP user is not a privileged user such as an administrator. Assign the minimal privilege required to read the files in the directory set in the sn_imt_tracing.wifi_log_sftp_file_path property.
    sn_imt_tracing.wifi_log_sftp_password Password required to log in to the SFTP server.
    sn_imt_tracing.wifi_log_cisco_tier Integration tier with Cisco DNA Spaces to fetch Wi-Fi access data. The available options are proximity_report and wifi_log_report.
    Hinweis:
    This property applies only if you are using integration with Cisco DNA Spaces to get the Wi-Fi access data.
    Tracing system: Kinexon SafeZone
    sn_imt_tracing.kinexon_api_endpoint API endpoint used to log in to the KINEXON SafeZone instance and access KINEXON data. This API endpoint is also used to fetch information required for Contact Tracing. Replace the default endpoint with the endpoint of your instance.
    sn_imt_tracing.kinexon_api_username KINEXON administrator user name.
    sn_imt_tracing.kinexon_api_password KINEXON administrator password.
    sn_imt_tracing.kinexon_api_param_min_duration The minimum duration of contact (in seconds) between two KINEXON sensors required to determine whether a user is a potentially exposed contact. The query omits all records with values below this duration. The default value is 300.
    sn_imt_tracing.kinexon_api_param_min_acc_duration The minimum total duration (in seconds) of all contact between two KINEXON sensors within the queried date range. If the total duration is shorter than this value, the query omits all records of contact between the pair of sensors. The default value is 300.
    sn_imt_tracing.kinexon_api_param_max_distance The maximum distance (in meters) between two KINEXON sensors that determines whether users are in contact. The query omits any instances of contact beyond this distance. The default value is 2.
    sn_imt_tracing.kinexon_api_param_max_time_gap_in_sequence Determines the amount of time that can pass (in seconds) between any two consecutive instances of contact before the potential exposure is considered two potential exposures. The default value is 15.
    Tabelle : 2. Properties for Contact Tracing
    Property Description
    Tracing system: Badge reader
    sn_imt_tracing.badge_data_page_size Number of records to process at a time for badge reader data. The default value is 500.
    sn_imt_tracing.badge_reader_location The field in the Badge Access Register [sn_imt_tracing_badge_access_register] table that refers to the location of the badge reader when the Use badge reader option is selected on the Diagnostic Request form. You can also specify a dot-walked field, for example, floor.floor_name. The default value is the floor_name field in the [sn_imt_tracing_badge_reader] table.
    sn_imt_tracing.badge_owner_field The field in the Badge Access Register [sn_imt_tracing_badge_access_register] table that refers to the badge owner when the Use badge reader option is selected on the Diagnostic Request form. You can also specify a dot-walked field, for example, user.user_name. The default value is the user field in the [sn_imt_tracing_user_badge] table.
    Tracing system: Wi-Fi access log
    sn_imt_tracing.wifi_client_table The CMDB Class table to look up to identify the device and owner matching the Wi-Fi client in Wi-Fi access logs. The default value is cmdb_ci_computer.
    sn_imt_tracing.wifi_client_mac_field The field in the CMDB Class [cmdb_ci_computer] table that stores the mac address of the Wi-Fi client. The default value is mac_address.
    sn_imt_tracing.wifi_client_owner_field The field in the CMDB Class [cmdb_ci_computer] table that identifies the owner of the Wi-Fi client from the Wi-Fi access logs. The default value is assigned_to.
    sn_imt_tracing.wifi_client_identification_fields The fields in the CMDB Class [cmdb_ci_computer] table that identify the Wi-Fi client matching the Wi-Fi client in the Wi-Fi access log. The default values are mac_address, name.
    sn_imt_tracing.wifi_ble_client_table The CMDB Class table to look up to identify the device and owner matching the Wi-Fi Bluetooth LE (BLE) client in the Wi-Fi access logs. The default value is cmdb_ci_wearable.
    Hinweis:
    The Wearable Technology table [cmdb_ci_wearable] is installed with the CMDB CI Class Models application available through the ServiceNow Store. For more information, see CMDB CI Class Models.
    sn_imt_tracing.wifi_ble_client_mac_field The field in the CMDB Class [cmdb_ci_wearable] table that stores the mac address of the Wi-Fi BLE client. The default value is mac_address.
    sn_imt_tracing.wifi_ble_client_owner_field The field in the CMDB Class [cmdb_ci_wearable] table that identifies the owner of the Wi-Fi BLE client from the Wi-Fi access logs. The default value is assigned_to.
    sn_imt_tracing.wifi_ble_client_identification_fields The fields in the CMDB Class [cmdb_ci_wearable] table that identify the Wi-Fi asset matching the Wi-Fi BLE client in the Wi-Fi access log. The default values are mac_address,asset_tag.
    Tracing system: Mist systems
    sn_imt_tracing.mist_api API that accesses the Wi-Fi access logs from Mist Systems. The default value is https://api.mist.com/api/v1.
    Hinweis:
    This property applies only if you collect Wi-Fi access logs using Mist Systems.
    sn_imt_tracing.mist_visits_page_size Maximum number of records to process by Mist Systems API calls. The default value is 1000.
    Hinweis:
    This property applies only if you collect Wi-Fi access logs using Mist Systems.
    Tracing system: Cisco DNA Spaces
    sn_imt_tracing.wifi_proximity_preference Level of proximity to consider employee interaction with an affected employee as potential exposure. The available options are 30ft, Floors, or Buildings. The default value is 30ft.
    Hinweis:
    This property applies only if you collect proximity reports using Cisco DNA Spaces.
    Properties that apply only if you collect Wi-Fi raw data from Cisco DNA Spaces using Wi-Fi raw data files
    sn_imt_tracing.wifi_log_sftp_server URL or IP Address (for example, 192.168.1.1) of the secured FTP (SFTP) server from which to access the Wi-Fi raw data files imported into the Wi-Fi Access Register [sn_imt_tracing_wifi_access_register] table.
    sn_imt_tracing.wifi_log_sftp_port Port on the SFTP server to allow an FTP connection to access the files.
    sn_imt_tracing.wifi_log_sftp_file_path File path on the SFTP server where the Wi-Fi access data files from Cisco DNA Spaces are stored.

    For example, in the file path /upload/Visit Data/Daily/ServiceNow_Daily_Visits_:

    • /upload/Visit Data/Daily/ is the folder location on the SFTP server where the files are stored.

    • ServiceNow_Daily_Visits_ is the first part of the default file name that Cisco DNA Spaces uses, followed by the date and the upload time.

    For example, the default file name for the Wi-Fi access data for 19 August 2020 at 0100 UCT would be ServiceNow_Daily_Visits_2020-08-19 0100 UTC.csv:
    • ServiceNow_Daily_Visits_ is a fixed value
    • 2020-08-19 is the date the Wi-Fi access data was captured
    • 0100 UTC is the time scheduled by you for Cisco DNA Spaces to upload the file
    Hinweis:
    Make sure that only a limited number of users have read and write access to this location.
    sn_imt_tracing.wifi_log_sftp_load_time Time in HH:mm format when the Cisco DNA Spaces system uploads the day's Wi-Fi access data files on the SFTP server. This timestamp is the last part of the name of the Wi-Fi access data file.
    sn_imt_tracing.wifi_log_sftp_username User name required to log in to the SFTP server.
    Hinweis:
    Make sure that the SFTP user is not a privileged user such as an administrator. Assign the minimal privilege required to read the files in the directory set in the sn_imt_tracing.wifi_log_sftp_file_path property.
    sn_imt_tracing.wifi_log_sftp_password Password required to log in to the SFTP server.
    sn_imt_tracing.wifi_log_cisco_tier Integration tier with Cisco DNA Spaces to fetch Wi-Fi access data. The available options are proximity_report and wifi_log_report.
    Hinweis:
    This property applies only if you are using integration with Cisco DNA Spaces to get the Wi-Fi access data.