DVBA MVI SEARCH PERSON

TITLEVALUE
NAMEDVBA MVI SEARCH PERSON
DESCRIPTIONThis remote procedure passes the delimited person traits to the MVI
SEARCH PERSON web service and returns the results of the search.
TAGFNDPAT
ROUTINEDVBAMVI1
INPUT PARAMETERSSEQUENCE NUMBER1
INPUT PARAMETERPERSON TRAITS
DESCRIPTIONPatient demographics used for search contained in a single "^"-delimited
string.

Piece 1: FIRSTNAME (required)
Piece 2: MIDDLENAME or INITIAL (optional)
Piece 3: LASTNAME (required)
Piece 4: SSN (9 digits) (required)
Piece 5: BIRTHDATE (FM format) (required)

Example: CAPRI^TEST^PATIENT^999999999^2540101
PARAMETER TYPELITERAL
REQUIREDYES
MAXIMUM DATA LENGTH
INPUT PARAMETERSSEQUENCE NUMBER2
INPUT PARAMETERINITIAL QUANTITY
DESCRIPTIONThis optional parameter populates the initialQuantity value attribute in
the 1305 HL7v3 message. The minimum value is 1 and the maximum value is
10. The parameter will default to 10 when the parameter is not defined.
PARAMETER TYPELITERAL
REQUIREDNO
MAXIMUM DATA LENGTH
INPUT PARAMETERSSEQUENCE NUMBER3
INPUT PARAMETERNAME FORMAT
DESCRIPTIONThis optional parameter controls the format of the full name result
returned. Setting the parameter to 1 causes the name to be formatted as
LASTNAME,FIRSTNAME MIDDLENAME SUFFIX. Any other value or no value causes
the name to be formatted as FIRSTNAME MIDDLENAME LASTNAME SUFFIX.
PARAMETER TYPELITERAL
REQUIREDNO
MAXIMUM DATA LENGTH
RETURN VALUE TYPEARRAY
RETURN PARAMETER DESCRIPTIONThe zero array node returns the caret-delimited record count and search
status results.

Piece 1: Returned record count
Piece 2: OK or error message text

Array node 1 starts the list of caret-delimited matching patient
records.

Piece 1: FULLNAME
Piece 2: SSN (9 digits)
Piece 3: DATE OF BIRTH (external format)
Pieces 4-7 contain the MVI ID components
Piece 4: ID
Piece 5: IdType
Piece 6: Assigning Location
Piece 7: Assigning Issuer

Example results:

Default name format:
R(0)=2^OK
R(1)=CAPRI PATIENT^111905454^01/01/1980^1062212234V192931^NI^200M^USVHA
R(2)=CAPRI T PATIENT^111905454^01/01/1980^1008591712V479586^NI^200M^USVHA

VistA name format:
R(0)=1^OK
R(1)=PATIENT,CAPRI T^111905454^01/01/1980^1008591712V479586^NI^200M^USVHA

Error:
R(0)=0^Acknowledgement Error: Multiple Matches Found[4]
AVAILABILITYAGREEMENT
INACTIVE
CLIENT MANAGER
WORD WRAP ONTRUE
VERSION
SUPPRESS RDV USER SETUP
APP PROXY ALLOWED