The Master Data Model for Veteran Care

Developer Documentation » VDM » Name_Components-20

Name Components (20)

This file, introduced with Name Standardization (Patch XU8.0134), holds the component parts of a person’s name as follows: Family (Last) Name (field #1) Given (First) Name (field #2) Middle Name (field #3) Prefix (field #4) Suffix (field #5) Degree (field #6) The “source name” that has these components is identified by the following three fields: File (field #.01) Field (field #.02) IENS (field #.03) The “ANAME” cross-reference on the Family (Last) Name, Given (First) Name, Middle Name, and Suffix fields keeps each component in synchronization with the corresponding source name. In the case of Patch XU8.0134, the source name is the .01 field (the Name field) of the NEW PERSON file (#200). The Degree and Prefix fields are not considered part of a standard name, but can be used to build formatted names for display.

Global: ^VA(20,

Domain: Non-Clinical

Properties

Label/Field Name Field # Description Datatype Attributes Range
File
  file
.01 Answer must be the number of the file or subfile that contains the name
field.
NUMERIC INDEXED
REQUIRED
 
Field
  field
.02 Answer must be the number of the field that contains the name. NUMERIC REQUIRED  
Iens
  iens
.03 Answer must be the IENS of the entry that contains the name. STRING REQUIRED  
Family (last) Name
  family_last_name
1 Answer with the person’s family (last) name. It must begin with an
upper-case letter and can contain only upper-case letters, numbers, and
punctuation, excluding circumflexes (^) and grave accents (`).
STRING REQUIRED  
Given (first) Name
  given_first_name
2 Answer with the person’s given (first) name. It must begin with an
upper-case letter and can contain only upper-case letters, numbers, and
punctuation, excluding circumflexes (^) and grave accents (`).
STRING REQUIRED  
Middle Name
  middle_name
3 Answer with the person’s middle name. It must begin with an upper-case
letter and can contain only upper-case letters, numbers, and punctuation,
excluding circumflexes (^) and grave accents (`). Middle names of NMI and
NMN are not accepted.
STRING    
Prefix
  prefix
4 Answer with the name prefix, such as MR or MS. Answer must begin with an
upper-case letter and can contain only upper-case letters, numbers, and
punctuation, excluding circumflexes (^) and grave accents (`).
STRING    
Suffix
  suffix
5 Answer with the name suffix(es), such as JR, SR, II, or III. Answer
must begin with an upper-case letter and can contain only upper-case
letters, numbers, and punctuation, excluding circumflexes (^) and grave
accents (`).
STRING    
Degree
  degree
6 Answer with the person’s academic or professional degree, such as BS, BA,
MD, or PHD. It must begin with an upper-case letter and can contain only
upper-case letters, numbers, and punctuation, excluding circumflexes (^)
and grave accents (`).
STRING    
Source Name Format Flags
  source_name_format_flags
7 When the name fields in the Name Components file are edited, the “ANAME”
cross-reference updates the corresponding name field in the source file.
This SOURCE NAME FORMAT FLAGS field can be used to control the format of
the name placed in the source name field.

Answer with the flags used in $$NAMEFMT^XLFNAME API. For example,

C : Return a Comma between the Family (Last) and Given (First)
Names.
L : Truncate the returned name to the maximum length as specified
by the data type of the source name field.
L# : Truncate the returned name to a maximum length of #
characters, where # is an integer between 1 and 256.
S : Standardize the name components before building the formatted
name.

If this field is null (i.e., no flags are specified), the default is
“CLS”.
STRING    
Notes About Name
  notes_about_name
11 This field stores notes about the name.

During the New Person Name Conversion, which is run as part of the
post-install routine of Patch XU8.0134, if a name in the NEW PERSON file
contains text in parentheses (), brackets [], or braces {}, that text is
removed from the name, and the original name with the parenthetical text
is recorded in this field.
STRING    

↑ Return to top


Document generated on August 31st 2017, 2:55:41 pm