Page Description

Use the Result Evaluation Rules page to define a set of conditions that, when met, causes Copia to execute the actions associated with the rule. Copia evaluates result evaluation rules when it receives results from host systems.

For each of the conditions, you may select how Copia applies the condition (e.g., selected locations, all locations except, all conditions must be met, at least one condition must be met, etc.). If the conditions are met and Copia appends order choices, it runs order entry rules on the added order choices.

For more help, click one of the following links:

• Accessing this Page
• Viewing the Rule List
• Searching for a Result Evaluation Rule
• Adding or Editing Result Evaluation Rule Details
• Result Evaluation Rule Warnings
• Setting Result Evaluation Rule Conditions
• Setting Result Evaluation Rule Actions

Accessing this Page

• Click the Administration menu button, click the Rules button, and then click the Result Evaluation Rules submenu link. You must have the necessary security permissions to access the Administration menu button and to create or edit result evaluation rules.

When you click the Administration menu button, Copia opens the main Administration menu, which contains administrative menu buttons, including the Rules menu. To return to the main menu for Copia, click the Lab Tasks menu button.

[Return to Top]

Viewing the Rule List

1. The Result Evaluation Rule List section contains a list of up to 10 result evaluation rules created to execute designated actions if the defined conditions are met when results are received. If the list is longer than one page, use the Page links, located below the list of rules, to navigate through the list.
2. To modify the number of reports on the page, adjust the value of the Displaying __ of __ Reports field. Copia defaults to 10 per page, and displays the total number of items based on your search.
3. To view active result evaluation rules only, select the Show active only checkbox at the top of the Result Evaluation Rules page. You set the inactive/active status in the Result Evaluation Rule Details section of the Result Evaluation Rules details page. See "Adding or Editing Result Evaluation Rule Details" below.
4. To narrow the list of displayed rules, or to find a specific rule, use the Search option. Click the List option to return to the full list of rules. See "Searching for a Result Evaluation Rule" below.
5. If you cannot find the desired result evaluation rule, click the Add or Create New buttons to add a result evaluation rule using the Result Evaluation Rules details page. See "Adding or Editing Rule Details" below.
   • Click the Add button to create a new, blank rule.
   • Click one of the Create New buttons to create a new rule based on the rule that corresponds to the button you clicked.
6. Enter a value into the Sort Order field in the Sort Order column. This field can also be configured via the Sort Order field on the Result Evaluation Rule Details page. The column contains text input elements with the sort order value of the rule associated with the row. Click the Save Sort Orders button to save sort order changes. Users can change the values in the Sort Order column. The text inputs in the Sort Order column will have a red border to indicate that their value has been changed. The changed Sort Order values can be saved by clicking the Save Sort Orders button, after which the Sort Order text inputs will no longer have red borders. Click the Discard Changes button to remove all changes made in the table by returning to the default value. See the "Adding or Editing Result Evaluation Rule Details" section below.
7. Click the name of a result evaluation rule on the Result Evaluation Rules list page to view or edit rule information on the Result Evaluation Rules details page. See "Adding or Editing Result Evaluation Rule Details" below.

[Return to Top]

Searching for a Result Evaluation Rule

1. Select the Search option to search by rule name or description. Enter one or more characters in the Search field and click the Search button to view a list of all result evaluation rules that match your search. Note that Copia searches for embedded text as well as starting characters.
2. If your search generates one or more matches, the matching rules are displayed with rule name, description, and active status when the page refreshes. Select the desired rule to view the details. See "Adding or Editing Result Evaluation Rule Details" below.
3. If no search results are found or if the desired rule is not found, search again, or you may click the Add or Create New buttons to add a new result evaluation rule. See "Adding or Editing Result Evaluation Rule Details" below.
4. Click the List option to view the full list of rules. See "Viewing the Rule List" above.

[Return to Top]

Adding or Editing Result Evaluation Rule Details

1. Use the Result Evaluation Rule Details section of the Result Evaluation Rules details page to add or edit result evaluation rule information.
2. Enter or edit the name for the result evaluation rule in the Name field. This field is required.
3. Select the Active checkbox to allow administrative users to include the rule on the Result Evaluation Rules list page when you select the Show active only checkbox. If the result evaluation rule is inactive, Copia will clear it from the Result Evaluation Rules list page when you select the checkbox. See "Viewing the Rule List" above.
4. Enter in the Description field a brief summary of the rule. Copia displays this information on the Result Evaluation Rule list page to help you distinguish the rules.
5. When this result evaluation rule is enabled, Copia will execute designated actions if the defined conditions are met when it receives results. See "Setting Result Evaluation Rule Conditions" and "Setting Result Evaluation Rule Actions" below.
6. Enter a value into the Sort Order field to define the value of the sort order. Note that the Save Sort Order and Discard Changes buttons will no longer be added to the search results table if the "Sort Order" column is not included in the "Active" column view.
7. Click < Back to List to return to the Result Evaluation Rules list page without saving any changes.
8. If your modifications are complete, click Save to record all changes. Otherwise, complete the remaining sections, and then click Save.

[Return to Top]

Result Evaluation Rule Warnings

There are now warning pop-ups on the Result Evaluation Rules administration page when a user attempts to save the page while actions with unmet conditions are present. Some existing alerts were converted to this method.

More specifically, when a user has the Add Unapproved Result Comment, Edit Test Flag, or Edit Test Result(s) action added while the Test Conditions condition is not added, the pop-up appears and lists the warning(s) depending on which action(s) were added.

The pop-up has two buttons: Save and Continue and Close without Saving. The user can ignore the warning(s) and continue, or halt the save and return to the Result Evaluation Rules administration page.

Another existing dependency alert that was changed will not allow the page to be saved while the Current Order Choices condition is not added.

If the user attempts to save the page while this condition is not met, the pop-up will show up and list the error, but will not display the Save and Continue button, so the user will be forced to return to the page without saving.

Note that when multiple actions are added without the appropriate conditions, or when any conditions that are needed are not set, all of them will be displayed in the pop-up.

Note that the pop-up will be named Warning(s) if only warnings are displayed inside of it and will allow the user to ignore the warnings and continue in this case, while the pop-up will be named Error(s) and will not show the Save and Continue button while the Current Order Choices condition is not set.

[Return to Top]

Setting Result Evaluation Rule Conditions

1. Copia lists the possible result evaluation rule conditions in the Conditions for this Result Evaluation Rule section:
   • Current Order Choices: The order choices that will have order choice-specific actions performed on them, or the order choices that must be included or absent on the order as new or added order choices to allow the rule to fire.
   • Days of the Week: The day(s) of the week that the order choice must be added to the order to allow the rule to fire.
   • Order Choice Priority: Conditions allows the user to select a list of priorities to use as an inclusion list or as an exclusion list. When used as an inclusion list, the rule will trigger if an order choice contains one of the selected priorities, and when used as an exclusion list, the rule will trigger if an order choice does not contain one of the selected priorities. Note that this is an order choice condition, so it will only trigger if all other order choice conditions on the rule trigger for a specified order choice.
   • Order User Defined Field Response: Condition allows the user to select and specify a user-defined field response for an order.
   • Ordering Location User Defined Field Response: Condition allows the user to select and specify a user-defined field response for an ordering location.
   • Ordering Locations: The ordering location(s) that must be included or absent on the order to allow the rule to fire.
   • Ordering Providers: The ordering provider(s) that must be included or absent on the order to allow the rule to fire.
   • Patient User Defined Field Response: Condition allows the user to select and specify a user-defined field response for a patient.
   • Practices: The practice(s) that must accompany the order choice to allow the rule to fire.
   • Result Comment Conditions (for any test): The result comment values (items separated by semicolons) that meet either all or at least one of the defined conditions to allow the rule to fire.
   • Specimen Sources: Whether or not the rule will apply if the order contains specimen part information on the order choice to allow the rule to fire.
   • Test Conditions: The test results' test name, result value, abnormal flag, and result comment values (items separated by semicolons) that meet either all or at least one of the defined conditions to allow the rule to fire.
   • Testing Hosts: The host(s) designated to perform testing that must be included or absent on the order to allow the rule to fire.

   If you are not currently using a condition, Copia disables the condition until you click the Add button (see below).

   Note that when you specify one or more order choices for the "Current Order Choices" condition and you specify one or more additional order choice-specific conditions (e.g., Test Conditions or Testing Hosts), then all of the order choice-specific conditions you set must be true for one of the specified "Current Order Choices," or the rule will not fire during result evaluation.

2. Click the Add or Edit button for the desired condition to establish or modify the condition settings on the Edit Result Evaluation Rule administration page. The condition associated with the button you click determines the available configuration options. See the Admin: Edit Result Evaluation Rule topic.

   For each of the conditions, you may select how Copia applies the condition (e.g., selected locations, all locations except, all conditions must be met, at least one condition must be met, etc.).

3. Click the Remove button for a condition to immediately disable that condition.
4. If your modifications are complete, click Save to record all changes. Otherwise, complete the remaining sections, and then click Save.

[Return to Top]

Setting Result Evaluation Rule Actions

1. Copia lists the possible result evaluation rule actions in the Actions for this Result Evaluation Rule section:
   • Add Result Recipients - Locations: Adds specified locations to an order's Result Recipients list.
   • Appended Forms: Adds the selected form letters to the result report for the order.
   • Appended Order Choices: Adds the selected order choices to the order.
   • Force Result Release Or Hold: Forces a result to be released or held.
   • Send Notifications: Delivers an event notification when the rule fires. Only one notification can be defined.

   If you are not currently using an action, Copia disables the action until you click the Add button (see below).

2. Click the Add or Edit button for the desired action to establish or modify the action settings on the Edit Result Evaluation Rule administration page. The action associated with the button you click determines the available configuration options. See the Admin: Edit Result Evaluation Rule topic.
3. Click the Remove button for an action to immediately disable that action.
4. If your modifications are complete, click Save to record all changes. Otherwise, complete the remaining sections, and then click Save.

[Return to Top]

 © 2018 Orchard Software Corporation