Customize the URL and REST API task parameters for EMR systems

Use scripted extension points to manipulate URL parameters and REST API task parameters for an EMR system.

Before you begin

Install the EMR Help application. For more information, see Install EMR Help.

Role required: admin

About this task

By using extension points, you can easily integrate customizations without having to alter the base code. You can extend standard base functionality using customized scripts. For more information, see Using extension points to extend application functionality.

Procedure

1. Navigate to All > System Extension Points > Scripted Extension Points.
2. In the API Name column, search for and select sn_ind_rmt_help.RemoteHelpParamTransformer.
3. On the Extension Point form, either modify a script include to use the sn_ind_rmt_help.RemoteHelpParamTransformer extension point or create and register a custom script include.
   • Create and register a custom script include.

     For more information, see Registering custom script includes against the scripted extension points.

   • Modify the existing script include by going to the Implementations related list and selecting a script include in the Class column.
     Note:

     By default, the RemoteHelpParamTransformer script include that use the sn_ind_rmt_help.RemoteHelpParamTransformer extension point is available for the EMR Help application.
4. Customize parameters for an EMR system by adding the sn_ind_rmt_help.RemoteHelpParamTransformer extension point to the script include.
   You can create multiple implementations for an extension point and provide an order number for each implementation. The implementation that has the lowest order number is executed first.

   Table 1. EMR system customizations

   Customization	Implementation
   Incoming task parameters	Include the transformIncomingTaskParams method in the sn_ind_rmt_help.RemoteHelpParamTransf​ormer extension point. The method is called from the REST APIs prior to creating and updating IT service requests from an EMR system and enables you to modify any input parameters.
   Outgoing task parameters	Include the transformOutgoingTaskParams method in the sn_ind_rmt_help.RemoteHelpParamTransformer extension point. The method is called from the REST APIs for getting a task list and task details before sending the task-related data to the EMR system.
   Incoming URL parameters	Include the transformURLParams method in the sn_ind_rmt_help.RemoteHelpParamTransformer extension point. This method is called from a service portal before storing the URL parameters. Note: If your EMR system has an encryption algorithm, you can configure the Incoming URL parameters method in the sn_ind_rmt_help.RemoteHelpParamTransformer extension point to decrypt any encrypted task parameters from your ServiceNow instance.

5. On the Extension Point form, click Update.