Links

Titles, text, icons and images can be configured as links, whereby a user action (hover or select) will cause the focus of attention to shift to a different part of the user interface (within Hyperspace, Canto, Haiku, etc.) or to an external information asset running in a Hyperspace activity or a separate program (such as the Internet Explorer browser). This section reminds about the types of links that builders can leverage during clinical system design.

External Links

External links use an Epic application-to-application interface to cause an independent application to open and present intended information, functions or views. Usually, external use universal resource locator (URL) syntax (referred to as 'Navigation Links' by Epic but recognizable to most as "hyperlinks"), causing a specific internet resource to be opened within either an Internet Explorer ActiveX control (when web resources are opened within an Hyperspace activity) or a separate Internet Explorer window.

External links must comply with Connect Care design and link management guides:

Internal Links

Internal links (referred to as 'Activity Links' or 'EpicACT Links' by Epic) allow users to jump from trigger text, title, icons or images in one activity to a different activity within Hyperspace. A link could open a flowsheet in a pop-up window, a text-editing task in a sidebar, a rule-dependent calculator or other tools. Most commonly, a link jumps to a specific activity or navigator within a patient's chart.

Activity Names

Links that facilitate jumps to activities within hyperspace require knowledge of an "activity descriptor". These can be discovered dynamically by opening the Hyperspace activity of interest (e.g., Problem List), then use "Epic button > Help > About Hyperspace". A popup information window should reference the current "Active workspace kind" and "Active activity descriptor". The latter activity descriptor is used when creating an Activity Link.

An alternate method for discovering activity descriptors for link jump destinations is to use the Menu Summary tool (Chart Search for "Menu Summary") to explore all available menu-based activities that can be activated within a particular user profile.

Activity Links in Navigators and Reports

Internal activity links are managed with a special print group (LPG) created as a copy of the "IP ACTIVITY LINK [345226]" code template.

  • In Chronicles (Clinical Administration), navigate to "Reports, Print Groups >> Print Groups (LPG)"

  • Create and appropriately label and number a new record.

  • Configure details on the first page:

    • Style: Rich Text

    • Stylesheet Compatibility: Certified for Low Light and Widget Styles [5]

    • Print Group Type: Standard

    • Color Coding: Blue

  • Print Group Definitions 2 settings:

    • Code Template: IP ACTIVITY LINK [345226] (okay to overwrite existing code)

    • Link caption: short appropriately directive statement ("click here to...")

    • Activity parameter: see list

    • Run parameter: see activity specific options

    • Rule ID: optional CER rule that must evaluate to true for the print group to show

Hypertext Activity Links

Internal activity links can be attached to text in a note or other text area that accepts hyperlinks. The process is the same as creating an external link. The link text is selected and then the hyperlink tool is used in the text editor to create a new link. However, rather than using Internet URL syntax, the following unique Epic syntax is used:

  • Instead of "http://..." use "EpicACT:Activity_Descriptor,Runparams:Param=value".

    • The activity descriptor is found as described above.

    • Run parameters are optional and contingent upon what the activity supports.

  • Launch options and run parameters can both be passed

    • EpicACT:CUSTOM_ACTIVITY,LaunchOptions:1,RunParams:PARAM1|PARAM2,InfoName:INI,InfoValue:EPT

    • EpicACT:CUSTOM_ACTIVITY,LaunchOptions:1,RunParamsURLEncoded:PARAM1%7CPARAM2,InfoName:INI,InfoValue:EPT

  • Example: launch a popup window with a particular flowsheet

    • "EpicACT:IP_FLOWSHEET_POPUP,Runparams:FLTID=1570000001"

Functional Links

  • Create a Note from a Link

    • IP_CREATE_NOTE_REDIR [34611]

      • run parameter is note type identifier (T) and SmartText identifier (S) to use

      • ^T~T~S

      • LPG 345226 IP ACTIVITY LINK can be used to set up such links

Resources