STANDARD DATA DICTIONARY #9000010.23 -- V HEALTH FACTORS FILE 9/29/25 PAGE 1
STORED IN ^AUPNVHF( *** NO DATA STORED YET *** SITE: WWW.BMIRWIN.COM UCI: VISTA,VISTA (VERSION 1.0)
DATA NAME GLOBAL DATA
ELEMENT TITLE LOCATION TYPE
-----------------------------------------------------------------------------------------------------------------------------------
This file has been defined for joint use by the Indian Health Service and the Department of Veteran Affairs.
This is the file used for storing patient health factors identified at a visit. Data must exist in the Patient/IHS and Visit file
for a patient's visit before data can be entered in the V Health Factor file.
IDENTIFIED BY: PATIENT NAME (#.02)[R], VISIT (#.03)[R]
CROSS
REFERENCED BY: VISIT(AA), PATIENT NAME(AATOO), HEALTH FACTOR(AATOO1), VISIT(AD), VISIT(AV10), HEALTH FACTOR(B), PATIENT NAME(C)
INDEXED BY: HEALTH FACTOR & PATIENT NAME & VISIT & EVENT DATE AND TIME (ACR), EVENT DATE AND TIME & DATA SOURCE & PATIENT NAME
(AED)
LAST MODIFIED: OCT 5,2022@14:55:07
9000010.23,.01HEALTH FACTOR 0;1 POINTER TO HEALTH FACTORS FILE (#9999999.64) (Required)
INPUT TRANSFORM: S DIC("S")="I $P(^(0),U,10)=""F"",$P(^(0),U,11)'=1" D ^DIC K DIC S DIC=DIE,X=+Y K:Y<0 X
LAST EDITED: AUG 10, 2017
HELP-PROMPT: Select the health factor identified at the visit.
DESCRIPTION: This is the entry in the Health Factor file that most closely represents the patient's health
factor status at the encounter for a given health factor category.
SCREEN: S DIC("S")="I $P(^(0),U,10)=""F"",$P(^(0),U,11)'=1"
EXPLANATION: Prevents selection of inactive and/or category health factor entries.
CROSS-REFERENCE: 9000010.23^B
1)= S ^AUPNVHF("B",$E(X,1,30),DA)=""
2)= K ^AUPNVHF("B",$E(X,1,30),DA)
CROSS-REFERENCE: 9000010.23^AATOO1^MUMPS
1)= I $P(^AUPNVHF(DA,0),U,2)]"",$P(^(0),U,3)]"" S ^AUPNVHF("AA",$P(^AUPNVHF(DA,0),U,2),X,(9999999-$
P(^AUPNVSIT($P(^AUPNVHF(DA,0),U,3),0),".")),DA)=""
2)= I $P(^AUPNVHF(DA,0),U,2)]"",$P(^(0),U,3)]"" K ^AUPNVHF("AA",$P(^AUPNVHF(DA,0),U,2),X,(9999999-$
P(^AUPNVSIT($P(^AUPNVHF(DA,0),U,3),0),".")),DA)
This cross-reference is used for searches in sequence by patient, health factor internal entry
number, inverted visit date, and internal entry number.
"AA",PATIENT,HEALTH FACTORS,VISIT,DA
RECORD INDEXES: ACR (#1680)
9000010.23,.02PATIENT NAME 0;2 POINTER TO PATIENT/IHS FILE (#9000001) (Required)
LAST EDITED: JAN 02, 2019
HELP-PROMPT: Enter the patient to whom the health factor was given.
DESCRIPTION: This is the patient to whom the health factor was given during the encounter.
TECHNICAL DESCR: This is a pointer to the PATIENT/IHS file, #9000001, which is DINUMED to the PATIENT file, #2. This
field is always stuffed by the application. No editing is allowed.
UNEDITABLE
CROSS-REFERENCE: 9000010.23^AATOO^MUMPS
1)= I $P(^AUPNVHF(DA,0),U,3)]"" S ^AUPNVHF("AA",X,$P(^AUPNVHF(DA,0),U,1),(9999999-$P(+^AUPNVSIT($P(
^AUPNVHF(DA,0),U,3),0),".",1)),DA)=""
2)= I $P(^AUPNVHF(DA,0),U,3)]"" K ^AUPNVHF("AA",X,$P(^AUPNVHF(DA,0),U,1),(9999999-$P(+^AUPNVSIT($P(
^AUPNVHF(DA,0),U,3),0),".",1)),DA)
This cross-reference is used for searches in sequence by patient, health factor internal entry
number, inverted visit date, and internal entry number.
"AA",PATIENT,HEALTH FACTOR,VISIT,DA
CROSS-REFERENCE: 9000010.23^C
1)= S ^AUPNVHF("C",$E(X,1,30),DA)=""
2)= K ^AUPNVHF("C",$E(X,1,30),DA)
This cross reference allows look-up of health factors by patient.
RECORD INDEXES: ACR (#1680), AED (#1681)
9000010.23,.03VISIT 0;3 POINTER TO VISIT FILE (#9000010) (Required)
INPUT TRANSFORM: S DIC("S")="I $P(^(0),U,5)=$P(^AUPNVHF(DA,0),U,2)" D ^DIC K DIC S DIC=DIE,X=+Y K:Y<0 X
LAST EDITED: JAN 02, 2019
HELP-PROMPT: Enter the visit date/time for the encounter where the health factor was given.
DESCRIPTION: This is the encounter or occasion of service defined in the VISIT file that represents when and
where the health factor was given.
TECHNICAL DESCR: This is a pointer to the VISIT file, #9000010. This field is stuffed by the applications. No
editing is allowed.
SCREEN: S DIC("S")="I $P(^(0),U,5)=$P(^AUPNVHF(DA,0),U,2)"
EXPLANATION: VISIT MUST BE FOR CURRENT PATIENT
UNEDITABLE
CROSS-REFERENCE: 9000010.23^AD
1)= S ^AUPNVHF("AD",$E(X,1,30),DA)=""
2)= K ^AUPNVHF("AD",$E(X,1,30),DA)
This cross-reference is used for searches by the visit pointer and internal entry number.
"AD",VISIT,DA
CROSS-REFERENCE: 9000010.23^AA^MUMPS
1)= Q:$P(^AUPNVHF(DA,0),U,2)="" S ^AUPNVHF("AA",$P(^AUPNVHF(DA,0),U,2),$P(^(0),U,1),(9999999-$P(+^
AUPNVSIT(X,0),".",1)),DA)=""
2)= Q:$P(^AUPNVHF(DA,0),U,2)="" K ^AUPNVHF("AA",$P(^AUPNVHF(DA,0),U,2),$P(^(0),U,1),(9999999-$P(+^
AUPNVSIT(X,0),".",1)),DA)
This cross-reference is used for searches in sequence by patient, health factory pointer, inverted
visit date, internal entry number.
"AA",PATIENT,HEALTH FACTOR,VISIT,DA
CROSS-REFERENCE: 9000010.23^AV10^MUMPS
1)= D ADD^AUPNVSIT
2)= D SUB^AUPNVSIT
This cross-reference adds and subtracts from the dependent entry count in the VISIT file.
RECORD INDEXES: ACR (#1680)
9000010.23,.04LEVEL/SEVERITY 0;4 SET
'M' FOR MINIMAL;
'MO' FOR MODERATE;
'H' FOR HEAVY/SEVERE;
LAST EDITED: JAN 02, 2019
HELP-PROMPT: Enter a Level/Severity for the health factor.
DESCRIPTION: Level/Severity provides an approximate magnitude associated with the health factor.
9000010.23,220MAGNITUDE 220;1 FREE TEXT (audited)
INPUT TRANSFORM: K:$L(X)>25!($L(X)<1)!('$$VMAGNITUDE^PXINPTR(.X)) X
MAXIMUM LENGTH: 25
LAST EDITED: MAR 28, 2022
HELP-PROMPT: Enter the magnitude of the measurement, a positive or negative number, up to 14 digits and 9
decimal places.
DESCRIPTION: If a measurement has been recorded for an entry in this file, this is the magnitude of the
measurement.
AUDIT: EDITED OR DELETED
NOTES: XXXX--CAN'T BE ALTERED EXCEPT BY PROGRAMMER
9000010.23,221UCUM CODE 220;2 POINTER TO UCUM CODES FILE (#757.5) (audited)
LAST EDITED: MAR 28, 2022
HELP-PROMPT: Enter the UCUM code of the measurement.
DESCRIPTION: If a measurement has been recorded for an entry in this file, this is the unit of the measurement.
AUDIT: EDITED OR DELETED
9000010.23,1201EVENT DATE AND TIME 12;1 DATE
INPUT TRANSFORM: S %DT="ESTX" D ^%DT S X=Y K:Y<1 X
LAST EDITED: DEC 11, 2020
HELP-PROMPT: Enter the date and time the health factor was recorded.
DESCRIPTION: Event Date and Time reflects the actual time the health factor was given. The Event Date does not
have to be the Visit Date, but it cannot be a future date.
If a user wants to enter a historical health factor the user should use the Historical Encounter
entry action to document the historical health factor. Historical entries will not be eligible for
credit.
PCE data sources for automatic (scanning) data capture will be blank unless the Event Date and Time
are passed to PCE for filing.
TECHNICAL DESCR: Event Date and Time defaults to NOW and reflects the actual time the health factor was given. The
Event Date does not have to be the Visit Date, but it cannot be a future date.
If a user wants to enter a historical health factor the user should use the Historical Encounter
entry action to document the historical health factor. Historical entries will not be eligible for
credit.
PCE data sources for automatic (scanning) data capture will be blank unless the event date and time
are passed to PCE for filing.
RECORD INDEXES: ACR (#1680), AED (#1681)
9000010.23,1202ORDERING PROVIDER 12;2 POINTER TO NEW PERSON FILE (#200)
LAST EDITED: MAY 13, 1996
HELP-PROMPT: Enter the provider who ordered this health factor recorded.
DESCRIPTION:
This field can be used to document the provider who ordered the health factor recorded.
9000010.23,1204ENCOUNTER PROVIDER 12;4 POINTER TO NEW PERSON FILE (#200)
LAST EDITED: DEC 19, 1994
HELP-PROMPT: Enter the provider who recorded the health factor.
DESCRIPTION:
This is the provider who recorded the health factor.
9000010.23,80101EDITED FLAG 801;1 SET
'1' FOR EDITED;
LAST EDITED: JAN 02, 2019
HELP-PROMPT: Enter 1 if the original health factor data is being edited.
DESCRIPTION: This field is automatically set to 1 if PCE detects that any original health factor data is being
edited.
TECHNICAL DESCR: PCE filing logic automatically compares the before and after pictures of the record to determine if
the edited flag should be set to "1".
9000010.23,80102AUDIT TRAIL 801;2 FREE TEXT
INPUT TRANSFORM: K:$L(X)>85!($L(X)<2) X
LAST EDITED: JAN 02, 2019
HELP-PROMPT: The answer must be 2 to 85 characters.
DESCRIPTION: This field is populated automatically by the PCE filing logic. The format of the field is as
follows: Pointer to PCE data source file_"-"_A for Add or E for Edit_" "_DUZ of the person who
entered the data_";"...
TECHNICAL DESCR: The PCE filing logic requires a pointer to the PCE data source file. If this is not passed, then
PCE filing logic will not process the data.
If the record is a new record, then an "A" is used to specify the source that added the data. If
the record existed previously, PCE filing logic compares the old and new records of information. An
"E" will automatically be used if the filing logic finds the data has been edited. If "E" is used,
then the Edited Flag field is automatically set to 1.
The DUZ is stored in its internal format to represent the user who performed the adding or editing
of data for this record.
Iterations of editing will be concatenated to the previous data source value, up to 85 characters.
9000010.23,81101COMMENTS 811;1 FREE TEXT
INPUT TRANSFORM: K:$L(X)>245!($L(X)<1) X
LAST EDITED: JAN 02, 2019
HELP-PROMPT: Enter a comment 1-245 characters in length.
DESCRIPTION: This is a comment related to the patient's health factor. The provider may enter this manually via
the PCE User Interface.
9000010.23,81201VERIFIED 812;1 SET
'1' FOR ELECTRONICALLY SIGNED;
'2' FOR VERIFIED BY PACKAGE;
LAST EDITED: JAN 02, 2019
HELP-PROMPT: Enter 1 if verified by electronic signature or 2 if verified by package.
DESCRIPTION: This is used to note how the event was verified and is automatically entered by the software.
TECHNICAL DESCR: This is automatically entered by the software and is uneditable for users.
UNEDITABLE
9000010.23,81202PACKAGE 812;2 POINTER TO PACKAGE FILE (#9.4)
LAST EDITED: JAN 02, 2019
HELP-PROMPT: Enter the VistA package from which this health factor originated.
DESCRIPTION: This is the VistA package from which this health factor originated through PCE.
This is automatically entered by the software and uneditable by users.
TECHNICAL DESCR:
UNEDITABLE
9000010.23,81203DATA SOURCE 812;3 POINTER TO PCE DATA SOURCE FILE (#839.7)
LAST EDITED: JAN 02, 2019
HELP-PROMPT: Select the data source for this health factor entry through PCE.
DESCRIPTION: This is the data source for this health factor. It is set automatically and uneditable by users.
TECHNICAL DESCR:
UNEDITABLE
RECORD INDEXES: AED (#1681)
FILES POINTED TO FIELDS
HEALTH FACTORS (#9999999.64) HEALTH FACTOR (#.01)
NEW PERSON (#200) ORDERING PROVIDER (#1202)
ENCOUNTER PROVIDER (#1204)
PACKAGE (#9.4) PACKAGE (#81202)
PATIENT/IHS (#9000001) PATIENT NAME (#.02)
PCE DATA SOURCE (#839.7) DATA SOURCE (#81203)
UCUM CODES (#757.5) UCUM CODE (#221)
VISIT (#9000010) VISIT (#.03)
File #9000010.23
Record Indexes:
ACR (#1680) RECORD MUMPS IR ACTION
Short Descr: Clinical Reminders index.
Description: This cross-reference builds two indexes, one for finding all patients with a particular health factor and one
for finding all the health factors a patient has. The indexes are stored in the Clinical Reminders Index
global as:
^PXRMINDX(9000010.23,"IP",HEALTH FACTOR,DFN,DATE,DAS) and
^PXRMINDX(9000010.23,"PI",DFN,HEALTH FACTOR,DATE,DAS) respectively.
Where
HEALTH FACTOR is a pointer to file #9999999.64.
DFN is a pointer to file #2.
DATE is EVENT DATE AND TIME, if it exists. If it does not, then it is VISIT/ADMIT DATE&TIME.
DAS is the internal entry number of the entry in file #9000010.23.
For all the details, see the Clinical Reminders Index Technical Guide/Programmer's Manual.
Set Logic: D SVFILE^PXPXRM(9000010.23,.X,.DA)
Kill Logic: D KVFILE^PXPXRM(9000010.23,.X,.DA)
Whole Kill: K ^PXRMINDX(9000010.23)
X(1): HEALTH FACTOR (9000010.23,.01) (Subscr 1) (forwards)
X(2): PATIENT NAME (9000010.23,.02) (Subscr 2) (forwards)
X(3): VISIT (9000010.23,.03) (Subscr 3) (forwards)
X(4): EVENT DATE AND TIME (9000010.23,1201) (forwards)
AED (#1681) RECORD REGULAR IR SORTING ONLY
Short Descr: AED,EVENT DATE AND TIME,DATA SOURCE,DA
Description: This cross-reference creates an index of the Event Date and Time field and the Data Source field.
Set Logic: S ^AUPNVHF("AED",X(1),X(3),X(2),DA)=""
Kill Logic: K ^AUPNVHF("AED",X(1),X(3),X(2),DA)
Whole Kill: K ^AUPNVHF("AED")
X(1): EVENT DATE AND TIME (9000010.23,1201) (Subscr 1) (forwards)
X(2): DATA SOURCE (9000010.23,81203) (Subscr 3) (forwards)
X(3): PATIENT NAME (9000010.23,.02) (Subscr 2) (forwards)
INPUT TEMPLATE(S):
PRINT TEMPLATE(S):
SORT TEMPLATE(S):
FORM(S)/BLOCK(S):