Update variables in record producers to capture tokenized data from Epic

  • Release version: Yokohama
  • Updated January 30, 2025
  • 1 minute to read

    • Update the variable values in existing record producers to capture tokenized data from Epic.

    Before you begin

    Role required: admin

    About this task

    When the Care Team Portal is launched inside of Epic Hyperspace via Hyperdrive, record producers can capture tokenized querystring parameters to populate record producer variables.

    This capture is possible due to a catalog client script associated with the record producers.

    For Care Team Operations for Healthcare IT: The script is called “Populate EMR sessions params” and can found on the “Report an EMR issue” record producer.

    For Care Team Operations for Biomed: The script is called “Populate biomed service session params” and can be found on the Request other biomed service” record producer.

    Note:
    The preceding client scripts only work with the Care Team Portal.

    To capture the tokenized querystring parameters, a variable must be created and the name must start with “sysparm_”. This same variable name must be included at the end of the launch URL in the Epic Hyperspace FDI record.

    Example of variable naming for capturing tokenized data from an EMR system.

    For example, to capture the “Workstation ID” field from an EMR system, the name value of the variable should “sysparm_workstation_id” and the querystring parameter would be “sysparm_workstation_id =%WORKSTATIONID%”.

    A complete launch querystring would look like the following:
    https://<instance-name>.service-now.com/careteam?glide_sso_id=<identity-provider-sysid>&sysparm_workstation_id=%WORKSTATIONID%&sysparm_user_template=%USERTEMPLATE%

    Procedure

    1. In the Record Producer, navigate to the Variables related list.
    2. Select New.
    3. Fill in fields as needed.
    4. Confirm that the name value of all variables begins with sysparm_ for any field in which you want to capture data coming from an EMR system.
    5. Select Submit.