Glossary
| Terminology | Description |
|---|---|
| Addendum | A document, provided in addition to this one, that describes in more detail the implementation of a specific MHS Measure. |
| Assessment | An instance of an MHS Measure that has been created to evaluate a Respondent as outlined in the corresponding Measure documentation. |
| Asynchronous | An API call in which the response is returned to the caller before the results are available. Processing continues to happen in the background, and in Janus results can be fetched using the provided URL in the response. Events can be used to notify the caller when results are available. |
| Data Gatherer | The phase of the Janus lifecycle where a Rater takes the assessment, and data is collected. |
| dataGathererID | A GUID used to represent a specific Data Gatherer type, defined in the ScalesItems document for the measure. For example, some measures have a full-length version of the assessment and a short version, and each would have its own dataGathererID |
| Data Gathering | A specific instance of a Data Gatherer, created when a request is made to the POST Data Gatherer endpoint. Contains Observation Sets and other data about the instance such as subscribed events. |
| dataGatheringID | A randomly generated GUID used to represent a Data Gathering instance. |
| Directives | Instructions or commands that tell other components how to behave, or how to process a submission. Typically, these are choices made by a test administrator that guide other elements of the measure (e.g., what scoring options to apply, and which sections of the measure to activate). Each template can have a unique set of directives. |
| Enrichment | The phase of the Janus lifecycle where reports can be generated to provide additional information and interpretations of results. These are provided in both PDF and DOCX formats, and more formats will be included in the future. This step is optional. |
| EnrichmentID | A GUID used to represent a specific Enrichment type, defined in the ScalesItems document for the measure. For example, in many measures, there are unique Enrichment report formats for each Rater type in the measure. |
| Enrichment Results | A specific instance of an Enrichment, created when a request is made to the POST Enrichment endpoint. Multiple files can be created within a single Enrichment Instance, for example most measures provide both a DOCX and PDF version of the same report. Also contains data about the instance such as subscribed events, for example. |
| EnrichmentResultsID | A randomly generated GUID used to represent an Enrichment Results instance. |
| Enrichment Transformer | A variation of the Enrichment endpoint where data from multiple Sessions is transformed into a combined report. Examples of these types of reports are CSV Scored Datasets, Multi-Rater Reports, and Progress Reports. |
| Evaluator | The phase of the Janus lifecycle where the collected Observation Items from the Data Gatherer phase are scored, producing Outcome Sets. |
| evaluatorID | A GUID used to represent a specific Evaluator, defined in the ScalesItems document for the measure. For example, Observation Sets from different Raters may need to be scored differently, and each of those Evaluators would have its own evaluatorID. |
| Evaluation | A specific instance of an Evaluator, created when a request is made to the PUT Evaluate endpoint. Contains Outcome Sets and other data about the instance such as subscribed events. |
| Event | Messages that are delivered from Janus to a webhook when certain actions take place. This requires an Event Subscription to be set up with MHS. Events in Janus follow Cloud Event Schema 1.0. |
| Event Subscription | A subscription must be set up before a webhook can receive Janus events. See “Events and Webhooks” for more details. Allows a webhook to receive events specific to one tenant. |
| GUID | Globally Unique Identifier. A 128-bit integer formatted into a string, used to uniquely identify resources within Janus. GUIDs follow the format 00000000-0000-0000-0000-000000000000, where each “0” is any hex value from 0-f. |
| Janus | The API through which MHS Measures are available for integration. |
| Measure | A representation of an MHS product within Janus, as defined by the ScalesItems document. Contains zero to many Data Gatherers, one to many Evaluators, and zero to many Enrichments. |
| Observation Item | An item which represents a single data point taken during the Data Gatherer phase. Some examples are: a question response (ex. “1” to represent “Very Likely”), demographic information (ex. “First Name”), a physical measurement (ex. a joystick input), a timestamp. |
| Observation Set | A logical grouping of Observation Items, for example a set of demographic information, or a set of responses to the assessment. Observation Sets are the output of the Data Gatherer phase, and the input to the Evaluate and Enrichment phases. |
| Outcome Item | A result of one or more Observation Items being run through a set of calculations. Some examples are: total score for an assessment, score for an individual Scale, percentile ranking, T-score, assessment validity flags. |
| Outcome Set | A logical grouping of Outcome Items. An Outcome Set would include all calculated results for a specific Scale, or can be used to group other sets of scored results. Outcome sets are the outputs of the Evaluate phase, and the input to the Enrichment phase. |
| Rater | The person who completes the Data Gatherer by performing tasks or providing ratings in response to items/prompts. |
| Respondent | The individual who is assessed or evaluated using the Measure. |
| Resource | A general term for a Data Gathering, Evaluation, or Enrichment Results instance. This refers to a specific occurrence, belonging to a Session. For example, when an assessment is scored, an Evaluation (Resource) is created using an Evaluator (Template) along with the input to create a set of scored results. |
| Scale | In the context of a measure, a Scale is a collection of items measuring a similar theme, concept, or psychological construct. In Janus, this means the set of Observation and Outcome Items related to that specific aspect of the measure. |
| ScalesItems | A legend or data dictionary that provides meta-data and documentation about the measure. Details for each Item, Item Set, identifiers, structure, prompt/description, possible values, and definition of each value are provided in a standardized format. |
| Scored Dataset | A type of Enrichment that compares results from different Janus sessions in a CSV format. |
| Session | Contains all Data Gathering, Evaluation, and Enrichment Results data for a ratee within Janus. A session describes an assessment for an individual, by one rater at a specific point in time. |
| shortID | The 8-character identifier used to describe a specific Item in the ScalesItems document. |
| sourceID | An identifier used to determine the source of a particular Observation Set. For tracking uses only, this field is provided to allow an Observation Set to be traced back to where the data was collected. For most cases, this will be generated during the Data Gathering phase using Data Gatherers contained within Janus. |
| subscriberID | A unique identifier used to route events to a Tenant’s webhook. One subscriberID exists for each Tenant. |
| Subscription Key | A unique key that provides access to the Janus API. Must be included in all requests to Janus, in a “Ocp-Apim-Subscription-Key” header. |
| Synchronous | An API call in which the response is returned to the caller only after processing is completed. |
| Template | Refers to the service that determines how a specific Janus lifecycle step will run. A generalization of Data Gatherer, Evaluator, and Enrichment. |
| Tenant | An environment for a specific customer within Janus. Typically all customers are provided two Tenants, one for testing/development work and one for production. |
| tenantID | A GUID used to refer to a specific Tenant. |