Process Read Method
The Process API provides access to the Process Resource.
Process Read allows the user to acquire the data of the Process that meets the specified conditions.
|
GET |
https://{Request URI Host}/v1/process?partition=[value]&count=[value]&start=[value]&field=[value,...]&condition=[field=value,...]&itemstate=[value]&keywords=[value,...]&order=[value,...] |
|---|
Scope
The access privilege required for Process Read is as follows:
process_r, candidate_r, resume_r, client_r, recruiter_r, job_r, user_r, option_r
Input Variables
When using the GET or POST Method, the parameter of the HTTP Header must be specified with a value. For details, see HTTP Header.
The following shows the Parameters that can be specified:
Each Parameter is an AND condition for search.
| Required | Parameter | Definition |
|---|---|---|
| ● | partition | Specify a numerical value for the Partition Id. To check the Partition Id that can be accessed, acquire the information using Partition Read. |
| ー | count | Specify the number of records of data to acquire. The range of the values that can be specified is between 1 and 200. If nothing is specified, 10 is assumed to be specified. |
| ー | start | The start index of the data to acquire. Specify a numerical value of 0 or larger. |
| ー | field | Specify items to output. If nothing is specified, Process.P_Id is assumed to be specified. For details, see Read API - Parameter > Read - Field. For information on the Fields that can be specified, see Process - Field List. |
| ー | condition | Specify the search conditions. For details, see Read API - Parameter > Read - Condition. For information on the Fields that can be specified, see Process - Field List. Note that when “deleted” or “all” is specified for the itemstate, the following three Fields and conditions can be specified for “condition.” More than one of the following three conditions can be specified.
|
| ー | itemstate | Specify the status of data to acquire. The following values can be specified. If nothing is specified, “existing” is assumed to be specified. existing: Acquire the undeleted data deleted: Acquire the deleted data all: Acquire the data in all states When “deleted” or “all” is specified, the conditions that can be specified for “condition” are limited. This parameter will be available from 04/10/2018. |
| ー | keywords | Specify the keywords for the conditions for the data to acquire. For details, see Read API - Parameter > Read - Keywords. |
| ー | order | Specify the sorting order of the data when output. If nothing is specified, Process.P_Id:asc is assumed to be specified. For details, see Read API - Parameter > Read - Order. For information on the Fields that can be specified, see Process - Field List. |
Result Values
When the processing is successfully completed, “200” is returned to the Response Header as the HTTP status, and the value that is described in Output Values can be acquired.
If an error occurs, a value other than 200 is returned.
Output Values
The output value can be acquired in the XML format.
| Tag | Definition |
|---|---|
| Process | Route element including the Process that meets the conditions. The number of acquired data is set for Count, and the index of the acquired data is set for Start. Start is the index beginning with 0. Lists every Process as the Item elements. |
| Total | Attribute of the Process. Indicates the total number of records that can be acquired under the specified search conditions. |
| Count | Attribute of the Process. Indicates the number of records of the data acquired this time. |
| Start | Attribute of the Process. Indicates the start index of the data acquired this time. |
| Code | The code that represents the processing result. For details, see Result Code List. |
| Item | Indicates one piece of Process information. Includes a Field element. |
| Field | Stores the value of the specified item. For the names of the elements, see Process - Field List. |
Process Read Sample
This sample code shown below is not encoded. In the case of an actual Request, encoding/decoding may be necessary depending on the content.
The following sample uses Process Read to acquire the Process ID, JOB ID, Position, Resume ID, and Person Name of the individual by specifying the Process = JOB Sent.
|
Input Parameter https://{Request URI Host}/v1/process?partition=999999&field=Process.P_Id,Process.P_Job(Job.P_Id,Job.P_Position),Process.P_Resume,Process.P_Candidate(Person.P_Name)&condition=Process.P_Phase=Option.P_ProcessSoundOut |
|
Output XML <?xml version=”1.0” encoding=”UTF-8” standalone=”yes”?> |