Data Gatherers
The Data Gatherer endpoint is used to create the form which will be filled in by the Rater while taking an assessment. Once the Data Gatherer has been completed, the data collected can be retrieved using the "Get DataGathering" endpoint, which returns the results as as Observation Item Sets.
When calling the "Create DataGathering" endpoint, the Janus API will provision a Data Gathering instance, and return two URLs to the caller. The link object containing "format": "HTML" is the URL to the assessment itself. This should be distributed to the Rater by the calling system, so that they may take the assessment.
The second link object, with "format": "JSON" is an assembled "Get DataGathering" endpoint URL, used to fetch the results of the Data Gathering session. The results cannot be retrieved until the assessment has been completed by the Rater; data for partially completed Data Gatherings are unavailable for retrieval.
The primary output of a Data Gathering instance is an array of Observation Item Sets. These are the logically grouped seta of captured inputs received during the Data Gathering phase. These Observation Item Sets are required for the next phase of the Janus Lifecycle, the Evaluation phase.
The following endpoints are available related to Data Gatherers:
The following table described several errors that may be encountered related to Data Gatherers, as well as how they may be resolved:
| Code | Description | Resolution |
|---|---|---|
| 400 | Invalid DataGathererID | Verify that the input dataGathererID is valid for the provided measureID |