General-purpose DocPop URLs can be created using the DocPop URL Creator. For information about using this tool, see the DocPop module reference guide.
To customize a DocPop URL for Epic:
- Create a DocPop URL using the DocPop URL creator. It is located at: https://[ServerName]/[WebServerVirtualDirectory]/docpop/docpopURLCreator.aspx
- Test the DocPop URL to ensure it retrieves the intended documents.
-
Add the following Epic parameters to the beginning of the URL query string,
q=epicUserToken =username &epicPasswordToken =password &epicID =epicuseraccount &epicTimestamp =yyyyMMddHHmmss&
-
Replace the values for epicUserToken, epicPasswordToken, epicID, and epicTimestamp with the correct values for your solution. Refer to the following table for more information:
Parameter
Description
epicUserToken
The value provided in OnBase Configuration for the EpicUsername key. To configure this key, see Configuring the User Name and Password.
epicPasswordToken
The value provided in OnBase Configuration for the EpicPassword key. To configure this key, see Configuring the User Name and Password.
epicID
The user name of the Epic user who is accessing DocPop. If this user name is not found in OnBase, then a new user is created with this value as the user name, and a default password is assigned.
epicTimestamp
The timestamp of the request. This value must be provided in the format yyyyMMddHHmmss using the 24-hour clock, UTC.
Note:These parameters are encrypted in the final URL that is launched from Epic.
For example, suppose the following is the original query string:
-
KT157_0_2_0=%242%2c000.00&clienttype=html&doctypeid=101
When you add the Epic parameters, it becomes the following:
-
q=epicUserToken =username &epicPasswordToken =password &epicID =epicuseraccount &epicTimestamp =20190719145308 & KT157_0_2_0=%242%2c000.00&clienttype=html&doctypeid=101
-
-
Append the query string (preceded by q=) to the DocPop URL. The URL should now resemble the following:
-
https://webserver.com/AppNet/DocPop/docpop.aspx? q=epicUserToken =username &epicPasswordToken =password &epicID =epicuseraccount &epicTimestamp =20190719145308 & KT157_0_2_0=%242%2c000.00&clienttype=html&doctypeid=101
This is not the final URL. When the URL is launched from Epic, the portion of the query string following q= is encrypted.
-
-
Provide the URL with the complete query string to the customer's Epic administrator.
If any issues arise, verify all prerequisites are met. See Prerequisites.