# | Name | Location | Type | Details | Index | Description |
---|---|---|---|---|---|---|
.01 | name(+) | 0;1 | FREE TEXT | This is the name of the dialog entry. Dialogs that are auto-generated from a reminder will default to the name of the reminder for ease in identifying the reminder dialog entry. Dialog elements that are auto-generated use the following naming convention: Finding type prefix_ _Name from finding file_ _Resolution Status. Examples of two dialog element entry names generated from an Exam file entry for DIABETIC EYE EXAM follow. EX DIABETIC EYE EXAM DONE EX DIABETIC EYE EXAM DONE ELSEWHERE Any item created locally can use any type of naming convention. Your site may want to create special namespacing for dialog entries that you create locally. Entries prefixed with PXRM are prompts, result groups, and result elements that were distributed with the Clinical Reminders package. The PXRM-prefixed prompts are the additional prompts that can be asked for particular types of PCE findings and WH Notification Purpose. For example: PXRM COMMENT can be added to any PCE file to allow the user to enter an additional COMMENT beyond the dialog element's progress note text, and the PXRM LEVEL OF UNDERSTANDING can only be used with PCE Education Topic findings. | ||
2 | source reminder | 0;2 | POINTER | 811.9 | AG | This identifies which reminder definition is associated with this "Reminder Dialog" entry. "Reminder Dialog" type entries are the only entries that require this field. |
3 | disable | 0;3 | SET OF CODES | 0:NO 1:DISABLE AND SEND MESSAGE 2:DISABLE AND DO NOT SEND MESSAGE | This field disables the use of a dialog item. If a dialog item is marked as DISABLE AND SEND MESSAGE and a user tries to use it in CPRS, a message will be sent to the Clinical Reminders mail group. | |
4 | type(+) | 0;4 | SET OF CODES | P:prompt E:dialog element R:reminder dialog F:forced value G:dialog group S:result group T:result element | TYPE | This field defines what type of dialog component this entry is. The type determines the processing that can occur with this entry. Reminder dialogs are the dialog entries that can be mapped to a reminder definition. Reminder dialogs will typically contain several dialog elements and/or dialog groups. Dialog elements that are auto-generated represent a finding item and resolution status combination, based on the Finding Type Parameters for auto-generation. The dialog elements can be defined manually if needed. Dialog elements must have the FINDING ITEM field defined in order to cause the finding to be updated automatically. When no finding item is defined, the dialog element is treated as a header or instruction text in the CPRS GUI. Sites can also add Additional Finding items to automatically update when a dialog element is checked off. An example of using the additional finding would be for a dialog element for a diagnosis, that must always be recorded with a second diagnosis. Another example is when an Exam or Education Topic dialog element checked off should automatically add an additional ICD9 and/or CPT finding to PCE. Dialog elements will use the DIALOG/PROGRESS NOTE TEXT to display in the CPRS GUI window. This text will also be added to the progress note, unless the optional ALTERNATE PROGRESS NOTE TEXT field is defined. If the dialog text to display to the user needs to be different from the text to add to the progress note, use the ALTERNATE PROGRESS NOTE TEXT field to define the progress note text. Dialog Groups can be used to group dialog elements together. Groups can be displayed with a box around them and have selection rules applied to them (e.g., select one, one or more) A dialog element can be changed to a dialog group by changing its TYPE. Prompts are distributed in the PXRM namespace to represent additional fields that the user can enter when an element is checked off. Prompts are added to dialog elements during auto-generation based on the finding type parameters. The PXRM COMMENT field is a generic comment field that can be used on all PCE related finding items. Dialog elements for "DONE ELSEWHERE" need to require the historical visit date prompt. The forced value is similar to a prompt, except it represents a stuffed prompt which doesn't need to be presented to answer. The PXRM prompts can be copied for local modification to create additional forced value entries if necessary. Prompts created locally (not copies of PXRM prompts) are treated as display text with checkboxes, which, when checked off, add text to a comment field which is added to the progress note text. Refer to these as Local Comment Prompts. Result Groups and Result Elements are distributed in the PXRM namespace and are associated with Mental Health Instrument finding items during auto-generation of a reminder dialog. When the mental health instrument finding item dialog element is selected by the CPRS GUI user, a window will be opened which contains the test's questions and probable answers. The selected answers are sent to the mental health package when the user selects OK. The mental health package returns the score and results which can be used within sentences. These sentences are defined as Result Elements, and can vary depending on the test score. If multiple sentences are possible depending on the score, the result elements should be defined in a result group. The result group should be added to the mental health test's dialog elements RESULT GROUP/ELEMENT field. Mental Health tests for use by Mental Health clinicians only are not available for CPRS reminder resolution. A reminder dialog can be made into a dialog group and added to another reminder's dialog. This allows multiple reminders to be addressed by one reminder dialog. Reminder Dialogs can include dialog elements that don't have anything to do with the findings defined in the reminder. Taxonomy dialogs are auto-generated based on the Taxonomy Dialog Parameters. The taxonomy dialog can be used as a black box that allows the users to enter current or historical encounter diagnoses or procedures, based on the selectable list of diagnosis parameters. Alternatively, a taxonomy can have individual dialog elements created for each coded value in the selectable list of diagnoses and procedures. It may be more useful for sites to create dialog elements for the common diagnoses and procedures they actively use and add them to groups, similar to the encounter form section and coded value groupings. |
5 | caption | 0;5 | FREE TEXT | The caption is used for prompt, dialog group, and reminder components. When a prompt has a caption defined, this is the text that should be used whenever the prompt is asked (e.g., Comment:). A dialog group can use the caption field to specify a header to use on a box around the group of dialog elements. The reminder dialog component can use the caption to specify a header to use on a box around the dialog elements for a reminder. | ||
6 | box | 0;6 | BOOLEAN | Y:YES N:NO | This flag will be used to determine whether the components will be presented to the user in a box. If the caption field is defined, it will appear as header text in the top line of the box. | |
7 | number of indents | 0;7 | NUMERIC | This is the number of indents that should be made before presenting the group's components/elements. Indent is used only for dialog groups. | ||
8 | share common prompts | 0;8 | BOOLEAN | 1:YES 0:NO | This field is used only for a dialog group where different dialog elements have common prompts. Prompts will be shared for all dialog elements unless otherwise selected. | |
9 | group entry | 0;9 | SET OF CODES | 1:ONE SELECTION ONLY 2:ONE OR MORE SELECTIONS 3:NONE OR ONE SELECTION 4:ALL SELECTIONS ARE REQUIRED 0:NO SELECTION REQUIRED | Used for dialog groups only. 1 indicates that only one element in the dialog group may be selected. 2 indicates that one or more elements must be selected. 3 indicates that either none or one selection is required. 4 indicates all selections are required. 0 or null indicates no selection required. | |
10 | components | 10;0 | MULTIPLE | 801.412 | This field contains the components that are used to process a reminder. Generally the components relate to the TYPE of entry in the Reminder Dialog File: Reminder dialogs have dialog group or dialog element components. Dialog groups have a combination of dialog element components. Dialog elements have prompt and forced value components. | |
13 | resolution type | 1;3 | POINTER | 801.9 | This field contains what type of resolution is represented by this dialog entry. | |
14 | finding type | 1;4 | POINTER | 801.45 | 1f an additional prompt is restricted to use with only one type of finding item this field contains the mnemonic of the finding type. The mnemonics allowed are: CPT Procedure ED Education Topic EX Exam HF Health Factor IM Immunization OI Orderable Item POV Diagnosis (ICD9) ST Skin Test VM Vital Measurement WH WH Notification Purpose (e.g. PXRM Contraindicated is restricted to IMMUNIZATION, finding type IM) | |
15 | finding item | 1;5 | VARIABLE-POINTER | 9999999.09, 9999999.14, 9999999.28, 9999999.15, 9999999.64, 120.51, 811.2, 101.41, 601.71, 790.404 | This is the finding item that should be created if the dialog element/group is checked in CPRS. Additional findings may be entered into the additional findings field. | |
17 | orderable item | 1;7 | POINTER | 101.43 | Orderable item from the reminder definition. | |
18 | additional findings | 3;0 | MULTIPLE | 801.4118 | ||
21 | default value | 2;1 | FREE TEXT | This is the default value for an additional prompt. If entering defaults for the PXRM VISIT DATE prompt (or copies) then the following codes are available: 0 - no year is initially set (forces required dates to be entered). M - Month is required. M0 - Month is required, no year initially set. | ||
22 | forced value | 2;2 | FREE TEXT | This is the value that will be used for a forced value type dialog. | ||
23 | exclude from progress note | 2;3 | BOOLEAN | 1:YES 0:NO | This field indicates that the question text of the dialog element will be excluded from the progress note. | |
24 | prompt caption | 2;4 | FREE TEXT | This is the caption that will be used for this prompt. This caption can be overridden by the OVERRIDE PROMPT CAPTION field in the ITEMS multiple, which can be more specific for the instance of the prompt. | ||
25 | dialog/progress note text | 25;0 | WORD-PROCESSING | This is the sentence text that will appear in the reminder dialog and progress note. | ||
35 | alternate progress note text | 35;0 | WORD-PROCESSING | This field is only required if the text on the progress note differs from the dialog text. | ||
45 | checkbox sequence | 45;0 | MULTIPLE | 801.4145 | Comment prompts (with a GUI Process ID of COM) may have a number of checkboxes associated with the comment prompt. | |
46 | gui process id | 46;1 | POINTER | 801.42 | Additional prompts and forced values which update PCE should have a GUI Process ID. If an additional prompt or forced value is created by copying one of the PXRM prompts, the GUI Process ID field will automatically be populated by the copy process. | |
50 | hide/show group | 0;10 | SET OF CODES | 1:HIDE 0:SHOW | Used for dialog groups. 1 indicates that the group will be hidden until checked 0 indicates that the group will be displayed | |
51 | suppress checkbox | 0;11 | SET OF CODES | 1:SUPPRESS | If the field is set to SUPPRESS, the dialog element or group header will be displayed without a checkbox. Otherwise the WP text will be presented with a checkbox. If the dialog element or group header has a finding item associated with it the SUPPRESS CHECKBOX flag will be ignored. Also if the HIDE/SHOW GROUP field is set to hide, then the SUPPRESS CHECKBOX field will be ignored (the group header question must be a checkbox). | |
52 | indent progress note text | 0;12 | SET OF CODES | 1:INDENT 0:NO INDENT | In a dialog group the dialog questions may be indented. This field allows the progress note text to be indented also. | |
53 | result condition | 0;13 | FREE TEXT | This field is used for dialog result elements only. The result condition determines if the progress note text of the result element will be included in the progress note e.g., I SCORE<2 will insert the text in the progress note if the SCORE from the mental health test is below 2. Result Elements will only use the Raw Score returned from a MH test. | ||
54 | exclude mh test from pn text | 0;14 | BOOLEAN | 1:YES 0:NO | This flag is used to control whether or not a mental health instrument question will be excluded from the progress note text when the component is acted upon. | |
100 | class(+) | 100;1 | SET OF CODES | N:NATIONAL V:VISN L:LOCAL | This is the class of dialog. National dialogs cannot be edited. | |
101 | sponsor | 100;2 | POINTER | 811.6 | This is the organization or group that sponsors this dialog. | |
102 | review date | 100;3 | DATE-TIME | The REVIEW DATE is used to determine when the dialog should be reviewed, to verify that it is current with the latest standards and guidelines. | ||
110 | edit history | 110;0 | MULTIPLE | 801.44 | This multiple is used to record a history of changes to the dialog. | |
111 | identify | 0;16 | FREE TEXT | AC | This field will associate a dialog with a package or module. Example: if the field contained the letters IHD, then this dialog would be part of the Ischemic Heart Disease project. If one dialog had IHD1 in this field and another had IHD2 located in this field, we would know that they were associated with each other and were both part of the same project. | |
112 | patient specific | 0;17 | SET OF CODES | 1:TRUE 0:FALSE | This field is used to identify a Reminder Dialog that has branching logic defined in the dialog. It is used in conjunction with three additional fields (Reminder Term, Reminder Term Status, and Replacement Element/group) defined at the item level of the Reminder Dialog. This field is used by CPRS to identify if the dialog set-up should be cached or re-built between every use. If the field is set to Yes, then the dialog will be re-loaded every time it is opened in CPRS. If the field is set to No or Null, the dialog set-up will be stored in CPRS the first time the dialog is loaded for the user. | |
113 | mh test required | 0;18 | SET OF CODES | 0:Optional open and optional complete (partial complete possible) 1:Required open and required complete before finish 2:Optional open and required complete or cancel before finish | The value defined in this field is used to control whether or not a mental health (MH) test is required to open from the reminder dialog, and whether the test must be completed before the reminder dialog can be finished in CPRS. If the value is 0, the user is not required to select/open the MH test before the reminder dialog can be finished. If the value is 1, the user is required to select/open and complete the MH test in the reminder dialog before the reminder dialog can be finished. If the value is 2, the user is not required to select/open the MH test in the reminder dialog; however, if the user opens the MH test, then the user is required to complete or Cancel the MH test before the reminder dialog can be finished. Clicking Cancel in the MH test dialog is considered the same as not opening the MH test. A value of 2 only works with CPRS 27 and the YS_MHA.dll file. If 2 is used in a pre-CPRS 27 environment, the value of 2 will be considered the same as the value 1. | |
114 | lock | 100;4 | BOOLEAN | 0:NO 1:YES | This field is used to "Lock" a reminder dialog, dialog element, and/or a dialog group from being copied and/or edited. It will prevent any copying and/or editing of a dialog element if a finding item is defined or if the only finding item defined for the element/group is an order. | |
116 | reminder term | 49;1 | POINTER | 811.5 | This field is a pointer to file 811.5. If a reminder term is defined in this field when the dialog is loaded by CPRS, the reminder term will be evaluated. The Reminder Term evaluation will return either a True of False value. The value returned by the Reminder Term evaluation is used in conjunction with the Reminder Term Status field. | |
117 | reminder term status | 49;2 | SET OF CODES | 1:TRUE 0:FALSE | This field is used in conjunction with the Reminder Term field. It will be used to determine if a Reminder Dialog Element/Group should do a special action. When the Reminder Term is defined in field #116, the True/False result of the term evaluation will be compared to the value defined in this field. If the value matches the dialog, it will complete the action defined in field #118. If the reminder term evaluation value does not match the value defined in this field, the default action of the element/group is loaded into CPRS. | |
118 | replacement element/group | 49;3 | POINTER | 801.41 | This field is used to determine if a dialog element/group should be replaced with another element/group or if the original element/group should be suppressed in the Dialog. If the Reminder Term defined in field #116 is evaluated and matches the value defined in field #117, then the dialog element/group will either be replaced or suppressed depending on the value defined in this field. This field points to file 801.41. If there is an active element/group defined in this field, then the original dialog element/group will be replaced with the new dialog element/group. If this field is null, then the original dialog element/group will be suppressed in CPRS. | |
119 | mh test | 50;1 | POINTER | 601.71 | This field is used to assign a mental health test to a result group. The value assigned to this field must match the mental health test assigned to the dialog element finding item. | |
120 | mh scale | 50;2 | NUMERIC | This field stores the mental health scale number used when obtaining a score for the mental health test defined in the MH Test field #119. | ||
121 | result group list | 51;0 | MULTIPLE | 801.41121 | This multiple assigns one or more result groups to the MH Test finding item, field #119, for creating progress note text. The text will change depending on the score of the MH Test. The score depends on the scale defined in the MH Scale field, #120. | |
123 | taxonomy pick list | TAX;1 | SET OF CODES | A:ALL D:DIAGNOSIS ONLY P:PROCEDURE ONLY N:NO PICK LIST | This field is used to determine how a Taxonomy should be display to an user in CPRS. A selection of: A: Displays two pick lists one for Diagnosis Codes and one for procedure codes. D: Displays a pick list for Diagnosis Codes only. The procedures codes will automatically be filed to VistA when the dialog is finish. P: Displays a pick list for Procedure Codes only. The diagnosis codes will automatically be filed to VistA when the dialog is finish. N: Does not displays a pick list. Both the diagnosis and procedures codes will be filed to VistA when the dialog is finish. | |
141 | pov header | POV;1 | FREE TEXT | This field is used to set the diagnosis header text to display in CPRS when using a Taxonomy. | ||
142 | cpt header | CPT;1 | FREE TEXT | This field is used to set the Procedure Text to display in CPRS when using a Taxonomy. |