DVBA MVI SEARCH PERSON (3067)    REMOTE PROCEDURE (8994)

This remote procedure passes the delimited person traits to the MVI 
SEARCH PERSON web service and returns the results of the search.

• PERSON TRAITS
  PARAMETER TYPE:   LITERAL
  REQUIRED:   YES
  SEQUENCE NUMBER:   1
  DESCRIPTION:   

  Patient demographics used for search contained in a single "^"-delimited 
    Example:  CAPRI^TEST^PATIENT^999999999^2540101
  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)
   
  

• INITIAL QUANTITY
  PARAMETER TYPE:   LITERAL
  REQUIRED:   NO
  SEQUENCE NUMBER:   2
  DESCRIPTION:   

  This 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.
  

• NAME FORMAT
  PARAMETER TYPE:   LITERAL
  REQUIRED:   NO
  SEQUENCE NUMBER:   3
  DESCRIPTION:   

  This 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.
  

The zero array node returns the caret-delimited record count and search
  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:
status 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]
  Piece 1: Returned record count
  Piece 2: OK or error message text
 
Array node 1 starts the list of caret-delimited matching patient
records.