Kinetic Sample People Retrieve Version 2

The KSSAMPLEPeople form is a sample People form with a limited number of fields on it. This handler retrieves the specified fields listed above for a single record that matches the qualification built by the combination of the Search By and Search Value parameters. The sole purpose of the handler is to make the record data available to other handlers. Examples of this would be to call this handler after running the KineticSamplePeopleCreate_V1 hander which returns the Entry ID of the record that was created. Once this handler has been run, you can run another handler that could send an email out with information about the People record.

  • Finds record where 'Entry Id' = 'Request ID'.

  • Throws an exception if a record cannot be found.

  • Returns the specified fields as Results of the handler.

Parameters

Name Description
Search By The Search By parameter has 4 options, and configures which field the handler will use in its search qualification
Search Value The Search Value parameter is the value of the Search By field on the record that will be retrieved

Sample Configuration

Name Description
Search By Entry Id
Search Value <%=@results['sample_people_create_v1']['Entry Id']%>

Results

Name Description
Entry Id The 'Request ID' field data of the record being retrieved.
First Name The 'First Name' field data of the record being retrieved.
Last Name The 'Last Name' field data of the record being retrieved.
Employee Number The 'Employee Number' field data of the record being retrieved.
AR Login The 'AR Login' field data of the record being retrieved.
Full Name The 'Full Name' field data of the record being retrieved.
Phone The 'Phone Number' field data of the record being retrieved.
Email Address The 'Email' field data of the record being retrieved.
Status The 'Status' field data of the record being retrieved.
Company The 'Company' field data of the record being retrieved.
Region The 'Region' field data of the record being retrieved.
Site The 'Site' field data of the record being retrieved.
Department The 'Department' field data of the record being retrieved.
Office The 'Office' field data of the record being retrieved.
Unverified The 'Unverified' field data of the record being retrieved.
Address 1 The 'AddrLine1' field data of the record being retrieved.
Address 2 The 'AddrLine2' field data of the record being retrieved.
City The 'City' field data of the record being retrieved.
State/Prov The 'State/Prov' field data of the record being retrieved.
Postal Code The 'Postal Code' field data of the record being retrieved.
Country The 'Country' field data of the record being retrieved.
Supervisor Name The 'Supervisor Name' field data of the record being retrieved.
Supervisor AR Login The 'Supervisor AR Login' field data of the record being retrieved.
Link Id The 'Link Id' field data of the record being retrieved.
instanceId The 'instanceId' field data of the record being retrieved.
Submitter The 'Submitter' field data of the record being retrieved.

Changelog

KineticSamplePeopleRetrieve_V1 (2011-01-07)

  • Initial version. See README for details.

KineticSamplePeopleRetrieve_V2 (2011-02-03)

  • Added Search By and Search Value parameters and removed the Entry Id

parameter. The Search By parameter has 4 options, and configures which field

the handler will use in its search qualification. The Search Value parameter

is the value of the Search By field on the record to be retrieved.


Related Handlers

Kinetic Sample Change Create
Creates an entry in the KS_SAMPLE_Change form based on information input by the end user.
Kinetic Sample Incident Create
Creates an entry in the KS_SAMPLE_Incident form based on information input by the end user.
Kinetic Sample Person Create
Creates a record in the KS_SAMPLE_People form based on the information input by the end user and returns the Request ID of the record created.