VistA Analysis » VistA Reference » RPCs » QACV PERSON LOOKUP VLH

QACV PERSON LOOKUP VLH

Pass the name of an employee formatted as “last_name,first_name”. The routine does a lister call on the VistA NEW PERSON file (200) to findthe next set of records that match the name. Partial name lookup issupported. For example, “Sm” will find all “Smiths” and Smurfs, “Sm,J”will find “Smith,Joe”, and “Smurf,Jimmy”. The routine returns the IEN, name components, title and mail code for theperson(s) who match the lookup value, in XML format. In addition, the XMLdata contains a flag indicating whether there are more matching records toreturn. If it is set to 1, then the caller can make another call to getthe next ‘N’ records. The XML data also contains a ‘next name’ and ‘nextIEN’ value. This is used to tell the FileMan Lister where to start lookingon subsequent calls, in order to return the next N records. These two’from’ values must be passed as input parameters to subsequent calls.

Properties

Property Value
Label EN
MUMPS Implementation QACVEMPX
Return Type GLOBAL ARRAY

Input Parameters

Name Type Maximum Data Length Required Description
EMPNAME LITERAL 60 true Employee's name with last name first. Ex: Smith,Joe
PATSROWS LITERAL 12 true Number of employees to return in each call. If not passed, the defaultvalue will be the next 10 matching employees.
PATSFRM0 LITERAL 35 true On the first call to this RPC, this parameter should be set to the emptystring "". On subsequent calls to find more matches to the same lookup value, the parameter must be set to the "patsFrom0" attribute value fromthe XML document output by the previous call. The attribute will contain the starting NAME value for the next search.
PATSFRM1 LITERAL 35 true On the first call to this RPC, this parameter should be set to the emptystring "". On subsequent calls to find more matches to the same lookup value, the parameter must be set to the "patsFrom1" attribute value fromthe XML document output by the previous call. The attribute will contain the starting IEN value for the next search.


Document generated on August 31st 2022, 2:55:43 pm