{ "$schema": "http://json-schema.org/draft-07/schema#", "title": "SIF IN v3.3", "description": "JSON Schema derived from SIF IN v3.3", "type": "array", "items": { "oneOf": [ { "required": [ "alert" ] }, { "required": [ "codeSet" ] }, { "required": [ "createResponse" ] }, { "required": [ "deleteRequest" ] }, { "required": [ "deleteResponse" ] }, { "required": [ "environment" ] }, { "required": [ "error" ] }, { "required": [ "job" ] }, { "required": [ "namespace" ] }, { "required": [ "pod" ] }, { "required": [ "provider" ] }, { "required": [ "provisionRequest" ] }, { "required": [ "queue" ] }, { "required": [ "state" ] }, { "required": [ "subscription" ] }, { "required": [ "updateResponse" ] }, { "required": [ "xquery" ] }, { "required": [ "zone" ] } ] }, "properties": { "alert": { "$ref": "#/definitions/alert" }, "codeSet": { "$ref": "#/definitions/codeSet" }, "createResponse": { "$ref": "#/definitions/createResponse" }, "deleteRequest": { "$ref": "#/definitions/deleteRequest" }, "deleteResponse": { "$ref": "#/definitions/deleteResponse" }, "environment": { "$ref": "#/definitions/environment" }, "error": { "$ref": "#/definitions/error" }, "job": { "$ref": "#/definitions/job" }, "namespace": { "$ref": "#/definitions/namespace" }, "pod": { "$ref": "#/definitions/pod" }, "provider": { "$ref": "#/definitions/provider" }, "provisionRequest": { "$ref": "#/definitions/provisionRequest" }, "queue": { "$ref": "#/definitions/queue" }, "state": { "$ref": "#/definitions/state" }, "subscription": { "$ref": "#/definitions/subscription" }, "updateResponse": { "$ref": "#/definitions/updateResponse" }, "xquery": { "$ref": "#/definitions/xquery" }, "zone": { "$ref": "#/definitions/zone" } }, "definitions": { "environmentCollection": { "type": "object", "properties": { "environment": { "type": "array", "items": { "$ref": "#/definitions/environment" } } } }, "environment": { "type": "object", "properties": { "type": { "allOf": [ { "$ref": "#/definitions/environmentType" }, { "xml": { "attribute": "true" } } ] }, "id": { "allOf": [ { "$ref": "#/definitions/uuid" }, { "xml": { "attribute": "true" } } ] }, "fingerprint": { "type": "string", "description": "
Unique environment identifier that can be safely shared with others. In order to not compromise security it MUST NOT match the environment's refId, sessionToken, userToken, or applicationKey.
" }, "sessionToken": { "type": "string" }, "solutionId": { "type": "string", "description": "The solution the Application would like to participate in. This is optional only, is advisory, and may be ignored by the Administrator. If processed it may be reflected in the URLs of the infrastructure services which are provided in the consumerEnvironment.
" }, "defaultZone": { "allOf": [ { "$ref": "#/definitions/zone" } ] }, "authenticationMethod": { "type": "string", "description": "Defines the way in which the applicationKey can be used to enforce security.
" }, "instanceId": { "type": "string" }, "userToken": { "type": "string" }, "consumerName": { "type": "string", "description": "A descriptive name for the application that will be readily identifiable to Zone Administrators if it becomes a Registered Consumer
" }, "applicationInfo": { "allOf": [ { "$ref": "#/definitions/applicationInfo" } ] }, "infrastructureServices": { "allOf": [ { "$ref": "#/definitions/infrastructureServices" } ] }, "provisionedZones": { "allOf": [ { "$ref": "#/definitions/provisionedZones" } ] } }, "description": "The Consumer Environment Service is the gateway to all other services. It scopes the Consumer's possible interactions with the infrastructure and any Provider Services accessible from it. The Environment Service provides the set of (possibly customized) information the Application needs to interoperate successfully.
" }, "provisionRequestCollection": { "type": "object", "properties": { "provisionRequest": { "type": "array", "items": { "$ref": "#/definitions/provisionRequest" } } } }, "provisionRequest": { "required": [ "provisionedZones" ], "type": "object", "properties": { "id": { "allOf": [ { "$ref": "#/definitions/uuid" }, { "xml": { "attribute": "true" } } ] }, "completionStatus": { "oneOf": [ { "const": "ACCEPTED" }, { "const": "MIXED" }, { "const": "REJECTED" } ], "xml": { "attribute": "true" } }, "provisionedZones": { "allOf": [ { "$ref": "#/definitions/provisionedZones" }, { "description": "A specific Zone defined for this environment.
" } ] } }, "description": "If an Environment supports self-provisioning Consumers than either this section must initially contain all the rights the Consumer has to all Services in all Zones, or the provisionRequests Infrastructure Service must be present in the Consumer's Environment to allow additional rights to be obtained.
" }, "queueCollection": { "type": "object", "properties": { "queue": { "type": "array", "items": { "$ref": "#/definitions/queue" } } } }, "queue": { "type": "object", "properties": { "id": { "allOf": [ { "$ref": "#/definitions/uuid" }, { "xml": { "attribute": "true" } } ] }, "polling": { "description": "Determines, when no messages are queued, whether the Consumer will have to periodically reissue Polling Requests at timed intervals or can reissue a Polling Request immediately.
", "oneOf": [ { "const": "IMMEDIATE" }, { "const": "LONG" } ] }, "ownerId": { "allOf": [ { "$ref": "#/definitions/uuid" }, { "description": "The Environment ID of the owning Consumer for which this Queue is buffering messages. It is not specified at Queue create time, but is returned as part of the response to a query operation, and serves to allow an administrative application to identify which application the Queue instance is assigned to.
" } ] }, "name": { "type": "string", "description": "A name which the Consumer assigns to the Queue. It is useful for reporting purposes, but is not guaranteed to be unique.
" }, "queueUri": { "type": "string", "format": "uri", "description": "The URI of the Messages Service associated with the Queue instance. This is the endpoint where the 'get next message' requests are issued.
" }, "ownerUri": { "type": "string", "format": "uri", "description": "When present, this contains the URL which the Queue instance will use when it determines the owner needs to be asynchronously alerted that a new message has arrived in the Queue.
" }, "idleTimeout": { "type": "integer", "description": "Is the maximum time in seconds the Messages Service will wait for a message to arrive, before returning an HTTPS Response of 'no message seen' to the Consumer.
" }, "minWaitTime": { "type": "integer", "description": "indicates the minimum time in seconds that the Consumer should wait after receiving a 'no message seen' response to a previous query, before posting another.
" }, "maxConcurrentConnections": { "type": "integer", "description": "Number of (properly identified) concurrent connections supported by (the consumer, if suggested, and) the queue.
" }, "created": { "description": "Time that Queue Instance was Created
" }, "lastAccessed": { "description": "Time that Queue Instance was last Accessed and a message was dequeued.
" }, "lastModified": { "description": "Time that Queue Instance was last Modified by receiving a new incoming message.
" }, "messageCount": { "type": "integer", "description": "The number of messages currently residing in the Queue.
" } }, "description": "The Queues Service supports creation, deletion and querying of Queue (Instance) / Queue Messages Service pairs.
" }, "subscriptionCollection": { "type": "object", "properties": { "subscription": { "type": "array", "items": { "$ref": "#/definitions/subscription" } } } }, "subscription": { "required": [ "queueId", "serviceName", "serviceType", "zoneId" ], "type": "object", "properties": { "id": { "allOf": [ { "$ref": "#/definitions/uuid" }, { "xml": { "attribute": "true" } } ] }, "zoneId": { "type": "string" }, "contextId": { "type": "string", "description": "The unique identity of a context element, which is associated with a Provider of this name and type operating in a Zone with this ID.
" }, "serviceType": { "allOf": [ { "$ref": "#/definitions/serviceType" }, { "description": "The type of the Service
" } ] }, "serviceName": { "type": "string", "description": "The name of the Service. For utilities, this is fixed to one of the defined set of Utility Service Names. For objects and functions, it is defined by the Data Model.
" }, "queueId": { "type": "string", "description": "Specifies which queues you want data associated with this subscription published to.
" } }, "description": "A Consumer uses the Subscriptions Infrastructure Service to subscribe to Events published by one or more Service Providers.
" }, "jobCollection": { "type": "object", "properties": { "job": { "type": "array", "items": { "$ref": "#/definitions/job" } } } }, "job": { "required": [ "name" ], "type": "object", "properties": { "id": { "allOf": [ { "$ref": "#/definitions/uuid" }, { "xml": { "attribute": "true" } } ] }, "name": { "type": "string", "description": "The name of the job, e.g. \"grading\" or \"sre\".
" }, "description": { "type": "string", "description": "A description of the job, e.g. \"Bowers Elementary School Final Marks\"
" }, "state": { "allOf": [ { "$ref": "#/definitions/jobState" }, { "description": "The current enumerable state of the job.
" } ] }, "stateDescription": { "type": "string", "description": "A descriptive message elaborating on the current state, e.g. if the current state is \"FAILED\" the stateDescription may be \"Timeout occured\".
" }, "created": { "description": "The datetime this job was created.
" }, "lastModified": { "description": "The datetime this job was last modified.
" }, "timeout": { "description": "The ammount of time after creation before this job is automatically deleted.
" }, "phases": { "allOf": [ { "$ref": "#/definitions/phaseCollection" }, { "description": "The phases that make up this job.
" } ] }, "initialization": { "allOf": [ { "$ref": "#/definitions/initialization" } ] } }, "description": "All functional services must use this object design to track state. While Events may be published back to the objects creator, they must not be published to the Consumer when the event was generated based on its request (since results were included in the response). Each functional service should define the expectations of how management of the job is managed for both the Consumer and Provider. For instance, certain optional fields may need to be included in-order-to successfully cause a job to be created.
" }, "stateCollection": { "type": "object", "properties": { "state": { "type": "array", "items": { "$ref": "#/definitions/state" } } } }, "state": { "required": [ "type" ], "type": "object", "properties": { "id": { "allOf": [ { "$ref": "#/definitions/uuid" }, { "xml": { "attribute": "true" } } ] }, "type": { "allOf": [ { "$ref": "#/definitions/phaseState" }, { "description": "The type of this State object.
" } ] }, "created": { "description": "The datetime this job was created.
" }, "lastModified": { "description": "The datetime this job was last modified.
" }, "description": { "type": "string", "description": "A descriptive message ellaborating the condition of this state, e.g. if the state is \"FAILED\" the stateDescription may be \"Timeout occured\".
" } }, "description": "For states updatable by the Consumer, it creates a new state much like it would a single object. The actual result (state or error) is included in the response. Each functional service should define the expectations for which Adaptor is responsible for updating the phase status. NOTE: The \"states\" collection represented here is reserved for future capabilities.
" }, "alertCollection": { "type": "object", "properties": { "alert": { "type": "array", "items": { "$ref": "#/definitions/alert" } } } }, "alert": { "required": [ "exchange", "level", "reporter" ], "type": "object", "properties": { "id": { "allOf": [ { "$ref": "#/definitions/uuid" }, { "xml": { "attribute": "true" } } ] }, "reporter": { "type": "string", "description": "External identification of the Application (Consumer or Provider) reporting this Alert.
" }, "cause": { "type": "string", "description": "External identification of the cause of the Alert.
" }, "exchange": { "description": "The exchange (or lack of exchange) responsible for generating the Alert.
", "oneOf": [ { "const": "REQUEST" }, { "const": "RESPONSE" }, { "const": "EVENT" }, { "const": "TIMEOUT" }, { "const": "OTHER" } ] }, "level": { "description": "The level of the Alert.
", "oneOf": [ { "const": "INFO" }, { "const": "STATECHANGE" }, { "const": "EVENT" }, { "const": "WARNING" }, { "const": "ERROR" } ] }, "description": { "type": "string", "description": "A description of the reason for the Alert.
" }, "messageID": { "type": "string", "description": "If available, the ID of the Message causing the problem.
" }, "body": { "type": "string", "description": "The internals of the offending message or a more complete description of the information or state change. Usage of the CDATA designation is recommended in order to make the XML contents more readable to humans.
" }, "error": { "type": "string", "description": "Detailed error results such as a stack trace.
" }, "xpath": { "type": "string", "description": "An indicator of the specific element that was in error (or contributed to the problem. [NEEDS TO BE CHANGED TO the SIF XPATH TYPE]
" }, "category": { "type": "integer", "description": "If the Alert Level is an error, this value must be the SIF 3.0.1 Error Category corresponding to the type of Error being reported
" }, "code": { "type": "integer", "description": "If the Alert Level is an error, this value must be the SIF 3.0.1 Error Code corresponding to the type of Error being reported.
" }, "internal": { "type": "string", "description": "Code internal to the reporter.
" } }, "description": "Alerts form a system wide log that can be protected, as it may contain sensitive data. Ideally an Alert should contain as much identifying information about the problem being reported as possible.
" }, "codeSetCollection": { "type": "object", "properties": { "codeSet": { "type": "array", "items": { "$ref": "#/definitions/codeSet" } } } }, "codeSet": { "required": [ "timestamp", "version", "zone" ], "type": "object", "properties": { "id": { "type": "string", "xml": { "attribute": "true" } }, "zone": { "type": "string", "description": "If this is tied to a specific zone it is specified here, otherwise \"environment-global\" indicates applicability to all zones in the Environment.
" }, "version": { "allOf": [ { "$ref": "#/definitions/version" }, { "description": "The official major, minor, and revision version of the code set.
" } ] }, "timestamp": { "description": "The date and time of the last change to this code set. So that only updates can be queried efficiently (where applicable).
" }, "source": { "allOf": [ { "$ref": "#/definitions/uri" }, { "description": "URL to an external code set whose values are not (yet) present in the system.
" } ] }, "codeItems": { "allOf": [ { "$ref": "#/definitions/codeItems" } ] } }, "description": "The Code Set Registry Service provides a way for all legal codes to be defined outside of the SIF Specification while allowing changes (additions and replacements) of external code set values to be easily verified by the recipient so as not to break existing Consumer / Provider interoperability.
" }, "namespaceCollection": { "type": "object", "properties": { "namespace": { "type": "array", "items": { "$ref": "#/definitions/namespace" } } } }, "namespace": { "required": [ "uri", "url", "zone" ], "type": "object", "properties": { "id": { "allOf": [ { "$ref": "#/definitions/uuid" }, { "xml": { "attribute": "true" } } ] }, "zone": { "type": "string", "description": "If this namespace is tied to a specific zone it is specified here.
" }, "uri": { "type": "string", "format": "uri", "description": "The namespace URI of the retrieved URL.
" }, "url": { "type": "string", "format": "uri", "description": "The URL of the specified namespace URI.
" } }, "description": "The Namespaces Registry contains the set of XML namespace URIs and their corresponding schema location URLs that are currently valid within the Environment.
" }, "providerCollection": { "type": "object", "properties": { "provider": { "type": "array", "items": { "$ref": "#/definitions/provider" } } } }, "provider": { "required": [ "contextId", "providerName", "querySupport", "serviceName", "serviceType", "zoneId" ], "type": "object", "properties": { "id": { "allOf": [ { "$ref": "#/definitions/uuid" }, { "xml": { "attribute": "true" } } ] }, "serviceType": { "allOf": [ { "$ref": "#/definitions/serviceType" }, { "description": "The generic type of Service being provided.
" } ] }, "serviceName": { "type": "string", "description": "The name of the Service or the Service Path being provided.
" }, "contextId": { "type": "string", "description": "The name of the Service Context being provided.
" }, "zoneId": { "type": "string", "description": "The Zone in which the Service Context is being provided.
" }, "providerName": { "type": "string", "description": "The name of the Service Provider as it would be referred to by the administrator of the Zone (ex: RamseySIS).
" }, "querySupport": { "allOf": [ { "$ref": "#/definitions/querySupport" } ] }, "mimeTypes": { "allOf": [ { "$ref": "#/definitions/mediaTypes" } ] }, "endPoint": { "allOf": [ { "$ref": "#/definitions/protocol" }, { "description": "In a Brokered Environment, this element contains the URL where all requests for this Service Provider should be re-invoked by the Connector
" } ] } }, "description": "All potentially accessible Services have an entry in the Providers Registry (including the Providers Registry Utility Service itself), although full or even partial Consumer access to that Service is determined by the access rights currently granted in the Consumer's Environment object, and is not guaranteed.
" }, "xqueryCollection": { "type": "object", "properties": { "xquery": { "type": "array", "items": { "$ref": "#/definitions/xquery" } } } }, "xquery": { "required": [ "parameters", "returnType", "script", "status", "type" ], "type": "object", "properties": { "id": { "type": "string", "description": "The unique ID of the XQuery Template, which is contained in the Query Request URL when this template is being utilized. \"Suggested\" by the Consumer issuing the create Request, or pre-set in accordance with the binding requirements of a particular SIF release. This is NOT required to be a UUID, and must be provided as the Service Identifier in every Query URL which invokes this Template. Ex: \"StudentSnapshot\".
", "xml": { "attribute": "true" } }, "type": { "description": "Determines if the query may be sent to a data provider or if it requires the extended XQuery mechanism.
", "oneOf": [ { "const": "SINGULAR" }, { "const": "FORMULA" }, { "const": "EXTENDED" } ] }, "status": { "description": "Communicates if the query has been inspected for data hiding and the results of that assessment.
", "oneOf": [ { "const": "PENDING" }, { "const": "APPROVED" }, { "const": "DISALLOWED" } ] }, "qualifier": { "type": "string", "description": "If status is DISALLOWED this element optionally contains the reason.
" }, "description": { "type": "string", "description": "Human readable description of the XQuery's intended behavior.
" }, "script": { "type": "string", "description": "The text of the XQuery which MAY accept parameters. Usage of the CDATA designation is recommended.
" }, "parameters": { "allOf": [ { "$ref": "#/definitions/parameters" } ] }, "returnType": { "type": "string", "format": "uri", "description": "The fully qualified name of the root element returned by this service. Example: http://www.sifassociation.org/datamodel/na/3.3:students
" } }, "description": "This collection defines the entire set of named queries that Consumers may legally issue for execution by Service Providers. A Consumer specifies the ID of a Named XQuery in a Query Request to a specific Service Provider, along with a set of values for any associated script parameters.
" }, "zoneCollection": { "type": "object", "properties": { "zone": { "type": "array", "items": { "$ref": "#/definitions/zone" } } } }, "zone": { "type": "object", "properties": { "id": { "type": "string", "xml": { "attribute": "true" } }, "description": { "type": "string", "description": "A short (possibly multi-sentence) description of the Zone
" }, "properties": { "allOf": [ { "$ref": "#/definitions/properties" } ] } }, "description": "Zone identifiers are chosen by the administrator and can follow any convention that best meets the needs of the deploying organization. The Zone in which the Service is to be found always qualifies every Consumer request for any Provider Service. Each Service Consumer is assigned a \"default\" Zone at Registration time, which is used whenever a specific Zone is not explicitly included in one of its Provider Service Requests.
" }, "podCollection": { "type": "object", "properties": { "pod": { "type": "array", "items": { "$ref": "#/definitions/pod" } } } }, "pod": { "required": [ "id", "partyId", "podStatus", "podToken", "podVersion", "privacyList" ], "type": "object", "properties": { "id": { "allOf": [ { "$ref": "#/definitions/uuid" }, { "description": "The ID (GUID) that uniquely identifies this object.
" }, { "xml": { "attribute": "true" } } ] }, "podStatus": { "description": "The status value for this POD.
", "oneOf": [ { "const": "Live" }, { "const": "Draft" }, { "const": "Pending" }, { "const": "Expired" } ] }, "podToken": { "allOf": [ { "$ref": "#/definitions/gCoreLocalId" }, { "description": "The token reference for the POD.
" } ] }, "podVersion": { "type": "string", "description": "The POD version number. PODs are expected to change over time.
" }, "partyId": { "type": "string", "description": "The name of the party (typically the data processor) which will receive the data from the school, district or state and has entered into an agreement to process the data and respect the privacy obligations of the data.
" }, "privacyList": { "allOf": [ { "$ref": "#/definitions/privacyList" }, { "description": "The set of privacy controls, laws and obligations which apply in this POD. There may be multiple sets which apply." } ] } }, "description": "This object contains information about privacy obligations.
" }, "deleteRequestCollection": { "type": "object", "properties": { "deleteRequest": { "type": "array", "items": { "$ref": "#/definitions/deleteRequest" } } } }, "deleteRequest": { "required": [ "deletes" ], "type": "object", "properties": { "deletes": { "allOf": [ { "$ref": "#/definitions/deleteIdCollection" } ] } }, "description": "A \"deleteRequest\" element, which consists of multiple, \"delete\" object ids. Since REST conventions do not support payloads on HTTP DELETE messages, all multi-object Delete Requests are conveyed via an HTTP PUT message containing an additional HTTP Header Field value of methodOverride set to DELETE.
" }, "createResponseCollection": { "type": "object", "properties": { "createResponse": { "type": "array", "items": { "$ref": "#/definitions/createResponse" } } } }, "createResponse": { "required": [ "creates" ], "type": "object", "properties": { "creates": { "allOf": [ { "$ref": "#/definitions/creates" } ] } }, "description": "An HTTP Response with a status of 200 and a payload consisting of a single \"createResponse\" element. This includes, for each requested object successfully created, an internal status of 201 and the service-assigned refId. Any requested object that failed to be created is indicated by an error statusCode and a corresponding error payload.
" }, "deleteResponseCollection": { "type": "object", "properties": { "deleteResponse": { "type": "array", "items": { "$ref": "#/definitions/deleteResponse" } } } }, "deleteResponse": { "required": [ "deletes" ], "type": "object", "properties": { "deletes": { "allOf": [ { "$ref": "#/definitions/deleteStatusCollection" } ] } }, "description": "An HTTP Response with a status of 200 (success). It contains a payload consisting of a single \"deleteResponse\" element.
" }, "errorCollection": { "type": "object", "properties": { "error": { "type": "array", "items": { "$ref": "#/definitions/error" } } } }, "error": { "required": [ "code", "message", "scope" ], "type": "object", "properties": { "id": { "type": "string", "xml": { "attribute": "true" } }, "code": { "type": "integer", "description": "Corresponds to the value contained in the HTTPS Header Status-Code\" field in which the Error Object is the payload.
" }, "scope": { "type": "string", "description": "Attempted operation. Ex: \"Modify Student\"
" }, "message": { "type": "string", "description": "A simple, easy to understand, compact description of the error. The primary consumer of this message is the application user. Example: \"Unable to open database.\"
" }, "description": { "type": "string", "description": "An optional error description that is more complete and technical in nature. It is to be used as a diagnostic message in trouble-shooting procedures. Example: \"The 'Students' table is opened in exclusive mode by user 'ADM1' (dbm.cpp, line 300).\"
" } } }, "updateResponseCollection": { "type": "object", "properties": { "updateResponse": { "type": "array", "items": { "$ref": "#/definitions/updateResponse" } } } }, "updateResponse": { "required": [ "updates" ], "type": "object", "properties": { "updates": { "allOf": [ { "$ref": "#/definitions/updates" } ] } }, "description": "An HTTP Response with a status of 200 (success) and a location corresponding to the URL of the first successfully modified object. It contains a payload consisting of a single \"updateResponse\" element.
" }, "gCoreEmailList": { "description": "A list of e-mail addresses associated with an individual or organization.
", "type": "object", "required": [ "email" ], "properties": { "email": { "type": "array", "items": { "$ref": "#/definitions/gCoreEmail" } } } }, "gCoreEmail": { "description": "This element represents an e-mail address of one of a number of types and occurs in objects such as StudentPersonal, StaffPersonal, StudentContactPersonal, etc..
", "type": "string" }, "gCorePhoneNumberList": { "description": "Lists phone numbers associated with an entity.
", "type": "object", "required": [ "phoneNumber" ], "properties": { "phoneNumber": { "type": "array", "items": { "$ref": "#/definitions/gCorePhoneNumber" } } } }, "gCorePhoneNumber": { "description": "This element represents a phone number and occurs within objects such as StudentPersonal, StaffPersonal, etc.
", "type": "object", "required": [ "number" ], "properties": { "number": { "type": "string", "description": "Phone number. Free-form, but typical Australian formats include:
Phone number extension.
" }, "listedStatus": { "description": "Indicates whether or not the phone number is available to the public.
", "oneOf": [ { "const": "Y" }, { "const": "N" } ] }, "preference": { "type": "integer", "description": "Preference number indicating an order in which phone numbers should be used when contacting person.
" } } }, "gCoreName": { "description": " Core Name Type or Name
elements, primarily to allow structure to be leveraged with different Type
attribute values.
A title or prefix associated with the name. If any of: Mr, Mrs, Ms, Miss, Rev, Fr, Dr, Prof, Hon, Sir, Lord, Lady - these must be as shown, otherwise free text. Note that title is not applicable to learners.
" }, "familyName": { "type": "string", "description": "Family name. That part of the person's name which is used to describe family, clan, tribal group, or marital association. Note that this element is required when known. However, it may not be possible to know the family name in which case you should add the available information to the FullName element.
" }, "givenName": { "type": "string", "description": "Given name of the person. Note that this element is required if known. However, it may not be possible to know the given name in which case you should add the available information to the FullName element.
" }, "otherGivenNames": { "type": "string", "description": "All other given or middle names, each separated with a single space character.
" }, "familyNameFirst": { "description": "An indicator used to identify the naming conventions used by some predominantly non-European, ethnic or language groups and related to the display nature of a name.
", "oneOf": [ { "const": "Y" }, { "const": "N" } ] }, "preferredName": { "type": "string", "description": "The given name preferred most by the person (as written).
" } } }, "gCoreContactList": { "description": "List of Contacts associated with an entity.
", "type": "object", "required": [ "contact" ], "properties": { "contact": { "type": "array", "items": { "$ref": "#/definitions/gCoreContactInfo" } } } }, "gCoreContactInfo": { "description": "Common element used to supply information for a contact person at a school, LEA, or other institution.
", "type": "object", "required": [ "name" ], "properties": { "name": { "allOf": [ { "$ref": "#/definitions/gCoreName" } ] }, "positionTitle": { "type": "string", "description": "The contact person's position title.
" }, "role": { "type": "string", "description": "Role played by this contact in this instance.
" }, "registrationDetails": { "type": "string", "description": "Registration Details of the Contact." }, "qualifications": { "type": "string", "description": "Qualifications of the Contact." }, "address": { "allOf": [ { "$ref": "#/definitions/gCoreAddress" }, { "description": "Address of the contact.
" } ] }, "emailList": { "allOf": [ { "$ref": "#/definitions/gCoreEmailList" }, { "description": "List of Email elements.
" } ] }, "phoneNumberList": { "allOf": [ { "$ref": "#/definitions/gCorePhoneNumberList" }, { "description": "List of PhoneNumber elements.
" } ] } } }, "gCoreAddress": { "description": "This element contains address data.
", "type": "object", "required": [ "city", "gCoreAddressType", "line1", "postalCode" ], "properties": { "effectiveFromDate": { "type": "string", "format": "date", "description": "Date the address became active.
" }, "effectiveToDate": { "type": "string", "format": "date", "description": "Date the address ceases to be active.
" }, "line1": { "type": "string", "description": "Address line 1.
" }, "line2": { "type": "string", "description": "Address line 2.
" }, "line3": { "type": "string", "description": "Address line 3.
" }, "city": { "type": "string", "description": "The city or Suburb part of the address.
" }, "stateProvince": { "allOf": [ { "$ref": "#/definitions/gCoreStateProvince" }, { "description": "The state or province or county.
" } ] }, "country": { "allOf": [ { "$ref": "#/definitions/gCoreCountry" }, { "description": "The country code.
" } ] }, "postalCode": { "type": "string", "description": "The ZIP/postal code.
" } } }, "gCoreAddressList": { "description": "A list of Address elements.
", "type": "object", "required": [ "address" ], "properties": { "address": { "type": "array", "items": { "$ref": "#/definitions/gCoreAddress" } } } }, "gCoreCountry": { "description": "A country code or name.
", "type": "string" }, "gCoreLocalId": { "description": "This is a common element used to define the locally assigned identifier associated with an entity.
", "type": "string" }, "gCoreStateProvinceId": { "description": "The identifier for this entity as assigned by the state or province.
", "type": "string" }, "gCoreStateProvince": { "description": "A state or province code. Note: When dealing with countries other than Australia, state/province codes/values other than those referenced here can be used.
", "type": "string" }, "gCoreGender": { "type": "string", "oneOf": [ { "const": "M", "description": "Male" }, { "const": "F", "description": "Female" }, { "const": "X", "description": "Non-binary/Intersex" }, { "const": "U", "description": "Unknown/Not-defined" } ] }, "privacyList": { "description": "", "type": "object", "properties": { "privacy": { "type": "array", "items": { "$ref": "#/definitions/privacy" } } } }, "privacy": { "description": ".
", "type": "object", "required": [ "default" ], "properties": { "default": { "description": "Is this the default privacy template?
", "oneOf": [ { "const": "Y" }, { "const": "N" } ] }, "appIDList": { "allOf": [ { "$ref": "#/definitions/appIDList" }, { "description": "The list of applications in this contract.
" } ] }, "adapterFingerprintList": { "allOf": [ { "$ref": "#/definitions/adapterFingerprintList" }, { "description": "A list of fingerprints.
" } ] }, "zoneContextList": { "allOf": [ { "$ref": "#/definitions/zoneContextList" }, { "description": "A list zones and contexts where this POD applies.
" } ] }, "endpointList": { "allOf": [ { "$ref": "#/definitions/endpointList" }, { "description": "A list of endpoints that are covered by this POD.
" } ] }, "dataModelNamespace": { "type": "string", "format": "uri", "description": "Namespace associated with the relevant datamodel.
" }, "dataModelVersionMin": { "type": "string", "description": "Minimum data model version.
" }, "dataModelVersionMax": { "type": "string", "description": "Maximum data model version.
" }, "privacyObligationsDocument": { "allOf": [ { "$ref": "#/definitions/privacyObligationsDocument" }, { "description": "The legal and technical requirements that are required to be met to satisfy privacy and security concerns.
" } ] } } }, "privacyObligationsDocument": { "description": "", "type": "object", "properties": { "contract": { "allOf": [ { "$ref": "#/definitions/contract" }, { "description": "The details of the contract the POD has been derived from.
" } ] }, "legalRequirements": { "allOf": [ { "$ref": "#/definitions/legalRequirements" }, { "description": "Legal Requirements Container.
" } ] }, "technicalRequirements": { "allOf": [ { "$ref": "#/definitions/technicalRequirements" }, { "description": "Technical Requirements Container.
" } ] }, "dataController": { "allOf": [ { "$ref": "#/definitions/dataController" }, { "description": "The data controller, \"means the natural or legal person, public authority, agency or other body which, alone or jointly with others, determines the purposes and means of the processing of personal data\", see GDPR.
" } ] }, "dataProcessor": { "allOf": [ { "$ref": "#/definitions/dataProcessor" }, { "description": "The data processor, \"means a natural or legal person, public authority, agency or other body which processes personal data on behalf of the controller\", see GDPR.
" } ] }, "dataSubProcessorList": { "allOf": [ { "$ref": "#/definitions/dataSubProcessorList" }, { "description": "The list of data sub-Processors who are the bodies that process data on behalf of the Data Processor.
" } ] } } }, "contract": { "description": "The details of the contract the POD has been derived from.", "type": "object", "required": [ "contractName", "contractURI", "dateValidFrom", "lawList" ], "properties": { "contractURI": { "type": "string", "format": "uri", "description": "URI Associated with contract
" }, "contractName": { "type": "string", "description": "Name associated with contract
" }, "dateValidFrom": { "type": "string", "format": "date", "description": "Date the contract is valid from.
" }, "dateValidTo": { "type": "string", "format": "date", "description": "Date the contract is valid to.
" }, "contractVersion": { "type": "string", "description": "Version of contract that this POD applies to.
" }, "lawList": { "allOf": [ { "$ref": "#/definitions/lawList" }, { "description": "List of laws covered referenced by the contract.
" } ] }, "studentDataIPRights": { "type": "string", "description": "Who owns the IP rights of this contract?
" } } }, "lawList": { "description": "A list of parties and data sharing permissions.
", "type": "object", "properties": { "law": { "type": "array", "items": { "$ref": "#/definitions/law" } } } }, "law": { "description": "Information about the specific law.
", "type": "object", "required": [ "lawDescription", "lawName" ], "properties": { "lawName": { "type": "string", "description": "Common name for this law.
" }, "lawDescription": { "type": "string", "description": "Details of the law.
" } } }, "legalRequirements": { "description": "Contains a list of the legal clauses within the contract.
", "type": "object", "required": [ "clauseList" ], "properties": { "clauseList": { "allOf": [ { "$ref": "#/definitions/clauseList" }, { "description": "A list of the legal clauses within the contract.
" } ] } } }, "clauseList": { "description": "A list of the legal clauses within the contract.
", "type": "object", "properties": { "clause": { "type": "array", "items": { "$ref": "#/definitions/clause" } } } }, "clause": { "description": "Details of a legal clause within the contract.
", "type": "object", "properties": { "clauseLabel": { "type": "string", "description": "The label which should include a brief description.
" }, "clauseReference": { "type": "string", "description": "The formal clause reference.
" }, "clauseContent": { "type": "string", "description": "The actual detailed content of the clause.
" }, "obligationList": { "allOf": [ { "$ref": "#/definitions/obligationList" }, { "description": "List of obligations.
" } ] } } }, "benchmarkList": { "description": "A List of benchmarks - where a benchmark is a set of technical or process standards to ensure the clause is met.
", "type": "object", "properties": { "benchmark": { "type": "array", "items": { "$ref": "#/definitions/benchmark" } } } }, "benchmark": { "description": "A set of technical or process standards to ensure the clause is met.
", "type": "object", "properties": { "benchmarkName": { "type": "string", "description": "The name of the Benchmark
" }, "benchmarkId": { "allOf": [ { "$ref": "#/definitions/gCoreLocalId" }, { "description": "The local id of the benchmark.
" } ] }, "benchmarkDescription": { "type": "string", "description": "A description of what the benchmark is and how it should be applied.
" }, "benchmarkURL": { "type": "string", "format": "uri", "description": "A link to any authoritative source of the benchmark.
" } } }, "obligationList": { "description": "A list of requirements imposed by the contract.
", "type": "object", "properties": { "obligation": { "type": "array", "items": { "$ref": "#/definitions/obligation" } } } }, "obligation": { "description": "A requirement imposed by the contract.
", "type": "object", "properties": { "obligationDescription": { "type": "string", "description": "A description of the requirment imposed by the contract.
" }, "obligationURL": { "type": "string", "format": "uri", "description": "A link to any authoritative source of the obligation.
" }, "benchmarkList": { "allOf": [ { "$ref": "#/definitions/benchmarkList" }, { "description": "A list of benchmarks associated with the obligation.
" } ] } } }, "technicalRequirements": { "description": "Details of technical requirements that need to be met to achieve the POD.
", "type": "object", "properties": { "dataAccess": { "allOf": [ { "$ref": "#/definitions/dataAccess" }, { "description": "A list of the data that can be accessed and any rules that specifically apply.
" } ] }, "conditionList": { "allOf": [ { "$ref": "#/definitions/conditionList" } ] }, "dataSubject": { "allOf": [ { "$ref": "#/definitions/dataSubject" }, { "description": "The specific clauses obligations and benchmarks that applies to the subject - teacher, student or parent.
" } ] }, "dataDeletion": { "allOf": [ { "$ref": "#/definitions/dataDeletion" }, { "description": "Details and requirements for data deletion.
" } ] }, "securityTechnologyList": { "allOf": [ { "$ref": "#/definitions/securityTechnologyList" } ] } } }, "dataAccess": { "description": "A list of the data that can be accessed and any rules that specifically apply.
", "type": "object", "properties": { "clauseList": { "allOf": [ { "$ref": "#/definitions/clauseList" }, { "description": "A list of clauses that specifically apply to these technical requirements.
" } ] }, "fieldList": { "allOf": [ { "$ref": "#/definitions/fieldList" }, { "description": "A list of fields that can be accessed under this POD. Equivalent to a \"green list\".
" } ] } } }, "dataSubject": { "description": "The specific clauses obligations and benchmarks that applies to the subject - teacher, student or parent.
", "type": "object", "properties": { "clauseList": { "allOf": [ { "$ref": "#/definitions/clauseList" } ] }, "benchmarkList": { "allOf": [ { "$ref": "#/definitions/benchmarkList" } ] }, "fieldList": { "allOf": [ { "$ref": "#/definitions/fieldList" }, { "description": "A list of fields that can be accessed under this POD. Equivalent to a \"green list\".
" } ] }, "respondInDays": { "type": "integer", "description": "n how many days should any request for information around this data subject be responded to?
" }, "requirePortability": { "description": "Do all the rules surrounding this data need to be ported with any data that is transmeitted?
", "oneOf": [ { "const": "Y" }, { "const": "N" } ] } } }, "dataDeletion": { "description": "Details and requirements for data deletion.
", "type": "object", "properties": { "deleteData": { "description": "Must data be deleted when no longer required to the primary purpose?
", "oneOf": [ { "const": "Y" }, { "const": "N" } ] }, "dataRetention": { "type": "integer", "description": "If allowed, how long can the data be retained for when no longer required for the primary purpose?
" }, "deleteBy": { "type": "string", "format": "date", "description": "By which specific date should this data be removed from systems?
" }, "partyToDeleteData": { "allOf": [ { "$ref": "#/definitions/partyToDeleteData" }, { "description": "Who is responsible for deletion of this data?
" } ] }, "respondInDays": { "type": "integer", "description": "In how many days should any request for information around this data and it's deletion be responded to?
" }, "requirePortability": { "description": "Do all the rules surrounding this data need to be ported with any data that is transmeitted?
", "oneOf": [ { "const": "Y" }, { "const": "N" } ] } } }, "partyToDeleteData": { "description": "Who is responsible for deletion of this data?
", "type": "object", "properties": { "organisation": { "allOf": [ { "$ref": "#/definitions/gCoreLocalId" } ] }, "deletecontactInfo": { "allOf": [ { "$ref": "#/definitions/gCoreContactInfo" } ] } } }, "securityTechnologyList": { "description": "", "type": "object", "properties": { "securityTechnology": { "type": "array", "items": { "$ref": "#/definitions/securityTechnology" } } } }, "securityTechnology": { "description": "", "type": "object", "properties": { "clauseList": { "allOf": [ { "$ref": "#/definitions/clauseList" } ] }, "technologyName": { "type": "string" }, "technologyDescription": { "type": "string" }, "referenceURL": { "type": "string", "format": "uri" }, "versionMin": { "type": "string" } } }, "fieldList": { "description": "A list of fields that can be accessed under this POD. Equivalent to a \"green list\".
", "type": "object", "properties": { "field": { "type": "array", "items": { "$ref": "#/definitions/field" } } } }, "field": { "description": "Details of a field that can be accessed under this POD, equivalent to an element in a \"green list\".
", "type": "object", "properties": { "fieldName": { "type": "string", "description": "Name of the \"green listed field\"
" }, "controlrights": { "description": "What are the control rights around this \"green listed field\"?
", "oneOf": [ { "const": "R" }, { "const": "RW" } ] } } }, "dataController": { "description": "The data controller, \"means the natural or legal person, public authority, agency or other body which, alone or jointly with others, determines the purposes and means of the processing of personal data\", see GDPR.
", "type": "object", "required": [ "privacyPolicyURL" ], "properties": { "dataControllerName": { "type": "string", "description": "Name of the data controller.
" }, "privacyPolicyURL": { "type": "string", "format": "uri", "description": "URL Associated with contract
" }, "privacyContactList": { "allOf": [ { "$ref": "#/definitions/gCoreContactList" }, { "description": "The details of the privacy contact.
" } ] }, "issuesNotificationContactList": { "allOf": [ { "$ref": "#/definitions/gCoreContactList" }, { "description": "The details of the individual to be contacted if there are issues in fulfilling the obligations of the contract.
" } ] } } }, "dataSubProcessorList": { "description": "The list of data sub-Processors who are the bodies that process data on behalf of the Data Processor.
", "type": "object", "properties": { "dataSubProcessor": { "type": "array", "items": { "$ref": "#/definitions/dataSubProcessor" } } } }, "dataProcessor": { "description": "The data processor, \"means a natural or legal person, public authority, agency or other body which processes personal data on behalf of the controller\", see GDPR.
", "type": "object", "required": [ "privacyPolicyURL" ], "properties": { "dataProcessorName": { "type": "string", "description": "Name of the Data Processor.
" }, "privacyPolicyURL": { "type": "string", "format": "uri", "description": "URL Associated with contract
" }, "privacyContactList": { "allOf": [ { "$ref": "#/definitions/gCoreContactList" }, { "description": "The details of the privacy contact.
" } ] }, "notifyDataControllerOnAccessRequests": { "description": "Do we need to advise the data controller of access requests?
", "oneOf": [ { "const": "Y" }, { "const": "N" } ] }, "dataProcessorContactForAccessRequestsList": { "allOf": [ { "$ref": "#/definitions/gCoreContactList" }, { "description": "The details of the person to contact for access requests.
" } ] }, "purposeList": { "allOf": [ { "$ref": "#/definitions/purposeList" }, { "description": "A list or purposes for which the data may be used.
" } ] }, "alternatePurposeList": { "allOf": [ { "$ref": "#/definitions/alternatePurposeList" }, { "description": "Alternate purposes for which the data may be used.
" } ] }, "deidentifiedPurposeList": { "allOf": [ { "$ref": "#/definitions/deidentifiedPurposeList" }, { "description": "The purposes for which deidentified data is able to be used (if any).
" } ] }, "dataUsageMarketingAllowed": { "description": "Can the data be used for marketing purposes?
", "oneOf": [ { "const": "Y" }, { "const": "N" } ] }, "personalInformationUpdatedFromSource": { "type": "integer", "description": "The frequency at which personal information is to be updated from source systems.
" }, "dataBreachNotification": { "description": "In the event there is a breach event is notification of the breach contact required?
", "oneOf": [ { "const": "Y" }, { "const": "N" } ] }, "dataBreachContactList": { "allOf": [ { "$ref": "#/definitions/gCoreContactList" }, { "description": "Contact details for the individual/s to be notified in the event of a data breach.
" } ] }, "employeesMustComplyWithAgreement": { "description": "Must employees of the data controller comply the with agreement?
", "oneOf": [ { "const": "Y" }, { "const": "N" } ] }, "employeeConfidentialityAgreement": { "description": "Are employees of the data controller required to comply with a confidentiality agreement?
", "oneOf": [ { "const": "Y" }, { "const": "N" } ] }, "employeeTrainingList": { "allOf": [ { "$ref": "#/definitions/employeeTrainingList" }, { "description": "A list of the data controller employee’s training requirements.
" } ] }, "passwordEmployeeAccessStandard": { "allOf": [ { "$ref": "#/definitions/passwordEmployeeAccessStandard" }, { "description": "A list of the data controller employee’s password access standards.
" } ] }, "securityTestRequiredList": { "allOf": [ { "$ref": "#/definitions/securityTestRequiredList" }, { "description": "A list of security testing required to be completed by the data controller.
" } ] }, "countryImpactedList": { "allOf": [ { "$ref": "#/definitions/countryImpactedList" }, { "description": "List of impacted countries in or through which the data transits or is stored.
" } ] } } }, "dataSubProcessor": { "description": "Details of organisations who process data on behalf of the data processor.
", "type": "object", "required": [ "privacyPolicyURL" ], "properties": { "subProcessorName": { "type": "string", "description": "Name of the sub processor.
" }, "privacyPolicyURL": { "type": "string", "format": "uri", "description": "URL Associated with contract
" }, "privacyContactList": { "allOf": [ { "$ref": "#/definitions/gCoreContactList" }, { "description": "Details of the data sub processor's privacy contact.
" } ] }, "purposeList": { "allOf": [ { "$ref": "#/definitions/purposeList" }, { "description": "The purpose for which data is supplied to the data sub processor by the data processor.
" } ] } } }, "appIDList": { "description": "List of application identifiers.
", "type": "object", "properties": { "appID": { "type": "array", "items": { "type": "string" } } } }, "adapterFingerprintList": { "description": "", "type": "object", "properties": { "adapterFingerprint": { "type": "array", "items": { "type": "string" } } } }, "deidentifiedPurposeList": { "description": "The purposes for which deidentified data is able to be used (if any).
", "type": "object", "properties": { "deidentifiedPurpose": { "type": "array", "items": { "type": "string" } } } }, "purposeList": { "description": "A list of the purposes for which data is may be used.
", "type": "object", "properties": { "purpose": { "type": "array", "items": { "type": "string" } } } }, "alternatePurposeList": { "description": "Alternate purposes for which the data may be used.
", "type": "object", "properties": { "alternatePurpose": { "type": "array", "items": { "type": "string" } } } }, "conditionList": { "description": "", "type": "object", "properties": { "condition": { "type": "array", "items": { "$ref": "#/definitions/condition" } } } }, "condition": { "description": "", "type": "object", "properties": { "typeOfCondition": { "type": "string" }, "conditionName": { "type": "string" }, "conditionDescription": { "type": "string" }, "propertyList": { "allOf": [ { "$ref": "#/definitions/propertyNVList" } ] } } }, "zoneContextList": { "description": "", "type": "object", "properties": { "zoneContext": { "type": "array", "items": { "$ref": "#/definitions/zoneContext" } } } }, "zoneContext": { "description": "A Zone and/or Context related to a POD.
", "type": "object", "properties": { "zoneId": { "allOf": [ { "$ref": "#/definitions/gCoreLocalId" } ] }, "contextId": { "allOf": [ { "$ref": "#/definitions/gCoreLocalId" } ] } } }, "endpointList": { "description": "", "type": "object", "properties": { "endpoint": { "type": "array", "items": { "$ref": "#/definitions/endpoint" } } } }, "endpoint": { "description": "A type of endpoint.
", "type": "object", "properties": { "endpointURL": { "type": "string", "format": "uri", "description": "The url of the endpoint.
" }, "endpointProviderName": { "type": "string", "description": "The name of the provider of the endpoint.
" } } }, "employeeTrainingList": { "description": "", "type": "object", "properties": { "employeeTraining": { "type": "array", "items": { "$ref": "#/definitions/employeeTraining" } } } }, "employeeTraining": { "description": "", "type": "object", "properties": { "trainingName": { "type": "string" }, "trainingURL": { "type": "string", "format": "uri" } } }, "passwordEmployeeAccessStandard": { "description": "", "type": "object", "properties": { "standardName": { "type": "string", "description": "Name of the standard used for access.
" }, "standardURL": { "type": "string", "format": "uri", "description": "A link to an authoritative source for this standard.
" } } }, "countryImpactedList": { "description": "List of impacted countries in or through which the data transits or is stored.
", "type": "object", "properties": { "countryImpacted": { "type": "array", "items": { "$ref": "#/definitions/countryImpacted" } } } }, "countryImpacted": { "description": "", "type": "object", "properties": { "country": { "allOf": [ { "$ref": "#/definitions/gCoreCountry" }, { "description": "Name of a country impacted in or through which the data transits or is stored.
" } ] }, "usage": { "type": "string", "description": "Details of the usage within the country, how the data is handled e.g. stored permanently, operational store, back-up, archived, etc.
" } } }, "securityTestRequiredList": { "description": "", "type": "object", "properties": { "securityTestRequired": { "type": "array", "items": { "$ref": "#/definitions/securityTestRequired" } } } }, "securityTestRequired": { "description": "Details of the security test required.
", "type": "object", "properties": { "testType": { "type": "string", "description": "Type of the test.
" }, "testFrequency": { "type": "string", "description": "How often does this test need to be performed?
" }, "remediationRequiredIn": { "type": "string", "description": "RNumber of days remediation for any inadequacies has to be completed with in.
" }, "shareResults": { "description": "Are the results of this security test allowed to be shared?
", "oneOf": [ { "const": "Y" }, { "const": "N" } ] } } }, "propertyNVList": { "description": "", "type": "object", "properties": { "property": { "type": "array", "items": { "$ref": "#/definitions/propertyNV" } } } }, "propertyNV": { "description": "", "type": "object", "properties": { "propertyName": { "type": "string" }, "propertyValue": { "type": "string" } } }, "DefinedProtocols": { "type": "string", "oneOf": [ { "const": "HTTPS" }, { "const": "HTTP" } ] }, "ExtendedContent": { "allOf": [ { "type": "object" }, { "description": "Allows for any mixed XML in an element." } ] }, "SelectedContent": { "allOf": [ { "type": "object" }, { "description": "Allows an XML fragment selected from an object to be used in an element with XML validation skipped." } ] }, "provisionedZones": { "type": "object", "required": [ "provisionedZone" ], "properties": { "provisionedZone": { "type": "array", "items": { "$ref": "#/definitions/provisionedZone" } } } }, "provisionedZone": { "type": "object", "required": [ "id" ], "properties": { "id": { "type": "string", "description": "The unique id of the Zone, and the key to the Zone element in the Zone Registry.
", "xml": { "attribute": "true" } }, "services": { "allOf": [ { "$ref": "#/definitions/services" } ] } } }, "creates": { "type": "object", "required": [ "create" ], "properties": { "create": { "type": "array", "items": { "$ref": "#/definitions/create" } } } }, "create": { "type": "object", "required": [ "advisoryId" ], "properties": { "id": { "type": "string", "xml": { "attribute": "true" } }, "advisoryId": { "type": "string", "xml": { "attribute": "true" } }, "statusCode": { "type": "string", "xml": { "attribute": "true" } }, "error": { "allOf": [ { "$ref": "#/definitions/error" } ] } } }, "deleteIdCollection": { "type": "object", "required": [ "delete" ], "properties": { "delete": { "type": "array", "items": { "$ref": "#/definitions/deleteId" } } } }, "environmentType": { "type": "string", "oneOf": [ { "const": "DIRECT" }, { "const": "BROKERED" } ] }, "jobState": { "type": "string", "oneOf": [ { "const": "NOTSTARTED" }, { "const": "INPROGRESS" }, { "const": "COMPLETED" }, { "const": "FAILED" } ] }, "phaseCollection": { "type": "object", "required": [ "phase" ], "properties": { "phase": { "type": "array", "items": { "$ref": "#/definitions/phase" } } } }, "phase": { "type": "object", "required": [ "name", "required", "rights", "states", "statesRights" ], "properties": { "name": { "type": "string", "description": "The name of the Phase unique within the context of the owning job.
" }, "states": { "allOf": [ { "$ref": "#/definitions/stateCollection" }, { "description": "A collection of the states the Phase has been through, must initially contain a NOTAPPLICABLE or NOTSTARTED state.
" } ] }, "required": { "type": "boolean", "description": "Whether or not this phase is required for the job to complete successfully.
" }, "rights": { "allOf": [ { "$ref": "#/definitions/rights" }, { "description": "Access rights given to the consumer for this phase.
" } ] }, "statesRights": { "allOf": [ { "$ref": "#/definitions/rights" }, { "description": "Access rights given to the consumer for each state.
" } ] } } }, "initialization": { "type": "object", "required": [ "payload" ], "properties": { "phaseName": { "type": "string", "description": "Name of initialization phase the payload corresponds to.
" }, "payload": { "description": "Information matching the initialization phase, should result in corresponding phase having an INPROGRESS, COMPLETED, or FAILED state.
" } } }, "phaseState": { "type": "string", "oneOf": [ { "const": "NOTAPPLICABLE" }, { "const": "NOTSTARTED" }, { "const": "PENDING" }, { "const": "SKIPPED" }, { "const": "INPROGRESS" }, { "const": "COMPLETED" }, { "const": "FAILED" } ] }, "enumerations": { "type": "object", "required": [ "enumeration" ], "properties": { "enumeration": { "type": "array", "items": { "$ref": "#/definitions/enumeration" } } } }, "enumeration": { "type": "object", "required": [ "value" ], "properties": { "value": { "type": "string", "description": "An acceptable parameter value for this query.
" }, "code": { "type": "string", "description": "If enumerated value has an equivalent code, this field may be used for conversion.
" } } }, "parameters": { "type": "object", "properties": { "parameter": { "type": "array", "items": { "$ref": "#/definitions/parameter" } } } }, "parameter": { "type": "object", "required": [ "name" ], "properties": { "name": { "type": "string", "description": "The name of the query parameter to be passed in. Note: Must not conflict with any other query parameter name.
" }, "type": { "type": "string", "description": "A well understood type that MAY be used for parameter validation. Example: xs:unsignedInt.
" }, "default": { "type": "string", "description": "Value to be supplied for this parameter if the submitter omits it.
" }, "description": { "type": "string", "description": "An explanation of what this parameter represents.
" }, "required": { "type": "boolean", "description": "Indicator as to if this parameter is required. If omitted, the parameter is assumed to be required!.
" }, "enumerations": { "allOf": [ { "$ref": "#/definitions/enumerations" } ] }, "range": { "allOf": [ { "$ref": "#/definitions/range" } ] }, "minLength": { "type": "integer", "description": "The minimum length for values of this parameter. If omitted, zero. May be functionally different because of other restrictions.
" }, "maxLength": { "type": "integer", "description": "The maximum length for values of this parameter. If omitted, unbounded. May be functionally different because of other restrictions.
" } } }, "properties": { "type": "object", "required": [ "property" ], "properties": { "property": { "type": "array", "items": { "$ref": "#/definitions/property" } } } }, "range": { "type": "object", "required": [ "end", "start" ], "properties": { "start": { "description": "If a numeric range is used, this holds the inclusive starting value.
" }, "end": { "description": "If a numeric range is used, this holds the inclusive ending value.
" } } }, "property": { "type": "object", "properties": { "value": { "type": "string" }, "name": { "type": "string", "description": "Name/Value pair.
", "xml": { "attribute": "true" } } } }, "applicationInfo": { "type": "object", "properties": { "applicationKey": { "type": "string", "description": "An opaque (to the SIF standard) element which contains any required Consumer authentication information. The content of this element is site-specific. For a Direct Environment which accepts Consumer Registration Requests from a mobile application, this element might contain a combination of the User ID and Password.
" }, "supportedInfrastructureVersion": { "type": "string", "description": "The version of the SIF infrastructure which the Consumer supports.
" }, "dataModelNamespace": { "type": "string", "format": "uri", "description": "The namespace of the data payloads conveyed by this environment. Returns may be of a diffrent minor version. Utility payloads will be of the infrastructure namespace.
" }, "transport": { "type": "string", "description": "The transport which the Consumer expects the infrastructure to use to interoperate with it. The default is whichever transport the create request was issued on
" }, "applicationProduct": { "allOf": [ { "$ref": "#/definitions/productIdentity" } ] }, "adapterProduct": { "allOf": [ { "$ref": "#/definitions/productIdentity" } ] } } }, "productIdentity": { "type": "object", "required": [ "productName" ], "properties": { "vendorName": { "type": "string", "description": "The name of the company supplying this Product.
" }, "productName": { "type": "string", "description": "The name of the Product
" }, "productVersion": { "type": "string", "description": "The format of this field is undefined, but it should match the format used in the agent's conformance statement, if the agent is SIF Certified.
" }, "iconURI": { "type": "string", "format": "uri", "description": "HTTP URL referencing an icon for graphical representation of the application/agent. Should range from 16x16 pixels to 128x128 pixels and be of an image MIME type commonly supported by Web browsers (e.g. PNG, JPEG, GIF).
" } } }, "services": { "type": "object", "required": [ "service" ], "properties": { "service": { "type": "array", "items": { "$ref": "#/definitions/service" } } } }, "service": { "type": "object", "required": [ "contextId", "name", "rights", "type" ], "properties": { "type": { "allOf": [ { "$ref": "#/definitions/serviceType" }, { "xml": { "attribute": "true" } } ] }, "name": { "type": "string", "description": "The name of the Service. For utilities, this is fixed to one of the defined set of Utility Service Names. For objects and functions, it is defined by the Data Model.
", "xml": { "attribute": "true" } }, "contextId": { "type": "string", "description": "The unique identity of a context element, which is associated with a Provider of this name and type operating in a Zone with this ID. All Services with the same name in the same Zone must have different Context IDs. Only one such Service can have no Context.
", "xml": { "attribute": "true" } }, "rights": { "allOf": [ { "$ref": "#/definitions/rights" } ] } } }, "rights": { "type": "object", "required": [ "right" ], "properties": { "right": { "type": "array", "items": { "$ref": "#/definitions/right" } } } }, "rightValue": { "type": "string", "oneOf": [ { "const": "APPROVED" }, { "const": "SUPPORTED" }, { "const": "REJECTED" }, { "const": "UNSUPPORTED" }, { "const": "REQUESTED" } ] }, "right": { "type": "object", "properties": { "value": { "allOf": [ { "$ref": "#/definitions/rightValue" } ] }, "type": { "description": "The type of the requested Access Right
", "oneOf": [ { "const": "QUERY" }, { "const": "CREATE" }, { "const": "UPDATE" }, { "const": "DELETE" }, { "const": "SUBSCRIBE" }, { "const": "PROVIDE" } ], "xml": { "attribute": "true" } } } }, "serviceType": { "type": "string", "oneOf": [ { "const": "UTILITY" }, { "const": "OBJECT" }, { "const": "FUNCTIONAL" }, { "const": "SERVICEPATH" }, { "const": "XQUERYTEMPLATE" }, { "const": "SERVICE" } ] }, "infrastructureServices": { "type": "object", "required": [ "infrastructureService" ], "properties": { "infrastructureService": { "type": "array", "items": { "$ref": "#/definitions/infrastructureService" } } } }, "infrastructureService": { "type": "object", "properties": { "value": { "type": "string" }, "name": { "allOf": [ { "$ref": "#/definitions/infrastructureServiceNames" }, { "xml": { "attribute": "true" } } ] } } }, "infrastructureServiceNames": { "type": "string", "oneOf": [ { "const": "environment" }, { "const": "provisionRequests" }, { "const": "requestsConnector" }, { "const": "eventsConnector" }, { "const": "queues" }, { "const": "subscriptions" }, { "const": "servicesConnector" } ] }, "uuid": { "type": "string", "pattern": "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[14][a-fA-F0-9]{3}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}" }, "version": { "type": "string", "pattern": "[0-9]{1,3}[.][0-9]{1,3}([.][0-9]{1,3})?" }, "uri": { "type": "string", "format": "uri" }, "aliases": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "array", "items": { "$ref": "#/definitions/alias" } } } }, "querySupport": { "type": "object", "properties": { "dynamicQuery": { "type": "boolean", "description": "True if this service is capable of honoring the \"where\" parameter.
" }, "queryByExample": { "type": "boolean", "description": "True if this service is capable of honoring query by example payloads.
" }, "changesSinceMarker": { "type": "boolean", "description": "True if this service is capable of supporting Changes Since Queries.
" }, "paged": { "type": "boolean", "description": "True if this service is capable of responding to Paged Query Requests (both Interactive and Batch).
" }, "maxPageSize": { "type": "integer", "description": "If Paged Queries are supported, this is the maximum number of Objects that will be returned on a Page of Query results.
" }, "totalCount": { "type": "boolean" }, "applicationProduct": { "allOf": [ { "$ref": "#/definitions/productIdentity" }, { "description": "Application Vendor Identification
" } ] }, "adapterProduct": { "allOf": [ { "$ref": "#/definitions/productIdentity" }, { "description": "Adapter Vendor Identification
" } ] } } }, "alias": { "type": "object", "required": [ "code" ], "properties": { "code": { "allOf": [ { "$ref": "#/definitions/code" } ] }, "source": { "allOf": [ { "$ref": "#/definitions/uri" }, { "description": "URL where the related abbreviation comes from.
" } ] }, "namespace": { "allOf": [ { "$ref": "#/definitions/uri" }, { "description": "Namespace where the related abbreviation comes from.
" } ] } } }, "codeItem": { "type": "object", "required": [ "action", "code", "timestamp", "value" ], "properties": { "code": { "type": "string", "description": "Official abbreviation for the given value.
" }, "source": { "allOf": [ { "$ref": "#/definitions/uri" }, { "description": "URL where the related abbreviation comes from.
" } ] }, "namespace": { "allOf": [ { "$ref": "#/definitions/uri" }, { "description": "Namespace where the related abbreviation comes from.
" } ] }, "value": { "type": "string", "description": "What the code represents.
" }, "description": { "type": "string", "description": "Human readable explanation of what the code represents.
" }, "definition": { "type": "string", "description": "Human readable explanation provided by the source!
" }, "aliases": { "allOf": [ { "$ref": "#/definitions/aliases" } ] }, "action": { "description": "The last action to be taken for this code item.
", "oneOf": [ { "const": "ADD" }, { "const": "CHANGE" }, { "const": "DEPRECATED" }, { "const": "DELETE" } ] }, "timestamp": { "description": "The date and time of the last action taken on this code item. So that only updates can be queried efficiently (where applicable).
" } } }, "code": { "type": "object", "required": [ "official", "old", "value" ], "properties": { "old": { "type": "boolean", "description": "Indicates the alias code has been deprecated or deleted, even if it no longer appears in the register.
" }, "official": { "type": "boolean", "description": "Indicates the alias code is an official one; however the locale uses this one to represent that concept, at least in part.
" }, "value": { "type": "string", "description": "Alternate abbreviation that might need to be more specific or correct.
" } } }, "codeItems": { "type": "object", "required": [ "codeItem" ], "properties": { "codeItem": { "type": "array", "items": { "$ref": "#/definitions/codeItem" } } } }, "deleteStatusCollection": { "type": "object", "required": [ "delete" ], "properties": { "delete": { "type": "array", "items": { "$ref": "#/definitions/deleteStatus" } } } }, "deleteStatus": { "type": "object", "properties": { "id": { "type": "string", "xml": { "attribute": "true" } }, "statusCode": { "type": "string", "xml": { "attribute": "true" } }, "error": { "allOf": [ { "$ref": "#/definitions/error" } ] } } }, "deleteId": { "type": "object", "properties": { "id": { "type": "string", "xml": { "attribute": "true" } } } }, "mediaTypes": { "type": "object", "required": [ "mediaType" ], "properties": { "mediaType": { "type": "array", "items": { "type": "string" } } } }, "protocol": { "type": "object", "required": [ "location" ], "properties": { "location": { "type": "string", "format": "uri", "description": "The URL to use when sending Requests to a Provider
" }, "properties": { "allOf": [ { "$ref": "#/definitions/properties" }, { "description": "May contain zero or more property elements containing name/value pairs describing any protocol settings required to ensure proper communication
" } ] } } }, "updates": { "type": "object", "required": [ "update" ], "properties": { "update": { "type": "array", "items": { "$ref": "#/definitions/update" } } } }, "update": { "type": "object", "properties": { "id": { "type": "string", "xml": { "attribute": "true" } }, "statusCode": { "type": "string", "xml": { "attribute": "true" } }, "error": { "allOf": [ { "$ref": "#/definitions/error" } ] } } } } }