The query string passes authentication credentials and the patient identifier from Epic MyChart to the PPL application.
To construct the query string:
-
Start with the following string:
epicUserToken={value}&epicPasswordToken={value}&epicTimestamp={value}&mpi={value}
-
Replace the {value} of each parameter (braces omitted)
with the appropriate value for your solution.
Refer to the following table for information about each parameter:
Parameter Name
Value Description
epicUserToken
The value configured for the EpicUsername key in the OnBase Configuration module.
For more information about this key, see the Integration for Epic module reference guide.
epicPasswordToken
The value configured for the EpicPassword key in the OnBase Configuration module.
For more information about this key, see the Integration for Epic module reference guide.
epicTimestamp
The timestamp of the request. This value must be provided in the format yyyyMMddHHmmss using the 24-hour clock, UTC.
mpi
The MPI number of the patient record that is being accessed through Epic MyChart.
-
Encrypt and URL-encode the entire string using the encryption key and encryption type configured for the OnBase Integration for Epic.
For more information about encryption settings, see the Integration for Epic module reference guide.
-
Add ?arg= to the beginning of the encrypted string as shown in the following example:
?arg=pcPEM+1P053AbWpFAuxxrqFYqpKb64SlAOqC8mnQCgplQ06VePrBa68hp4tI%2F64aN26vIyI+9Ei+RUtet1Fqk35NKVgywy+ateSEBaGvoxk%3D
The query string is ready to be appended to the URL.
Note: If the OnBase data source has a Facility ID or Facility Mapping table configured, then the PPL query string also must include the epicFacilityID parameter. For more information, see Setting the Facility ID.