diff --git a/demo/openapi.yaml b/demo/openapi.yaml
index fc3ce073..1efeafcd 100644
--- a/demo/openapi.yaml
+++ b/demo/openapi.yaml
@@ -1,928 +1,117953 @@
-openapi: 3.0.0
-servers:
- - url: //petstore.swagger.io/v2
- description: Default server
- - url: //petstore.swagger.io/sandbox
- description: Sandbox server
+openapi: 3.0.2
info:
- description: |
- This is a sample server Petstore server.
- You can find out more about Swagger at
- [http://swagger.io](http://swagger.io) or on [irc.freenode.net, #swagger](http://swagger.io/irc/).
- For this sample, you can use the api key `special-key` to test the authorization filters.
-
- # Introduction
- This API is documented in **OpenAPI format** and is based on
- [Petstore sample](http://petstore.swagger.io/) provided by [swagger.io](http://swagger.io) team.
- It was **extended** to illustrate features of [generator-openapi-repo](https://github.com/Rebilly/generator-openapi-repo)
- tool and [ReDoc](https://github.com/Rebilly/ReDoc) documentation. In addition to standard
- OpenAPI syntax we use a few [vendor extensions](https://github.com/Rebilly/ReDoc/blob/master/docs/redoc-vendor-extensions.md).
-
- # OpenAPI Specification
- This API is documented in **OpenAPI format** and is based on
- [Petstore sample](http://petstore.swagger.io/) provided by [swagger.io](http://swagger.io) team.
- It was **extended** to illustrate features of [generator-openapi-repo](https://github.com/Rebilly/generator-openapi-repo)
- tool and [ReDoc](https://github.com/Rebilly/ReDoc) documentation. In addition to standard
- OpenAPI syntax we use a few [vendor extensions](https://github.com/Rebilly/ReDoc/blob/master/docs/redoc-vendor-extensions.md).
-
- # Cross-Origin Resource Sharing
- This API features Cross-Origin Resource Sharing (CORS) implemented in compliance with [W3C spec](https://www.w3.org/TR/cors/).
- And that allows cross-domain communication from the browser.
- All responses have a wildcard same-origin which makes them completely public and accessible to everyone, including any code on any site.
-
- # Authentication
-
- Petstore offers two forms of authentication:
- - API Key
- - OAuth2
- OAuth2 - an open protocol to allow secure authorization in a simple
- and standard method from web, mobile and desktop applications.
-
-
Derived from Systems Interoperability Framework™ SIF Implementation + Specification (New Zealand) 3.0 (RC 3)
Release Date: + 8-Aug-2019
+ basePath: v1 contact: - name: API Support - email: apiteam@swagger.io - url: https://github.com/Rebilly/ReDoc - x-logo: - url: 'https://rebilly.github.io/ReDoc/petstore-logo.png' - altText: Petstore logo - license: - name: Apache 2.0 - url: 'http://www.apache.org/licenses/LICENSE-2.0.html' -externalDocs: - description: Find out how to create Github repo for your OpenAPI spec. - url: 'https://github.com/Rebilly/generator-openapi-repo' -tags: - - name: pet - description: Everything about your Pets - - name: store - description: Access to Petstore orders - - name: user - description: Operations about user + name: Ministry of Education + url: http://www.education.govt.nz + email: terito@education.govt.nz + host: api.terito.education.govt.nz x-tagGroups: - - name: General + - name: Data Analysis ESR - Milestone 1 tags: - - pet - - store - - name: User Management + - environment + - Provider + - StudentPersonal + - StudentProviderEnrolment + - StudentAttendanceTimeList + - StaffPersonal + - StaffAssignment + - name: Data Analysis ESR - Milestone 2 tags: - - user + - StudentAssessmentTaskResult + - LearningStandard + - StudentAttainment + - name: Data Analysis ESR - Milestone 3 + tags: + - WellbeingEvent + - WellbeingCharacteristic + - StudentLearningSupportParticipation + - name: Data Analysis ESR - Milestone 4 + tags: + - StudentAssessmentTaskResult + - name: SIF Infrastructure Services + tags: + - environment + - name: Provider + tags: + - ProviderOverview + - Provider + - Organisation + - ProviderRelationship + - StaffPersonal + - StaffAssignment + - ProviderCourse + - TeachingGroup + - AcademicDepartment + - Schedule + - ScheduleAcademicDay + - SchedulePeriod + - ScheduleTerm + - ScheduleDate + - ScheduleEvent + - BellSchedule + - ScheduleHoliday + - TeachingGroupEvent + - LearningSupportRegisterDirectory + - name: Student & Whānau + tags: + - StudentWhānauOverview + - StudentPersonal + - StudentContactPersonal + - StudentContactRelationship + - StudentConsent + - name: Enrolment + tags: + - EnrolmentOverview + - StudentProviderEnrolment + - StudentTeachingGroupEnrolment + - name: Hauora / Wellbeing + tags: + - HauoraWellbeingOverview + - WellbeingCharacteristic + - WellbeingAlert + - WellbeingEvent + - WellbeingResponse + - WellbeingAppeal + - StudentLearningSupportParticipation + - Document + - StudentVoice + - StudentPhysicalRestraint + - name: Schedule & Attendance + tags: + - ScheduleAttendanceOverview + - StudentAttendanceTimeList + - StudentAttendanceSummary + - name: Aromatawai / Assessment + tags: + - AromatawaiAssessmentOverview + - StudentAssessmentTaskRegistration + - AssessmentTask + - StudentAssessmentTask + - StudentAssessmentTaskResult + - StudentAttainment + - Credential + - LearningStandard + - StudentCurriculumProgressReport +tags: + - name: environment + 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.
+ externalDocs: + description: Environment service in SIF Infrastructure v3.3 + url: http://specification.sifassociation.org/Implementation/Infrastructure/3.3/infrastructures/SIFInfrastructureServices.html#351Environment + - name: ProviderOverview + x-displayName: Provider Overview + description:The Provider domain describes education provider entities, the + relationships between them, and the Staff that work at them.
+ Background documentation on the Provider domain is available here +
+ externalDocs: + description: Provider Domain in SIF NZ Data Model + url: https://sifnzmodel.azurewebsites.net/SIFNZ-v3.0-rc3/DomainMap.html#Domain__Provider + - name: StudentWhānauOverview + x-displayName: Student & Whānau Overview + description:The Student domain describes Student entities, their Whānau, and the + relationships between them.
Background documentation on the + Student & Whānau domain is available here +
+ externalDocs: + description: Student & Whānau Domain in SIF NZ Data Model + url: https://sifnzmodel.azurewebsites.net/SIFNZ-v3.0-rc3/DomainMap.html#Domain__StudentWhānau + - name: EnrolmentOverview + x-displayName: Enrolment Overview + description:The Enrolment domain describes transactional entities whereby Students + enrol at Providers, in LearningProgrammes, in Sections, or in Activities. +
Background documentation on the Enrolment domain is available + here +
+ externalDocs: + description: Enrolment Domain in SIF NZ Data Model + url: https://sifnzmodel.azurewebsites.net/SIFNZ-v3.0-rc3/DomainMap.html#Domain__Enrolment + - name: HauoraWellbeingOverview + x-displayName: Hauora / Wellbeing Overview + description:The Hauora / Wellbing domain records everything from Student's health + conditions through behavioural incidents (both good and bad) to Student's + aspirations and goals participation in extra-curricular activities and the + provision of Learning Support programmes.
Background documentation on + the Hauora / Wellbeing domain is available here + externalDocs: + description: Hauora / Wellbeing Domain in SIF NZ Data Model + url: https://sifnzmodel.azurewebsites.net/SIFNZ-v3.0-rc3/DomainMap.html#Domain__Hauora/Wellbeing + - name: ScheduleAttendanceOverview + x-displayName: Schedule & Attendance Overview + description:The Schedule & Attendance domain describes the school's schedule or + timetable, along with transactional entities that record a Student's + attendance at & absence from Providers. Attendance is recorded at either + Day, Half-Day or individual Period granuality at the choice of the + Provider; and reported back in summary form.
Background + documentation on the Schedule domain is available here +
Background documentation on the Attendance domain is available + here +
+ externalDocs: + description: Schedule & Attendance Domain in SIF NZ Data Model + url: https://sifnzmodel.azurewebsites.net/SIFNZ-v3.0-rc3/DomainMap.html#Domain__ScheduleAttendance + - name: AromatawaiAssessmentOverview + x-displayName: Aromatawai / Assessment Overview + description:The Assessment domain describes transactional entities that record + assessment of Student's learning. The domain covers everything from a + simple in-class assessment task (eg grading assignment, test or essay) + through to end of Course or year final marks, and curriculum progress + reports as well as formal external assessments performed by external + agencies (eg. NZQA, Cambridge International Education, International + Baccalaureate, etc).
Background documentation on the Aromatawai / + Assessment domain is available here +
+ externalDocs: + description: Aromatawai / Assessment Domain in SIF NZ Data Model + url: https://sifnzmodel.azurewebsites.net/SIFNZ-v3.0-rc3/DomainMap.html#Domain__Aromatawai/Assessment + - name: Provider + description: A recognised provider of education services in the New Zealand education + system. Providers may operate in the Early Childhood, Compulsory Schooling + or Tertiary sectors. + - name: ProviderRelationship + description:Records a recognised relationship between two education Providers. The + two providers are referred to as the Source Provider and the Related + Provider.
RelationshipType records the nature of the relationship + between the two providers, and gives guidance on which Provider is the + Source Provider and which is the Related Provider.
+ - name: Organisation + description: A generic organisation that operates within the education sector; but + doesn’t provide education services. e.g. Communities of Learning | Kāhui + Ako, Ministry local offices, Industry training organisations, etc. + - name: AcademicDepartment + description:Information about an academic department within a provider, e.g. Maths + Department.
+ - name: StaffPersonal + description:All the personal contact and demographic information relating to a + staff member, who might be a teacher or other employee of a Provider.
+Non personal information relating to the staff member's relationship + with Providers is stored in the StaffAssignment data object.
+ - name: StaffAssignment + description:Records assignment of a Staff member to a particular role at a Provider + or other EducationOrganisation. A staff member can have multiple + concurrent roles at Schools (via Provider data object) and Kāhui Ako (via + the EducationOrganisation data object); each role would be a separate + StaffAssignment record.
Role assignments can be restricted to + categories of Students with the StaffSubjectList and YearLevelList. This + allows for assignment to roles with particular responsibility for general + cohorts of students, such as "Head of Department (Maths)" or "Year 8 + Student Dean".
While assignment to student contact roles such as + Subject Teacher, Homeroom Teacher, Whānau Teacher or House Master is made + with this data object; Details of the particular group of specific + students the staff member is responsible for are made via the + TeachingGroup data object.
+ - name: StaffTeachingGroupAssignment + description:Records assignment of a Staff member to a particular role with a + particular TeachingGroup at a Provider
+ - name: StudentPersonal + description: Contains all the personal information related to the student. + - name: StudentContactPersonal + description: Information about a Student's whānau member. + - name: StudentContactRelationship + description:A relationship between a person who is part of a Student's whānau and + that Student. Relationship properties include the relationship type and + roles played by the student contact in respect of the student.
+Individual details about the student and student contact are provided + in other data objects - StudentPersonal and StudentContactPersonal + respectively.
+ - name: Document + description:Location and meta-data of a document, including evidentiary documents, + personalised plans, and action plans.
+ - name: StudentConsent + description: A record of Student's consent or non-consent to some action taking place. + - name: TeachingGroup + description:Identifies a particular class or other group of students. Such groups + can have multiple staff assigned in a variety of roles, may be assigned + students from multiple year levels and may be taught multiple courses. +
+ - name: ProviderCourse + description:A Provider defined Course that Students enrol in, and may be assessed + for, and achieve passes in.
+ - name: LearningStandard + description:A curriculum standard or the like published by a national body, + professional association or other interested party. The LearningStandard + describes a set of learning that students are expected to undertake.
+ - name: Credential + description:A qualification or other award published by a national body, + professional association or other interested party. The Credential + recognises a set of learning that students have undertaken and + successfully completed.
+ - name: StudentProviderEnrolment + description:A student's association with an education provider for the purpose of + receiving educational servics.
Provider enrolments span multiple + years with the ProviderEnrolment containing one or more ECE, School or + Tertiary Enrolment sub-objects for each particular year.
+ - name: StudentTeachingGroupEnrolment + description:Records a student's arrival to and departure from a TeachingGroup.
+ - name: Schedule + description: Provides information about a schedule for a provider. + - name: ScheduleAcademicDay + description: An academic day that makes up all or part of a schedule for a provider. An + academic day represents a structured day that reoccurs consistently e.g. + Day A has five periods that occurs Mon-Wed and Day B has four periods and + occurs Thurs-Fri. + - name: SchedulePeriod + description: Defines the periods that take place within an academic day + - name: BellSchedule + description: Defines bell schedules, each of which is a collection of periods within an + academic day with start and end times associated. These bell schedules are + assigned to calendar dates on which the school is in session using + ScheduleDate in order to specify the school schedule on those dates. These + bell schedules should generally only be used to define standard day types. + Exception days (unless they repeat multiple times and follow a common + template) are defined using ScheduleEvent and ScheduleCustomDayEvent. + - name: ScheduleTerm + description:Provides information about school terms, tertiary terms etc., either at + a national, or provider level, within a school year. If the term is being + supplied at a national level, no provider information will be linked.
+ - name: ScheduleHoliday + description:Provides information about a holiday that may or may not impact upon + the schedule of a provider.
+ - name: ScheduleDate + description: Provides information about the schedule that is being followed on a + specific calendar date at a particular Provider, e.g. Academic Day A from + the Term 1 Schedule using the Periods and their start and end times + defined in Bell Schedule Day A. + - name: TeachingGroupEvent + description:Defines a single SchedulePeriod in a Schedule where the TeachingGroup + meets.
+ - name: ScheduleEvent + description:Defines events that may or may not impact the schedule. These events + may simply be for display, or may affect the schools academic + schedule.
+ - name: StudentAttendanceSummary + description:Provides a summary of a student's daily attendance and membership + information for a given provider during the time period between the + StartDate and EndDate, inclusive. There will be multiple instances of this + object for a student in a school over the course of a school year. This + summary may be generated by aggregating more granular attendance records, + in which case all fields will be read-only; and RefId element may not be + applicable.
+ - name: StudentAttendanceTimeList + description:This object provides more detail about the attendance spans for a + single student during the day it provides more detailed information than + the single TimeIn and TimeOut elements in StudentDailyAttendance.
+ - name: WellbeingAlert + description:Alert indicating to teachers and systems that this student has a + 'concern' that needs to be known for 'duty of care', which could be + Medical, Legal or other.
The alert may merely draw attention to + Wellbeing Characteristics or Events, that contain more detail.
+ - name: WellbeingCharacteristic + description:Core Wellbeing Characteristic that is integral to the Student. This may + be a Medical condition, special needs or a characteristic such as a known + disability or any other characteristic or condition that is student + specific and impacts their learning.
+ - name: WellbeingEvent + description:Record of an event happening that impacts on a school's duty of care to + its students. The event records both 'positive' and 'negative' behaviours + and is not just the recording of a discipline incident or an accident.
+ - name: WellbeingResponse + description:A record of the outcome and follow ups generated by a WellbeingEvent
+ - name: WellbeingAppeal + description:Records detail of any "appeal" or "request" made by involved parties in + regard to a negative/punitive Wellbeing Response that was the result of a + student Wellbeing Event.
+ - name: StudentActivityParticipation + description: This object provides information on a co-curricular or extra-curricular + activity in which a student participates during a given school year. + - name: StudentPhysicalRestraint + description:Provides information about an incident where staff members or other + parties used physical restraint on a child.
+ - name: StudentVoice + description: A record of a student's interests as well as their social, academic and + academic goals. + - name: LearningSupportRegisterDirectory + description:Learning Support Needs are grouped by similarity. The Learning Support + Directory maps those groups to Learning Support Interventions so when a + Learning Support Need is identified for the Student only applicable + Interventions for the group it belongs to are presented to the user. It + also holds additional information about the Learning Support + Interventions, e.g. Description, Funded By, Provided by.
+ - name: StudentLearningSupportParticipation + description:Contains information pertaining to a student's participation in + learning support.
+ - name: AssessmentTask + description:This object provides information about a particular assignment, allows + applications to synchronize each other's assignment tables, gathers the + definition for a StudentAssessmentTask object, etc.
+ - name: StudentAssessmentTaskResult + description:Records the result achieved by a single student at a particular + assessment task.
+ - name: StudentAssessmentTaskRegistration + description:The student's registration for an assessment task they are intending to + participate in.
+ - name: StudentAssessmentTask + description:Record of a student's attempt at a particular assessment task.
+ - name: StudentAttainment + description:Records a student gaining an Attainment e.g. NCEA Qualification, + Learning Standard etc.
+ - name: StudentCurriculumProgressReport + description:A single curriculum progress and achievement report provided for a + student. Used in technology centres allowing the host provider to report + on student progress to their base school.
May be extended in the + future to cover reporting on other curriculum areas.
paths: - /pet: - parameters: - - name: cookieParam - in: cookie - description: Some cookie - required: true - schema: - type: integer - format: int64 + /environments: post: tags: - - pet - summary: Add a new pet to the store - description: Add new pet to the store inventory. - operationId: addPet - responses: - '405': - description: Invalid input - security: - - petstore_auth: - - 'write:pets' - - 'read:pets' - x-code-samples: - - lang: 'C#' - source: | - PetStore.v1.Pet pet = new PetStore.v1.Pet(); - pet.setApiKey("your api key"); - pet.petType = PetStore.v1.Pet.TYPE_DOG; - pet.name = "Rex"; - // set other fields - PetStoreResponse response = pet.create(); - if (response.statusCode == HttpStatusCode.Created) - { - // Successfully created - } - else - { - // Something wrong -- check response for errors - Console.WriteLine(response.getRawResponse()); - } - - lang: PHP - source: | - $form = new \PetStore\Entities\Pet(); - $form->setPetType("Dog"); - $form->setName("Rex"); - // set other fields - try { - $pet = $client->pets()->create($form); - } catch (UnprocessableEntityException $e) { - var_dump($e->getErrors()); - } - requestBody: - $ref: '#/components/requestBodies/Pet' - put: - tags: - - pet - summary: Update an existing pet - description: '' - operationId: updatePet - responses: - '400': - description: Invalid ID supplied - '404': - description: Pet not found - '405': - description: Validation exception - security: - - petstore_auth: - - 'write:pets' - - 'read:pets' - x-code-samples: - - lang: PHP - source: | - $form = new \PetStore\Entities\Pet(); - $form->setPetId(1); - $form->setPetType("Dog"); - $form->setName("Rex"); - // set other fields - try { - $pet = $client->pets()->update($form); - } catch (UnprocessableEntityException $e) { - var_dump($e->getErrors()); - } - requestBody: - $ref: '#/components/requestBodies/Pet' - '/pet/{petId}': - get: - tags: - - pet - summary: Find pet by ID - description: Returns a single pet - operationId: getPetById - parameters: - - name: petId - in: path - description: ID of pet to return - required: true - deprecated: true - schema: - type: integer - format: int64 - responses: - '200': - description: successful operation - content: - application/json: - schema: - $ref: '#/components/schemas/Pet' - application/xml: - schema: - $ref: '#/components/schemas/Pet' - '400': - description: Invalid ID supplied - '404': - description: Pet not found - security: - - api_key: [] - post: - tags: - - pet - summary: Updates a pet in the store with form data - description: '' - operationId: updatePetWithForm - parameters: - - name: petId - in: path - description: ID of pet that needs to be updated - required: true - schema: - type: integer - format: int64 - responses: - '405': - description: Invalid input - security: - - petstore_auth: - - 'write:pets' - - 'read:pets' + - environment + summary: Initiate SIF Environment + operationId: createEnvironment requestBody: + description: Initial operation to create a SIF Environment (or Session) content: - application/x-www-form-urlencoded: + application/json: schema: type: object properties: - name: - description: Updated name of the pet - type: string - status: - description: Updated status of the pet - type: string - delete: + environment: + type: object + required: + - type + - authenticationMethod + - consumerName + - applicationInfo + properties: + type: + type: string + xml: + attribute: true + enum: + - DIRECT + authenticationMethod: + type: string + description:Defines the way in which the applicationKey can be + used to enforce security.
+ 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: + type: object + required: + - applicationKey + - supportedInfrastructureVersion + - dataModelNamespace + - transport + 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
+ enum: + - REST + description:The SIF Environment Service is the gateway to all other + SIF services. It scopes the Client's possible interactions + with the infrastructure and any Services accessible from it. + The Environment Service provides the set of (possibly + customized) information the Application needs to + interoperate successfully.
+ example: + environment: + type: DIRECT + authenticationMethod: OAuth + consumerName: SMS Name + applicationInfo: + applicationKey: Example + supportedInfrastructureVersion: 3.3 + dataModelNamespace: http://www.sifassociation.org/datamodel/nz/3.0 + transport: REST + application/xml: + schema: + type: object + properties: + environment: + $ref: "#/paths/~1environments/post/requestBody/content/applicatio\ + n~1json/schema/properties/environment" + example: "$ref: '../examples/environment.yaml#/post/xml'" + responses: + "200": + description: SIF Environment successfully initiated + content: + application/json: + schema: + type: object + properties: + environment: + type: object + required: + - type + - id + - sessionToken + - defaultZone + - authenticationMethod + - consumerName + - applicationInfo + - infrastructureServices + - provisionedZones + properties: + type: + type: string + xml: + attribute: true + enum: + - DIRECT + id: + 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}" + xml: + attribute: true + sessionToken: + type: string + defaultZone: + type: object + properties: + id: + type: string + xml: + attribute: true + description: + type: string + description:A short (possibly multi-sentence) description + of the Zone
+ properties: + type: object + required: + - property + properties: + property: + type: array + items: + type: object + properties: + value: + type: string + name: + type: string + description:Name/Value pair.
+ xml: + attribute: true + 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.
+ authenticationMethod: + type: string + description:Defines the way in which the applicationKey can be + used to enforce security.
+ 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: + type: object + description: A description of the SIF application environment that + has been provisioned for the client + required: + - supportedInfrastructureVersion + - dataModelNamespace + - transport + properties: + supportedInfrastructureVersion: + type: string + description:The version of the SIF infrastructure which the + SIF Environment 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
+ enum: + - REST + infrastructureServices: + type: object + description: A set of two (2) Infrastructure Service definitions, + that have been provisioned for the client + required: + - infrastructureService + properties: + infrastructureService: + type: array + items: + type: object + properties: + value: + type: string + description: Full or Partial URL of the SIF + Infrastructure Service that will accept the + relevant REST calls + name: + type: string + description: >- + The name of the SIF Infrastructure Service + being defined; one of:+ The set of Zones that have been provisioned as part of this SIF Environment (Session). + Each Zone represents an individual School or Kāhui Ako, and is identified with it's MoE OrganisationId +
+ For the Te Rito Data Analysis ESR; each SIF Environment will be provisioned with a single Zone. Future ESRs + and the full Te Rito project will make use of SIF Environments provisioned with multiple Zones. +
+ required: + - provisionedZone + properties: + provisionedZone: + type: array + items: + type: object + required: + - id + - services + 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: + type: object + description: A set of SIF Service definitions, (ACL + lists) for each of the SIF services that are + available to the connecting client in this + particular Zone + required: + - service + properties: + service: + type: array + items: + type: object + required: + - contextId + - name + - rights + - type + properties: + type: + type: string + oneOf: + - enum: + - UTILITY + - enum: + - OBJECT + - enum: + - FUNCTIONAL + - enum: + - SERVICEPATH + - enum: + - XQUERYTEMPLATE + - enum: + - SERVICE + 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: + type: object + required: + - right + description: The Access Control List (ACL) + denoting which operations are + available to the connecting client + for this SIF Service + properties: + right: + type: array + items: + type: object + properties: + value: + type: string + oneOf: + - enum: + - APPROVED + - enum: + - SUPPORTED + - enum: + - REJECTED + - enum: + - UNSUPPORTED + - enum: + - REQUESTED + type: + description:The type of the + requested Access + Right
+ oneOf: + - enum: + - QUERY + - enum: + - CREATE + - enum: + - UPDATE + - enum: + - DELETE + - enum: + - SUBSCRIBE + - enum: + - PROVIDE + xml: + attribute: true + description:The SIF Environment Service is the gateway to all other + SIF services. It scopes the Client's possible interactions + with the infrastructure and any Services accessible from + it. The SIF Environment Service provides the set of + (possibly customized) information the Application needs to + interoperate successfully.
+ example: + environment: + type: DIRECT + sessionToken: a579ff69-0148-1000-007f-14109fdcaf83 + defaultZone: + id: b9969a95-352c-445e-bf13-1d01e1c6bc12 + description: Zone for Wellington College, MoE ProviderId=275 + properties: + property: + - name: providerId + value: "275" + - name: emailContact + value: john.smith@district.k12.wa.us + - name: phoneContact + value: (360)555-1234 + authenticationMethod: Bearer + consumerName: SMS Name + applicationInfo: + applicationKey: Example + supportedInfrastructureVersion: 3.3 + dataModelNamespace: http://www.sifassociation.org/datamodel/nz/3.0 + transport: REST + infrastructureServices: + infrastructureService: + - name: environment + value: https://testharness.sifassociation.org/SIFConnector/v1/environments/ + - name: requestsConnector + value: https://testharness.sifassociation.org/SIFConnector/v1/ + provisionedZones: + provisionedZone: + id: b9969a95-352c-445e-bf13-1d01e1c6bc12" + services: + service: + - name: providers + contextId="DEFAULT": null + type="OBJECT": null + rights: + - right: + type: QUERY + value: APPROVED + - right: + type: CREATE + value: REJECTED + - right: + type: UPDATE + value: REJECTED + - right: + type: DELETE + value: REJECTED + - right: + type: SUBSCRIBE + value: UNSUPPORTED + - name: studentpersonals + contextId="DEFAULT": null + type="OBJECT": null + rights: + - right: + type: QUERY + value: APPROVED + - right: + type: CREATE + value: REJECTED + - right: + type: UPDATE + value: REJECTED + - right: + type: DELETE + value: REJECTED + - right: + type: SUBSCRIBE + value: UNSUPPORTED + - name: studentproviderenrolments + contextId="DEFAULT": null + type="OBJECT": null + rights: + - right: + type: QUERY + value: APPROVED + - right: + type: CREATE + value: REJECTED + - right: + type: UPDATE + value: REJECTED + - right: + type: DELETE + value: REJECTED + - right: + type: SUBSCRIBE + value: UNSUPPORTED + application/xml: + schema: + type: object + properties: + environment: + $ref: "#/paths/~1environments/post/responses/200/content/applic\ + ation~1json/schema/properties/environment" + example: "$ref: '../examples/environment.yaml#/get/xml'" + default: + description: Failed to Initiate SIF Environment. + content: + application/json: + schema: + $ref: "#/components/errors/create/content/application~1json/schema" + application/xml: + schema: + $ref: "#/components/errors/create/content/application~1json/schema" + "/environments/{id}": + get: tags: - - pet - summary: Deletes a pet - description: '' - operationId: deletePet + - environment + summary: Retrieve a SIF Environment + operationId: getEnvironment + description: Retrieve current settings for a particular SIF Environment parameters: - - name: api_key - in: header - required: false + - name: id + in: path + description: GUID identifying the environment being retrieved. + required: true schema: type: string - example: "BearerThis is a common element used to define the + locally assigned identifier associated with an + entity.
+ type: string + AddressList: + description:The set of postal and other addresses that + the Organisation uses
+ type: object + required: + - Address + properties: + Address: + type: array + items: + description:This element contains address data.
+ type: object + required: + - Street + properties: + Type: + type: string + title: Address Type + description: >- +Address type allows an address to + be categorised according to its + component structure. Address type can + be used to build processing rules for + validating, managing and presenting + addresses. Address type is independent + of the use of the address by any + party. To describe how a party may use + an address (residence, billing, term + address etc) see AddressRoleType
+Also called 'Street' + addresses, The most general, and + widely used type of address, and + can contain the widest variety of + components
In general a + thoroughfare address will include + components for a number, a + roadname, and a locality.
+They cannot contain any of the + components specific to a delivery + service, rural post delivery, or + water address.
These + addresses are used to find a + location.
Example: 30 - 40 + Lambton Quay, Wellington, + 6165
\"" + enum: + - TH + - title: Rural Post Delivery + description: '"Defined by New Zealand Post, + these addresses are assigned by NZ + Post for customers who purchase a + rural delivery service (mail and + also other goods).
They + will have the same number and + roadname components as the street + address, and may have the same + region component.
They do + not have a component that + identifies the locality the + address is within. The locality + and city or town components are + replaced by components that + identify the rural delivery route + (RD number), and the town from + which the rural delivery route + starts and finishes (the mail + town). Only addresses of this + class can contain these + components.
+ Example: 121 Waitaha + Road, RD 1, Ross, 7885
"' + enum: + - RU + - title: Delivery Service + description: '"Defined by New Zealand Post, + and used exclusively for NZ Post + services other than standard mail + delivery. Addresses in this class + include PO Box, Private Bag, and + Counter Delivery addresses.
+Example: Private Bag + 2345, Auckland, 1142
"' + enum: + - DE + - title: Water + description: '"Where properties have no road + access, but do have access to + water frontage (coastline or + riverbank or lakefront), a water + address uses the name of a water + feature (for example, islands, + rivers, bays, or peninsulas).
+Example: 235 Lochmara + Bay, Queen Charlotte Sound, + Marlborough Sounds
"' + enum: + - WA + - title: Foreign Address + description: '"A foreign address identifies + a location outside of New + Zealand.
Example: + Rudolf-Diesel-Strasse 14, 54595 + Prüm, Germany
"' + enum: + - FO + Role: + type: string + title: Address Role + description: >- +A standardised description of the + role or usage of an address by a party + (person or organisation). Where a + party has more than one address, this + provides context for deciding which + address to use.
The street element is a complex + element and breaks the street down + into several parts. (Allow for PO Box + here)
+ type: object + required: + - Line1 + properties: + Line1: + type: string + description:Address line 1.
+ Line2: + type: string + description:Address line 2.
+ Line3: + type: string + description:Address line 3.
+ Suburb: + type: string + description:The suburb part of urban addresses, + or the 'RD No' part of rural + addresses
+ City: + type: string + description:The city part of the address.
+ StateProvince: + type: string + description:The state or province code. + StateTerritory Code only applicable if + a non-New Zealand Address.
+ Country: + type: string + description:The country code.
+ PostalCode: + type: string + description:The ZIP/postal code.
+ GridLocation: + description:The latitude & longitude of the + location. Grid location values are + derived from New Zealand Map Grid x,y + coordinates and converted to Latitude + and Longitude values per the World + Geodetic System 1984 (G1762)
+ type: object + required: + - Latitude + - Longitude + properties: + Latitude: + description:Latitude in decimal + degrees.
Latitudes north + of the equator are positive, + latitudes south of the equator are + negative [ISO 6709].
+ Longitude: + description:Longitude in decimal + degrees.
Longitudes east of + the Prime Meridian in Greenwich + are positive, longitudes west of + the Prime Meridian are negative. + The 180th meridian is negative. + [ISO 6709]
+ StatisticalAreaList: + description:A list of Statistical Areas + containing the location.
The + list may contain exactly one + StatisticalArea element for each of + the following spatial unit types:
+A particular statistical area + defined by Statistics New + Zealand.
+ type: object + required: + - Code + - SpatialUnitType + properties: + SpatialUnitType: + type: string + title: Spatial Unit Type + description: >- +A classification of + geographical boundaries or + statistical areas as defined + by Statistics NZ’s + geographic hierarchy.
+Area units are + aggregations of + meshblocks. They are + non–administrative areas + that are in between + meshblocks and + territorial authorities + in size. Area units must + either define or + aggregate to define, + regional councils, + territorial authorities + and urban areas.
+ Statistics NZ + Classification of Area + Unit 2013 v1.0.0 + enum: + - AE + - title: General Electoral + District + description:The general electoral + districts as constituted + under the Electoral Act + 1993.
Statistics NZ + General Electoral + District 2014 v1.0.0 + enum: + - GE + - title: Community Board + description:(aka Local Board + within Auckland) Local + boards provide + governance at the local + level within Auckland + Council. They enable + democratic decision + making by, and on behalf + of communities within + the local board + area.
Statistics NZ + Community Board 2013 + v1.0.0 + enum: + - CB + - title: Māori Electoral District + description:Māori electoral + districts are the voting + districts for + parliamentary elections + for people who choose to + be on the Māori + Electoral Roll.
+ Statistics NZ Māori + Electoral District 2014 + v1.0.0 + enum: + - ME + - title: Mesh Block + description:A meshblock is the + smallest geographic unit + for which statistical + data is collected and + processed by Statistics + New Zealand.
A + meshblock is defined by + a geographic area, which + can vary in size from + part of a city block to + a large area of rural + land. Each meshblock + borders on another to + form a network covering + all of New Zealand, + including coasts and + inlets and extending out + to the 200-mile economic + zone.
Statistics NZ + Statistical Standard for + Meshblock 2013 v1.0.0 + enum: + - MB + - title: Regional Council + description:The top tier of local + government in New + Zealand, defined by the + Local Government Act + 2002, which requires the + boundaries of regions to + conform as far as + possible to one or more + water catchments. When + determining regional + boundaries, the Local + Government Commission + gave consideration to + regional communities of + interest when selecting + water catchments to be + included in a region. It + also considered factors + such as natural resource + management, land use + planning and + environmental + matters.
Statistics + NZ Regional Council 2013 + v1.0.0 + enum: + - RC + - title: Territorial Authority + description:The second tier of + local government in New + Zealand, defined under + the Local Government Act + 2002 as a city council + or district council. + There are 67 territorial + authorities consisting + of 12 city councils, 53 + districts, Auckland + Council, and Chatham + Islands Council.
+ Statistics NZ + Territorial Authority + 2013 v1.0.0 + enum: + - TA + - title: Urban Area + description: '"Urban Areas are + statistically defined + areas with no + administrative or legal + basis. There is a three + part hierarchical + sub-division of urban + areas into: main urban + areas, secondary urban + areas, minor urban + areas. Together the + populations in main, + secondary and minor + urban areas comprise the + statistically defined + urban population of New + Zealand. The urban area + classification is + designed to identify + concentrated urban or + semi-urban settlements + without the distortions + of administrative + boundaries.
+ Statistics NZ Urban Area + 2013 v2.0.0"' + enum: + - UA + - title: Ward + description:Wards are defined + under the Local + Electoral Act 2001 and + result from the + division, for electoral + purposes, of the + district of a + territorial authority. + The ward system was + designed to allow for + the recognition of + communities within a + district and to increase + community involvement in + the local government + system.
Statistics + NZ Ward 2013 v1.0.0 + enum: + - WA + Code: + type: string + description:A valid value defined by + the nominated spatial unit + type, defined by Statistics + New Zealand in one of the + following statistical area + defintion standards:
+A list of one or more methods of + communication with the organisation
+ type: object + required: + - Channel + properties: + Channel: + type: array + items: + description:A particular person or organisation's + communications method
+ type: object + required: + - Value + properties: + Type: + type: string + title: Communication Channel Type + description: >- +A standardised method of describing + a communication channel used to + communicate with or find information + about a party. Provides a more generic + definition than phone and email. + Intended to provide for future + requirements to record social network + channels, eg Facebook & Twitter + identifiers for a school.
The unique value that provides + access to the channel. eg: URL for a + website; Facebook page addess, Twitter + handle.
" + ContactList: + description:A list of one or more cotact persons related + to the organisation
+ type: object + required: + - Contact + properties: + Contact: + type: array + items: + description:A particular person's contact + details
+ type: object + required: + - Name + properties: + Name: + description:The contact's name
+ type: object + properties: + Title: + type: string + description:A title or prefix associated + with the name.
+ FamilyName: + type: string + description:Also known as Last Name, + although some cultures may not + present a family name as the last + name.
+ GivenName: + type: string + description:Also known as First Name, + although some cultures may not + present this name as the first + element in a name. May contain a + composite of all given names.
+ MiddleName: + type: string + description:Where more than one Given Name, + these may be combined in one + composite field or else populated + in several elements.
+ FamilyNameFirst: + type: string + title: Yes Or No Category + description: >- +A reusable code set for yes, + no, unknown and not provided + values.
A preferred version of the + Family Name. Note:A name cannot + have both a Preferred Family and + Preferred Given Name within the + same Name structure – only one of + these fields should be populated. + If a person does have both a + Preferred Family and Preferred + Given Name then this must be + populated as a separate Name of + type ‘Preferred’.
+ PreferredFamilyNameFirst: + $ref: "#/paths/~1Providers/get/response\ + s/200/content/application~1json/s\ + chema/properties/Providers/proper\ + ties/Provider/items/properties/Co\ + ntactList/properties/Contact/item\ + s/properties/Name/properties/Fami\ + lyNameFirst" + PreferredGivenName: + type: string + description: "A preferred version of the + Given Name. Note: A name cannot + have both a Preferred Family and + Preferred Given Name within the + same Name structure – only one of + these fields should be populated. + If a person does have both a + Preferred Family and Preferred + Given Name then this must be + populated as a separate Name of + type ‘Preferred’.
" + Suffix: + type: string + description:Textual suffix like PHD, JP, + BSc.
+ FullName: + type: string + description:A combination of all name + elements as one composite text + element
+ Type: + type: string + title: Name Usage Type + description: >- +A standardised method of + describing the usage of a name by + a person. Where a person has more + than one current name, the usage + type indicates which name may be + used according to the purpose.
+Code values are based on SIF + Australia 3.4.
The name by which an + individual prefers to be known + and addressed.
Only + usage type applicable for + student name usage (other + types are not supported by + NSI).
+ enum: + - PRF + - title: Foreign Official Name + description:Included for future usage + in NZ, especially for tertiary + students.
+ enum: + - FON + - title: Previous name + enum: + - PRV + - title: Also Known As + description: AKA or Alias + enum: + - AKA + - title: Name at Birth + enum: + - BTH + - title: Legal Name + description:Legal Name or Official Name + as defined by the organisation + which collects it (legal name + is not defined in this + standard)
+ enum: + - LGL + IsVerified: + $ref: "#/paths/~1Providers/get/response\ + s/200/content/application~1json/s\ + chema/properties/Providers/proper\ + ties/Provider/items/properties/Co\ + ntactList/properties/Contact/item\ + s/properties/Name/properties/Fami\ + lyNameFirst" + PositionTitle: + type: string + description:The title the contact has within + the Organisation being contacted
+ Role: + type: string + title: Organisation Contact Role + description: >- +The role played by a person in an + organisation where that person is + recorded as a contact. The role + definition is used to recognise + similar functions across + organisations, however individuals + with the same role may be given + different position titles that differ + from the generic role description. For + example, a principal may have a title + of ‘headmaster’.
A list of Address elements.
+ type: object + required: + - Address + properties: + Address: + type: array + items: + description:This element contains address + data.
+ type: object + required: + - Street + properties: + Type: + $ref: "#/paths/~1Providers/get/re\ + sponses/200/content/applica\ + tion~1json/schema/propertie\ + s/Providers/properties/Prov\ + ider/items/properties/Addre\ + ssList/properties/Address/i\ + tems/properties/Type" + Role: + $ref: "#/paths/~1Providers/get/re\ + sponses/200/content/applica\ + tion~1json/schema/propertie\ + s/Providers/properties/Prov\ + ider/items/properties/Addre\ + ssList/properties/Address/i\ + tems/properties/Role" + Street: + description:The street element is a + complex element and breaks + the street down into several + parts. (Allow for PO Box + here)
+ type: object + required: + - Line1 + properties: + Line1: + type: string + description:Address line 1.
+ Line2: + type: string + description:Address line 2.
+ Line3: + type: string + description:Address line 3.
+ Suburb: + type: string + description:The suburb part of urban + addresses, or the 'RD No' + part of rural addresses
+ City: + type: string + description:The city part of the + address.
+ StateProvince: + type: string + description:The state or province + code. StateTerritory Code + only applicable if a non-New + Zealand Address.
+ Country: + type: string + description:The country code.
+ PostalCode: + type: string + description:The ZIP/postal code.
+ GridLocation: + description:The latitude & longitude + of the location. Grid + location values are derived + from New Zealand Map Grid + x,y coordinates and + converted to Latitude and + Longitude values per the + World Geodetic System 1984 + (G1762)
+ type: object + required: + - Latitude + - Longitude + properties: + Latitude: + description:Latitude in decimal + degrees.
+ Latitudes north of the + equator are positive, + latitudes south of the + equator are negative + [ISO 6709].
+ Longitude: + description:Longitude in decimal + degrees.
+Longitudes east of + the Prime Meridian in + Greenwich are positive, + longitudes west of the + Prime Meridian are + negative. The 180th + meridian is negative. + [ISO 6709]
+ StatisticalAreaList: + description:A list of Statistical + Areas containing the + location.
The list + may contain exactly one + StatisticalArea element for + each of the following + spatial unit types:
A particular + statistical area + defined by Statistics + New Zealand.
+ type: object + required: + - Code + - SpatialUnitType + properties: + SpatialUnitType: + $ref: "#/paths/~1Provid\ + ers/get/responses/2\ + 00/content/applicat\ + ion~1json/schema/pr\ + operties/Providers/\ + properties/Provider\ + /items/properties/A\ + ddressList/properti\ + es/Address/items/pr\ + operties/Statistica\ + lAreaList/propertie\ + s/StatisticalArea/i\ + tems/properties/Spa\ + tialUnitType" + Code: + type: string + description:A valid value + defined by the + nominated spatial + unit type, defined + by Statistics New + Zealand in one of + the following + statistical area + defintion + standards:
List of Email elements.
+ type: object + required: + - Email + properties: + Email: + type: array + items: + 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: object + required: + - Address + properties: + Type: + type: string + title: Email Type + description: >- +A standardised method of + describing an electronic + mail address used as contact + method by a party. Where a + party has more than one + email address, this may + provide context for deciding + which email address to + use.
The actual email + address.
+ PhoneNumberList: + description:List of PhoneNumber elements.
+ type: object + required: + - PhoneNumber + properties: + PhoneNumber: + type: array + items: + description:This element represents a + phone number and occurs within + objects such as StudentPersonal, + StaffPersonal, etc.
+ type: object + required: + - Number + properties: + Type: + type: string + title: Telephone Number Type + description: >- +A standardised method of + describing a + telecommunications device + used as contact method by a + party. Where a party has + more than one phone number, + this may provide context for + deciding which number to + use.
Phone number. Free-form, + but typical New Zealand + formats include:
Phone number + extension.
+ ListedStatus: + $ref: "#/paths/~1Providers/get/re\ + sponses/200/content/applica\ + tion~1json/schema/propertie\ + s/Providers/properties/Prov\ + ider/items/properties/Conta\ + ctList/properties/Contact/i\ + tems/properties/Name/proper\ + ties/FamilyNameFirst" + EducationRegion: + type: string + title: Education Region + description: >- + Regions of New Zealand defined by Ministry of + Education for administrative purposes.The set of contact email addresses that the + Organisation uses
+ type: object + required: + - Email + properties: + Email: + type: array + items: + 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: object + required: + - Address + properties: + Type: + $ref: "#/paths/~1Providers/get/responses/20\ + 0/content/application~1json/schema/pr\ + operties/Providers/properties/Provide\ + r/items/properties/ContactList/proper\ + ties/Contact/items/properties/EmailLi\ + st/properties/Email/items/properties/\ + Type" + Address: + type: string + description:The actual email address.
+ EntityClose: + type: string + format: date + description:Closing date of entity. Only present for + closed providers.
+ EntityOpen: + type: string + format: date + description:Opening date of entity. For proposed schools + this will be the projected opening date. For + open schools this may not be present.
+ LocationList: + description:A list of one or more locations, from which + the organisation operates or provides a + service.
+ type: object + required: + - Location + properties: + Location: + type: array + items: + description:This element contains data about a + geographical location.
+ type: object + properties: + Description: + type: string + description:A description for the Location.
+ Address: + description:The physical address of the + Location
+ type: object + required: + - Street + properties: + Type: + $ref: "#/paths/~1Providers/get/response\ + s/200/content/application~1json/s\ + chema/properties/Providers/proper\ + ties/Provider/items/properties/Ad\ + dressList/properties/Address/item\ + s/properties/Type" + Role: + $ref: "#/paths/~1Providers/get/response\ + s/200/content/application~1json/s\ + chema/properties/Providers/proper\ + ties/Provider/items/properties/Ad\ + dressList/properties/Address/item\ + s/properties/Role" + Street: + description:The street element is a complex + element and breaks the street down + into several parts. (Allow for PO + Box here)
+ type: object + required: + - Line1 + properties: + Line1: + type: string + description:Address line 1.
+ Line2: + type: string + description:Address line 2.
+ Line3: + type: string + description:Address line 3.
+ Suburb: + type: string + description:The suburb part of urban + addresses, or the 'RD No' part of + rural addresses
+ City: + type: string + description:The city part of the + address.
+ StateProvince: + type: string + description:The state or province code. + StateTerritory Code only + applicable if a non-New Zealand + Address.
+ Country: + type: string + description:The country code.
+ PostalCode: + type: string + description:The ZIP/postal code.
+ GridLocation: + description:The latitude & longitude of the + location. Grid location values are + derived from New Zealand Map Grid + x,y coordinates and converted to + Latitude and Longitude values per + the World Geodetic System 1984 + (G1762)
+ type: object + required: + - Latitude + - Longitude + properties: + Latitude: + description:Latitude in decimal + degrees.
Latitudes + north of the equator are + positive, latitudes south of + the equator are negative [ISO + 6709].
+ Longitude: + description:Longitude in decimal + degrees.
Longitudes + east of the Prime Meridian in + Greenwich are positive, + longitudes west of the Prime + Meridian are negative. The + 180th meridian is negative. + [ISO 6709]
+ StatisticalAreaList: + description:A list of Statistical Areas + containing the location.
+The list may contain exactly + one StatisticalArea element for + each of the following spatial unit + types:
A particular statistical + area defined by Statistics + New Zealand.
+ type: object + required: + - Code + - SpatialUnitType + properties: + SpatialUnitType: + $ref: "#/paths/~1Providers/ge\ + t/responses/200/content\ + /application~1json/sche\ + ma/properties/Providers\ + /properties/Provider/it\ + ems/properties/AddressL\ + ist/properties/Address/\ + items/properties/Statis\ + ticalAreaList/propertie\ + s/StatisticalArea/items\ + /properties/SpatialUnit\ + Type" + Code: + type: string + description:A valid value defined + by the nominated spatial + unit type, defined by + Statistics New Zealand + in one of the following + statistical area + defintion standards:
+The latitude & longitude of the + location. Grid location values are + derived from New Zealand Map Grid x,y + coordinates and converted to Latitude + and Longitude values per the World + Geodetic System 1984 (G1762)
+ type: object + required: + - Latitude + - Longitude + properties: + Latitude: + description:Latitude in decimal + degrees.
Latitudes north + of the equator are positive, + latitudes south of the equator are + negative [ISO 6709].
+ Longitude: + description:Longitude in decimal + degrees.
Longitudes east of + the Prime Meridian in Greenwich + are positive, longitudes west of + the Prime Meridian are negative. + The 180th meridian is negative. + [ISO 6709]
+ StatisticalAreaList: + description:A list of Statistical Areas + containing the location.
The + list may contain exactly one + StatisticalArea element for each of + the following spatial unit types:
+A particular statistical area + defined by Statistics New + Zealand.
+ type: object + required: + - Code + - SpatialUnitType + properties: + SpatialUnitType: + $ref: "#/paths/~1Providers/get/re\ + sponses/200/content/applica\ + tion~1json/schema/propertie\ + s/Providers/properties/Prov\ + ider/items/properties/Addre\ + ssList/properties/Address/i\ + tems/properties/Statistical\ + AreaList/properties/Statist\ + icalArea/items/properties/S\ + patialUnitType" + Code: + type: string + description:A valid value defined by + the nominated spatial unit + type, defined by Statistics + New Zealand in one of the + following statistical area + defintion standards:
+The normal business name of the + Organisation
+ PhoneNumberList: + description:The set of contact phone numbers that the + Organisation uses
+ type: object + required: + - PhoneNumber + properties: + PhoneNumber: + type: array + items: + description:This element represents a phone number + and occurs within objects such as + StudentPersonal, StaffPersonal, etc.
+ type: object + required: + - Number + properties: + Type: + $ref: "#/paths/~1Providers/get/responses/20\ + 0/content/application~1json/schema/pr\ + operties/Providers/properties/Provide\ + r/items/properties/ContactList/proper\ + ties/Contact/items/properties/PhoneNu\ + mberList/properties/PhoneNumber/items\ + /properties/Type" + Number: + type: string + description: "Phone number. Free-form, but + typical New Zealand formats + include:
Phone number extension.
+ ListedStatus: + $ref: "#/paths/~1Providers/get/responses/20\ + 0/content/application~1json/schema/pr\ + operties/Providers/properties/Provide\ + r/items/properties/ContactList/proper\ + ties/Contact/items/properties/Name/pr\ + operties/FamilyNameFirst" + RelatedOrganisationList: + description:A list of other organisations that are + related to the Provider
+ type: object + required: + - RelatedOrganisation + properties: + RelatedOrganisation: + type: array + items: + description:Extends
+ ObjectReferenceType
to add an
+ extra element,
+ OrganisationType
, describing
+ the nature of the related
+ organisation.
The start date of the relationship + between the two organisations
+ EndDate: + type: string + format: date + description:The end date of the relationship + between the two organisations
+ Type: + type: string + title: Organisation Relationship Type + description: >- +A code describing the nature of the + relationship between a pair of + Organisations
Indicates the operational status of an + organisation.
Only present if the Provider is a provider of + school education services. Contains properties + that are school-specific.
+ type: object + properties: + CoEdStatus: + type: string + title: School Co-Ed Status + description: >- +A summary description of the gender of + students that a school accepts, indicating + the type of school from a gender + perspective.
A description of the socio-economic + position of a school's student community + according to the MoE decile rating system. +
+ NewEntrantPolicyList: + description:A list of recognised policy choices + adopted by the School.
+ type: object + required: + - EnactedPolicy + properties: + EnactedPolicy: + type: array + items: + description:A descriptor for a particular + enacted policy that has been adopted + by a school.
+ type: object + required: + - Policy + properties: + EffectiveFrom: + type: string + format: date + description:The date from which the school + adopted the policy. If not + populated then this is the + current/original policy of the + school.
+ EffectiveTo: + type: string + format: date + description:The date after which the school + has no longer adopted the policy. + If not populated then the school + has no planned date to end the + policy.
+ Policy: + type: string + title: Enacted Policy + description: >- +A policy that a school may + choose to implement as part of its + operating rules. For example, + policies may concern student + behaviour, clothing/appearance, + wellbeing and new entrant + enrolment.
A list of School definition descriptors + that further describe the nature of a + school
+ type: object + required: + - Definition + properties: + Definition: + type: array + items: + type: string + title: School Definition + description: >- +A school-specific definition of a + provider, describing the school + according to specialist services or + facilities that it provides for + students or for teaching staff.
+A list of SchoolYear
+ elements describing the genders of students
+ accepted for enrolment at each year
+ level.
A descriptor for a particular Year + Level offered by the school, including + detail of the gender of students that + are accepted for enrolment in this + year level.
+ type: object + required: + - Gender + - YearLevel + properties: + YearLevel: + type: string + title: Year Level Code + description: >- +Year Level defines the values + that are valid for describing + Funding Year Level and Current + Year Level for a student + enrolment.
Current Year + Level indicates the year level of + the student’s class cohort and the + level at which the student spends + most of their time at school. + While a student may be enrolled in + subjects at varying instructional + year levels, in relation to the + student enrolment this value + represents the year level at which + the student is considered to be + predominantly taught.
+Funding Year Level measures the + actual number of years that the + student has attended a school. It + provides the Ministry with a + method of counting students for + funding purposes which is + independent of the way schools are + organised or the particular + programme of study that a student + may undertake. Funding Year Level + for most students is based on the + date they first started + school.
School Year Level + is used to indicate the + instructional year levels offered + by a school, i.e. those years for + which student enrolments may be + accepted.
A description of the gender of + students that the school accepts + at a certain year level or other + instructional grouping.
+ For use at the year level or + course only, rather than school + level. For instance a school may + accept boys only in year 11 but + both girls and boys at years 12 + and 13.
Only present if the Provider is a provider of + early childhood education services. Contains + properties that are ECE specific.
+ type: object + required: + - Type + properties: + Type: + type: string + title: ECEService Type + description: >- +Codes denoting the nature of an Early + Childhood Education service.
Only present if the Provider is a provider of + tertiary education services. Contains properties + that are Tertiary Education specific.
A + placeholder for future expansion
+ x-accessControl: + create: + - 1001 + - 2401 + - 2403 + read: + - 1001 + - 2401 + - 2403 + update: + - 1001 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: [] example: - status: 400 - message: "Invalid Order" - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/Order' - description: order placed for purchasing the pet - required: true - '/store/order/{orderId}': - get: - tags: - - store - summary: Find purchase order by ID - description: >- - For valid response try integer IDs with value <= 5 or > 10. Other values - will generated exceptions - operationId: getOrderById - parameters: - - name: orderId - in: path - description: ID of pet that needs to be fetched - required: true - schema: - type: integer - format: int64 - minimum: 1 - maximum: 5 - responses: - '200': - description: successful operation - content: - application/json: - schema: - $ref: '#/components/schemas/Order' + Providers: + Provider: + - AddressList: + Address: + - Type: RU + Role: PHY + Street: + Line1: 1175 Lake Ferry Rd + Suburb: RD 1 + City: Martinborough + CommunicationChannelList: + Channel: + - Notes: Attendance System (Self Service) + Type: WEB + Value: http://att.hogwarts.school.nz + - Notes: School Website + Type: WEB + Value: http://www.hogwarts.school.nz + ContactList: + Contact: + - Name: + FamilyName: Dumbledore + GivenName: Albus + FullName: Albus Dumbledore + PositionTitle: Headmaster + Role: PRI + AddressList: + Address: + - Type: TH + Role: PHY + Street: + Line1: 533 Hogwart's Way + City: Hogsmead + PostalCode: "7733" + EmailList: {} + PhoneNumberList: {} + - Name: + FamilyName: Hagrid + GivenName: Rubeus + FullName: Rubeus Hagrid + PositionTitle: Gamekeeper + Role: DIR + AddressList: + Address: + - Type: TH + Role: PHY + Street: + Line1: The Enchanted Wood + Line2: 533 Hogwart's Way + City: Hogsmead + PostalCode: "7733" + EmailList: {} + PhoneNumberList: {} + EducationRegion: TAIT + EmailList: + Email: + - Type: PRIM + Address: stuart@gmail.com + EntityOpen: 1652-04-01 + LocationList: + Location: + - Description: Only Campus + Address: + Type: RU + Role: PHY + Street: + Line1: 1175 Lake Ferry Rd + Suburb: RD 1 + City: Martinborough + PostalCode: "5781" + GridLocation: + Latitude: -41.2814719 + Longitude: 175.3458472 + StatisticalAreaList: + StatisticalArea: + - SpatialUnitType: GE + Code: "058" + - SpatialUnitType: TA + Code: "050" + - SpatialUnitType: WA + Code: "05003" + Name: Hogwart's Area School + PhoneNumberList: + PhoneNumber: + - Notes: Attendance Office (Automated) + Usage: SMS + Type: WTE + Number: (0274) 300 9991 + - Notes: Attendance Office + Usage: INT + Type: WTE + Number: (04) 300 9992 + - Notes: School Secretary DDI + Type: WTE + Number: (04) 300 9993 + RelatedOrganisationList: + RelatedOrganisation: + - RefId: 0951bacf-fc88-4ed6-8113-11a6d6335c07 + LocalId: "99102" + Name: Tai Tokerau + ObjectType: Organisation + StartDate: 2012-10-31 + Type: MOE + - RefId: ac0871d9-6562-4209-ae86-abdb3661842b + LocalId: "99204" + Name: Masterton (Whakaoriori) Kāhui Ako + ObjectType: Organisation + StartDate: 2012-04-30 + Type: COL + OperationalStatus: O + Type: 21 + ProviderRefId: D3E34B35-9D75-101A-8C3D-00AA001A1652 + ProviderLocalId: "01011234" + Authority: STATE + SchoolService: + CoEdStatus: COED + Decile: 5 + NewEntrantPolicyList: + EnactedPolicy: + - EffectiveTo: 2018-12-31 + Policy: AE + - EffectiveFrom: 2019-01-01 + Policy: CE + DefinitionList: + Definition: + - SMBS + - KKMA + - SWBF + SchoolYearList: + SchoolYear: + - YearLevel: "1" + Gender: C + - YearLevel: "2" + Gender: C + - YearLevel: "3" + Gender: C + - YearLevel: "4" + Gender: C + - YearLevel: "5" + Gender: C + - YearLevel: "6" + Gender: C + - YearLevel: "7" + Gender: C + - YearLevel: "8" + Gender: C + - YearLevel: "9" + Gender: F + - YearLevel: "10" + Gender: F + - YearLevel: "11" + Gender: F + - YearLevel: "12" + Gender: F + - YearLevel: "13" + Gender: F application/xml: schema: - $ref: '#/components/schemas/Order' - '400': - description: Invalid ID supplied - '404': - description: Order not found - delete: - tags: - - store - summary: Delete purchase order by ID - description: >- - For valid response try integer IDs with value < 1000. Anything above - 1000 or nonintegers will generate API errors - operationId: deleteOrder - parameters: - - name: orderId - in: path - description: ID of the order that needs to be deleted - required: true - schema: - type: string - minimum: 1 - responses: - '400': - description: Invalid ID supplied - '404': - description: Order not found - /user: + type: object + properties: + Providers: + type: object + description: A List of Provider objects + properties: + Provider: + type: array + items: + $ref: "#/paths/~1Providers/get/responses/200/content/appl\ + ication~1json/schema/properties/Providers/propertie\ + s/Provider/items" + example: "$ref: '../examples/Provider.yaml#/getList/xml'" + default: + $ref: "#/paths/~1ScheduleTerms/get/responses/default" + "/Providers/{ProviderRefId}": post: tags: - - user - summary: Create user - description: This can only be done by the logged in user. - operationId: createUser - responses: - default: - description: successful operation - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/User' - description: Created user object - required: true - '/user/{username}': - get: - tags: - - user - summary: Get user by user name - description: '' - operationId: getUserByName + - Provider + summary: Default operation to create a single Provider parameters: - - name: username + - name: ProviderRefId in: path - description: 'The name that needs to be fetched. Use user1 for testing. ' + description:The SIF GUID used by systems to identify the organisation.
required: true schema: type: string + operationId: createProvider + requestBody: + description: CRUD operation on Provider + content: + application/json: + schema: + type: object + properties: + Provider: + $ref: "#/paths/~1Providers/get/responses/200/content/application~\ + 1json/schema/properties/Providers/properties/Provider/items" + example: + Provider: + AddressList: + Address: + - Type: RU + Role: PHY + Street: + Line1: 1175 Lake Ferry Rd + Suburb: RD 1 + City: Martinborough + CommunicationChannelList: + Channel: + - Notes: Attendance System (Self Service) + Type: WEB + Value: http://att.hogwarts.school.nz + - Notes: School Website + Type: WEB + Value: http://www.hogwarts.school.nz + ContactList: + Contact: + - Name: + FamilyName: Dumbledore + GivenName: Albus + FullName: Albus Dumbledore + PositionTitle: Headmaster + Role: PRI + AddressList: + Address: + - Type: TH + Role: PHY + Street: + Line1: 533 Hogwart's Way + City: Hogsmead + PostalCode: "7733" + EmailList: {} + PhoneNumberList: {} + - Name: + FamilyName: Hagrid + GivenName: Rubeus + FullName: Rubeus Hagrid + PositionTitle: Gamekeeper + Role: DIR + AddressList: + Address: + - Type: TH + Role: PHY + Street: + Line1: The Enchanted Wood + Line2: 533 Hogwart's Way + City: Hogsmead + PostalCode: "7733" + EmailList: {} + PhoneNumberList: {} + EducationRegion: TAIT + EmailList: + Email: + - Type: PRIM + Address: stuart@gmail.com + EntityOpen: 1652-04-01 + LocationList: + Location: + - Description: Only Campus + Address: + Type: RU + Role: PHY + Street: + Line1: 1175 Lake Ferry Rd + Suburb: RD 1 + City: Martinborough + PostalCode: "5781" + GridLocation: + Latitude: -41.2814719 + Longitude: 175.3458472 + StatisticalAreaList: + StatisticalArea: + - SpatialUnitType: GE + Code: "058" + - SpatialUnitType: TA + Code: "050" + - SpatialUnitType: WA + Code: "05003" + Name: Hogwart's Area School + PhoneNumberList: + PhoneNumber: + - Notes: Attendance Office (Automated) + Usage: SMS + Type: WTE + Number: (0274) 300 9991 + - Notes: Attendance Office + Usage: INT + Type: WTE + Number: (04) 300 9992 + - Notes: School Secretary DDI + Type: WTE + Number: (04) 300 9993 + RelatedOrganisationList: + RelatedOrganisation: + - RefId: 0951bacf-fc88-4ed6-8113-11a6d6335c07 + LocalId: "99102" + Name: Tai Tokerau + ObjectType: Organisation + StartDate: 2012-10-31 + Type: MOE + - RefId: ac0871d9-6562-4209-ae86-abdb3661842b + LocalId: "99204" + Name: Masterton (Whakaoriori) Kāhui Ako + ObjectType: Organisation + StartDate: 2012-04-30 + Type: COL + OperationalStatus: O + Type: 21 + ProviderRefId: D3E34B35-9D75-101A-8C3D-00AA001A1652 + ProviderLocalId: "01011234" + Authority: STATE + SchoolService: + CoEdStatus: COED + Decile: 5 + NewEntrantPolicyList: + EnactedPolicy: + - EffectiveTo: 2018-12-31 + Policy: AE + - EffectiveFrom: 2019-01-01 + Policy: CE + DefinitionList: + Definition: + - SMBS + - KKMA + - SWBF + SchoolYearList: + SchoolYear: + - YearLevel: "1" + Gender: C + - YearLevel: "2" + Gender: C + - YearLevel: "3" + Gender: C + - YearLevel: "4" + Gender: C + - YearLevel: "5" + Gender: C + - YearLevel: "6" + Gender: C + - YearLevel: "7" + Gender: C + - YearLevel: "8" + Gender: C + - YearLevel: "9" + Gender: F + - YearLevel: "10" + Gender: F + - YearLevel: "11" + Gender: F + - YearLevel: "12" + Gender: F + - YearLevel: "13" + Gender: F + application/xml: + schema: + type: object + properties: + Provider: + $ref: "#/paths/~1Providers/get/responses/200/content/application~\ + 1json/schema/properties/Providers/properties/Provider/items" + example: "$ref: '../examples/Provider.yaml#/post/xml'" responses: - '200': - description: successful operation - content: - application/json: - schema: - $ref: '#/components/schemas/User' - application/xml: - schema: - $ref: '#/components/schemas/User' - '400': - description: Invalid username supplied - '404': - description: User not found + "200": + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/post/responses/200" + default: + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/post/responses/de\ + fault" put: tags: - - user - summary: Updated user - description: This can only be done by the logged in user. - operationId: updateUser + - Provider + summary: Default operation to update a single Provider parameters: - - name: username + - name: ProviderRefId in: path - description: name that need to be deleted + description:The SIF GUID used by systems to identify the organisation.
required: true schema: type: string - responses: - '400': - description: Invalid user supplied - '404': - description: User not found + operationId: updateProvider requestBody: + description: CRUD operation on Provider content: application/json: schema: - $ref: '#/components/schemas/User' - description: Updated user object - required: true - delete: - tags: - - user - summary: Delete user - description: This can only be done by the logged in user. - operationId: deleteUser - parameters: - - name: username - in: path - description: The name that needs to be deleted - required: true - schema: - type: string - responses: - '400': - description: Invalid username supplied - '404': - description: User not found - /user/createWithArray: - post: - tags: - - user - summary: Creates list of users with given input array - description: '' - operationId: createUsersWithArrayInput + type: object + properties: + Provider: + type: object + description: A recognised provider of education services in the New + Zealand education system. Providers may operate in the Early + Childhood, Compulsory Schooling or Tertiary sectors. + properties: + MinistryOfEducationId: + description:This is a common element used to define the locally + assigned identifier associated with an entity.
+ type: string + AddressList: + description:The set of postal and other addresses that the + Organisation uses
+ type: object + properties: + Address: + type: array + items: + description:This element contains address data.
+ type: object + properties: + Type: + type: string + title: Address Type + description: >- +Address type allows an address to be + categorised according to its component + structure. Address type can be used to build + processing rules for validating, managing and + presenting addresses. Address type is + independent of the use of the address by any + party. To describe how a party may use an + address (residence, billing, term address etc) + see AddressRoleType
Also called 'Street' addresses, The + most general, and widely used type of + address, and can contain the widest + variety of components
In general a + thoroughfare address will include + components for a number, a roadname, and a + locality.
They cannot contain any + of the components specific to a delivery + service, rural post delivery, or water + address.
These addresses are used + to find a location.
Example: 30 - + 40 Lambton Quay, Wellington, 6165
\"" + enum: + - TH + - title: Rural Post Delivery + description: '"Defined by New Zealand Post, these + addresses are assigned by NZ Post for + customers who purchase a rural delivery + service (mail and also other goods).
+They will have the same number and + roadname components as the street address, + and may have the same region + component.
They do not have a + component that identifies the locality the + address is within. The locality and city + or town components are replaced by + components that identify the rural + delivery route (RD number), and the town + from which the rural delivery route starts + and finishes (the mail town). Only + addresses of this class can contain these + components.
Example: 121 + Waitaha Road, RD 1, Ross, 7885
"' + enum: + - RU + - title: Delivery Service + description: '"Defined by New Zealand Post, and used + exclusively for NZ Post services other + than standard mail delivery. Addresses in + this class include PO Box, Private Bag, + and Counter Delivery addresses.
+ Example: Private Bag 2345, + Auckland, 1142
"' + enum: + - DE + - title: Water + description: '"Where properties have no road access, + but do have access to water frontage + (coastline or riverbank or lakefront), a + water address uses the name of a water + feature (for example, islands, rivers, + bays, or peninsulas).
+ Example: 235 Lochmara Bay, Queen + Charlotte Sound, Marlborough Sounds
"' + enum: + - WA + - title: Foreign Address + description: '"A foreign address identifies a + location outside of New Zealand.
+ Example: Rudolf-Diesel-Strasse + 14, 54595 Prüm, Germany
"' + enum: + - FO + Role: + type: string + title: Address Role + description: >- +A standardised description of the role or + usage of an address by a party (person or + organisation). Where a party has more than one + address, this provides context for deciding + which address to use.
The street element is a complex element and + breaks the street down into several parts. + (Allow for PO Box here)
+ type: object + properties: + Line1: + type: string + description:Address line 1.
+ Line2: + type: string + description:Address line 2.
+ Line3: + type: string + description:Address line 3.
+ Suburb: + type: string + description:The suburb part of urban addresses, or the + 'RD No' part of rural addresses
+ City: + type: string + description:The city part of the address.
+ StateProvince: + type: string + description:The state or province code. StateTerritory + Code only applicable if a non-New Zealand + Address.
+ Country: + type: string + description:The country code.
+ PostalCode: + type: string + description:The ZIP/postal code.
+ GridLocation: + description:The latitude & longitude of the location. + Grid location values are derived from New + Zealand Map Grid x,y coordinates and converted + to Latitude and Longitude values per the World + Geodetic System 1984 (G1762)
+ type: object + properties: + Latitude: + description:Latitude in decimal degrees.
+ Latitudes north of the equator are + positive, latitudes south of the equator + are negative [ISO 6709].
+ Longitude: + description:Longitude in decimal degrees.
+Longitudes east of the Prime Meridian + in Greenwich are positive, longitudes west + of the Prime Meridian are negative. The + 180th meridian is negative. [ISO 6709]
+ StatisticalAreaList: + description:A list of Statistical Areas containing the + location.
The list may contain exactly + one StatisticalArea element for each of the + following spatial unit types:
A particular statistical area defined + by Statistics New Zealand.
+ type: object + properties: + SpatialUnitType: + type: string + title: Spatial Unit Type + description: >- +A classification of geographical + boundaries or statistical areas as + defined by Statistics NZ’s + geographic hierarchy.
Area units are aggregations + of meshblocks. They are + non–administrative areas that + are in between meshblocks and + territorial authorities in size. + Area units must either define or + aggregate to define, regional + councils, territorial + authorities and urban areas.
+ Statistics NZ Classification of + Area Unit 2013 v1.0.0 + enum: + - AE + - title: General Electoral District + description:The general electoral + districts as constituted under + the Electoral Act 1993.
+ Statistics NZ General Electoral + District 2014 v1.0.0 + enum: + - GE + - title: Community Board + description:(aka Local Board within + Auckland) Local boards provide + governance at the local level + within Auckland Council. They + enable democratic decision + making by, and on behalf of + communities within the local + board area.
Statistics NZ + Community Board 2013 v1.0.0 + enum: + - CB + - title: Māori Electoral District + description:Māori electoral districts are + the voting districts for + parliamentary elections for + people who choose to be on the + Māori Electoral Roll.
+ Statistics NZ Māori Electoral + District 2014 v1.0.0 + enum: + - ME + - title: Mesh Block + description:A meshblock is the smallest + geographic unit for which + statistical data is collected + and processed by Statistics New + Zealand.
A meshblock is + defined by a geographic area, + which can vary in size from part + of a city block to a large area + of rural land. Each meshblock + borders on another to form a + network covering all of New + Zealand, including coasts and + inlets and extending out to the + 200-mile economic zone.
+ Statistics NZ Statistical + Standard for Meshblock 2013 + v1.0.0 + enum: + - MB + - title: Regional Council + description:The top tier of local + government in New Zealand, + defined by the Local Government + Act 2002, which requires the + boundaries of regions to conform + as far as possible to one or + more water catchments. When + determining regional boundaries, + the Local Government Commission + gave consideration to regional + communities of interest when + selecting water catchments to be + included in a region. It also + considered factors such as + natural resource management, + land use planning and + environmental matters.
+ Statistics NZ Regional Council + 2013 v1.0.0 + enum: + - RC + - title: Territorial Authority + description:The second tier of local + government in New Zealand, + defined under the Local + Government Act 2002 as a city + council or district council. + There are 67 territorial + authorities consisting of 12 + city councils, 53 districts, + Auckland Council, and Chatham + Islands Council.
Statistics + NZ Territorial Authority 2013 + v1.0.0 + enum: + - TA + - title: Urban Area + description: '"Urban Areas are + statistically defined areas with + no administrative or legal + basis. There is a three part + hierarchical sub-division of + urban areas into: main urban + areas, secondary urban areas, + minor urban areas. Together the + populations in main, secondary + and minor urban areas comprise + the statistically defined urban + population of New Zealand. The + urban area classification is + designed to identify + concentrated urban or semi-urban + settlements without the + distortions of administrative + boundaries.
Statistics NZ + Urban Area 2013 v2.0.0"' + enum: + - UA + - title: Ward + description:Wards are defined under the + Local Electoral Act 2001 and + result from the division, for + electoral purposes, of the + district of a territorial + authority. The ward system was + designed to allow for the + recognition of communities + within a district and to + increase community involvement + in the local government + system.
Statistics NZ Ward + 2013 v1.0.0 + enum: + - WA + Code: + type: string + description:A valid value defined by the + nominated spatial unit type, defined + by Statistics New Zealand in one of + the following statistical area + defintion standards:
A list of one or more methods of communication with + the organisation
+ type: object + properties: + Channel: + type: array + items: + description:A particular person or organisation's + communications method
+ type: object + properties: + Type: + type: string + title: Communication Channel Type + description: >- +A standardised method of describing a + communication channel used to communicate with + or find information about a party. Provides a + more generic definition than phone and email. + Intended to provide for future requirements to + record social network channels, eg Facebook + & Twitter identifiers for a school.
+The unique value that provides access to + the channel. eg: URL for a website; Facebook + page addess, Twitter handle.
" + ContactList: + description:A list of one or more cotact persons related to the + organisation
+ type: object + properties: + Contact: + type: array + items: + description:A particular person's contact details
+ type: object + properties: + Name: + description:The contact's name
+ type: object + properties: + Title: + type: string + description:A title or prefix associated with the + name.
+ FamilyName: + type: string + description:Also known as Last Name, although some + cultures may not present a family name as + the last name.
+ GivenName: + type: string + description:Also known as First Name, although some + cultures may not present this name as the + first element in a name. May contain a + composite of all given names.
+ MiddleName: + type: string + description:Where more than one Given Name, these + may be combined in one composite field or + else populated in several elements.
+ FamilyNameFirst: + type: string + title: Yes Or No Category + description: >- +A reusable code set for yes, no, + unknown and not provided values.
A preferred version of the Family Name. + Note:A name cannot have both a Preferred + Family and Preferred Given Name within the + same Name structure – only one of these + fields should be populated. If a person + does have both a Preferred Family and + Preferred Given Name then this must be + populated as a separate Name of type + ‘Preferred’.
+ PreferredFamilyNameFirst: + $ref: "#/paths/~1Providers~1%7BProviderRefId%7D\ + /put/requestBody/content/application~1jso\ + n/schema/properties/Provider/properties/C\ + ontactList/properties/Contact/items/prope\ + rties/Name/properties/FamilyNameFirst" + PreferredGivenName: + type: string + description: "A preferred version of the Given Name. + Note: A name cannot have both a Preferred + Family and Preferred Given Name within the + same Name structure – only one of these + fields should be populated. If a person + does have both a Preferred Family and + Preferred Given Name then this must be + populated as a separate Name of type + ‘Preferred’.
" + Suffix: + type: string + description:Textual suffix like PHD, JP, BSc.
+ FullName: + type: string + description:A combination of all name elements as + one composite text element
+ Type: + type: string + title: Name Usage Type + description: >- +A standardised method of describing the + usage of a name by a person. Where a + person has more than one current name, the + usage type indicates which name may be + used according to the purpose.
Code + values are based on SIF Australia 3.4.
+The name by which an individual + prefers to be known and addressed.
+Only usage type applicable for + student name usage (other types are + not supported by NSI).
+ enum: + - PRF + - title: Foreign Official Name + description:Included for future usage in NZ, + especially for tertiary students.
+ enum: + - FON + - title: Previous name + enum: + - PRV + - title: Also Known As + description: AKA or Alias + enum: + - AKA + - title: Name at Birth + enum: + - BTH + - title: Legal Name + description:Legal Name or Official Name as + defined by the organisation which + collects it (legal name is not defined + in this standard)
+ enum: + - LGL + IsVerified: + $ref: "#/paths/~1Providers~1%7BProviderRefId%7D\ + /put/requestBody/content/application~1jso\ + n/schema/properties/Provider/properties/C\ + ontactList/properties/Contact/items/prope\ + rties/Name/properties/FamilyNameFirst" + PositionTitle: + type: string + description:The title the contact has within the + Organisation being contacted
+ Role: + type: string + title: Organisation Contact Role + description: >- +The role played by a person in an + organisation where that person is recorded as + a contact. The role definition is used to + recognise similar functions across + organisations, however individuals with the + same role may be given different position + titles that differ from the generic role + description. For example, a principal may have + a title of ‘headmaster’.
A list of Address elements.
+ type: object + properties: + Address: + type: array + items: + description:This element contains address + data.
+ type: object + properties: + Type: + $ref: "#/paths/~1Providers~1%7BProviderRe\ + fId%7D/put/requestBody/content/appl\ + ication~1json/schema/properties/Pro\ + vider/properties/AddressList/proper\ + ties/Address/items/properties/Type" + Role: + $ref: "#/paths/~1Providers~1%7BProviderRe\ + fId%7D/put/requestBody/content/appl\ + ication~1json/schema/properties/Pro\ + vider/properties/AddressList/proper\ + ties/Address/items/properties/Role" + Street: + description:The street element is a complex + element and breaks the street down + into several parts. (Allow for PO + Box here)
+ type: object + properties: + Line1: + type: string + description:Address line 1.
+ Line2: + type: string + description:Address line 2.
+ Line3: + type: string + description:Address line 3.
+ Suburb: + type: string + description:The suburb part of urban + addresses, or the 'RD No' part of + rural addresses
+ City: + type: string + description:The city part of the address.
+ StateProvince: + type: string + description:The state or province code. + StateTerritory Code only applicable + if a non-New Zealand Address.
+ Country: + type: string + description:The country code.
+ PostalCode: + type: string + description:The ZIP/postal code.
+ GridLocation: + description:The latitude & longitude of the + location. Grid location values are + derived from New Zealand Map Grid + x,y coordinates and converted to + Latitude and Longitude values per + the World Geodetic System 1984 + (G1762)
+ type: object + properties: + Latitude: + description:Latitude in decimal + degrees.
Latitudes north + of the equator are positive, + latitudes south of the equator + are negative [ISO 6709].
+ Longitude: + description:Longitude in decimal + degrees.
Longitudes east + of the Prime Meridian in + Greenwich are positive, + longitudes west of the Prime + Meridian are negative. The 180th + meridian is negative. [ISO + 6709]
+ StatisticalAreaList: + description:A list of Statistical Areas + containing the location.
The + list may contain exactly one + StatisticalArea element for each of + the following spatial unit + types:
A particular statistical + area defined by Statistics New + Zealand.
+ type: object + properties: + SpatialUnitType: + $ref: "#/paths/~1Providers~1%7B\ + ProviderRefId%7D/put/requ\ + estBody/content/applicati\ + on~1json/schema/propertie\ + s/Provider/properties/Add\ + ressList/properties/Addre\ + ss/items/properties/Stati\ + sticalAreaList/properties\ + /StatisticalArea/items/pr\ + operties/SpatialUnitType" + Code: + type: string + description:A valid value defined + by the nominated spatial + unit type, defined by + Statistics New Zealand in + one of the following + statistical area defintion + standards:
List of Email elements.
+ type: object + properties: + Email: + type: array + items: + 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: object + properties: + Type: + type: string + title: Email Type + description: >- +A standardised method of + describing an electronic mail + address used as contact method by a + party. Where a party has more than + one email address, this may provide + context for deciding which email + address to use.
The actual email address.
+ PhoneNumberList: + description:List of PhoneNumber elements.
+ type: object + properties: + PhoneNumber: + type: array + items: + description:This element represents a phone + number and occurs within objects such as + StudentPersonal, StaffPersonal, etc.
+ type: object + properties: + Type: + type: string + title: Telephone Number Type + description: >- +A standardised method of + describing a telecommunications + device used as contact method by a + party. Where a party has more than + one phone number, this may provide + context for deciding which number to + use.
Phone number. Free-form, but + typical New Zealand formats + include:
Phone number extension.
+ ListedStatus: + $ref: "#/paths/~1Providers~1%7BProviderRe\ + fId%7D/put/requestBody/content/appl\ + ication~1json/schema/properties/Pro\ + vider/properties/ContactList/proper\ + ties/Contact/items/properties/Name/\ + properties/FamilyNameFirst" + EducationRegion: + type: string + title: Education Region + description: >- + Regions of New Zealand defined by Ministry of Education + for administrative purposes.The set of contact email addresses that the + Organisation uses
+ type: object + properties: + Email: + type: array + items: + 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: object + properties: + Type: + $ref: "#/paths/~1Providers~1%7BProviderRefId%7D/put\ + /requestBody/content/application~1json/schema\ + /properties/Provider/properties/ContactList/p\ + roperties/Contact/items/properties/EmailList/\ + properties/Email/items/properties/Type" + Address: + type: string + description:The actual email address.
+ EntityClose: + type: string + format: date + description:Closing date of entity. Only present for closed + providers.
+ EntityOpen: + type: string + format: date + description:Opening date of entity. For proposed schools this + will be the projected opening date. For open schools + this may not be present.
+ LocationList: + description:A list of one or more locations, from which the + organisation operates or provides a service.
+ type: object + properties: + Location: + type: array + items: + description:This element contains data about a geographical + location.
+ type: object + properties: + Description: + type: string + description:A description for the Location.
+ Address: + description:The physical address of the Location
+ type: object + properties: + Type: + $ref: "#/paths/~1Providers~1%7BProviderRefId%7D\ + /put/requestBody/content/application~1jso\ + n/schema/properties/Provider/properties/A\ + ddressList/properties/Address/items/prope\ + rties/Type" + Role: + $ref: "#/paths/~1Providers~1%7BProviderRefId%7D\ + /put/requestBody/content/application~1jso\ + n/schema/properties/Provider/properties/A\ + ddressList/properties/Address/items/prope\ + rties/Role" + Street: + description:The street element is a complex element + and breaks the street down into several + parts. (Allow for PO Box here)
+ type: object + properties: + Line1: + type: string + description:Address line 1.
+ Line2: + type: string + description:Address line 2.
+ Line3: + type: string + description:Address line 3.
+ Suburb: + type: string + description:The suburb part of urban addresses, or + the 'RD No' part of rural addresses
+ City: + type: string + description:The city part of the address.
+ StateProvince: + type: string + description:The state or province code. + StateTerritory Code only applicable if a + non-New Zealand Address.
+ Country: + type: string + description:The country code.
+ PostalCode: + type: string + description:The ZIP/postal code.
+ GridLocation: + description:The latitude & longitude of the + location. Grid location values are derived + from New Zealand Map Grid x,y coordinates + and converted to Latitude and Longitude + values per the World Geodetic System 1984 + (G1762)
+ type: object + properties: + Latitude: + description:Latitude in decimal degrees.
+Latitudes north of the equator are + positive, latitudes south of the + equator are negative [ISO 6709].
+ Longitude: + description:Longitude in decimal degrees.
+Longitudes east of the Prime + Meridian in Greenwich are positive, + longitudes west of the Prime Meridian + are negative. The 180th meridian is + negative. [ISO 6709]
+ StatisticalAreaList: + description:A list of Statistical Areas containing + the location.
The list may contain + exactly one StatisticalArea element for + each of the following spatial unit + types:
A particular statistical area + defined by Statistics New + Zealand.
+ type: object + properties: + SpatialUnitType: + $ref: "#/paths/~1Providers~1%7BProvid\ + erRefId%7D/put/requestBody/cont\ + ent/application~1json/schema/pr\ + operties/Provider/properties/Ad\ + dressList/properties/Address/it\ + ems/properties/StatisticalAreaL\ + ist/properties/StatisticalArea/\ + items/properties/SpatialUnitTyp\ + e" + Code: + type: string + description:A valid value defined by the + nominated spatial unit type, + defined by Statistics New + Zealand in one of the following + statistical area defintion + standards:
The latitude & longitude of the location. + Grid location values are derived from New + Zealand Map Grid x,y coordinates and converted + to Latitude and Longitude values per the World + Geodetic System 1984 (G1762)
+ type: object + properties: + Latitude: + description:Latitude in decimal degrees.
+ Latitudes north of the equator are + positive, latitudes south of the equator + are negative [ISO 6709].
+ Longitude: + description:Longitude in decimal degrees.
+Longitudes east of the Prime Meridian + in Greenwich are positive, longitudes west + of the Prime Meridian are negative. The + 180th meridian is negative. [ISO 6709]
+ StatisticalAreaList: + description:A list of Statistical Areas containing the + location.
The list may contain exactly + one StatisticalArea element for each of the + following spatial unit types:
A particular statistical area defined + by Statistics New Zealand.
+ type: object + properties: + SpatialUnitType: + $ref: "#/paths/~1Providers~1%7BProviderRe\ + fId%7D/put/requestBody/content/appl\ + ication~1json/schema/properties/Pro\ + vider/properties/AddressList/proper\ + ties/Address/items/properties/Stati\ + sticalAreaList/properties/Statistic\ + alArea/items/properties/SpatialUnit\ + Type" + Code: + type: string + description:A valid value defined by the + nominated spatial unit type, defined + by Statistics New Zealand in one of + the following statistical area + defintion standards:
The normal business name of the Organisation
+ PhoneNumberList: + description:The set of contact phone numbers that the + Organisation uses
+ type: object + properties: + PhoneNumber: + type: array + items: + description:This element represents a phone number and + occurs within objects such as StudentPersonal, + StaffPersonal, etc.
+ type: object + properties: + Type: + $ref: "#/paths/~1Providers~1%7BProviderRefId%7D/put\ + /requestBody/content/application~1json/schema\ + /properties/Provider/properties/ContactList/p\ + roperties/Contact/items/properties/PhoneNumbe\ + rList/properties/PhoneNumber/items/properties\ + /Type" + Number: + type: string + description: "Phone number. Free-form, but typical New + Zealand formats include:
Phone number extension.
+ ListedStatus: + $ref: "#/paths/~1Providers~1%7BProviderRefId%7D/put\ + /requestBody/content/application~1json/schema\ + /properties/Provider/properties/ContactList/p\ + roperties/Contact/items/properties/Name/prope\ + rties/FamilyNameFirst" + RelatedOrganisationList: + description:A list of other organisations that are related to the + Provider
+ type: object + properties: + RelatedOrganisation: + type: array + items: + description:Extends ObjectReferenceType
to add
+ an extra element, OrganisationType
,
+ describing the nature of the related
+ organisation.
The start date of the relationship between + the two organisations
+ EndDate: + type: string + format: date + description:The end date of the relationship between + the two organisations
+ Type: + type: string + title: Organisation Relationship Type + description: >- +A code describing the nature of the + relationship between a pair of + Organisations
Indicates the operational status of an + organisation.
Only present if the Provider is a provider of school + education services. Contains properties that are + school-specific.
+ type: object + properties: + CoEdStatus: + type: string + title: School Co-Ed Status + description: >- +A summary description of the gender of students + that a school accepts, indicating the type of school + from a gender perspective.
A description of the socio-economic position of a + school's student community according to the MoE + decile rating system.
+ NewEntrantPolicyList: + description:A list of recognised policy choices adopted by + the School.
+ type: object + properties: + EnactedPolicy: + type: array + items: + description:A descriptor for a particular enacted + policy that has been adopted by a school.
+ type: object + properties: + EffectiveFrom: + type: string + format: date + description:The date from which the school adopted + the policy. If not populated then this is + the current/original policy of the + school.
+ EffectiveTo: + type: string + format: date + description:The date after which the school has no + longer adopted the policy. If not + populated then the school has no planned + date to end the policy.
+ Policy: + type: string + title: Enacted Policy + description: >- +A policy that a school may choose to + implement as part of its operating rules. + For example, policies may concern student + behaviour, clothing/appearance, wellbeing + and new entrant enrolment.
A list of School definition descriptors that + further describe the nature of a school
+ type: object + properties: + Definition: + type: array + items: + type: string + title: School Definition + description: >- +A school-specific definition of a provider, + describing the school according to specialist + services or facilities that it provides for + students or for teaching staff.
A list of SchoolYear
elements
+ describing the genders of students accepted for
+ enrolment at each year level.
A descriptor for a particular Year Level + offered by the school, including detail of the + gender of students that are accepted for + enrolment in this year level.
+ type: object + properties: + YearLevel: + type: string + title: Year Level Code + description: >- +Year Level defines the values that are + valid for describing Funding Year Level + and Current Year Level for a student + enrolment.
Current Year Level + indicates the year level of the student’s + class cohort and the level at which the + student spends most of their time at + school. While a student may be enrolled in + subjects at varying instructional year + levels, in relation to the student + enrolment this value represents the year + level at which the student is considered + to be predominantly taught.
Funding + Year Level measures the actual number of + years that the student has attended a + school. It provides the Ministry with a + method of counting students for funding + purposes which is independent of the way + schools are organised or the particular + programme of study that a student may + undertake. Funding Year Level for most + students is based on the date they first + started school.
School Year Level + is used to indicate the instructional year + levels offered by a school, i.e. those + years for which student enrolments may be + accepted.
A description of the gender of students + that the school accepts at a certain year + level or other instructional grouping.
+For use at the year level or course + only, rather than school level. For + instance a school may accept boys only in + year 11 but both girls and boys at years + 12 and 13.
Only present if the Provider is a provider of early + childhood education services. Contains properties that + are ECE specific.
+ type: object + properties: + Type: + type: string + title: ECEService Type + description: >- +Codes denoting the nature of an Early Childhood + Education service.
Only present if the Provider is a provider of + tertiary education services. Contains properties that + are Tertiary Education specific.
A placeholder + for future expansion
+ x-accessControl: + create: + - 1001 + - 2401 + - 2403 + read: + - 1001 + - 2401 + - 2403 + update: + - 1001 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: [] + example: + Provider: + AddressList: + Address: + - Type: RU + Role: PHY + Street: + Line1: 1175 Lake Ferry Rd + Suburb: RD 1 + City: Martinborough + CommunicationChannelList: + Channel: + - Notes: Attendance System (Self Service) + Type: WEB + Value: http://att.hogwarts.school.nz + - Notes: School Website + Type: WEB + Value: http://www.hogwarts.school.nz + ContactList: + Contact: + - Name: + FamilyName: Dumbledore + GivenName: Albus + FullName: Albus Dumbledore + PositionTitle: Headmaster + Role: PRI + AddressList: + Address: + - Type: TH + Role: PHY + Street: + Line1: 533 Hogwart's Way + City: Hogsmead + PostalCode: "7733" + EmailList: {} + PhoneNumberList: {} + - Name: + FamilyName: Hagrid + GivenName: Rubeus + FullName: Rubeus Hagrid + PositionTitle: Gamekeeper + Role: DIR + AddressList: + Address: + - Type: TH + Role: PHY + Street: + Line1: The Enchanted Wood + Line2: 533 Hogwart's Way + City: Hogsmead + PostalCode: "7733" + EmailList: {} + PhoneNumberList: {} + EducationRegion: TAIT + EmailList: + Email: + - Type: PRIM + Address: stuart@gmail.com + EntityOpen: 1652-04-01 + LocationList: + Location: + - Description: Only Campus + Address: + Type: RU + Role: PHY + Street: + Line1: 1175 Lake Ferry Rd + Suburb: RD 1 + City: Martinborough + PostalCode: "5781" + GridLocation: + Latitude: -41.2814719 + Longitude: 175.3458472 + StatisticalAreaList: + StatisticalArea: + - SpatialUnitType: GE + Code: "058" + - SpatialUnitType: TA + Code: "050" + - SpatialUnitType: WA + Code: "05003" + Name: Hogwart's Area School + PhoneNumberList: + PhoneNumber: + - Notes: Attendance Office (Automated) + Usage: SMS + Type: WTE + Number: (0274) 300 9991 + - Notes: Attendance Office + Usage: INT + Type: WTE + Number: (04) 300 9992 + - Notes: School Secretary DDI + Type: WTE + Number: (04) 300 9993 + RelatedOrganisationList: + RelatedOrganisation: + - RefId: 0951bacf-fc88-4ed6-8113-11a6d6335c07 + LocalId: "99102" + Name: Tai Tokerau + ObjectType: Organisation + StartDate: 2012-10-31 + Type: MOE + - RefId: ac0871d9-6562-4209-ae86-abdb3661842b + LocalId: "99204" + Name: Masterton (Whakaoriori) Kāhui Ako + ObjectType: Organisation + StartDate: 2012-04-30 + Type: COL + OperationalStatus: O + Type: 21 + ProviderRefId: D3E34B35-9D75-101A-8C3D-00AA001A1652 + ProviderLocalId: "01011234" + Authority: STATE + SchoolService: + CoEdStatus: COED + Decile: 5 + NewEntrantPolicyList: + EnactedPolicy: + - EffectiveTo: 2018-12-31 + Policy: AE + - EffectiveFrom: 2019-01-01 + Policy: CE + DefinitionList: + Definition: + - SMBS + - KKMA + - SWBF + SchoolYearList: + SchoolYear: + - YearLevel: "1" + Gender: C + - YearLevel: "2" + Gender: C + - YearLevel: "3" + Gender: C + - YearLevel: "4" + Gender: C + - YearLevel: "5" + Gender: C + - YearLevel: "6" + Gender: C + - YearLevel: "7" + Gender: C + - YearLevel: "8" + Gender: C + - YearLevel: "9" + Gender: F + - YearLevel: "10" + Gender: F + - YearLevel: "11" + Gender: F + - YearLevel: "12" + Gender: F + - YearLevel: "13" + Gender: F + application/xml: + schema: + type: object + properties: + Provider: + $ref: "#/paths/~1Providers~1%7BProviderRefId%7D/put/requestBody/c\ + ontent/application~1json/schema/properties/Provider" + example: "$ref: '../examples/Provider.yaml#/put/xml'" responses: + "200": + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/put/responses/200" default: - description: successful operation - requestBody: - $ref: '#/components/requestBodies/UserArray' - /user/createWithList: - post: - tags: - - user - summary: Creates list of users with given input array - description: '' - operationId: createUsersWithListInput - responses: - default: - description: successful operation - requestBody: - $ref: '#/components/requestBodies/UserArray' - /user/login: + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/put/responses/def\ + ault" get: tags: - - user - summary: Logs user into the system - description: '' - operationId: loginUser + - Provider + summary: Default operation to get a single Provider parameters: - - name: username - in: query - description: The user name for login - required: true - schema: - type: string - - name: password - in: query - description: The password for login in clear text + - name: ProviderRefId + in: path + description:The SIF GUID used by systems to identify the organisation.
required: true schema: type: string responses: - '200': + "200": description: successful operation - headers: - X-Rate-Limit: - description: calls per hour allowed by the user - schema: - type: integer - format: int32 - X-Expires-After: - description: date in UTC when toekn expires - schema: - type: string - format: date-time content: application/json: schema: - type: string - examples: - response: - value: OK + type: object + properties: + Provider: + $ref: "#/paths/~1Providers/get/responses/200/content/applicatio\ + n~1json/schema/properties/Providers/properties/Provider/i\ + tems" + example: + Provider: + AddressList: + Address: + - Type: RU + Role: PHY + Street: + Line1: 1175 Lake Ferry Rd + Suburb: RD 1 + City: Martinborough + CommunicationChannelList: + Channel: + - Notes: Attendance System (Self Service) + Type: WEB + Value: http://att.hogwarts.school.nz + - Notes: School Website + Type: WEB + Value: http://www.hogwarts.school.nz + ContactList: + Contact: + - Name: + FamilyName: Dumbledore + GivenName: Albus + FullName: Albus Dumbledore + PositionTitle: Headmaster + Role: PRI + AddressList: + Address: + - Type: TH + Role: PHY + Street: + Line1: 533 Hogwart's Way + City: Hogsmead + PostalCode: "7733" + EmailList: {} + PhoneNumberList: {} + - Name: + FamilyName: Hagrid + GivenName: Rubeus + FullName: Rubeus Hagrid + PositionTitle: Gamekeeper + Role: DIR + AddressList: + Address: + - Type: TH + Role: PHY + Street: + Line1: The Enchanted Wood + Line2: 533 Hogwart's Way + City: Hogsmead + PostalCode: "7733" + EmailList: {} + PhoneNumberList: {} + EducationRegion: TAIT + EmailList: + Email: + - Type: PRIM + Address: stuart@gmail.com + EntityOpen: 1652-04-01 + LocationList: + Location: + - Description: Only Campus + Address: + Type: RU + Role: PHY + Street: + Line1: 1175 Lake Ferry Rd + Suburb: RD 1 + City: Martinborough + PostalCode: "5781" + GridLocation: + Latitude: -41.2814719 + Longitude: 175.3458472 + StatisticalAreaList: + StatisticalArea: + - SpatialUnitType: GE + Code: "058" + - SpatialUnitType: TA + Code: "050" + - SpatialUnitType: WA + Code: "05003" + Name: Hogwart's Area School + PhoneNumberList: + PhoneNumber: + - Notes: Attendance Office (Automated) + Usage: SMS + Type: WTE + Number: (0274) 300 9991 + - Notes: Attendance Office + Usage: INT + Type: WTE + Number: (04) 300 9992 + - Notes: School Secretary DDI + Type: WTE + Number: (04) 300 9993 + RelatedOrganisationList: + RelatedOrganisation: + - RefId: 0951bacf-fc88-4ed6-8113-11a6d6335c07 + LocalId: "99102" + Name: Tai Tokerau + ObjectType: Organisation + StartDate: 2012-10-31 + Type: MOE + - RefId: ac0871d9-6562-4209-ae86-abdb3661842b + LocalId: "99204" + Name: Masterton (Whakaoriori) Kāhui Ako + ObjectType: Organisation + StartDate: 2012-04-30 + Type: COL + OperationalStatus: O + Type: 21 + ProviderRefId: D3E34B35-9D75-101A-8C3D-00AA001A1652 + ProviderLocalId: "01011234" + Authority: STATE + SchoolService: + CoEdStatus: COED + Decile: 5 + NewEntrantPolicyList: + EnactedPolicy: + - EffectiveTo: 2018-12-31 + Policy: AE + - EffectiveFrom: 2019-01-01 + Policy: CE + DefinitionList: + Definition: + - SMBS + - KKMA + - SWBF + SchoolYearList: + SchoolYear: + - YearLevel: "1" + Gender: C + - YearLevel: "2" + Gender: C + - YearLevel: "3" + Gender: C + - YearLevel: "4" + Gender: C + - YearLevel: "5" + Gender: C + - YearLevel: "6" + Gender: C + - YearLevel: "7" + Gender: C + - YearLevel: "8" + Gender: C + - YearLevel: "9" + Gender: F + - YearLevel: "10" + Gender: F + - YearLevel: "11" + Gender: F + - YearLevel: "12" + Gender: F + - YearLevel: "13" + Gender: F application/xml: schema: - type: string - examples: - response: - value:The SIF GUID used by systems to identify the organisation.
+ required: true + schema: + type: string + responses: + "200": + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + 200" + default: + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + default" + /ProviderRelationships: get: tags: - - user - summary: Logs out current logged in user session - description: '' - operationId: logoutUser - responses: - default: - description: successful operation -components: - schemas: - ApiResponse: - type: object - properties: - code: - type: integer - format: int32 - type: - type: string - message: - type: string - Cat: - description: A representation of a cat - allOf: - - $ref: '#/components/schemas/Pet' - - type: object - properties: - huntingSkill: - type: string - description: The measured skill for hunting - default: lazy - enum: - - clueless - - lazy - - adventurous - - aggressive - required: - - huntingSkill - Category: - type: object - properties: - id: - description: Category ID - allOf: - - $ref: '#/components/schemas/Id' - name: - description: Category name - type: string - minLength: 1 - sub: - description: Test Sub Category - type: object - properties: - prop1: - type: string - description: Dumb Property - xml: - name: Category - Dog: - description: A representation of a dog - allOf: - - $ref: '#/components/schemas/Pet' - - type: object - properties: - packSize: - type: integer - format: int32 - description: The size of the pack the dog is from - default: 1 - minimum: 1 - required: - - packSize - HoneyBee: - description: A representation of a honey bee - allOf: - - $ref: '#/components/schemas/Pet' - - type: object - properties: - honeyPerDay: - type: number - description: Average amount of honey produced per day in ounces - example: 3.14 - required: - - honeyPerDay - Id: - type: integer - format: int64 - readOnly: true - Order: - type: object - properties: - id: - description: Order ID - allOf: - - $ref: '#/components/schemas/Id' - petId: - description: Pet ID - allOf: - - $ref: '#/components/schemas/Id' - quantity: - type: integer - format: int32 - minimum: 1 - default: 1 - shipDate: - description: Estimated ship date - type: string - format: date-time - status: - type: string - description: Order Status - enum: - - placed - - approved - - delivered - complete: - description: Indicates whenever order was completed or not - type: boolean - default: false - xml: - name: Order - Pet: - type: object - required: - - name - - photoUrls - discriminator: - propertyName: petType - mapping: - cat: '#/components/schemas/Cat' - dog: '#/components/schemas/Dog' - bee: '#/components/schemas/HoneyBee' - properties: - id: - externalDocs: - description: "Find more info here" - url: "https://example.com" - description: Pet ID - allOf: - - $ref: '#/components/schemas/Id' - category: - description: Categories this pet belongs to - allOf: - - $ref: '#/components/schemas/Category' - name: - description: The name given to a pet - type: string - example: Guru - photoUrls: - description: The list of URL to a cute photos featuring pet - type: array - maxItems: 20 - xml: - name: photoUrl - wrapped: true - items: + - ProviderRelationship + summary: Default operation to get a list of all available ProviderRelationships + description: Search the set of available ProviderRelationships, according to the + search criteria in the URL parameters. Returns the first 20 objects + located; with SIF defined navigation headers, indicating how to retrieve + subsequent sets of 20 objects. + parameters: + - name: LocalId + in: path + description: Search for object by LocalId, within the context of the organisation + represented by the ZoneId of the request. + schema: type: string - format: url - friend: - allOf: - - $ref: '#/components/schemas/Pet' - tags: - description: Tags attached to the pet - type: array - minItems: 1 - xml: - name: tag - wrapped: true - items: - $ref: '#/components/schemas/Tag' - status: - type: string - description: Pet status in the store - enum: - - available - - pending - - sold - petType: - description: Type of a pet - type: string - xml: - name: Pet - Tag: - type: object - properties: - id: - description: Tag ID - allOf: - - $ref: '#/components/schemas/Id' - name: - description: Tag name - type: string - minLength: 1 - xml: - name: Tag - User: - type: object - properties: - id: - $ref: '#/components/schemas/Id' - pet: - oneOf: - - $ref: '#/components/schemas/Pet' - - $ref: '#/components/schemas/Tag' - username: - description: User supplied username - type: string - minLength: 4 - example: John78 - firstName: - description: User first name - type: string - minLength: 1 - example: John - lastName: - description: User last name - type: string - minLength: 1 - example: Smith - email: - description: User email address - type: string - format: email - example: john.smith@example.com - password: - type: string - description: >- - User password, MUST contain a mix of upper and lower case letters, - as well as digits - format: password - minLength: 8 - pattern: '(?=.*[a-z])(?=.*[A-Z])(?=.*[0-9])' - example: drowssaP123 - phone: - description: User phone number in international format - type: string - pattern: '^\+(?:[0-9]-?){6,14}[0-9]$' - example: +1-202-555-0192 - nullable: true - userStatus: - description: User status - type: integer - format: int32 - xml: - name: User - requestBodies: - Pet: + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + ProviderRelationships: + type: object + description: A List of ProviderRelationship objects + properties: + ProviderRelationship: + type: array + items: + required: + - EffectiveDate + - RelatedProvider + - RelationshipType + - SourceProvider + type: object + properties: + ProviderRelationshipRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[\ + a-fA-F0-9]{4}-[a-fA-F0-9]{12}" + ProviderRelationshipLocalId: + description:This is a common element used to define the + locally assigned identifier associated with an + entity.
+ type: string + RelationshipType: + type: string + title: Provider Relationship Type + description: >- +A code describing the nature of the + relationship between the pair of Providers
+A reference to another SIF Data Object
+ type: object + required: + - ObjectType + properties: + RefId: + $ref: "#/paths/~1ProviderRelationships/get/respon\ + ses/200/content/application~1json/schema/pr\ + operties/ProviderRelationships/properties/P\ + roviderRelationship/items/properties/Provid\ + erRelationshipRefId" + LocalId: + $ref: "#/paths/~1ProviderRelationships/get/respon\ + ses/200/content/application~1json/schema/pr\ + operties/ProviderRelationships/properties/P\ + roviderRelationship/items/properties/Provid\ + erRelationshipLocalId" + Name: + type: string + description:The normal descriptive name of the + referenced object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject + names, to be included in Object + References
The date the source Provider in the + relationship registered their agreement to the + relationship. nil value if the source Provider + is yet to register their agreement ot the + relationship.
+ RelatedProvider: + $ref: "#/paths/~1ProviderRelationships/get/responses/\ + 200/content/application~1json/schema/properties\ + /ProviderRelationships/properties/ProviderRelat\ + ionship/items/properties/SourceProvider" + RelatedProviderAgreementDate: + type: string + format: date + description:The date the related Provider in the + relationship registered their agreement to the + relationship. nil value if the related Provider + is yet to register their agreement ot the + relationship.
+ EffectiveDate: + type: string + format: date + description:The date from which the provider relationship + is active.
+ ExpirationDate: + type: string + format: date + description:The date after which the provider + relationship is no longer active.
+ YearLevelList: + description:A list of YearLevels, denoting the year + levels of the learners being hosted or sent from + the client or contributing provider
+ type: object + required: + - YearLevel + properties: + YearLevel: + type: array + items: + type: string + title: Year Level Code + description: >- +Year Level defines the values that are + valid for describing Funding Year Level + and Current Year Level for a student + enrolment.
Current Year Level + indicates the year level of the student’s + class cohort and the level at which the + student spends most of their time at + school. While a student may be enrolled in + subjects at varying instructional year + levels, in relation to the student + enrolment this value represents the year + level at which the student is considered + to be predominantly taught.
Funding + Year Level measures the actual number of + years that the student has attended a + school. It provides the Ministry with a + method of counting students for funding + purposes which is independent of the way + schools are organised or the particular + programme of study that a student may + undertake. Funding Year Level for most + students is based on the date they first + started school.
School Year Level + is used to indicate the instructional year + levels offered by a school, i.e. those + years for which student enrolments may be + accepted.
A list of Subject or Learning Areas, denoting + the curriculum subjects or learning areas that + the learners being sent by the Source Provider + are taught at the Related Provider.
+ type: object + properties: + SubjectAreaList: + type: array + items: + SubjectArea: + type: string + title: Subject Area + description: >- +Codes denoting Subject Areas defined + by the NZ Curriculum and Te Marautanga o + Aotearoa.
Codes denoting Subject Areas defined + by the NZQA for NCEA.
Free text description providing more detail + about the provider relationship.
+ description:Records a recognised relationship between two + education Providers. The two providers are referred + to as the Source Provider and the Related Provider. +
RelationshipType records the nature of the + relationship between the two providers, and gives + guidance on which Provider is the Source Provider + and which is the Related Provider.
+ x-accessControl: + create: + - 1001 + - 2401 + - 2403 + read: + - 1001 + - 2401 + - 2403 + update: + - 1001 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: [] + application/xml: + schema: + type: object + properties: + ProviderRelationships: + type: object + description: A List of ProviderRelationship objects + properties: + ProviderRelationship: + type: array + items: + $ref: "#/paths/~1ProviderRelationships/get/responses/200/\ + content/application~1json/schema/properties/Provide\ + rRelationships/properties/ProviderRelationship/item\ + s" + default: + $ref: "#/paths/~1ScheduleTerms/get/responses/default" + "/ProviderRelationships/{ProviderRelationshipRefId}": + post: + tags: + - ProviderRelationship + summary: Default operation to create a single ProviderRelationship + parameters: + - name: ProviderRelationshipRefId + in: path + description:The SIF GUID for the relationship between two providers.
+ required: true + schema: + type: string + operationId: createProviderRelationship + requestBody: + description: CRUD operation on ProviderRelationship + content: + application/json: + schema: + type: object + properties: + ProviderRelationship: + $ref: "#/paths/~1ProviderRelationships/get/responses/200/content/\ + application~1json/schema/properties/ProviderRelationships/p\ + roperties/ProviderRelationship/items" + application/xml: + schema: + type: object + properties: + ProviderRelationship: + $ref: "#/paths/~1ProviderRelationships/get/responses/200/content/\ + application~1json/schema/properties/ProviderRelationships/p\ + roperties/ProviderRelationship/items" + responses: + "200": + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/post/responses/200" + default: + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/post/responses/de\ + fault" + put: + tags: + - ProviderRelationship + summary: Default operation to update a single ProviderRelationship + parameters: + - name: ProviderRelationshipRefId + in: path + description:The SIF GUID for the relationship between two providers.
+ required: true + schema: + type: string + operationId: updateProviderRelationship + requestBody: + description: CRUD operation on ProviderRelationship + content: + application/json: + schema: + type: object + properties: + ProviderRelationship: + type: object + properties: + ProviderRelationshipRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-\ + 9]{4}-[a-fA-F0-9]{12}" + ProviderRelationshipLocalId: + description:This is a common element used to define the locally + assigned identifier associated with an entity.
+ type: string + RelationshipType: + type: string + title: Provider Relationship Type + description: >- +A code describing the nature of the relationship + between the pair of Providers
A reference to another SIF Data Object
+ type: object + properties: + RefId: + $ref: "#/paths/~1ProviderRelationships~1%7BProviderRelati\ + onshipRefId%7D/put/requestBody/content/application~\ + 1json/schema/properties/ProviderRelationship/proper\ + ties/ProviderRelationshipRefId" + LocalId: + $ref: "#/paths/~1ProviderRelationships~1%7BProviderRelati\ + onshipRefId%7D/put/requestBody/content/application~\ + 1json/schema/properties/ProviderRelationship/proper\ + ties/ProviderRelationshipLocalId" + Name: + type: string + description:The normal descriptive name of the referenced + object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject names, to + be included in Object References
The date the source Provider in the relationship + registered their agreement to the relationship. nil + value if the source Provider is yet to register their + agreement ot the relationship.
+ RelatedProvider: + $ref: "#/paths/~1ProviderRelationships~1%7BProviderRelationsh\ + ipRefId%7D/put/requestBody/content/application~1json/sc\ + hema/properties/ProviderRelationship/properties/SourceP\ + rovider" + RelatedProviderAgreementDate: + type: string + format: date + description:The date the related Provider in the relationship + registered their agreement to the relationship. nil + value if the related Provider is yet to register their + agreement ot the relationship.
+ EffectiveDate: + type: string + format: date + description:The date from which the provider relationship is + active.
+ ExpirationDate: + type: string + format: date + description:The date after which the provider relationship is no + longer active.
+ YearLevelList: + description:A list of YearLevels, denoting the year levels of the + learners being hosted or sent from the client or + contributing provider
+ type: object + properties: + YearLevel: + type: array + items: + type: string + title: Year Level Code + description: >- +Year Level defines the values that are valid + for describing Funding Year Level and Current Year + Level for a student enrolment.
Current Year + Level indicates the year level of the student’s + class cohort and the level at which the student + spends most of their time at school. While a + student may be enrolled in subjects at varying + instructional year levels, in relation to the + student enrolment this value represents the year + level at which the student is considered to be + predominantly taught.
Funding Year Level + measures the actual number of years that the + student has attended a school. It provides the + Ministry with a method of counting students for + funding purposes which is independent of the way + schools are organised or the particular programme + of study that a student may undertake. Funding + Year Level for most students is based on the date + they first started school.
School Year + Level is used to indicate the instructional year + levels offered by a school, i.e. those years for + which student enrolments may be accepted.
A list of Subject or Learning Areas, denoting the + curriculum subjects or learning areas that the learners + being sent by the Source Provider are taught at the + Related Provider.
+ type: object + properties: + SubjectAreaList: + type: array + items: + SubjectArea: + type: string + title: Subject Area + description: >- +Codes denoting Subject Areas defined by the + NZ Curriculum and Te Marautanga o Aotearoa.
+Codes denoting Subject Areas defined by the + NZQA for NCEA.
Free text description providing more detail about the + provider relationship.
+ description:Records a recognised relationship between two education + Providers. The two providers are referred to as the Source + Provider and the Related Provider.
RelationshipType + records the nature of the relationship between the two + providers, and gives guidance on which Provider is the + Source Provider and which is the Related Provider.
+ x-accessControl: + create: + - 1001 + - 2401 + - 2403 + read: + - 1001 + - 2401 + - 2403 + update: + - 1001 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: [] + application/xml: + schema: + type: object + properties: + ProviderRelationship: + $ref: "#/paths/~1ProviderRelationships~1%7BProviderRelationshipRe\ + fId%7D/put/requestBody/content/application~1json/schema/pro\ + perties/ProviderRelationship" + responses: + "200": + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/put/responses/200" + default: + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/put/responses/def\ + ault" + get: + tags: + - ProviderRelationship + summary: Default operation to get a single ProviderRelationship + parameters: + - name: ProviderRelationshipRefId + in: path + description:The SIF GUID for the relationship between two providers.
+ required: true + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + ProviderRelationship: + $ref: "#/paths/~1ProviderRelationships/get/responses/200/conten\ + t/application~1json/schema/properties/ProviderRelationshi\ + ps/properties/ProviderRelationship/items" + application/xml: + schema: + type: object + properties: + ProviderRelationship: + $ref: "#/paths/~1ProviderRelationships/get/responses/200/conten\ + t/application~1json/schema/properties/ProviderRelationshi\ + ps/properties/ProviderRelationship/items" + default: + $ref: "#/paths/~1ScheduleTerms/get/responses/default" + delete: + tags: + - ProviderRelationship + summary: Default operation to delete a single ProviderRelationship + parameters: + - name: ProviderRelationshipRefId + in: path + description:The SIF GUID for the relationship between two providers.
+ required: true + schema: + type: string + responses: + "200": + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + 200" + default: + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + default" + /Organisations: + get: + tags: + - Organisation + summary: Default operation to get a list of all available Organisations + description: Search the set of available Organisations, according to the search + criteria in the URL parameters. Returns the first 20 objects located; + with SIF defined navigation headers, indicating how to retrieve + subsequent sets of 20 objects. + parameters: + - name: LocalId + in: path + description: Search for object by LocalId, within the context of the organisation + represented by the ZoneId of the request. + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + Organisations: + type: object + description: A List of Organisation objects + properties: + Organisation: + type: array + items: + required: + - Type + type: object + description: A generic organisation that operates within the + education sector; but doesn’t provide education + services. e.g. Communities of Learning | Kāhui Ako, + Ministry local offices, Industry training + organisations, etc. + properties: + MinistryOfEducationId: + description:This is a common element used to define the + locally assigned identifier associated with an + entity.
+ type: string + AddressList: + description:The set of postal and other addresses that + the Organisation uses
+ type: object + required: + - Address + properties: + Address: + type: array + items: + description:This element contains address data.
+ type: object + required: + - Street + properties: + Type: + type: string + title: Address Type + description: >- +Address type allows an address to + be categorised according to its + component structure. Address type can + be used to build processing rules for + validating, managing and presenting + addresses. Address type is independent + of the use of the address by any + party. To describe how a party may use + an address (residence, billing, term + address etc) see AddressRoleType
+Also called 'Street' + addresses, The most general, and + widely used type of address, and + can contain the widest variety of + components
In general a + thoroughfare address will include + components for a number, a + roadname, and a locality.
+They cannot contain any of the + components specific to a delivery + service, rural post delivery, or + water address.
These + addresses are used to find a + location.
Example: 30 - 40 + Lambton Quay, Wellington, + 6165
\"" + enum: + - TH + - title: Rural Post Delivery + description: '"Defined by New Zealand Post, + these addresses are assigned by NZ + Post for customers who purchase a + rural delivery service (mail and + also other goods).
They + will have the same number and + roadname components as the street + address, and may have the same + region component.
They do + not have a component that + identifies the locality the + address is within. The locality + and city or town components are + replaced by components that + identify the rural delivery route + (RD number), and the town from + which the rural delivery route + starts and finishes (the mail + town). Only addresses of this + class can contain these + components.
+ Example: 121 Waitaha + Road, RD 1, Ross, 7885
"' + enum: + - RU + - title: Delivery Service + description: '"Defined by New Zealand Post, + and used exclusively for NZ Post + services other than standard mail + delivery. Addresses in this class + include PO Box, Private Bag, and + Counter Delivery addresses.
+Example: Private Bag + 2345, Auckland, 1142
"' + enum: + - DE + - title: Water + description: '"Where properties have no road + access, but do have access to + water frontage (coastline or + riverbank or lakefront), a water + address uses the name of a water + feature (for example, islands, + rivers, bays, or peninsulas).
+Example: 235 Lochmara + Bay, Queen Charlotte Sound, + Marlborough Sounds
"' + enum: + - WA + - title: Foreign Address + description: '"A foreign address identifies + a location outside of New + Zealand.
Example: + Rudolf-Diesel-Strasse 14, 54595 + Prüm, Germany
"' + enum: + - FO + Role: + type: string + title: Address Role + description: >- +A standardised description of the + role or usage of an address by a party + (person or organisation). Where a + party has more than one address, this + provides context for deciding which + address to use.
The street element is a complex + element and breaks the street down + into several parts. (Allow for PO Box + here)
+ type: object + required: + - Line1 + properties: + Line1: + type: string + description:Address line 1.
+ Line2: + type: string + description:Address line 2.
+ Line3: + type: string + description:Address line 3.
+ Suburb: + type: string + description:The suburb part of urban addresses, + or the 'RD No' part of rural + addresses
+ City: + type: string + description:The city part of the address.
+ StateProvince: + type: string + description:The state or province code. + StateTerritory Code only applicable if + a non-New Zealand Address.
+ Country: + type: string + description:The country code.
+ PostalCode: + type: string + description:The ZIP/postal code.
+ GridLocation: + description:The latitude & longitude of the + location. Grid location values are + derived from New Zealand Map Grid x,y + coordinates and converted to Latitude + and Longitude values per the World + Geodetic System 1984 (G1762)
+ type: object + required: + - Latitude + - Longitude + properties: + Latitude: + description:Latitude in decimal + degrees.
Latitudes north + of the equator are positive, + latitudes south of the equator are + negative [ISO 6709].
+ Longitude: + description:Longitude in decimal + degrees.
Longitudes east of + the Prime Meridian in Greenwich + are positive, longitudes west of + the Prime Meridian are negative. + The 180th meridian is negative. + [ISO 6709]
+ StatisticalAreaList: + description:A list of Statistical Areas + containing the location.
The + list may contain exactly one + StatisticalArea element for each of + the following spatial unit types:
+A particular statistical area + defined by Statistics New + Zealand.
+ type: object + required: + - Code + - SpatialUnitType + properties: + SpatialUnitType: + type: string + title: Spatial Unit Type + description: >- +A classification of + geographical boundaries or + statistical areas as defined + by Statistics NZ’s + geographic hierarchy.
+Area units are + aggregations of + meshblocks. They are + non–administrative areas + that are in between + meshblocks and + territorial authorities + in size. Area units must + either define or + aggregate to define, + regional councils, + territorial authorities + and urban areas.
+ Statistics NZ + Classification of Area + Unit 2013 v1.0.0 + enum: + - AE + - title: General Electoral + District + description:The general electoral + districts as constituted + under the Electoral Act + 1993.
Statistics NZ + General Electoral + District 2014 v1.0.0 + enum: + - GE + - title: Community Board + description:(aka Local Board + within Auckland) Local + boards provide + governance at the local + level within Auckland + Council. They enable + democratic decision + making by, and on behalf + of communities within + the local board + area.
Statistics NZ + Community Board 2013 + v1.0.0 + enum: + - CB + - title: Māori Electoral District + description:Māori electoral + districts are the voting + districts for + parliamentary elections + for people who choose to + be on the Māori + Electoral Roll.
+ Statistics NZ Māori + Electoral District 2014 + v1.0.0 + enum: + - ME + - title: Mesh Block + description:A meshblock is the + smallest geographic unit + for which statistical + data is collected and + processed by Statistics + New Zealand.
A + meshblock is defined by + a geographic area, which + can vary in size from + part of a city block to + a large area of rural + land. Each meshblock + borders on another to + form a network covering + all of New Zealand, + including coasts and + inlets and extending out + to the 200-mile economic + zone.
Statistics NZ + Statistical Standard for + Meshblock 2013 v1.0.0 + enum: + - MB + - title: Regional Council + description:The top tier of local + government in New + Zealand, defined by the + Local Government Act + 2002, which requires the + boundaries of regions to + conform as far as + possible to one or more + water catchments. When + determining regional + boundaries, the Local + Government Commission + gave consideration to + regional communities of + interest when selecting + water catchments to be + included in a region. It + also considered factors + such as natural resource + management, land use + planning and + environmental + matters.
Statistics + NZ Regional Council 2013 + v1.0.0 + enum: + - RC + - title: Territorial Authority + description:The second tier of + local government in New + Zealand, defined under + the Local Government Act + 2002 as a city council + or district council. + There are 67 territorial + authorities consisting + of 12 city councils, 53 + districts, Auckland + Council, and Chatham + Islands Council.
+ Statistics NZ + Territorial Authority + 2013 v1.0.0 + enum: + - TA + - title: Urban Area + description: '"Urban Areas are + statistically defined + areas with no + administrative or legal + basis. There is a three + part hierarchical + sub-division of urban + areas into: main urban + areas, secondary urban + areas, minor urban + areas. Together the + populations in main, + secondary and minor + urban areas comprise the + statistically defined + urban population of New + Zealand. The urban area + classification is + designed to identify + concentrated urban or + semi-urban settlements + without the distortions + of administrative + boundaries.
+ Statistics NZ Urban Area + 2013 v2.0.0"' + enum: + - UA + - title: Ward + description:Wards are defined + under the Local + Electoral Act 2001 and + result from the + division, for electoral + purposes, of the + district of a + territorial authority. + The ward system was + designed to allow for + the recognition of + communities within a + district and to increase + community involvement in + the local government + system.
Statistics + NZ Ward 2013 v1.0.0 + enum: + - WA + Code: + type: string + description:A valid value defined by + the nominated spatial unit + type, defined by Statistics + New Zealand in one of the + following statistical area + defintion standards:
+A list of one or more methods of + communication with the organisation
+ type: object + required: + - Channel + properties: + Channel: + type: array + items: + description:A particular person or organisation's + communications method
+ type: object + required: + - Value + properties: + Type: + type: string + title: Communication Channel Type + description: >- +A standardised method of describing + a communication channel used to + communicate with or find information + about a party. Provides a more generic + definition than phone and email. + Intended to provide for future + requirements to record social network + channels, eg Facebook & Twitter + identifiers for a school.
The unique value that provides + access to the channel. eg: URL for a + website; Facebook page addess, Twitter + handle.
" + ContactList: + description:A list of one or more cotact persons related + to the organisation
+ type: object + required: + - Contact + properties: + Contact: + type: array + items: + description:A particular person's contact + details
+ type: object + required: + - Name + properties: + Name: + description:The contact's name
+ type: object + properties: + Title: + type: string + description:A title or prefix associated + with the name.
+ FamilyName: + type: string + description:Also known as Last Name, + although some cultures may not + present a family name as the last + name.
+ GivenName: + type: string + description:Also known as First Name, + although some cultures may not + present this name as the first + element in a name. May contain a + composite of all given names.
+ MiddleName: + type: string + description:Where more than one Given Name, + these may be combined in one + composite field or else populated + in several elements.
+ FamilyNameFirst: + type: string + title: Yes Or No Category + description: >- +A reusable code set for yes, + no, unknown and not provided + values.
A preferred version of the + Family Name. Note:A name cannot + have both a Preferred Family and + Preferred Given Name within the + same Name structure – only one of + these fields should be populated. + If a person does have both a + Preferred Family and Preferred + Given Name then this must be + populated as a separate Name of + type ‘Preferred’.
+ PreferredFamilyNameFirst: + $ref: "#/paths/~1Organisations/get/resp\ + onses/200/content/application~1js\ + on/schema/properties/Organisation\ + s/properties/Organisation/items/p\ + roperties/ContactList/properties/\ + Contact/items/properties/Name/pro\ + perties/FamilyNameFirst" + PreferredGivenName: + type: string + description: "A preferred version of the + Given Name. Note: A name cannot + have both a Preferred Family and + Preferred Given Name within the + same Name structure – only one of + these fields should be populated. + If a person does have both a + Preferred Family and Preferred + Given Name then this must be + populated as a separate Name of + type ‘Preferred’.
" + Suffix: + type: string + description:Textual suffix like PHD, JP, + BSc.
+ FullName: + type: string + description:A combination of all name + elements as one composite text + element
+ Type: + type: string + title: Name Usage Type + description: >- +A standardised method of + describing the usage of a name by + a person. Where a person has more + than one current name, the usage + type indicates which name may be + used according to the purpose.
+Code values are based on SIF + Australia 3.4.
The name by which an + individual prefers to be known + and addressed.
Only + usage type applicable for + student name usage (other + types are not supported by + NSI).
+ enum: + - PRF + - title: Foreign Official Name + description:Included for future usage + in NZ, especially for tertiary + students.
+ enum: + - FON + - title: Previous name + enum: + - PRV + - title: Also Known As + description: AKA or Alias + enum: + - AKA + - title: Name at Birth + enum: + - BTH + - title: Legal Name + description:Legal Name or Official Name + as defined by the organisation + which collects it (legal name + is not defined in this + standard)
+ enum: + - LGL + IsVerified: + $ref: "#/paths/~1Organisations/get/resp\ + onses/200/content/application~1js\ + on/schema/properties/Organisation\ + s/properties/Organisation/items/p\ + roperties/ContactList/properties/\ + Contact/items/properties/Name/pro\ + perties/FamilyNameFirst" + PositionTitle: + type: string + description:The title the contact has within + the Organisation being contacted
+ Role: + type: string + title: Organisation Contact Role + description: >- +The role played by a person in an + organisation where that person is + recorded as a contact. The role + definition is used to recognise + similar functions across + organisations, however individuals + with the same role may be given + different position titles that differ + from the generic role description. For + example, a principal may have a title + of ‘headmaster’.
A list of Address elements.
+ type: object + required: + - Address + properties: + Address: + type: array + items: + description:This element contains address + data.
+ type: object + required: + - Street + properties: + Type: + $ref: "#/paths/~1Organisations/ge\ + t/responses/200/content/app\ + lication~1json/schema/prope\ + rties/Organisations/propert\ + ies/Organisation/items/prop\ + erties/AddressList/properti\ + es/Address/items/properties\ + /Type" + Role: + $ref: "#/paths/~1Organisations/ge\ + t/responses/200/content/app\ + lication~1json/schema/prope\ + rties/Organisations/propert\ + ies/Organisation/items/prop\ + erties/AddressList/properti\ + es/Address/items/properties\ + /Role" + Street: + description:The street element is a + complex element and breaks + the street down into several + parts. (Allow for PO Box + here)
+ type: object + required: + - Line1 + properties: + Line1: + type: string + description:Address line 1.
+ Line2: + type: string + description:Address line 2.
+ Line3: + type: string + description:Address line 3.
+ Suburb: + type: string + description:The suburb part of urban + addresses, or the 'RD No' + part of rural addresses
+ City: + type: string + description:The city part of the + address.
+ StateProvince: + type: string + description:The state or province + code. StateTerritory Code + only applicable if a non-New + Zealand Address.
+ Country: + type: string + description:The country code.
+ PostalCode: + type: string + description:The ZIP/postal code.
+ GridLocation: + description:The latitude & longitude + of the location. Grid + location values are derived + from New Zealand Map Grid + x,y coordinates and + converted to Latitude and + Longitude values per the + World Geodetic System 1984 + (G1762)
+ type: object + required: + - Latitude + - Longitude + properties: + Latitude: + description:Latitude in decimal + degrees.
+ Latitudes north of the + equator are positive, + latitudes south of the + equator are negative + [ISO 6709].
+ Longitude: + description:Longitude in decimal + degrees.
+Longitudes east of + the Prime Meridian in + Greenwich are positive, + longitudes west of the + Prime Meridian are + negative. The 180th + meridian is negative. + [ISO 6709]
+ StatisticalAreaList: + description:A list of Statistical + Areas containing the + location.
The list + may contain exactly one + StatisticalArea element for + each of the following + spatial unit types:
A particular + statistical area + defined by Statistics + New Zealand.
+ type: object + required: + - Code + - SpatialUnitType + properties: + SpatialUnitType: + $ref: "#/paths/~1Organi\ + sations/get/respons\ + es/200/content/appl\ + ication~1json/schem\ + a/properties/Organi\ + sations/properties/\ + Organisation/items/\ + properties/AddressL\ + ist/properties/Addr\ + ess/items/propertie\ + s/StatisticalAreaLi\ + st/properties/Stati\ + sticalArea/items/pr\ + operties/SpatialUni\ + tType" + Code: + type: string + description:A valid value + defined by the + nominated spatial + unit type, defined + by Statistics New + Zealand in one of + the following + statistical area + defintion + standards:
List of Email elements.
+ type: object + required: + - Email + properties: + Email: + type: array + items: + 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: object + required: + - Address + properties: + Type: + type: string + title: Email Type + description: >- +A standardised method of + describing an electronic + mail address used as contact + method by a party. Where a + party has more than one + email address, this may + provide context for deciding + which email address to + use.
The actual email + address.
+ PhoneNumberList: + description:List of PhoneNumber elements.
+ type: object + required: + - PhoneNumber + properties: + PhoneNumber: + type: array + items: + description:This element represents a + phone number and occurs within + objects such as StudentPersonal, + StaffPersonal, etc.
+ type: object + required: + - Number + properties: + Type: + type: string + title: Telephone Number Type + description: >- +A standardised method of + describing a + telecommunications device + used as contact method by a + party. Where a party has + more than one phone number, + this may provide context for + deciding which number to + use.
Phone number. Free-form, + but typical New Zealand + formats include:
Phone number + extension.
+ ListedStatus: + $ref: "#/paths/~1Organisations/ge\ + t/responses/200/content/app\ + lication~1json/schema/prope\ + rties/Organisations/propert\ + ies/Organisation/items/prop\ + erties/ContactList/properti\ + es/Contact/items/properties\ + /Name/properties/FamilyName\ + First" + EducationRegion: + type: string + title: Education Region + description: >- + Regions of New Zealand defined by Ministry of + Education for administrative purposes.The set of contact email addresses that the + Organisation uses
+ type: object + required: + - Email + properties: + Email: + type: array + items: + 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: object + required: + - Address + properties: + Type: + $ref: "#/paths/~1Organisations/get/response\ + s/200/content/application~1json/schem\ + a/properties/Organisations/properties\ + /Organisation/items/properties/Contac\ + tList/properties/Contact/items/proper\ + ties/EmailList/properties/Email/items\ + /properties/Type" + Address: + type: string + description:The actual email address.
+ EntityClose: + type: string + format: date + description:Closing date of entity. Only present for + closed providers.
+ EntityOpen: + type: string + format: date + description:Opening date of entity. For proposed schools + this will be the projected opening date. For + open schools this may not be present.
+ LocationList: + description:A list of one or more locations, from which + the organisation operates or provides a + service.
+ type: object + required: + - Location + properties: + Location: + type: array + items: + description:This element contains data about a + geographical location.
+ type: object + properties: + Description: + type: string + description:A description for the Location.
+ Address: + description:The physical address of the + Location
+ type: object + required: + - Street + properties: + Type: + $ref: "#/paths/~1Organisations/get/resp\ + onses/200/content/application~1js\ + on/schema/properties/Organisation\ + s/properties/Organisation/items/p\ + roperties/AddressList/properties/\ + Address/items/properties/Type" + Role: + $ref: "#/paths/~1Organisations/get/resp\ + onses/200/content/application~1js\ + on/schema/properties/Organisation\ + s/properties/Organisation/items/p\ + roperties/AddressList/properties/\ + Address/items/properties/Role" + Street: + description:The street element is a complex + element and breaks the street down + into several parts. (Allow for PO + Box here)
+ type: object + required: + - Line1 + properties: + Line1: + type: string + description:Address line 1.
+ Line2: + type: string + description:Address line 2.
+ Line3: + type: string + description:Address line 3.
+ Suburb: + type: string + description:The suburb part of urban + addresses, or the 'RD No' part of + rural addresses
+ City: + type: string + description:The city part of the + address.
+ StateProvince: + type: string + description:The state or province code. + StateTerritory Code only + applicable if a non-New Zealand + Address.
+ Country: + type: string + description:The country code.
+ PostalCode: + type: string + description:The ZIP/postal code.
+ GridLocation: + description:The latitude & longitude of the + location. Grid location values are + derived from New Zealand Map Grid + x,y coordinates and converted to + Latitude and Longitude values per + the World Geodetic System 1984 + (G1762)
+ type: object + required: + - Latitude + - Longitude + properties: + Latitude: + description:Latitude in decimal + degrees.
Latitudes + north of the equator are + positive, latitudes south of + the equator are negative [ISO + 6709].
+ Longitude: + description:Longitude in decimal + degrees.
Longitudes + east of the Prime Meridian in + Greenwich are positive, + longitudes west of the Prime + Meridian are negative. The + 180th meridian is negative. + [ISO 6709]
+ StatisticalAreaList: + description:A list of Statistical Areas + containing the location.
+The list may contain exactly + one StatisticalArea element for + each of the following spatial unit + types:
A particular statistical + area defined by Statistics + New Zealand.
+ type: object + required: + - Code + - SpatialUnitType + properties: + SpatialUnitType: + $ref: "#/paths/~1Organisation\ + s/get/responses/200/con\ + tent/application~1json/\ + schema/properties/Organ\ + isations/properties/Org\ + anisation/items/propert\ + ies/AddressList/propert\ + ies/Address/items/prope\ + rties/StatisticalAreaLi\ + st/properties/Statistic\ + alArea/items/properties\ + /SpatialUnitType" + Code: + type: string + description:A valid value defined + by the nominated spatial + unit type, defined by + Statistics New Zealand + in one of the following + statistical area + defintion standards:
+The latitude & longitude of the + location. Grid location values are + derived from New Zealand Map Grid x,y + coordinates and converted to Latitude + and Longitude values per the World + Geodetic System 1984 (G1762)
+ type: object + required: + - Latitude + - Longitude + properties: + Latitude: + description:Latitude in decimal + degrees.
Latitudes north + of the equator are positive, + latitudes south of the equator are + negative [ISO 6709].
+ Longitude: + description:Longitude in decimal + degrees.
Longitudes east of + the Prime Meridian in Greenwich + are positive, longitudes west of + the Prime Meridian are negative. + The 180th meridian is negative. + [ISO 6709]
+ StatisticalAreaList: + description:A list of Statistical Areas + containing the location.
The + list may contain exactly one + StatisticalArea element for each of + the following spatial unit types:
+A particular statistical area + defined by Statistics New + Zealand.
+ type: object + required: + - Code + - SpatialUnitType + properties: + SpatialUnitType: + $ref: "#/paths/~1Organisations/ge\ + t/responses/200/content/app\ + lication~1json/schema/prope\ + rties/Organisations/propert\ + ies/Organisation/items/prop\ + erties/AddressList/properti\ + es/Address/items/properties\ + /StatisticalAreaList/proper\ + ties/StatisticalArea/items/\ + properties/SpatialUnitType" + Code: + type: string + description:A valid value defined by + the nominated spatial unit + type, defined by Statistics + New Zealand in one of the + following statistical area + defintion standards:
+The normal business name of the + Organisation
+ PhoneNumberList: + description:The set of contact phone numbers that the + Organisation uses
+ type: object + required: + - PhoneNumber + properties: + PhoneNumber: + type: array + items: + description:This element represents a phone number + and occurs within objects such as + StudentPersonal, StaffPersonal, etc.
+ type: object + required: + - Number + properties: + Type: + $ref: "#/paths/~1Organisations/get/response\ + s/200/content/application~1json/schem\ + a/properties/Organisations/properties\ + /Organisation/items/properties/Contac\ + tList/properties/Contact/items/proper\ + ties/PhoneNumberList/properties/Phone\ + Number/items/properties/Type" + Number: + type: string + description: "Phone number. Free-form, but + typical New Zealand formats + include:
Phone number extension.
+ ListedStatus: + $ref: "#/paths/~1Organisations/get/response\ + s/200/content/application~1json/schem\ + a/properties/Organisations/properties\ + /Organisation/items/properties/Contac\ + tList/properties/Contact/items/proper\ + ties/Name/properties/FamilyNameFirst" + RelatedOrganisationList: + description:A list of other organisations that are + related to the Provider
+ type: object + required: + - RelatedOrganisation + properties: + RelatedOrganisation: + type: array + items: + description:Extends
+ ObjectReferenceType
to add an
+ extra element,
+ OrganisationType
, describing
+ the nature of the related
+ organisation.
The start date of the relationship + between the two organisations
+ EndDate: + type: string + format: date + description:The end date of the relationship + between the two organisations
+ Type: + type: string + title: Organisation Relationship Type + description: >- +A code describing the nature of the + relationship between a pair of + Organisations
Indicates the operational status of an + organisation.
The SIF GUID used by systems to identify the organisation.
+ required: true + schema: + type: string + operationId: createOrganisation + requestBody: + description: CRUD operation on Organisation + content: + application/json: + schema: + type: object + properties: + Organisation: + $ref: "#/paths/~1Organisations/get/responses/200/content/applicat\ + ion~1json/schema/properties/Organisations/properties/Organi\ + sation/items" + example: + Organisation: + AddressList: {} + CommunicationChannelList: {} + ContactList: + Contact: + Name: + FamilyName: Dumbledore + GivenName: Albus + FullName: Albus Dumbledore + PositionTitle: Lead School Headmaster + Role: PRI + AddressList: + Address: + Type: TH + Role: PHY + Street: + Line1: 533 Hogwart's Way + City: Hogsmead + PostalCode: "7733" + EmailList: {} + PhoneNumberList: {} + EmailList: + Email: + - Type: PRIM + Address: stuart@gmail.com + LocationList: {} + Name: Masterton (Whakaoriori) Kāhui Ako + PhoneNumberList: + PhoneNumber: + Notes: Lead School Secretary (Mobile) + Type: MOB + Number: (021) 300 999 + Type: 998 + OrganisationRefId: D3E34B35-9D75-101A-8C3D-00AA001A1652 + OrganisationLocalId: 99204 + application/xml: + schema: + type: object + properties: + Organisation: + $ref: "#/paths/~1Organisations/get/responses/200/content/applicat\ + ion~1json/schema/properties/Organisations/properties/Organi\ + sation/items" + example: >- +The SIF GUID used by systems to identify the organisation.
+ required: true + schema: + type: string + operationId: updateOrganisation + requestBody: + description: CRUD operation on Organisation + content: + application/json: + schema: + type: object + properties: + Organisation: + type: object + description: A generic organisation that operates within the education + sector; but doesn’t provide education services. e.g. + Communities of Learning | Kāhui Ako, Ministry local offices, + Industry training organisations, etc. + properties: + MinistryOfEducationId: + description:This is a common element used to define the locally + assigned identifier associated with an entity.
+ type: string + AddressList: + description:The set of postal and other addresses that the + Organisation uses
+ type: object + properties: + Address: + type: array + items: + description:This element contains address data.
+ type: object + properties: + Type: + type: string + title: Address Type + description: >- +Address type allows an address to be + categorised according to its component + structure. Address type can be used to build + processing rules for validating, managing and + presenting addresses. Address type is + independent of the use of the address by any + party. To describe how a party may use an + address (residence, billing, term address etc) + see AddressRoleType
Also called 'Street' addresses, The + most general, and widely used type of + address, and can contain the widest + variety of components
In general a + thoroughfare address will include + components for a number, a roadname, and a + locality.
They cannot contain any + of the components specific to a delivery + service, rural post delivery, or water + address.
These addresses are used + to find a location.
Example: 30 - + 40 Lambton Quay, Wellington, 6165
\"" + enum: + - TH + - title: Rural Post Delivery + description: '"Defined by New Zealand Post, these + addresses are assigned by NZ Post for + customers who purchase a rural delivery + service (mail and also other goods).
+They will have the same number and + roadname components as the street address, + and may have the same region + component.
They do not have a + component that identifies the locality the + address is within. The locality and city + or town components are replaced by + components that identify the rural + delivery route (RD number), and the town + from which the rural delivery route starts + and finishes (the mail town). Only + addresses of this class can contain these + components.
Example: 121 + Waitaha Road, RD 1, Ross, 7885
"' + enum: + - RU + - title: Delivery Service + description: '"Defined by New Zealand Post, and used + exclusively for NZ Post services other + than standard mail delivery. Addresses in + this class include PO Box, Private Bag, + and Counter Delivery addresses.
+ Example: Private Bag 2345, + Auckland, 1142
"' + enum: + - DE + - title: Water + description: '"Where properties have no road access, + but do have access to water frontage + (coastline or riverbank or lakefront), a + water address uses the name of a water + feature (for example, islands, rivers, + bays, or peninsulas).
+ Example: 235 Lochmara Bay, Queen + Charlotte Sound, Marlborough Sounds
"' + enum: + - WA + - title: Foreign Address + description: '"A foreign address identifies a + location outside of New Zealand.
+ Example: Rudolf-Diesel-Strasse + 14, 54595 Prüm, Germany
"' + enum: + - FO + Role: + type: string + title: Address Role + description: >- +A standardised description of the role or + usage of an address by a party (person or + organisation). Where a party has more than one + address, this provides context for deciding + which address to use.
The street element is a complex element and + breaks the street down into several parts. + (Allow for PO Box here)
+ type: object + properties: + Line1: + type: string + description:Address line 1.
+ Line2: + type: string + description:Address line 2.
+ Line3: + type: string + description:Address line 3.
+ Suburb: + type: string + description:The suburb part of urban addresses, or the + 'RD No' part of rural addresses
+ City: + type: string + description:The city part of the address.
+ StateProvince: + type: string + description:The state or province code. StateTerritory + Code only applicable if a non-New Zealand + Address.
+ Country: + type: string + description:The country code.
+ PostalCode: + type: string + description:The ZIP/postal code.
+ GridLocation: + description:The latitude & longitude of the location. + Grid location values are derived from New + Zealand Map Grid x,y coordinates and converted + to Latitude and Longitude values per the World + Geodetic System 1984 (G1762)
+ type: object + properties: + Latitude: + description:Latitude in decimal degrees.
+ Latitudes north of the equator are + positive, latitudes south of the equator + are negative [ISO 6709].
+ Longitude: + description:Longitude in decimal degrees.
+Longitudes east of the Prime Meridian + in Greenwich are positive, longitudes west + of the Prime Meridian are negative. The + 180th meridian is negative. [ISO 6709]
+ StatisticalAreaList: + description:A list of Statistical Areas containing the + location.
The list may contain exactly + one StatisticalArea element for each of the + following spatial unit types:
A particular statistical area defined + by Statistics New Zealand.
+ type: object + properties: + SpatialUnitType: + type: string + title: Spatial Unit Type + description: >- +A classification of geographical + boundaries or statistical areas as + defined by Statistics NZ’s + geographic hierarchy.
Area units are aggregations + of meshblocks. They are + non–administrative areas that + are in between meshblocks and + territorial authorities in size. + Area units must either define or + aggregate to define, regional + councils, territorial + authorities and urban areas.
+ Statistics NZ Classification of + Area Unit 2013 v1.0.0 + enum: + - AE + - title: General Electoral District + description:The general electoral + districts as constituted under + the Electoral Act 1993.
+ Statistics NZ General Electoral + District 2014 v1.0.0 + enum: + - GE + - title: Community Board + description:(aka Local Board within + Auckland) Local boards provide + governance at the local level + within Auckland Council. They + enable democratic decision + making by, and on behalf of + communities within the local + board area.
Statistics NZ + Community Board 2013 v1.0.0 + enum: + - CB + - title: Māori Electoral District + description:Māori electoral districts are + the voting districts for + parliamentary elections for + people who choose to be on the + Māori Electoral Roll.
+ Statistics NZ Māori Electoral + District 2014 v1.0.0 + enum: + - ME + - title: Mesh Block + description:A meshblock is the smallest + geographic unit for which + statistical data is collected + and processed by Statistics New + Zealand.
A meshblock is + defined by a geographic area, + which can vary in size from part + of a city block to a large area + of rural land. Each meshblock + borders on another to form a + network covering all of New + Zealand, including coasts and + inlets and extending out to the + 200-mile economic zone.
+ Statistics NZ Statistical + Standard for Meshblock 2013 + v1.0.0 + enum: + - MB + - title: Regional Council + description:The top tier of local + government in New Zealand, + defined by the Local Government + Act 2002, which requires the + boundaries of regions to conform + as far as possible to one or + more water catchments. When + determining regional boundaries, + the Local Government Commission + gave consideration to regional + communities of interest when + selecting water catchments to be + included in a region. It also + considered factors such as + natural resource management, + land use planning and + environmental matters.
+ Statistics NZ Regional Council + 2013 v1.0.0 + enum: + - RC + - title: Territorial Authority + description:The second tier of local + government in New Zealand, + defined under the Local + Government Act 2002 as a city + council or district council. + There are 67 territorial + authorities consisting of 12 + city councils, 53 districts, + Auckland Council, and Chatham + Islands Council.
Statistics + NZ Territorial Authority 2013 + v1.0.0 + enum: + - TA + - title: Urban Area + description: '"Urban Areas are + statistically defined areas with + no administrative or legal + basis. There is a three part + hierarchical sub-division of + urban areas into: main urban + areas, secondary urban areas, + minor urban areas. Together the + populations in main, secondary + and minor urban areas comprise + the statistically defined urban + population of New Zealand. The + urban area classification is + designed to identify + concentrated urban or semi-urban + settlements without the + distortions of administrative + boundaries.
Statistics NZ + Urban Area 2013 v2.0.0"' + enum: + - UA + - title: Ward + description:Wards are defined under the + Local Electoral Act 2001 and + result from the division, for + electoral purposes, of the + district of a territorial + authority. The ward system was + designed to allow for the + recognition of communities + within a district and to + increase community involvement + in the local government + system.
Statistics NZ Ward + 2013 v1.0.0 + enum: + - WA + Code: + type: string + description:A valid value defined by the + nominated spatial unit type, defined + by Statistics New Zealand in one of + the following statistical area + defintion standards:
A list of one or more methods of communication with + the organisation
+ type: object + properties: + Channel: + type: array + items: + description:A particular person or organisation's + communications method
+ type: object + properties: + Type: + type: string + title: Communication Channel Type + description: >- +A standardised method of describing a + communication channel used to communicate with + or find information about a party. Provides a + more generic definition than phone and email. + Intended to provide for future requirements to + record social network channels, eg Facebook + & Twitter identifiers for a school.
+The unique value that provides access to + the channel. eg: URL for a website; Facebook + page addess, Twitter handle.
" + ContactList: + description:A list of one or more cotact persons related to the + organisation
+ type: object + properties: + Contact: + type: array + items: + description:A particular person's contact details
+ type: object + properties: + Name: + description:The contact's name
+ type: object + properties: + Title: + type: string + description:A title or prefix associated with the + name.
+ FamilyName: + type: string + description:Also known as Last Name, although some + cultures may not present a family name as + the last name.
+ GivenName: + type: string + description:Also known as First Name, although some + cultures may not present this name as the + first element in a name. May contain a + composite of all given names.
+ MiddleName: + type: string + description:Where more than one Given Name, these + may be combined in one composite field or + else populated in several elements.
+ FamilyNameFirst: + type: string + title: Yes Or No Category + description: >- +A reusable code set for yes, no, + unknown and not provided values.
A preferred version of the Family Name. + Note:A name cannot have both a Preferred + Family and Preferred Given Name within the + same Name structure – only one of these + fields should be populated. If a person + does have both a Preferred Family and + Preferred Given Name then this must be + populated as a separate Name of type + ‘Preferred’.
+ PreferredFamilyNameFirst: + $ref: "#/paths/~1Organisations~1%7BOrganisation\ + RefId%7D/put/requestBody/content/applicat\ + ion~1json/schema/properties/Organisation/\ + properties/ContactList/properties/Contact\ + /items/properties/Name/properties/FamilyN\ + ameFirst" + PreferredGivenName: + type: string + description: "A preferred version of the Given Name. + Note: A name cannot have both a Preferred + Family and Preferred Given Name within the + same Name structure – only one of these + fields should be populated. If a person + does have both a Preferred Family and + Preferred Given Name then this must be + populated as a separate Name of type + ‘Preferred’.
" + Suffix: + type: string + description:Textual suffix like PHD, JP, BSc.
+ FullName: + type: string + description:A combination of all name elements as + one composite text element
+ Type: + type: string + title: Name Usage Type + description: >- +A standardised method of describing the + usage of a name by a person. Where a + person has more than one current name, the + usage type indicates which name may be + used according to the purpose.
Code + values are based on SIF Australia 3.4.
+The name by which an individual + prefers to be known and addressed.
+Only usage type applicable for + student name usage (other types are + not supported by NSI).
+ enum: + - PRF + - title: Foreign Official Name + description:Included for future usage in NZ, + especially for tertiary students.
+ enum: + - FON + - title: Previous name + enum: + - PRV + - title: Also Known As + description: AKA or Alias + enum: + - AKA + - title: Name at Birth + enum: + - BTH + - title: Legal Name + description:Legal Name or Official Name as + defined by the organisation which + collects it (legal name is not defined + in this standard)
+ enum: + - LGL + IsVerified: + $ref: "#/paths/~1Organisations~1%7BOrganisation\ + RefId%7D/put/requestBody/content/applicat\ + ion~1json/schema/properties/Organisation/\ + properties/ContactList/properties/Contact\ + /items/properties/Name/properties/FamilyN\ + ameFirst" + PositionTitle: + type: string + description:The title the contact has within the + Organisation being contacted
+ Role: + type: string + title: Organisation Contact Role + description: >- +The role played by a person in an + organisation where that person is recorded as + a contact. The role definition is used to + recognise similar functions across + organisations, however individuals with the + same role may be given different position + titles that differ from the generic role + description. For example, a principal may have + a title of ‘headmaster’.
A list of Address elements.
+ type: object + properties: + Address: + type: array + items: + description:This element contains address + data.
+ type: object + properties: + Type: + $ref: "#/paths/~1Organisations~1%7BOrgani\ + sationRefId%7D/put/requestBody/cont\ + ent/application~1json/schema/proper\ + ties/Organisation/properties/Addres\ + sList/properties/Address/items/prop\ + erties/Type" + Role: + $ref: "#/paths/~1Organisations~1%7BOrgani\ + sationRefId%7D/put/requestBody/cont\ + ent/application~1json/schema/proper\ + ties/Organisation/properties/Addres\ + sList/properties/Address/items/prop\ + erties/Role" + Street: + description:The street element is a complex + element and breaks the street down + into several parts. (Allow for PO + Box here)
+ type: object + properties: + Line1: + type: string + description:Address line 1.
+ Line2: + type: string + description:Address line 2.
+ Line3: + type: string + description:Address line 3.
+ Suburb: + type: string + description:The suburb part of urban + addresses, or the 'RD No' part of + rural addresses
+ City: + type: string + description:The city part of the address.
+ StateProvince: + type: string + description:The state or province code. + StateTerritory Code only applicable + if a non-New Zealand Address.
+ Country: + type: string + description:The country code.
+ PostalCode: + type: string + description:The ZIP/postal code.
+ GridLocation: + description:The latitude & longitude of the + location. Grid location values are + derived from New Zealand Map Grid + x,y coordinates and converted to + Latitude and Longitude values per + the World Geodetic System 1984 + (G1762)
+ type: object + properties: + Latitude: + description:Latitude in decimal + degrees.
Latitudes north + of the equator are positive, + latitudes south of the equator + are negative [ISO 6709].
+ Longitude: + description:Longitude in decimal + degrees.
Longitudes east + of the Prime Meridian in + Greenwich are positive, + longitudes west of the Prime + Meridian are negative. The 180th + meridian is negative. [ISO + 6709]
+ StatisticalAreaList: + description:A list of Statistical Areas + containing the location.
The + list may contain exactly one + StatisticalArea element for each of + the following spatial unit + types:
A particular statistical + area defined by Statistics New + Zealand.
+ type: object + properties: + SpatialUnitType: + $ref: "#/paths/~1Organisations~\ + 1%7BOrganisationRefId%7D/\ + put/requestBody/content/a\ + pplication~1json/schema/p\ + roperties/Organisation/pr\ + operties/AddressList/prop\ + erties/Address/items/prop\ + erties/StatisticalAreaLis\ + t/properties/StatisticalA\ + rea/items/properties/Spat\ + ialUnitType" + Code: + type: string + description:A valid value defined + by the nominated spatial + unit type, defined by + Statistics New Zealand in + one of the following + statistical area defintion + standards:
List of Email elements.
+ type: object + properties: + Email: + type: array + items: + 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: object + properties: + Type: + type: string + title: Email Type + description: >- +A standardised method of + describing an electronic mail + address used as contact method by a + party. Where a party has more than + one email address, this may provide + context for deciding which email + address to use.
The actual email address.
+ PhoneNumberList: + description:List of PhoneNumber elements.
+ type: object + properties: + PhoneNumber: + type: array + items: + description:This element represents a phone + number and occurs within objects such as + StudentPersonal, StaffPersonal, etc.
+ type: object + properties: + Type: + type: string + title: Telephone Number Type + description: >- +A standardised method of + describing a telecommunications + device used as contact method by a + party. Where a party has more than + one phone number, this may provide + context for deciding which number to + use.
Phone number. Free-form, but + typical New Zealand formats + include:
Phone number extension.
+ ListedStatus: + $ref: "#/paths/~1Organisations~1%7BOrgani\ + sationRefId%7D/put/requestBody/cont\ + ent/application~1json/schema/proper\ + ties/Organisation/properties/Contac\ + tList/properties/Contact/items/prop\ + erties/Name/properties/FamilyNameFi\ + rst" + EducationRegion: + type: string + title: Education Region + description: >- + Regions of New Zealand defined by Ministry of Education + for administrative purposes.The set of contact email addresses that the + Organisation uses
+ type: object + properties: + Email: + type: array + items: + 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: object + properties: + Type: + $ref: "#/paths/~1Organisations~1%7BOrganisationRefI\ + d%7D/put/requestBody/content/application~1jso\ + n/schema/properties/Organisation/properties/C\ + ontactList/properties/Contact/items/propertie\ + s/EmailList/properties/Email/items/properties\ + /Type" + Address: + type: string + description:The actual email address.
+ EntityClose: + type: string + format: date + description:Closing date of entity. Only present for closed + providers.
+ EntityOpen: + type: string + format: date + description:Opening date of entity. For proposed schools this + will be the projected opening date. For open schools + this may not be present.
+ LocationList: + description:A list of one or more locations, from which the + organisation operates or provides a service.
+ type: object + properties: + Location: + type: array + items: + description:This element contains data about a geographical + location.
+ type: object + properties: + Description: + type: string + description:A description for the Location.
+ Address: + description:The physical address of the Location
+ type: object + properties: + Type: + $ref: "#/paths/~1Organisations~1%7BOrganisation\ + RefId%7D/put/requestBody/content/applicat\ + ion~1json/schema/properties/Organisation/\ + properties/AddressList/properties/Address\ + /items/properties/Type" + Role: + $ref: "#/paths/~1Organisations~1%7BOrganisation\ + RefId%7D/put/requestBody/content/applicat\ + ion~1json/schema/properties/Organisation/\ + properties/AddressList/properties/Address\ + /items/properties/Role" + Street: + description:The street element is a complex element + and breaks the street down into several + parts. (Allow for PO Box here)
+ type: object + properties: + Line1: + type: string + description:Address line 1.
+ Line2: + type: string + description:Address line 2.
+ Line3: + type: string + description:Address line 3.
+ Suburb: + type: string + description:The suburb part of urban addresses, or + the 'RD No' part of rural addresses
+ City: + type: string + description:The city part of the address.
+ StateProvince: + type: string + description:The state or province code. + StateTerritory Code only applicable if a + non-New Zealand Address.
+ Country: + type: string + description:The country code.
+ PostalCode: + type: string + description:The ZIP/postal code.
+ GridLocation: + description:The latitude & longitude of the + location. Grid location values are derived + from New Zealand Map Grid x,y coordinates + and converted to Latitude and Longitude + values per the World Geodetic System 1984 + (G1762)
+ type: object + properties: + Latitude: + description:Latitude in decimal degrees.
+Latitudes north of the equator are + positive, latitudes south of the + equator are negative [ISO 6709].
+ Longitude: + description:Longitude in decimal degrees.
+Longitudes east of the Prime + Meridian in Greenwich are positive, + longitudes west of the Prime Meridian + are negative. The 180th meridian is + negative. [ISO 6709]
+ StatisticalAreaList: + description:A list of Statistical Areas containing + the location.
The list may contain + exactly one StatisticalArea element for + each of the following spatial unit + types:
A particular statistical area + defined by Statistics New + Zealand.
+ type: object + properties: + SpatialUnitType: + $ref: "#/paths/~1Organisations~1%7BOr\ + ganisationRefId%7D/put/requestB\ + ody/content/application~1json/s\ + chema/properties/Organisation/p\ + roperties/AddressList/propertie\ + s/Address/items/properties/Stat\ + isticalAreaList/properties/Stat\ + isticalArea/items/properties/Sp\ + atialUnitType" + Code: + type: string + description:A valid value defined by the + nominated spatial unit type, + defined by Statistics New + Zealand in one of the following + statistical area defintion + standards:
The latitude & longitude of the location. + Grid location values are derived from New + Zealand Map Grid x,y coordinates and converted + to Latitude and Longitude values per the World + Geodetic System 1984 (G1762)
+ type: object + properties: + Latitude: + description:Latitude in decimal degrees.
+ Latitudes north of the equator are + positive, latitudes south of the equator + are negative [ISO 6709].
+ Longitude: + description:Longitude in decimal degrees.
+Longitudes east of the Prime Meridian + in Greenwich are positive, longitudes west + of the Prime Meridian are negative. The + 180th meridian is negative. [ISO 6709]
+ StatisticalAreaList: + description:A list of Statistical Areas containing the + location.
The list may contain exactly + one StatisticalArea element for each of the + following spatial unit types:
A particular statistical area defined + by Statistics New Zealand.
+ type: object + properties: + SpatialUnitType: + $ref: "#/paths/~1Organisations~1%7BOrgani\ + sationRefId%7D/put/requestBody/cont\ + ent/application~1json/schema/proper\ + ties/Organisation/properties/Addres\ + sList/properties/Address/items/prop\ + erties/StatisticalAreaList/properti\ + es/StatisticalArea/items/properties\ + /SpatialUnitType" + Code: + type: string + description:A valid value defined by the + nominated spatial unit type, defined + by Statistics New Zealand in one of + the following statistical area + defintion standards:
The normal business name of the Organisation
+ PhoneNumberList: + description:The set of contact phone numbers that the + Organisation uses
+ type: object + properties: + PhoneNumber: + type: array + items: + description:This element represents a phone number and + occurs within objects such as StudentPersonal, + StaffPersonal, etc.
+ type: object + properties: + Type: + $ref: "#/paths/~1Organisations~1%7BOrganisationRefI\ + d%7D/put/requestBody/content/application~1jso\ + n/schema/properties/Organisation/properties/C\ + ontactList/properties/Contact/items/propertie\ + s/PhoneNumberList/properties/PhoneNumber/item\ + s/properties/Type" + Number: + type: string + description: "Phone number. Free-form, but typical New + Zealand formats include:
Phone number extension.
+ ListedStatus: + $ref: "#/paths/~1Organisations~1%7BOrganisationRefI\ + d%7D/put/requestBody/content/application~1jso\ + n/schema/properties/Organisation/properties/C\ + ontactList/properties/Contact/items/propertie\ + s/Name/properties/FamilyNameFirst" + RelatedOrganisationList: + description:A list of other organisations that are related to the + Provider
+ type: object + properties: + RelatedOrganisation: + type: array + items: + description:Extends ObjectReferenceType
to add
+ an extra element, OrganisationType
,
+ describing the nature of the related
+ organisation.
The start date of the relationship between + the two organisations
+ EndDate: + type: string + format: date + description:The end date of the relationship between + the two organisations
+ Type: + type: string + title: Organisation Relationship Type + description: >- +A code describing the nature of the + relationship between a pair of + Organisations
Indicates the operational status of an + organisation.
The SIF GUID used by systems to identify the organisation.
+ required: true + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + Organisation: + $ref: "#/paths/~1Organisations/get/responses/200/content/applic\ + ation~1json/schema/properties/Organisations/properties/Or\ + ganisation/items" + example: + Organisation: + AddressList: {} + CommunicationChannelList: {} + ContactList: + Contact: + Name: + FamilyName: Dumbledore + GivenName: Albus + FullName: Albus Dumbledore + PositionTitle: Lead School Headmaster + Role: PRI + AddressList: + Address: + Type: TH + Role: PHY + Street: + Line1: 533 Hogwart's Way + City: Hogsmead + PostalCode: "7733" + EmailList: {} + PhoneNumberList: {} + EmailList: + Email: + - Type: PRIM + Address: stuart@gmail.com + LocationList: {} + Name: Masterton (Whakaoriori) Kāhui Ako + PhoneNumberList: + PhoneNumber: + Notes: Lead School Secretary (Mobile) + Type: MOB + Number: (021) 300 999 + Type: 998 + OrganisationRefId: D3E34B35-9D75-101A-8C3D-00AA001A1652 + OrganisationLocalId: 99204 + application/xml: + schema: + type: object + properties: + Organisation: + $ref: "#/paths/~1Organisations/get/responses/200/content/applic\ + ation~1json/schema/properties/Organisations/properties/Or\ + ganisation/items" + example: >- +The SIF GUID used by systems to identify the organisation.
+ required: true + schema: + type: string + responses: + "200": + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + 200" + default: + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + default" + /AcademicDepartments: + get: + tags: + - AcademicDepartment + summary: Default operation to get a list of all available AcademicDepartments + description: Search the set of available AcademicDepartments, according to the search + criteria in the URL parameters. Returns the first 20 objects located; + with SIF defined navigation headers, indicating how to retrieve + subsequent sets of 20 objects. + parameters: + - name: LocalId + in: path + description: Search for object by LocalId, within the context of the organisation + represented by the ZoneId of the request. + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + AcademicDepartments: + type: object + description: A List of AcademicDepartment objects + properties: + AcademicDepartment: + type: array + items: + required: + - Provider + type: object + properties: + AcademicDepartmentRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[\ + a-fA-F0-9]{4}-[a-fA-F0-9]{12}" + AcademicDepartmentLocalId: + description:This is a common element used to define the + locally assigned identifier associated with an + entity.
+ type: string + Name: + type: string + description:The name of the academic department.
+ Description: + type: string + description:Free text description providing more detail + about the academic department.
+ Provider: + description:A reference to another SIF Data Object
+ type: object + required: + - ObjectType + properties: + RefId: + $ref: "#/paths/~1AcademicDepartments/get/response\ + s/200/content/application~1json/schema/prop\ + erties/AcademicDepartments/properties/Acade\ + micDepartment/items/properties/AcademicDepa\ + rtmentRefId" + LocalId: + $ref: "#/paths/~1AcademicDepartments/get/response\ + s/200/content/application~1json/schema/prop\ + erties/AcademicDepartments/properties/Acade\ + micDepartment/items/properties/AcademicDepa\ + rtmentLocalId" + Name: + type: string + description:The normal descriptive name of the + referenced object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject + names, to be included in Object + References
A list of the staff members that belong to + the academic department.
+ type: object + required: + - StaffMember + properties: + StaffMember: + type: array + items: + description:The individual staff member as a member + of the StaffList and their role.
+ type: object + required: + - ObjectType + - Role + properties: + Role: + type: string + title: Staff Role + description: >- +Describes the role a staff member + has at a Provider or other + EducationOrganisation.
A list of the courses the academic department + manages.
+ type: object + required: + - Course + properties: + Course: + type: array + items: + $ref: "#/paths/~1AcademicDepartments/get/respon\ + ses/200/content/application~1json/schema/\ + properties/AcademicDepartments/properties\ + /AcademicDepartment/items/properties/Prov\ + ider" + SubjectAreaList: + description:A list of the subject areas the academic + department manages.
+ type: object + properties: + SubjectAreaList: + type: array + items: + SubjectArea: + type: string + title: Subject Area + description: >- +Codes denoting Subject Areas defined + by the NZ Curriculum and Te Marautanga o + Aotearoa.
Codes denoting Subject Areas defined + by the NZQA for NCEA.
Information about an academic department within + a provider, e.g. Maths Department.
+ x-accessControl: + create: + - 1001 + - 2401 + - 2403 + read: + - 1001 + - 2401 + - 2403 + update: + - 1001 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: [] + example: + AcademicDepartments: + AcademicDepartment: + - AcademicDepartmentRefId: 2FFB63B4-CFEF-4820-8501-E7D1E54555CB + Name: Science Department + Provider: + RefId: CA285746-359D-7510-1A8C-36432A901A16 + StaffList: + StaffMember: + - RefId: 44FB63B4-CFEF-4820-8501-E7D1E54555CB + Name: Bobby Test + application/xml: + schema: + type: object + properties: + AcademicDepartments: + type: object + description: A List of AcademicDepartment objects + properties: + AcademicDepartment: + type: array + items: + $ref: "#/paths/~1AcademicDepartments/get/responses/200/co\ + ntent/application~1json/schema/properties/AcademicD\ + epartments/properties/AcademicDepartment/items" + example: >- +The ID (GUID) assigned to uniquely identify this + AcademicDepartment.
+ required: true + schema: + type: string + operationId: createAcademicDepartment + requestBody: + description: CRUD operation on AcademicDepartment + content: + application/json: + schema: + type: object + properties: + AcademicDepartment: + $ref: "#/paths/~1AcademicDepartments/get/responses/200/content/ap\ + plication~1json/schema/properties/AcademicDepartments/prope\ + rties/AcademicDepartment/items" + example: + AcademicDepartment: + AcademicDepartmentRefId: 2FFB63B4-CFEF-4820-8501-E7D1E54555CB + Name: Science Department + Provider: + RefId: CA285746-359D-7510-1A8C-36432A901A16 + StaffList: + StaffMember: + - RefId: 44FB63B4-CFEF-4820-8501-E7D1E54555CB + Name: Bobby Test + application/xml: + schema: + type: object + properties: + AcademicDepartment: + $ref: "#/paths/~1AcademicDepartments/get/responses/200/content/ap\ + plication~1json/schema/properties/AcademicDepartments/prope\ + rties/AcademicDepartment/items" + example: >- +The ID (GUID) assigned to uniquely identify this + AcademicDepartment.
+ required: true + schema: + type: string + operationId: updateAcademicDepartment + requestBody: + description: CRUD operation on AcademicDepartment + content: + application/json: + schema: + type: object + properties: + AcademicDepartment: + type: object + properties: + AcademicDepartmentRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-\ + 9]{4}-[a-fA-F0-9]{12}" + AcademicDepartmentLocalId: + description:This is a common element used to define the locally + assigned identifier associated with an entity.
+ type: string + Name: + type: string + description:The name of the academic department.
+ Description: + type: string + description:Free text description providing more detail about the + academic department.
+ Provider: + description:A reference to another SIF Data Object
+ type: object + properties: + RefId: + $ref: "#/paths/~1AcademicDepartments~1%7BAcademicDepartme\ + ntRefId%7D/put/requestBody/content/application~1jso\ + n/schema/properties/AcademicDepartment/properties/A\ + cademicDepartmentRefId" + LocalId: + $ref: "#/paths/~1AcademicDepartments~1%7BAcademicDepartme\ + ntRefId%7D/put/requestBody/content/application~1jso\ + n/schema/properties/AcademicDepartment/properties/A\ + cademicDepartmentLocalId" + Name: + type: string + description:The normal descriptive name of the referenced + object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject names, to + be included in Object References
A list of the staff members that belong to the + academic department.
+ type: object + properties: + StaffMember: + type: array + items: + description:The individual staff member as a member of the + StaffList and their role.
+ type: object + properties: + Role: + type: string + title: Staff Role + description: >- +Describes the role a staff member has at a + Provider or other EducationOrganisation.
+A list of the courses the academic department + manages.
+ type: object + properties: + Course: + type: array + items: + $ref: "#/paths/~1AcademicDepartments~1%7BAcademicDepart\ + mentRefId%7D/put/requestBody/content/application~\ + 1json/schema/properties/AcademicDepartment/proper\ + ties/Provider" + SubjectAreaList: + description:A list of the subject areas the academic department + manages.
+ type: object + properties: + SubjectAreaList: + type: array + items: + SubjectArea: + type: string + title: Subject Area + description: >- +Codes denoting Subject Areas defined by the + NZ Curriculum and Te Marautanga o Aotearoa.
+Codes denoting Subject Areas defined by the + NZQA for NCEA.
Information about an academic department within a + provider, e.g. Maths Department.
+ x-accessControl: + create: + - 1001 + - 2401 + - 2403 + read: + - 1001 + - 2401 + - 2403 + update: + - 1001 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: [] + example: + AcademicDepartment: + AcademicDepartmentRefId: 2FFB63B4-CFEF-4820-8501-E7D1E54555CB + Name: Science Department + Provider: + RefId: CA285746-359D-7510-1A8C-36432A901A16 + StaffList: + StaffMember: + - RefId: 44FB63B4-CFEF-4820-8501-E7D1E54555CB + Name: Bobby Test + application/xml: + schema: + type: object + properties: + AcademicDepartment: + $ref: "#/paths/~1AcademicDepartments~1%7BAcademicDepartmentRefId%\ + 7D/put/requestBody/content/application~1json/schema/propert\ + ies/AcademicDepartment" + example: >- +The ID (GUID) assigned to uniquely identify this + AcademicDepartment.
+ required: true + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + AcademicDepartment: + $ref: "#/paths/~1AcademicDepartments/get/responses/200/content/\ + application~1json/schema/properties/AcademicDepartments/p\ + roperties/AcademicDepartment/items" + example: + AcademicDepartment: + AcademicDepartmentRefId: 2FFB63B4-CFEF-4820-8501-E7D1E54555CB + Name: Science Department + Provider: + RefId: CA285746-359D-7510-1A8C-36432A901A16 + StaffList: + StaffMember: + - RefId: 44FB63B4-CFEF-4820-8501-E7D1E54555CB + Name: Bobby Test + application/xml: + schema: + type: object + properties: + AcademicDepartment: + $ref: "#/paths/~1AcademicDepartments/get/responses/200/content/\ + application~1json/schema/properties/AcademicDepartments/p\ + roperties/AcademicDepartment/items" + example: >- +The ID (GUID) assigned to uniquely identify this + AcademicDepartment.
+ required: true + schema: + type: string + responses: + "200": + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + 200" + default: + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + default" + /StaffPersonals: + get: + tags: + - StaffPersonal + summary: Default operation to get a list of all available StaffPersonals + description: Search the set of available StaffPersonals, according to the search + criteria in the URL parameters. Returns the first 20 objects located; + with SIF defined navigation headers, indicating how to retrieve + subsequent sets of 20 objects. + parameters: + - name: LocalId + in: path + description: Search for object by LocalId, within the context of the organisation + represented by the ZoneId of the request. + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + StaffPersonals: + type: object + description: A List of StaffPersonal objects + properties: + StaffPersonal: + type: array + items: + required: + - PersonInfo + type: object + properties: + StaffPersonalRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[\ + a-fA-F0-9]{4}-[a-fA-F0-9]{12}" + StaffPersonalLocalId: + description:This is a common element used to define the + locally assigned identifier associated with an + entity.
+ type: string + ESLPairwiseId: + $ref: "#/paths/~1StaffPersonals/get/responses/200/con\ + tent/application~1json/schema/properties/StaffP\ + ersonals/properties/StaffPersonal/items/propert\ + ies/StaffPersonalLocalId" + SchoolSMSUserId: + $ref: "#/paths/~1StaffPersonals/get/responses/200/con\ + tent/application~1json/schema/properties/StaffP\ + ersonals/properties/StaffPersonal/items/propert\ + ies/StaffPersonalLocalId" + PersonInfo: + description:Personal Information
+ type: object + required: + - Name + properties: + Name: + description:A name used by the person
+ type: object + properties: + Title: + type: string + description:A title or prefix associated with the + name.
+ FamilyName: + type: string + description:Also known as Last Name, although + some cultures may not present a family + name as the last name.
+ GivenName: + type: string + description:Also known as First Name, although + some cultures may not present this name + as the first element in a name. May + contain a composite of all given + names.
+ MiddleName: + type: string + description:Where more than one Given Name, these + may be combined in one composite field + or else populated in several elements. +
+ FamilyNameFirst: + type: string + title: Yes Or No Category + description: >- +A reusable code set for yes, no, + unknown and not provided values.
+A preferred version of the Family + Name. Note:A name cannot have both a + Preferred Family and Preferred Given + Name within the same Name structure – + only one of these fields should be + populated. If a person does have both a + Preferred Family and Preferred Given + Name then this must be populated as a + separate Name of type ‘Preferred’.
+ PreferredFamilyNameFirst: + $ref: "#/paths/~1StaffPersonals/get/responses\ + /200/content/application~1json/schema/p\ + roperties/StaffPersonals/properties/Sta\ + ffPersonal/items/properties/PersonInfo/\ + properties/Name/properties/FamilyNameFi\ + rst" + PreferredGivenName: + type: string + description: "A preferred version of the Given + Name. Note: A name cannot have both a + Preferred Family and Preferred Given + Name within the same Name structure – + only one of these fields should be + populated. If a person does have both a + Preferred Family and Preferred Given + Name then this must be populated as a + separate Name of type ‘Preferred’.
" + Suffix: + type: string + description:Textual suffix like PHD, JP, BSc.
+ FullName: + type: string + description:A combination of all name elements as + one composite text element
+ Type: + type: string + title: Name Usage Type + description: >- +A standardised method of describing + the usage of a name by a person. Where a + person has more than one current name, + the usage type indicates which name may + be used according to the purpose.
+Code values are based on SIF + Australia 3.4.
The name by which an individual + prefers to be known and + addressed.
Only usage type + applicable for student name usage + (other types are not supported by + NSI).
+ enum: + - PRF + - title: Foreign Official Name + description:Included for future usage in NZ, + especially for tertiary + students.
+ enum: + - FON + - title: Previous name + enum: + - PRV + - title: Also Known As + description: AKA or Alias + enum: + - AKA + - title: Name at Birth + enum: + - BTH + - title: Legal Name + description:Legal Name or Official Name as + defined by the organisation which + collects it (legal name is not + defined in this standard)
+ enum: + - LGL + IsVerified: + $ref: "#/paths/~1StaffPersonals/get/responses\ + /200/content/application~1json/schema/p\ + roperties/StaffPersonals/properties/Sta\ + ffPersonal/items/properties/PersonInfo/\ + properties/Name/properties/FamilyNameFi\ + rst" + OtherNameList: + description:Previous, alternate or other names or + aliases associated with the person.
+ type: object + required: + - Name + properties: + Name: + type: array + items: + description:Extension of BaseNameType including + name verification data
+ type: object + properties: + Verification: + description:The verification event that + verified the person's name.
+ type: object + required: + - IsConfirmed + - Source + properties: + Source: + type: string + title: Verification Source + description: >- +Records the source of the + identity or eligibility + verification, that has been + made. Mostly it is merely a + record of the kind of document + that has been presented; but + occasionally it is down to + Principal or Ministry + discretion / approval.
+The serial number on the + document that was used to + verify the name or + birthdate.
+ DocumentExpiryDate: + type: string + format: date + description:The expiry date on the + document that was used to + verify the name or + birthdate.
+ IsConfirmed: + type: boolean + description:If true then verification + has been confirmed by MoE.
+ Timestamp: + description:The date & time that the + VerificationEvent took + place.
+ Provider: + description:A reference to another SIF + Data Object
+ type: object + required: + - ObjectType + properties: + RefId: + $ref: "#/paths/~1StaffPersonals\ + /get/responses/200/conten\ + t/application~1json/schem\ + a/properties/StaffPersona\ + ls/properties/StaffPerson\ + al/items/properties/Staff\ + PersonalRefId" + LocalId: + $ref: "#/paths/~1StaffPersonals\ + /get/responses/200/conten\ + t/application~1json/schem\ + a/properties/StaffPersona\ + ls/properties/StaffPerson\ + al/items/properties/Staff\ + PersonalLocalId" + Name: + type: string + description:The normal descriptive + name of the referenced + object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid + SIF DataObject names, to + be included in Object + References
The verified name of the person.
+ type: object + properties: + Verification: + description:The verification event that verified + the person's name.
+ type: object + required: + - IsConfirmed + - Source + properties: + Source: + $ref: "#/paths/~1StaffPersonals/get/respo\ + nses/200/content/application~1json/\ + schema/properties/StaffPersonals/pr\ + operties/StaffPersonal/items/proper\ + ties/PersonInfo/properties/OtherNam\ + eList/properties/Name/items/propert\ + ies/Verification/properties/Source" + DocumentSerialNumber: + type: string + description:The serial number on the document + that was used to verify the name or + birthdate.
+ DocumentExpiryDate: + type: string + format: date + description:The expiry date on the document + that was used to verify the name or + birthdate.
+ IsConfirmed: + type: boolean + description:If true then verification has + been confirmed by MoE.
+ Timestamp: + description:The date & time that the + VerificationEvent took place.
+ Provider: + $ref: "#/paths/~1StaffPersonals/get/respo\ + nses/200/content/application~1json/\ + schema/properties/StaffPersonals/pr\ + operties/StaffPersonal/items/proper\ + ties/PersonInfo/properties/OtherNam\ + eList/properties/Name/items/propert\ + ies/Verification/properties/Provide\ + r" + x-accessControl: + ? create + ? read + ? update + ? delete + ? aggregate + Demographics: + description:Details of the person’s demographic + properties
+ type: object + properties: + BirthDate: + type: string + format: date + description:The person's date of birth.
+ DateOfDeath: + type: string + format: date + description:The person's date of death.
+ PlaceOfBirth: + type: string + description:The person's place of birth - like + village, town, city etc.
+ CountryOfBirth: + type: string + title: 3166 Country + description: >- +A country is a geopolitical entity + recognised by the New Zealand + government. The term country may + include
Conforms to the International + Standard ISO 3166 Codes for the + Representation of Names of Countries and + their Subdivisions (ISO 3166-1:2013). + Education adopts the alpha-3 + representation of this standard.
+The citizenship or residency status + of a person, principally recorded in + order to determine eligibility for + education services hence limited to + indicating New Zealand, Australian or + Other residency.
Based on SIF + Australia + AUCodeSetsAustralianCitizenshipStatusType
+The verification event that verified + the residency status of the person. + Absence of a verification event + indicates that the residency was not + verified against an identity document. +
+ type: object + required: + - IsConfirmed + - Source + properties: + Source: + $ref: "#/paths/~1StaffPersonals/get/respo\ + nses/200/content/application~1json/\ + schema/properties/StaffPersonals/pr\ + operties/StaffPersonal/items/proper\ + ties/PersonInfo/properties/OtherNam\ + eList/properties/Name/items/propert\ + ies/Verification/properties/Source" + DocumentSerialNumber: + type: string + description:The serial number on the document + that was used to verify the name or + birthdate.
+ DocumentExpiryDate: + type: string + format: date + description:The expiry date on the document + that was used to verify the name or + birthdate.
+ IsConfirmed: + type: boolean + description:If true then verification has + been confirmed by MoE.
+ Timestamp: + description:The date & time that the + VerificationEvent took place.
+ Provider: + $ref: "#/paths/~1StaffPersonals/get/respo\ + nses/200/content/application~1json/\ + schema/properties/StaffPersonals/pr\ + operties/StaffPersonal/items/proper\ + ties/PersonInfo/properties/OtherNam\ + eList/properties/Name/items/propert\ + ies/Verification/properties/Provide\ + r" + Gender: + type: string + title: Gender + description: >- +A Person may identify as having a + Gender (or Gender Identity). Biological + sex and sexual orientation are related + but different concepts. Sourced from + Statistics NZ Standard for Gender + Identity
A language that an individual + uses to communicate.
+ type: object + required: + - Code + properties: + Code: + type: string + title: Language + description: >- +Language refers to + recognised human communication + systems, typically oral and/or + written. Sourced from + Statistics NZ - Language + Standard Classification 1999 + v2.0.0
A standardised method of + describing the usage of a + language by a person, + potentially indicating + capability and preference for + the language.
Specific dialect of a + person's language.
+ ProficiencyList: + description:A list of the person's + proficiency in the language in + regards to speaking, reading + and writing.
+ type: object + required: + - Proficiency + properties: + Proficiency: + type: array + items: + description:The person's + proficiency in the + language in regards to + speaking, reading and + writing.
+ type: object + required: + - Level + - Type + properties: + Level: + type: string + title: Language Proficiency + Level + description: >- +The language + proficiency + level.
Code set denoting + a type of language + proficiency, e.g. + speaking, writing + reading.
One or more ethnic groups with which + the person identifies.
+ type: object + required: + - Ethnicity + properties: + Ethnicity: + type: array + items: + description:An ethnic group with which the + person identifies, and if there is + more than one, their order of + preference.
+ type: object + required: + - Code + properties: + PreferenceOrderNumber: + type: integer + description:The order of preference for + the person's ethnicity.
+ Code: + type: string + title: Ethnicity + description: >- +Ethnicity is the ethnic + group or groups that people + identify with or feel they + belong to. Ethnicity is a + measure of cultural + affiliation, as opposed to + race, ancestry, nationality or + citizenship. Ethnicity is self + perceived and people can + belong to more than one ethnic + group.
The permissible + values consists of any value + from the Statistics NZ - + Ethnicity New Zealand Standard + Classification 2005 v2.0.0 + Depending on usage, ethnicity + may be defined at levels 1 to + 4.
A list of one or more iwi with which + the person has an affiliation.
+ type: object + required: + - IwiAffiliation + properties: + IwiAffiliation: + type: array + items: + type: string + title: Iwi + description: >- +An iwi, or Māori tribe, is one + of the largest kinship groupings + and is generally made up of + several hapū that are all + descended from a common ancestor. + Hapū are clusters of whānau where + the whānau is usually an extended + family grouping consisting of + children, parents, often + grandparents, and other closely + related kin.
Sourced from + Statistics NZ - Iwi and Iwi + related groups statistical + standard v1.0.0.0
A list of one or more religions with + which the person has an affiliation.
+ type: object + required: + - ReligiousAffiliation + properties: + ReligiousAffiliation: + type: array + items: + type: string + title: Religion + description: >- +Religious affiliation is the + self-identified association of a + person with a religion, + denomination or sub-denominational + religious group.
Sourced + from Statistics NZ - Religious + Affiliation 1999 v1.0.0.0
This element contains address + data.
+ type: object + required: + - Street + properties: + Type: + type: string + title: Address Type + description: >- +Address type allows an address + to be categorised according to its + component structure. Address type + can be used to build processing + rules for validating, managing and + presenting addresses. Address type + is independent of the use of the + address by any party. To describe + how a party may use an address + (residence, billing, term address + etc) see AddressRoleType
Also called 'Street' + addresses, The most general, + and widely used type of + address, and can contain the + widest variety of + components
In general a + thoroughfare address will + include components for a + number, a roadname, and a + locality.
They cannot + contain any of the components + specific to a delivery + service, rural post delivery, + or water address.
These + addresses are used to find a + location.
Example: 30 - + 40 Lambton Quay, Wellington, + 6165
\"" + enum: + - TH + - title: Rural Post Delivery + description: '"Defined by New Zealand + Post, these addresses are + assigned by NZ Post for + customers who purchase a rural + delivery service (mail and + also other goods).
They + will have the same number and + roadname components as the + street address, and may have + the same region component.
+They do not have a + component that identifies the + locality the address is + within. The locality and city + or town components are + replaced by components that + identify the rural delivery + route (RD number), and the + town from which the rural + delivery route starts and + finishes (the mail town). Only + addresses of this class can + contain these components.
+Example: 121 + Waitaha Road, RD 1, Ross, + 7885
"' + enum: + - RU + - title: Delivery Service + description: '"Defined by New Zealand + Post, and used exclusively for + NZ Post services other than + standard mail delivery. + Addresses in this class + include PO Box, Private Bag, + and Counter Delivery + addresses.
+ Example: Private Bag + 2345, Auckland, 1142
"' + enum: + - DE + - title: Water + description: '"Where properties have no + road access, but do have + access to water frontage + (coastline or riverbank or + lakefront), a water address + uses the name of a water + feature (for example, islands, + rivers, bays, or + peninsulas).
+ Example: 235 Lochmara + Bay, Queen Charlotte Sound, + Marlborough Sounds
"' + enum: + - WA + - title: Foreign Address + description: '"A foreign address + identifies a location outside + of New Zealand.
+ Example: + Rudolf-Diesel-Strasse 14, + 54595 Prüm, Germany
"' + enum: + - FO + Role: + type: string + title: Address Role + description: >- +A standardised description of + the role or usage of an address by + a party (person or organisation). + Where a party has more than one + address, this provides context for + deciding which address to use.
+The street element is a complex + element and breaks the street down + into several parts. (Allow for PO + Box here)
+ type: object + required: + - Line1 + properties: + Line1: + type: string + description:Address line 1.
+ Line2: + type: string + description:Address line 2.
+ Line3: + type: string + description:Address line 3.
+ Suburb: + type: string + description:The suburb part of urban + addresses, or the 'RD No' part of + rural addresses
+ City: + type: string + description:The city part of the + address.
+ StateProvince: + type: string + description:The state or province code. + StateTerritory Code only + applicable if a non-New Zealand + Address.
+ Country: + type: string + description:The country code.
+ PostalCode: + type: string + description:The ZIP/postal code.
+ GridLocation: + description:The latitude & longitude of the + location. Grid location values are + derived from New Zealand Map Grid + x,y coordinates and converted to + Latitude and Longitude values per + the World Geodetic System 1984 + (G1762)
+ type: object + required: + - Latitude + - Longitude + properties: + Latitude: + description:Latitude in decimal + degrees.
Latitudes + north of the equator are + positive, latitudes south of + the equator are negative [ISO + 6709].
+ Longitude: + description:Longitude in decimal + degrees.
Longitudes + east of the Prime Meridian in + Greenwich are positive, + longitudes west of the Prime + Meridian are negative. The + 180th meridian is negative. + [ISO 6709]
+ StatisticalAreaList: + description:A list of Statistical Areas + containing the location.
+The list may contain exactly + one StatisticalArea element for + each of the following spatial unit + types:
A particular statistical + area defined by Statistics + New Zealand.
+ type: object + required: + - Code + - SpatialUnitType + properties: + SpatialUnitType: + type: string + title: Spatial Unit Type + description: >- +A classification of + geographical boundaries + or statistical areas as + defined by Statistics + NZ’s geographic + hierarchy.
Area units are + aggregations of + meshblocks. They are + non–administrative + areas that are in + between meshblocks + and territorial + authorities in size. + Area units must + either define or + aggregate to define, + regional councils, + territorial + authorities and + urban areas.
+ Statistics NZ + Classification of + Area Unit 2013 + v1.0.0 + enum: + - AE + - title: General Electoral + District + description:The general + electoral districts + as constituted under + the Electoral Act + 1993.
Statistics + NZ General Electoral + District 2014 v1.0.0 + enum: + - GE + - title: Community Board + description:(aka Local Board + within Auckland) + Local boards provide + governance at the + local level within + Auckland Council. + They enable + democratic decision + making by, and on + behalf of + communities within + the local board + area.
Statistics + NZ Community Board + 2013 v1.0.0 + enum: + - CB + - title: Māori Electoral + District + description:Māori electoral + districts are the + voting districts for + parliamentary + elections for people + who choose to be on + the Māori Electoral + Roll.
Statistics + NZ Māori Electoral + District 2014 v1.0.0 + enum: + - ME + - title: Mesh Block + description:A meshblock is + the smallest + geographic unit for + which statistical + data is collected + and processed by + Statistics New + Zealand.
A + meshblock is defined + by a geographic + area, which can vary + in size from part of + a city block to a + large area of rural + land. Each meshblock + borders on another + to form a network + covering all of New + Zealand, including + coasts and inlets + and extending out to + the 200-mile + economic zone.
+ Statistics NZ + Statistical Standard + for Meshblock 2013 + v1.0.0 + enum: + - MB + - title: Regional Council + description:The top tier of + local government in + New Zealand, defined + by the Local + Government Act 2002, + which requires the + boundaries of + regions to conform + as far as possible + to one or more water + catchments. When + determining regional + boundaries, the + Local Government + Commission gave + consideration to + regional communities + of interest when + selecting water + catchments to be + included in a + region. It also + considered factors + such as natural + resource management, + land use planning + and environmental + matters.
+ Statistics NZ + Regional Council + 2013 v1.0.0 + enum: + - RC + - title: Territorial Authority + description:The second tier + of local government + in New Zealand, + defined under the + Local Government Act + 2002 as a city + council or district + council. There are + 67 territorial + authorities + consisting of 12 + city councils, 53 + districts, Auckland + Council, and Chatham + Islands Council.
+ Statistics NZ + Territorial + Authority 2013 + v1.0.0 + enum: + - TA + - title: Urban Area + description: '"Urban Areas are + statistically + defined areas with + no administrative or + legal basis. There + is a three part + hierarchical + sub-division of + urban areas into: + main urban areas, + secondary urban + areas, minor urban + areas. Together the + populations in main, + secondary and minor + urban areas comprise + the statistically + defined urban + population of New + Zealand. The urban + area classification + is designed to + identify + concentrated urban + or semi-urban + settlements without + the distortions of + administrative + boundaries.
+ Statistics NZ Urban + Area 2013 v2.0.0"' + enum: + - UA + - title: Ward + description:Wards are defined + under the Local + Electoral Act 2001 + and result from the + division, for + electoral purposes, + of the district of a + territorial + authority. The ward + system was designed + to allow for the + recognition of + communities within a + district and to + increase community + involvement in the + local government + system.
+ Statistics NZ Ward + 2013 v1.0.0 + enum: + - WA + Code: + type: string + description:A valid value defined + by the nominated spatial + unit type, defined by + Statistics New Zealand + in one of the following + statistical area + defintion standards:
+The person's e-mail address(es) - one or + more emails.
+ type: object + required: + - Email + properties: + Email: + type: array + items: + 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: object + required: + - Address + properties: + Type: + type: string + title: Email Type + description: >- +A standardised method of + describing an electronic mail + address used as contact method by + a party. Where a party has more + than one email address, this may + provide context for deciding which + email address to use.
The actual email address.
+ PhoneNumberList: + description:The person's phone number(s) - one or + more phone numbers.
+ type: object + required: + - PhoneNumber + properties: + PhoneNumber: + type: array + items: + description:This element represents a phone + number and occurs within objects such + as StudentPersonal, StaffPersonal, + etc.
+ type: object + required: + - Number + properties: + Type: + type: string + title: Telephone Number Type + description: >- +A standardised method of + describing a telecommunications + device used as contact method by a + party. Where a party has more than + one phone number, this may provide + context for deciding which number + to use.
Phone number. Free-form, but + typical New Zealand formats + include:
Phone number extension.
+ ListedStatus: + $ref: "#/paths/~1StaffPersonals/get/res\ + ponses/200/content/application~1j\ + son/schema/properties/StaffPerson\ + als/properties/StaffPersonal/item\ + s/properties/PersonInfo/propertie\ + s/Name/properties/FamilyNameFirst" + x-accessControl: + ? create + ? read + ? update + ? delete + ? aggregate + HouseholdContactInfoList: + description:The person's household/s contact + information. A list of one or more + household’s contact information.
+ type: object + required: + - HouseholdContactInfo + properties: + HouseholdContactInfo: + type: array + items: + description:Common element used to supply + information about a particular + household a person is a member of.
+ type: object + properties: + PreferenceNumber: + type: integer + description:Priority of Household Contact + in relation to this Person.
+ HouseholdContactId: + $ref: "#/paths/~1StaffPersonals/get/res\ + ponses/200/content/application~1j\ + son/schema/properties/StaffPerson\ + als/properties/StaffPersonal/item\ + s/properties/StaffPersonalLocalId" + HouseholdSalutation: + type: string + description:Salutation to be used in + addressing this household.
+ AddressList: + description:A list of Address elements.
+ type: object + required: + - Address + properties: + Address: + type: array + items: + description:This element contains + address data.
+ type: object + required: + - Street + properties: + Type: + $ref: "#/paths/~1StaffPersona\ + ls/get/responses/200/co\ + ntent/application~1json\ + /schema/properties/Staf\ + fPersonals/properties/S\ + taffPersonal/items/prop\ + erties/PersonInfo/prope\ + rties/AddressList/prope\ + rties/Address/items/pro\ + perties/Type" + Role: + $ref: "#/paths/~1StaffPersona\ + ls/get/responses/200/co\ + ntent/application~1json\ + /schema/properties/Staf\ + fPersonals/properties/S\ + taffPersonal/items/prop\ + erties/PersonInfo/prope\ + rties/AddressList/prope\ + rties/Address/items/pro\ + perties/Role" + Street: + description:The street element is + a complex element and + breaks the street down + into several parts. + (Allow for PO Box + here)
+ type: object + required: + - Line1 + properties: + Line1: + type: string + description:Address line + 1.
+ Line2: + type: string + description:Address line + 2.
+ Line3: + type: string + description:Address line + 3.
+ Suburb: + type: string + description:The suburb part of + urban addresses, or the + 'RD No' part of rural + addresses
+ City: + type: string + description:The city part of the + address.
+ StateProvince: + type: string + description:The state or province + code. StateTerritory + Code only applicable if + a non-New Zealand + Address.
+ Country: + type: string + description:The country code.
+ PostalCode: + type: string + description:The ZIP/postal + code.
+ GridLocation: + description:The latitude & + longitude of the + location. Grid location + values are derived from + New Zealand Map Grid x,y + coordinates and + converted to Latitude + and Longitude values per + the World Geodetic + System 1984 (G1762)
+ type: object + required: + - Latitude + - Longitude + properties: + Latitude: + description:Latitude in + decimal degrees.
+Latitudes north + of the equator are + positive, latitudes + south of the equator + are negative [ISO + 6709].
+ Longitude: + description:Longitude in + decimal degrees.
+Longitudes east + of the Prime + Meridian in + Greenwich are + positive, longitudes + west of the Prime + Meridian are + negative. The 180th + meridian is + negative. [ISO + 6709]
+ StatisticalAreaList: + description:A list of Statistical + Areas containing the + location.
The + list may contain exactly + one StatisticalArea + element for each of the + following spatial unit + types:
A particular + statistical area + defined by + Statistics New + Zealand.
+ type: object + required: + - Code + - SpatialUnitType + properties: + SpatialUnitType: + $ref: "#/paths/~1St\ + affPersonals/get/re\ + sponses/200/content\ + /application~1json/\ + schema/properties/S\ + taffPersonals/prope\ + rties/StaffPersonal\ + /items/properties/P\ + ersonInfo/propertie\ + s/AddressList/prope\ + rties/Address/items\ + /properties/Statist\ + icalAreaList/proper\ + ties/StatisticalAre\ + a/items/properties/\ + SpatialUnitType" + Code: + type: string + description:A valid + value defined by the + nominated spatial + unit type, defined + by Statistics New + Zealand in one of + the following + statistical area + defintion + standards:
List of Email elements.
+ type: object + required: + - Email + properties: + Email: + type: array + items: + 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: object + required: + - Address + properties: + Type: + $ref: "#/paths/~1StaffPersona\ + ls/get/responses/200/co\ + ntent/application~1json\ + /schema/properties/Staf\ + fPersonals/properties/S\ + taffPersonal/items/prop\ + erties/PersonInfo/prope\ + rties/EmailList/propert\ + ies/Email/items/propert\ + ies/Type" + Address: + type: string + description:The actual email + address.
+ PhoneNumberList: + description:List of PhoneNumber + elements.
+ type: object + required: + - PhoneNumber + properties: + PhoneNumber: + type: array + items: + description:This element represents a + phone number and occurs + within objects such as + StudentPersonal, + StaffPersonal, etc.
+ type: object + required: + - Number + properties: + Type: + $ref: "#/paths/~1StaffPersona\ + ls/get/responses/200/co\ + ntent/application~1json\ + /schema/properties/Staf\ + fPersonals/properties/S\ + taffPersonal/items/prop\ + erties/PersonInfo/prope\ + rties/PhoneNumberList/p\ + roperties/PhoneNumber/i\ + tems/properties/Type" + Number: + type: string + description: "Phone number. + Free-form, but typical + New Zealand formats + include:
Phone number + extension.
+ ListedStatus: + $ref: "#/paths/~1StaffPersona\ + ls/get/responses/200/co\ + ntent/application~1json\ + /schema/properties/Staf\ + fPersonals/properties/S\ + taffPersonal/items/prop\ + erties/PersonInfo/prope\ + rties/Name/properties/F\ + amilyNameFirst" + x-accessControl: + ? create + ? read + ? update + ? delete + ? aggregate + description:All the personal contact and demographic + information relating to a staff member, who might be + a teacher or other employee of a Provider.
+Non personal information relating to the staff + member's relationship with Providers is stored in + the StaffAssignment data object.
+ x-accessControl: + create: + - 1001 + - 2401 + - 2403 + read: + - 1001 + - 2401 + - 2403 + update: + - 1001 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: [] + example: + StaffPersonals: + StaffPersonal: + - StaffPersonalRefId: D3E34F41-9D75-101A-8C3D-00AA001A1652 + PersonInfo: + Name: + FamilyName: Smith + GivenName: Fred + FullName: Fred Smith + Type: LGL + IsVerified: Y + AddressList: + Address: + - Type: TH + Role: PHY + Street: + Line1: The Enchanted Wood + Line2: 533 Hogwart's Way + Suburb: RD 1 + City: Hogsmeade + PostalCode: 5780 + EmailList: + Email: + - Type: ALT1 + Address: fsmith@yahoo.com + - Type: PRIM + Address: freddy@gmail.com + PhoneNumberList: + PhoneNumber: + - Type: WTE + Number: 03 9637-2289 + Extension: 72289 + - Type: HTE + Number: 0437-765-234 + application/xml: + schema: + type: object + properties: + StaffPersonals: + type: object + description: A List of StaffPersonal objects + properties: + StaffPersonal: + type: array + items: + $ref: "#/paths/~1StaffPersonals/get/responses/200/content\ + /application~1json/schema/properties/StaffPersonals\ + /properties/StaffPersonal/items" + example: >- +The GUID of the staff member.
+ required: true + schema: + type: string + operationId: createStaffPersonal + requestBody: + description: CRUD operation on StaffPersonal + content: + application/json: + schema: + type: object + properties: + StaffPersonal: + $ref: "#/paths/~1StaffPersonals/get/responses/200/content/applica\ + tion~1json/schema/properties/StaffPersonals/properties/Staf\ + fPersonal/items" + example: + StaffPersonal: + StaffPersonalRefId: D3E34F41-9D75-101A-8C3D-00AA001A1652 + PersonInfo: + Name: + FamilyName: Smith + GivenName: Fred + FullName: Fred Smith + Type: LGL + IsVerified: Y + AddressList: + Address: + - Type: TH + Role: PHY + Street: + Line1: The Enchanted Wood + Line2: 533 Hogwart's Way + Suburb: RD 1 + City: Hogsmeade + PostalCode: 5780 + EmailList: + Email: + - Type: ALT1 + Address: fsmith@yahoo.com + - Type: PRIM + Address: freddy@gmail.com + PhoneNumberList: + PhoneNumber: + - Type: WTE + Number: 03 9637-2289 + Extension: 72289 + - Type: HTE + Number: 0437-765-234 + application/xml: + schema: + type: object + properties: + StaffPersonal: + $ref: "#/paths/~1StaffPersonals/get/responses/200/content/applica\ + tion~1json/schema/properties/StaffPersonals/properties/Staf\ + fPersonal/items" + example: >- +The GUID of the staff member.
+ required: true + schema: + type: string + operationId: updateStaffPersonal + requestBody: + description: CRUD operation on StaffPersonal + content: + application/json: + schema: + type: object + properties: + StaffPersonal: + type: object + properties: + StaffPersonalRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-\ + 9]{4}-[a-fA-F0-9]{12}" + StaffPersonalLocalId: + description:This is a common element used to define the locally + assigned identifier associated with an entity.
+ type: string + ESLPairwiseId: + $ref: "#/paths/~1StaffPersonals~1%7BStaffPersonalRefId%7D/put\ + /requestBody/content/application~1json/schema/propertie\ + s/StaffPersonal/properties/StaffPersonalLocalId" + SchoolSMSUserId: + $ref: "#/paths/~1StaffPersonals~1%7BStaffPersonalRefId%7D/put\ + /requestBody/content/application~1json/schema/propertie\ + s/StaffPersonal/properties/StaffPersonalLocalId" + PersonInfo: + description:Personal Information
+ type: object + properties: + Name: + description:A name used by the person
+ type: object + properties: + Title: + type: string + description:A title or prefix associated with the + name.
+ FamilyName: + type: string + description:Also known as Last Name, although some + cultures may not present a family name as the + last name.
+ GivenName: + type: string + description:Also known as First Name, although some + cultures may not present this name as the first + element in a name. May contain a composite of + all given names.
+ MiddleName: + type: string + description:Where more than one Given Name, these may be + combined in one composite field or else + populated in several elements.
+ FamilyNameFirst: + type: string + title: Yes Or No Category + description: >- +A reusable code set for yes, no, unknown and + not provided values.
A preferred version of the Family Name. + Note:A name cannot have both a Preferred Family + and Preferred Given Name within the same Name + structure – only one of these fields should be + populated. If a person does have both a + Preferred Family and Preferred Given Name then + this must be populated as a separate Name of + type ‘Preferred’.
+ PreferredFamilyNameFirst: + $ref: "#/paths/~1StaffPersonals~1%7BStaffPersonalRefI\ + d%7D/put/requestBody/content/application~1json/\ + schema/properties/StaffPersonal/properties/Pers\ + onInfo/properties/Name/properties/FamilyNameFir\ + st" + PreferredGivenName: + type: string + description: "A preferred version of the Given Name. Note: + A name cannot have both a Preferred Family and + Preferred Given Name within the same Name + structure – only one of these fields should be + populated. If a person does have both a + Preferred Family and Preferred Given Name then + this must be populated as a separate Name of + type ‘Preferred’.
" + Suffix: + type: string + description:Textual suffix like PHD, JP, BSc.
+ FullName: + type: string + description:A combination of all name elements as one + composite text element
+ Type: + type: string + title: Name Usage Type + description: >- +A standardised method of describing the usage + of a name by a person. Where a person has more + than one current name, the usage type indicates + which name may be used according to the + purpose.
Code values are based on SIF + Australia 3.4.
The name by which an individual prefers + to be known and addressed.
Only usage + type applicable for student name usage + (other types are not supported by NSI).
+ enum: + - PRF + - title: Foreign Official Name + description:Included for future usage in NZ, + especially for tertiary students.
+ enum: + - FON + - title: Previous name + enum: + - PRV + - title: Also Known As + description: AKA or Alias + enum: + - AKA + - title: Name at Birth + enum: + - BTH + - title: Legal Name + description:Legal Name or Official Name as defined by + the organisation which collects it (legal + name is not defined in this standard)
+ enum: + - LGL + IsVerified: + $ref: "#/paths/~1StaffPersonals~1%7BStaffPersonalRefI\ + d%7D/put/requestBody/content/application~1json/\ + schema/properties/StaffPersonal/properties/Pers\ + onInfo/properties/Name/properties/FamilyNameFir\ + st" + OtherNameList: + description:Previous, alternate or other names or aliases + associated with the person.
+ type: object + properties: + Name: + type: array + items: + description:Extension of BaseNameType including name + verification data
+ type: object + properties: + Verification: + description:The verification event that verified + the person's name.
+ type: object + properties: + Source: + type: string + title: Verification Source + description: >- +Records the source of the identity + or eligibility verification, that has + been made. Mostly it is merely a + record of the kind of document that + has been presented; but occasionally + it is down to Principal or Ministry + discretion / approval.
The serial number on the document + that was used to verify the name or + birthdate.
+ DocumentExpiryDate: + type: string + format: date + description:The expiry date on the document + that was used to verify the name or + birthdate.
+ IsConfirmed: + type: boolean + description:If true then verification has been + confirmed by MoE.
+ Timestamp: + description:The date & time that the + VerificationEvent took place.
+ Provider: + description:A reference to another SIF Data + Object
+ type: object + properties: + RefId: + $ref: "#/paths/~1StaffPersonals~1%7BSta\ + ffPersonalRefId%7D/put/requestBod\ + y/content/application~1json/schem\ + a/properties/StaffPersonal/proper\ + ties/StaffPersonalRefId" + LocalId: + $ref: "#/paths/~1StaffPersonals~1%7BSta\ + ffPersonalRefId%7D/put/requestBod\ + y/content/application~1json/schem\ + a/properties/StaffPersonal/proper\ + ties/StaffPersonalLocalId" + Name: + type: string + description:The normal descriptive name of + the referenced object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF + DataObject names, to be included + in Object References
The verified name of the person.
+ type: object + properties: + Verification: + description:The verification event that verified the + person's name.
+ type: object + properties: + Source: + $ref: "#/paths/~1StaffPersonals~1%7BStaffPersonal\ + RefId%7D/put/requestBody/content/applicatio\ + n~1json/schema/properties/StaffPersonal/pro\ + perties/PersonInfo/properties/OtherNameList\ + /properties/Name/items/properties/Verificat\ + ion/properties/Source" + DocumentSerialNumber: + type: string + description:The serial number on the document that + was used to verify the name or + birthdate.
+ DocumentExpiryDate: + type: string + format: date + description:The expiry date on the document that was + used to verify the name or birthdate.
+ IsConfirmed: + type: boolean + description:If true then verification has been + confirmed by MoE.
+ Timestamp: + description:The date & time that the + VerificationEvent took place.
+ Provider: + $ref: "#/paths/~1StaffPersonals~1%7BStaffPersonal\ + RefId%7D/put/requestBody/content/applicatio\ + n~1json/schema/properties/StaffPersonal/pro\ + perties/PersonInfo/properties/OtherNameList\ + /properties/Name/items/properties/Verificat\ + ion/properties/Provider" + x-accessControl: + ? create + ? read + ? update + ? delete + ? aggregate + Demographics: + description:Details of the person’s demographic properties
+ type: object + properties: + BirthDate: + type: string + format: date + description:The person's date of birth.
+ DateOfDeath: + type: string + format: date + description:The person's date of death.
+ PlaceOfBirth: + type: string + description:The person's place of birth - like village, + town, city etc.
+ CountryOfBirth: + type: string + title: 3166 Country + description: >- +A country is a geopolitical entity recognised + by the New Zealand government. The term country + may include
Conforms to + the International Standard ISO 3166 Codes for + the Representation of Names of Countries and + their Subdivisions (ISO 3166-1:2013). Education + adopts the alpha-3 representation of this + standard.
The citizenship or residency status of a + person, principally recorded in order to + determine eligibility for education services + hence limited to indicating New Zealand, + Australian or Other residency.
Based on + SIF Australia + AUCodeSetsAustralianCitizenshipStatusType
+The verification event that verified the + residency status of the person. Absence of a + verification event indicates that the residency + was not verified against an identity document. +
+ type: object + properties: + Source: + $ref: "#/paths/~1StaffPersonals~1%7BStaffPersonal\ + RefId%7D/put/requestBody/content/applicatio\ + n~1json/schema/properties/StaffPersonal/pro\ + perties/PersonInfo/properties/OtherNameList\ + /properties/Name/items/properties/Verificat\ + ion/properties/Source" + DocumentSerialNumber: + type: string + description:The serial number on the document that + was used to verify the name or + birthdate.
+ DocumentExpiryDate: + type: string + format: date + description:The expiry date on the document that was + used to verify the name or birthdate.
+ IsConfirmed: + type: boolean + description:If true then verification has been + confirmed by MoE.
+ Timestamp: + description:The date & time that the + VerificationEvent took place.
+ Provider: + $ref: "#/paths/~1StaffPersonals~1%7BStaffPersonal\ + RefId%7D/put/requestBody/content/applicatio\ + n~1json/schema/properties/StaffPersonal/pro\ + perties/PersonInfo/properties/OtherNameList\ + /properties/Name/items/properties/Verificat\ + ion/properties/Provider" + Gender: + type: string + title: Gender + description: >- +A Person may identify as having a Gender (or + Gender Identity). Biological sex and sexual + orientation are related but different concepts. + Sourced from Statistics NZ Standard for Gender + Identity
A language that an individual uses to + communicate.
+ type: object + properties: + Code: + type: string + title: Language + description: >- +Language refers to recognised human + communication systems, typically oral + and/or written. Sourced from + Statistics NZ - Language Standard + Classification 1999 v2.0.0
A standardised method of describing + the usage of a language by a person, + potentially indicating capability and + preference for the language.
Specific dialect of a person's + language.
+ ProficiencyList: + description:A list of the person's proficiency + in the language in regards to + speaking, reading and writing.
+ type: object + properties: + Proficiency: + type: array + items: + description:The person's proficiency in + the language in regards to + speaking, reading and + writing.
+ type: object + properties: + Level: + type: string + title: Language Proficiency Level + description: >- +The language proficiency + level.
Code set denoting a type + of language proficiency, + e.g. speaking, writing + reading.
One or more ethnic groups with which the + person identifies.
+ type: object + properties: + Ethnicity: + type: array + items: + description:An ethnic group with which the person + identifies, and if there is more than one, + their order of preference.
+ type: object + properties: + PreferenceOrderNumber: + type: integer + description:The order of preference for the + person's ethnicity.
+ Code: + type: string + title: Ethnicity + description: >- +Ethnicity is the ethnic group or + groups that people identify with or + feel they belong to. Ethnicity is a + measure of cultural affiliation, as + opposed to race, ancestry, nationality + or citizenship. Ethnicity is self + perceived and people can belong to + more than one ethnic group.
The + permissible values consists of any + value from the Statistics NZ - + Ethnicity New Zealand Standard + Classification 2005 v2.0.0 Depending + on usage, ethnicity may be defined at + levels 1 to 4.
A list of one or more iwi with which the + person has an affiliation.
+ type: object + properties: + IwiAffiliation: + type: array + items: + type: string + title: Iwi + description: >- +An iwi, or Māori tribe, is one of the + largest kinship groupings and is generally + made up of several hapū that are all + descended from a common ancestor. Hapū are + clusters of whānau where the whānau is + usually an extended family grouping + consisting of children, parents, often + grandparents, and other closely related + kin.
Sourced from Statistics NZ - + Iwi and Iwi related groups statistical + standard v1.0.0.0
A list of one or more religions with which + the person has an affiliation.
+ type: object + properties: + ReligiousAffiliation: + type: array + items: + type: string + title: Religion + description: >- +Religious affiliation is the + self-identified association of a person + with a religion, denomination or + sub-denominational religious group.
+Sourced from Statistics NZ - Religious + Affiliation 1999 v1.0.0.0
This element contains address data.
+ type: object + properties: + Type: + type: string + title: Address Type + description: >- +Address type allows an address to be + categorised according to its component + structure. Address type can be used to + build processing rules for validating, + managing and presenting addresses. Address + type is independent of the use of the + address by any party. To describe how a + party may use an address (residence, + billing, term address etc) see + AddressRoleType
Also called 'Street' addresses, + The most general, and widely used type + of address, and can contain the widest + variety of components
In + general a thoroughfare address will + include components for a number, a + roadname, and a locality.
They + cannot contain any of the components + specific to a delivery service, rural + post delivery, or water address.
+These addresses are used to find a + location.
Example: 30 - 40 + Lambton Quay, Wellington, 6165
\"" + enum: + - TH + - title: Rural Post Delivery + description: '"Defined by New Zealand Post, + these addresses are assigned by NZ + Post for customers who purchase a + rural delivery service (mail and also + other goods).
They will have + the same number and roadname + components as the street address, and + may have the same region + component.
They do not have a + component that identifies the locality + the address is within. The locality + and city or town components are + replaced by components that identify + the rural delivery route (RD number), + and the town from which the rural + delivery route starts and finishes + (the mail town). Only addresses of + this class can contain these + components.
Example: + 121 Waitaha Road, RD 1, Ross, + 7885
"' + enum: + - RU + - title: Delivery Service + description: '"Defined by New Zealand Post, and + used exclusively for NZ Post services + other than standard mail delivery. + Addresses in this class include PO + Box, Private Bag, and Counter Delivery + addresses.
Example: + Private Bag 2345, Auckland, 1142
"' + enum: + - DE + - title: Water + description: '"Where properties have no road + access, but do have access to water + frontage (coastline or riverbank or + lakefront), a water address uses the + name of a water feature (for example, + islands, rivers, bays, or + peninsulas).
Example: + 235 Lochmara Bay, Queen Charlotte + Sound, Marlborough Sounds
"' + enum: + - WA + - title: Foreign Address + description: '"A foreign address identifies a + location outside of New Zealand.
+Example: + Rudolf-Diesel-Strasse 14, 54595 Prüm, + Germany
"' + enum: + - FO + Role: + type: string + title: Address Role + description: >- +A standardised description of the role + or usage of an address by a party (person + or organisation). Where a party has more + than one address, this provides context + for deciding which address to use.
+The street element is a complex element + and breaks the street down into several + parts. (Allow for PO Box here)
+ type: object + properties: + Line1: + type: string + description:Address line 1.
+ Line2: + type: string + description:Address line 2.
+ Line3: + type: string + description:Address line 3.
+ Suburb: + type: string + description:The suburb part of urban addresses, or + the 'RD No' part of rural addresses
+ City: + type: string + description:The city part of the address.
+ StateProvince: + type: string + description:The state or province code. + StateTerritory Code only applicable if a + non-New Zealand Address.
+ Country: + type: string + description:The country code.
+ PostalCode: + type: string + description:The ZIP/postal code.
+ GridLocation: + description:The latitude & longitude of the + location. Grid location values are derived + from New Zealand Map Grid x,y coordinates + and converted to Latitude and Longitude + values per the World Geodetic System 1984 + (G1762)
+ type: object + properties: + Latitude: + description:Latitude in decimal degrees.
+Latitudes north of the equator are + positive, latitudes south of the + equator are negative [ISO 6709].
+ Longitude: + description:Longitude in decimal degrees.
+Longitudes east of the Prime + Meridian in Greenwich are positive, + longitudes west of the Prime Meridian + are negative. The 180th meridian is + negative. [ISO 6709]
+ StatisticalAreaList: + description:A list of Statistical Areas containing + the location.
The list may contain + exactly one StatisticalArea element for + each of the following spatial unit + types:
A particular statistical area + defined by Statistics New + Zealand.
+ type: object + properties: + SpatialUnitType: + type: string + title: Spatial Unit Type + description: >- +A classification of + geographical boundaries or + statistical areas as defined by + Statistics NZ’s geographic + hierarchy.
Area units are + aggregations of meshblocks. + They are non–administrative + areas that are in between + meshblocks and territorial + authorities in size. Area + units must either define or + aggregate to define, + regional councils, + territorial authorities and + urban areas.
Statistics + NZ Classification of Area + Unit 2013 v1.0.0 + enum: + - AE + - title: General Electoral District + description:The general electoral + districts as constituted + under the Electoral Act + 1993.
Statistics NZ + General Electoral District + 2014 v1.0.0 + enum: + - GE + - title: Community Board + description:(aka Local Board within + Auckland) Local boards + provide governance at the + local level within Auckland + Council. They enable + democratic decision making + by, and on behalf of + communities within the local + board area.
Statistics + NZ Community Board 2013 + v1.0.0 + enum: + - CB + - title: Māori Electoral District + description:Māori electoral districts + are the voting districts for + parliamentary elections for + people who choose to be on + the Māori Electoral + Roll.
Statistics NZ + Māori Electoral District + 2014 v1.0.0 + enum: + - ME + - title: Mesh Block + description:A meshblock is the + smallest geographic unit for + which statistical data is + collected and processed by + Statistics New Zealand.
+A meshblock is defined by + a geographic area, which can + vary in size from part of a + city block to a large area + of rural land. Each + meshblock borders on another + to form a network covering + all of New Zealand, + including coasts and inlets + and extending out to the + 200-mile economic zone.
+ Statistics NZ Statistical + Standard for Meshblock 2013 + v1.0.0 + enum: + - MB + - title: Regional Council + description:The top tier of local + government in New Zealand, + defined by the Local + Government Act 2002, which + requires the boundaries of + regions to conform as far as + possible to one or more + water catchments. When + determining regional + boundaries, the Local + Government Commission gave + consideration to regional + communities of interest when + selecting water catchments + to be included in a region. + It also considered factors + such as natural resource + management, land use + planning and environmental + matters.
Statistics NZ + Regional Council 2013 v1.0.0 + enum: + - RC + - title: Territorial Authority + description:The second tier of local + government in New Zealand, + defined under the Local + Government Act 2002 as a + city council or district + council. There are 67 + territorial authorities + consisting of 12 city + councils, 53 districts, + Auckland Council, and + Chatham Islands Council.
+ Statistics NZ Territorial + Authority 2013 v1.0.0 + enum: + - TA + - title: Urban Area + description: '"Urban Areas are + statistically defined areas + with no administrative or + legal basis. There is a + three part hierarchical + sub-division of urban areas + into: main urban areas, + secondary urban areas, minor + urban areas. Together the + populations in main, + secondary and minor urban + areas comprise the + statistically defined urban + population of New Zealand. + The urban area + classification is designed + to identify concentrated + urban or semi-urban + settlements without the + distortions of + administrative + boundaries.
Statistics + NZ Urban Area 2013 v2.0.0"' + enum: + - UA + - title: Ward + description:Wards are defined under + the Local Electoral Act 2001 + and result from the + division, for electoral + purposes, of the district of + a territorial authority. The + ward system was designed to + allow for the recognition of + communities within a + district and to increase + community involvement in the + local government system.
+ Statistics NZ Ward 2013 + v1.0.0 + enum: + - WA + Code: + type: string + description:A valid value defined by the + nominated spatial unit type, + defined by Statistics New + Zealand in one of the following + statistical area defintion + standards:
The person's e-mail address(es) - one or more + emails.
+ type: object + properties: + Email: + type: array + items: + 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: object + properties: + Type: + type: string + title: Email Type + description: >- +A standardised method of describing an + electronic mail address used as contact + method by a party. Where a party has more + than one email address, this may provide + context for deciding which email address + to use.
The actual email address.
+ PhoneNumberList: + description:The person's phone number(s) - one or more phone + numbers.
+ type: object + properties: + PhoneNumber: + type: array + items: + description:This element represents a phone number and + occurs within objects such as StudentPersonal, + StaffPersonal, etc.
+ type: object + properties: + Type: + type: string + title: Telephone Number Type + description: >- +A standardised method of describing a + telecommunications device used as contact + method by a party. Where a party has more + than one phone number, this may provide + context for deciding which number to + use.
Phone number. Free-form, but typical + New Zealand formats include:
Phone number extension.
+ ListedStatus: + $ref: "#/paths/~1StaffPersonals~1%7BStaffPerson\ + alRefId%7D/put/requestBody/content/applic\ + ation~1json/schema/properties/StaffPerson\ + al/properties/PersonInfo/properties/Name/\ + properties/FamilyNameFirst" + x-accessControl: + ? create + ? read + ? update + ? delete + ? aggregate + HouseholdContactInfoList: + description:The person's household/s contact information. A + list of one or more household’s contact + information.
+ type: object + properties: + HouseholdContactInfo: + type: array + items: + description:Common element used to supply information + about a particular household a person is a + member of.
+ type: object + properties: + PreferenceNumber: + type: integer + description:Priority of Household Contact in + relation to this Person.
+ HouseholdContactId: + $ref: "#/paths/~1StaffPersonals~1%7BStaffPerson\ + alRefId%7D/put/requestBody/content/applic\ + ation~1json/schema/properties/StaffPerson\ + al/properties/StaffPersonalLocalId" + HouseholdSalutation: + type: string + description:Salutation to be used in addressing + this household.
+ AddressList: + description:A list of Address elements.
+ type: object + properties: + Address: + type: array + items: + description:This element contains address + data.
+ type: object + properties: + Type: + $ref: "#/paths/~1StaffPersonals~1%7BS\ + taffPersonalRefId%7D/put/reques\ + tBody/content/application~1json\ + /schema/properties/StaffPersona\ + l/properties/PersonInfo/propert\ + ies/AddressList/properties/Addr\ + ess/items/properties/Type" + Role: + $ref: "#/paths/~1StaffPersonals~1%7BS\ + taffPersonalRefId%7D/put/reques\ + tBody/content/application~1json\ + /schema/properties/StaffPersona\ + l/properties/PersonInfo/propert\ + ies/AddressList/properties/Addr\ + ess/items/properties/Role" + Street: + description:The street element is a + complex element and breaks the + street down into several parts. + (Allow for PO Box here)
+ type: object + properties: + Line1: + type: string + description:Address line 1.
+ Line2: + type: string + description:Address line 2.
+ Line3: + type: string + description:Address line 3.
+ Suburb: + type: string + description:The suburb part of urban + addresses, or the 'RD No' part + of rural addresses
+ City: + type: string + description:The city part of the + address.
+ StateProvince: + type: string + description:The state or province code. + StateTerritory Code only + applicable if a non-New Zealand + Address.
+ Country: + type: string + description:The country code.
+ PostalCode: + type: string + description:The ZIP/postal code.
+ GridLocation: + description:The latitude & longitude of + the location. Grid location + values are derived from New + Zealand Map Grid x,y coordinates + and converted to Latitude and + Longitude values per the World + Geodetic System 1984 (G1762) +
+ type: object + properties: + Latitude: + description:Latitude in decimal + degrees.
Latitudes + north of the equator are + positive, latitudes south of + the equator are negative + [ISO 6709].
+ Longitude: + description:Longitude in decimal + degrees.
Longitudes + east of the Prime Meridian + in Greenwich are positive, + longitudes west of the Prime + Meridian are negative. The + 180th meridian is negative. + [ISO 6709]
+ StatisticalAreaList: + description:A list of Statistical Areas + containing the location.
+The list may contain exactly + one StatisticalArea element for + each of the following spatial + unit types:
A particular + statistical area defined + by Statistics New + Zealand.
+ type: object + properties: + SpatialUnitType: + $ref: "#/paths/~1StaffPerso\ + nals~1%7BStaffPersona\ + lRefId%7D/put/request\ + Body/content/applicat\ + ion~1json/schema/prop\ + erties/StaffPersonal/\ + properties/PersonInfo\ + /properties/AddressLi\ + st/properties/Address\ + /items/properties/Sta\ + tisticalAreaList/prop\ + erties/StatisticalAre\ + a/items/properties/Sp\ + atialUnitType" + Code: + type: string + description:A valid value + defined by the + nominated spatial unit + type, defined by + Statistics New Zealand + in one of the + following statistical + area defintion + standards:
List of Email elements.
+ type: object + properties: + Email: + type: array + items: + 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: object + properties: + Type: + $ref: "#/paths/~1StaffPersonals~1%7BS\ + taffPersonalRefId%7D/put/reques\ + tBody/content/application~1json\ + /schema/properties/StaffPersona\ + l/properties/PersonInfo/propert\ + ies/EmailList/properties/Email/\ + items/properties/Type" + Address: + type: string + description:The actual email address.
+ PhoneNumberList: + description:List of PhoneNumber elements.
+ type: object + properties: + PhoneNumber: + type: array + items: + description:This element represents a phone + number and occurs within objects + such as StudentPersonal, + StaffPersonal, etc.
+ type: object + properties: + Type: + $ref: "#/paths/~1StaffPersonals~1%7BS\ + taffPersonalRefId%7D/put/reques\ + tBody/content/application~1json\ + /schema/properties/StaffPersona\ + l/properties/PersonInfo/propert\ + ies/PhoneNumberList/properties/\ + PhoneNumber/items/properties/Ty\ + pe" + Number: + type: string + description: "Phone number. Free-form, but + typical New Zealand formats + include:
Phone number extension.
+ ListedStatus: + $ref: "#/paths/~1StaffPersonals~1%7BS\ + taffPersonalRefId%7D/put/reques\ + tBody/content/application~1json\ + /schema/properties/StaffPersona\ + l/properties/PersonInfo/propert\ + ies/Name/properties/FamilyNameF\ + irst" + x-accessControl: + ? create + ? read + ? update + ? delete + ? aggregate + description:All the personal contact and demographic information + relating to a staff member, who might be a teacher or other + employee of a Provider.
Non personal information + relating to the staff member's relationship with Providers + is stored in the StaffAssignment data object.
+ x-accessControl: + create: + - 1001 + - 2401 + - 2403 + read: + - 1001 + - 2401 + - 2403 + update: + - 1001 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: [] + example: + StaffPersonal: + StaffPersonalRefId: D3E34F41-9D75-101A-8C3D-00AA001A1652 + PersonInfo: + Name: + FamilyName: Smith + GivenName: Fred + FullName: Fred Smith + Type: LGL + IsVerified: Y + AddressList: + Address: + - Type: TH + Role: PHY + Street: + Line1: The Enchanted Wood + Line2: 533 Hogwart's Way + Suburb: RD 1 + City: Hogsmeade + PostalCode: 5780 + EmailList: + Email: + - Type: ALT1 + Address: fsmith@yahoo.com + - Type: PRIM + Address: freddy@gmail.com + PhoneNumberList: + PhoneNumber: + - Type: WTE + Number: 03 9637-2289 + Extension: 72289 + - Type: HTE + Number: 0437-765-234 + application/xml: + schema: + type: object + properties: + StaffPersonal: + $ref: "#/paths/~1StaffPersonals~1%7BStaffPersonalRefId%7D/put/req\ + uestBody/content/application~1json/schema/properties/StaffP\ + ersonal" + example: >- +The GUID of the staff member.
+ required: true + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + StaffPersonal: + $ref: "#/paths/~1StaffPersonals/get/responses/200/content/appli\ + cation~1json/schema/properties/StaffPersonals/properties/\ + StaffPersonal/items" + example: + StaffPersonal: + StaffPersonalRefId: D3E34F41-9D75-101A-8C3D-00AA001A1652 + PersonInfo: + Name: + FamilyName: Smith + GivenName: Fred + FullName: Fred Smith + Type: LGL + IsVerified: Y + AddressList: + Address: + - Type: TH + Role: PHY + Street: + Line1: The Enchanted Wood + Line2: 533 Hogwart's Way + Suburb: RD 1 + City: Hogsmeade + PostalCode: 5780 + EmailList: + Email: + - Type: ALT1 + Address: fsmith@yahoo.com + - Type: PRIM + Address: freddy@gmail.com + PhoneNumberList: + PhoneNumber: + - Type: WTE + Number: 03 9637-2289 + Extension: 72289 + - Type: HTE + Number: 0437-765-234 + application/xml: + schema: + type: object + properties: + StaffPersonal: + $ref: "#/paths/~1StaffPersonals/get/responses/200/content/appli\ + cation~1json/schema/properties/StaffPersonals/properties/\ + StaffPersonal/items" + example: >- +The GUID of the staff member.
+ required: true + schema: + type: string + responses: + "200": + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + 200" + default: + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + default" + /StaffAssignments: + get: + tags: + - StaffAssignment + summary: Default operation to get a list of all available StaffAssignments + description: Search the set of available StaffAssignments, according to the search + criteria in the URL parameters. Returns the first 20 objects located; + with SIF defined navigation headers, indicating how to retrieve + subsequent sets of 20 objects. + parameters: + - name: LocalId + in: path + description: Search for object by LocalId, within the context of the organisation + represented by the ZoneId of the request. + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + StaffAssignments: + type: object + description: A List of StaffAssignment objects + properties: + StaffAssignment: + type: array + items: + required: + - AssignedLocation + - CasualReliefTeacher + - EmploymentStatus + - StaffMember + - StartDate + type: object + properties: + StaffAssignmentRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[\ + a-fA-F0-9]{4}-[a-fA-F0-9]{12}" + StaffAssignmentLocalId: + description:This is a common element used to define the + locally assigned identifier associated with an + entity.
+ type: string + StaffMember: + description:A reference to another SIF Data Object
+ type: object + required: + - ObjectType + properties: + RefId: + $ref: "#/paths/~1StaffAssignments/get/responses/2\ + 00/content/application~1json/schema/propert\ + ies/StaffAssignments/properties/StaffAssign\ + ment/items/properties/StaffAssignmentRefId" + LocalId: + $ref: "#/paths/~1StaffAssignments/get/responses/2\ + 00/content/application~1json/schema/propert\ + ies/StaffAssignments/properties/StaffAssign\ + ment/items/properties/StaffAssignmentLocalI\ + d" + Name: + type: string + description:The normal descriptive name of the + referenced object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject + names, to be included in Object + References
Short description of the staff member's + assignment to the provider.
+ StaffRoleList: + description:The list of roles the StaffMember has in + relation to all students at the assigned + location.
+ type: object + required: + - StaffRole + properties: + StaffRole: + type: array + items: + description:A list of roles that are assigned to + the staff member.
+ type: object + required: + - Role + - StartDate + properties: + Role: + type: string + title: Staff Role + description: >- +Describes the role a staff member + has at a Provider or other + EducationOrganisation.
The date from which (inclusive) the + role was assigned to the staff + member.
+ EndDate: + type: string + format: date + description:The date after which the role is no + longer assigned to the staff + member.
+ StartDate: + type: string + format: date + description:This is the date from which the staff + assignment is valid (inclusive).
+ EndDate: + type: string + format: date + description:This is the date through which the staff + assignment is valid (inclusive). This can be + NULL when the staff member's assignment to a + particular role is open-ended.
+ CasualReliefTeacher: + type: string + title: Yes Or No Category + description: >- +A reusable code set for yes, no, unknown and + not provided values.
Describes the status of a staff member's + assignment at a Provider or other + EducationOrganisation.
The set of SubjectArea/LearningAreas the that + the staff member is responsible for. e.g. "Head + of Dept (Maths)" includes students learning any + flavour of Mathematics.
+ type: object + required: + - StaffSubject + properties: + StaffSubject: + type: array + items: + description:This element contains Staff subjects + they are eligible to teach together with + the teaching preference.
+ type: object + required: + - Code + properties: + PreferenceNumber: + type: integer + description:Priority of Subject to Teach.
+ Code: + type: string + title: Subject Area + description: >- +Codes denoting Subject Areas + defined by the NZ Curriculum and Te + Marautanga o Aotearoa.
Staff assignment to this particular + subject area / learning area applies + only for students enrolled in a + particular set of year levels. e.g. + "Asst. Head of Dept (Maths, Jnr)" + could ony be responsible for Students + in year levels 9 & 10, who are + learning Mathematics.
+ type: object + required: + - YearLevel + properties: + YearLevel: + type: array + items: + type: string + title: Year Level Code + description: >- +Year Level defines the values + that are valid for describing + Funding Year Level and Current + Year Level for a student + enrolment.
Current Year + Level indicates the year level + of the student’s class cohort + and the level at which the + student spends most of their + time at school. While a student + may be enrolled in subjects at + varying instructional year + levels, in relation to the + student enrolment this value + represents the year level at + which the student is considered + to be predominantly taught.
+Funding Year Level measures + the actual number of years that + the student has attended a + school. It provides the Ministry + with a method of counting + students for funding purposes + which is independent of the way + schools are organised or the + particular programme of study + that a student may undertake. + Funding Year Level for most + students is based on the date + they first started school.
+School Year Level is used to + indicate the instructional year + levels offered by a school, i.e. + those years for which student + enrolments may be accepted.
+The set of student Year Levels that the staff + member is responsible for. e.g. "Junior Student + Dean" could have responsibility for all students + in year levels 9 & 10.
+ type: object + required: + - YearLevel + properties: + YearLevel: + type: array + items: + $ref: "#/paths/~1StaffAssignments/get/responses\ + /200/content/application~1json/schema/pro\ + perties/StaffAssignments/properties/Staff\ + Assignment/items/properties/StaffSubjectL\ + ist/properties/StaffSubject/items/propert\ + ies/YearLevels/properties/YearLevel/items" + description:Records assignment of a Staff member to a + particular role at a Provider or other + EducationOrganisation. A staff member can have + multiple concurrent roles at Schools (via Provider + data object) and Kāhui Ako (via the + EducationOrganisation data object); each role would + be a separate StaffAssignment record.
Role + assignments can be restricted to categories of + Students with the StaffSubjectList and + YearLevelList. This allows for assignment to roles + with particular responsibility for general cohorts + of students, such as "Head of Department (Maths)" or + "Year 8 Student Dean".
While assignment to + student contact roles such as Subject Teacher, + Homeroom Teacher, Whānau Teacher or House Master is + made with this data object; Details of the + particular group of specific students the staff + member is responsible for are made via the + TeachingGroup data object.
+ x-accessControl: + create: + - 1001 + - 2401 + - 2403 + read: + - 1001 + - 2401 + - 2403 + update: + - 1001 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: [] + example: + StaffAssignments: + StaffAssignment: + - StaffAssignmentRefId: D3E34B35-9D75-101A-8C3D-00AA001A1652 + StaffMember: + RefId: D3E34B35-9D75-101A-8C3D-00AA001A1651 + AssignedLocation: + RefId: A8C3D3E3-4B35-9D75-101D-00AA001A1652 + LocalId: "203" + Name: Wellington College + ObjectType: Provider + Description: Senior English Teacher + StaffRoleList: + StaffRole: + Role: + - "1102" + StartDate: 2000-09-05 + EndDate: 2001-06-25 + CasualReliefTeacher: N + EmploymentStatus: A + StaffSubjectList: + StaffSubject: + - PreferenceNumber: 1 + Code: ENGL + YearLevels: + YearLevel: + - "11" + - "12" + - "13" + - PreferenceNumber: 2 + Code: HIST + application/xml: + schema: + type: object + properties: + StaffAssignments: + type: object + description: A List of StaffAssignment objects + properties: + StaffAssignment: + type: array + items: + $ref: "#/paths/~1StaffAssignments/get/responses/200/conte\ + nt/application~1json/schema/properties/StaffAssignm\ + ents/properties/StaffAssignment/items" + example: >- +The GUID that uniquely identifies a particular staff + assignment.
+ required: true + schema: + type: string + operationId: createStaffAssignment + requestBody: + description: CRUD operation on StaffAssignment + content: + application/json: + schema: + type: object + properties: + StaffAssignment: + $ref: "#/paths/~1StaffAssignments/get/responses/200/content/appli\ + cation~1json/schema/properties/StaffAssignments/properties/\ + StaffAssignment/items" + example: + StaffAssignment: + StaffAssignmentRefId: D3E34B35-9D75-101A-8C3D-00AA001A1652 + StaffMember: + RefId: D3E34B35-9D75-101A-8C3D-00AA001A1651 + AssignedLocation: + RefId: A8C3D3E3-4B35-9D75-101D-00AA001A1652 + LocalId: "203" + Name: Wellington College + ObjectType: Provider + Description: Senior English Teacher + StaffRoleList: + StaffRole: + Role: + - "1102" + StartDate: 2000-09-05 + EndDate: 2001-06-25 + CasualReliefTeacher: N + EmploymentStatus: A + StaffSubjectList: + StaffSubject: + - PreferenceNumber: 1 + Code: ENGL + YearLevels: + YearLevel: + - "11" + - "12" + - "13" + - PreferenceNumber: 2 + Code: HIST + application/xml: + schema: + type: object + properties: + StaffAssignment: + $ref: "#/paths/~1StaffAssignments/get/responses/200/content/appli\ + cation~1json/schema/properties/StaffAssignments/properties/\ + StaffAssignment/items" + example: >- +The GUID that uniquely identifies a particular staff + assignment.
+ required: true + schema: + type: string + operationId: updateStaffAssignment + requestBody: + description: CRUD operation on StaffAssignment + content: + application/json: + schema: + type: object + properties: + StaffAssignment: + type: object + properties: + StaffAssignmentRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-\ + 9]{4}-[a-fA-F0-9]{12}" + StaffAssignmentLocalId: + description:This is a common element used to define the locally + assigned identifier associated with an entity.
+ type: string + StaffMember: + description:A reference to another SIF Data Object
+ type: object + properties: + RefId: + $ref: "#/paths/~1StaffAssignments~1%7BStaffAssignmentRefI\ + d%7D/put/requestBody/content/application~1json/sche\ + ma/properties/StaffAssignment/properties/StaffAssig\ + nmentRefId" + LocalId: + $ref: "#/paths/~1StaffAssignments~1%7BStaffAssignmentRefI\ + d%7D/put/requestBody/content/application~1json/sche\ + ma/properties/StaffAssignment/properties/StaffAssig\ + nmentLocalId" + Name: + type: string + description:The normal descriptive name of the referenced + object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject names, to + be included in Object References
Short description of the staff member's assignment to + the provider.
+ StaffRoleList: + description:The list of roles the StaffMember has in relation to + all students at the assigned location.
+ type: object + properties: + StaffRole: + type: array + items: + description:A list of roles that are assigned to the staff + member.
+ type: object + properties: + Role: + type: string + title: Staff Role + description: >- +Describes the role a staff member has at a + Provider or other EducationOrganisation.
+The date from which (inclusive) the role + was assigned to the staff member.
+ EndDate: + type: string + format: date + description:The date after which the role is no longer + assigned to the staff member.
+ StartDate: + type: string + format: date + description:This is the date from which the staff assignment is + valid (inclusive).
+ EndDate: + type: string + format: date + description:This is the date through which the staff assignment + is valid (inclusive). This can be NULL when the staff + member's assignment to a particular role is + open-ended.
+ CasualReliefTeacher: + type: string + title: Yes Or No Category + description: >- +A reusable code set for yes, no, unknown and not + provided values.
Describes the status of a staff member's assignment + at a Provider or other EducationOrganisation.
The set of SubjectArea/LearningAreas the that the + staff member is responsible for. e.g. "Head of Dept + (Maths)" includes students learning any flavour of + Mathematics.
+ type: object + properties: + StaffSubject: + type: array + items: + description:This element contains Staff subjects they are + eligible to teach together with the teaching + preference.
+ type: object + properties: + PreferenceNumber: + type: integer + description:Priority of Subject to Teach.
+ Code: + type: string + title: Subject Area + description: >- +Codes denoting Subject Areas defined by the + NZ Curriculum and Te Marautanga o + Aotearoa.
Staff assignment to this particular subject + area / learning area applies only for students + enrolled in a particular set of year levels. + e.g. "Asst. Head of Dept (Maths, Jnr)" could + ony be responsible for Students in year levels + 9 & 10, who are learning Mathematics.
+ type: object + properties: + YearLevel: + type: array + items: + type: string + title: Year Level Code + description: >- +Year Level defines the values that + are valid for describing Funding Year + Level and Current Year Level for a + student enrolment.
Current Year + Level indicates the year level of the + student’s class cohort and the level at + which the student spends most of their + time at school. While a student may be + enrolled in subjects at varying + instructional year levels, in relation + to the student enrolment this value + represents the year level at which the + student is considered to be + predominantly taught.
Funding + Year Level measures the actual number of + years that the student has attended a + school. It provides the Ministry with a + method of counting students for funding + purposes which is independent of the way + schools are organised or the particular + programme of study that a student may + undertake. Funding Year Level for most + students is based on the date they first + started school.
School Year Level + is used to indicate the instructional + year levels offered by a school, i.e. + those years for which student enrolments + may be accepted.
The set of student Year Levels that the staff member + is responsible for. e.g. "Junior Student Dean" could + have responsibility for all students in year levels 9 & + 10.
+ type: object + properties: + YearLevel: + type: array + items: + $ref: "#/paths/~1StaffAssignments~1%7BStaffAssignmentRe\ + fId%7D/put/requestBody/content/application~1json/\ + schema/properties/StaffAssignment/properties/Staf\ + fSubjectList/properties/StaffSubject/items/proper\ + ties/YearLevels/properties/YearLevel/items" + description:Records assignment of a Staff member to a particular role + at a Provider or other EducationOrganisation. A staff member + can have multiple concurrent roles at Schools (via Provider + data object) and Kāhui Ako (via the EducationOrganisation + data object); each role would be a separate StaffAssignment + record.
Role assignments can be restricted to + categories of Students with the StaffSubjectList and + YearLevelList. This allows for assignment to roles with + particular responsibility for general cohorts of students, + such as "Head of Department (Maths)" or "Year 8 Student + Dean".
While assignment to student contact roles such + as Subject Teacher, Homeroom Teacher, Whānau Teacher or + House Master is made with this data object; Details of the + particular group of specific students the staff member is + responsible for are made via the TeachingGroup data + object.
+ x-accessControl: + create: + - 1001 + - 2401 + - 2403 + read: + - 1001 + - 2401 + - 2403 + update: + - 1001 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: [] + example: + StaffAssignment: + StaffAssignmentRefId: D3E34B35-9D75-101A-8C3D-00AA001A1652 + StaffMember: + RefId: D3E34B35-9D75-101A-8C3D-00AA001A1651 + AssignedLocation: + RefId: A8C3D3E3-4B35-9D75-101D-00AA001A1652 + LocalId: "203" + Name: Wellington College + ObjectType: Provider + Description: Senior English Teacher + StaffRoleList: + StaffRole: + Role: + - "1102" + StartDate: 2000-09-05 + EndDate: 2001-06-25 + CasualReliefTeacher: N + EmploymentStatus: A + StaffSubjectList: + StaffSubject: + - PreferenceNumber: 1 + Code: ENGL + YearLevels: + YearLevel: + - "11" + - "12" + - "13" + - PreferenceNumber: 2 + Code: HIST + application/xml: + schema: + type: object + properties: + StaffAssignment: + $ref: "#/paths/~1StaffAssignments~1%7BStaffAssignmentRefId%7D/put\ + /requestBody/content/application~1json/schema/properties/St\ + affAssignment" + example: >- +The GUID that uniquely identifies a particular staff + assignment.
+ required: true + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + StaffAssignment: + $ref: "#/paths/~1StaffAssignments/get/responses/200/content/app\ + lication~1json/schema/properties/StaffAssignments/propert\ + ies/StaffAssignment/items" + example: + StaffAssignment: + StaffAssignmentRefId: D3E34B35-9D75-101A-8C3D-00AA001A1652 + StaffMember: + RefId: D3E34B35-9D75-101A-8C3D-00AA001A1651 + AssignedLocation: + RefId: A8C3D3E3-4B35-9D75-101D-00AA001A1652 + LocalId: "203" + Name: Wellington College + ObjectType: Provider + Description: Senior English Teacher + StaffRoleList: + StaffRole: + Role: + - "1102" + StartDate: 2000-09-05 + EndDate: 2001-06-25 + CasualReliefTeacher: N + EmploymentStatus: A + StaffSubjectList: + StaffSubject: + - PreferenceNumber: 1 + Code: ENGL + YearLevels: + YearLevel: + - "11" + - "12" + - "13" + - PreferenceNumber: 2 + Code: HIST + application/xml: + schema: + type: object + properties: + StaffAssignment: + $ref: "#/paths/~1StaffAssignments/get/responses/200/content/app\ + lication~1json/schema/properties/StaffAssignments/propert\ + ies/StaffAssignment/items" + example: >- +The GUID that uniquely identifies a particular staff + assignment.
+ required: true + schema: + type: string + responses: + "200": + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + 200" + default: + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + default" + /StaffTeachingGroupAssignments: + get: + tags: + - StaffTeachingGroupAssignment + summary: Default operation to get a list of all available + StaffTeachingGroupAssignments + description: Search the set of available StaffTeachingGroupAssignments, according to + the search criteria in the URL parameters. Returns the first 20 objects + located; with SIF defined navigation headers, indicating how to retrieve + subsequent sets of 20 objects. + parameters: + - name: LocalId + in: path + description: Search for object by LocalId, within the context of the organisation + represented by the ZoneId of the request. + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + StaffTeachingGroupAssignments: + type: object + description: A List of StaffTeachingGroupAssignment objects + properties: + StaffTeachingGroupAssignment: + type: array + items: + required: + - Provider + - Role + - StaffMember + - StartDate + - TeachingGroup + type: object + properties: + StaffTeachingGroupAssignmentRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[\ + a-fA-F0-9]{4}-[a-fA-F0-9]{12}" + StaffTeachingGroupAssignmentLocalId: + description:This is a common element used to define the + locally assigned identifier associated with an + entity.
+ type: string + StaffMember: + description:A reference to another SIF Data Object
+ type: object + required: + - ObjectType + properties: + RefId: + $ref: "#/paths/~1StaffTeachingGroupAssignments/ge\ + t/responses/200/content/application~1json/s\ + chema/properties/StaffTeachingGroupAssignme\ + nts/properties/StaffTeachingGroupAssignment\ + /items/properties/StaffTeachingGroupAssignm\ + entRefId" + LocalId: + $ref: "#/paths/~1StaffTeachingGroupAssignments/ge\ + t/responses/200/content/application~1json/s\ + chema/properties/StaffTeachingGroupAssignme\ + nts/properties/StaffTeachingGroupAssignment\ + /items/properties/StaffTeachingGroupAssignm\ + entLocalId" + Name: + type: string + description:The normal descriptive name of the + referenced object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject + names, to be included in Object + References
Code set denoting the role the staff member + is performing within the teaching group, e.g. + Teacher, Teacher Aide, Student Teacher.
This is the date from which the staff + assignment is valid (inclusive).
+ EndDate: + type: string + format: date + description:This is the date through which the staff + assignment is valid (inclusive). This can be + NULL when the staff member's assignment to a + particular role is open-ended.
+ description:Records assignment of a Staff member to a + particular role with a particular TeachingGroup at a + Provider
+ x-accessControl: + create: + - 1001 + - 2401 + - 2403 + read: + - 1001 + - 2401 + - 2403 + update: + - 1001 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: [] + example: + StaffTeachingGroupAssignments: + StaffTeachingGroupAssignment: + - StaffTeachingGroupAssignmentRefId: 92828e71-c702-4944-841e-761203142ccd + StaffMember: + RefId: 6c12f5ae-ca86-40e2-b252-593154c8b967 + Provider: + RefId: f91cd380-2e14-43ef-b181-aedccea399f9 + TeachingGroup: + RefId: edc3ac19-264f-4734-b75b-6d56fbf84a18 + LocalId: 11FrenA + Name: Year 11 French, Stream A + Role: 1201 + StartDate: 2000-09-05 + EndDate: 2001-06-25 + application/xml: + schema: + type: object + properties: + StaffTeachingGroupAssignments: + type: object + description: A List of StaffTeachingGroupAssignment objects + properties: + StaffTeachingGroupAssignment: + type: array + items: + $ref: "#/paths/~1StaffTeachingGroupAssignments/get/respon\ + ses/200/content/application~1json/schema/properties\ + /StaffTeachingGroupAssignments/properties/StaffTeac\ + hingGroupAssignment/items" + example: >- +The GUID that uniquely identifies a particular staff teaching + group assignment.
+ required: true + schema: + type: string + operationId: createStaffTeachingGroupAssignment + requestBody: + description: CRUD operation on StaffTeachingGroupAssignment + content: + application/json: + schema: + type: object + properties: + StaffTeachingGroupAssignment: + $ref: "#/paths/~1StaffTeachingGroupAssignments/get/responses/200/\ + content/application~1json/schema/properties/StaffTeachingGr\ + oupAssignments/properties/StaffTeachingGroupAssignment/item\ + s" + example: + StaffTeachingGroupAssignment: + StaffTeachingGroupAssignmentRefId: 92828e71-c702-4944-841e-761203142ccd + StaffMember: + RefId: 6c12f5ae-ca86-40e2-b252-593154c8b967 + Provider: + RefId: f91cd380-2e14-43ef-b181-aedccea399f9 + TeachingGroup: + RefId: edc3ac19-264f-4734-b75b-6d56fbf84a18 + LocalId: 11FrenA + Name: Year 11 French, Stream A + Role: 1201 + StartDate: 2000-09-05 + EndDate: 2001-06-25 + application/xml: + schema: + type: object + properties: + StaffTeachingGroupAssignment: + $ref: "#/paths/~1StaffTeachingGroupAssignments/get/responses/200/\ + content/application~1json/schema/properties/StaffTeachingGr\ + oupAssignments/properties/StaffTeachingGroupAssignment/item\ + s" + example: >- +The GUID that uniquely identifies a particular staff teaching + group assignment.
+ required: true + schema: + type: string + operationId: updateStaffTeachingGroupAssignment + requestBody: + description: CRUD operation on StaffTeachingGroupAssignment + content: + application/json: + schema: + type: object + properties: + StaffTeachingGroupAssignment: + type: object + properties: + StaffTeachingGroupAssignmentRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-\ + 9]{4}-[a-fA-F0-9]{12}" + StaffTeachingGroupAssignmentLocalId: + description:This is a common element used to define the locally + assigned identifier associated with an entity.
+ type: string + StaffMember: + description:A reference to another SIF Data Object
+ type: object + properties: + RefId: + $ref: "#/paths/~1StaffTeachingGroupAssignments~1%7BStaffT\ + eachingGroupAssignmentRefId%7D/put/requestBody/cont\ + ent/application~1json/schema/properties/StaffTeachi\ + ngGroupAssignment/properties/StaffTeachingGroupAssi\ + gnmentRefId" + LocalId: + $ref: "#/paths/~1StaffTeachingGroupAssignments~1%7BStaffT\ + eachingGroupAssignmentRefId%7D/put/requestBody/cont\ + ent/application~1json/schema/properties/StaffTeachi\ + ngGroupAssignment/properties/StaffTeachingGroupAssi\ + gnmentLocalId" + Name: + type: string + description:The normal descriptive name of the referenced + object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject names, to + be included in Object References
Code set denoting the role the staff member is + performing within the teaching group, e.g. Teacher, + Teacher Aide, Student Teacher.
This is the date from which the staff assignment is + valid (inclusive).
+ EndDate: + type: string + format: date + description:This is the date through which the staff assignment + is valid (inclusive). This can be NULL when the staff + member's assignment to a particular role is + open-ended.
+ description:Records assignment of a Staff member to a particular role + with a particular TeachingGroup at a Provider
+ x-accessControl: + create: + - 1001 + - 2401 + - 2403 + read: + - 1001 + - 2401 + - 2403 + update: + - 1001 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: [] + example: + StaffTeachingGroupAssignment: + StaffTeachingGroupAssignmentRefId: 92828e71-c702-4944-841e-761203142ccd + StaffMember: + RefId: 6c12f5ae-ca86-40e2-b252-593154c8b967 + Provider: + RefId: f91cd380-2e14-43ef-b181-aedccea399f9 + TeachingGroup: + RefId: edc3ac19-264f-4734-b75b-6d56fbf84a18 + LocalId: 11FrenA + Name: Year 11 French, Stream A + Role: 1201 + StartDate: 2000-09-05 + EndDate: 2001-06-25 + application/xml: + schema: + type: object + properties: + StaffTeachingGroupAssignment: + $ref: "#/paths/~1StaffTeachingGroupAssignments~1%7BStaffTeachingG\ + roupAssignmentRefId%7D/put/requestBody/content/application~\ + 1json/schema/properties/StaffTeachingGroupAssignment" + example: >- +The GUID that uniquely identifies a particular staff teaching + group assignment.
+ required: true + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + StaffTeachingGroupAssignment: + $ref: "#/paths/~1StaffTeachingGroupAssignments/get/responses/20\ + 0/content/application~1json/schema/properties/StaffTeachi\ + ngGroupAssignments/properties/StaffTeachingGroupAssignmen\ + t/items" + example: + StaffTeachingGroupAssignment: + StaffTeachingGroupAssignmentRefId: 92828e71-c702-4944-841e-761203142ccd + StaffMember: + RefId: 6c12f5ae-ca86-40e2-b252-593154c8b967 + Provider: + RefId: f91cd380-2e14-43ef-b181-aedccea399f9 + TeachingGroup: + RefId: edc3ac19-264f-4734-b75b-6d56fbf84a18 + LocalId: 11FrenA + Name: Year 11 French, Stream A + Role: 1201 + StartDate: 2000-09-05 + EndDate: 2001-06-25 + application/xml: + schema: + type: object + properties: + StaffTeachingGroupAssignment: + $ref: "#/paths/~1StaffTeachingGroupAssignments/get/responses/20\ + 0/content/application~1json/schema/properties/StaffTeachi\ + ngGroupAssignments/properties/StaffTeachingGroupAssignmen\ + t/items" + example: >- +The GUID that uniquely identifies a particular staff teaching + group assignment.
+ required: true + schema: + type: string + responses: + "200": + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + 200" + default: + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + default" + /StudentPersonals: + get: + tags: + - StudentPersonal + summary: Default operation to get a list of all available StudentPersonals + description: Search the set of available StudentPersonals, according to the search + criteria in the URL parameters. Returns the first 20 objects located; + with SIF defined navigation headers, indicating how to retrieve + subsequent sets of 20 objects. + parameters: + - name: LocalId + in: path + description: Search for object by LocalId, within the context of the organisation + represented by the ZoneId of the request. + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + StudentPersonals: + type: object + description: A List of StudentPersonal objects + properties: + StudentPersonal: + type: array + items: + required: + - NationalStudentNumber + - PersonInfo + type: object + properties: + StudentPersonalRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[\ + a-fA-F0-9]{4}-[a-fA-F0-9]{12}" + StudentPersonalLocalId: + description:This is a common element used to define the + locally assigned identifier associated with an + entity.
+ type: string + NationalStudentNumber: + description:The unique identifier allocated to every + student in New Zealand, also known as the + NSN.
+ FirstNZSchoolingDate: + type: string + format: date + description:The date a student first ever started + schooling in New Zealand. This field is used to + establish most students’ Funding Year Level.
+ x-accessControl: + ? create + ? read + ? update + ? delete + ? aggregate + EarlyChildhoodEducation: + description:The type of early childhood education the + student received before enrolling in their first + school.
+ type: object + properties: + Type: + type: string + title: Early Childhood Education Type + description: >- +The type of early childhood education the + student received.
The total number of hours of early + childhood education attended, prior to + enrolling in their first school.
+ x-accessControl: + ? create + ? read + ? update + ? delete + ? aggregate + PersonInfo: + description:Personal Information
+ type: object + required: + - Name + properties: + Name: + description:A name used by the person
+ type: object + properties: + Title: + type: string + description:A title or prefix associated with the + name.
+ FamilyName: + type: string + description:Also known as Last Name, although + some cultures may not present a family + name as the last name.
+ GivenName: + type: string + description:Also known as First Name, although + some cultures may not present this name + as the first element in a name. May + contain a composite of all given + names.
+ MiddleName: + type: string + description:Where more than one Given Name, these + may be combined in one composite field + or else populated in several elements. +
+ FamilyNameFirst: + type: string + title: Yes Or No Category + description: >- +A reusable code set for yes, no, + unknown and not provided values.
+A preferred version of the Family + Name. Note:A name cannot have both a + Preferred Family and Preferred Given + Name within the same Name structure – + only one of these fields should be + populated. If a person does have both a + Preferred Family and Preferred Given + Name then this must be populated as a + separate Name of type ‘Preferred’.
+ PreferredFamilyNameFirst: + $ref: "#/paths/~1StudentPersonals/get/respons\ + es/200/content/application~1json/schema\ + /properties/StudentPersonals/properties\ + /StudentPersonal/items/properties/Perso\ + nInfo/properties/Name/properties/Family\ + NameFirst" + PreferredGivenName: + type: string + description: "A preferred version of the Given + Name. Note: A name cannot have both a + Preferred Family and Preferred Given + Name within the same Name structure – + only one of these fields should be + populated. If a person does have both a + Preferred Family and Preferred Given + Name then this must be populated as a + separate Name of type ‘Preferred’.
" + Suffix: + type: string + description:Textual suffix like PHD, JP, BSc.
+ FullName: + type: string + description:A combination of all name elements as + one composite text element
+ Type: + type: string + title: Name Usage Type + description: >- +A standardised method of describing + the usage of a name by a person. Where a + person has more than one current name, + the usage type indicates which name may + be used according to the purpose.
+Code values are based on SIF + Australia 3.4.
The name by which an individual + prefers to be known and + addressed.
Only usage type + applicable for student name usage + (other types are not supported by + NSI).
+ enum: + - PRF + - title: Foreign Official Name + description:Included for future usage in NZ, + especially for tertiary + students.
+ enum: + - FON + - title: Previous name + enum: + - PRV + - title: Also Known As + description: AKA or Alias + enum: + - AKA + - title: Name at Birth + enum: + - BTH + - title: Legal Name + description:Legal Name or Official Name as + defined by the organisation which + collects it (legal name is not + defined in this standard)
+ enum: + - LGL + IsVerified: + $ref: "#/paths/~1StudentPersonals/get/respons\ + es/200/content/application~1json/schema\ + /properties/StudentPersonals/properties\ + /StudentPersonal/items/properties/Perso\ + nInfo/properties/Name/properties/Family\ + NameFirst" + OtherNameList: + description:Previous, alternate or other names or + aliases associated with the person.
+ type: object + required: + - Name + properties: + Name: + type: array + items: + description:Extension of BaseNameType including + name verification data
+ type: object + properties: + Verification: + description:The verification event that + verified the person's name.
+ type: object + required: + - IsConfirmed + - Source + properties: + Source: + type: string + title: Verification Source + description: >- +Records the source of the + identity or eligibility + verification, that has been + made. Mostly it is merely a + record of the kind of document + that has been presented; but + occasionally it is down to + Principal or Ministry + discretion / approval.
+The serial number on the + document that was used to + verify the name or + birthdate.
+ DocumentExpiryDate: + type: string + format: date + description:The expiry date on the + document that was used to + verify the name or + birthdate.
+ IsConfirmed: + type: boolean + description:If true then verification + has been confirmed by MoE.
+ Timestamp: + description:The date & time that the + VerificationEvent took + place.
+ Provider: + description:A reference to another SIF + Data Object
+ type: object + required: + - ObjectType + properties: + RefId: + $ref: "#/paths/~1StudentPersona\ + ls/get/responses/200/cont\ + ent/application~1json/sch\ + ema/properties/StudentPer\ + sonals/properties/Student\ + Personal/items/properties\ + /StudentPersonalRefId" + LocalId: + $ref: "#/paths/~1StudentPersona\ + ls/get/responses/200/cont\ + ent/application~1json/sch\ + ema/properties/StudentPer\ + sonals/properties/Student\ + Personal/items/properties\ + /StudentPersonalLocalId" + Name: + type: string + description:The normal descriptive + name of the referenced + object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid + SIF DataObject names, to + be included in Object + References
The verified name of the person.
+ type: object + properties: + Verification: + description:The verification event that verified + the person's name.
+ type: object + required: + - IsConfirmed + - Source + properties: + Source: + $ref: "#/paths/~1StudentPersonals/get/res\ + ponses/200/content/application~1jso\ + n/schema/properties/StudentPersonal\ + s/properties/StudentPersonal/items/\ + properties/PersonInfo/properties/Ot\ + herNameList/properties/Name/items/p\ + roperties/Verification/properties/S\ + ource" + DocumentSerialNumber: + type: string + description:The serial number on the document + that was used to verify the name or + birthdate.
+ DocumentExpiryDate: + type: string + format: date + description:The expiry date on the document + that was used to verify the name or + birthdate.
+ IsConfirmed: + type: boolean + description:If true then verification has + been confirmed by MoE.
+ Timestamp: + description:The date & time that the + VerificationEvent took place.
+ Provider: + $ref: "#/paths/~1StudentPersonals/get/res\ + ponses/200/content/application~1jso\ + n/schema/properties/StudentPersonal\ + s/properties/StudentPersonal/items/\ + properties/PersonInfo/properties/Ot\ + herNameList/properties/Name/items/p\ + roperties/Verification/properties/P\ + rovider" + x-accessControl: + ? create + ? read + ? update + ? delete + ? aggregate + Demographics: + description:Details of the person’s demographic + properties
+ type: object + properties: + BirthDate: + type: string + format: date + description:The person's date of birth.
+ DateOfDeath: + type: string + format: date + description:The person's date of death.
+ x-accessControl: + ? create + ? read + ? update + ? delete + ? aggregate + PlaceOfBirth: + type: string + description:The person's place of birth - like + village, town, city etc.
+ x-accessControl: + ? create + ? read + ? update + ? delete + ? aggregate + CountryOfBirth: + type: string + title: 3166 Country + description: >- +A country is a geopolitical entity + recognised by the New Zealand + government. The term country may + include
Conforms to the International + Standard ISO 3166 Codes for the + Representation of Names of Countries and + their Subdivisions (ISO 3166-1:2013). + Education adopts the alpha-3 + representation of this standard.
+The citizenship or residency status + of a person, principally recorded in + order to determine eligibility for + education services hence limited to + indicating New Zealand, Australian or + Other residency.
Based on SIF + Australia + AUCodeSetsAustralianCitizenshipStatusType
+The verification event that verified + the residency status of the person. + Absence of a verification event + indicates that the residency was not + verified against an identity document. +
+ type: object + required: + - IsConfirmed + - Source + properties: + Source: + $ref: "#/paths/~1StudentPersonals/get/res\ + ponses/200/content/application~1jso\ + n/schema/properties/StudentPersonal\ + s/properties/StudentPersonal/items/\ + properties/PersonInfo/properties/Ot\ + herNameList/properties/Name/items/p\ + roperties/Verification/properties/S\ + ource" + DocumentSerialNumber: + type: string + description:The serial number on the document + that was used to verify the name or + birthdate.
+ DocumentExpiryDate: + type: string + format: date + description:The expiry date on the document + that was used to verify the name or + birthdate.
+ IsConfirmed: + type: boolean + description:If true then verification has + been confirmed by MoE.
+ Timestamp: + description:The date & time that the + VerificationEvent took place.
+ Provider: + $ref: "#/paths/~1StudentPersonals/get/res\ + ponses/200/content/application~1jso\ + n/schema/properties/StudentPersonal\ + s/properties/StudentPersonal/items/\ + properties/PersonInfo/properties/Ot\ + herNameList/properties/Name/items/p\ + roperties/Verification/properties/P\ + rovider" + x-accessControl: + ? create + ? read + ? update + ? delete + ? aggregate + Gender: + type: string + title: Gender + description: >- +A Person may identify as having a + Gender (or Gender Identity). Biological + sex and sexual orientation are related + but different concepts. Sourced from + Statistics NZ Standard for Gender + Identity
A language that an individual + uses to communicate.
+ type: object + required: + - Code + properties: + Code: + type: string + title: Language + description: >- +Language refers to + recognised human communication + systems, typically oral and/or + written. Sourced from + Statistics NZ - Language + Standard Classification 1999 + v2.0.0
A standardised method of + describing the usage of a + language by a person, + potentially indicating + capability and preference for + the language.
Specific dialect of a + person's language.
+ ProficiencyList: + description:A list of the person's + proficiency in the language in + regards to speaking, reading + and writing.
+ type: object + required: + - Proficiency + properties: + Proficiency: + type: array + items: + description:The person's + proficiency in the + language in regards to + speaking, reading and + writing.
+ type: object + required: + - Level + - Type + properties: + Level: + type: string + title: Language Proficiency + Level + description: >- +The language + proficiency + level.
Code set denoting + a type of language + proficiency, e.g. + speaking, writing + reading.
One or more ethnic groups with which + the person identifies.
+ type: object + required: + - Ethnicity + properties: + Ethnicity: + type: array + items: + description:An ethnic group with which the + person identifies, and if there is + more than one, their order of + preference.
+ type: object + required: + - Code + properties: + PreferenceOrderNumber: + type: integer + description:The order of preference for + the person's ethnicity.
+ Code: + type: string + title: Ethnicity + description: >- +Ethnicity is the ethnic + group or groups that people + identify with or feel they + belong to. Ethnicity is a + measure of cultural + affiliation, as opposed to + race, ancestry, nationality or + citizenship. Ethnicity is self + perceived and people can + belong to more than one ethnic + group.
The permissible + values consists of any value + from the Statistics NZ - + Ethnicity New Zealand Standard + Classification 2005 v2.0.0 + Depending on usage, ethnicity + may be defined at levels 1 to + 4.
A list of one or more iwi with which + the person has an affiliation.
+ type: object + required: + - IwiAffiliation + properties: + IwiAffiliation: + type: array + items: + type: string + title: Iwi + description: >- +An iwi, or Māori tribe, is one + of the largest kinship groupings + and is generally made up of + several hapū that are all + descended from a common ancestor. + Hapū are clusters of whānau where + the whānau is usually an extended + family grouping consisting of + children, parents, often + grandparents, and other closely + related kin.
Sourced from + Statistics NZ - Iwi and Iwi + related groups statistical + standard v1.0.0.0
A list of one or more religions with + which the person has an affiliation.
+ type: object + required: + - ReligiousAffiliation + properties: + ReligiousAffiliation: + type: array + items: + type: string + title: Religion + description: >- +Religious affiliation is the + self-identified association of a + person with a religion, + denomination or sub-denominational + religious group.
Sourced + from Statistics NZ - Religious + Affiliation 1999 v1.0.0.0
This element contains address + data.
+ type: object + required: + - Street + properties: + Type: + type: string + title: Address Type + description: >- +Address type allows an address + to be categorised according to its + component structure. Address type + can be used to build processing + rules for validating, managing and + presenting addresses. Address type + is independent of the use of the + address by any party. To describe + how a party may use an address + (residence, billing, term address + etc) see AddressRoleType
Also called 'Street' + addresses, The most general, + and widely used type of + address, and can contain the + widest variety of + components
In general a + thoroughfare address will + include components for a + number, a roadname, and a + locality.
They cannot + contain any of the components + specific to a delivery + service, rural post delivery, + or water address.
These + addresses are used to find a + location.
Example: 30 - + 40 Lambton Quay, Wellington, + 6165
\"" + enum: + - TH + - title: Rural Post Delivery + description: '"Defined by New Zealand + Post, these addresses are + assigned by NZ Post for + customers who purchase a rural + delivery service (mail and + also other goods).
They + will have the same number and + roadname components as the + street address, and may have + the same region component.
+They do not have a + component that identifies the + locality the address is + within. The locality and city + or town components are + replaced by components that + identify the rural delivery + route (RD number), and the + town from which the rural + delivery route starts and + finishes (the mail town). Only + addresses of this class can + contain these components.
+Example: 121 + Waitaha Road, RD 1, Ross, + 7885
"' + enum: + - RU + - title: Delivery Service + description: '"Defined by New Zealand + Post, and used exclusively for + NZ Post services other than + standard mail delivery. + Addresses in this class + include PO Box, Private Bag, + and Counter Delivery + addresses.
+ Example: Private Bag + 2345, Auckland, 1142
"' + enum: + - DE + - title: Water + description: '"Where properties have no + road access, but do have + access to water frontage + (coastline or riverbank or + lakefront), a water address + uses the name of a water + feature (for example, islands, + rivers, bays, or + peninsulas).
+ Example: 235 Lochmara + Bay, Queen Charlotte Sound, + Marlborough Sounds
"' + enum: + - WA + - title: Foreign Address + description: '"A foreign address + identifies a location outside + of New Zealand.
+ Example: + Rudolf-Diesel-Strasse 14, + 54595 Prüm, Germany
"' + enum: + - FO + Role: + type: string + title: Address Role + description: >- +A standardised description of + the role or usage of an address by + a party (person or organisation). + Where a party has more than one + address, this provides context for + deciding which address to use.
+The street element is a complex + element and breaks the street down + into several parts. (Allow for PO + Box here)
+ type: object + required: + - Line1 + properties: + Line1: + type: string + description:Address line 1.
+ Line2: + type: string + description:Address line 2.
+ Line3: + type: string + description:Address line 3.
+ Suburb: + type: string + description:The suburb part of urban + addresses, or the 'RD No' part of + rural addresses
+ City: + type: string + description:The city part of the + address.
+ StateProvince: + type: string + description:The state or province code. + StateTerritory Code only + applicable if a non-New Zealand + Address.
+ Country: + type: string + description:The country code.
+ PostalCode: + type: string + description:The ZIP/postal code.
+ GridLocation: + description:The latitude & longitude of the + location. Grid location values are + derived from New Zealand Map Grid + x,y coordinates and converted to + Latitude and Longitude values per + the World Geodetic System 1984 + (G1762)
+ type: object + required: + - Latitude + - Longitude + properties: + Latitude: + description:Latitude in decimal + degrees.
Latitudes + north of the equator are + positive, latitudes south of + the equator are negative [ISO + 6709].
+ Longitude: + description:Longitude in decimal + degrees.
Longitudes + east of the Prime Meridian in + Greenwich are positive, + longitudes west of the Prime + Meridian are negative. The + 180th meridian is negative. + [ISO 6709]
+ StatisticalAreaList: + description:A list of Statistical Areas + containing the location.
+The list may contain exactly + one StatisticalArea element for + each of the following spatial unit + types:
A particular statistical + area defined by Statistics + New Zealand.
+ type: object + required: + - Code + - SpatialUnitType + properties: + SpatialUnitType: + type: string + title: Spatial Unit Type + description: >- +A classification of + geographical boundaries + or statistical areas as + defined by Statistics + NZ’s geographic + hierarchy.
Area units are + aggregations of + meshblocks. They are + non–administrative + areas that are in + between meshblocks + and territorial + authorities in size. + Area units must + either define or + aggregate to define, + regional councils, + territorial + authorities and + urban areas.
+ Statistics NZ + Classification of + Area Unit 2013 + v1.0.0 + enum: + - AE + - title: General Electoral + District + description:The general + electoral districts + as constituted under + the Electoral Act + 1993.
Statistics + NZ General Electoral + District 2014 v1.0.0 + enum: + - GE + - title: Community Board + description:(aka Local Board + within Auckland) + Local boards provide + governance at the + local level within + Auckland Council. + They enable + democratic decision + making by, and on + behalf of + communities within + the local board + area.
Statistics + NZ Community Board + 2013 v1.0.0 + enum: + - CB + - title: Māori Electoral + District + description:Māori electoral + districts are the + voting districts for + parliamentary + elections for people + who choose to be on + the Māori Electoral + Roll.
Statistics + NZ Māori Electoral + District 2014 v1.0.0 + enum: + - ME + - title: Mesh Block + description:A meshblock is + the smallest + geographic unit for + which statistical + data is collected + and processed by + Statistics New + Zealand.
A + meshblock is defined + by a geographic + area, which can vary + in size from part of + a city block to a + large area of rural + land. Each meshblock + borders on another + to form a network + covering all of New + Zealand, including + coasts and inlets + and extending out to + the 200-mile + economic zone.
+ Statistics NZ + Statistical Standard + for Meshblock 2013 + v1.0.0 + enum: + - MB + - title: Regional Council + description:The top tier of + local government in + New Zealand, defined + by the Local + Government Act 2002, + which requires the + boundaries of + regions to conform + as far as possible + to one or more water + catchments. When + determining regional + boundaries, the + Local Government + Commission gave + consideration to + regional communities + of interest when + selecting water + catchments to be + included in a + region. It also + considered factors + such as natural + resource management, + land use planning + and environmental + matters.
+ Statistics NZ + Regional Council + 2013 v1.0.0 + enum: + - RC + - title: Territorial Authority + description:The second tier + of local government + in New Zealand, + defined under the + Local Government Act + 2002 as a city + council or district + council. There are + 67 territorial + authorities + consisting of 12 + city councils, 53 + districts, Auckland + Council, and Chatham + Islands Council.
+ Statistics NZ + Territorial + Authority 2013 + v1.0.0 + enum: + - TA + - title: Urban Area + description: '"Urban Areas are + statistically + defined areas with + no administrative or + legal basis. There + is a three part + hierarchical + sub-division of + urban areas into: + main urban areas, + secondary urban + areas, minor urban + areas. Together the + populations in main, + secondary and minor + urban areas comprise + the statistically + defined urban + population of New + Zealand. The urban + area classification + is designed to + identify + concentrated urban + or semi-urban + settlements without + the distortions of + administrative + boundaries.
+ Statistics NZ Urban + Area 2013 v2.0.0"' + enum: + - UA + - title: Ward + description:Wards are defined + under the Local + Electoral Act 2001 + and result from the + division, for + electoral purposes, + of the district of a + territorial + authority. The ward + system was designed + to allow for the + recognition of + communities within a + district and to + increase community + involvement in the + local government + system.
+ Statistics NZ Ward + 2013 v1.0.0 + enum: + - WA + Code: + type: string + description:A valid value defined + by the nominated spatial + unit type, defined by + Statistics New Zealand + in one of the following + statistical area + defintion standards:
+The person's e-mail address(es) - one or + more emails.
+ type: object + required: + - Email + properties: + Email: + type: array + items: + 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: object + required: + - Address + properties: + Type: + type: string + title: Email Type + description: >- +A standardised method of + describing an electronic mail + address used as contact method by + a party. Where a party has more + than one email address, this may + provide context for deciding which + email address to use.
The actual email address.
+ PhoneNumberList: + description:The person's phone number(s) - one or + more phone numbers.
+ type: object + required: + - PhoneNumber + properties: + PhoneNumber: + type: array + items: + description:This element represents a phone + number and occurs within objects such + as StudentPersonal, StaffPersonal, + etc.
+ type: object + required: + - Number + properties: + Type: + type: string + title: Telephone Number Type + description: >- +A standardised method of + describing a telecommunications + device used as contact method by a + party. Where a party has more than + one phone number, this may provide + context for deciding which number + to use.
Phone number. Free-form, but + typical New Zealand formats + include:
Phone number extension.
+ ListedStatus: + $ref: "#/paths/~1StudentPersonals/get/r\ + esponses/200/content/application~\ + 1json/schema/properties/StudentPe\ + rsonals/properties/StudentPersona\ + l/items/properties/PersonInfo/pro\ + perties/Name/properties/FamilyNam\ + eFirst" + HouseholdContactInfoList: + description:The person's household/s contact + information. A list of one or more + household’s contact information.
+ type: object + required: + - HouseholdContactInfo + properties: + HouseholdContactInfo: + type: array + items: + description:Common element used to supply + information about a particular + household a person is a member of.
+ type: object + properties: + PreferenceNumber: + type: integer + description:Priority of Household Contact + in relation to this Person.
+ HouseholdContactId: + $ref: "#/paths/~1StudentPersonals/get/r\ + esponses/200/content/application~\ + 1json/schema/properties/StudentPe\ + rsonals/properties/StudentPersona\ + l/items/properties/StudentPersona\ + lLocalId" + HouseholdSalutation: + type: string + description:Salutation to be used in + addressing this household.
+ AddressList: + description:A list of Address elements.
+ type: object + required: + - Address + properties: + Address: + type: array + items: + description:This element contains + address data.
+ type: object + required: + - Street + properties: + Type: + $ref: "#/paths/~1StudentPerso\ + nals/get/responses/200/\ + content/application~1js\ + on/schema/properties/St\ + udentPersonals/properti\ + es/StudentPersonal/item\ + s/properties/PersonInfo\ + /properties/AddressList\ + /properties/Address/ite\ + ms/properties/Type" + Role: + $ref: "#/paths/~1StudentPerso\ + nals/get/responses/200/\ + content/application~1js\ + on/schema/properties/St\ + udentPersonals/properti\ + es/StudentPersonal/item\ + s/properties/PersonInfo\ + /properties/AddressList\ + /properties/Address/ite\ + ms/properties/Role" + Street: + description:The street element is + a complex element and + breaks the street down + into several parts. + (Allow for PO Box + here)
+ type: object + required: + - Line1 + properties: + Line1: + type: string + description:Address line + 1.
+ Line2: + type: string + description:Address line + 2.
+ Line3: + type: string + description:Address line + 3.
+ Suburb: + type: string + description:The suburb part of + urban addresses, or the + 'RD No' part of rural + addresses
+ City: + type: string + description:The city part of the + address.
+ StateProvince: + type: string + description:The state or province + code. StateTerritory + Code only applicable if + a non-New Zealand + Address.
+ Country: + type: string + description:The country code.
+ PostalCode: + type: string + description:The ZIP/postal + code.
+ GridLocation: + description:The latitude & + longitude of the + location. Grid location + values are derived from + New Zealand Map Grid x,y + coordinates and + converted to Latitude + and Longitude values per + the World Geodetic + System 1984 (G1762)
+ type: object + required: + - Latitude + - Longitude + properties: + Latitude: + description:Latitude in + decimal degrees.
+Latitudes north + of the equator are + positive, latitudes + south of the equator + are negative [ISO + 6709].
+ Longitude: + description:Longitude in + decimal degrees.
+Longitudes east + of the Prime + Meridian in + Greenwich are + positive, longitudes + west of the Prime + Meridian are + negative. The 180th + meridian is + negative. [ISO + 6709]
+ StatisticalAreaList: + description:A list of Statistical + Areas containing the + location.
The + list may contain exactly + one StatisticalArea + element for each of the + following spatial unit + types:
A particular + statistical area + defined by + Statistics New + Zealand.
+ type: object + required: + - Code + - SpatialUnitType + properties: + SpatialUnitType: + $ref: "#/paths/~1St\ + udentPersonals/get/\ + responses/200/conte\ + nt/application~1jso\ + n/schema/properties\ + /StudentPersonals/p\ + roperties/StudentPe\ + rsonal/items/proper\ + ties/PersonInfo/pro\ + perties/AddressList\ + /properties/Address\ + /items/properties/S\ + tatisticalAreaList/\ + properties/Statisti\ + calArea/items/prope\ + rties/SpatialUnitTy\ + pe" + Code: + type: string + description:A valid + value defined by the + nominated spatial + unit type, defined + by Statistics New + Zealand in one of + the following + statistical area + defintion + standards:
List of Email elements.
+ type: object + required: + - Email + properties: + Email: + type: array + items: + 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: object + required: + - Address + properties: + Type: + $ref: "#/paths/~1StudentPerso\ + nals/get/responses/200/\ + content/application~1js\ + on/schema/properties/St\ + udentPersonals/properti\ + es/StudentPersonal/item\ + s/properties/PersonInfo\ + /properties/EmailList/p\ + roperties/Email/items/p\ + roperties/Type" + Address: + type: string + description:The actual email + address.
+ PhoneNumberList: + description:List of PhoneNumber + elements.
+ type: object + required: + - PhoneNumber + properties: + PhoneNumber: + type: array + items: + description:This element represents a + phone number and occurs + within objects such as + StudentPersonal, + StaffPersonal, etc.
+ type: object + required: + - Number + properties: + Type: + $ref: "#/paths/~1StudentPerso\ + nals/get/responses/200/\ + content/application~1js\ + on/schema/properties/St\ + udentPersonals/properti\ + es/StudentPersonal/item\ + s/properties/PersonInfo\ + /properties/PhoneNumber\ + List/properties/PhoneNu\ + mber/items/properties/T\ + ype" + Number: + type: string + description: "Phone number. + Free-form, but typical + New Zealand formats + include:
Phone number + extension.
+ ListedStatus: + $ref: "#/paths/~1StudentPerso\ + nals/get/responses/200/\ + content/application~1js\ + on/schema/properties/St\ + udentPersonals/properti\ + es/StudentPersonal/item\ + s/properties/PersonInfo\ + /properties/Name/proper\ + ties/FamilyNameFirst" + x-accessControl: + ? create + ? read + ? update + ? delete + ? aggregate + description: Contains all the personal information related to the + student. + x-accessControl: + create: + - 1001 + - 1306 + - 2103 + - 2401 + - 2403 + read: + - 1001 + - 1306 + - 2101 + - 2103 + - 2401 + - 2403 + update: + - 1001 + - 1306 + - 2103 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: + - 2002 + - 2102 + example: + StudentPersonals: + StudentPersonal: + - StudentPersonalRefId: 7C834EA9-EDA1-2090-347F-83297E1C290C + StudentPersonalLocalId: S1234567 + NationalStudentNumber: 2234523 + FirstNZSchoolingDate: 1996-05-04 + PersonInfo: + Name: + FamilyName: Hagrid + GivenName: Rubeus + FullName: Rubeus Hagrid + Type: LGL + IsVerified: N + OtherNameList: + Name: + - FamilyName: Anderson + GivenName: Samuel + FullName: Samuel Anderson + Type: AKA + IsVerified: Y + Verification: + Source: NZPAS + DocumentSerialNumber: L905673 + DocumentExpiryDate: 2019-03-30 + IsConfirmed: true + Timestamp: 2003-11-30T12:34:56.7 + Provider: + RefId: 822f6c83-2841-4a87-9ff9-49730951b3ba + - FamilyName: Rowinski + GivenName: Sam + FullName: "Sam Rowinski " + Type: PRF + IsVerified: N + Demographics: + BirthDate: 1990-09-26 + PlaceOfBirth: Dunedin + CountryOfBirth: ZAF + CitizenshipList: + Country: + - NZL + - ZAF + CitizenshipStatus: NZCI + CitizenshipVerification: + Source: NZPAS + DocumentSerialNumber: L905673 + DocumentExpiryDate: 2019-03-30 + IsConfirmed: true + Timestamp: 2003-11-30T12:34:56.7 + Provider: + RefId: 822f6c83-2841-4a87-9ff9-49730951b3ba + Gender: 2 + LanguageList: + Language: + - Code: NZS01110 + Usage: FL + ProficiencyList: + Proficiency: + Level: AD + Type: SP + - Code: NZS01112 + Usage: SL + ProficiencyList: + Proficiency: + Level: BE + Type: SP + EthnicityList: + Ethnicity: + - PreferenceOrderNumber: 1 + Code: 111 + - PreferenceOrderNumber: 1 + Code: 211 + IwiAffiliationList: + IwiAffiliation: + - NZS0702 + - NZS0601 + ReligiousAffiliationList: + ReligiousAffiliation: + - NZS212 + - NZS215 + AddressList: + Address: + - Type: TH + Role: PHY + Street: + Line1: The Enchanted Wood + Line2: 533 Hogwart's Way + City: Hogsmead + PostalCode: "7733" + - Type: RU + Role: PHY + Street: + Line1: 1175 Lake Ferry Rd + Suburb: RD 1 + City: Martinborough + EmailList: + Email: + - Type: PRIM + Address: hagrid@gmail.com + PhoneNumberList: + PhoneNumber: + Type: MOB + Number: (021) 300 999 + HouseholdContactInfoList: + HouseholdContactInfo: + - PreferenceNumber: 1 + HouseholdContactId: 7d5c3f5c-d89c-4551-9442-6b008207986e + AddressList: + Address: + - Type: DE + Role: POS + Street: + Line1: P O Box 81 + City: Martinborough + PostalCode: "5781" + "{\n \"Email\": { \"Type\": \"PRIM\", \"Address\": \"hagrid@gmail.com\" }\n}": null + PhoneNumberList: + PhoneNumber: + Type: MOB + Number: (021) 300 999 + application/xml: + schema: + type: object + properties: + StudentPersonals: + type: object + description: A List of StudentPersonal objects + properties: + StudentPersonal: + type: array + items: + $ref: "#/paths/~1StudentPersonals/get/responses/200/conte\ + nt/application~1json/schema/properties/StudentPerso\ + nals/properties/StudentPersonal/items" + example: >- +The GUID of the student.
+ required: true + schema: + type: string + operationId: createStudentPersonal + requestBody: + description: CRUD operation on StudentPersonal + content: + application/json: + schema: + type: object + properties: + StudentPersonal: + $ref: "#/paths/~1StudentPersonals/get/responses/200/content/appli\ + cation~1json/schema/properties/StudentPersonals/properties/\ + StudentPersonal/items" + example: + StudentPersonal: + StudentPersonalRefId: 7C834EA9-EDA1-2090-347F-83297E1C290C + StudentPersonalLocalId: S1234567 + NationalStudentNumber: 2234523 + FirstNZSchoolingDate: 1996-05-04 + PersonInfo: + Name: + FamilyName: Hagrid + GivenName: Rubeus + FullName: Rubeus Hagrid + Type: LGL + IsVerified: N + OtherNameList: + Name: + - FamilyName: Anderson + GivenName: Samuel + FullName: Samuel Anderson + Type: AKA + IsVerified: Y + Verification: + Source: NZPAS + DocumentSerialNumber: L905673 + DocumentExpiryDate: 2019-03-30 + IsConfirmed: true + Timestamp: 2003-11-30T12:34:56.7 + Provider: + RefId: 822f6c83-2841-4a87-9ff9-49730951b3ba + - FamilyName: Rowinski + GivenName: Sam + FullName: "Sam Rowinski " + Type: PRF + IsVerified: N + Demographics: + BirthDate: 1990-09-26 + PlaceOfBirth: Dunedin + CountryOfBirth: ZAF + CitizenshipList: + Country: + - NZL + - ZAF + CitizenshipStatus: NZCI + CitizenshipVerification: + Source: NZPAS + DocumentSerialNumber: L905673 + DocumentExpiryDate: 2019-03-30 + IsConfirmed: true + Timestamp: 2003-11-30T12:34:56.7 + Provider: + RefId: 822f6c83-2841-4a87-9ff9-49730951b3ba + Gender: 2 + LanguageList: + Language: + - Code: NZS01110 + Usage: FL + ProficiencyList: + Proficiency: + Level: AD + Type: SP + - Code: NZS01112 + Usage: SL + ProficiencyList: + Proficiency: + Level: BE + Type: SP + EthnicityList: + Ethnicity: + - PreferenceOrderNumber: 1 + Code: 111 + - PreferenceOrderNumber: 1 + Code: 211 + IwiAffiliationList: + IwiAffiliation: + - NZS0702 + - NZS0601 + ReligiousAffiliationList: + ReligiousAffiliation: + - NZS212 + - NZS215 + AddressList: + Address: + - Type: TH + Role: PHY + Street: + Line1: The Enchanted Wood + Line2: 533 Hogwart's Way + City: Hogsmead + PostalCode: "7733" + - Type: RU + Role: PHY + Street: + Line1: 1175 Lake Ferry Rd + Suburb: RD 1 + City: Martinborough + EmailList: + Email: + - Type: PRIM + Address: hagrid@gmail.com + PhoneNumberList: + PhoneNumber: + Type: MOB + Number: (021) 300 999 + HouseholdContactInfoList: + HouseholdContactInfo: + - PreferenceNumber: 1 + HouseholdContactId: 7d5c3f5c-d89c-4551-9442-6b008207986e + AddressList: + Address: + - Type: DE + Role: POS + Street: + Line1: P O Box 81 + City: Martinborough + PostalCode: "5781" + "{\n \"Email\": { \"Type\": \"PRIM\", \"Address\": \"hagrid@gmail.com\" }\n}": null + PhoneNumberList: + PhoneNumber: + Type: MOB + Number: (021) 300 999 + application/xml: + schema: + type: object + properties: + StudentPersonal: + $ref: "#/paths/~1StudentPersonals/get/responses/200/content/appli\ + cation~1json/schema/properties/StudentPersonals/properties/\ + StudentPersonal/items" + example: >- +The GUID of the student.
+ required: true + schema: + type: string + operationId: updateStudentPersonal + requestBody: + description: CRUD operation on StudentPersonal + content: + application/json: + schema: + type: object + properties: + StudentPersonal: + type: object + properties: + StudentPersonalRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-\ + 9]{4}-[a-fA-F0-9]{12}" + StudentPersonalLocalId: + description:This is a common element used to define the locally + assigned identifier associated with an entity.
+ type: string + NationalStudentNumber: + description:The unique identifier allocated to every student in + New Zealand, also known as the NSN.
+ FirstNZSchoolingDate: + type: string + format: date + description:The date a student first ever started schooling in + New Zealand. This field is used to establish most + students’ Funding Year Level.
+ x-accessControl: + ? create + ? read + ? update + ? delete + ? aggregate + EarlyChildhoodEducation: + description:The type of early childhood education the student + received before enrolling in their first school.
+ type: object + properties: + Type: + type: string + title: Early Childhood Education Type + description: >- +The type of early childhood education the student + received.
The total number of hours of early childhood + education attended, prior to enrolling in their + first school.
+ x-accessControl: + ? create + ? read + ? update + ? delete + ? aggregate + PersonInfo: + description:Personal Information
+ type: object + properties: + Name: + description:A name used by the person
+ type: object + properties: + Title: + type: string + description:A title or prefix associated with the + name.
+ FamilyName: + type: string + description:Also known as Last Name, although some + cultures may not present a family name as the + last name.
+ GivenName: + type: string + description:Also known as First Name, although some + cultures may not present this name as the first + element in a name. May contain a composite of + all given names.
+ MiddleName: + type: string + description:Where more than one Given Name, these may be + combined in one composite field or else + populated in several elements.
+ FamilyNameFirst: + type: string + title: Yes Or No Category + description: >- +A reusable code set for yes, no, unknown and + not provided values.
A preferred version of the Family Name. + Note:A name cannot have both a Preferred Family + and Preferred Given Name within the same Name + structure – only one of these fields should be + populated. If a person does have both a + Preferred Family and Preferred Given Name then + this must be populated as a separate Name of + type ‘Preferred’.
+ PreferredFamilyNameFirst: + $ref: "#/paths/~1StudentPersonals~1%7BStudentPersonal\ + RefId%7D/put/requestBody/content/application~1j\ + son/schema/properties/StudentPersonal/propertie\ + s/PersonInfo/properties/Name/properties/FamilyN\ + ameFirst" + PreferredGivenName: + type: string + description: "A preferred version of the Given Name. Note: + A name cannot have both a Preferred Family and + Preferred Given Name within the same Name + structure – only one of these fields should be + populated. If a person does have both a + Preferred Family and Preferred Given Name then + this must be populated as a separate Name of + type ‘Preferred’.
" + Suffix: + type: string + description:Textual suffix like PHD, JP, BSc.
+ FullName: + type: string + description:A combination of all name elements as one + composite text element
+ Type: + type: string + title: Name Usage Type + description: >- +A standardised method of describing the usage + of a name by a person. Where a person has more + than one current name, the usage type indicates + which name may be used according to the + purpose.
Code values are based on SIF + Australia 3.4.
The name by which an individual prefers + to be known and addressed.
Only usage + type applicable for student name usage + (other types are not supported by NSI).
+ enum: + - PRF + - title: Foreign Official Name + description:Included for future usage in NZ, + especially for tertiary students.
+ enum: + - FON + - title: Previous name + enum: + - PRV + - title: Also Known As + description: AKA or Alias + enum: + - AKA + - title: Name at Birth + enum: + - BTH + - title: Legal Name + description:Legal Name or Official Name as defined by + the organisation which collects it (legal + name is not defined in this standard)
+ enum: + - LGL + IsVerified: + $ref: "#/paths/~1StudentPersonals~1%7BStudentPersonal\ + RefId%7D/put/requestBody/content/application~1j\ + son/schema/properties/StudentPersonal/propertie\ + s/PersonInfo/properties/Name/properties/FamilyN\ + ameFirst" + OtherNameList: + description:Previous, alternate or other names or aliases + associated with the person.
+ type: object + properties: + Name: + type: array + items: + description:Extension of BaseNameType including name + verification data
+ type: object + properties: + Verification: + description:The verification event that verified + the person's name.
+ type: object + properties: + Source: + type: string + title: Verification Source + description: >- +Records the source of the identity + or eligibility verification, that has + been made. Mostly it is merely a + record of the kind of document that + has been presented; but occasionally + it is down to Principal or Ministry + discretion / approval.
The serial number on the document + that was used to verify the name or + birthdate.
+ DocumentExpiryDate: + type: string + format: date + description:The expiry date on the document + that was used to verify the name or + birthdate.
+ IsConfirmed: + type: boolean + description:If true then verification has been + confirmed by MoE.
+ Timestamp: + description:The date & time that the + VerificationEvent took place.
+ Provider: + description:A reference to another SIF Data + Object
+ type: object + properties: + RefId: + $ref: "#/paths/~1StudentPersonals~1%7BS\ + tudentPersonalRefId%7D/put/reques\ + tBody/content/application~1json/s\ + chema/properties/StudentPersonal/\ + properties/StudentPersonalRefId" + LocalId: + $ref: "#/paths/~1StudentPersonals~1%7BS\ + tudentPersonalRefId%7D/put/reques\ + tBody/content/application~1json/s\ + chema/properties/StudentPersonal/\ + properties/StudentPersonalLocalId" + Name: + type: string + description:The normal descriptive name of + the referenced object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF + DataObject names, to be included + in Object References
The verified name of the person.
+ type: object + properties: + Verification: + description:The verification event that verified the + person's name.
+ type: object + properties: + Source: + $ref: "#/paths/~1StudentPersonals~1%7BStudentPers\ + onalRefId%7D/put/requestBody/content/applic\ + ation~1json/schema/properties/StudentPerson\ + al/properties/PersonInfo/properties/OtherNa\ + meList/properties/Name/items/properties/Ver\ + ification/properties/Source" + DocumentSerialNumber: + type: string + description:The serial number on the document that + was used to verify the name or + birthdate.
+ DocumentExpiryDate: + type: string + format: date + description:The expiry date on the document that was + used to verify the name or birthdate.
+ IsConfirmed: + type: boolean + description:If true then verification has been + confirmed by MoE.
+ Timestamp: + description:The date & time that the + VerificationEvent took place.
+ Provider: + $ref: "#/paths/~1StudentPersonals~1%7BStudentPers\ + onalRefId%7D/put/requestBody/content/applic\ + ation~1json/schema/properties/StudentPerson\ + al/properties/PersonInfo/properties/OtherNa\ + meList/properties/Name/items/properties/Ver\ + ification/properties/Provider" + x-accessControl: + ? create + ? read + ? update + ? delete + ? aggregate + Demographics: + description:Details of the person’s demographic properties
+ type: object + properties: + BirthDate: + type: string + format: date + description:The person's date of birth.
+ DateOfDeath: + type: string + format: date + description:The person's date of death.
+ x-accessControl: + ? create + ? read + ? update + ? delete + ? aggregate + PlaceOfBirth: + type: string + description:The person's place of birth - like village, + town, city etc.
+ x-accessControl: + ? create + ? read + ? update + ? delete + ? aggregate + CountryOfBirth: + type: string + title: 3166 Country + description: >- +A country is a geopolitical entity recognised + by the New Zealand government. The term country + may include
Conforms to + the International Standard ISO 3166 Codes for + the Representation of Names of Countries and + their Subdivisions (ISO 3166-1:2013). Education + adopts the alpha-3 representation of this + standard.
The citizenship or residency status of a + person, principally recorded in order to + determine eligibility for education services + hence limited to indicating New Zealand, + Australian or Other residency.
Based on + SIF Australia + AUCodeSetsAustralianCitizenshipStatusType
+The verification event that verified the + residency status of the person. Absence of a + verification event indicates that the residency + was not verified against an identity document. +
+ type: object + properties: + Source: + $ref: "#/paths/~1StudentPersonals~1%7BStudentPers\ + onalRefId%7D/put/requestBody/content/applic\ + ation~1json/schema/properties/StudentPerson\ + al/properties/PersonInfo/properties/OtherNa\ + meList/properties/Name/items/properties/Ver\ + ification/properties/Source" + DocumentSerialNumber: + type: string + description:The serial number on the document that + was used to verify the name or + birthdate.
+ DocumentExpiryDate: + type: string + format: date + description:The expiry date on the document that was + used to verify the name or birthdate.
+ IsConfirmed: + type: boolean + description:If true then verification has been + confirmed by MoE.
+ Timestamp: + description:The date & time that the + VerificationEvent took place.
+ Provider: + $ref: "#/paths/~1StudentPersonals~1%7BStudentPers\ + onalRefId%7D/put/requestBody/content/applic\ + ation~1json/schema/properties/StudentPerson\ + al/properties/PersonInfo/properties/OtherNa\ + meList/properties/Name/items/properties/Ver\ + ification/properties/Provider" + x-accessControl: + ? create + ? read + ? update + ? delete + ? aggregate + Gender: + type: string + title: Gender + description: >- +A Person may identify as having a Gender (or + Gender Identity). Biological sex and sexual + orientation are related but different concepts. + Sourced from Statistics NZ Standard for Gender + Identity
A language that an individual uses to + communicate.
+ type: object + properties: + Code: + type: string + title: Language + description: >- +Language refers to recognised human + communication systems, typically oral + and/or written. Sourced from + Statistics NZ - Language Standard + Classification 1999 v2.0.0
A standardised method of describing + the usage of a language by a person, + potentially indicating capability and + preference for the language.
Specific dialect of a person's + language.
+ ProficiencyList: + description:A list of the person's proficiency + in the language in regards to + speaking, reading and writing.
+ type: object + properties: + Proficiency: + type: array + items: + description:The person's proficiency in + the language in regards to + speaking, reading and + writing.
+ type: object + properties: + Level: + type: string + title: Language Proficiency Level + description: >- +The language proficiency + level.
Code set denoting a type + of language proficiency, + e.g. speaking, writing + reading.
One or more ethnic groups with which the + person identifies.
+ type: object + properties: + Ethnicity: + type: array + items: + description:An ethnic group with which the person + identifies, and if there is more than one, + their order of preference.
+ type: object + properties: + PreferenceOrderNumber: + type: integer + description:The order of preference for the + person's ethnicity.
+ Code: + type: string + title: Ethnicity + description: >- +Ethnicity is the ethnic group or + groups that people identify with or + feel they belong to. Ethnicity is a + measure of cultural affiliation, as + opposed to race, ancestry, nationality + or citizenship. Ethnicity is self + perceived and people can belong to + more than one ethnic group.
The + permissible values consists of any + value from the Statistics NZ - + Ethnicity New Zealand Standard + Classification 2005 v2.0.0 Depending + on usage, ethnicity may be defined at + levels 1 to 4.
A list of one or more iwi with which the + person has an affiliation.
+ type: object + properties: + IwiAffiliation: + type: array + items: + type: string + title: Iwi + description: >- +An iwi, or Māori tribe, is one of the + largest kinship groupings and is generally + made up of several hapū that are all + descended from a common ancestor. Hapū are + clusters of whānau where the whānau is + usually an extended family grouping + consisting of children, parents, often + grandparents, and other closely related + kin.
Sourced from Statistics NZ - + Iwi and Iwi related groups statistical + standard v1.0.0.0
A list of one or more religions with which + the person has an affiliation.
+ type: object + properties: + ReligiousAffiliation: + type: array + items: + type: string + title: Religion + description: >- +Religious affiliation is the + self-identified association of a person + with a religion, denomination or + sub-denominational religious group.
+Sourced from Statistics NZ - Religious + Affiliation 1999 v1.0.0.0
This element contains address data.
+ type: object + properties: + Type: + type: string + title: Address Type + description: >- +Address type allows an address to be + categorised according to its component + structure. Address type can be used to + build processing rules for validating, + managing and presenting addresses. Address + type is independent of the use of the + address by any party. To describe how a + party may use an address (residence, + billing, term address etc) see + AddressRoleType
Also called 'Street' addresses, + The most general, and widely used type + of address, and can contain the widest + variety of components
In + general a thoroughfare address will + include components for a number, a + roadname, and a locality.
They + cannot contain any of the components + specific to a delivery service, rural + post delivery, or water address.
+These addresses are used to find a + location.
Example: 30 - 40 + Lambton Quay, Wellington, 6165
\"" + enum: + - TH + - title: Rural Post Delivery + description: '"Defined by New Zealand Post, + these addresses are assigned by NZ + Post for customers who purchase a + rural delivery service (mail and also + other goods).
They will have + the same number and roadname + components as the street address, and + may have the same region + component.
They do not have a + component that identifies the locality + the address is within. The locality + and city or town components are + replaced by components that identify + the rural delivery route (RD number), + and the town from which the rural + delivery route starts and finishes + (the mail town). Only addresses of + this class can contain these + components.
Example: + 121 Waitaha Road, RD 1, Ross, + 7885
"' + enum: + - RU + - title: Delivery Service + description: '"Defined by New Zealand Post, and + used exclusively for NZ Post services + other than standard mail delivery. + Addresses in this class include PO + Box, Private Bag, and Counter Delivery + addresses.
Example: + Private Bag 2345, Auckland, 1142
"' + enum: + - DE + - title: Water + description: '"Where properties have no road + access, but do have access to water + frontage (coastline or riverbank or + lakefront), a water address uses the + name of a water feature (for example, + islands, rivers, bays, or + peninsulas).
Example: + 235 Lochmara Bay, Queen Charlotte + Sound, Marlborough Sounds
"' + enum: + - WA + - title: Foreign Address + description: '"A foreign address identifies a + location outside of New Zealand.
+Example: + Rudolf-Diesel-Strasse 14, 54595 Prüm, + Germany
"' + enum: + - FO + Role: + type: string + title: Address Role + description: >- +A standardised description of the role + or usage of an address by a party (person + or organisation). Where a party has more + than one address, this provides context + for deciding which address to use.
+The street element is a complex element + and breaks the street down into several + parts. (Allow for PO Box here)
+ type: object + properties: + Line1: + type: string + description:Address line 1.
+ Line2: + type: string + description:Address line 2.
+ Line3: + type: string + description:Address line 3.
+ Suburb: + type: string + description:The suburb part of urban addresses, or + the 'RD No' part of rural addresses
+ City: + type: string + description:The city part of the address.
+ StateProvince: + type: string + description:The state or province code. + StateTerritory Code only applicable if a + non-New Zealand Address.
+ Country: + type: string + description:The country code.
+ PostalCode: + type: string + description:The ZIP/postal code.
+ GridLocation: + description:The latitude & longitude of the + location. Grid location values are derived + from New Zealand Map Grid x,y coordinates + and converted to Latitude and Longitude + values per the World Geodetic System 1984 + (G1762)
+ type: object + properties: + Latitude: + description:Latitude in decimal degrees.
+Latitudes north of the equator are + positive, latitudes south of the + equator are negative [ISO 6709].
+ Longitude: + description:Longitude in decimal degrees.
+Longitudes east of the Prime + Meridian in Greenwich are positive, + longitudes west of the Prime Meridian + are negative. The 180th meridian is + negative. [ISO 6709]
+ StatisticalAreaList: + description:A list of Statistical Areas containing + the location.
The list may contain + exactly one StatisticalArea element for + each of the following spatial unit + types:
A particular statistical area + defined by Statistics New + Zealand.
+ type: object + properties: + SpatialUnitType: + type: string + title: Spatial Unit Type + description: >- +A classification of + geographical boundaries or + statistical areas as defined by + Statistics NZ’s geographic + hierarchy.
Area units are + aggregations of meshblocks. + They are non–administrative + areas that are in between + meshblocks and territorial + authorities in size. Area + units must either define or + aggregate to define, + regional councils, + territorial authorities and + urban areas.
Statistics + NZ Classification of Area + Unit 2013 v1.0.0 + enum: + - AE + - title: General Electoral District + description:The general electoral + districts as constituted + under the Electoral Act + 1993.
Statistics NZ + General Electoral District + 2014 v1.0.0 + enum: + - GE + - title: Community Board + description:(aka Local Board within + Auckland) Local boards + provide governance at the + local level within Auckland + Council. They enable + democratic decision making + by, and on behalf of + communities within the local + board area.
Statistics + NZ Community Board 2013 + v1.0.0 + enum: + - CB + - title: Māori Electoral District + description:Māori electoral districts + are the voting districts for + parliamentary elections for + people who choose to be on + the Māori Electoral + Roll.
Statistics NZ + Māori Electoral District + 2014 v1.0.0 + enum: + - ME + - title: Mesh Block + description:A meshblock is the + smallest geographic unit for + which statistical data is + collected and processed by + Statistics New Zealand.
+A meshblock is defined by + a geographic area, which can + vary in size from part of a + city block to a large area + of rural land. Each + meshblock borders on another + to form a network covering + all of New Zealand, + including coasts and inlets + and extending out to the + 200-mile economic zone.
+ Statistics NZ Statistical + Standard for Meshblock 2013 + v1.0.0 + enum: + - MB + - title: Regional Council + description:The top tier of local + government in New Zealand, + defined by the Local + Government Act 2002, which + requires the boundaries of + regions to conform as far as + possible to one or more + water catchments. When + determining regional + boundaries, the Local + Government Commission gave + consideration to regional + communities of interest when + selecting water catchments + to be included in a region. + It also considered factors + such as natural resource + management, land use + planning and environmental + matters.
Statistics NZ + Regional Council 2013 v1.0.0 + enum: + - RC + - title: Territorial Authority + description:The second tier of local + government in New Zealand, + defined under the Local + Government Act 2002 as a + city council or district + council. There are 67 + territorial authorities + consisting of 12 city + councils, 53 districts, + Auckland Council, and + Chatham Islands Council.
+ Statistics NZ Territorial + Authority 2013 v1.0.0 + enum: + - TA + - title: Urban Area + description: '"Urban Areas are + statistically defined areas + with no administrative or + legal basis. There is a + three part hierarchical + sub-division of urban areas + into: main urban areas, + secondary urban areas, minor + urban areas. Together the + populations in main, + secondary and minor urban + areas comprise the + statistically defined urban + population of New Zealand. + The urban area + classification is designed + to identify concentrated + urban or semi-urban + settlements without the + distortions of + administrative + boundaries.
Statistics + NZ Urban Area 2013 v2.0.0"' + enum: + - UA + - title: Ward + description:Wards are defined under + the Local Electoral Act 2001 + and result from the + division, for electoral + purposes, of the district of + a territorial authority. The + ward system was designed to + allow for the recognition of + communities within a + district and to increase + community involvement in the + local government system.
+ Statistics NZ Ward 2013 + v1.0.0 + enum: + - WA + Code: + type: string + description:A valid value defined by the + nominated spatial unit type, + defined by Statistics New + Zealand in one of the following + statistical area defintion + standards:
The person's e-mail address(es) - one or more + emails.
+ type: object + properties: + Email: + type: array + items: + 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: object + properties: + Type: + type: string + title: Email Type + description: >- +A standardised method of describing an + electronic mail address used as contact + method by a party. Where a party has more + than one email address, this may provide + context for deciding which email address + to use.
The actual email address.
+ PhoneNumberList: + description:The person's phone number(s) - one or more phone + numbers.
+ type: object + properties: + PhoneNumber: + type: array + items: + description:This element represents a phone number and + occurs within objects such as StudentPersonal, + StaffPersonal, etc.
+ type: object + properties: + Type: + type: string + title: Telephone Number Type + description: >- +A standardised method of describing a + telecommunications device used as contact + method by a party. Where a party has more + than one phone number, this may provide + context for deciding which number to + use.
Phone number. Free-form, but typical + New Zealand formats include:
Phone number extension.
+ ListedStatus: + $ref: "#/paths/~1StudentPersonals~1%7BStudentPe\ + rsonalRefId%7D/put/requestBody/content/ap\ + plication~1json/schema/properties/Student\ + Personal/properties/PersonInfo/properties\ + /Name/properties/FamilyNameFirst" + HouseholdContactInfoList: + description:The person's household/s contact information. A + list of one or more household’s contact + information.
+ type: object + properties: + HouseholdContactInfo: + type: array + items: + description:Common element used to supply information + about a particular household a person is a + member of.
+ type: object + properties: + PreferenceNumber: + type: integer + description:Priority of Household Contact in + relation to this Person.
+ HouseholdContactId: + $ref: "#/paths/~1StudentPersonals~1%7BStudentPe\ + rsonalRefId%7D/put/requestBody/content/ap\ + plication~1json/schema/properties/Student\ + Personal/properties/StudentPersonalLocalI\ + d" + HouseholdSalutation: + type: string + description:Salutation to be used in addressing + this household.
+ AddressList: + description:A list of Address elements.
+ type: object + properties: + Address: + type: array + items: + description:This element contains address + data.
+ type: object + properties: + Type: + $ref: "#/paths/~1StudentPersonals~1%7\ + BStudentPersonalRefId%7D/put/re\ + questBody/content/application~1\ + json/schema/properties/StudentP\ + ersonal/properties/PersonInfo/p\ + roperties/AddressList/propertie\ + s/Address/items/properties/Type" + Role: + $ref: "#/paths/~1StudentPersonals~1%7\ + BStudentPersonalRefId%7D/put/re\ + questBody/content/application~1\ + json/schema/properties/StudentP\ + ersonal/properties/PersonInfo/p\ + roperties/AddressList/propertie\ + s/Address/items/properties/Role" + Street: + description:The street element is a + complex element and breaks the + street down into several parts. + (Allow for PO Box here)
+ type: object + properties: + Line1: + type: string + description:Address line 1.
+ Line2: + type: string + description:Address line 2.
+ Line3: + type: string + description:Address line 3.
+ Suburb: + type: string + description:The suburb part of urban + addresses, or the 'RD No' part + of rural addresses
+ City: + type: string + description:The city part of the + address.
+ StateProvince: + type: string + description:The state or province code. + StateTerritory Code only + applicable if a non-New Zealand + Address.
+ Country: + type: string + description:The country code.
+ PostalCode: + type: string + description:The ZIP/postal code.
+ GridLocation: + description:The latitude & longitude of + the location. Grid location + values are derived from New + Zealand Map Grid x,y coordinates + and converted to Latitude and + Longitude values per the World + Geodetic System 1984 (G1762) +
+ type: object + properties: + Latitude: + description:Latitude in decimal + degrees.
Latitudes + north of the equator are + positive, latitudes south of + the equator are negative + [ISO 6709].
+ Longitude: + description:Longitude in decimal + degrees.
Longitudes + east of the Prime Meridian + in Greenwich are positive, + longitudes west of the Prime + Meridian are negative. The + 180th meridian is negative. + [ISO 6709]
+ StatisticalAreaList: + description:A list of Statistical Areas + containing the location.
+The list may contain exactly + one StatisticalArea element for + each of the following spatial + unit types:
A particular + statistical area defined + by Statistics New + Zealand.
+ type: object + properties: + SpatialUnitType: + $ref: "#/paths/~1StudentPer\ + sonals~1%7BStudentPer\ + sonalRefId%7D/put/req\ + uestBody/content/appl\ + ication~1json/schema/\ + properties/StudentPer\ + sonal/properties/Pers\ + onInfo/properties/Add\ + ressList/properties/A\ + ddress/items/properti\ + es/StatisticalAreaLis\ + t/properties/Statisti\ + calArea/items/propert\ + ies/SpatialUnitType" + Code: + type: string + description:A valid value + defined by the + nominated spatial unit + type, defined by + Statistics New Zealand + in one of the + following statistical + area defintion + standards:
List of Email elements.
+ type: object + properties: + Email: + type: array + items: + 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: object + properties: + Type: + $ref: "#/paths/~1StudentPersonals~1%7\ + BStudentPersonalRefId%7D/put/re\ + questBody/content/application~1\ + json/schema/properties/StudentP\ + ersonal/properties/PersonInfo/p\ + roperties/EmailList/properties/\ + Email/items/properties/Type" + Address: + type: string + description:The actual email address.
+ PhoneNumberList: + description:List of PhoneNumber elements.
+ type: object + properties: + PhoneNumber: + type: array + items: + description:This element represents a phone + number and occurs within objects + such as StudentPersonal, + StaffPersonal, etc.
+ type: object + properties: + Type: + $ref: "#/paths/~1StudentPersonals~1%7\ + BStudentPersonalRefId%7D/put/re\ + questBody/content/application~1\ + json/schema/properties/StudentP\ + ersonal/properties/PersonInfo/p\ + roperties/PhoneNumberList/prope\ + rties/PhoneNumber/items/propert\ + ies/Type" + Number: + type: string + description: "Phone number. Free-form, but + typical New Zealand formats + include:
Phone number extension.
+ ListedStatus: + $ref: "#/paths/~1StudentPersonals~1%7\ + BStudentPersonalRefId%7D/put/re\ + questBody/content/application~1\ + json/schema/properties/StudentP\ + ersonal/properties/PersonInfo/p\ + roperties/Name/properties/Famil\ + yNameFirst" + x-accessControl: + ? create + ? read + ? update + ? delete + ? aggregate + description: Contains all the personal information related to the student. + x-accessControl: + create: + - 1001 + - 1306 + - 2103 + - 2401 + - 2403 + read: + - 1001 + - 1306 + - 2101 + - 2103 + - 2401 + - 2403 + update: + - 1001 + - 1306 + - 2103 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: + - 2002 + - 2102 + example: + StudentPersonal: + StudentPersonalRefId: 7C834EA9-EDA1-2090-347F-83297E1C290C + StudentPersonalLocalId: S1234567 + NationalStudentNumber: 2234523 + FirstNZSchoolingDate: 1996-05-04 + PersonInfo: + Name: + FamilyName: Hagrid + GivenName: Rubeus + FullName: Rubeus Hagrid + Type: LGL + IsVerified: N + OtherNameList: + Name: + - FamilyName: Anderson + GivenName: Samuel + FullName: Samuel Anderson + Type: AKA + IsVerified: Y + Verification: + Source: NZPAS + DocumentSerialNumber: L905673 + DocumentExpiryDate: 2019-03-30 + IsConfirmed: true + Timestamp: 2003-11-30T12:34:56.7 + Provider: + RefId: 822f6c83-2841-4a87-9ff9-49730951b3ba + - FamilyName: Rowinski + GivenName: Sam + FullName: "Sam Rowinski " + Type: PRF + IsVerified: N + Demographics: + BirthDate: 1990-09-26 + PlaceOfBirth: Dunedin + CountryOfBirth: ZAF + CitizenshipList: + Country: + - NZL + - ZAF + CitizenshipStatus: NZCI + CitizenshipVerification: + Source: NZPAS + DocumentSerialNumber: L905673 + DocumentExpiryDate: 2019-03-30 + IsConfirmed: true + Timestamp: 2003-11-30T12:34:56.7 + Provider: + RefId: 822f6c83-2841-4a87-9ff9-49730951b3ba + Gender: 2 + LanguageList: + Language: + - Code: NZS01110 + Usage: FL + ProficiencyList: + Proficiency: + Level: AD + Type: SP + - Code: NZS01112 + Usage: SL + ProficiencyList: + Proficiency: + Level: BE + Type: SP + EthnicityList: + Ethnicity: + - PreferenceOrderNumber: 1 + Code: 111 + - PreferenceOrderNumber: 1 + Code: 211 + IwiAffiliationList: + IwiAffiliation: + - NZS0702 + - NZS0601 + ReligiousAffiliationList: + ReligiousAffiliation: + - NZS212 + - NZS215 + AddressList: + Address: + - Type: TH + Role: PHY + Street: + Line1: The Enchanted Wood + Line2: 533 Hogwart's Way + City: Hogsmead + PostalCode: "7733" + - Type: RU + Role: PHY + Street: + Line1: 1175 Lake Ferry Rd + Suburb: RD 1 + City: Martinborough + EmailList: + Email: + - Type: PRIM + Address: hagrid@gmail.com + PhoneNumberList: + PhoneNumber: + Type: MOB + Number: (021) 300 999 + HouseholdContactInfoList: + HouseholdContactInfo: + - PreferenceNumber: 1 + HouseholdContactId: 7d5c3f5c-d89c-4551-9442-6b008207986e + AddressList: + Address: + - Type: DE + Role: POS + Street: + Line1: P O Box 81 + City: Martinborough + PostalCode: "5781" + "{\n \"Email\": { \"Type\": \"PRIM\", \"Address\": \"hagrid@gmail.com\" }\n}": null + PhoneNumberList: + PhoneNumber: + Type: MOB + Number: (021) 300 999 + application/xml: + schema: + type: object + properties: + StudentPersonal: + $ref: "#/paths/~1StudentPersonals~1%7BStudentPersonalRefId%7D/put\ + /requestBody/content/application~1json/schema/properties/St\ + udentPersonal" + example: >- +The GUID of the student.
+ required: true + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + StudentPersonal: + $ref: "#/paths/~1StudentPersonals/get/responses/200/content/app\ + lication~1json/schema/properties/StudentPersonals/propert\ + ies/StudentPersonal/items" + example: + StudentPersonal: + StudentPersonalRefId: 7C834EA9-EDA1-2090-347F-83297E1C290C + StudentPersonalLocalId: S1234567 + NationalStudentNumber: 2234523 + FirstNZSchoolingDate: 1996-05-04 + PersonInfo: + Name: + FamilyName: Hagrid + GivenName: Rubeus + FullName: Rubeus Hagrid + Type: LGL + IsVerified: N + OtherNameList: + Name: + - FamilyName: Anderson + GivenName: Samuel + FullName: Samuel Anderson + Type: AKA + IsVerified: Y + Verification: + Source: NZPAS + DocumentSerialNumber: L905673 + DocumentExpiryDate: 2019-03-30 + IsConfirmed: true + Timestamp: 2003-11-30T12:34:56.7 + Provider: + RefId: 822f6c83-2841-4a87-9ff9-49730951b3ba + - FamilyName: Rowinski + GivenName: Sam + FullName: "Sam Rowinski " + Type: PRF + IsVerified: N + Demographics: + BirthDate: 1990-09-26 + PlaceOfBirth: Dunedin + CountryOfBirth: ZAF + CitizenshipList: + Country: + - NZL + - ZAF + CitizenshipStatus: NZCI + CitizenshipVerification: + Source: NZPAS + DocumentSerialNumber: L905673 + DocumentExpiryDate: 2019-03-30 + IsConfirmed: true + Timestamp: 2003-11-30T12:34:56.7 + Provider: + RefId: 822f6c83-2841-4a87-9ff9-49730951b3ba + Gender: 2 + LanguageList: + Language: + - Code: NZS01110 + Usage: FL + ProficiencyList: + Proficiency: + Level: AD + Type: SP + - Code: NZS01112 + Usage: SL + ProficiencyList: + Proficiency: + Level: BE + Type: SP + EthnicityList: + Ethnicity: + - PreferenceOrderNumber: 1 + Code: 111 + - PreferenceOrderNumber: 1 + Code: 211 + IwiAffiliationList: + IwiAffiliation: + - NZS0702 + - NZS0601 + ReligiousAffiliationList: + ReligiousAffiliation: + - NZS212 + - NZS215 + AddressList: + Address: + - Type: TH + Role: PHY + Street: + Line1: The Enchanted Wood + Line2: 533 Hogwart's Way + City: Hogsmead + PostalCode: "7733" + - Type: RU + Role: PHY + Street: + Line1: 1175 Lake Ferry Rd + Suburb: RD 1 + City: Martinborough + EmailList: + Email: + - Type: PRIM + Address: hagrid@gmail.com + PhoneNumberList: + PhoneNumber: + Type: MOB + Number: (021) 300 999 + HouseholdContactInfoList: + HouseholdContactInfo: + - PreferenceNumber: 1 + HouseholdContactId: 7d5c3f5c-d89c-4551-9442-6b008207986e + AddressList: + Address: + - Type: DE + Role: POS + Street: + Line1: P O Box 81 + City: Martinborough + PostalCode: "5781" + "{\n \"Email\": { \"Type\": \"PRIM\", \"Address\": \"hagrid@gmail.com\" }\n}": null + PhoneNumberList: + PhoneNumber: + Type: MOB + Number: (021) 300 999 + application/xml: + schema: + type: object + properties: + StudentPersonal: + $ref: "#/paths/~1StudentPersonals/get/responses/200/content/app\ + lication~1json/schema/properties/StudentPersonals/propert\ + ies/StudentPersonal/items" + example: >- +The GUID of the student.
+ required: true + schema: + type: string + responses: + "200": + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + 200" + default: + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + default" + /StudentContactPersonals: + get: + tags: + - StudentContactPersonal + summary: Default operation to get a list of all available StudentContactPersonals + description: Search the set of available StudentContactPersonals, according to the + search criteria in the URL parameters. Returns the first 20 objects + located; with SIF defined navigation headers, indicating how to retrieve + subsequent sets of 20 objects. + parameters: + - name: LocalId + in: path + description: Search for object by LocalId, within the context of the organisation + represented by the ZoneId of the request. + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + StudentContactPersonals: + type: object + description: A List of StudentContactPersonal objects + properties: + StudentContactPersonal: + type: array + items: + required: + - PersonInfo + type: object + properties: + StudentContactPersonalRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[\ + a-fA-F0-9]{4}-[a-fA-F0-9]{12}" + StudentContactPersonalLocalId: + description:This is a common element used to define the + locally assigned identifier associated with an + entity.
+ type: string + HasBOTVote: + type: string + title: Yes Or No Category + description: >- +A reusable code set for yes, no, unknown and + not provided values.
Personal Information collected about the + StudentContact, when that contact is a member of + the Student's whānau.
+ type: object + required: + - Name + properties: + Name: + description:A name used by the person
+ type: object + properties: + Title: + type: string + description:A title or prefix associated with the + name.
+ FamilyName: + type: string + description:Also known as Last Name, although + some cultures may not present a family + name as the last name.
+ GivenName: + type: string + description:Also known as First Name, although + some cultures may not present this name + as the first element in a name. May + contain a composite of all given + names.
+ MiddleName: + type: string + description:Where more than one Given Name, these + may be combined in one composite field + or else populated in several elements. +
+ FamilyNameFirst: + $ref: "#/paths/~1StudentContactPersonals/get/\ + responses/200/content/application~1json\ + /schema/properties/StudentContactPerson\ + als/properties/StudentContactPersonal/i\ + tems/properties/HasBOTVote" + PreferredFamilyName: + type: string + description:A preferred version of the Family + Name. Note:A name cannot have both a + Preferred Family and Preferred Given + Name within the same Name structure – + only one of these fields should be + populated. If a person does have both a + Preferred Family and Preferred Given + Name then this must be populated as a + separate Name of type ‘Preferred’.
+ PreferredFamilyNameFirst: + $ref: "#/paths/~1StudentContactPersonals/get/\ + responses/200/content/application~1json\ + /schema/properties/StudentContactPerson\ + als/properties/StudentContactPersonal/i\ + tems/properties/HasBOTVote" + PreferredGivenName: + type: string + description: "A preferred version of the Given + Name. Note: A name cannot have both a + Preferred Family and Preferred Given + Name within the same Name structure – + only one of these fields should be + populated. If a person does have both a + Preferred Family and Preferred Given + Name then this must be populated as a + separate Name of type ‘Preferred’.
" + Suffix: + type: string + description:Textual suffix like PHD, JP, BSc.
+ FullName: + type: string + description:A combination of all name elements as + one composite text element
+ Type: + type: string + title: Name Usage Type + description: >- +A standardised method of describing + the usage of a name by a person. Where a + person has more than one current name, + the usage type indicates which name may + be used according to the purpose.
+Code values are based on SIF + Australia 3.4.
The name by which an individual + prefers to be known and + addressed.
Only usage type + applicable for student name usage + (other types are not supported by + NSI).
+ enum: + - PRF + - title: Foreign Official Name + description:Included for future usage in NZ, + especially for tertiary + students.
+ enum: + - FON + - title: Previous name + enum: + - PRV + - title: Also Known As + description: AKA or Alias + enum: + - AKA + - title: Name at Birth + enum: + - BTH + - title: Legal Name + description:Legal Name or Official Name as + defined by the organisation which + collects it (legal name is not + defined in this standard)
+ enum: + - LGL + IsVerified: + $ref: "#/paths/~1StudentContactPersonals/get/\ + responses/200/content/application~1json\ + /schema/properties/StudentContactPerson\ + als/properties/StudentContactPersonal/i\ + tems/properties/HasBOTVote" + OtherNameList: + description:Previous, alternate or other names or + aliases associated with the person.
+ type: object + required: + - Name + properties: + Name: + type: array + items: + description:Extension of BaseNameType including + name verification data
+ type: object + properties: + Verification: + description:The verification event that + verified the person's name.
+ type: object + required: + - IsConfirmed + - Source + properties: + Source: + type: string + title: Verification Source + description: >- +Records the source of the + identity or eligibility + verification, that has been + made. Mostly it is merely a + record of the kind of document + that has been presented; but + occasionally it is down to + Principal or Ministry + discretion / approval.
+The serial number on the + document that was used to + verify the name or + birthdate.
+ DocumentExpiryDate: + type: string + format: date + description:The expiry date on the + document that was used to + verify the name or + birthdate.
+ IsConfirmed: + type: boolean + description:If true then verification + has been confirmed by MoE.
+ Timestamp: + description:The date & time that the + VerificationEvent took + place.
+ Provider: + description:A reference to another SIF + Data Object
+ type: object + required: + - ObjectType + properties: + RefId: + $ref: "#/paths/~1StudentContact\ + Personals/get/responses/2\ + 00/content/application~1j\ + son/schema/properties/Stu\ + dentContactPersonals/prop\ + erties/StudentContactPers\ + onal/items/properties/Stu\ + dentContactPersonalRefId" + LocalId: + $ref: "#/paths/~1StudentContact\ + Personals/get/responses/2\ + 00/content/application~1j\ + son/schema/properties/Stu\ + dentContactPersonals/prop\ + erties/StudentContactPers\ + onal/items/properties/Stu\ + dentContactPersonalLocalI\ + d" + Name: + type: string + description:The normal descriptive + name of the referenced + object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid + SIF DataObject names, to + be included in Object + References
The verified name of the person.
+ type: object + properties: + Verification: + description:The verification event that verified + the person's name.
+ type: object + required: + - IsConfirmed + - Source + properties: + Source: + $ref: "#/paths/~1StudentContactPersonals/\ + get/responses/200/content/applicati\ + on~1json/schema/properties/StudentC\ + ontactPersonals/properties/StudentC\ + ontactPersonal/items/properties/Per\ + sonInfo/properties/OtherNameList/pr\ + operties/Name/items/properties/Veri\ + fication/properties/Source" + DocumentSerialNumber: + type: string + description:The serial number on the document + that was used to verify the name or + birthdate.
+ DocumentExpiryDate: + type: string + format: date + description:The expiry date on the document + that was used to verify the name or + birthdate.
+ IsConfirmed: + type: boolean + description:If true then verification has + been confirmed by MoE.
+ Timestamp: + description:The date & time that the + VerificationEvent took place.
+ Provider: + $ref: "#/paths/~1StudentContactPersonals/\ + get/responses/200/content/applicati\ + on~1json/schema/properties/StudentC\ + ontactPersonals/properties/StudentC\ + ontactPersonal/items/properties/Per\ + sonInfo/properties/OtherNameList/pr\ + operties/Name/items/properties/Veri\ + fication/properties/Provider" + x-accessControl: + ? create + ? read + ? update + ? delete + ? aggregate + Demographics: + description:Details of the person’s demographic + properties
+ type: object + properties: + BirthDate: + type: string + format: date + description:The person's date of birth.
+ DateOfDeath: + type: string + format: date + description:The person's date of death.
+ PlaceOfBirth: + type: string + description:The person's place of birth - like + village, town, city etc.
+ CountryOfBirth: + type: string + title: 3166 Country + description: >- +A country is a geopolitical entity + recognised by the New Zealand + government. The term country may + include
Conforms to the International + Standard ISO 3166 Codes for the + Representation of Names of Countries and + their Subdivisions (ISO 3166-1:2013). + Education adopts the alpha-3 + representation of this standard.
+The citizenship or residency status + of a person, principally recorded in + order to determine eligibility for + education services hence limited to + indicating New Zealand, Australian or + Other residency.
Based on SIF + Australia + AUCodeSetsAustralianCitizenshipStatusType
+The verification event that verified + the residency status of the person. + Absence of a verification event + indicates that the residency was not + verified against an identity document. +
+ type: object + required: + - IsConfirmed + - Source + properties: + Source: + $ref: "#/paths/~1StudentContactPersonals/\ + get/responses/200/content/applicati\ + on~1json/schema/properties/StudentC\ + ontactPersonals/properties/StudentC\ + ontactPersonal/items/properties/Per\ + sonInfo/properties/OtherNameList/pr\ + operties/Name/items/properties/Veri\ + fication/properties/Source" + DocumentSerialNumber: + type: string + description:The serial number on the document + that was used to verify the name or + birthdate.
+ DocumentExpiryDate: + type: string + format: date + description:The expiry date on the document + that was used to verify the name or + birthdate.
+ IsConfirmed: + type: boolean + description:If true then verification has + been confirmed by MoE.
+ Timestamp: + description:The date & time that the + VerificationEvent took place.
+ Provider: + $ref: "#/paths/~1StudentContactPersonals/\ + get/responses/200/content/applicati\ + on~1json/schema/properties/StudentC\ + ontactPersonals/properties/StudentC\ + ontactPersonal/items/properties/Per\ + sonInfo/properties/OtherNameList/pr\ + operties/Name/items/properties/Veri\ + fication/properties/Provider" + Gender: + type: string + title: Gender + description: >- +A Person may identify as having a + Gender (or Gender Identity). Biological + sex and sexual orientation are related + but different concepts. Sourced from + Statistics NZ Standard for Gender + Identity
A language that an individual + uses to communicate.
+ type: object + required: + - Code + properties: + Code: + type: string + title: Language + description: >- +Language refers to + recognised human communication + systems, typically oral and/or + written. Sourced from + Statistics NZ - Language + Standard Classification 1999 + v2.0.0
A standardised method of + describing the usage of a + language by a person, + potentially indicating + capability and preference for + the language.
Specific dialect of a + person's language.
+ ProficiencyList: + description:A list of the person's + proficiency in the language in + regards to speaking, reading + and writing.
+ type: object + required: + - Proficiency + properties: + Proficiency: + type: array + items: + description:The person's + proficiency in the + language in regards to + speaking, reading and + writing.
+ type: object + required: + - Level + - Type + properties: + Level: + type: string + title: Language Proficiency + Level + description: >- +The language + proficiency + level.
Code set denoting + a type of language + proficiency, e.g. + speaking, writing + reading.
One or more ethnic groups with which + the person identifies.
+ type: object + required: + - Ethnicity + properties: + Ethnicity: + type: array + items: + description:An ethnic group with which the + person identifies, and if there is + more than one, their order of + preference.
+ type: object + required: + - Code + properties: + PreferenceOrderNumber: + type: integer + description:The order of preference for + the person's ethnicity.
+ Code: + type: string + title: Ethnicity + description: >- +Ethnicity is the ethnic + group or groups that people + identify with or feel they + belong to. Ethnicity is a + measure of cultural + affiliation, as opposed to + race, ancestry, nationality or + citizenship. Ethnicity is self + perceived and people can + belong to more than one ethnic + group.
The permissible + values consists of any value + from the Statistics NZ - + Ethnicity New Zealand Standard + Classification 2005 v2.0.0 + Depending on usage, ethnicity + may be defined at levels 1 to + 4.
A list of one or more iwi with which + the person has an affiliation.
+ type: object + required: + - IwiAffiliation + properties: + IwiAffiliation: + type: array + items: + type: string + title: Iwi + description: >- +An iwi, or Māori tribe, is one + of the largest kinship groupings + and is generally made up of + several hapū that are all + descended from a common ancestor. + Hapū are clusters of whānau where + the whānau is usually an extended + family grouping consisting of + children, parents, often + grandparents, and other closely + related kin.
Sourced from + Statistics NZ - Iwi and Iwi + related groups statistical + standard v1.0.0.0
A list of one or more religions with + which the person has an affiliation.
+ type: object + required: + - ReligiousAffiliation + properties: + ReligiousAffiliation: + type: array + items: + type: string + title: Religion + description: >- +Religious affiliation is the + self-identified association of a + person with a religion, + denomination or sub-denominational + religious group.
Sourced + from Statistics NZ - Religious + Affiliation 1999 v1.0.0.0
This element contains address + data.
+ type: object + required: + - Street + properties: + Type: + type: string + title: Address Type + description: >- +Address type allows an address + to be categorised according to its + component structure. Address type + can be used to build processing + rules for validating, managing and + presenting addresses. Address type + is independent of the use of the + address by any party. To describe + how a party may use an address + (residence, billing, term address + etc) see AddressRoleType
Also called 'Street' + addresses, The most general, + and widely used type of + address, and can contain the + widest variety of + components
In general a + thoroughfare address will + include components for a + number, a roadname, and a + locality.
They cannot + contain any of the components + specific to a delivery + service, rural post delivery, + or water address.
These + addresses are used to find a + location.
Example: 30 - + 40 Lambton Quay, Wellington, + 6165
\"" + enum: + - TH + - title: Rural Post Delivery + description: '"Defined by New Zealand + Post, these addresses are + assigned by NZ Post for + customers who purchase a rural + delivery service (mail and + also other goods).
They + will have the same number and + roadname components as the + street address, and may have + the same region component.
+They do not have a + component that identifies the + locality the address is + within. The locality and city + or town components are + replaced by components that + identify the rural delivery + route (RD number), and the + town from which the rural + delivery route starts and + finishes (the mail town). Only + addresses of this class can + contain these components.
+Example: 121 + Waitaha Road, RD 1, Ross, + 7885
"' + enum: + - RU + - title: Delivery Service + description: '"Defined by New Zealand + Post, and used exclusively for + NZ Post services other than + standard mail delivery. + Addresses in this class + include PO Box, Private Bag, + and Counter Delivery + addresses.
+ Example: Private Bag + 2345, Auckland, 1142
"' + enum: + - DE + - title: Water + description: '"Where properties have no + road access, but do have + access to water frontage + (coastline or riverbank or + lakefront), a water address + uses the name of a water + feature (for example, islands, + rivers, bays, or + peninsulas).
+ Example: 235 Lochmara + Bay, Queen Charlotte Sound, + Marlborough Sounds
"' + enum: + - WA + - title: Foreign Address + description: '"A foreign address + identifies a location outside + of New Zealand.
+ Example: + Rudolf-Diesel-Strasse 14, + 54595 Prüm, Germany
"' + enum: + - FO + Role: + type: string + title: Address Role + description: >- +A standardised description of + the role or usage of an address by + a party (person or organisation). + Where a party has more than one + address, this provides context for + deciding which address to use.
+The street element is a complex + element and breaks the street down + into several parts. (Allow for PO + Box here)
+ type: object + required: + - Line1 + properties: + Line1: + type: string + description:Address line 1.
+ Line2: + type: string + description:Address line 2.
+ Line3: + type: string + description:Address line 3.
+ Suburb: + type: string + description:The suburb part of urban + addresses, or the 'RD No' part of + rural addresses
+ City: + type: string + description:The city part of the + address.
+ StateProvince: + type: string + description:The state or province code. + StateTerritory Code only + applicable if a non-New Zealand + Address.
+ Country: + type: string + description:The country code.
+ PostalCode: + type: string + description:The ZIP/postal code.
+ GridLocation: + description:The latitude & longitude of the + location. Grid location values are + derived from New Zealand Map Grid + x,y coordinates and converted to + Latitude and Longitude values per + the World Geodetic System 1984 + (G1762)
+ type: object + required: + - Latitude + - Longitude + properties: + Latitude: + description:Latitude in decimal + degrees.
Latitudes + north of the equator are + positive, latitudes south of + the equator are negative [ISO + 6709].
+ Longitude: + description:Longitude in decimal + degrees.
Longitudes + east of the Prime Meridian in + Greenwich are positive, + longitudes west of the Prime + Meridian are negative. The + 180th meridian is negative. + [ISO 6709]
+ StatisticalAreaList: + description:A list of Statistical Areas + containing the location.
+The list may contain exactly + one StatisticalArea element for + each of the following spatial unit + types:
A particular statistical + area defined by Statistics + New Zealand.
+ type: object + required: + - Code + - SpatialUnitType + properties: + SpatialUnitType: + type: string + title: Spatial Unit Type + description: >- +A classification of + geographical boundaries + or statistical areas as + defined by Statistics + NZ’s geographic + hierarchy.
Area units are + aggregations of + meshblocks. They are + non–administrative + areas that are in + between meshblocks + and territorial + authorities in size. + Area units must + either define or + aggregate to define, + regional councils, + territorial + authorities and + urban areas.
+ Statistics NZ + Classification of + Area Unit 2013 + v1.0.0 + enum: + - AE + - title: General Electoral + District + description:The general + electoral districts + as constituted under + the Electoral Act + 1993.
Statistics + NZ General Electoral + District 2014 v1.0.0 + enum: + - GE + - title: Community Board + description:(aka Local Board + within Auckland) + Local boards provide + governance at the + local level within + Auckland Council. + They enable + democratic decision + making by, and on + behalf of + communities within + the local board + area.
Statistics + NZ Community Board + 2013 v1.0.0 + enum: + - CB + - title: Māori Electoral + District + description:Māori electoral + districts are the + voting districts for + parliamentary + elections for people + who choose to be on + the Māori Electoral + Roll.
Statistics + NZ Māori Electoral + District 2014 v1.0.0 + enum: + - ME + - title: Mesh Block + description:A meshblock is + the smallest + geographic unit for + which statistical + data is collected + and processed by + Statistics New + Zealand.
A + meshblock is defined + by a geographic + area, which can vary + in size from part of + a city block to a + large area of rural + land. Each meshblock + borders on another + to form a network + covering all of New + Zealand, including + coasts and inlets + and extending out to + the 200-mile + economic zone.
+ Statistics NZ + Statistical Standard + for Meshblock 2013 + v1.0.0 + enum: + - MB + - title: Regional Council + description:The top tier of + local government in + New Zealand, defined + by the Local + Government Act 2002, + which requires the + boundaries of + regions to conform + as far as possible + to one or more water + catchments. When + determining regional + boundaries, the + Local Government + Commission gave + consideration to + regional communities + of interest when + selecting water + catchments to be + included in a + region. It also + considered factors + such as natural + resource management, + land use planning + and environmental + matters.
+ Statistics NZ + Regional Council + 2013 v1.0.0 + enum: + - RC + - title: Territorial Authority + description:The second tier + of local government + in New Zealand, + defined under the + Local Government Act + 2002 as a city + council or district + council. There are + 67 territorial + authorities + consisting of 12 + city councils, 53 + districts, Auckland + Council, and Chatham + Islands Council.
+ Statistics NZ + Territorial + Authority 2013 + v1.0.0 + enum: + - TA + - title: Urban Area + description: '"Urban Areas are + statistically + defined areas with + no administrative or + legal basis. There + is a three part + hierarchical + sub-division of + urban areas into: + main urban areas, + secondary urban + areas, minor urban + areas. Together the + populations in main, + secondary and minor + urban areas comprise + the statistically + defined urban + population of New + Zealand. The urban + area classification + is designed to + identify + concentrated urban + or semi-urban + settlements without + the distortions of + administrative + boundaries.
+ Statistics NZ Urban + Area 2013 v2.0.0"' + enum: + - UA + - title: Ward + description:Wards are defined + under the Local + Electoral Act 2001 + and result from the + division, for + electoral purposes, + of the district of a + territorial + authority. The ward + system was designed + to allow for the + recognition of + communities within a + district and to + increase community + involvement in the + local government + system.
+ Statistics NZ Ward + 2013 v1.0.0 + enum: + - WA + Code: + type: string + description:A valid value defined + by the nominated spatial + unit type, defined by + Statistics New Zealand + in one of the following + statistical area + defintion standards:
+The person's e-mail address(es) - one or + more emails.
+ type: object + required: + - Email + properties: + Email: + type: array + items: + 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: object + required: + - Address + properties: + Type: + type: string + title: Email Type + description: >- +A standardised method of + describing an electronic mail + address used as contact method by + a party. Where a party has more + than one email address, this may + provide context for deciding which + email address to use.
The actual email address.
+ PhoneNumberList: + description:The person's phone number(s) - one or + more phone numbers.
+ type: object + required: + - PhoneNumber + properties: + PhoneNumber: + type: array + items: + description:This element represents a phone + number and occurs within objects such + as StudentPersonal, StaffPersonal, + etc.
+ type: object + required: + - Number + properties: + Type: + type: string + title: Telephone Number Type + description: >- +A standardised method of + describing a telecommunications + device used as contact method by a + party. Where a party has more than + one phone number, this may provide + context for deciding which number + to use.
Phone number. Free-form, but + typical New Zealand formats + include:
Phone number extension.
+ ListedStatus: + $ref: "#/paths/~1StudentContactPersonal\ + s/get/responses/200/content/appli\ + cation~1json/schema/properties/St\ + udentContactPersonals/properties/\ + StudentContactPersonal/items/prop\ + erties/HasBOTVote" + HouseholdContactInfoList: + description:The person's household/s contact + information. A list of one or more + household’s contact information.
+ type: object + required: + - HouseholdContactInfo + properties: + HouseholdContactInfo: + type: array + items: + description:Common element used to supply + information about a particular + household a person is a member of.
+ type: object + properties: + PreferenceNumber: + type: integer + description:Priority of Household Contact + in relation to this Person.
+ HouseholdContactId: + $ref: "#/paths/~1StudentContactPersonal\ + s/get/responses/200/content/appli\ + cation~1json/schema/properties/St\ + udentContactPersonals/properties/\ + StudentContactPersonal/items/prop\ + erties/StudentContactPersonalLoca\ + lId" + HouseholdSalutation: + type: string + description:Salutation to be used in + addressing this household.
+ AddressList: + description:A list of Address elements.
+ type: object + required: + - Address + properties: + Address: + type: array + items: + description:This element contains + address data.
+ type: object + required: + - Street + properties: + Type: + $ref: "#/paths/~1StudentConta\ + ctPersonals/get/respons\ + es/200/content/applicat\ + ion~1json/schema/proper\ + ties/StudentContactPers\ + onals/properties/Studen\ + tContactPersonal/items/\ + properties/PersonInfo/p\ + roperties/AddressList/p\ + roperties/Address/items\ + /properties/Type" + Role: + $ref: "#/paths/~1StudentConta\ + ctPersonals/get/respons\ + es/200/content/applicat\ + ion~1json/schema/proper\ + ties/StudentContactPers\ + onals/properties/Studen\ + tContactPersonal/items/\ + properties/PersonInfo/p\ + roperties/AddressList/p\ + roperties/Address/items\ + /properties/Role" + Street: + description:The street element is + a complex element and + breaks the street down + into several parts. + (Allow for PO Box + here)
+ type: object + required: + - Line1 + properties: + Line1: + type: string + description:Address line + 1.
+ Line2: + type: string + description:Address line + 2.
+ Line3: + type: string + description:Address line + 3.
+ Suburb: + type: string + description:The suburb part of + urban addresses, or the + 'RD No' part of rural + addresses
+ City: + type: string + description:The city part of the + address.
+ StateProvince: + type: string + description:The state or province + code. StateTerritory + Code only applicable if + a non-New Zealand + Address.
+ Country: + type: string + description:The country code.
+ PostalCode: + type: string + description:The ZIP/postal + code.
+ GridLocation: + description:The latitude & + longitude of the + location. Grid location + values are derived from + New Zealand Map Grid x,y + coordinates and + converted to Latitude + and Longitude values per + the World Geodetic + System 1984 (G1762)
+ type: object + required: + - Latitude + - Longitude + properties: + Latitude: + description:Latitude in + decimal degrees.
+Latitudes north + of the equator are + positive, latitudes + south of the equator + are negative [ISO + 6709].
+ Longitude: + description:Longitude in + decimal degrees.
+Longitudes east + of the Prime + Meridian in + Greenwich are + positive, longitudes + west of the Prime + Meridian are + negative. The 180th + meridian is + negative. [ISO + 6709]
+ StatisticalAreaList: + description:A list of Statistical + Areas containing the + location.
The + list may contain exactly + one StatisticalArea + element for each of the + following spatial unit + types:
A particular + statistical area + defined by + Statistics New + Zealand.
+ type: object + required: + - Code + - SpatialUnitType + properties: + SpatialUnitType: + $ref: "#/paths/~1St\ + udentContactPersona\ + ls/get/responses/20\ + 0/content/applicati\ + on~1json/schema/pro\ + perties/StudentCont\ + actPersonals/proper\ + ties/StudentContact\ + Personal/items/prop\ + erties/PersonInfo/p\ + roperties/AddressLi\ + st/properties/Addre\ + ss/items/properties\ + /StatisticalAreaLis\ + t/properties/Statis\ + ticalArea/items/pro\ + perties/SpatialUnit\ + Type" + Code: + type: string + description:A valid + value defined by the + nominated spatial + unit type, defined + by Statistics New + Zealand in one of + the following + statistical area + defintion + standards:
List of Email elements.
+ type: object + required: + - Email + properties: + Email: + type: array + items: + 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: object + required: + - Address + properties: + Type: + $ref: "#/paths/~1StudentConta\ + ctPersonals/get/respons\ + es/200/content/applicat\ + ion~1json/schema/proper\ + ties/StudentContactPers\ + onals/properties/Studen\ + tContactPersonal/items/\ + properties/PersonInfo/p\ + roperties/EmailList/pro\ + perties/Email/items/pro\ + perties/Type" + Address: + type: string + description:The actual email + address.
+ PhoneNumberList: + description:List of PhoneNumber + elements.
+ type: object + required: + - PhoneNumber + properties: + PhoneNumber: + type: array + items: + description:This element represents a + phone number and occurs + within objects such as + StudentPersonal, + StaffPersonal, etc.
+ type: object + required: + - Number + properties: + Type: + $ref: "#/paths/~1StudentConta\ + ctPersonals/get/respons\ + es/200/content/applicat\ + ion~1json/schema/proper\ + ties/StudentContactPers\ + onals/properties/Studen\ + tContactPersonal/items/\ + properties/PersonInfo/p\ + roperties/PhoneNumberLi\ + st/properties/PhoneNumb\ + er/items/properties/Typ\ + e" + Number: + type: string + description: "Phone number. + Free-form, but typical + New Zealand formats + include:
Phone number + extension.
+ ListedStatus: + $ref: "#/paths/~1StudentConta\ + ctPersonals/get/respons\ + es/200/content/applicat\ + ion~1json/schema/proper\ + ties/StudentContactPers\ + onals/properties/Studen\ + tContactPersonal/items/\ + properties/HasBOTVote" + x-accessControl: + ? create + ? read + ? update + ? delete + ? aggregate + HealthcareServiceInfo: + description:Information about the StudentContact, when + that contact is a healthcare service. Details + about the actual healthcare pratitioner are kept + in the PersonInfo fields.
+ type: object + required: + - OrganisationName + - OrganisationPhoneNum + - Type + properties: + OrganisationName: + type: string + description: "The name of the healthcare service, eg: + 'Martinborough Health Centre'
" + OrganisationPhoneNum: + type: string + description:The name phone number of the healthcare + service
+ Notes: + type: string + description:Who at the healthservice is the Student's + regular e.g. 'Dr Phillips'
+ Type: + type: string + title: Healthcare Service Type + description: >- +Code denoting the type of healthcare + service provided by a StudentContact.
+This is a common element used to define the + locally assigned identifier associated with an + entity.
+ type: string + Student: + description:A reference to another SIF Data Object
+ type: object + required: + - ObjectType + properties: + RefId: + $ref: "#/paths/~1StudentContactRelationships/get/\ + responses/200/content/application~1json/sch\ + ema/properties/StudentContactRelationships/\ + properties/StudentContactRelationship/items\ + /properties/StudentContactRelationshipRefId" + LocalId: + $ref: "#/paths/~1StudentContactRelationships/get/\ + responses/200/content/application~1json/sch\ + ema/properties/StudentContactRelationships/\ + properties/StudentContactRelationship/items\ + /properties/StudentContactRelationshipLocal\ + ID" + Name: + type: string + description:The normal descriptive name of the + referenced object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject + names, to be included in Object + References
Defines the relationship of the contact to + the student.
+ type: object + required: + - Code + properties: + Code: + type: string + title: Relationship To Student + description: >- +A standardised method of describing the + personal relationship between two persons. + Such a relationship arises from two persons + belonging to the same family or closer + community or as a consequence of sharing + living arrangements.
A free text description of relationship + type, where Relationship To Student Type is + set to ‘Other’, eg ‘Au-pair’, + ‘Neighbour’
+ LanguageUsed: + type: string + title: Language + description: >- +Language refers to recognised human + communication systems, typically oral and/or + written. Sourced from Statistics NZ - Language + Standard Classification 1999 v2.0.0
A list of one or more household identifiers + indicating the households associated with this + relationship.
+ type: object + required: + - HouseholdId + properties: + HouseholdId: + type: array + items: + $ref: "#/paths/~1StudentContactRelationships/ge\ + t/responses/200/content/application~1json\ + /schema/properties/StudentContactRelation\ + ships/properties/StudentContactRelationsh\ + ip/items/properties/StudentContactRelatio\ + nshipLocalID" + ContactFlags: + description:Contains characteristics of the contact + person's role with the Student. At least one of + the flags must be populated with a 'Yes' + value.
+ type: object + properties: + ParentLegalGuardian: + type: string + title: Yes Or No Category + description: >- +A reusable code set for yes, no, unknown + and not provided values.
Number indicating the order in which the + student contact should be contacted.
+ description:A relationship between a person who is part of a + Student's whānau and that Student. Relationship + properties include the relationship type and roles + played by the student contact in respect of the + student.
Individual details about the student + and student contact are provided in other data + objects - StudentPersonal and StudentContactPersonal + respectively.
+ x-accessControl: + create: + - 1001 + - 2401 + - 2403 + read: + - 1001 + - 2401 + - 2403 + update: + - 1001 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: [] + example: + StudentContactRelationships: + StudentContactRelationship: + - StudentContactRelationshipRefId: 7572B261-0947-583A-463D-BB345291B332 + Student: + RefId: DEE34B35-9D75-101A-8C3D-00AA001A1652 + StudentContact: + RefId: 6472B261-0947-583A-463D-BB345291B001 + Provider: + RefId: 4661c4c8-fd03-4fc6-8af7-5084338494db + Relationship: + Code: LEG + HouseholdList: + HouseholdId: + - FamilyA + - FamilyB + ContactFlags: + ParentLegalGuardian: Y + PickupRights: Y + LivesWith: N + AccessToRecords: U + ReceivesAssessmentReport: Y + EmergencyContact: Y + CivilDefenceEmergencyContact: N + DisciplinaryContact: N + AttendanceContact: N + PrimaryCareProvider: U + FeesBilling: Y + FamilyMail: Y + CourtOrder: N + ContactSequence: 1 + application/xml: + schema: + type: object + properties: + StudentContactRelationships: + type: object + description: A List of StudentContactRelationship objects + properties: + StudentContactRelationship: + type: array + items: + $ref: "#/paths/~1StudentContactRelationships/get/response\ + s/200/content/application~1json/schema/properties/S\ + tudentContactRelationships/properties/StudentContac\ + tRelationship/items" + example: >- +The SIF GUID for the student contact relationship.
+ required: true + schema: + type: string + operationId: createStudentContactRelationship + requestBody: + description: CRUD operation on StudentContactRelationship + content: + application/json: + schema: + type: object + properties: + StudentContactRelationship: + $ref: "#/paths/~1StudentContactRelationships/get/responses/200/co\ + ntent/application~1json/schema/properties/StudentContactRel\ + ationships/properties/StudentContactRelationship/items" + example: + StudentContactRelationship: + StudentContactRelationshipRefId: 7572B261-0947-583A-463D-BB345291B332 + Student: + RefId: DEE34B35-9D75-101A-8C3D-00AA001A1652 + StudentContact: + RefId: 6472B261-0947-583A-463D-BB345291B001 + Provider: + RefId: 4661c4c8-fd03-4fc6-8af7-5084338494db + Relationship: + Code: LEG + HouseholdList: + HouseholdId: + - FamilyA + - FamilyB + ContactFlags: + ParentLegalGuardian: Y + PickupRights: Y + LivesWith: N + AccessToRecords: U + ReceivesAssessmentReport: Y + EmergencyContact: Y + CivilDefenceEmergencyContact: N + DisciplinaryContact: N + AttendanceContact: N + PrimaryCareProvider: U + FeesBilling: Y + FamilyMail: Y + CourtOrder: N + ContactSequence: 1 + application/xml: + schema: + type: object + properties: + StudentContactRelationship: + $ref: "#/paths/~1StudentContactRelationships/get/responses/200/co\ + ntent/application~1json/schema/properties/StudentContactRel\ + ationships/properties/StudentContactRelationship/items" + example: >- +The SIF GUID for the student contact relationship.
+ required: true + schema: + type: string + operationId: updateStudentContactRelationship + requestBody: + description: CRUD operation on StudentContactRelationship + content: + application/json: + schema: + type: object + properties: + StudentContactRelationship: + type: object + properties: + StudentContactRelationshipRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-\ + 9]{4}-[a-fA-F0-9]{12}" + StudentContactRelationshipLocalID: + description:This is a common element used to define the locally + assigned identifier associated with an entity.
+ type: string + Student: + description:A reference to another SIF Data Object
+ type: object + properties: + RefId: + $ref: "#/paths/~1StudentContactRelationships~1%7BStudentC\ + ontactRelationshipRefId%7D/put/requestBody/content/\ + application~1json/schema/properties/StudentContactR\ + elationship/properties/StudentContactRelationshipRe\ + fId" + LocalId: + $ref: "#/paths/~1StudentContactRelationships~1%7BStudentC\ + ontactRelationshipRefId%7D/put/requestBody/content/\ + application~1json/schema/properties/StudentContactR\ + elationship/properties/StudentContactRelationshipLo\ + calID" + Name: + type: string + description:The normal descriptive name of the referenced + object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject names, to + be included in Object References
Defines the relationship of the contact to the + student.
+ type: object + properties: + Code: + type: string + title: Relationship To Student + description: >- +A standardised method of describing the personal + relationship between two persons. Such a + relationship arises from two persons belonging to + the same family or closer community or as a + consequence of sharing living arrangements.
A free text description of relationship type, + where Relationship To Student Type is set to + ‘Other’, eg ‘Au-pair’, ‘Neighbour’
+ LanguageUsed: + type: string + title: Language + description: >- +Language refers to recognised human communication + systems, typically oral and/or written. Sourced from + Statistics NZ - Language Standard Classification 1999 + v2.0.0
A list of one or more household identifiers + indicating the households associated with this + relationship.
+ type: object + properties: + HouseholdId: + type: array + items: + $ref: "#/paths/~1StudentContactRelationships~1%7BStuden\ + tContactRelationshipRefId%7D/put/requestBody/cont\ + ent/application~1json/schema/properties/StudentCo\ + ntactRelationship/properties/StudentContactRelati\ + onshipLocalID" + ContactFlags: + description:Contains characteristics of the contact person's role + with the Student. At least one of the flags must be + populated with a 'Yes' value.
+ type: object + properties: + ParentLegalGuardian: + type: string + title: Yes Or No Category + description: >- +A reusable code set for yes, no, unknown and not + provided values.
Number indicating the order in which the student + contact should be contacted.
+ description:A relationship between a person who is part of a + Student's whānau and that Student. Relationship properties + include the relationship type and roles played by the + student contact in respect of the student.
Individual + details about the student and student contact are provided + in other data objects - StudentPersonal and + StudentContactPersonal respectively.
+ x-accessControl: + create: + - 1001 + - 2401 + - 2403 + read: + - 1001 + - 2401 + - 2403 + update: + - 1001 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: [] + example: + StudentContactRelationship: + StudentContactRelationshipRefId: 7572B261-0947-583A-463D-BB345291B332 + Student: + RefId: DEE34B35-9D75-101A-8C3D-00AA001A1652 + StudentContact: + RefId: 6472B261-0947-583A-463D-BB345291B001 + Provider: + RefId: 4661c4c8-fd03-4fc6-8af7-5084338494db + Relationship: + Code: LEG + HouseholdList: + HouseholdId: + - FamilyA + - FamilyB + ContactFlags: + ParentLegalGuardian: Y + PickupRights: Y + LivesWith: N + AccessToRecords: U + ReceivesAssessmentReport: Y + EmergencyContact: Y + CivilDefenceEmergencyContact: N + DisciplinaryContact: N + AttendanceContact: N + PrimaryCareProvider: U + FeesBilling: Y + FamilyMail: Y + CourtOrder: N + ContactSequence: 1 + application/xml: + schema: + type: object + properties: + StudentContactRelationship: + $ref: "#/paths/~1StudentContactRelationships~1%7BStudentContactRe\ + lationshipRefId%7D/put/requestBody/content/application~1jso\ + n/schema/properties/StudentContactRelationship" + example: >- +The SIF GUID for the student contact relationship.
+ required: true + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + StudentContactRelationship: + $ref: "#/paths/~1StudentContactRelationships/get/responses/200/\ + content/application~1json/schema/properties/StudentContac\ + tRelationships/properties/StudentContactRelationship/item\ + s" + example: + StudentContactRelationship: + StudentContactRelationshipRefId: 7572B261-0947-583A-463D-BB345291B332 + Student: + RefId: DEE34B35-9D75-101A-8C3D-00AA001A1652 + StudentContact: + RefId: 6472B261-0947-583A-463D-BB345291B001 + Provider: + RefId: 4661c4c8-fd03-4fc6-8af7-5084338494db + Relationship: + Code: LEG + HouseholdList: + HouseholdId: + - FamilyA + - FamilyB + ContactFlags: + ParentLegalGuardian: Y + PickupRights: Y + LivesWith: N + AccessToRecords: U + ReceivesAssessmentReport: Y + EmergencyContact: Y + CivilDefenceEmergencyContact: N + DisciplinaryContact: N + AttendanceContact: N + PrimaryCareProvider: U + FeesBilling: Y + FamilyMail: Y + CourtOrder: N + ContactSequence: 1 + application/xml: + schema: + type: object + properties: + StudentContactRelationship: + $ref: "#/paths/~1StudentContactRelationships/get/responses/200/\ + content/application~1json/schema/properties/StudentContac\ + tRelationships/properties/StudentContactRelationship/item\ + s" + example: >- +The SIF GUID for the student contact relationship.
+ required: true + schema: + type: string + responses: + "200": + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + 200" + default: + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + default" + /Documents: + get: + tags: + - Document + summary: Default operation to get a list of all available Documents + description: Search the set of available Documents, according to the search criteria + in the URL parameters. Returns the first 20 objects located; with SIF + defined navigation headers, indicating how to retrieve subsequent sets + of 20 objects. + parameters: + - name: LocalId + in: path + description: Search for object by LocalId, within the context of the organisation + represented by the ZoneId of the request. + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + Documents: + type: object + description: A List of Document objects + properties: + Document: + type: array + items: + required: + - DocumentTitle + - Provider + type: object + properties: + DocumentRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[\ + a-fA-F0-9]{4}-[a-fA-F0-9]{12}" + DocumentLocalId: + description:This is a common element used to define the + locally assigned identifier associated with an + entity.
+ type: string + Provider: + description:A reference to another SIF Data Object
+ type: object + required: + - ObjectType + properties: + RefId: + $ref: "#/paths/~1Documents/get/responses/200/cont\ + ent/application~1json/schema/properties/Doc\ + uments/properties/Document/items/properties\ + /DocumentRefId" + LocalId: + $ref: "#/paths/~1Documents/get/responses/200/cont\ + ent/application~1json/schema/properties/Doc\ + uments/properties/Document/items/properties\ + /DocumentLocalId" + Name: + type: string + description:The normal descriptive name of the + referenced object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject + names, to be included in Object + References
Location of Documentation.
+ DocumentTitle: + type: string + description:Document's full title.
+ DocumentDescription: + type: string + description:What the document is and how it is related to + the Student.
+ AddedDateTime: + type: string + format: date + description:The date the document was added at the source + system.
+ ReviewDate: + type: string + format: date + description:Document Review Date.
+ URL: + type: string + format: uri + description:URL if known.
+ NoteText: + type: string + description:If the type of document is 'Note' then this + is populated with the free text that makes up + the note.
+ RelatedToList: + description:A list of objects that this document relates + to, e.g. a Wellbeing Response or Characteristic, + Physical Restraint.
+ type: object + required: + - RelatedTo + properties: + RelatedTo: + type: array + items: + $ref: "#/paths/~1Documents/get/responses/200/co\ + ntent/application~1json/schema/properties\ + /Documents/properties/Document/items/prop\ + erties/Provider" + DocumentClassification: + type: string + title: Document Classification + description: >- +Standard codes denoting the classification of + the Document.
Standard codes denoting the type of + Document.
The list of people associated to a document + and their role in relation to it, e.g. author, + owner, reviewer, subject of.
+ type: object + required: + - PersonDocumentRole + properties: + PersonDocumentRole: + type: array + items: + description:A person associated to a document and + their role in relation to it, e.g. author, + owner, reviewer, subject of.
+ type: object + required: + - ObjectType + properties: + Role: + type: string + title: Document Role + description: >- +A code set denoting the role a + person performs in relation to a + document and their role in relation to + it, e.g. author, owner, reviewer, + subject of.
Location and meta-data of a document, including + evidentiary documents, personalised plans, and + action plans.
+ x-accessControl: + create: + - 1001 + - 2401 + - 2403 + read: + - 1001 + - 2101 + - 2401 + - 2403 + update: + - 1001 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: [] + example: + Documents: + Document: + - DocumentRefId: 2FFB63B4-CFEF-4820-8501-E7D1E54555CB + Provider: + RefId: CA285746-359D-7510-1A8C-36432A901A16 + DocumentDescription: Timmy McGannaway's IEP for 2019 + URL: http://somehost.co.nz/docs/ghf12312 + DocumentType: IEP + PersonDocumentRoleList: + PersonDocumentRole: + - RefId: 17c9b7aa-bc34-435f-8bba-7e337891f53b + ObjectType: StudentPersonal + Role: SU + - RefId: 2a288f40-c3fb-4d9c-857e-0e562f3f5dde + ObjectType: StaffPersonal + Role: AU + application/xml: + schema: + type: object + properties: + Documents: + type: object + description: A List of Document objects + properties: + Document: + type: array + items: + $ref: "#/paths/~1Documents/get/responses/200/content/appl\ + ication~1json/schema/properties/Documents/propertie\ + s/Document/items" + example: >- +The ID (GUID) assigned to uniquely identify this Document.
+ required: true + schema: + type: string + operationId: createDocument + requestBody: + description: CRUD operation on Document + content: + application/json: + schema: + type: object + properties: + Document: + $ref: "#/paths/~1Documents/get/responses/200/content/application~\ + 1json/schema/properties/Documents/properties/Document/items" + example: + Document: + DocumentRefId: 2FFB63B4-CFEF-4820-8501-E7D1E54555CB + Provider: + RefId: CA285746-359D-7510-1A8C-36432A901A16 + DocumentDescription: Timmy McGannaway's IEP for 2019 + URL: http://somehost.co.nz/docs/ghf12312 + DocumentType: IEP + PersonDocumentRoleList: + PersonDocumentRole: + - RefId: 17c9b7aa-bc34-435f-8bba-7e337891f53b + ObjectType: StudentPersonal + Role: SU + - RefId: 2a288f40-c3fb-4d9c-857e-0e562f3f5dde + ObjectType: StaffPersonal + Role: AU + application/xml: + schema: + type: object + properties: + Document: + $ref: "#/paths/~1Documents/get/responses/200/content/application~\ + 1json/schema/properties/Documents/properties/Document/items" + example: >- +The ID (GUID) assigned to uniquely identify this Document.
+ required: true + schema: + type: string + operationId: updateDocument + requestBody: + description: CRUD operation on Document + content: + application/json: + schema: + type: object + properties: + Document: + type: object + properties: + DocumentRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-\ + 9]{4}-[a-fA-F0-9]{12}" + DocumentLocalId: + description:This is a common element used to define the locally + assigned identifier associated with an entity.
+ type: string + Provider: + description:A reference to another SIF Data Object
+ type: object + properties: + RefId: + $ref: "#/paths/~1Documents~1%7BDocumentRefId%7D/put/reque\ + stBody/content/application~1json/schema/properties/\ + Document/properties/DocumentRefId" + LocalId: + $ref: "#/paths/~1Documents~1%7BDocumentRefId%7D/put/reque\ + stBody/content/application~1json/schema/properties/\ + Document/properties/DocumentLocalId" + Name: + type: string + description:The normal descriptive name of the referenced + object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject names, to + be included in Object References
Location of Documentation.
+ DocumentTitle: + type: string + description:Document's full title.
+ DocumentDescription: + type: string + description:What the document is and how it is related to the + Student.
+ AddedDateTime: + type: string + format: date + description:The date the document was added at the source + system.
+ ReviewDate: + type: string + format: date + description:Document Review Date.
+ URL: + type: string + format: uri + description:URL if known.
+ NoteText: + type: string + description:If the type of document is 'Note' then this is + populated with the free text that makes up the note.
+ RelatedToList: + description:A list of objects that this document relates to, e.g. + a Wellbeing Response or Characteristic, Physical + Restraint.
+ type: object + properties: + RelatedTo: + type: array + items: + $ref: "#/paths/~1Documents~1%7BDocumentRefId%7D/put/req\ + uestBody/content/application~1json/schema/propert\ + ies/Document/properties/Provider" + DocumentClassification: + type: string + title: Document Classification + description: >- +Standard codes denoting the classification of the + Document.
Standard codes denoting the type of Document.
+The list of people associated to a document and their + role in relation to it, e.g. author, owner, reviewer, + subject of.
+ type: object + properties: + PersonDocumentRole: + type: array + items: + description:A person associated to a document and their + role in relation to it, e.g. author, owner, + reviewer, subject of.
+ type: object + properties: + Role: + type: string + title: Document Role + description: >- +A code set denoting the role a person + performs in relation to a document and their + role in relation to it, e.g. author, owner, + reviewer, subject of.
Location and meta-data of a document, including + evidentiary documents, personalised plans, and action + plans.
+ x-accessControl: + create: + - 1001 + - 2401 + - 2403 + read: + - 1001 + - 2101 + - 2401 + - 2403 + update: + - 1001 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: [] + example: + Document: + DocumentRefId: 2FFB63B4-CFEF-4820-8501-E7D1E54555CB + Provider: + RefId: CA285746-359D-7510-1A8C-36432A901A16 + DocumentDescription: Timmy McGannaway's IEP for 2019 + URL: http://somehost.co.nz/docs/ghf12312 + DocumentType: IEP + PersonDocumentRoleList: + PersonDocumentRole: + - RefId: 17c9b7aa-bc34-435f-8bba-7e337891f53b + ObjectType: StudentPersonal + Role: SU + - RefId: 2a288f40-c3fb-4d9c-857e-0e562f3f5dde + ObjectType: StaffPersonal + Role: AU + application/xml: + schema: + type: object + properties: + Document: + $ref: "#/paths/~1Documents~1%7BDocumentRefId%7D/put/requestBody/c\ + ontent/application~1json/schema/properties/Document" + example: >- +The ID (GUID) assigned to uniquely identify this Document.
+ required: true + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + Document: + $ref: "#/paths/~1Documents/get/responses/200/content/applicatio\ + n~1json/schema/properties/Documents/properties/Document/i\ + tems" + example: + Document: + DocumentRefId: 2FFB63B4-CFEF-4820-8501-E7D1E54555CB + Provider: + RefId: CA285746-359D-7510-1A8C-36432A901A16 + DocumentDescription: Timmy McGannaway's IEP for 2019 + URL: http://somehost.co.nz/docs/ghf12312 + DocumentType: IEP + PersonDocumentRoleList: + PersonDocumentRole: + - RefId: 17c9b7aa-bc34-435f-8bba-7e337891f53b + ObjectType: StudentPersonal + Role: SU + - RefId: 2a288f40-c3fb-4d9c-857e-0e562f3f5dde + ObjectType: StaffPersonal + Role: AU + application/xml: + schema: + type: object + properties: + Document: + $ref: "#/paths/~1Documents/get/responses/200/content/applicatio\ + n~1json/schema/properties/Documents/properties/Document/i\ + tems" + example: >- +The ID (GUID) assigned to uniquely identify this Document.
+ required: true + schema: + type: string + responses: + "200": + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + 200" + default: + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + default" + /StudentConsents: + get: + tags: + - StudentConsent + summary: Default operation to get a list of all available StudentConsents + description: Search the set of available StudentConsents, according to the search + criteria in the URL parameters. Returns the first 20 objects located; + with SIF defined navigation headers, indicating how to retrieve + subsequent sets of 20 objects. + parameters: + - name: LocalId + in: path + description: Search for object by LocalId, within the context of the organisation + represented by the ZoneId of the request. + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + StudentConsents: + type: object + description: A List of StudentConsent objects + properties: + StudentConsent: + type: array + items: + required: + - ConsentDate + - ConsentGiven + - ConsentTo + - Organisation + - Student + type: object + properties: + StudentConsentRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[\ + a-fA-F0-9]{4}-[a-fA-F0-9]{12}" + StudentConsentLocalId: + description:This is a common element used to define the + locally assigned identifier associated with an + entity.
+ type: string + Student: + description:A reference to another SIF Data Object
+ type: object + required: + - ObjectType + properties: + RefId: + $ref: "#/paths/~1StudentConsents/get/responses/20\ + 0/content/application~1json/schema/properti\ + es/StudentConsents/properties/StudentConsen\ + t/items/properties/StudentConsentRefId" + LocalId: + $ref: "#/paths/~1StudentConsents/get/responses/20\ + 0/content/application~1json/schema/properti\ + es/StudentConsents/properties/StudentConsen\ + t/items/properties/StudentConsentLocalId" + Name: + type: string + description:The normal descriptive name of the + referenced object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject + names, to be included in Object + References
Code set denoting what the student is + consenting or not consenting to.
A reusable code set for yes, no, unknown and + not provided values.
The date the consent or no consent was + given.
+ ConsentRevokedDate: + type: string + format: date + description:The date the consent ended, if it was + given.
+ RelatedObject: + $ref: "#/paths/~1StudentConsents/get/responses/200/co\ + ntent/application~1json/schema/properties/Stude\ + ntConsents/properties/StudentConsent/items/prop\ + erties/Student" + AdditionalInformation: + type: string + description:Additional free text information provided + about the consent.
+ description: A record of Student's consent or non-consent to some + action taking place. + x-accessControl: + create: + - 1001 + - 2401 + - 2403 + read: + - 1001 + - 2401 + - 2403 + update: + - 1001 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: [] + example: + StudentConsents: + StudentConsent: + - StudentConsentRefId: 7C834EA9-EDA1-2090-347F-83297E1C290C + StudentConsentLocalId: S1234567 + application/xml: + schema: + type: object + properties: + StudentConsents: + type: object + description: A List of StudentConsent objects + properties: + StudentConsent: + type: array + items: + $ref: "#/paths/~1StudentConsents/get/responses/200/conten\ + t/application~1json/schema/properties/StudentConsen\ + ts/properties/StudentConsent/items" + example: >- +The GUID of the student consent.
+ required: true + schema: + type: string + operationId: createStudentConsent + requestBody: + description: CRUD operation on StudentConsent + content: + application/json: + schema: + type: object + properties: + StudentConsent: + $ref: "#/paths/~1StudentConsents/get/responses/200/content/applic\ + ation~1json/schema/properties/StudentConsents/properties/St\ + udentConsent/items" + example: + StudentConsent: + StudentConsentRefId: 7C834EA9-EDA1-2090-347F-83297E1C290C + StudentConsentLocalId: S1234567 + application/xml: + schema: + type: object + properties: + StudentConsent: + $ref: "#/paths/~1StudentConsents/get/responses/200/content/applic\ + ation~1json/schema/properties/StudentConsents/properties/St\ + udentConsent/items" + example: >- +The GUID of the student consent.
+ required: true + schema: + type: string + operationId: updateStudentConsent + requestBody: + description: CRUD operation on StudentConsent + content: + application/json: + schema: + type: object + properties: + StudentConsent: + type: object + properties: + StudentConsentRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-\ + 9]{4}-[a-fA-F0-9]{12}" + StudentConsentLocalId: + description:This is a common element used to define the locally + assigned identifier associated with an entity.
+ type: string + Student: + description:A reference to another SIF Data Object
+ type: object + properties: + RefId: + $ref: "#/paths/~1StudentConsents~1%7BStudentConsentRefId%\ + 7D/put/requestBody/content/application~1json/schema\ + /properties/StudentConsent/properties/StudentConsen\ + tRefId" + LocalId: + $ref: "#/paths/~1StudentConsents~1%7BStudentConsentRefId%\ + 7D/put/requestBody/content/application~1json/schema\ + /properties/StudentConsent/properties/StudentConsen\ + tLocalId" + Name: + type: string + description:The normal descriptive name of the referenced + object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject names, to + be included in Object References
Code set denoting what the student is consenting or + not consenting to.
A reusable code set for yes, no, unknown and not + provided values.
The date the consent or no consent was given.
+ ConsentRevokedDate: + type: string + format: date + description:The date the consent ended, if it was given.
+ RelatedObject: + $ref: "#/paths/~1StudentConsents~1%7BStudentConsentRefId%7D/p\ + ut/requestBody/content/application~1json/schema/propert\ + ies/StudentConsent/properties/Student" + AdditionalInformation: + type: string + description:Additional free text information provided about the + consent.
+ description: A record of Student's consent or non-consent to some action + taking place. + x-accessControl: + create: + - 1001 + - 2401 + - 2403 + read: + - 1001 + - 2401 + - 2403 + update: + - 1001 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: [] + example: + StudentConsent: + StudentConsentRefId: 7C834EA9-EDA1-2090-347F-83297E1C290C + StudentConsentLocalId: S1234567 + application/xml: + schema: + type: object + properties: + StudentConsent: + $ref: "#/paths/~1StudentConsents~1%7BStudentConsentRefId%7D/put/r\ + equestBody/content/application~1json/schema/properties/Stud\ + entConsent" + example: >- +The GUID of the student consent.
+ required: true + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + StudentConsent: + $ref: "#/paths/~1StudentConsents/get/responses/200/content/appl\ + ication~1json/schema/properties/StudentConsents/propertie\ + s/StudentConsent/items" + example: + StudentConsent: + StudentConsentRefId: 7C834EA9-EDA1-2090-347F-83297E1C290C + StudentConsentLocalId: S1234567 + application/xml: + schema: + type: object + properties: + StudentConsent: + $ref: "#/paths/~1StudentConsents/get/responses/200/content/appl\ + ication~1json/schema/properties/StudentConsents/propertie\ + s/StudentConsent/items" + example: >- +The GUID of the student consent.
+ required: true + schema: + type: string + responses: + "200": + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + 200" + default: + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + default" + /TeachingGroups: + get: + tags: + - TeachingGroup + summary: Default operation to get a list of all available TeachingGroups + description: Search the set of available TeachingGroups, according to the search + criteria in the URL parameters. Returns the first 20 objects located; + with SIF defined navigation headers, indicating how to retrieve + subsequent sets of 20 objects. + parameters: + - name: LocalId + in: path + description: Search for object by LocalId, within the context of the organisation + represented by the ZoneId of the request. + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + TeachingGroups: + type: object + description: A List of TeachingGroup objects + properties: + TeachingGroup: + type: array + items: + required: + - Provider + - SchoolYear + - ShortName + type: object + properties: + TeachingGroupRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[\ + a-fA-F0-9]{4}-[a-fA-F0-9]{12}" + TeachingGroupLocalId: + description:This is a common element used to define the + locally assigned identifier associated with an + entity.
+ type: string + ShortName: + type: string + description:Short free format label that describes the + group.
+ LongName: + type: string + description:Longer description if required.
+ GroupType: + type: string + title: Teaching Group Type + description: >- +Provides the means of identifying the type of + group such as Roll class, Subject class or + Homeroom and allows systems to treat them + accordingly
A reference to another SIF Data Object
+ type: object + required: + - ObjectType + properties: + RefId: + $ref: "#/paths/~1TeachingGroups/get/responses/200\ + /content/application~1json/schema/propertie\ + s/TeachingGroups/properties/TeachingGroup/i\ + tems/properties/TeachingGroupRefId" + LocalId: + $ref: "#/paths/~1TeachingGroups/get/responses/200\ + /content/application~1json/schema/propertie\ + s/TeachingGroups/properties/TeachingGroup/i\ + tems/properties/TeachingGroupLocalId" + Name: + type: string + description:The normal descriptive name of the + referenced object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject + names, to be included in Object + References
The SchoolYear that the class represented by + the TeachingGroup is being taught.
+ BeginDate: + type: string + format: date + description:The start date of the first Timetable that + the class represented by the TeachingGroup is + being taught in the nominated school year.
+ EndDate: + type: string + format: date + description:The end date of the last Timetable that the + class represented by the TeachingGroup is being + taught in the nominated school year.
+ StudentList: + description:List of Students in this Teaching Group
+ type: object + required: + - Student + properties: + Student: + type: array + items: + $ref: "#/paths/~1TeachingGroups/get/responses/2\ + 00/content/application~1json/schema/prope\ + rties/TeachingGroups/properties/TeachingG\ + roup/items/properties/Provider" + TeacherList: + description:A List of staff associated with the group – + may or may not include the teacher timetabled in + the schedule.
+ type: object + required: + - StaffMember + properties: + StaffMember: + type: array + items: + description:The individual staff member as a member + of the StaffList and their role.
+ type: object + required: + - ObjectType + - Role + properties: + Role: + type: string + title: Staff Role + description: >- +Describes the role a staff member + has at a Provider or other + EducationOrganisation.
List of generic references denoting the + Courses the TeachingGroup is being taught.
+ type: object + required: + - Course + properties: + Course: + type: array + items: + $ref: "#/paths/~1TeachingGroups/get/responses/2\ + 00/content/application~1json/schema/prope\ + rties/TeachingGroups/properties/TeachingG\ + roup/items/properties/Provider" + SubjectAreaList: + description:List of codes denoting the Learning or + Subject Areas of the Course the TeachingGroup is + being taught.
+ type: object + properties: + SubjectAreaList: + type: array + items: + SubjectArea: + type: string + title: Subject Area + description: >- +Codes denoting Subject Areas defined + by the NZ Curriculum and Te Marautanga o + Aotearoa.
Codes denoting Subject Areas defined + by the NZQA for NCEA.
For Subject Class teaching groups: the list + of codes denoting the Year Levels of the Course + the TeachingGroup is being taught.
For + Roll Class teaching groups, the Year Levels of + the students in the roll class group.
" + type: object + required: + - YearLevel + properties: + YearLevel: + type: array + items: + type: string + title: Year Level Code + description: >- +Year Level defines the values that are + valid for describing Funding Year Level + and Current Year Level for a student + enrolment.
Current Year Level + indicates the year level of the student’s + class cohort and the level at which the + student spends most of their time at + school. While a student may be enrolled in + subjects at varying instructional year + levels, in relation to the student + enrolment this value represents the year + level at which the student is considered + to be predominantly taught.
Funding + Year Level measures the actual number of + years that the student has attended a + school. It provides the Ministry with a + method of counting students for funding + purposes which is independent of the way + schools are organised or the particular + programme of study that a student may + undertake. Funding Year Level for most + students is based on the date they first + started school.
School Year Level + is used to indicate the instructional year + levels offered by a school, i.e. those + years for which student enrolments may be + accepted.
Identifies a particular class or other group of + students. Such groups can have multiple staff + assigned in a variety of roles, may be assigned + students from multiple year levels and may be taught + multiple courses.
+ x-accessControl: + create: + - 1001 + - 2401 + - 2403 + read: + - 1001 + - 2401 + - 2403 + update: + - 1001 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: [] + example: + TeachingGroups: + TeachingGroup: + - TeachingGroupRefId: 64A309DA-063A-2E35-B359-D75101A8C3D1 + TeachingGroupLocalId: 20087ASPN + ShortName: 7A SPN + LongName: Year 7A Maths - Space and Numbers + GroupType: SC + Provider: + RefId: 64A309DA-063A-2E35-B359-FACEA8C12312 + LocalId: 234 + SchoolYear: 2018 + BeginDate: 2018-02-04 + EndDate: 2018-12-05 + StudentList: + Student: + - RefId: 9897466F-200E-4BC1-B9AE-D1507DA15CEF + LocalId: SMI001 + Name: Peter Smith + - RefId: 7C834EA9-EDA1-2090-347F-83297E1C290D + LocalId: SMI002 + Name: Jennifer Smith + - RefId: 7C834EA9-EDA1-2090-347F-83297E1C290E + LocalId: SMI003 + Name: Terence Smith + TeacherList: + StaffMember: + - RefId: A8C3A2E3-5B35-9D75-101D-00AA001A0000 + LocalId: SMI1 + Name: Thomas Smith + Role: "1001" + - RefId: A8CCCCE3-5B35-9D75-101D-00AA001A0000 + LocalId: LONG2 + Name: Tamara Long + Role: "1002" + application/xml: + schema: + type: object + properties: + TeachingGroups: + type: object + description: A List of TeachingGroup objects + properties: + TeachingGroup: + type: array + items: + $ref: "#/paths/~1TeachingGroups/get/responses/200/content\ + /application~1json/schema/properties/TeachingGroups\ + /properties/TeachingGroup/items" + example: >- +The GUID of the TeachingGroup
+ required: true + schema: + type: string + operationId: createTeachingGroup + requestBody: + description: CRUD operation on TeachingGroup + content: + application/json: + schema: + type: object + properties: + TeachingGroup: + $ref: "#/paths/~1TeachingGroups/get/responses/200/content/applica\ + tion~1json/schema/properties/TeachingGroups/properties/Teac\ + hingGroup/items" + example: + TeachingGroup: + TeachingGroupRefId: 64A309DA-063A-2E35-B359-D75101A8C3D1 + TeachingGroupLocalId: 20087ASPN + ShortName: 7A SPN + LongName: Year 7A Maths - Space and Numbers + GroupType: SC + Provider: + RefId: 64A309DA-063A-2E35-B359-FACEA8C12312 + LocalId: 234 + SchoolYear: 2018 + BeginDate: 2018-02-04 + EndDate: 2018-12-05 + StudentList: + Student: + - RefId: 9897466F-200E-4BC1-B9AE-D1507DA15CEF + LocalId: SMI001 + Name: Peter Smith + - RefId: 7C834EA9-EDA1-2090-347F-83297E1C290D + LocalId: SMI002 + Name: Jennifer Smith + - RefId: 7C834EA9-EDA1-2090-347F-83297E1C290E + LocalId: SMI003 + Name: Terence Smith + TeacherList: + StaffMember: + - RefId: A8C3A2E3-5B35-9D75-101D-00AA001A0000 + LocalId: SMI1 + Name: Thomas Smith + Role: "1001" + - RefId: A8CCCCE3-5B35-9D75-101D-00AA001A0000 + LocalId: LONG2 + Name: Tamara Long + Role: "1002" + application/xml: + schema: + type: object + properties: + TeachingGroup: + $ref: "#/paths/~1TeachingGroups/get/responses/200/content/applica\ + tion~1json/schema/properties/TeachingGroups/properties/Teac\ + hingGroup/items" + example: >- +The GUID of the TeachingGroup
+ required: true + schema: + type: string + operationId: updateTeachingGroup + requestBody: + description: CRUD operation on TeachingGroup + content: + application/json: + schema: + type: object + properties: + TeachingGroup: + type: object + properties: + TeachingGroupRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-\ + 9]{4}-[a-fA-F0-9]{12}" + TeachingGroupLocalId: + description:This is a common element used to define the locally + assigned identifier associated with an entity.
+ type: string + ShortName: + type: string + description:Short free format label that describes the group.
+ LongName: + type: string + description:Longer description if required.
+ GroupType: + type: string + title: Teaching Group Type + description: >- +Provides the means of identifying the type of group + such as Roll class, Subject class or Homeroom and allows + systems to treat them accordingly
A reference to another SIF Data Object
+ type: object + properties: + RefId: + $ref: "#/paths/~1TeachingGroups~1%7BTeachingGroupRefId%7D\ + /put/requestBody/content/application~1json/schema/p\ + roperties/TeachingGroup/properties/TeachingGroupRef\ + Id" + LocalId: + $ref: "#/paths/~1TeachingGroups~1%7BTeachingGroupRefId%7D\ + /put/requestBody/content/application~1json/schema/p\ + roperties/TeachingGroup/properties/TeachingGroupLoc\ + alId" + Name: + type: string + description:The normal descriptive name of the referenced + object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject names, to + be included in Object References
The SchoolYear that the class represented by the + TeachingGroup is being taught.
+ BeginDate: + type: string + format: date + description:The start date of the first Timetable that the class + represented by the TeachingGroup is being taught in the + nominated school year.
+ EndDate: + type: string + format: date + description:The end date of the last Timetable that the class + represented by the TeachingGroup is being taught in the + nominated school year.
+ StudentList: + description:List of Students in this Teaching Group
+ type: object + properties: + Student: + type: array + items: + $ref: "#/paths/~1TeachingGroups~1%7BTeachingGroupRefId%\ + 7D/put/requestBody/content/application~1json/sche\ + ma/properties/TeachingGroup/properties/Provider" + TeacherList: + description:A List of staff associated with the group – may or + may not include the teacher timetabled in the + schedule.
+ type: object + properties: + StaffMember: + type: array + items: + description:The individual staff member as a member of the + StaffList and their role.
+ type: object + properties: + Role: + type: string + title: Staff Role + description: >- +Describes the role a staff member has at a + Provider or other EducationOrganisation.
+List of generic references denoting the Courses the + TeachingGroup is being taught.
+ type: object + properties: + Course: + type: array + items: + $ref: "#/paths/~1TeachingGroups~1%7BTeachingGroupRefId%\ + 7D/put/requestBody/content/application~1json/sche\ + ma/properties/TeachingGroup/properties/Provider" + SubjectAreaList: + description:List of codes denoting the Learning or Subject Areas + of the Course the TeachingGroup is being taught.
+ type: object + properties: + SubjectAreaList: + type: array + items: + SubjectArea: + type: string + title: Subject Area + description: >- +Codes denoting Subject Areas defined by the + NZ Curriculum and Te Marautanga o Aotearoa.
+Codes denoting Subject Areas defined by the + NZQA for NCEA.
For Subject Class teaching groups: the list of codes + denoting the Year Levels of the Course the TeachingGroup + is being taught.
For Roll Class teaching groups, + the Year Levels of the students in the roll class + group.
" + type: object + properties: + YearLevel: + type: array + items: + type: string + title: Year Level Code + description: >- +Year Level defines the values that are valid + for describing Funding Year Level and Current Year + Level for a student enrolment.
Current Year + Level indicates the year level of the student’s + class cohort and the level at which the student + spends most of their time at school. While a + student may be enrolled in subjects at varying + instructional year levels, in relation to the + student enrolment this value represents the year + level at which the student is considered to be + predominantly taught.
Funding Year Level + measures the actual number of years that the + student has attended a school. It provides the + Ministry with a method of counting students for + funding purposes which is independent of the way + schools are organised or the particular programme + of study that a student may undertake. Funding + Year Level for most students is based on the date + they first started school.
School Year + Level is used to indicate the instructional year + levels offered by a school, i.e. those years for + which student enrolments may be accepted.
Identifies a particular class or other group of students. + Such groups can have multiple staff assigned in a variety of + roles, may be assigned students from multiple year levels + and may be taught multiple courses.
+ x-accessControl: + create: + - 1001 + - 2401 + - 2403 + read: + - 1001 + - 2401 + - 2403 + update: + - 1001 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: [] + example: + TeachingGroup: + TeachingGroupRefId: 64A309DA-063A-2E35-B359-D75101A8C3D1 + TeachingGroupLocalId: 20087ASPN + ShortName: 7A SPN + LongName: Year 7A Maths - Space and Numbers + GroupType: SC + Provider: + RefId: 64A309DA-063A-2E35-B359-FACEA8C12312 + LocalId: 234 + SchoolYear: 2018 + BeginDate: 2018-02-04 + EndDate: 2018-12-05 + StudentList: + Student: + - RefId: 9897466F-200E-4BC1-B9AE-D1507DA15CEF + LocalId: SMI001 + Name: Peter Smith + - RefId: 7C834EA9-EDA1-2090-347F-83297E1C290D + LocalId: SMI002 + Name: Jennifer Smith + - RefId: 7C834EA9-EDA1-2090-347F-83297E1C290E + LocalId: SMI003 + Name: Terence Smith + TeacherList: + StaffMember: + - RefId: A8C3A2E3-5B35-9D75-101D-00AA001A0000 + LocalId: SMI1 + Name: Thomas Smith + Role: "1001" + - RefId: A8CCCCE3-5B35-9D75-101D-00AA001A0000 + LocalId: LONG2 + Name: Tamara Long + Role: "1002" + application/xml: + schema: + type: object + properties: + TeachingGroup: + $ref: "#/paths/~1TeachingGroups~1%7BTeachingGroupRefId%7D/put/req\ + uestBody/content/application~1json/schema/properties/Teachi\ + ngGroup" + example: >- +The GUID of the TeachingGroup
+ required: true + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + TeachingGroup: + $ref: "#/paths/~1TeachingGroups/get/responses/200/content/appli\ + cation~1json/schema/properties/TeachingGroups/properties/\ + TeachingGroup/items" + example: + TeachingGroup: + TeachingGroupRefId: 64A309DA-063A-2E35-B359-D75101A8C3D1 + TeachingGroupLocalId: 20087ASPN + ShortName: 7A SPN + LongName: Year 7A Maths - Space and Numbers + GroupType: SC + Provider: + RefId: 64A309DA-063A-2E35-B359-FACEA8C12312 + LocalId: 234 + SchoolYear: 2018 + BeginDate: 2018-02-04 + EndDate: 2018-12-05 + StudentList: + Student: + - RefId: 9897466F-200E-4BC1-B9AE-D1507DA15CEF + LocalId: SMI001 + Name: Peter Smith + - RefId: 7C834EA9-EDA1-2090-347F-83297E1C290D + LocalId: SMI002 + Name: Jennifer Smith + - RefId: 7C834EA9-EDA1-2090-347F-83297E1C290E + LocalId: SMI003 + Name: Terence Smith + TeacherList: + StaffMember: + - RefId: A8C3A2E3-5B35-9D75-101D-00AA001A0000 + LocalId: SMI1 + Name: Thomas Smith + Role: "1001" + - RefId: A8CCCCE3-5B35-9D75-101D-00AA001A0000 + LocalId: LONG2 + Name: Tamara Long + Role: "1002" + application/xml: + schema: + type: object + properties: + TeachingGroup: + $ref: "#/paths/~1TeachingGroups/get/responses/200/content/appli\ + cation~1json/schema/properties/TeachingGroups/properties/\ + TeachingGroup/items" + example: >- +The GUID of the TeachingGroup
+ required: true + schema: + type: string + responses: + "200": + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + 200" + default: + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + default" + /ProviderCourses: + get: + tags: + - ProviderCourse + summary: Default operation to get a list of all available ProviderCourses + description: Search the set of available ProviderCourses, according to the search + criteria in the URL parameters. Returns the first 20 objects located; + with SIF defined navigation headers, indicating how to retrieve + subsequent sets of 20 objects. + parameters: + - name: LocalId + in: path + description: Search for object by LocalId, within the context of the organisation + represented by the ZoneId of the request. + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + ProviderCourses: + type: object + description: A List of ProviderCourse objects + properties: + ProviderCourse: + type: array + items: + required: + - Curriculum + - Provider + - Title + type: object + properties: + ProviderCourseRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[\ + a-fA-F0-9]{4}-[a-fA-F0-9]{12}" + ProviderCourseLocalId: + description:This is a common element used to define the + locally assigned identifier associated with an + entity.
+ type: string + Provider: + description:A reference to another SIF Data Object
+ type: object + required: + - ObjectType + properties: + RefId: + $ref: "#/paths/~1ProviderCourses/get/responses/20\ + 0/content/application~1json/schema/properti\ + es/ProviderCourses/properties/ProviderCours\ + e/items/properties/ProviderCourseRefId" + LocalId: + $ref: "#/paths/~1ProviderCourses/get/responses/20\ + 0/content/application~1json/schema/properti\ + es/ProviderCourses/properties/ProviderCours\ + e/items/properties/ProviderCourseLocalId" + Name: + type: string + description:The normal descriptive name of the + referenced object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject + names, to be included in Object + References
Codes denoting the two curricula used in New + Zealand.
Subject matter areas covered by the + Course.
+ type: object + properties: + SubjectAreaList: + type: array + items: + SubjectArea: + type: string + title: Subject Area + description: >- +Codes denoting Subject Areas defined + by the NZ Curriculum and Te Marautanga o + Aotearoa.
Codes denoting Subject Areas defined + by the NZQA for NCEA.
Year Levels covered by the Course.
+ type: object + required: + - YearLevel + properties: + YearLevel: + type: array + items: + type: string + title: Year Level Code + description: >- +Year Level defines the values that are + valid for describing Funding Year Level + and Current Year Level for a student + enrolment.
Current Year Level + indicates the year level of the student’s + class cohort and the level at which the + student spends most of their time at + school. While a student may be enrolled in + subjects at varying instructional year + levels, in relation to the student + enrolment this value represents the year + level at which the student is considered + to be predominantly taught.
Funding + Year Level measures the actual number of + years that the student has attended a + school. It provides the Ministry with a + method of counting students for funding + purposes which is independent of the way + schools are organised or the particular + programme of study that a student may + undertake. Funding Year Level for most + students is based on the date they first + started school.
School Year Level + is used to indicate the instructional year + levels offered by a school, i.e. those + years for which student enrolments may be + accepted.
Title of the Course.
+ Description: + type: string + description:Textual description of the Course.
+ Duration: + type: integer + description:The number of weeks the course is taught + for.
+ Credits: + type: string + description:The number of credits awarded upon Course + completion.
+ LanguageOfInstructionList: + description:The language of instruction for the + Course.
+ type: object + required: + - Language + properties: + Language: + type: array + items: + description:The number of hours per week the + Learner is taught in a specific language + during the enrolment.
+ type: object + required: + - Code + - LanguageOfInstructionType + - Level + properties: + Code: + type: string + title: Language + description: >- +Language refers to recognised human + communication systems, typically oral + and/or written. Sourced from + Statistics NZ - Language Standard + Classification 1999 v2.0.0
The level of instruction that is + made in the selected language.
+ LearningStandardList: + description:A list of ObjectReference
s to
+ the LearningStandards covered by the Course.
A list of ObjectReference
s to
+ the Credentials that may be gained by students
+ completing the course.
A Provider defined Course that Students enrol in, + and may be assessed for, and achieve passes in.
+ x-accessControl: + create: + - 1001 + - 2401 + - 2403 + read: + - 1001 + - 2401 + - 2403 + update: + - 1001 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: [] + example: + ProviderCourses: + ProviderCourse: + - ProviderCourseRefId: 9D75101A-8C3D-00AA-001A-0000A2E35B35 + ProviderCourseLocalId: 12CHEM + Provider: + RefId: 101A8C3D-00AA-001A-0000-A2E35B359D75 + LocalId: 208 + Curriculum: NZC + SubjectAreaList: + SubjectArea: + - CHEM + YearLevelList: + YearLevel: + - "12" + Title: Year 12 Chemistry + Description: Organic & Inorganic Chemistry for NCEA Level 2 + Duration: 35 + Credits: 11 + LanguageOfInstructionList: + Language: + - Code: NZS01112 + Level: 1 + LearningStandardList: + LearningStandard: + - RefId: ac0871d9-6562-4209-ae86-face3661842b + LocalId: 91165-v2 + Name: Demonstrate understanding of the properties of + selected organic compounds + - RefId: ac0871d9-6562-4209-ae86-aabb3661842b + LocalId: 91166-v2 + Name: Demonstrate understanding of chemical reactivity + - RefId: ac0871d9-6562-4209-ae86-aabb3661842b + LocalId: 91167-v2 + Name: Demonstrate understanding of oxidation-reduction + application/xml: + schema: + type: object + properties: + ProviderCourses: + type: object + description: A List of ProviderCourse objects + properties: + ProviderCourse: + type: array + items: + $ref: "#/paths/~1ProviderCourses/get/responses/200/conten\ + t/application~1json/schema/properties/ProviderCours\ + es/properties/ProviderCourse/items" + example: >- +The ID (GUID) that uniquely identifies the Provider defined + Course.
+ required: true + schema: + type: string + operationId: createProviderCourse + requestBody: + description: CRUD operation on ProviderCourse + content: + application/json: + schema: + type: object + properties: + ProviderCourse: + $ref: "#/paths/~1ProviderCourses/get/responses/200/content/applic\ + ation~1json/schema/properties/ProviderCourses/properties/Pr\ + oviderCourse/items" + example: + ProviderCourse: + ProviderCourseRefId: 9D75101A-8C3D-00AA-001A-0000A2E35B35 + ProviderCourseLocalId: 12CHEM + Provider: + RefId: 101A8C3D-00AA-001A-0000-A2E35B359D75 + LocalId: 208 + Curriculum: NZC + SubjectAreaList: + SubjectArea: + - CHEM + YearLevelList: + YearLevel: + - "12" + Title: Year 12 Chemistry + Description: Organic & Inorganic Chemistry for NCEA Level 2 + Duration: 35 + Credits: 11 + LanguageOfInstructionList: + Language: + - Code: NZS01112 + Level: 1 + LearningStandardList: + LearningStandard: + - RefId: ac0871d9-6562-4209-ae86-face3661842b + LocalId: 91165-v2 + Name: Demonstrate understanding of the properties of selected + organic compounds + - RefId: ac0871d9-6562-4209-ae86-aabb3661842b + LocalId: 91166-v2 + Name: Demonstrate understanding of chemical reactivity + - RefId: ac0871d9-6562-4209-ae86-aabb3661842b + LocalId: 91167-v2 + Name: Demonstrate understanding of oxidation-reduction + application/xml: + schema: + type: object + properties: + ProviderCourse: + $ref: "#/paths/~1ProviderCourses/get/responses/200/content/applic\ + ation~1json/schema/properties/ProviderCourses/properties/Pr\ + oviderCourse/items" + example: >- +The ID (GUID) that uniquely identifies the Provider defined + Course.
+ required: true + schema: + type: string + operationId: updateProviderCourse + requestBody: + description: CRUD operation on ProviderCourse + content: + application/json: + schema: + type: object + properties: + ProviderCourse: + type: object + properties: + ProviderCourseRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-\ + 9]{4}-[a-fA-F0-9]{12}" + ProviderCourseLocalId: + description:This is a common element used to define the locally + assigned identifier associated with an entity.
+ type: string + Provider: + description:A reference to another SIF Data Object
+ type: object + properties: + RefId: + $ref: "#/paths/~1ProviderCourses~1%7BProviderCourseRefId%\ + 7D/put/requestBody/content/application~1json/schema\ + /properties/ProviderCourse/properties/ProviderCours\ + eRefId" + LocalId: + $ref: "#/paths/~1ProviderCourses~1%7BProviderCourseRefId%\ + 7D/put/requestBody/content/application~1json/schema\ + /properties/ProviderCourse/properties/ProviderCours\ + eLocalId" + Name: + type: string + description:The normal descriptive name of the referenced + object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject names, to + be included in Object References
Codes denoting the two curricula used in New Zealand. +
Subject matter areas covered by the Course.
+ type: object + properties: + SubjectAreaList: + type: array + items: + SubjectArea: + type: string + title: Subject Area + description: >- +Codes denoting Subject Areas defined by the + NZ Curriculum and Te Marautanga o Aotearoa.
+Codes denoting Subject Areas defined by the + NZQA for NCEA.
Year Levels covered by the Course.
+ type: object + properties: + YearLevel: + type: array + items: + type: string + title: Year Level Code + description: >- +Year Level defines the values that are valid + for describing Funding Year Level and Current Year + Level for a student enrolment.
Current Year + Level indicates the year level of the student’s + class cohort and the level at which the student + spends most of their time at school. While a + student may be enrolled in subjects at varying + instructional year levels, in relation to the + student enrolment this value represents the year + level at which the student is considered to be + predominantly taught.
Funding Year Level + measures the actual number of years that the + student has attended a school. It provides the + Ministry with a method of counting students for + funding purposes which is independent of the way + schools are organised or the particular programme + of study that a student may undertake. Funding + Year Level for most students is based on the date + they first started school.
School Year + Level is used to indicate the instructional year + levels offered by a school, i.e. those years for + which student enrolments may be accepted.
Title of the Course.
+ Description: + type: string + description:Textual description of the Course.
+ Duration: + type: integer + description:The number of weeks the course is taught for.
+ Credits: + type: string + description:The number of credits awarded upon Course + completion.
+ LanguageOfInstructionList: + description:The language of instruction for the Course.
+ type: object + properties: + Language: + type: array + items: + description:The number of hours per week the Learner is + taught in a specific language during the + enrolment.
+ type: object + properties: + Code: + type: string + title: Language + description: >- +Language refers to recognised human + communication systems, typically oral and/or + written. Sourced from Statistics NZ - Language + Standard Classification 1999 v2.0.0
The level of instruction that is made in + the selected language.
+ LearningStandardList: + description:A list of ObjectReference
s to the
+ LearningStandards covered by the Course.
A list of ObjectReference
s to the
+ Credentials that may be gained by students completing
+ the course.
A Provider defined Course that Students enrol in, and may + be assessed for, and achieve passes in.
+ x-accessControl: + create: + - 1001 + - 2401 + - 2403 + read: + - 1001 + - 2401 + - 2403 + update: + - 1001 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: [] + example: + ProviderCourse: + ProviderCourseRefId: 9D75101A-8C3D-00AA-001A-0000A2E35B35 + ProviderCourseLocalId: 12CHEM + Provider: + RefId: 101A8C3D-00AA-001A-0000-A2E35B359D75 + LocalId: 208 + Curriculum: NZC + SubjectAreaList: + SubjectArea: + - CHEM + YearLevelList: + YearLevel: + - "12" + Title: Year 12 Chemistry + Description: Organic & Inorganic Chemistry for NCEA Level 2 + Duration: 35 + Credits: 11 + LanguageOfInstructionList: + Language: + - Code: NZS01112 + Level: 1 + LearningStandardList: + LearningStandard: + - RefId: ac0871d9-6562-4209-ae86-face3661842b + LocalId: 91165-v2 + Name: Demonstrate understanding of the properties of selected + organic compounds + - RefId: ac0871d9-6562-4209-ae86-aabb3661842b + LocalId: 91166-v2 + Name: Demonstrate understanding of chemical reactivity + - RefId: ac0871d9-6562-4209-ae86-aabb3661842b + LocalId: 91167-v2 + Name: Demonstrate understanding of oxidation-reduction + application/xml: + schema: + type: object + properties: + ProviderCourse: + $ref: "#/paths/~1ProviderCourses~1%7BProviderCourseRefId%7D/put/r\ + equestBody/content/application~1json/schema/properties/Prov\ + iderCourse" + example: >- +The ID (GUID) that uniquely identifies the Provider defined + Course.
+ required: true + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + ProviderCourse: + $ref: "#/paths/~1ProviderCourses/get/responses/200/content/appl\ + ication~1json/schema/properties/ProviderCourses/propertie\ + s/ProviderCourse/items" + example: + ProviderCourse: + ProviderCourseRefId: 9D75101A-8C3D-00AA-001A-0000A2E35B35 + ProviderCourseLocalId: 12CHEM + Provider: + RefId: 101A8C3D-00AA-001A-0000-A2E35B359D75 + LocalId: 208 + Curriculum: NZC + SubjectAreaList: + SubjectArea: + - CHEM + YearLevelList: + YearLevel: + - "12" + Title: Year 12 Chemistry + Description: Organic & Inorganic Chemistry for NCEA Level 2 + Duration: 35 + Credits: 11 + LanguageOfInstructionList: + Language: + - Code: NZS01112 + Level: 1 + LearningStandardList: + LearningStandard: + - RefId: ac0871d9-6562-4209-ae86-face3661842b + LocalId: 91165-v2 + Name: Demonstrate understanding of the properties of + selected organic compounds + - RefId: ac0871d9-6562-4209-ae86-aabb3661842b + LocalId: 91166-v2 + Name: Demonstrate understanding of chemical reactivity + - RefId: ac0871d9-6562-4209-ae86-aabb3661842b + LocalId: 91167-v2 + Name: Demonstrate understanding of oxidation-reduction + application/xml: + schema: + type: object + properties: + ProviderCourse: + $ref: "#/paths/~1ProviderCourses/get/responses/200/content/appl\ + ication~1json/schema/properties/ProviderCourses/propertie\ + s/ProviderCourse/items" + example: >- +The ID (GUID) that uniquely identifies the Provider defined + Course.
+ required: true + schema: + type: string + responses: + "200": + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + 200" + default: + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + default" + /LearningStandards: + get: + tags: + - LearningStandard + summary: Default operation to get a list of all available LearningStandards + description: Search the set of available LearningStandards, according to the search + criteria in the URL parameters. Returns the first 20 objects located; + with SIF defined navigation headers, indicating how to retrieve + subsequent sets of 20 objects. + parameters: + - name: LocalId + in: path + description: Search for object by LocalId, within the context of the organisation + represented by the ZoneId of the request. + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + LearningStandards: + type: object + description: A List of LearningStandard objects + properties: + LearningStandard: + type: array + items: + required: + - SubjectAreaList + - Title + type: object + properties: + LearningStandardRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[\ + a-fA-F0-9]{4}-[a-fA-F0-9]{12}" + LearningStandardLocalId: + description:This is a common element used to define the + locally assigned identifier associated with an + entity.
+ type: string + Title: + type: string + description: 'The name of the LearningStandard. eg: + "Demonstrate understanding of chemical + reactivity"
' + VersionNo: + description:The version number of the + LearningStandard.
+ Publisher: + description:A reference to another SIF Data Object
+ type: object + required: + - ObjectType + properties: + RefId: + $ref: "#/paths/~1LearningStandards/get/responses/\ + 200/content/application~1json/schema/proper\ + ties/LearningStandards/properties/LearningS\ + tandard/items/properties/LearningStandardRe\ + fId" + LocalId: + $ref: "#/paths/~1LearningStandards/get/responses/\ + 200/content/application~1json/schema/proper\ + ties/LearningStandards/properties/LearningS\ + tandard/items/properties/LearningStandardLo\ + calId" + Name: + type: string + description:The normal descriptive name of the + referenced object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject + names, to be included in Object + References
Code set denoting the type of standard e.g., + unit standard, achievement standard.
Developed by Industry Training + Organisations or NZQA.
+ enum: + - US + - title: Achievement Standard + description:Developed by MoE, derived from the + achievement objectives of the NZ Curriculum + or Te Marautanga o Aotearoa
+ enum: + - AS + Description: + type: string + description:Description of the standards document.
+ SubjectAreaList: + description:Which standard MoE Learning / Subject Areas + is this LearningStandard part of?
+ type: object + properties: + SubjectAreaList: + type: array + items: + SubjectArea: + type: string + title: Subject Area + description: >- +Codes denoting Subject Areas defined + by the NZ Curriculum and Te Marautanga o + Aotearoa.
Codes denoting Subject Areas defined + by the NZQA for NCEA.
A code denoting the status of the + LearningStandard throughout its life-cycle.
+The LearningStandard is being developed, + and is not yet ready for use in teaching and + assessment.
+ enum: + - CA + - title: Published + description:The LearningStandard is available for use + in teaching and assessment.
+ enum: + - PU + - title: Superceded + description:The LearningStandard has been superceded + (probably by a subsequent version of the + standard) but this version is still + available for use in teaching and + assessment.
+ enum: + - SU + - title: Discontinued + description:The LearningStandard is no longer + available for use in teaching and + assessment.
+ enum: + - DI + PublicationDate: + type: string + format: date + description:The date the publishing organization + published the standard.
+ SupercededDate: + type: string + format: date + description:The date the publishing organization + superceded (or will supercede) the + LearningStandard. May be future dated.
+ DiscontinuedDate: + type: string + format: date + description:The date the publishing organization + discontinued (or will discontinue) the + LearningStandard. May be future dated.
+ Credits: + description:The number of course (or other qualification) + credits that will be achieved by passing this + LearningStandard.
+ Level: + description:Where the publisher is NZQA, Which NCEA Level + applies to the LearningStandard?
+ AssessmentType: + type: string + title: Assessment Type + description: >- +Standard codes denoting the type of + assessment the student is sitting for the + assessment task.
A list of related LearningStandard + references
+ type: object + required: + - RelatedLearningStandard + properties: + RelatedLearningStandard: + type: array + items: + description:A member of a list of related + LearningStandard references.
+ type: object + required: + - ObjectType + - Relationship + properties: + Relationship: + type: string + title: Learning Standard Relationship Type + description: >- +A code denoting the nature of the + relationship with another + LearningStandard
The related LearningStandard is + a predecessor to this + LearningStandard, and is + superceded by it.
+ enum: + - PREDEC + - title: Successor + description:The related LearningStandard is + a successor to this + LearningStandard, and it + supercedes this + LearningStandard.
+ enum: + - SUCCES + - title: Prerequisite + description:The related LearningStandard is + a prerequisite to this + LearningStandard, and students + should have completed the learning + in that LearningStandard before + embarking on the learning in this + one.
+ enum: + - PREREQ + - title: Unknown + description:The precise nature of the + relationship between the two + LearningStandards not known, but + the fact that they are related is + known.
+ enum: + - UNKNWN + CredentialList: + description:A list of Credentials that the learning + standard contributes to attaining.
+ type: object + required: + - Credential + properties: + Credential: + type: array + items: + $ref: "#/paths/~1LearningStandards/get/response\ + s/200/content/application~1json/schema/pr\ + operties/LearningStandards/properties/Lea\ + rningStandard/items/properties/Publisher" + description:A curriculum standard or the like published by a + national body, professional association or other + interested party. The LearningStandard describes a + set of learning that students are expected to + undertake.
+ x-accessControl: + create: + - 1001 + - 2401 + - 2403 + read: + - 1001 + - 2401 + - 2403 + update: + - 1001 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: [] + example: + LearningStandards: + LearningStandard: + - LearningStandardRefId: cedf9eae-4358-408d-af57-ec0ea1b0d210 + LearningStandardLocalId: 91165 + Title: Chemistry + VersionNo: 2 + Publisher: + RefId: cedf9eae-4358-408d-af57-ec0ea1b0d210 + Description: Demonstrate understanding of the properties of selected + organic compounds + SubjectAreaList: + SubjectArea: CHEM + Status: PU + Credits: 4 + Level: "2" + AssessmentType: INT + application/xml: + schema: + type: object + properties: + LearningStandards: + type: object + description: A List of LearningStandard objects + properties: + LearningStandard: + type: array + items: + $ref: "#/paths/~1LearningStandards/get/responses/200/cont\ + ent/application~1json/schema/properties/LearningSta\ + ndards/properties/LearningStandard/items" + example: >- +Unique identifier (GUID) that uniquely identifies the particular + version or edition of the Learning Standard.
+ required: true + schema: + type: string + operationId: createLearningStandard + requestBody: + description: CRUD operation on LearningStandard + content: + application/json: + schema: + type: object + properties: + LearningStandard: + $ref: "#/paths/~1LearningStandards/get/responses/200/content/appl\ + ication~1json/schema/properties/LearningStandards/propertie\ + s/LearningStandard/items" + example: + LearningStandard: + LearningStandardRefId: cedf9eae-4358-408d-af57-ec0ea1b0d210 + LearningStandardLocalId: 91165 + Title: Chemistry + VersionNo: 2 + Publisher: + RefId: cedf9eae-4358-408d-af57-ec0ea1b0d210 + Description: Demonstrate understanding of the properties of selected + organic compounds + SubjectAreaList: + SubjectArea: CHEM + Status: PU + Credits: 4 + Level: "2" + AssessmentType: INT + application/xml: + schema: + type: object + properties: + LearningStandard: + $ref: "#/paths/~1LearningStandards/get/responses/200/content/appl\ + ication~1json/schema/properties/LearningStandards/propertie\ + s/LearningStandard/items" + example: >- +Unique identifier (GUID) that uniquely identifies the particular + version or edition of the Learning Standard.
+ required: true + schema: + type: string + operationId: updateLearningStandard + requestBody: + description: CRUD operation on LearningStandard + content: + application/json: + schema: + type: object + properties: + LearningStandard: + type: object + properties: + LearningStandardRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-\ + 9]{4}-[a-fA-F0-9]{12}" + LearningStandardLocalId: + description:This is a common element used to define the locally + assigned identifier associated with an entity.
+ type: string + Title: + type: string + description: 'The name of the LearningStandard. eg: "Demonstrate + understanding of chemical reactivity"
' + VersionNo: + description:The version number of the LearningStandard.
+ Publisher: + description:A reference to another SIF Data Object
+ type: object + properties: + RefId: + $ref: "#/paths/~1LearningStandards~1%7BLearningStandardRe\ + fId%7D/put/requestBody/content/application~1json/sc\ + hema/properties/LearningStandard/properties/Learnin\ + gStandardRefId" + LocalId: + $ref: "#/paths/~1LearningStandards~1%7BLearningStandardRe\ + fId%7D/put/requestBody/content/application~1json/sc\ + hema/properties/LearningStandard/properties/Learnin\ + gStandardLocalId" + Name: + type: string + description:The normal descriptive name of the referenced + object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject names, to + be included in Object References
Code set denoting the type of standard e.g., unit + standard, achievement standard.
Developed by Industry Training Organisations or + NZQA.
+ enum: + - US + - title: Achievement Standard + description:Developed by MoE, derived from the achievement + objectives of the NZ Curriculum or Te Marautanga o + Aotearoa
+ enum: + - AS + Description: + type: string + description:Description of the standards document.
+ SubjectAreaList: + description:Which standard MoE Learning / Subject Areas is this + LearningStandard part of?
+ type: object + properties: + SubjectAreaList: + type: array + items: + SubjectArea: + type: string + title: Subject Area + description: >- +Codes denoting Subject Areas defined by the + NZ Curriculum and Te Marautanga o Aotearoa.
+Codes denoting Subject Areas defined by the + NZQA for NCEA.
A code denoting the status of the LearningStandard + throughout its life-cycle.
The LearningStandard is being developed, and is + not yet ready for use in teaching and + assessment.
+ enum: + - CA + - title: Published + description:The LearningStandard is available for use in + teaching and assessment.
+ enum: + - PU + - title: Superceded + description:The LearningStandard has been superceded + (probably by a subsequent version of the standard) + but this version is still available for use in + teaching and assessment.
+ enum: + - SU + - title: Discontinued + description:The LearningStandard is no longer available for + use in teaching and assessment.
+ enum: + - DI + PublicationDate: + type: string + format: date + description:The date the publishing organization published the + standard.
+ SupercededDate: + type: string + format: date + description:The date the publishing organization superceded (or + will supercede) the LearningStandard. May be future + dated.
+ DiscontinuedDate: + type: string + format: date + description:The date the publishing organization discontinued (or + will discontinue) the LearningStandard. May be future + dated.
+ Credits: + description:The number of course (or other qualification) credits + that will be achieved by passing this + LearningStandard.
+ Level: + description:Where the publisher is NZQA, Which NCEA Level applies + to the LearningStandard?
+ AssessmentType: + type: string + title: Assessment Type + description: >- +Standard codes denoting the type of assessment the + student is sitting for the assessment task.
A list of related LearningStandard references
+ type: object + properties: + RelatedLearningStandard: + type: array + items: + description:A member of a list of related LearningStandard + references.
+ type: object + properties: + Relationship: + type: string + title: Learning Standard Relationship Type + description: >- +A code denoting the nature of the + relationship with another LearningStandard
+The related LearningStandard is a + predecessor to this LearningStandard, and + is superceded by it.
+ enum: + - PREDEC + - title: Successor + description:The related LearningStandard is a + successor to this LearningStandard, and it + supercedes this LearningStandard.
+ enum: + - SUCCES + - title: Prerequisite + description:The related LearningStandard is a + prerequisite to this LearningStandard, and + students should have completed the + learning in that LearningStandard before + embarking on the learning in this one.
+ enum: + - PREREQ + - title: Unknown + description:The precise nature of the relationship + between the two LearningStandards not + known, but the fact that they are related + is known.
+ enum: + - UNKNWN + CredentialList: + description:A list of Credentials that the learning standard + contributes to attaining.
+ type: object + properties: + Credential: + type: array + items: + $ref: "#/paths/~1LearningStandards~1%7BLearningStandard\ + RefId%7D/put/requestBody/content/application~1jso\ + n/schema/properties/LearningStandard/properties/P\ + ublisher" + description:A curriculum standard or the like published by a national + body, professional association or other interested party. + The LearningStandard describes a set of learning that + students are expected to undertake.
+ x-accessControl: + create: + - 1001 + - 2401 + - 2403 + read: + - 1001 + - 2401 + - 2403 + update: + - 1001 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: [] + example: + LearningStandard: + LearningStandardRefId: cedf9eae-4358-408d-af57-ec0ea1b0d210 + LearningStandardLocalId: 91165 + Title: Chemistry + VersionNo: 2 + Publisher: + RefId: cedf9eae-4358-408d-af57-ec0ea1b0d210 + Description: Demonstrate understanding of the properties of selected + organic compounds + SubjectAreaList: + SubjectArea: CHEM + Status: PU + Credits: 4 + Level: "2" + AssessmentType: INT + application/xml: + schema: + type: object + properties: + LearningStandard: + $ref: "#/paths/~1LearningStandards~1%7BLearningStandardRefId%7D/p\ + ut/requestBody/content/application~1json/schema/properties/\ + LearningStandard" + example: >- +Unique identifier (GUID) that uniquely identifies the particular + version or edition of the Learning Standard.
+ required: true + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + LearningStandard: + $ref: "#/paths/~1LearningStandards/get/responses/200/content/ap\ + plication~1json/schema/properties/LearningStandards/prope\ + rties/LearningStandard/items" + example: + LearningStandard: + LearningStandardRefId: cedf9eae-4358-408d-af57-ec0ea1b0d210 + LearningStandardLocalId: 91165 + Title: Chemistry + VersionNo: 2 + Publisher: + RefId: cedf9eae-4358-408d-af57-ec0ea1b0d210 + Description: Demonstrate understanding of the properties of selected + organic compounds + SubjectAreaList: + SubjectArea: CHEM + Status: PU + Credits: 4 + Level: "2" + AssessmentType: INT + application/xml: + schema: + type: object + properties: + LearningStandard: + $ref: "#/paths/~1LearningStandards/get/responses/200/content/ap\ + plication~1json/schema/properties/LearningStandards/prope\ + rties/LearningStandard/items" + example: >- +Unique identifier (GUID) that uniquely identifies the particular + version or edition of the Learning Standard.
+ required: true + schema: + type: string + responses: + "200": + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + 200" + default: + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + default" + /Credentials: + get: + tags: + - Credential + summary: Default operation to get a list of all available Credentials + description: Search the set of available Credentials, according to the search + criteria in the URL parameters. Returns the first 20 objects located; + with SIF defined navigation headers, indicating how to retrieve + subsequent sets of 20 objects. + parameters: + - name: LocalId + in: path + description: Search for object by LocalId, within the context of the organisation + represented by the ZoneId of the request. + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + Credentials: + type: object + description: A List of Credential objects + properties: + Credential: + type: array + items: + required: + - Status + - Title + type: object + properties: + CredentialRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[\ + a-fA-F0-9]{4}-[a-fA-F0-9]{12}" + CredentialLocalId: + description:This is a common element used to define the + locally assigned identifier associated with an + entity.
+ type: string + Title: + type: string + description: 'The name of the Credential. eg: "NCEA Level + 1"
' + VersionNo: + description:The version number of the Credential.
+ Administrator: + description:A reference to another SIF Data Object
+ type: object + required: + - ObjectType + properties: + RefId: + $ref: "#/paths/~1Credentials/get/responses/200/co\ + ntent/application~1json/schema/properties/C\ + redentials/properties/Credential/items/prop\ + erties/CredentialRefId" + LocalId: + $ref: "#/paths/~1Credentials/get/responses/200/co\ + ntent/application~1json/schema/properties/C\ + redentials/properties/Credential/items/prop\ + erties/CredentialLocalId" + Name: + type: string + description:The normal descriptive name of the + referenced object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject + names, to be included in Object + References
Description of the credential
+ SubjectAreaList: + description:Which standard MoE Learning / Subject Areas + is this Credential part of?
+ type: object + properties: + SubjectAreaList: + type: array + items: + SubjectArea: + type: string + title: Subject Area + description: >- +Codes denoting Subject Areas defined + by the NZ Curriculum and Te Marautanga o + Aotearoa.
Codes denoting Subject Areas defined + by the NZQA for NCEA.
A code denoting the status of the Credential + throughout its life-cycle.
The Credential is being developed, and is + not yet available for granting as an + Attainment.
+ enum: + - CA + - title: Published + description:The Credential is available for granting + as an Attainment
+ enum: + - PU + - title: Superceded + description:The Credential has been superceded + (probably by a subsequent Credential) but + this version is still available for granting + as an Attainment.
+ enum: + - SU + - title: Discontinued + description:The Credential is no longer available + granting as an Attainment
+ enum: + - DI + PublicationDate: + type: string + format: date + description:This is the date that the administering + organization published the Credential.
+ SupercededDate: + type: string + format: date + description:The date the administering organization + superceded (or will supercede) the Credential. + May be future dated.
+ DiscontinuedDate: + type: string + format: date + description:The date the administering organization + discontinued (or will discontinue) the + Credential. May be future dated.
+ Credits: + description:The number of course (or other qualification) + credits that will be achieved by attaining this + Credential.
+ Level: + type: string + description:The level of the credential if applicable, + eg. 1,2 or 3 for NCEA levels
+ RelatedLearningStandardList: + description:A list of related LearningStandard + references
+ type: object + required: + - RelatedLearningStandard + properties: + RelatedLearningStandard: + type: array + items: + description:A member of a list of related + LearningStandard references.
+ type: object + required: + - ObjectType + - Relationship + properties: + Relationship: + type: string + title: Learning Standard Relationship Type + description: >- +A code denoting the nature of the + relationship with another + LearningStandard
The related LearningStandard is + a predecessor to this + LearningStandard, and is + superceded by it.
+ enum: + - PREDEC + - title: Successor + description:The related LearningStandard is + a successor to this + LearningStandard, and it + supercedes this + LearningStandard.
+ enum: + - SUCCES + - title: Prerequisite + description:The related LearningStandard is + a prerequisite to this + LearningStandard, and students + should have completed the learning + in that LearningStandard before + embarking on the learning in this + one.
+ enum: + - PREREQ + - title: Unknown + description:The precise nature of the + relationship between the two + LearningStandards not known, but + the fact that they are related is + known.
+ enum: + - UNKNWN + description:A qualification or other award published by a + national body, professional association or other + interested party. The Credential recognises a set of + learning that students have undertaken and + successfully completed.
+ x-accessControl: + create: + - 1001 + - 2401 + - 2403 + read: + - 1001 + - 2401 + - 2403 + update: + - 1001 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: [] + example: + Credentials: + Credential: + - CredentialRefId: 2b560779-872b-4491-afd6-3c6bd5f1c8cc + CredentialLocalId: 91165 + Title: NCEA Level 2 - Endorsed with Merit + VersionNo: 2 + Administrator: + RefId: 3d614c16-9046-47d1-87b5-51438590de15 + Name: NZQA + Description: Achieved sufficient chemistry credits endorsed with merit + SubjectAreaList: + SubjectArea: CHEM + Status: PU + Credits: 4 + Level: "2" + application/xml: + schema: + type: object + properties: + Credentials: + type: object + description: A List of Credential objects + properties: + Credential: + type: array + items: + $ref: "#/paths/~1Credentials/get/responses/200/content/ap\ + plication~1json/schema/properties/Credentials/prope\ + rties/Credential/items" + example: >- +Unique identifier (GUID) that uniquely identifies the particular + version or edition of the Credential.
+ required: true + schema: + type: string + operationId: createCredential + requestBody: + description: CRUD operation on Credential + content: + application/json: + schema: + type: object + properties: + Credential: + $ref: "#/paths/~1Credentials/get/responses/200/content/applicatio\ + n~1json/schema/properties/Credentials/properties/Credential\ + /items" + example: + Credential: + CredentialRefId: 2b560779-872b-4491-afd6-3c6bd5f1c8cc + CredentialLocalId: 91165 + Title: NCEA Level 2 - Endorsed with Merit + VersionNo: 2 + Administrator: + RefId: 3d614c16-9046-47d1-87b5-51438590de15 + Name: NZQA + Description: Achieved sufficient chemistry credits endorsed with merit + SubjectAreaList: + SubjectArea: CHEM + Status: PU + Credits: 4 + Level: "2" + application/xml: + schema: + type: object + properties: + Credential: + $ref: "#/paths/~1Credentials/get/responses/200/content/applicatio\ + n~1json/schema/properties/Credentials/properties/Credential\ + /items" + example: >- +Unique identifier (GUID) that uniquely identifies the particular + version or edition of the Credential.
+ required: true + schema: + type: string + operationId: updateCredential + requestBody: + description: CRUD operation on Credential + content: + application/json: + schema: + type: object + properties: + Credential: + type: object + properties: + CredentialRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-\ + 9]{4}-[a-fA-F0-9]{12}" + CredentialLocalId: + description:This is a common element used to define the locally + assigned identifier associated with an entity.
+ type: string + Title: + type: string + description: 'The name of the Credential. eg: "NCEA Level 1"
' + VersionNo: + description:The version number of the Credential.
+ Administrator: + description:A reference to another SIF Data Object
+ type: object + properties: + RefId: + $ref: "#/paths/~1Credentials~1%7BCredentialRefId%7D/put/r\ + equestBody/content/application~1json/schema/propert\ + ies/Credential/properties/CredentialRefId" + LocalId: + $ref: "#/paths/~1Credentials~1%7BCredentialRefId%7D/put/r\ + equestBody/content/application~1json/schema/propert\ + ies/Credential/properties/CredentialLocalId" + Name: + type: string + description:The normal descriptive name of the referenced + object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject names, to + be included in Object References
Description of the credential
+ SubjectAreaList: + description:Which standard MoE Learning / Subject Areas is this + Credential part of?
+ type: object + properties: + SubjectAreaList: + type: array + items: + SubjectArea: + type: string + title: Subject Area + description: >- +Codes denoting Subject Areas defined by the + NZ Curriculum and Te Marautanga o Aotearoa.
+Codes denoting Subject Areas defined by the + NZQA for NCEA.
A code denoting the status of the Credential + throughout its life-cycle.
The Credential is being developed, and is not yet + available for granting as an Attainment.
+ enum: + - CA + - title: Published + description:The Credential is available for granting as an + Attainment
+ enum: + - PU + - title: Superceded + description:The Credential has been superceded (probably by a + subsequent Credential) but this version is still + available for granting as an Attainment.
+ enum: + - SU + - title: Discontinued + description:The Credential is no longer available granting as + an Attainment
+ enum: + - DI + PublicationDate: + type: string + format: date + description:This is the date that the administering organization + published the Credential.
+ SupercededDate: + type: string + format: date + description:The date the administering organization superceded + (or will supercede) the Credential. May be future + dated.
+ DiscontinuedDate: + type: string + format: date + description:The date the administering organization discontinued + (or will discontinue) the Credential. May be future + dated.
+ Credits: + description:The number of course (or other qualification) credits + that will be achieved by attaining this Credential.
+ Level: + type: string + description:The level of the credential if applicable, eg. 1,2 or + 3 for NCEA levels
+ RelatedLearningStandardList: + description:A list of related LearningStandard references
+ type: object + properties: + RelatedLearningStandard: + type: array + items: + description:A member of a list of related LearningStandard + references.
+ type: object + properties: + Relationship: + type: string + title: Learning Standard Relationship Type + description: >- +A code denoting the nature of the + relationship with another LearningStandard
+The related LearningStandard is a + predecessor to this LearningStandard, and + is superceded by it.
+ enum: + - PREDEC + - title: Successor + description:The related LearningStandard is a + successor to this LearningStandard, and it + supercedes this LearningStandard.
+ enum: + - SUCCES + - title: Prerequisite + description:The related LearningStandard is a + prerequisite to this LearningStandard, and + students should have completed the + learning in that LearningStandard before + embarking on the learning in this one.
+ enum: + - PREREQ + - title: Unknown + description:The precise nature of the relationship + between the two LearningStandards not + known, but the fact that they are related + is known.
+ enum: + - UNKNWN + description:A qualification or other award published by a national + body, professional association or other interested party. + The Credential recognises a set of learning that students + have undertaken and successfully completed.
+ x-accessControl: + create: + - 1001 + - 2401 + - 2403 + read: + - 1001 + - 2401 + - 2403 + update: + - 1001 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: [] + example: + Credential: + CredentialRefId: 2b560779-872b-4491-afd6-3c6bd5f1c8cc + CredentialLocalId: 91165 + Title: NCEA Level 2 - Endorsed with Merit + VersionNo: 2 + Administrator: + RefId: 3d614c16-9046-47d1-87b5-51438590de15 + Name: NZQA + Description: Achieved sufficient chemistry credits endorsed with merit + SubjectAreaList: + SubjectArea: CHEM + Status: PU + Credits: 4 + Level: "2" + application/xml: + schema: + type: object + properties: + Credential: + $ref: "#/paths/~1Credentials~1%7BCredentialRefId%7D/put/requestBo\ + dy/content/application~1json/schema/properties/Credential" + example: >- +Unique identifier (GUID) that uniquely identifies the particular + version or edition of the Credential.
+ required: true + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + Credential: + $ref: "#/paths/~1Credentials/get/responses/200/content/applicat\ + ion~1json/schema/properties/Credentials/properties/Creden\ + tial/items" + example: + Credential: + CredentialRefId: 2b560779-872b-4491-afd6-3c6bd5f1c8cc + CredentialLocalId: 91165 + Title: NCEA Level 2 - Endorsed with Merit + VersionNo: 2 + Administrator: + RefId: 3d614c16-9046-47d1-87b5-51438590de15 + Name: NZQA + Description: Achieved sufficient chemistry credits endorsed with merit + SubjectAreaList: + SubjectArea: CHEM + Status: PU + Credits: 4 + Level: "2" + application/xml: + schema: + type: object + properties: + Credential: + $ref: "#/paths/~1Credentials/get/responses/200/content/applicat\ + ion~1json/schema/properties/Credentials/properties/Creden\ + tial/items" + example: >- +Unique identifier (GUID) that uniquely identifies the particular + version or edition of the Credential.
+ required: true + schema: + type: string + responses: + "200": + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + 200" + default: + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + default" + /StudentProviderEnrolments: + get: + tags: + - StudentProviderEnrolment + summary: Default operation to get a list of all available + StudentProviderEnrolments + description: Search the set of available StudentProviderEnrolments, according to the + search criteria in the URL parameters. Returns the first 20 objects + located; with SIF defined navigation headers, indicating how to retrieve + subsequent sets of 20 objects. + parameters: + - name: LocalId + in: path + description: Search for object by LocalId, within the context of the organisation + represented by the ZoneId of the request. + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + StudentProviderEnrolments: + type: object + description: A List of StudentProviderEnrolment objects + properties: + StudentProviderEnrolment: + type: array + items: + required: + - EntryDate + - Provider + - Student + type: object + properties: + StudentProviderEnrolmentRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[\ + a-fA-F0-9]{4}-[a-fA-F0-9]{12}" + StudentProviderEnrolmentLocalId: + description:This is a common element used to define the + locally assigned identifier associated with an + entity.
+ type: string + Student: + description:A reference to another SIF Data Object
+ type: object + required: + - ObjectType + properties: + RefId: + $ref: "#/paths/~1StudentProviderEnrolments/get/re\ + sponses/200/content/application~1json/schem\ + a/properties/StudentProviderEnrolments/prop\ + erties/StudentProviderEnrolment/items/prope\ + rties/StudentProviderEnrolmentRefId" + LocalId: + $ref: "#/paths/~1StudentProviderEnrolments/get/re\ + sponses/200/content/application~1json/schem\ + a/properties/StudentProviderEnrolments/prop\ + erties/StudentProviderEnrolment/items/prope\ + rties/StudentProviderEnrolmentLocalId" + Name: + type: string + description:The normal descriptive name of the + referenced object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject + names, to be included in Object + References
The date from when this enrolment is ACTIVE. + The date of the student’s first attendance at + the provider. If future dated, then the intended + first attendance date of the enrolment.
+ ExitDate: + type: string + format: date + description:The date of a student’s last attendance at + the provider.
+ Status: + type: string + title: Provider Enrolment Status + description: >- +Records the status of a potentially + multi-year Provider enrolment, which goes + through a different life-cycle to the + single-year school enrolment.
Student has applied to become a Student + at the Provider, this pre-enrolment has been + received, and is being processed by the + provider. It has not yet been accepted or + declined by the provider.
+ enum: + - APP + - title: Accepted + description:The Provider has processed the + application, validated it against school + zoning rules, and other acceptance criteria. + The provider has accepted the enrolment and + will have a place for the Student if they + choose to take it up. Student has accepted + the enrolment and is expecting to take up + the enrolment at the agreed future date.
+ enum: + - ACC + - title: Cancelled + description:The enrolment application has been + declined by the Provider, or discontinued by + the Student, prior to becoming an ACTIVE + enrolment.
+ enum: + - CAN + - title: Active + description:The student has taken up the enrolment, + and has attended classes for the first + time.
+ enum: + - ACT + - title: Withdrawn + description: The Student has left the Provider, after the + enrolment was made ACTIVE + enum: + - WIT + - title: Pending + description:The enrolment has been accepted by the + Provider, taken up by the Student, and the + student has attended their first day; but + the enrolment is unable to be set to ACTIVE, + because there is still an ACTIVE enrolment + for the student at a (previous) provider. + Once the blocking Provider has put their + enrolment to WITHDRAWN, this enrolment can + be moved to 'ACTIVE'.
+ enum: + - PEN + Exit: + description:Details of the reasons, and interventions + leading up to the student's enrolment being + terminated.
+ type: object + required: + - ProviderExitType + - Reason + properties: + Reason: + type: string + title: Enrolment Exit Type + description: >- +Enrolment Exit code, derived from code + set used in School Roll Returns.
The post school activity the student is + moving on to once they have exited the + school.
A list of references to Wellbeing Event, + Response & Appeal data objects, that record + the process of terminating a students + enrolment.
+ type: object + required: + - Intervention + properties: + Intervention: + type: array + items: + $ref: "#/paths/~1StudentProviderEnrolments/\ + get/responses/200/content/application\ + ~1json/schema/properties/StudentProvi\ + derEnrolments/properties/StudentProvi\ + derEnrolment/items/properties/Student" + PotentialDestinationSchool: + $ref: "#/paths/~1StudentProviderEnrolments/get/re\ + sponses/200/content/application~1json/schem\ + a/properties/StudentProviderEnrolments/prop\ + erties/StudentProviderEnrolment/items/prope\ + rties/Student" + x-accessControl: + ? create + ? read + ? update + ? delete + ? aggregate + EarlyChildhoodEnrolment: + description:Properties of an enrolment in an early + childhood service (WiP).
+ type: object + properties: + ECEType: + type: string + title: Early Childhood Education Type + description: >- +The type of early childhood education the + student received.
Properties of an enrolment in a school
+ type: object + required: + - SchoolEnrolment + properties: + SchoolEnrolment: + type: array + items: + description:Defines information related to a + student's enrolment at a school education + Provider for a particular academic year + (or part thereof)
+ type: object + required: + - Curriculum + - CurriculumLevel + - MembershipType + properties: + SchoolCalendarYear: + description:School year for which this + enrolment is applicable, expressed as + the four-digit year in which the + school year ends (eg 2018).
+ StartDate: + type: string + format: date + description:The date the student started at + the school.
+ MembershipType: + type: string + title: School Enrolment Type + description: >- +A type of student enrolment with a + school. Allows differentiation of + concurrent enrolments, eg base vs + other.
The school that the student is + considered to be primarily + enrolled with, especially for the + purposes of reporting and Ministry + funding. Typically the student + will spend most of their school + time at this school.
+ enum: + - BASE + - title: Hosted Enrolment + description:Indicates an enrolment that is + concurrent with the student's base + enrolment at another school.
+ enum: + - HOST + - title: Remote/Distance Learning + description:Indicates an enrolment with a + school (typically Te Kura - The + Correspondence School) which + provides remote/distance learning; + this means that the student + remains at their base school (or + at home) for all classes covered + by this enrolment.
+ enum: + - REMO + YearLevel: + type: string + title: Year Level Code + description: >- +Year Level defines the values that + are valid for describing Funding Year + Level and Current Year Level for a + student enrolment.
Current Year + Level indicates the year level of the + student’s class cohort and the level + at which the student spends most of + their time at school. While a student + may be enrolled in subjects at varying + instructional year levels, in relation + to the student enrolment this value + represents the year level at which the + student is considered to be + predominantly taught.
Funding + Year Level measures the actual number + of years that the student has attended + a school. It provides the Ministry + with a method of counting students for + funding purposes which is independent + of the way schools are organised or + the particular programme of study that + a student may undertake. Funding Year + Level for most students is based on + the date they first started + school.
School Year Level is + used to indicate the instructional + year levels offered by a school, i.e. + those years for which student + enrolments may be accepted.
The criteria used to determine the + eligibility status of a student for + enrolment and MoE funding + purposes.
Records how the Student's + eligibility to enrol / for funding was + verified by the school staff during + the enrolment process.
+ type: object + required: + - IsConfirmed + - Source + properties: + Source: + type: string + title: Verification Source + description: >- +Records the source of the + identity or eligibility + verification, that has been made. + Mostly it is merely a record of + the kind of document that has been + presented; but occasionally it is + down to Principal or Ministry + discretion / approval.
The serial number on the + document that was used to verify + the name or birthdate.
+ DocumentExpiryDate: + type: string + format: date + description:The expiry date on the document + that was used to verify the name + or birthdate.
+ IsConfirmed: + type: boolean + description:If true then verification has + been confirmed by MoE.
+ Timestamp: + description:The date & time that the + VerificationEvent took place.
+ Provider: + $ref: "#/paths/~1StudentProviderEnrolme\ + nts/get/responses/200/content/app\ + lication~1json/schema/properties/\ + StudentProviderEnrolments/propert\ + ies/StudentProviderEnrolment/item\ + s/properties/Student" + x-accessControl: + ? create + ? read + ? update + ? delete + ? aggregate + FTE: + description:Full-time equivalent numeric value + of the student's course load during + this enrollment, expressed in decimal + form, where 1.00 represents a + full-time enrolment.
+ FundingType: + type: string + title: Student Funding Type + description: >- +Student classification for MoE + funding purposes.
Codes in this + list are hierarchical. Students can + only be allocated one TYPE code (even + though they may belong to more than + one of the groups listed below). To + allocate a code to an individual + student, start at the top of the list + and work down. Use the first code that + applies to the student.
Codes denoting the two curricula + used in New Zealand.
Which level of the National + Curriculum (1-5) is the student + enrolling in?
+ x-accessControl: + ? create + ? read + ? update + ? delete + ? aggregate + LanguageOfInstructionList: + description:How much instruction has the + student received in which + languages?
+ type: object + required: + - Language + properties: + Language: + type: array + items: + description:The number of hours per week + the Learner is taught in a + specific language during the + enrolment.
+ type: object + required: + - Code + - LanguageOfInstructionType + - Level + properties: + Code: + type: string + title: Language + description: >- +Language refers to + recognised human + communication systems, + typically oral and/or + written. Sourced from + Statistics NZ - Language + Standard Classification 1999 + v2.0.0
The level of instruction + that is made in the selected + language.
+ x-accessControl: + ? create + ? read + ? update + ? delete + ? aggregate + TimeInImmersion: + type: integer + description:The number of years the student has + been in Te Reo Māori immersion + education.
+ Section9Agreement: + type: string + title: Yes Or No Category + description: >- +A reusable code set for yes, no, + unknown and not provided values.
+Codes denoting the level of ORS + funding a student may receive.
+Student’s choice of general + subjects and learning areas to be + studied during the school year. Not to + be confused with CourseChoiceList + which allows students to choose + specific courses.
+ type: object + required: + - StudentSubjectChoice + properties: + StudentSubjectChoice: + type: array + items: + description:An individual Subject choice + that can be made, or has been + made by a Student.
+ type: object + required: + - Code + properties: + PreferenceNumber: + type: integer + description:The student's preference + for this subject, with + respect to the other subject + choices in the list.
+ Code: + type: string + title: Subject Area + description: >- +Codes denoting Subject + Areas defined by the NZ + Curriculum and Te Marautanga + o Aotearoa.
Student’s choice of courses to be + studied during the school year. Not to + be confused with SubjectChoiceList + which allows students to choose + general subjects and learning areas + rather than specific courses.
+ type: object + required: + - StudentCourseChoice + properties: + StudentCourseChoice: + type: array + items: + description:An individual Course choice + that can be made, or has been + made by a Student.
+ type: object + required: + - Course + properties: + PreferenceNumber: + type: integer + description:The student's preference + for this course, with + respect to the other course + choices in the list.
+ Course: + $ref: "#/paths/~1StudentProviderE\ + nrolments/get/responses/200\ + /content/application~1json/\ + schema/properties/StudentPr\ + oviderEnrolments/properties\ + /StudentProviderEnrolment/i\ + tems/properties/Student" + x-accessControl: + ? create + ? read + ? update + ? delete + ? aggregate + CoEnrolment: + description:Describes the student's enrolment + with their base school in the case + where this enrolment is not a base + school enrolment.
+ type: object + required: + - OtherProvider + properties: + OtherProvider: + $ref: "#/paths/~1StudentProviderEnrolme\ + nts/get/responses/200/content/app\ + lication~1json/schema/properties/\ + StudentProviderEnrolments/propert\ + ies/StudentProviderEnrolment/item\ + s/properties/Student" + CoEnrolmentType: + type: string + title: CoEnrolment Type + description: |- +Free text note of key + behavioural issues, made by the + client school in relation to the + student.
+ ClientSchoolConfidentialNote: + type: string + description:Free text confidential note + made by the client school in + relation to the student.
+ GuardianConfidentialNote: + type: string + description:Free text confidential note + made by the parents/caregivers of + the student.
+ InternationalEnrolment: + description:Additional information collected + for international enrolments.
+ type: object + properties: + NZArrivalDate: + type: string + format: date + description:The date the Student arrived in + New Zealand.
+ TuitionWeeklyFee: + description:The amount paid by the Student + per Week (GST excl) as a tuition + fee.
+ ExchangeScheme: + type: string + title: Exchange Scheme + description: >- +The type of exchange scheme for + student enrolment where the + Eligibility Criteria is "Student + on Government approved exchange + scheme" (5).
A list of student consent + information.
+ type: object + required: + - StudentConsent + properties: + StudentConsent: + type: array + items: + $ref: "#/paths/~1StudentProviderEnrol\ + ments/get/responses/200/content\ + /application~1json/schema/prope\ + rties/StudentProviderEnrolments\ + /properties/StudentProviderEnro\ + lment/items/properties/Student" + AcademicAttainmentGoalList: + description:The academic attainment goals of + the student when they enrol, e.g. they + wish to achieve a certain + qualification.
+ type: object + required: + - AttainmentGoal + properties: + AttainmentGoal: + type: array + items: + $ref: "#/paths/~1StudentProviderEnrol\ + ments/get/responses/200/content\ + /application~1json/schema/prope\ + rties/StudentProviderEnrolments\ + /properties/StudentProviderEnro\ + lment/items/properties/Student" + x-accessControl: + ? create + ? read + ? update + ? delete + ? aggregate + PreEnrolmentCancellation: + description:Details of why the school + pre-enrolment was cancelled.
+ type: object + properties: + NotifiedDate: + type: string + format: date + description:The date the Student was + notified of the cancellation of + the pre-enrolment.
+ CancellationMethod: + type: string + title: Pre Enrolment Exit Type + description: >- +Code set denoting how the + student's pre-enrolment was + cancelled.
Code set denoting why the + student's pre-enrolment was + cancelled.
Properties of an enrolment in a Tertiary + Education service (WiP).
+ type: object + required: + - Type + properties: + Type: + type: string + description:The type of tertiary education the + student is enrolling in.
+ x-accessControl: + ? create + ? read + ? update + ? delete + ? aggregate + description:A student's association with an education + provider for the purpose of receiving educational + servics.
Provider enrolments span multiple + years with the ProviderEnrolment containing one or + more ECE, School or Tertiary Enrolment sub-objects + for each particular year.
+ x-accessControl: + create: + - 1001 + - 1306 + - 2103 + - 2401 + - 2403 + read: + - 1001 + - 1306 + - 2103 + - 2401 + - 2403 + update: + - 1001 + - 1306 + - 2103 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: + - 2002 + - 2102 + example: + StudentProviderEnrolments: + StudentProviderEnrolment: + - StudentProviderEnrolmentRefId: A8C3D3E3-4B35-9D75-101D-00AA001A1652 + StudentProviderEnrolmentLocalId: 2004H102 + Student: + RefId: d3e34b35-9d75-101a-8c3d-00aa001a1652 + Provider: + RefId: d3e34b35-9d75-101a-8c3d-00aa001a1651 + EntryDate: 2018-01-29 + Status: WIT + SchoolEnrolmentList: + SchoolEnrolment: + SchoolCalendarYear: 2018 + MembershipType: BASE + YearLevel: 11 + EligibilityCriteria: GAE + EligibilityVerification: + Source: AUSPA + DocumentSerialNumber: L905673 + DocumentExpiryDate: 2019-03-30 + IsConfirmed: true + Timestamp: 2003-11-30T12:34:56.7 + Provider: + RefId: 822f6c83-2841-4a87-9ff9-49730951b3ba + FTE: 1 + FundingType: EX + FundingYearLevel: 1 + Curriculum: NZC + CurriculumLevel: 5 + InternationalEnrolment: + NZArrivalDate: 2018-05-02 + ExchangeScheme: STA + application/xml: + schema: + type: object + properties: + StudentProviderEnrolments: + type: object + description: A List of StudentProviderEnrolment objects + properties: + StudentProviderEnrolment: + type: array + items: + $ref: "#/paths/~1StudentProviderEnrolments/get/responses/\ + 200/content/application~1json/schema/properties/Stu\ + dentProviderEnrolments/properties/StudentProviderEn\ + rolment/items" + example: >- +The SIF GUID for the student provider enrolment.
+ required: true + schema: + type: string + operationId: createStudentProviderEnrolment + requestBody: + description: CRUD operation on StudentProviderEnrolment + content: + application/json: + schema: + type: object + properties: + StudentProviderEnrolment: + $ref: "#/paths/~1StudentProviderEnrolments/get/responses/200/cont\ + ent/application~1json/schema/properties/StudentProviderEnro\ + lments/properties/StudentProviderEnrolment/items" + example: + StudentProviderEnrolment: + StudentProviderEnrolmentRefId: A8C3D3E3-4B35-9D75-101D-00AA001A1652 + StudentProviderEnrolmentLocalId: 2004H102 + Student: + RefId: d3e34b35-9d75-101a-8c3d-00aa001a1652 + Provider: + RefId: d3e34b35-9d75-101a-8c3d-00aa001a1651 + EntryDate: 2018-01-29 + Status: WIT + SchoolEnrolmentList: + SchoolEnrolment: + SchoolCalendarYear: 2018 + MembershipType: BASE + YearLevel: 11 + EligibilityCriteria: GAE + EligibilityVerification: + Source: AUSPA + DocumentSerialNumber: L905673 + DocumentExpiryDate: 2019-03-30 + IsConfirmed: true + Timestamp: 2003-11-30T12:34:56.7 + Provider: + RefId: 822f6c83-2841-4a87-9ff9-49730951b3ba + FTE: 1 + FundingType: EX + FundingYearLevel: 1 + Curriculum: NZC + CurriculumLevel: 5 + InternationalEnrolment: + NZArrivalDate: 2018-05-02 + ExchangeScheme: STA + application/xml: + schema: + type: object + properties: + StudentProviderEnrolment: + $ref: "#/paths/~1StudentProviderEnrolments/get/responses/200/cont\ + ent/application~1json/schema/properties/StudentProviderEnro\ + lments/properties/StudentProviderEnrolment/items" + example: >- +The SIF GUID for the student provider enrolment.
+ required: true + schema: + type: string + operationId: updateStudentProviderEnrolment + requestBody: + description: CRUD operation on StudentProviderEnrolment + content: + application/json: + schema: + type: object + properties: + StudentProviderEnrolment: + type: object + properties: + StudentProviderEnrolmentRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-\ + 9]{4}-[a-fA-F0-9]{12}" + StudentProviderEnrolmentLocalId: + description:This is a common element used to define the locally + assigned identifier associated with an entity.
+ type: string + Student: + description:A reference to another SIF Data Object
+ type: object + properties: + RefId: + $ref: "#/paths/~1StudentProviderEnrolments~1%7BStudentPro\ + viderEnrolmentRefId%7D/put/requestBody/content/appl\ + ication~1json/schema/properties/StudentProviderEnro\ + lment/properties/StudentProviderEnrolmentRefId" + LocalId: + $ref: "#/paths/~1StudentProviderEnrolments~1%7BStudentPro\ + viderEnrolmentRefId%7D/put/requestBody/content/appl\ + ication~1json/schema/properties/StudentProviderEnro\ + lment/properties/StudentProviderEnrolmentLocalId" + Name: + type: string + description:The normal descriptive name of the referenced + object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject names, to + be included in Object References
The date from when this enrolment is ACTIVE. The date + of the student’s first attendance at the provider. If + future dated, then the intended first attendance date of + the enrolment.
+ ExitDate: + type: string + format: date + description:The date of a student’s last attendance at the + provider.
+ Status: + type: string + title: Provider Enrolment Status + description: >- +Records the status of a potentially multi-year + Provider enrolment, which goes through a different + life-cycle to the single-year school enrolment.
Student has applied to become a Student at the + Provider, this pre-enrolment has been received, and + is being processed by the provider. It has not yet + been accepted or declined by the provider.
+ enum: + - APP + - title: Accepted + description:The Provider has processed the application, + validated it against school zoning rules, and other + acceptance criteria. The provider has accepted the + enrolment and will have a place for the Student if + they choose to take it up. Student has accepted the + enrolment and is expecting to take up the enrolment + at the agreed future date.
+ enum: + - ACC + - title: Cancelled + description:The enrolment application has been declined by + the Provider, or discontinued by the Student, prior + to becoming an ACTIVE enrolment.
+ enum: + - CAN + - title: Active + description:The student has taken up the enrolment, and has + attended classes for the first time.
+ enum: + - ACT + - title: Withdrawn + description: The Student has left the Provider, after the + enrolment was made ACTIVE + enum: + - WIT + - title: Pending + description:The enrolment has been accepted by the Provider, + taken up by the Student, and the student has + attended their first day; but the enrolment is + unable to be set to ACTIVE, because there is still + an ACTIVE enrolment for the student at a (previous) + provider. Once the blocking Provider has put their + enrolment to WITHDRAWN, this enrolment can be moved + to 'ACTIVE'.
+ enum: + - PEN + Exit: + description:Details of the reasons, and interventions leading up + to the student's enrolment being terminated.
+ type: object + properties: + Reason: + type: string + title: Enrolment Exit Type + description: >- +Enrolment Exit code, derived from code set used + in School Roll Returns.
The post school activity the student is moving on + to once they have exited the school.
A list of references to Wellbeing Event, Response + & Appeal data objects, that record the process of + terminating a students enrolment.
+ type: object + properties: + Intervention: + type: array + items: + $ref: "#/paths/~1StudentProviderEnrolments~1%7BStud\ + entProviderEnrolmentRefId%7D/put/requestBody/\ + content/application~1json/schema/properties/S\ + tudentProviderEnrolment/properties/Student" + PotentialDestinationSchool: + $ref: "#/paths/~1StudentProviderEnrolments~1%7BStudentPro\ + viderEnrolmentRefId%7D/put/requestBody/content/appl\ + ication~1json/schema/properties/StudentProviderEnro\ + lment/properties/Student" + x-accessControl: + ? create + ? read + ? update + ? delete + ? aggregate + EarlyChildhoodEnrolment: + description:Properties of an enrolment in an early childhood + service (WiP).
+ type: object + properties: + ECEType: + type: string + title: Early Childhood Education Type + description: >- +The type of early childhood education the student + received.
Properties of an enrolment in a school
+ type: object + properties: + SchoolEnrolment: + type: array + items: + description:Defines information related to a student's + enrolment at a school education Provider for a + particular academic year (or part thereof)
+ type: object + properties: + SchoolCalendarYear: + description:School year for which this enrolment is + applicable, expressed as the four-digit year + in which the school year ends (eg 2018).
+ StartDate: + type: string + format: date + description:The date the student started at the + school.
+ MembershipType: + type: string + title: School Enrolment Type + description: >- +A type of student enrolment with a school. + Allows differentiation of concurrent + enrolments, eg base vs other.
The school that the student is + considered to be primarily enrolled with, + especially for the purposes of reporting + and Ministry funding. Typically the + student will spend most of their school + time at this school.
+ enum: + - BASE + - title: Hosted Enrolment + description:Indicates an enrolment that is + concurrent with the student's base + enrolment at another school.
+ enum: + - HOST + - title: Remote/Distance Learning + description:Indicates an enrolment with a school + (typically Te Kura - The Correspondence + School) which provides remote/distance + learning; this means that the student + remains at their base school (or at home) + for all classes covered by this + enrolment.
+ enum: + - REMO + YearLevel: + type: string + title: Year Level Code + description: >- +Year Level defines the values that are + valid for describing Funding Year Level and + Current Year Level for a student + enrolment.
Current Year Level indicates + the year level of the student’s class cohort + and the level at which the student spends most + of their time at school. While a student may + be enrolled in subjects at varying + instructional year levels, in relation to the + student enrolment this value represents the + year level at which the student is considered + to be predominantly taught.
Funding + Year Level measures the actual number of years + that the student has attended a school. It + provides the Ministry with a method of + counting students for funding purposes which + is independent of the way schools are + organised or the particular programme of study + that a student may undertake. Funding Year + Level for most students is based on the date + they first started school.
School Year + Level is used to indicate the instructional + year levels offered by a school, i.e. those + years for which student enrolments may be + accepted.
The criteria used to determine the + eligibility status of a student for enrolment + and MoE funding purposes.
Records how the Student's eligibility to + enrol / for funding was verified by the school + staff during the enrolment process.
+ type: object + properties: + Source: + type: string + title: Verification Source + description: >- +Records the source of the identity or + eligibility verification, that has been + made. Mostly it is merely a record of the + kind of document that has been presented; + but occasionally it is down to Principal + or Ministry discretion / approval.
+The serial number on the document that + was used to verify the name or + birthdate.
+ DocumentExpiryDate: + type: string + format: date + description:The expiry date on the document that + was used to verify the name or + birthdate.
+ IsConfirmed: + type: boolean + description:If true then verification has been + confirmed by MoE.
+ Timestamp: + description:The date & time that the + VerificationEvent took place.
+ Provider: + $ref: "#/paths/~1StudentProviderEnrolments~1%7B\ + StudentProviderEnrolmentRefId%7D/put/requ\ + estBody/content/application~1json/schema/\ + properties/StudentProviderEnrolment/prope\ + rties/Student" + x-accessControl: + ? create + ? read + ? update + ? delete + ? aggregate + FTE: + description:Full-time equivalent numeric value of the + student's course load during this enrollment, + expressed in decimal form, where 1.00 + represents a full-time enrolment.
+ FundingType: + type: string + title: Student Funding Type + description: >- +Student classification for MoE funding + purposes.
Codes in this list are + hierarchical. Students can only be allocated + one TYPE code (even though they may belong to + more than one of the groups listed below). To + allocate a code to an individual student, + start at the top of the list and work down. + Use the first code that applies to the + student.
Codes denoting the two curricula used in + New Zealand.
Which level of the National Curriculum + (1-5) is the student enrolling in?
+ x-accessControl: + ? create + ? read + ? update + ? delete + ? aggregate + LanguageOfInstructionList: + description:How much instruction has the student + received in which languages?
+ type: object + properties: + Language: + type: array + items: + description:The number of hours per week the + Learner is taught in a specific language + during the enrolment.
+ type: object + properties: + Code: + type: string + title: Language + description: >- +Language refers to recognised + human communication systems, + typically oral and/or written. + Sourced from Statistics NZ - + Language Standard Classification + 1999 v2.0.0
The level of instruction that is + made in the selected language.
+ x-accessControl: + ? create + ? read + ? update + ? delete + ? aggregate + TimeInImmersion: + type: integer + description:The number of years the student has been in + Te Reo Māori immersion education.
+ Section9Agreement: + type: string + title: Yes Or No Category + description: >- +A reusable code set for yes, no, unknown + and not provided values.
Codes denoting the level of ORS funding a + student may receive.
Student’s choice of general subjects and + learning areas to be studied during the school + year. Not to be confused with CourseChoiceList + which allows students to choose specific + courses.
+ type: object + properties: + StudentSubjectChoice: + type: array + items: + description:An individual Subject choice that can + be made, or has been made by a + Student.
+ type: object + properties: + PreferenceNumber: + type: integer + description:The student's preference for this + subject, with respect to the other + subject choices in the list.
+ Code: + type: string + title: Subject Area + description: >- +Codes denoting Subject Areas + defined by the NZ Curriculum and Te + Marautanga o Aotearoa.
Student’s choice of courses to be studied + during the school year. Not to be confused + with SubjectChoiceList which allows students + to choose general subjects and learning areas + rather than specific courses.
+ type: object + properties: + StudentCourseChoice: + type: array + items: + description:An individual Course choice that can + be made, or has been made by a + Student.
+ type: object + properties: + PreferenceNumber: + type: integer + description:The student's preference for this + course, with respect to the other + course choices in the list.
+ Course: + $ref: "#/paths/~1StudentProviderEnrolment\ + s~1%7BStudentProviderEnrolmentRefId\ + %7D/put/requestBody/content/applica\ + tion~1json/schema/properties/Studen\ + tProviderEnrolment/properties/Stude\ + nt" + x-accessControl: + ? create + ? read + ? update + ? delete + ? aggregate + CoEnrolment: + description:Describes the student's enrolment with + their base school in the case where this + enrolment is not a base school enrolment.
+ type: object + properties: + OtherProvider: + $ref: "#/paths/~1StudentProviderEnrolments~1%7B\ + StudentProviderEnrolmentRefId%7D/put/requ\ + estBody/content/application~1json/schema/\ + properties/StudentProviderEnrolment/prope\ + rties/Student" + CoEnrolmentType: + type: string + title: CoEnrolment Type + description: |- +Free text note of key behavioural + issues, made by the client school in + relation to the student.
+ ClientSchoolConfidentialNote: + type: string + description:Free text confidential note made by the + client school in relation to the + student.
+ GuardianConfidentialNote: + type: string + description:Free text confidential note made by the + parents/caregivers of the student.
+ InternationalEnrolment: + description:Additional information collected for + international enrolments.
+ type: object + properties: + NZArrivalDate: + type: string + format: date + description:The date the Student arrived in New + Zealand.
+ TuitionWeeklyFee: + description:The amount paid by the Student per Week + (GST excl) as a tuition fee.
+ ExchangeScheme: + type: string + title: Exchange Scheme + description: >- +The type of exchange scheme for student + enrolment where the Eligibility Criteria + is "Student on Government approved + exchange scheme" (5).
A list of student consent information.
+ type: object + properties: + StudentConsent: + type: array + items: + $ref: "#/paths/~1StudentProviderEnrolments~1%\ + 7BStudentProviderEnrolmentRefId%7D/put/\ + requestBody/content/application~1json/s\ + chema/properties/StudentProviderEnrolme\ + nt/properties/Student" + AcademicAttainmentGoalList: + description:The academic attainment goals of the + student when they enrol, e.g. they wish to + achieve a certain qualification.
+ type: object + properties: + AttainmentGoal: + type: array + items: + $ref: "#/paths/~1StudentProviderEnrolments~1%\ + 7BStudentProviderEnrolmentRefId%7D/put/\ + requestBody/content/application~1json/s\ + chema/properties/StudentProviderEnrolme\ + nt/properties/Student" + x-accessControl: + ? create + ? read + ? update + ? delete + ? aggregate + PreEnrolmentCancellation: + description:Details of why the school pre-enrolment was + cancelled.
+ type: object + properties: + NotifiedDate: + type: string + format: date + description:The date the Student was notified of + the cancellation of the pre-enrolment.
+ CancellationMethod: + type: string + title: Pre Enrolment Exit Type + description: >- +Code set denoting how the student's + pre-enrolment was cancelled.
Code set denoting why the student's + pre-enrolment was cancelled.
Properties of an enrolment in a Tertiary Education + service (WiP).
+ type: object + properties: + Type: + type: string + description:The type of tertiary education the student is + enrolling in.
+ x-accessControl: + ? create + ? read + ? update + ? delete + ? aggregate + description:A student's association with an education provider for + the purpose of receiving educational servics.
+Provider enrolments span multiple years with the + ProviderEnrolment containing one or more ECE, School or + Tertiary Enrolment sub-objects for each particular year.
+ x-accessControl: + create: + - 1001 + - 1306 + - 2103 + - 2401 + - 2403 + read: + - 1001 + - 1306 + - 2103 + - 2401 + - 2403 + update: + - 1001 + - 1306 + - 2103 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: + - 2002 + - 2102 + example: + StudentProviderEnrolment: + StudentProviderEnrolmentRefId: A8C3D3E3-4B35-9D75-101D-00AA001A1652 + StudentProviderEnrolmentLocalId: 2004H102 + Student: + RefId: d3e34b35-9d75-101a-8c3d-00aa001a1652 + Provider: + RefId: d3e34b35-9d75-101a-8c3d-00aa001a1651 + EntryDate: 2018-01-29 + Status: WIT + SchoolEnrolmentList: + SchoolEnrolment: + SchoolCalendarYear: 2018 + MembershipType: BASE + YearLevel: 11 + EligibilityCriteria: GAE + EligibilityVerification: + Source: AUSPA + DocumentSerialNumber: L905673 + DocumentExpiryDate: 2019-03-30 + IsConfirmed: true + Timestamp: 2003-11-30T12:34:56.7 + Provider: + RefId: 822f6c83-2841-4a87-9ff9-49730951b3ba + FTE: 1 + FundingType: EX + FundingYearLevel: 1 + Curriculum: NZC + CurriculumLevel: 5 + InternationalEnrolment: + NZArrivalDate: 2018-05-02 + ExchangeScheme: STA + application/xml: + schema: + type: object + properties: + StudentProviderEnrolment: + $ref: "#/paths/~1StudentProviderEnrolments~1%7BStudentProviderEnr\ + olmentRefId%7D/put/requestBody/content/application~1json/sc\ + hema/properties/StudentProviderEnrolment" + example: >- +The SIF GUID for the student provider enrolment.
+ required: true + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + StudentProviderEnrolment: + $ref: "#/paths/~1StudentProviderEnrolments/get/responses/200/co\ + ntent/application~1json/schema/properties/StudentProvider\ + Enrolments/properties/StudentProviderEnrolment/items" + example: + StudentProviderEnrolment: + StudentProviderEnrolmentRefId: A8C3D3E3-4B35-9D75-101D-00AA001A1652 + StudentProviderEnrolmentLocalId: 2004H102 + Student: + RefId: d3e34b35-9d75-101a-8c3d-00aa001a1652 + Provider: + RefId: d3e34b35-9d75-101a-8c3d-00aa001a1651 + EntryDate: 2018-01-29 + Status: WIT + SchoolEnrolmentList: + SchoolEnrolment: + SchoolCalendarYear: 2018 + MembershipType: BASE + YearLevel: 11 + EligibilityCriteria: GAE + EligibilityVerification: + Source: AUSPA + DocumentSerialNumber: L905673 + DocumentExpiryDate: 2019-03-30 + IsConfirmed: true + Timestamp: 2003-11-30T12:34:56.7 + Provider: + RefId: 822f6c83-2841-4a87-9ff9-49730951b3ba + FTE: 1 + FundingType: EX + FundingYearLevel: 1 + Curriculum: NZC + CurriculumLevel: 5 + InternationalEnrolment: + NZArrivalDate: 2018-05-02 + ExchangeScheme: STA + application/xml: + schema: + type: object + properties: + StudentProviderEnrolment: + $ref: "#/paths/~1StudentProviderEnrolments/get/responses/200/co\ + ntent/application~1json/schema/properties/StudentProvider\ + Enrolments/properties/StudentProviderEnrolment/items" + example: >- +The SIF GUID for the student provider enrolment.
+ required: true + schema: + type: string + responses: + "200": + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + 200" + default: + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + default" + /StudentTeachingGroupEnrolments: + get: + tags: + - StudentTeachingGroupEnrolment + summary: Default operation to get a list of all available + StudentTeachingGroupEnrolments + description: Search the set of available StudentTeachingGroupEnrolments, according to + the search criteria in the URL parameters. Returns the first 20 objects + located; with SIF defined navigation headers, indicating how to retrieve + subsequent sets of 20 objects. + parameters: + - name: LocalId + in: path + description: Search for object by LocalId, within the context of the organisation + represented by the ZoneId of the request. + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + StudentTeachingGroupEnrolments: + type: object + description: A List of StudentTeachingGroupEnrolment objects + properties: + StudentTeachingGroupEnrolment: + type: array + items: + required: + - Provider + - StartDate + - Student + - TeachingGroup + type: object + properties: + StudentTeachingGroupEnrolmentRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[\ + a-fA-F0-9]{4}-[a-fA-F0-9]{12}" + StudentTeachingGroupEnrolmentLocalId: + description:This is a common element used to define the + locally assigned identifier associated with an + entity.
+ type: string + Student: + description:A reference to another SIF Data Object
+ type: object + required: + - ObjectType + properties: + RefId: + $ref: "#/paths/~1StudentTeachingGroupEnrolments/g\ + et/responses/200/content/application~1json/\ + schema/properties/StudentTeachingGroupEnrol\ + ments/properties/StudentTeachingGroupEnrolm\ + ent/items/properties/StudentTeachingGroupEn\ + rolmentRefId" + LocalId: + $ref: "#/paths/~1StudentTeachingGroupEnrolments/g\ + et/responses/200/content/application~1json/\ + schema/properties/StudentTeachingGroupEnrol\ + ments/properties/StudentTeachingGroupEnrolm\ + ent/items/properties/StudentTeachingGroupEn\ + rolmentLocalId" + Name: + type: string + description:The normal descriptive name of the + referenced object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject + names, to be included in Object + References
The date the Student's enrolment in the + teaching group starts.
+ EndDate: + type: string + format: date + description:The date of a student’s enrolment in the + teaching group ends.
+ description:Records a student's arrival to and departure from + a TeachingGroup.
+ x-accessControl: + create: + - 1001 + - 2401 + - 2403 + read: + - 1001 + - 2401 + - 2403 + update: + - 1001 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: + - 2002 + - 2102 + example: + StudentTeachingGroupEnrolments: + StudentTeachingGroupEnrolment: + - StudentTeachingGroupEnrolmentRefId: A8C3D3E3-4B35-9D75-101D-00AA001A1652 + StudentTeachingGroupEnrolmentLocalId: 2004H102 + Student: + RefId: d3e34b35-9d75-101a-8c3d-00aa001a1652 + Provider: + RefId: d3e34b35-9d75-101a-8c3d-00aa001a1651 + TeachingGroup: + RefId: 93b9b77e-a23f-4acd-a65e-e26f1034317f + StartDate: 2018-01-29 + EndDate: 2018-12-05 + application/xml: + schema: + type: object + properties: + StudentTeachingGroupEnrolments: + type: object + description: A List of StudentTeachingGroupEnrolment objects + properties: + StudentTeachingGroupEnrolment: + type: array + items: + $ref: "#/paths/~1StudentTeachingGroupEnrolments/get/respo\ + nses/200/content/application~1json/schema/propertie\ + s/StudentTeachingGroupEnrolments/properties/Student\ + TeachingGroupEnrolment/items" + example: >- +The SIF GUID for the student teaching group enrolment.
+ required: true + schema: + type: string + operationId: createStudentTeachingGroupEnrolment + requestBody: + description: CRUD operation on StudentTeachingGroupEnrolment + content: + application/json: + schema: + type: object + properties: + StudentTeachingGroupEnrolment: + $ref: "#/paths/~1StudentTeachingGroupEnrolments/get/responses/200\ + /content/application~1json/schema/properties/StudentTeachin\ + gGroupEnrolments/properties/StudentTeachingGroupEnrolment/i\ + tems" + example: + StudentTeachingGroupEnrolment: + StudentTeachingGroupEnrolmentRefId: A8C3D3E3-4B35-9D75-101D-00AA001A1652 + StudentTeachingGroupEnrolmentLocalId: 2004H102 + Student: + RefId: d3e34b35-9d75-101a-8c3d-00aa001a1652 + Provider: + RefId: d3e34b35-9d75-101a-8c3d-00aa001a1651 + TeachingGroup: + RefId: 93b9b77e-a23f-4acd-a65e-e26f1034317f + StartDate: 2018-01-29 + EndDate: 2018-12-05 + application/xml: + schema: + type: object + properties: + StudentTeachingGroupEnrolment: + $ref: "#/paths/~1StudentTeachingGroupEnrolments/get/responses/200\ + /content/application~1json/schema/properties/StudentTeachin\ + gGroupEnrolments/properties/StudentTeachingGroupEnrolment/i\ + tems" + example: >- +The SIF GUID for the student teaching group enrolment.
+ required: true + schema: + type: string + operationId: updateStudentTeachingGroupEnrolment + requestBody: + description: CRUD operation on StudentTeachingGroupEnrolment + content: + application/json: + schema: + type: object + properties: + StudentTeachingGroupEnrolment: + type: object + properties: + StudentTeachingGroupEnrolmentRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-\ + 9]{4}-[a-fA-F0-9]{12}" + StudentTeachingGroupEnrolmentLocalId: + description:This is a common element used to define the locally + assigned identifier associated with an entity.
+ type: string + Student: + description:A reference to another SIF Data Object
+ type: object + properties: + RefId: + $ref: "#/paths/~1StudentTeachingGroupEnrolments~1%7BStude\ + ntTeachingGroupEnrolmentRefId%7D/put/requestBody/co\ + ntent/application~1json/schema/properties/StudentTe\ + achingGroupEnrolment/properties/StudentTeachingGrou\ + pEnrolmentRefId" + LocalId: + $ref: "#/paths/~1StudentTeachingGroupEnrolments~1%7BStude\ + ntTeachingGroupEnrolmentRefId%7D/put/requestBody/co\ + ntent/application~1json/schema/properties/StudentTe\ + achingGroupEnrolment/properties/StudentTeachingGrou\ + pEnrolmentLocalId" + Name: + type: string + description:The normal descriptive name of the referenced + object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject names, to + be included in Object References
The date the Student's enrolment in the teaching + group starts.
+ EndDate: + type: string + format: date + description:The date of a student’s enrolment in the teaching + group ends.
+ description:Records a student's arrival to and departure from a + TeachingGroup.
+ x-accessControl: + create: + - 1001 + - 2401 + - 2403 + read: + - 1001 + - 2401 + - 2403 + update: + - 1001 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: + - 2002 + - 2102 + example: + StudentTeachingGroupEnrolment: + StudentTeachingGroupEnrolmentRefId: A8C3D3E3-4B35-9D75-101D-00AA001A1652 + StudentTeachingGroupEnrolmentLocalId: 2004H102 + Student: + RefId: d3e34b35-9d75-101a-8c3d-00aa001a1652 + Provider: + RefId: d3e34b35-9d75-101a-8c3d-00aa001a1651 + TeachingGroup: + RefId: 93b9b77e-a23f-4acd-a65e-e26f1034317f + StartDate: 2018-01-29 + EndDate: 2018-12-05 + application/xml: + schema: + type: object + properties: + StudentTeachingGroupEnrolment: + $ref: "#/paths/~1StudentTeachingGroupEnrolments~1%7BStudentTeachi\ + ngGroupEnrolmentRefId%7D/put/requestBody/content/applicatio\ + n~1json/schema/properties/StudentTeachingGroupEnrolment" + example: >- +The SIF GUID for the student teaching group enrolment.
+ required: true + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + StudentTeachingGroupEnrolment: + $ref: "#/paths/~1StudentTeachingGroupEnrolments/get/responses/2\ + 00/content/application~1json/schema/properties/StudentTea\ + chingGroupEnrolments/properties/StudentTeachingGroupEnrol\ + ment/items" + example: + StudentTeachingGroupEnrolment: + StudentTeachingGroupEnrolmentRefId: A8C3D3E3-4B35-9D75-101D-00AA001A1652 + StudentTeachingGroupEnrolmentLocalId: 2004H102 + Student: + RefId: d3e34b35-9d75-101a-8c3d-00aa001a1652 + Provider: + RefId: d3e34b35-9d75-101a-8c3d-00aa001a1651 + TeachingGroup: + RefId: 93b9b77e-a23f-4acd-a65e-e26f1034317f + StartDate: 2018-01-29 + EndDate: 2018-12-05 + application/xml: + schema: + type: object + properties: + StudentTeachingGroupEnrolment: + $ref: "#/paths/~1StudentTeachingGroupEnrolments/get/responses/2\ + 00/content/application~1json/schema/properties/StudentTea\ + chingGroupEnrolments/properties/StudentTeachingGroupEnrol\ + ment/items" + example: >- +The SIF GUID for the student teaching group enrolment.
+ required: true + schema: + type: string + responses: + "200": + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + 200" + default: + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + default" + /Schedules: + get: + tags: + - Schedule + summary: Default operation to get a list of all available Schedules + description: Search the set of available Schedules, according to the search criteria + in the URL parameters. Returns the first 20 objects located; with SIF + defined navigation headers, indicating how to retrieve subsequent sets + of 20 objects. + parameters: + - name: LocalId + in: path + description: Search for object by LocalId, within the context of the organisation + represented by the ZoneId of the request. + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + Schedules: + type: object + description: A List of Schedule objects + properties: + Schedule: + type: array + items: + required: + - AcademicDayList + - Provider + - ScheduleName + - StartDate + type: object + properties: + ScheduleRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[\ + a-fA-F0-9]{4}-[a-fA-F0-9]{12}" + ScheduleLocalId: + description:This is a common element used to define the + locally assigned identifier associated with an + entity.
+ type: string + ScheduleName: + type: string + description:The name of the schedule.
+ StartDate: + type: string + format: date + description:The start date of the schedule.
+ EndDate: + type: string + format: date + description:The end date of the schedule.
+ Provider: + description:A reference to another SIF Data Object
+ type: object + required: + - ObjectType + properties: + RefId: + $ref: "#/paths/~1Schedules/get/responses/200/cont\ + ent/application~1json/schema/properties/Sch\ + edules/properties/Schedule/items/properties\ + /ScheduleRefId" + LocalId: + $ref: "#/paths/~1Schedules/get/responses/200/cont\ + ent/application~1json/schema/properties/Sch\ + edules/properties/Schedule/items/properties\ + /ScheduleLocalId" + Name: + type: string + description:The normal descriptive name of the + referenced object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject + names, to be included in Object + References
A list of the academic days within this + schedule.
+ type: object + required: + - AcademicDay + properties: + AcademicDay: + type: array + items: + description:An academic day that is part of this + schedule
+ type: object + required: + - AcademicDayType + - ObjectType + - PeriodList + properties: + BellSchedule: + $ref: "#/paths/~1Schedules/get/responses/20\ + 0/content/application~1json/schema/pr\ + operties/Schedules/properties/Schedul\ + e/items/properties/Provider" + PeriodList: + description:A list of the periods that make up + this academic day, e.g. Period 1, + Period 2 etc.
+ type: object + required: + - Period + properties: + Period: + type: array + items: + $ref: "#/paths/~1Schedules/get/respon\ + ses/200/content/application~1js\ + on/schema/properties/Schedules/\ + properties/Schedule/items/prope\ + rties/Provider" + description: Provides information about a schedule for a provider. + x-accessControl: + create: + - 1001 + - 2401 + - 2403 + read: + - 1001 + - 2401 + - 2403 + update: + - 1001 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: [] + example: + Schedules: + Schedule: + - ScheduleRefId: d2f4aea9-564f-4bdf-a18e-42a111a0602c + ScheduleLocalId: 2019a + ScheduleName: Scheule 2019a (Term 1) + StartDate: 2019-01-30 + EndDate: 2019-04-07 + Provider: + RefId: ab987eeb-cf1d-4e62-aecd-96d942a12828 + Name: Hogwarts High + AcademicDayList: + AcademicDay: + - RefId: 364f0aa5-49e2-434e-9c82-45770f4c71a9 + LocalId: 2019a-A + Name: Schedule 2019a, Day A + PeriodList: + Period: + - RefId: 215f796c-67f7-4855-83dc-28ad9d002830 + LocalId: 2019a-A1 + Name: Period 1 on Day A + - RefId: 1c48a0bb-a6cc-41ab-8aae-929ce5ec9c34 + LocalId: 2019a-A2 + Name: Period 2 on Day A + - RefId: 337804c6-1247-4c0f-b288-e4aa28584aad + LocalId: 2019a-B + Name: Schedule 2019a, DayB + PeriodList: + Period: + - RefId: f6776718-4680-4cb7-b649-a84f9796905c + LocalId: 2019a-B1 + Name: Period 1 on Day B + - RefId: 0ddaa486-adf1-4cb3-bd06-71397f4bbdd9 + LocalId: 2019a-B2 + Name: Period 2 on Day B + application/xml: + schema: + type: object + properties: + Schedules: + type: object + description: A List of Schedule objects + properties: + Schedule: + type: array + items: + $ref: "#/paths/~1Schedules/get/responses/200/content/appl\ + ication~1json/schema/properties/Schedules/propertie\ + s/Schedule/items" + example: >- +The ID (GUID) assigned to uniquely identify this Schedule.
+ required: true + schema: + type: string + operationId: createSchedule + requestBody: + description: CRUD operation on Schedule + content: + application/json: + schema: + type: object + properties: + Schedule: + $ref: "#/paths/~1Schedules/get/responses/200/content/application~\ + 1json/schema/properties/Schedules/properties/Schedule/items" + example: + Schedule: + ScheduleRefId: d2f4aea9-564f-4bdf-a18e-42a111a0602c + ScheduleLocalId: 2019a + ScheduleName: Scheule 2019a (Term 1) + StartDate: 2019-01-30 + EndDate: 2019-04-07 + Provider: + RefId: ab987eeb-cf1d-4e62-aecd-96d942a12828 + Name: Hogwarts High + AcademicDayList: + AcademicDay: + - RefId: 364f0aa5-49e2-434e-9c82-45770f4c71a9 + LocalId: 2019a-A + Name: Schedule 2019a, Day A + PeriodList: + Period: + - RefId: 215f796c-67f7-4855-83dc-28ad9d002830 + LocalId: 2019a-A1 + Name: Period 1 on Day A + - RefId: 1c48a0bb-a6cc-41ab-8aae-929ce5ec9c34 + LocalId: 2019a-A2 + Name: Period 2 on Day A + - RefId: 337804c6-1247-4c0f-b288-e4aa28584aad + LocalId: 2019a-B + Name: Schedule 2019a, DayB + PeriodList: + Period: + - RefId: f6776718-4680-4cb7-b649-a84f9796905c + LocalId: 2019a-B1 + Name: Period 1 on Day B + - RefId: 0ddaa486-adf1-4cb3-bd06-71397f4bbdd9 + LocalId: 2019a-B2 + Name: Period 2 on Day B + application/xml: + schema: + type: object + properties: + Schedule: + $ref: "#/paths/~1Schedules/get/responses/200/content/application~\ + 1json/schema/properties/Schedules/properties/Schedule/items" + example: >- +The ID (GUID) assigned to uniquely identify this Schedule.
+ required: true + schema: + type: string + operationId: updateSchedule + requestBody: + description: CRUD operation on Schedule + content: + application/json: + schema: + type: object + properties: + Schedule: + type: object + properties: + ScheduleRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-\ + 9]{4}-[a-fA-F0-9]{12}" + ScheduleLocalId: + description:This is a common element used to define the locally + assigned identifier associated with an entity.
+ type: string + ScheduleName: + type: string + description:The name of the schedule.
+ StartDate: + type: string + format: date + description:The start date of the schedule.
+ EndDate: + type: string + format: date + description:The end date of the schedule.
+ Provider: + description:A reference to another SIF Data Object
+ type: object + properties: + RefId: + $ref: "#/paths/~1Schedules~1%7BScheduleRefId%7D/put/reque\ + stBody/content/application~1json/schema/properties/\ + Schedule/properties/ScheduleRefId" + LocalId: + $ref: "#/paths/~1Schedules~1%7BScheduleRefId%7D/put/reque\ + stBody/content/application~1json/schema/properties/\ + Schedule/properties/ScheduleLocalId" + Name: + type: string + description:The normal descriptive name of the referenced + object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject names, to + be included in Object References
A list of the academic days within this schedule.
+ type: object + properties: + AcademicDay: + type: array + items: + description:An academic day that is part of this + schedule
+ type: object + properties: + BellSchedule: + $ref: "#/paths/~1Schedules~1%7BScheduleRefId%7D/put\ + /requestBody/content/application~1json/schema\ + /properties/Schedule/properties/Provider" + PeriodList: + description:A list of the periods that make up this + academic day, e.g. Period 1, Period 2 etc.
+ type: object + properties: + Period: + type: array + items: + $ref: "#/paths/~1Schedules~1%7BScheduleRefId%\ + 7D/put/requestBody/content/application~\ + 1json/schema/properties/Schedule/proper\ + ties/Provider" + description: Provides information about a schedule for a provider. + x-accessControl: + create: + - 1001 + - 2401 + - 2403 + read: + - 1001 + - 2401 + - 2403 + update: + - 1001 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: [] + example: + Schedule: + ScheduleRefId: d2f4aea9-564f-4bdf-a18e-42a111a0602c + ScheduleLocalId: 2019a + ScheduleName: Scheule 2019a (Term 1) + StartDate: 2019-01-30 + EndDate: 2019-04-07 + Provider: + RefId: ab987eeb-cf1d-4e62-aecd-96d942a12828 + Name: Hogwarts High + AcademicDayList: + AcademicDay: + - RefId: 364f0aa5-49e2-434e-9c82-45770f4c71a9 + LocalId: 2019a-A + Name: Schedule 2019a, Day A + PeriodList: + Period: + - RefId: 215f796c-67f7-4855-83dc-28ad9d002830 + LocalId: 2019a-A1 + Name: Period 1 on Day A + - RefId: 1c48a0bb-a6cc-41ab-8aae-929ce5ec9c34 + LocalId: 2019a-A2 + Name: Period 2 on Day A + - RefId: 337804c6-1247-4c0f-b288-e4aa28584aad + LocalId: 2019a-B + Name: Schedule 2019a, DayB + PeriodList: + Period: + - RefId: f6776718-4680-4cb7-b649-a84f9796905c + LocalId: 2019a-B1 + Name: Period 1 on Day B + - RefId: 0ddaa486-adf1-4cb3-bd06-71397f4bbdd9 + LocalId: 2019a-B2 + Name: Period 2 on Day B + application/xml: + schema: + type: object + properties: + Schedule: + $ref: "#/paths/~1Schedules~1%7BScheduleRefId%7D/put/requestBody/c\ + ontent/application~1json/schema/properties/Schedule" + example: >- +The ID (GUID) assigned to uniquely identify this Schedule.
+ required: true + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + Schedule: + $ref: "#/paths/~1Schedules/get/responses/200/content/applicatio\ + n~1json/schema/properties/Schedules/properties/Schedule/i\ + tems" + example: + Schedule: + ScheduleRefId: d2f4aea9-564f-4bdf-a18e-42a111a0602c + ScheduleLocalId: 2019a + ScheduleName: Scheule 2019a (Term 1) + StartDate: 2019-01-30 + EndDate: 2019-04-07 + Provider: + RefId: ab987eeb-cf1d-4e62-aecd-96d942a12828 + Name: Hogwarts High + AcademicDayList: + AcademicDay: + - RefId: 364f0aa5-49e2-434e-9c82-45770f4c71a9 + LocalId: 2019a-A + Name: Schedule 2019a, Day A + PeriodList: + Period: + - RefId: 215f796c-67f7-4855-83dc-28ad9d002830 + LocalId: 2019a-A1 + Name: Period 1 on Day A + - RefId: 1c48a0bb-a6cc-41ab-8aae-929ce5ec9c34 + LocalId: 2019a-A2 + Name: Period 2 on Day A + - RefId: 337804c6-1247-4c0f-b288-e4aa28584aad + LocalId: 2019a-B + Name: Schedule 2019a, DayB + PeriodList: + Period: + - RefId: f6776718-4680-4cb7-b649-a84f9796905c + LocalId: 2019a-B1 + Name: Period 1 on Day B + - RefId: 0ddaa486-adf1-4cb3-bd06-71397f4bbdd9 + LocalId: 2019a-B2 + Name: Period 2 on Day B + application/xml: + schema: + type: object + properties: + Schedule: + $ref: "#/paths/~1Schedules/get/responses/200/content/applicatio\ + n~1json/schema/properties/Schedules/properties/Schedule/i\ + tems" + example: >- +The ID (GUID) assigned to uniquely identify this Schedule.
+ required: true + schema: + type: string + responses: + "200": + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + 200" + default: + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + default" + /ScheduleAcademicDays: + get: + tags: + - ScheduleAcademicDay + summary: Default operation to get a list of all available ScheduleAcademicDays + description: Search the set of available ScheduleAcademicDays, according to the + search criteria in the URL parameters. Returns the first 20 objects + located; with SIF defined navigation headers, indicating how to retrieve + subsequent sets of 20 objects. + parameters: + - name: LocalId + in: path + description: Search for object by LocalId, within the context of the organisation + represented by the ZoneId of the request. + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + ScheduleAcademicDays: + type: object + description: A List of ScheduleAcademicDay objects + properties: + ScheduleAcademicDay: + type: array + items: + required: + - AcademicDayName + - PeriodList + - Provider + - Schedule + type: object + properties: + ScheduleAcademicDayRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[\ + a-fA-F0-9]{4}-[a-fA-F0-9]{12}" + ScheduleAcademicDayLocalId: + description:This is a common element used to define the + locally assigned identifier associated with an + entity.
+ type: string + AcademicDayName: + type: string + description:The name of the Academic Day.
+ Provider: + description:A reference to another SIF Data Object
+ type: object + required: + - ObjectType + properties: + RefId: + $ref: "#/paths/~1ScheduleAcademicDays/get/respons\ + es/200/content/application~1json/schema/pro\ + perties/ScheduleAcademicDays/properties/Sch\ + eduleAcademicDay/items/properties/ScheduleA\ + cademicDayRefId" + LocalId: + $ref: "#/paths/~1ScheduleAcademicDays/get/respons\ + es/200/content/application~1json/schema/pro\ + perties/ScheduleAcademicDays/properties/Sch\ + eduleAcademicDay/items/properties/ScheduleA\ + cademicDayLocalId" + Name: + type: string + description:The normal descriptive name of the + referenced object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject + names, to be included in Object + References
A list of periods that make up this academic + day, e.g. Period 1, Period 2 etc.
+ type: object + required: + - Period + properties: + Period: + type: array + items: + $ref: "#/paths/~1ScheduleAcademicDays/get/respo\ + nses/200/content/application~1json/schema\ + /properties/ScheduleAcademicDays/properti\ + es/ScheduleAcademicDay/items/properties/P\ + rovider" + description: An academic day that makes up all or part of a + schedule for a provider. An academic day represents + a structured day that reoccurs consistently e.g. Day + A has five periods that occurs Mon-Wed and Day B has + four periods and occurs Thurs-Fri. + x-accessControl: + create: + - 1001 + - 2401 + - 2403 + read: + - 1001 + - 2401 + - 2403 + update: + - 1001 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: [] + example: + ScheduleAcademicDays: + ScheduleAcademicDay: + - ScheduleAcademicDayRefId: 364f0aa5-49e2-434e-9c82-45770f4c71a9 + ScheduleAcademicDayLocalId: 2019a-A + AcademicDayName: Scheule 2019a, Day A + Provider: + RefId: ab987eeb-cf1d-4e62-aecd-96d942a12828 + Name: Hogwarts High + Schedule: + RefId: d2f4aea9-564f-4bdf-a18e-42a111a0602c + Name: Scheule 2019a (Term 1) + BellSchedule: + RefId: 8bda1e4a-ddd2-4d18-9a85-ffcd7a2528b8 + Name: Schedule 2019a, Normal Bell Schedule + PeriodList: + Period: + - RefId: 215f796c-67f7-4855-83dc-28ad9d002830 + LocalId: 2019a-A1 + Name: Period 1 on Day A + - RefId: 1c48a0bb-a6cc-41ab-8aae-929ce5ec9c34 + LocalId: 2019a-A2 + Name: Period 2 on Day A + application/xml: + schema: + type: object + properties: + ScheduleAcademicDays: + type: object + description: A List of ScheduleAcademicDay objects + properties: + ScheduleAcademicDay: + type: array + items: + $ref: "#/paths/~1ScheduleAcademicDays/get/responses/200/c\ + ontent/application~1json/schema/properties/Schedule\ + AcademicDays/properties/ScheduleAcademicDay/items" + example: >- +The ID (GUID) assigned to uniquely identify this Academic + Day.
+ required: true + schema: + type: string + operationId: createScheduleAcademicDay + requestBody: + description: CRUD operation on ScheduleAcademicDay + content: + application/json: + schema: + type: object + properties: + ScheduleAcademicDay: + $ref: "#/paths/~1ScheduleAcademicDays/get/responses/200/content/a\ + pplication~1json/schema/properties/ScheduleAcademicDays/pro\ + perties/ScheduleAcademicDay/items" + example: + ScheduleAcademicDay: + ScheduleAcademicDayRefId: 364f0aa5-49e2-434e-9c82-45770f4c71a9 + ScheduleAcademicDayLocalId: 2019a-A + AcademicDayName: Scheule 2019a, Day A + Provider: + RefId: ab987eeb-cf1d-4e62-aecd-96d942a12828 + Name: Hogwarts High + Schedule: + RefId: d2f4aea9-564f-4bdf-a18e-42a111a0602c + Name: Scheule 2019a (Term 1) + BellSchedule: + RefId: 8bda1e4a-ddd2-4d18-9a85-ffcd7a2528b8 + Name: Schedule 2019a, Normal Bell Schedule + PeriodList: + Period: + - RefId: 215f796c-67f7-4855-83dc-28ad9d002830 + LocalId: 2019a-A1 + Name: Period 1 on Day A + - RefId: 1c48a0bb-a6cc-41ab-8aae-929ce5ec9c34 + LocalId: 2019a-A2 + Name: Period 2 on Day A + application/xml: + schema: + type: object + properties: + ScheduleAcademicDay: + $ref: "#/paths/~1ScheduleAcademicDays/get/responses/200/content/a\ + pplication~1json/schema/properties/ScheduleAcademicDays/pro\ + perties/ScheduleAcademicDay/items" + example: >- +The ID (GUID) assigned to uniquely identify this Academic + Day.
+ required: true + schema: + type: string + operationId: updateScheduleAcademicDay + requestBody: + description: CRUD operation on ScheduleAcademicDay + content: + application/json: + schema: + type: object + properties: + ScheduleAcademicDay: + type: object + properties: + ScheduleAcademicDayRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-\ + 9]{4}-[a-fA-F0-9]{12}" + ScheduleAcademicDayLocalId: + description:This is a common element used to define the locally + assigned identifier associated with an entity.
+ type: string + AcademicDayName: + type: string + description:The name of the Academic Day.
+ Provider: + description:A reference to another SIF Data Object
+ type: object + properties: + RefId: + $ref: "#/paths/~1ScheduleAcademicDays~1%7BScheduleAcademi\ + cDayRefId%7D/put/requestBody/content/application~1j\ + son/schema/properties/ScheduleAcademicDay/propertie\ + s/ScheduleAcademicDayRefId" + LocalId: + $ref: "#/paths/~1ScheduleAcademicDays~1%7BScheduleAcademi\ + cDayRefId%7D/put/requestBody/content/application~1j\ + son/schema/properties/ScheduleAcademicDay/propertie\ + s/ScheduleAcademicDayLocalId" + Name: + type: string + description:The normal descriptive name of the referenced + object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject names, to + be included in Object References
A list of periods that make up this academic day, + e.g. Period 1, Period 2 etc.
+ type: object + properties: + Period: + type: array + items: + $ref: "#/paths/~1ScheduleAcademicDays~1%7BScheduleAcade\ + micDayRefId%7D/put/requestBody/content/applicatio\ + n~1json/schema/properties/ScheduleAcademicDay/pro\ + perties/Provider" + description: An academic day that makes up all or part of a schedule for + a provider. An academic day represents a structured day that + reoccurs consistently e.g. Day A has five periods that + occurs Mon-Wed and Day B has four periods and occurs + Thurs-Fri. + x-accessControl: + create: + - 1001 + - 2401 + - 2403 + read: + - 1001 + - 2401 + - 2403 + update: + - 1001 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: [] + example: + ScheduleAcademicDay: + ScheduleAcademicDayRefId: 364f0aa5-49e2-434e-9c82-45770f4c71a9 + ScheduleAcademicDayLocalId: 2019a-A + AcademicDayName: Scheule 2019a, Day A + Provider: + RefId: ab987eeb-cf1d-4e62-aecd-96d942a12828 + Name: Hogwarts High + Schedule: + RefId: d2f4aea9-564f-4bdf-a18e-42a111a0602c + Name: Scheule 2019a (Term 1) + BellSchedule: + RefId: 8bda1e4a-ddd2-4d18-9a85-ffcd7a2528b8 + Name: Schedule 2019a, Normal Bell Schedule + PeriodList: + Period: + - RefId: 215f796c-67f7-4855-83dc-28ad9d002830 + LocalId: 2019a-A1 + Name: Period 1 on Day A + - RefId: 1c48a0bb-a6cc-41ab-8aae-929ce5ec9c34 + LocalId: 2019a-A2 + Name: Period 2 on Day A + application/xml: + schema: + type: object + properties: + ScheduleAcademicDay: + $ref: "#/paths/~1ScheduleAcademicDays~1%7BScheduleAcademicDayRefI\ + d%7D/put/requestBody/content/application~1json/schema/prope\ + rties/ScheduleAcademicDay" + example: >- +The ID (GUID) assigned to uniquely identify this Academic + Day.
+ required: true + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + ScheduleAcademicDay: + $ref: "#/paths/~1ScheduleAcademicDays/get/responses/200/content\ + /application~1json/schema/properties/ScheduleAcademicDays\ + /properties/ScheduleAcademicDay/items" + example: + ScheduleAcademicDay: + ScheduleAcademicDayRefId: 364f0aa5-49e2-434e-9c82-45770f4c71a9 + ScheduleAcademicDayLocalId: 2019a-A + AcademicDayName: Scheule 2019a, Day A + Provider: + RefId: ab987eeb-cf1d-4e62-aecd-96d942a12828 + Name: Hogwarts High + Schedule: + RefId: d2f4aea9-564f-4bdf-a18e-42a111a0602c + Name: Scheule 2019a (Term 1) + BellSchedule: + RefId: 8bda1e4a-ddd2-4d18-9a85-ffcd7a2528b8 + Name: Schedule 2019a, Normal Bell Schedule + PeriodList: + Period: + - RefId: 215f796c-67f7-4855-83dc-28ad9d002830 + LocalId: 2019a-A1 + Name: Period 1 on Day A + - RefId: 1c48a0bb-a6cc-41ab-8aae-929ce5ec9c34 + LocalId: 2019a-A2 + Name: Period 2 on Day A + application/xml: + schema: + type: object + properties: + ScheduleAcademicDay: + $ref: "#/paths/~1ScheduleAcademicDays/get/responses/200/content\ + /application~1json/schema/properties/ScheduleAcademicDays\ + /properties/ScheduleAcademicDay/items" + example: >- +The ID (GUID) assigned to uniquely identify this Academic + Day.
+ required: true + schema: + type: string + responses: + "200": + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + 200" + default: + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + default" + /SchedulePeriods: + get: + tags: + - SchedulePeriod + summary: Default operation to get a list of all available SchedulePeriods + description: Search the set of available SchedulePeriods, according to the search + criteria in the URL parameters. Returns the first 20 objects located; + with SIF defined navigation headers, indicating how to retrieve + subsequent sets of 20 objects. + parameters: + - name: LocalId + in: path + description: Search for object by LocalId, within the context of the organisation + represented by the ZoneId of the request. + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + SchedulePeriods: + type: object + description: A List of SchedulePeriod objects + properties: + SchedulePeriod: + type: array + items: + required: + - AcademicDay + - PeriodName + - Provider + - Schedule + type: object + properties: + SchedulePeriodRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[\ + a-fA-F0-9]{4}-[a-fA-F0-9]{12}" + SchedulePeriodLocalId: + description:This is a common element used to define the + locally assigned identifier associated with an + entity.
+ type: string + PeriodName: + type: string + description:The name of the schedule period.
+ Provider: + description:A reference to another SIF Data Object
+ type: object + required: + - ObjectType + properties: + RefId: + $ref: "#/paths/~1SchedulePeriods/get/responses/20\ + 0/content/application~1json/schema/properti\ + es/SchedulePeriods/properties/SchedulePerio\ + d/items/properties/SchedulePeriodRefId" + LocalId: + $ref: "#/paths/~1SchedulePeriods/get/responses/20\ + 0/content/application~1json/schema/properti\ + es/SchedulePeriods/properties/SchedulePerio\ + d/items/properties/SchedulePeriodLocalId" + Name: + type: string + description:The normal descriptive name of the + referenced object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject + names, to be included in Object + References
The ID (GUID) assigned to uniquely identify this Schedule + Period.
+ required: true + schema: + type: string + operationId: createSchedulePeriod + requestBody: + description: CRUD operation on SchedulePeriod + content: + application/json: + schema: + type: object + properties: + SchedulePeriod: + $ref: "#/paths/~1SchedulePeriods/get/responses/200/content/applic\ + ation~1json/schema/properties/SchedulePeriods/properties/Sc\ + hedulePeriod/items" + example: + SchedulePeriod: + SchedulePeriodRefId: 215f796c-67f7-4855-83dc-28ad9d002830 + SchedulePeriodLocalId: 2019a-A1 + PeriodName: Period 1 on Day A + Provider: + RefId: ab987eeb-cf1d-4e62-aecd-96d942a12828 + Name: Hogwarts High + Schedule: + RefId: d2f4aea9-564f-4bdf-a18e-42a111a0602c + LocalId: 2019a + Name: Scheule 2019a (Term 1) + AcademicDay: + RefId: 364f0aa5-49e2-434e-9c82-45770f4c71a9 + LocalId: 2019a-A + Name: Schedule 2019a, Day A + application/xml: + schema: + type: object + properties: + SchedulePeriod: + $ref: "#/paths/~1SchedulePeriods/get/responses/200/content/applic\ + ation~1json/schema/properties/SchedulePeriods/properties/Sc\ + hedulePeriod/items" + example: >- +The ID (GUID) assigned to uniquely identify this Schedule + Period.
+ required: true + schema: + type: string + operationId: updateSchedulePeriod + requestBody: + description: CRUD operation on SchedulePeriod + content: + application/json: + schema: + type: object + properties: + SchedulePeriod: + type: object + properties: + SchedulePeriodRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-\ + 9]{4}-[a-fA-F0-9]{12}" + SchedulePeriodLocalId: + description:This is a common element used to define the locally + assigned identifier associated with an entity.
+ type: string + PeriodName: + type: string + description:The name of the schedule period.
+ Provider: + description:A reference to another SIF Data Object
+ type: object + properties: + RefId: + $ref: "#/paths/~1SchedulePeriods~1%7BSchedulePeriodRefId%\ + 7D/put/requestBody/content/application~1json/schema\ + /properties/SchedulePeriod/properties/SchedulePerio\ + dRefId" + LocalId: + $ref: "#/paths/~1SchedulePeriods~1%7BSchedulePeriodRefId%\ + 7D/put/requestBody/content/application~1json/schema\ + /properties/SchedulePeriod/properties/SchedulePerio\ + dLocalId" + Name: + type: string + description:The normal descriptive name of the referenced + object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject names, to + be included in Object References
The ID (GUID) assigned to uniquely identify this Schedule + Period.
+ required: true + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + SchedulePeriod: + $ref: "#/paths/~1SchedulePeriods/get/responses/200/content/appl\ + ication~1json/schema/properties/SchedulePeriods/propertie\ + s/SchedulePeriod/items" + example: + SchedulePeriod: + SchedulePeriodRefId: 215f796c-67f7-4855-83dc-28ad9d002830 + SchedulePeriodLocalId: 2019a-A1 + PeriodName: Period 1 on Day A + Provider: + RefId: ab987eeb-cf1d-4e62-aecd-96d942a12828 + Name: Hogwarts High + Schedule: + RefId: d2f4aea9-564f-4bdf-a18e-42a111a0602c + LocalId: 2019a + Name: Scheule 2019a (Term 1) + AcademicDay: + RefId: 364f0aa5-49e2-434e-9c82-45770f4c71a9 + LocalId: 2019a-A + Name: Schedule 2019a, Day A + application/xml: + schema: + type: object + properties: + SchedulePeriod: + $ref: "#/paths/~1SchedulePeriods/get/responses/200/content/appl\ + ication~1json/schema/properties/SchedulePeriods/propertie\ + s/SchedulePeriod/items" + example: >- +The ID (GUID) assigned to uniquely identify this Schedule + Period.
+ required: true + schema: + type: string + responses: + "200": + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + 200" + default: + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + default" + /BellSchedules: + get: + tags: + - BellSchedule + summary: Default operation to get a list of all available BellSchedules + description: Search the set of available BellSchedules, according to the search + criteria in the URL parameters. Returns the first 20 objects located; + with SIF defined navigation headers, indicating how to retrieve + subsequent sets of 20 objects. + parameters: + - name: LocalId + in: path + description: Search for object by LocalId, within the context of the organisation + represented by the ZoneId of the request. + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + BellSchedules: + type: object + description: A List of BellSchedule objects + properties: + BellSchedule: + type: array + items: + required: + - BellScheduleName + - Provider + - Schedule + - SchedulePeriodList + type: object + properties: + BellScheduleRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[\ + a-fA-F0-9]{4}-[a-fA-F0-9]{12}" + BellScheduleLocalId: + description:This is a common element used to define the + locally assigned identifier associated with an + entity.
+ type: string + BellScheduleName: + type: string + description:The name of the Bell Schedule.
+ Provider: + description:A reference to another SIF Data Object
+ type: object + required: + - ObjectType + properties: + RefId: + $ref: "#/paths/~1BellSchedules/get/responses/200/\ + content/application~1json/schema/properties\ + /BellSchedules/properties/BellSchedule/item\ + s/properties/BellScheduleRefId" + LocalId: + $ref: "#/paths/~1BellSchedules/get/responses/200/\ + content/application~1json/schema/properties\ + /BellSchedules/properties/BellSchedule/item\ + s/properties/BellScheduleLocalId" + Name: + type: string + description:The normal descriptive name of the + referenced object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject + names, to be included in Object + References
A list of periods that make up this academic + day, e.g. Period 1, Period 2 etc.
+ type: object + required: + - SchedulePeriodTime + properties: + SchedulePeriodTime: + type: array + items: + description:The definition of a SchedulePeriod + start and end time, on a particular Bell + Schedule.
+ type: object + required: + - EndTime + - Period + - SchedulePeriodTimeType + - StartTime + properties: + Period: + $ref: "#/paths/~1BellSchedules/get/response\ + s/200/content/application~1json/schem\ + a/properties/BellSchedules/properties\ + /BellSchedule/items/properties/Provid\ + er" + StartTime: + description:The time the period starts.
+ EndTime: + description:The time the period ends.
+ description: Defines bell schedules, each of which is a + collection of periods within an academic day with + start and end times associated. These bell schedules + are assigned to calendar dates on which the school + is in session using ScheduleDate in order to specify + the school schedule on those dates. These bell + schedules should generally only be used to define + standard day types. Exception days (unless they + repeat multiple times and follow a common template) + are defined using ScheduleEvent and + ScheduleCustomDayEvent. + x-accessControl: + create: + - 1001 + - 2401 + - 2403 + read: + - 1001 + - 2401 + - 2403 + update: + - 1001 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: [] + example: + BellSchedules: + BellSchedule: + - BellScheduleRefId: d2f4aea9-564f-4bdf-a18e-42a111a0602c + BellScheduleLocalId: 2019a-Normal + BellScheduleName: Schedule 2019a, Normal Bell Schedule + Provider: + RefId: ab987eeb-cf1d-4e62-aecd-96d942a12828 + Name: Hogwarts High + Schedule: + Name: Scheule 2019a (Term 1) + SchedulePeriodList: + SchedulePeriodTime: + - Period: + RefId: 215f796c-67f7-4855-83dc-28ad9d002830 + LocalId: 2019a-A1 + Name: Period 1 on Day A + StartTime: 08:45:00 + EndTime: 09:35:00 + - Period: + RefId: 1c48a0bb-a6cc-41ab-8aae-929ce5ec9c34 + LocalId: 2019a-A2 + Name: Period 2 on Day A + StartTime: 09:45:00 + EndTime: 10:35:00 + application/xml: + schema: + type: object + properties: + BellSchedules: + type: object + description: A List of BellSchedule objects + properties: + BellSchedule: + type: array + items: + $ref: "#/paths/~1BellSchedules/get/responses/200/content/\ + application~1json/schema/properties/BellSchedules/p\ + roperties/BellSchedule/items" + example: >- +The ID (GUID) assigned to uniquely identify this Bell + Schedule.
+ required: true + schema: + type: string + operationId: createBellSchedule + requestBody: + description: CRUD operation on BellSchedule + content: + application/json: + schema: + type: object + properties: + BellSchedule: + $ref: "#/paths/~1BellSchedules/get/responses/200/content/applicat\ + ion~1json/schema/properties/BellSchedules/properties/BellSc\ + hedule/items" + example: + BellSchedule: + BellScheduleRefId: d2f4aea9-564f-4bdf-a18e-42a111a0602c + BellScheduleLocalId: 2019a-Normal + BellScheduleName: Schedule 2019a, Normal Bell Schedule + Provider: + RefId: ab987eeb-cf1d-4e62-aecd-96d942a12828 + Name: Hogwarts High + Schedule: + Name: Scheule 2019a (Term 1) + SchedulePeriodList: + SchedulePeriodTime: + - Period: + RefId: 215f796c-67f7-4855-83dc-28ad9d002830 + LocalId: 2019a-A1 + Name: Period 1 on Day A + StartTime: 08:45:00 + EndTime: 09:35:00 + - Period: + RefId: 1c48a0bb-a6cc-41ab-8aae-929ce5ec9c34 + LocalId: 2019a-A2 + Name: Period 2 on Day A + StartTime: 09:45:00 + EndTime: 10:35:00 + application/xml: + schema: + type: object + properties: + BellSchedule: + $ref: "#/paths/~1BellSchedules/get/responses/200/content/applicat\ + ion~1json/schema/properties/BellSchedules/properties/BellSc\ + hedule/items" + example: >- +The ID (GUID) assigned to uniquely identify this Bell + Schedule.
+ required: true + schema: + type: string + operationId: updateBellSchedule + requestBody: + description: CRUD operation on BellSchedule + content: + application/json: + schema: + type: object + properties: + BellSchedule: + type: object + properties: + BellScheduleRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-\ + 9]{4}-[a-fA-F0-9]{12}" + BellScheduleLocalId: + description:This is a common element used to define the locally + assigned identifier associated with an entity.
+ type: string + BellScheduleName: + type: string + description:The name of the Bell Schedule.
+ Provider: + description:A reference to another SIF Data Object
+ type: object + properties: + RefId: + $ref: "#/paths/~1BellSchedules~1%7BBellScheduleRefId%7D/p\ + ut/requestBody/content/application~1json/schema/pro\ + perties/BellSchedule/properties/BellScheduleRefId" + LocalId: + $ref: "#/paths/~1BellSchedules~1%7BBellScheduleRefId%7D/p\ + ut/requestBody/content/application~1json/schema/pro\ + perties/BellSchedule/properties/BellScheduleLocalId" + Name: + type: string + description:The normal descriptive name of the referenced + object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject names, to + be included in Object References
A list of periods that make up this academic day, + e.g. Period 1, Period 2 etc.
+ type: object + properties: + SchedulePeriodTime: + type: array + items: + description:The definition of a SchedulePeriod start and + end time, on a particular Bell Schedule.
+ type: object + properties: + Period: + $ref: "#/paths/~1BellSchedules~1%7BBellScheduleRefI\ + d%7D/put/requestBody/content/application~1jso\ + n/schema/properties/BellSchedule/properties/P\ + rovider" + StartTime: + description:The time the period starts.
+ EndTime: + description:The time the period ends.
+ description: Defines bell schedules, each of which is a collection of + periods within an academic day with start and end times + associated. These bell schedules are assigned to calendar + dates on which the school is in session using ScheduleDate + in order to specify the school schedule on those dates. + These bell schedules should generally only be used to define + standard day types. Exception days (unless they repeat + multiple times and follow a common template) are defined + using ScheduleEvent and ScheduleCustomDayEvent. + x-accessControl: + create: + - 1001 + - 2401 + - 2403 + read: + - 1001 + - 2401 + - 2403 + update: + - 1001 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: [] + example: + BellSchedule: + BellScheduleRefId: d2f4aea9-564f-4bdf-a18e-42a111a0602c + BellScheduleLocalId: 2019a-Normal + BellScheduleName: Schedule 2019a, Normal Bell Schedule + Provider: + RefId: ab987eeb-cf1d-4e62-aecd-96d942a12828 + Name: Hogwarts High + Schedule: + Name: Scheule 2019a (Term 1) + SchedulePeriodList: + SchedulePeriodTime: + - Period: + RefId: 215f796c-67f7-4855-83dc-28ad9d002830 + LocalId: 2019a-A1 + Name: Period 1 on Day A + StartTime: 08:45:00 + EndTime: 09:35:00 + - Period: + RefId: 1c48a0bb-a6cc-41ab-8aae-929ce5ec9c34 + LocalId: 2019a-A2 + Name: Period 2 on Day A + StartTime: 09:45:00 + EndTime: 10:35:00 + application/xml: + schema: + type: object + properties: + BellSchedule: + $ref: "#/paths/~1BellSchedules~1%7BBellScheduleRefId%7D/put/reque\ + stBody/content/application~1json/schema/properties/BellSche\ + dule" + example: >- +The ID (GUID) assigned to uniquely identify this Bell + Schedule.
+ required: true + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + BellSchedule: + $ref: "#/paths/~1BellSchedules/get/responses/200/content/applic\ + ation~1json/schema/properties/BellSchedules/properties/Be\ + llSchedule/items" + example: + BellSchedule: + BellScheduleRefId: d2f4aea9-564f-4bdf-a18e-42a111a0602c + BellScheduleLocalId: 2019a-Normal + BellScheduleName: Schedule 2019a, Normal Bell Schedule + Provider: + RefId: ab987eeb-cf1d-4e62-aecd-96d942a12828 + Name: Hogwarts High + Schedule: + Name: Scheule 2019a (Term 1) + SchedulePeriodList: + SchedulePeriodTime: + - Period: + RefId: 215f796c-67f7-4855-83dc-28ad9d002830 + LocalId: 2019a-A1 + Name: Period 1 on Day A + StartTime: 08:45:00 + EndTime: 09:35:00 + - Period: + RefId: 1c48a0bb-a6cc-41ab-8aae-929ce5ec9c34 + LocalId: 2019a-A2 + Name: Period 2 on Day A + StartTime: 09:45:00 + EndTime: 10:35:00 + application/xml: + schema: + type: object + properties: + BellSchedule: + $ref: "#/paths/~1BellSchedules/get/responses/200/content/applic\ + ation~1json/schema/properties/BellSchedules/properties/Be\ + llSchedule/items" + example: >- +The ID (GUID) assigned to uniquely identify this Bell + Schedule.
+ required: true + schema: + type: string + responses: + "200": + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + 200" + default: + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + default" + /ScheduleTerms: + get: + tags: + - ScheduleTerm + summary: Default operation to get a list of all available ScheduleTerms + description: Search the set of available ScheduleTerms, according to the search + criteria in the URL parameters. Returns the first 20 objects located; + with SIF defined navigation headers, indicating how to retrieve + subsequent sets of 20 objects. + parameters: + - name: LocalId + in: path + description: Search for object by LocalId, within the context of the organisation + represented by the ZoneId of the request. + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + ScheduleTerms: + type: object + description: A List of ScheduleTerm objects + properties: + ScheduleTerm: + type: array + items: + required: + - EndDate + - SchoolYear + - StartDate + - TermName + type: object + properties: + ScheduleTermRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[\ + a-fA-F0-9]{4}-[a-fA-F0-9]{12}" + ScheduleTermLocalId: + description:This is a common element used to define the + locally assigned identifier associated with an + entity.
+ type: string + TermName: + type: string + description:The name of the schedule term.
+ Provider: + description:A reference to another SIF Data Object
+ type: object + required: + - ObjectType + properties: + RefId: + $ref: "#/paths/~1ScheduleTerms/get/responses/200/\ + content/application~1json/schema/properties\ + /ScheduleTerms/properties/ScheduleTerm/item\ + s/properties/ScheduleTermRefId" + LocalId: + $ref: "#/paths/~1ScheduleTerms/get/responses/200/\ + content/application~1json/schema/properties\ + /ScheduleTerms/properties/ScheduleTerm/item\ + s/properties/ScheduleTermLocalId" + Name: + type: string + description:The normal descriptive name of the + referenced object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject + names, to be included in Object + References
The school year the Term is part of.
+ StartDate: + type: string + format: date + description:The start date of the term
+ EndDate: + type: string + format: date + description:The end date of the term
+ description:Provides information about school terms, tertiary + terms etc., either at a national, or provider level, + within a school year. If the term is being supplied + at a national level, no provider information will be + linked.
+ x-accessControl: + create: + - 1001 + - 2401 + - 2403 + read: + - 1001 + - 2401 + - 2403 + update: + - 1001 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: [] + example: + ScheduleTerms: + ScheduleTerm: + - ScheduleTermRefId: eed03e3c-b088-4b69-bba7-b042f6f7a040 + ScheduleTermLocalId: 2019-1 + TermName: Term I of 2019 + StartDate: 2019-01-28 + EndDate: 2019-03-13 + application/xml: + schema: + type: object + properties: + ScheduleTerms: + type: object + description: A List of ScheduleTerm objects + properties: + ScheduleTerm: + type: array + items: + $ref: "#/paths/~1ScheduleTerms/get/responses/200/content/\ + application~1json/schema/properties/ScheduleTerms/p\ + roperties/ScheduleTerm/items" + example: >- +The ID (GUID) assigned to uniquely identify this Schedule + Term.
+ required: true + schema: + type: string + operationId: createScheduleTerm + requestBody: + description: CRUD operation on ScheduleTerm + content: + application/json: + schema: + type: object + properties: + ScheduleTerm: + $ref: "#/paths/~1ScheduleTerms/get/responses/200/content/applicat\ + ion~1json/schema/properties/ScheduleTerms/properties/Schedu\ + leTerm/items" + example: + ScheduleTerm: + ScheduleTermRefId: eed03e3c-b088-4b69-bba7-b042f6f7a040 + ScheduleTermLocalId: 2019-1 + TermName: Term I of 2019 + StartDate: 2019-01-28 + EndDate: 2019-03-13 + application/xml: + schema: + type: object + properties: + ScheduleTerm: + $ref: "#/paths/~1ScheduleTerms/get/responses/200/content/applicat\ + ion~1json/schema/properties/ScheduleTerms/properties/Schedu\ + leTerm/items" + example: >- +The ID (GUID) assigned to uniquely identify this Schedule + Term.
+ required: true + schema: + type: string + operationId: updateScheduleTerm + requestBody: + description: CRUD operation on ScheduleTerm + content: + application/json: + schema: + type: object + properties: + ScheduleTerm: + type: object + properties: + ScheduleTermRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-\ + 9]{4}-[a-fA-F0-9]{12}" + ScheduleTermLocalId: + description:This is a common element used to define the locally + assigned identifier associated with an entity.
+ type: string + TermName: + type: string + description:The name of the schedule term.
+ Provider: + description:A reference to another SIF Data Object
+ type: object + properties: + RefId: + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/p\ + ut/requestBody/content/application~1json/schema/pro\ + perties/ScheduleTerm/properties/ScheduleTermRefId" + LocalId: + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/p\ + ut/requestBody/content/application~1json/schema/pro\ + perties/ScheduleTerm/properties/ScheduleTermLocalId" + Name: + type: string + description:The normal descriptive name of the referenced + object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject names, to + be included in Object References
The school year the Term is part of.
+ StartDate: + type: string + format: date + description:The start date of the term
+ EndDate: + type: string + format: date + description:The end date of the term
+ description:Provides information about school terms, tertiary terms + etc., either at a national, or provider level, within a + school year. If the term is being supplied at a national + level, no provider information will be linked.
+ x-accessControl: + create: + - 1001 + - 2401 + - 2403 + read: + - 1001 + - 2401 + - 2403 + update: + - 1001 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: [] + example: + ScheduleTerm: + ScheduleTermRefId: eed03e3c-b088-4b69-bba7-b042f6f7a040 + ScheduleTermLocalId: 2019-1 + TermName: Term I of 2019 + StartDate: 2019-01-28 + EndDate: 2019-03-13 + application/xml: + schema: + type: object + properties: + ScheduleTerm: + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/put/reque\ + stBody/content/application~1json/schema/properties/Schedule\ + Term" + example: >- +The ID (GUID) assigned to uniquely identify this Schedule + Term.
+ required: true + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + ScheduleTerm: + $ref: "#/paths/~1ScheduleTerms/get/responses/200/content/applic\ + ation~1json/schema/properties/ScheduleTerms/properties/Sc\ + heduleTerm/items" + example: + ScheduleTerm: + ScheduleTermRefId: eed03e3c-b088-4b69-bba7-b042f6f7a040 + ScheduleTermLocalId: 2019-1 + TermName: Term I of 2019 + StartDate: 2019-01-28 + EndDate: 2019-03-13 + application/xml: + schema: + type: object + properties: + ScheduleTerm: + $ref: "#/paths/~1ScheduleTerms/get/responses/200/content/applic\ + ation~1json/schema/properties/ScheduleTerms/properties/Sc\ + heduleTerm/items" + example: >- +The ID (GUID) assigned to uniquely identify this Schedule + Term.
+ required: true + schema: + type: string + responses: + "200": + description: Successfully deleted object(s). + content: + application/json: + schema: + $ref: "#/components/errors/delete/content/application~1json/schema" + application/xml: + schema: + $ref: "#/components/errors/delete/content/application~1json/schema" + default: + description: Failed to delete object(s). + content: + application/json: + schema: + $ref: "#/components/errors/delete/content/application~1json/schema" + application/xml: + schema: + $ref: "#/components/errors/delete/content/application~1json/schema" + /ScheduleHolidays: + get: + tags: + - ScheduleHoliday + summary: Default operation to get a list of all available ScheduleHolidays + description: Search the set of available ScheduleHoldiays, according to the search + criteria in the URL parameters. Returns the first 20 objects located; + with SIF defined navigation headers, indicating how to retrieve + subsequent sets of 20 objects. + parameters: + - name: LocalId + in: path + description: Search for object by LocalId, within the context of the organisation + represented by the ZoneId of the request. + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + ScheduleHolidays: + type: object + description: A List of ScheduleHoliday objects + properties: + ScheduleHoliday: + type: array + items: + required: + - AlwaysDisplayFlag + - HolidayDate + - HolidayName + type: object + properties: + ScheduleHolidayRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[\ + a-fA-F0-9]{4}-[a-fA-F0-9]{12}" + ScheduleHolidayLocalId: + description:This is a common element used to define the + locally assigned identifier associated with an + entity.
+ type: string + Provider: + description:A reference to another SIF Data Object
+ type: object + required: + - ObjectType + properties: + RefId: + $ref: "#/paths/~1ScheduleHolidays/get/responses/2\ + 00/content/application~1json/schema/propert\ + ies/ScheduleHolidays/properties/ScheduleHol\ + iday/items/properties/ScheduleHolidayRefId" + LocalId: + $ref: "#/paths/~1ScheduleHolidays/get/responses/2\ + 00/content/application~1json/schema/propert\ + ies/ScheduleHolidays/properties/ScheduleHol\ + iday/items/properties/ScheduleHolidayLocalI\ + d" + Name: + type: string + description:The normal descriptive name of the + referenced object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject + names, to be included in Object + References
The date of the holiday
+ HolidayName: + type: string + description:The name of the holiday.
+ HolidayLongName: + type: string + description:The long description of the holiday, if there + is one.
+ AlwaysDisplayFlag: + type: string + title: Yes Or No Category + description: >- +A reusable code set for yes, no, unknown and + not provided values.
Provides information about a holiday that may or + may not impact upon the schedule of a provider.
+ x-accessControl: + create: + - 1001 + - 2401 + - 2403 + read: + - 1001 + - 2401 + - 2403 + update: + - 1001 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: [] + example: + ScheduleHolidays: + ScheduleHoliday: + - ScheduleHolidayRefId: 4e8387f0-faed-4eb5-84ef-2139da62133d + ScheduleHolidayLocalId: 2019-ANZAC + HolidayDate: 2019-04-25 + HolidayName: ANZAC Day + HolidayLongName: ANZAC Day, 2019 + AlwaysDisplayFlag: Y + application/xml: + schema: + type: object + properties: + ScheduleHolidays: + type: object + description: A List of ScheduleHoliday objects + properties: + ScheduleHoliday: + type: array + items: + $ref: "#/paths/~1ScheduleHolidays/get/responses/200/conte\ + nt/application~1json/schema/properties/ScheduleHoli\ + days/properties/ScheduleHoliday/items" + example: >- +The ID (GUID) assigned to uniquely identify this Schedule + Term.
+ required: true + schema: + type: string + operationId: createScheduleHoliday + requestBody: + description: CRUD operation on ScheduleHoliday + content: + application/json: + schema: + type: object + properties: + ScheduleHoliday: + $ref: "#/paths/~1ScheduleHolidays/get/responses/200/content/appli\ + cation~1json/schema/properties/ScheduleHolidays/properties/\ + ScheduleHoliday/items" + example: + ScheduleHoliday: + ScheduleHolidayRefId: 4e8387f0-faed-4eb5-84ef-2139da62133d + ScheduleHolidayLocalId: 2019-ANZAC + HolidayDate: 2019-04-25 + HolidayName: ANZAC Day + HolidayLongName: ANZAC Day, 2019 + AlwaysDisplayFlag: Y + application/xml: + schema: + type: object + properties: + ScheduleHoliday: + $ref: "#/paths/~1ScheduleHolidays/get/responses/200/content/appli\ + cation~1json/schema/properties/ScheduleHolidays/properties/\ + ScheduleHoliday/items" + example: >- +The ID (GUID) assigned to uniquely identify this Schedule + Term.
+ required: true + schema: + type: string + operationId: updateScheduleHoliday + requestBody: + description: CRUD operation on ScheduleHoliday + content: + application/json: + schema: + type: object + properties: + ScheduleHoliday: + type: object + properties: + ScheduleHolidayRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-\ + 9]{4}-[a-fA-F0-9]{12}" + ScheduleHolidayLocalId: + description:This is a common element used to define the locally + assigned identifier associated with an entity.
+ type: string + Provider: + description:A reference to another SIF Data Object
+ type: object + properties: + RefId: + $ref: "#/paths/~1ScheduleHolidays~1%7BScheduleHolidayRefI\ + d%7D/put/requestBody/content/application~1json/sche\ + ma/properties/ScheduleHoliday/properties/ScheduleHo\ + lidayRefId" + LocalId: + $ref: "#/paths/~1ScheduleHolidays~1%7BScheduleHolidayRefI\ + d%7D/put/requestBody/content/application~1json/sche\ + ma/properties/ScheduleHoliday/properties/ScheduleHo\ + lidayLocalId" + Name: + type: string + description:The normal descriptive name of the referenced + object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject names, to + be included in Object References
The date of the holiday
+ HolidayName: + type: string + description:The name of the holiday.
+ HolidayLongName: + type: string + description:The long description of the holiday, if there is + one.
+ AlwaysDisplayFlag: + type: string + title: Yes Or No Category + description: >- +A reusable code set for yes, no, unknown and not + provided values.
Provides information about a holiday that may or may not + impact upon the schedule of a provider.
+ x-accessControl: + create: + - 1001 + - 2401 + - 2403 + read: + - 1001 + - 2401 + - 2403 + update: + - 1001 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: [] + example: + ScheduleHoliday: + ScheduleHolidayRefId: 4e8387f0-faed-4eb5-84ef-2139da62133d + ScheduleHolidayLocalId: 2019-ANZAC + HolidayDate: 2019-04-25 + HolidayName: ANZAC Day + HolidayLongName: ANZAC Day, 2019 + AlwaysDisplayFlag: Y + application/xml: + schema: + type: object + properties: + ScheduleHoliday: + $ref: "#/paths/~1ScheduleHolidays~1%7BScheduleHolidayRefId%7D/put\ + /requestBody/content/application~1json/schema/properties/Sc\ + heduleHoliday" + example: >- +The ID (GUID) assigned to uniquely identify this Schedule + Term.
+ required: true + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + ScheduleHoliday: + $ref: "#/paths/~1ScheduleHolidays/get/responses/200/content/app\ + lication~1json/schema/properties/ScheduleHolidays/propert\ + ies/ScheduleHoliday/items" + example: + ScheduleHoliday: + ScheduleHolidayRefId: 4e8387f0-faed-4eb5-84ef-2139da62133d + ScheduleHolidayLocalId: 2019-ANZAC + HolidayDate: 2019-04-25 + HolidayName: ANZAC Day + HolidayLongName: ANZAC Day, 2019 + AlwaysDisplayFlag: Y + application/xml: + schema: + type: object + properties: + ScheduleHoliday: + $ref: "#/paths/~1ScheduleHolidays/get/responses/200/content/app\ + lication~1json/schema/properties/ScheduleHolidays/propert\ + ies/ScheduleHoliday/items" + example: >- +The ID (GUID) assigned to uniquely identify this Schedule + Term.
+ required: true + schema: + type: string + responses: + "200": + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + 200" + default: + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + default" + /ScheduleDates: + get: + tags: + - ScheduleDate + summary: Default operation to get a list of all available ScheduleDates + description: Search the set of available ScheduleDates, according to the search + criteria in the URL parameters. Returns the first 20 objects located; + with SIF defined navigation headers, indicating how to retrieve + subsequent sets of 20 objects. + parameters: + - name: LocalId + in: path + description: Search for object by LocalId, within the context of the organisation + represented by the ZoneId of the request. + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + ScheduleDates: + type: object + description: A List of ScheduleDate objects + properties: + ScheduleDate: + type: array + items: + required: + - AcademicDay + - CalendarDate + - Provider + - Schedule + type: object + properties: + ScheduleDateRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[\ + a-fA-F0-9]{4}-[a-fA-F0-9]{12}" + ScheduleDateLocalId: + description:This is a common element used to define the + locally assigned identifier associated with an + entity.
+ type: string + CalendarDate: + type: string + description:The actual date the school is in session.
+ Provider: + description:A reference to another SIF Data Object
+ type: object + required: + - ObjectType + properties: + RefId: + $ref: "#/paths/~1ScheduleDates/get/responses/200/\ + content/application~1json/schema/properties\ + /ScheduleDates/properties/ScheduleDate/item\ + s/properties/ScheduleDateRefId" + LocalId: + $ref: "#/paths/~1ScheduleDates/get/responses/200/\ + content/application~1json/schema/properties\ + /ScheduleDates/properties/ScheduleDate/item\ + s/properties/ScheduleDateLocalId" + Name: + type: string + description:The normal descriptive name of the + referenced object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject + names, to be included in Object + References
List of generic object references to the set + of TeachingGroupEvents that take place on this + calendar date.
+ type: object + required: + - Event + properties: + Event: + type: array + items: + $ref: "#/paths/~1ScheduleDates/get/responses/20\ + 0/content/application~1json/schema/proper\ + ties/ScheduleDates/properties/ScheduleDat\ + e/items/properties/Provider" + description: Provides information about the schedule that is + being followed on a specific calendar date at a + particular Provider, e.g. Academic Day A from the + Term 1 Schedule using the Periods and their start + and end times defined in Bell Schedule Day A. + x-accessControl: + create: + - 1001 + - 2401 + - 2403 + read: + - 1001 + - 2401 + - 2403 + update: + - 1001 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: [] + example: + ScheduleDates: + ScheduleDate: + - ScheduleDateRefId: 84c40f87-769d-46cc-8077-f5efb912e099 + ScheduleDateLocalId: 2019a-A-06 + CalendarDate: 2019-03-14 + Provider: + RefId: ab987eeb-cf1d-4e62-aecd-96d942a12828 + Name: Hogwarts High + Term: + RefId: 2f97ed99-7291-4b88-91c3-709be4308c63 + Name: Hogwarts High, Term I, 2019 + Schedule: + RefId: d2f4aea9-564f-4bdf-a18e-42a111a0602c + Name: Scheule 2019a (Term 1) + AcademicDay: + RefId: 364f0aa5-49e2-434e-9c82-45770f4c71a9 + LocalId: 2019a-A + Name: Scheule 2019a, Day A + BellSchedule: + RefId: 8bda1e4a-ddd2-4d18-9a85-ffcd7a2528b8 + Name: Schedule 2019a, Normal Bell Schedule + application/xml: + schema: + type: object + properties: + ScheduleDates: + type: object + description: A List of ScheduleDate objects + properties: + ScheduleDate: + type: array + items: + $ref: "#/paths/~1ScheduleDates/get/responses/200/content/\ + application~1json/schema/properties/ScheduleDates/p\ + roperties/ScheduleDate/items" + example: >- +The ID (GUID) assigned to uniquely identify this Schedule + Date.
+ required: true + schema: + type: string + operationId: createScheduleDate + requestBody: + description: CRUD operation on ScheduleDate + content: + application/json: + schema: + type: object + properties: + ScheduleDate: + $ref: "#/paths/~1ScheduleDates/get/responses/200/content/applicat\ + ion~1json/schema/properties/ScheduleDates/properties/Schedu\ + leDate/items" + example: + ScheduleDate: + ScheduleDateRefId: 84c40f87-769d-46cc-8077-f5efb912e099 + ScheduleDateLocalId: 2019a-A-06 + CalendarDate: 2019-03-14 + Provider: + RefId: ab987eeb-cf1d-4e62-aecd-96d942a12828 + Name: Hogwarts High + Term: + RefId: 2f97ed99-7291-4b88-91c3-709be4308c63 + Name: Hogwarts High, Term I, 2019 + Schedule: + RefId: d2f4aea9-564f-4bdf-a18e-42a111a0602c + Name: Scheule 2019a (Term 1) + AcademicDay: + RefId: 364f0aa5-49e2-434e-9c82-45770f4c71a9 + LocalId: 2019a-A + Name: Scheule 2019a, Day A + BellSchedule: + RefId: 8bda1e4a-ddd2-4d18-9a85-ffcd7a2528b8 + Name: Schedule 2019a, Normal Bell Schedule + application/xml: + schema: + type: object + properties: + ScheduleDate: + $ref: "#/paths/~1ScheduleDates/get/responses/200/content/applicat\ + ion~1json/schema/properties/ScheduleDates/properties/Schedu\ + leDate/items" + example: >- +The ID (GUID) assigned to uniquely identify this Schedule + Date.
+ required: true + schema: + type: string + operationId: updateScheduleDate + requestBody: + description: CRUD operation on ScheduleDate + content: + application/json: + schema: + type: object + properties: + ScheduleDate: + type: object + properties: + ScheduleDateRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-\ + 9]{4}-[a-fA-F0-9]{12}" + ScheduleDateLocalId: + description:This is a common element used to define the locally + assigned identifier associated with an entity.
+ type: string + CalendarDate: + type: string + description:The actual date the school is in session.
+ Provider: + description:A reference to another SIF Data Object
+ type: object + properties: + RefId: + $ref: "#/paths/~1ScheduleDates~1%7BScheduleDateRefId%7D/p\ + ut/requestBody/content/application~1json/schema/pro\ + perties/ScheduleDate/properties/ScheduleDateRefId" + LocalId: + $ref: "#/paths/~1ScheduleDates~1%7BScheduleDateRefId%7D/p\ + ut/requestBody/content/application~1json/schema/pro\ + perties/ScheduleDate/properties/ScheduleDateLocalId" + Name: + type: string + description:The normal descriptive name of the referenced + object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject names, to + be included in Object References
List of generic object references to the set of + TeachingGroupEvents that take place on this calendar + date.
+ type: object + properties: + Event: + type: array + items: + $ref: "#/paths/~1ScheduleDates~1%7BScheduleDateRefId%7D\ + /put/requestBody/content/application~1json/schema\ + /properties/ScheduleDate/properties/Provider" + description: Provides information about the schedule that is being + followed on a specific calendar date at a particular + Provider, e.g. Academic Day A from the Term 1 Schedule using + the Periods and their start and end times defined in Bell + Schedule Day A. + x-accessControl: + create: + - 1001 + - 2401 + - 2403 + read: + - 1001 + - 2401 + - 2403 + update: + - 1001 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: [] + example: + ScheduleDate: + ScheduleDateRefId: 84c40f87-769d-46cc-8077-f5efb912e099 + ScheduleDateLocalId: 2019a-A-06 + CalendarDate: 2019-03-14 + Provider: + RefId: ab987eeb-cf1d-4e62-aecd-96d942a12828 + Name: Hogwarts High + Term: + RefId: 2f97ed99-7291-4b88-91c3-709be4308c63 + Name: Hogwarts High, Term I, 2019 + Schedule: + RefId: d2f4aea9-564f-4bdf-a18e-42a111a0602c + Name: Scheule 2019a (Term 1) + AcademicDay: + RefId: 364f0aa5-49e2-434e-9c82-45770f4c71a9 + LocalId: 2019a-A + Name: Scheule 2019a, Day A + BellSchedule: + RefId: 8bda1e4a-ddd2-4d18-9a85-ffcd7a2528b8 + Name: Schedule 2019a, Normal Bell Schedule + application/xml: + schema: + type: object + properties: + ScheduleDate: + $ref: "#/paths/~1ScheduleDates~1%7BScheduleDateRefId%7D/put/reque\ + stBody/content/application~1json/schema/properties/Schedule\ + Date" + example: >- +The ID (GUID) assigned to uniquely identify this Schedule + Date.
+ required: true + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + ScheduleDate: + $ref: "#/paths/~1ScheduleDates/get/responses/200/content/applic\ + ation~1json/schema/properties/ScheduleDates/properties/Sc\ + heduleDate/items" + example: + ScheduleDate: + ScheduleDateRefId: 84c40f87-769d-46cc-8077-f5efb912e099 + ScheduleDateLocalId: 2019a-A-06 + CalendarDate: 2019-03-14 + Provider: + RefId: ab987eeb-cf1d-4e62-aecd-96d942a12828 + Name: Hogwarts High + Term: + RefId: 2f97ed99-7291-4b88-91c3-709be4308c63 + Name: Hogwarts High, Term I, 2019 + Schedule: + RefId: d2f4aea9-564f-4bdf-a18e-42a111a0602c + Name: Scheule 2019a (Term 1) + AcademicDay: + RefId: 364f0aa5-49e2-434e-9c82-45770f4c71a9 + LocalId: 2019a-A + Name: Scheule 2019a, Day A + BellSchedule: + RefId: 8bda1e4a-ddd2-4d18-9a85-ffcd7a2528b8 + Name: Schedule 2019a, Normal Bell Schedule + application/xml: + schema: + type: object + properties: + ScheduleDate: + $ref: "#/paths/~1ScheduleDates/get/responses/200/content/applic\ + ation~1json/schema/properties/ScheduleDates/properties/Sc\ + heduleDate/items" + example: >- +The ID (GUID) assigned to uniquely identify this Schedule + Date.
+ required: true + schema: + type: string + responses: + "200": + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + 200" + default: + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + default" + /TeachingGroupEvents: + get: + tags: + - TeachingGroupEvent + summary: Default operation to get a list of all available TeachingGroupEvents + description: Search the set of available TeachingGroupEvents, according to the search + criteria in the URL parameters. Returns the first 20 objects located; + with SIF defined navigation headers, indicating how to retrieve + subsequent sets of 20 objects. + parameters: + - name: LocalId + in: path + description: Search for object by LocalId, within the context of the organisation + represented by the ZoneId of the request. + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + TeachingGroupEvents: + type: object + description: A List of TeachingGroupEvent objects + properties: + TeachingGroupEvent: + type: array + items: + required: + - Provider + - Schedule + - SchedulePeriod + - TeachingGroup + type: object + properties: + TeachingGroupEventRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[\ + a-fA-F0-9]{4}-[a-fA-F0-9]{12}" + TeachingGroupEventLocalId: + description:This is a common element used to define the + locally assigned identifier associated with an + entity.
+ type: string + Provider: + description:A reference to another SIF Data Object
+ type: object + required: + - ObjectType + properties: + RefId: + $ref: "#/paths/~1TeachingGroupEvents/get/response\ + s/200/content/application~1json/schema/prop\ + erties/TeachingGroupEvents/properties/Teach\ + ingGroupEvent/items/properties/TeachingGrou\ + pEventRefId" + LocalId: + $ref: "#/paths/~1TeachingGroupEvents/get/response\ + s/200/content/application~1json/schema/prop\ + erties/TeachingGroupEvents/properties/Teach\ + ingGroupEvent/items/properties/TeachingGrou\ + pEventLocalId" + Name: + type: string + description:The normal descriptive name of the + referenced object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject + names, to be included in Object + References
The Id of the room the teaching group is + meeting in.
+ RoomName: + type: string + description:The name of the room the teaching group is + meeting in.
+ TakeAttendanceFlag: + type: string + title: Yes Or No Category + description: >- +A reusable code set for yes, no, unknown and + not provided values.
List of the teacher(s) teaching the class + during this timetable event.
+ type: object + required: + - StaffMember + properties: + StaffMember: + type: array + items: + description:The individual staff member as a member + of the StaffList and their role.
+ type: object + required: + - ObjectType + - Role + properties: + Role: + type: string + title: Staff Role + description: >- +Describes the role a staff member + has at a Provider or other + EducationOrganisation.
The list of Courses that is being taught to + the teaching group at this event.
+ type: object + required: + - Course + properties: + Course: + type: array + items: + $ref: "#/paths/~1TeachingGroupEvents/get/respon\ + ses/200/content/application~1json/schema/\ + properties/TeachingGroupEvents/properties\ + /TeachingGroupEvent/items/properties/Prov\ + ider" + description:Defines a single SchedulePeriod in a Schedule + where the TeachingGroup meets.
+ x-accessControl: + create: + - 1001 + - 2401 + - 2403 + read: + - 1001 + - 2401 + - 2403 + update: + - 1001 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: [] + example: + TeachingGroupEvents: + TeachingGroupEvent: + - TeachingGroupEventRefId: 9356909d-e46a-456a-a177-6a914af861ae + TeachingGroupEventLocalId: 20197A-SPN-1 + Provider: + RefId: ab987eeb-cf1d-4e62-aecd-96d942a12828 + Name: Hogwarts High + TeachingGroup: + RefId: 64a309da-063a-2e35-b359-d75101a8c3d1 + LocalId: 20197ASPN + Name: Year 7A Maths - Space and Numbers + Schedule: + RefId: d2f4aea9-564f-4bdf-a18e-42a111a0602c + Name: Scheule 2019a (Term 1) + SchedulePeriod: + RefId: 215f796c-67f7-4855-83dc-28ad9d002830 + LocalId: 2019a-A1 + Name: Period 1 on Day A + AcademicDay: + RefId: 364f0aa5-49e2-434e-9c82-45770f4c71a9 + LocalId: 2019a-A + Name: Scheule 2019a, Day A + RoomId: TB202 + RoomName: Tower Block, Room 202 + TakeAttendanceFlag: Y + TeacherList: + StaffMember: + - RefId: A8C3A2E3-5B35-9D75-101D-00AA001A0000 + LocalId: SMI1 + Name: Thomas Smith + Role: "1001" + application/xml: + schema: + type: object + properties: + TeachingGroupEvents: + type: object + description: A List of TeachingGroupEvent objects + properties: + TeachingGroupEvent: + type: array + items: + $ref: "#/paths/~1TeachingGroupEvents/get/responses/200/co\ + ntent/application~1json/schema/properties/TeachingG\ + roupEvents/properties/TeachingGroupEvent/items" + example: >- +The GUID of the TeachingGroupEvent
+ required: true + schema: + type: string + operationId: createTeachingGroupEvent + requestBody: + description: CRUD operation on TeachingGroupEvent + content: + application/json: + schema: + type: object + properties: + TeachingGroupEvent: + $ref: "#/paths/~1TeachingGroupEvents/get/responses/200/content/ap\ + plication~1json/schema/properties/TeachingGroupEvents/prope\ + rties/TeachingGroupEvent/items" + example: + TeachingGroupEvent: + TeachingGroupEventRefId: 9356909d-e46a-456a-a177-6a914af861ae + TeachingGroupEventLocalId: 20197A-SPN-1 + Provider: + RefId: ab987eeb-cf1d-4e62-aecd-96d942a12828 + Name: Hogwarts High + TeachingGroup: + RefId: 64a309da-063a-2e35-b359-d75101a8c3d1 + LocalId: 20197ASPN + Name: Year 7A Maths - Space and Numbers + Schedule: + RefId: d2f4aea9-564f-4bdf-a18e-42a111a0602c + Name: Scheule 2019a (Term 1) + SchedulePeriod: + RefId: 215f796c-67f7-4855-83dc-28ad9d002830 + LocalId: 2019a-A1 + Name: Period 1 on Day A + AcademicDay: + RefId: 364f0aa5-49e2-434e-9c82-45770f4c71a9 + LocalId: 2019a-A + Name: Scheule 2019a, Day A + RoomId: TB202 + RoomName: Tower Block, Room 202 + TakeAttendanceFlag: Y + TeacherList: + StaffMember: + - RefId: A8C3A2E3-5B35-9D75-101D-00AA001A0000 + LocalId: SMI1 + Name: Thomas Smith + Role: "1001" + application/xml: + schema: + type: object + properties: + TeachingGroupEvent: + $ref: "#/paths/~1TeachingGroupEvents/get/responses/200/content/ap\ + plication~1json/schema/properties/TeachingGroupEvents/prope\ + rties/TeachingGroupEvent/items" + example: >- +The GUID of the TeachingGroupEvent
+ required: true + schema: + type: string + operationId: updateTeachingGroupEvent + requestBody: + description: CRUD operation on TeachingGroupEvent + content: + application/json: + schema: + type: object + properties: + TeachingGroupEvent: + type: object + properties: + TeachingGroupEventRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-\ + 9]{4}-[a-fA-F0-9]{12}" + TeachingGroupEventLocalId: + description:This is a common element used to define the locally + assigned identifier associated with an entity.
+ type: string + Provider: + description:A reference to another SIF Data Object
+ type: object + properties: + RefId: + $ref: "#/paths/~1TeachingGroupEvents~1%7BTeachingGroupEve\ + ntRefId%7D/put/requestBody/content/application~1jso\ + n/schema/properties/TeachingGroupEvent/properties/T\ + eachingGroupEventRefId" + LocalId: + $ref: "#/paths/~1TeachingGroupEvents~1%7BTeachingGroupEve\ + ntRefId%7D/put/requestBody/content/application~1jso\ + n/schema/properties/TeachingGroupEvent/properties/T\ + eachingGroupEventLocalId" + Name: + type: string + description:The normal descriptive name of the referenced + object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject names, to + be included in Object References
The Id of the room the teaching group is meeting + in.
+ RoomName: + type: string + description:The name of the room the teaching group is meeting + in.
+ TakeAttendanceFlag: + type: string + title: Yes Or No Category + description: >- +A reusable code set for yes, no, unknown and not + provided values.
List of the teacher(s) teaching the class during this + timetable event.
+ type: object + properties: + StaffMember: + type: array + items: + description:The individual staff member as a member of the + StaffList and their role.
+ type: object + properties: + Role: + type: string + title: Staff Role + description: >- +Describes the role a staff member has at a + Provider or other EducationOrganisation.
+The list of Courses that is being taught to the + teaching group at this event.
+ type: object + properties: + Course: + type: array + items: + $ref: "#/paths/~1TeachingGroupEvents~1%7BTeachingGroupE\ + ventRefId%7D/put/requestBody/content/application~\ + 1json/schema/properties/TeachingGroupEvent/proper\ + ties/Provider" + description:Defines a single SchedulePeriod in a Schedule where the + TeachingGroup meets.
+ x-accessControl: + create: + - 1001 + - 2401 + - 2403 + read: + - 1001 + - 2401 + - 2403 + update: + - 1001 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: [] + example: + TeachingGroupEvent: + TeachingGroupEventRefId: 9356909d-e46a-456a-a177-6a914af861ae + TeachingGroupEventLocalId: 20197A-SPN-1 + Provider: + RefId: ab987eeb-cf1d-4e62-aecd-96d942a12828 + Name: Hogwarts High + TeachingGroup: + RefId: 64a309da-063a-2e35-b359-d75101a8c3d1 + LocalId: 20197ASPN + Name: Year 7A Maths - Space and Numbers + Schedule: + RefId: d2f4aea9-564f-4bdf-a18e-42a111a0602c + Name: Scheule 2019a (Term 1) + SchedulePeriod: + RefId: 215f796c-67f7-4855-83dc-28ad9d002830 + LocalId: 2019a-A1 + Name: Period 1 on Day A + AcademicDay: + RefId: 364f0aa5-49e2-434e-9c82-45770f4c71a9 + LocalId: 2019a-A + Name: Scheule 2019a, Day A + RoomId: TB202 + RoomName: Tower Block, Room 202 + TakeAttendanceFlag: Y + TeacherList: + StaffMember: + - RefId: A8C3A2E3-5B35-9D75-101D-00AA001A0000 + LocalId: SMI1 + Name: Thomas Smith + Role: "1001" + application/xml: + schema: + type: object + properties: + TeachingGroupEvent: + $ref: "#/paths/~1TeachingGroupEvents~1%7BTeachingGroupEventRefId%\ + 7D/put/requestBody/content/application~1json/schema/propert\ + ies/TeachingGroupEvent" + example: >- +The GUID of the TeachingGroupEvent
+ required: true + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + TeachingGroupEvent: + $ref: "#/paths/~1TeachingGroupEvents/get/responses/200/content/\ + application~1json/schema/properties/TeachingGroupEvents/p\ + roperties/TeachingGroupEvent/items" + example: + TeachingGroupEvent: + TeachingGroupEventRefId: 9356909d-e46a-456a-a177-6a914af861ae + TeachingGroupEventLocalId: 20197A-SPN-1 + Provider: + RefId: ab987eeb-cf1d-4e62-aecd-96d942a12828 + Name: Hogwarts High + TeachingGroup: + RefId: 64a309da-063a-2e35-b359-d75101a8c3d1 + LocalId: 20197ASPN + Name: Year 7A Maths - Space and Numbers + Schedule: + RefId: d2f4aea9-564f-4bdf-a18e-42a111a0602c + Name: Scheule 2019a (Term 1) + SchedulePeriod: + RefId: 215f796c-67f7-4855-83dc-28ad9d002830 + LocalId: 2019a-A1 + Name: Period 1 on Day A + AcademicDay: + RefId: 364f0aa5-49e2-434e-9c82-45770f4c71a9 + LocalId: 2019a-A + Name: Scheule 2019a, Day A + RoomId: TB202 + RoomName: Tower Block, Room 202 + TakeAttendanceFlag: Y + TeacherList: + StaffMember: + - RefId: A8C3A2E3-5B35-9D75-101D-00AA001A0000 + LocalId: SMI1 + Name: Thomas Smith + Role: "1001" + application/xml: + schema: + type: object + properties: + TeachingGroupEvent: + $ref: "#/paths/~1TeachingGroupEvents/get/responses/200/content/\ + application~1json/schema/properties/TeachingGroupEvents/p\ + roperties/TeachingGroupEvent/items" + example: >- +The GUID of the TeachingGroupEvent
+ required: true + schema: + type: string + responses: + "200": + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + 200" + default: + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + default" + /ScheduleEvents: + get: + tags: + - ScheduleEvent + summary: Default operation to get a list of all available ScheduleEvents + description: Search the set of available ScheduleEvents, according to the search + criteria in the URL parameters. Returns the first 20 objects located; + with SIF defined navigation headers, indicating how to retrieve + subsequent sets of 20 objects. + parameters: + - name: LocalId + in: path + description: Search for object by LocalId, within the context of the organisation + represented by the ZoneId of the request. + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + ScheduleEvents: + type: object + description: A List of ScheduleEvent objects + properties: + ScheduleEvent: + type: array + items: + required: + - EventDate + - EventName + - Provider + - ScheduleEffect + type: object + properties: + ScheduleEventRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[\ + a-fA-F0-9]{4}-[a-fA-F0-9]{12}" + ScheduleEventLocalId: + description:This is a common element used to define the + locally assigned identifier associated with an + entity.
+ type: string + Provider: + description:A reference to another SIF Data Object
+ type: object + required: + - ObjectType + properties: + RefId: + $ref: "#/paths/~1ScheduleEvents/get/responses/200\ + /content/application~1json/schema/propertie\ + s/ScheduleEvents/properties/ScheduleEvent/i\ + tems/properties/ScheduleEventRefId" + LocalId: + $ref: "#/paths/~1ScheduleEvents/get/responses/200\ + /content/application~1json/schema/propertie\ + s/ScheduleEvents/properties/ScheduleEvent/i\ + tems/properties/ScheduleEventLocalId" + Name: + type: string + description:The normal descriptive name of the + referenced object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject + names, to be included in Object + References
The start date of the event.
+ Duration: + type: integer + description:The duration of the event. If only the + "EventDate" field is populated, the duration is + in days and if omitted defaults to 1 day; if the + "EventDate" and "EventTime" fields are both + populated, the duration is in seconds and if + omitted defaults to 3600 seconds (1 hour).
+ EventTime: + description:The start time for the event, if required.
+ EventName: + type: string + description:The name of the event.
+ Location: + type: string + description:The name of location where the event will + occur.
+ ScheduleEffect: + type: string + title: Schedule Effect + description: >- +Code set denoting the effect a ScheduleEvent + will have on the school's academic schedule. At + present, only full-day events (i.e. the + "EventDate" field is populated but "EventTime" + isn't) can have any effect other than + "noEffect".
This event has no effect on the school + calendar.
+ enum: + - NOEFFECT + - title: Renumber Days + description:This event causes the day rotation on the + school calendar to be renumbered, starting + with any academic days specified in + ScheduleDayList.
If any terms are + included in ScheduleTermList, those terms + are activated effective on the start date of + this event.
+ enum: + - RENUMBER + - title: Insert Day + description:This event causes an insertion into the + normal academic day rotation of the school + calendar.
Any academic days and bell + schedules specified in ScheduleDayList and + BellScheduleList are scheduled for the + duration of this event, or school is + cancelled if ScheduleDayList is omitted.
+After the event ends the academic day + rotation resumes from the point at which it + was interrupted. E.g. if it was Day 1 before + the event, then it will be Day 2 + afterwards.
+ enum: + - INSERT + - title: Displace Day + description:This event causes a displacement in the + normal academic day rotation of the school + calendar.
Any academic days or bell + schedules specified in ScheduleDayList and + BellScheduleList are scheduled for the + duration of this event, or school is + cancelled if ScheduleDayList is omitted.
+After the event ends the rotation resumes + from the point it would be at had the event + not occurred. E.g. if it was Day 1 before + the event, and the event duration was 1 day, + then it will be Day 3 afterwards; Day 2 is + overwritten by the event.
+ enum: + - DISPLACE + - title: End Schedule + description:This event terminates the academic + schedule for any term(s) specified in + ScheduleTermList, which is required when + using this schedule effect.
Used to + terminate the academic day rotation prior to + the end of term; e.g. when the last week of + term is used for impromptu non-academic + activities.
Note that events take + effect at midnight on the start date, so the + designated term(s) do not occur on the + actual day of the endSchedule event (i.e. + the day prior to the event's start date is + the last day the term(s) are in + session).
+ enum: + - ENDSCHEDULE + - title: Pause Schedule + description:Temporarily suspend the academic day + rotation until a subsequent "resumeSchedule" + event occurs.
+ enum: + - PAUSESCHEDULE + - title: Resume Schedule + description:Resume an academic day rotation + previously suspended using + "pauseSchedule".
+ enum: + - RESUMESCHEDULE + - title: Cancel Day + description:Cancel one or more academic days, + specified in ScheduleDayList, that would + normally occur on this date.
This is + generally used to partially cancel the + school schedule on a given calendar date. To + fully cancel school on date, use either the + "insert" or "displace" schedule effect.
+ enum: + - CANCEL + - title: Start Term + description:Start one or more terms, specified in + ScheduleTermList, on this date without + changing the academic day rotation.
A + ScheduleTermList value is required when + using this schedule effect.
+ enum: + - STARTTERM + - title: Additional Day + description:Set one or more additional academic days, + specified in ScheduleDayList to apply to + this calendar date in addition to those + normally applied to the academic day + rotation.
This can also be used to + schedule school on a day on which it would + not normally occur, such as a weekend.
+As a convenience, RemoveScheduleDayList + specifies a set of academic days to be + removed from the calendar while this event + is in effect.
+ enum: + - ADD + - title: Custom Day Schedule + description: This event replaces the normal day rotation + for the event date with a custom set of + SchedulePeriods and bell times. + enum: + - CUSTOM + ScheduleList: + description:List of the schedules within the provider + which the event will affect. If this event is to + affect the school's academic schedule this field + is required, otherwise it is optional.
+ type: object + required: + - Schedule + properties: + Schedule: + type: array + items: + $ref: "#/paths/~1ScheduleEvents/get/responses/2\ + 00/content/application~1json/schema/prope\ + rties/ScheduleEvents/properties/ScheduleE\ + vent/items/properties/Provider" + ScheduleDayList: + description:A list of one or more academic days to be + applied to the school calendar for the duration + of this event.
+ type: object + required: + - ScheduleDay + properties: + ScheduleDay: + type: array + items: + $ref: "#/paths/~1ScheduleEvents/get/responses/2\ + 00/content/application~1json/schema/prope\ + rties/ScheduleEvents/properties/ScheduleE\ + vent/items/properties/Provider" + RemoveScheduleDayList: + description:A list of one or more academic days to be + removed from the school calendar for the + duration of this event. Generally only operates + with a Schedule Effect of "add" or "custom".
+ type: object + required: + - ScheduleDay + properties: + ScheduleDay: + type: array + items: + $ref: "#/paths/~1ScheduleEvents/get/responses/2\ + 00/content/application~1json/schema/prope\ + rties/ScheduleEvents/properties/ScheduleE\ + vent/items/properties/Provider" + BellScheduleList: + description:A list of one or more bell schedules to be + applied to the school calendar for the duration + of this event.
+ type: object + required: + - BellSchedule + properties: + BellSchedule: + type: array + items: + $ref: "#/paths/~1ScheduleEvents/get/responses/2\ + 00/content/application~1json/schema/prope\ + rties/ScheduleEvents/properties/ScheduleE\ + vent/items/properties/Provider" + RemoveBellScheduleList: + description:A list of one or more bell schedules to be + removed from the school calendar for the + duration of this event. Generally only operates + with a Schedule Effect of "add" or "custom".
+ type: object + required: + - BellSchedule + properties: + BellSchedule: + type: array + items: + $ref: "#/paths/~1ScheduleEvents/get/responses/2\ + 00/content/application~1json/schema/prope\ + rties/ScheduleEvents/properties/ScheduleE\ + vent/items/properties/Provider" + ScheduleTermList: + description: "A list of one or more terms to be affected + by this event. WARNING: Terms should only be + specified for events that affect the scheduling + of terms. Setting Terms on other event can have + a disruptive effect on the school schedule.
" + type: object + required: + - ScheduleTerm + properties: + ScheduleTerm: + type: array + items: + $ref: "#/paths/~1ScheduleEvents/get/responses/2\ + 00/content/application~1json/schema/prope\ + rties/ScheduleEvents/properties/ScheduleE\ + vent/items/properties/Provider" + CustomPeriodList: + description:A list of generic object references to a set + of SchedulePeriods, along with their custom + start and end times, which are part of a + 'CUSTOM' ScheduleEvent.
Used in the + creation of "one off" events defined in + ScheduleEvent to have a custom set of + SchedulePeriods, each with custom start and end + times that don't match any particular bell + schedule.
Used for exception days in the + school schedule, such as assembly days or + activity days.
+ type: object + required: + - Period + properties: + Period: + type: array + items: + description:Generic object reference to a single + SchedulePeriod, along with its custom + start and end times, which are part of a + 'CUSTOM' ScheduleEvent.
Used in the + creation of "one off" events defined in + ScheduleEvent to have a custom set of + SchedulePeriods, each with custom start + and end times that don't match any + particular bell schedule.
Used for + exception days in the school schedule, + such as assembly days or activity + days.
+ type: object + required: + - EndTime + - ObjectType + - StartTime + properties: + StartTime: + description:The time the custom schedule period + starts.
+ EndTime: + description:The time the custom schedule period + ends.
+ description:Defines events that may or may not impact the + schedule. These events may simply be for display, or + may affect the schools academic schedule.
+ x-accessControl: + create: + - 1001 + - 2401 + - 2403 + read: + - 1001 + - 2401 + - 2403 + update: + - 1001 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: [] + example: + ScheduleEvents: + ScheduleEvent: + - ScheduleEventRefId: c79e65df-0b11-4a97-9062-9fbd1c1a38e3 + ScheduleEventLocalId: evMarSlip + Provider: + RefId: ab987eeb-cf1d-4e62-aecd-96d942a12828 + Name: Hogwarts High + EventDate: 2019-03-14 + Duration: 1 + EventName: March Floods - School Closed - Slip Schedule + ScheduleEffect: INSERT + ScheduleList: + Schedule: + RefId: d2f4aea9-564f-4bdf-a18e-42a111a0602c + Name: Schedule 2019a (Term 1) + application/xml: + schema: + type: object + properties: + ScheduleEvents: + type: object + description: A List of ScheduleEvent objects + properties: + ScheduleEvent: + type: array + items: + $ref: "#/paths/~1ScheduleEvents/get/responses/200/content\ + /application~1json/schema/properties/ScheduleEvents\ + /properties/ScheduleEvent/items" + example: >- +This is a common element used to define the + locally assigned identifier associated with an + entity.
+ type: string + Student: + description:A reference to another SIF Data Object
+ type: object + required: + - ObjectType + properties: + RefId: + $ref: "#/paths/~1StudentAttendanceSummarys/get/re\ + sponses/200/content/application~1json/schem\ + a/properties/StudentAttendanceSummarys/prop\ + erties/StudentAttendanceSummary/items/prope\ + rties/StudentAttendanceSummaryRefId" + LocalId: + $ref: "#/paths/~1StudentAttendanceSummarys/get/re\ + sponses/200/content/application~1json/schem\ + a/properties/StudentAttendanceSummarys/prop\ + erties/StudentAttendanceSummary/items/prope\ + rties/StudentAttendanceSummaryLocalId" + Name: + type: string + description:The normal descriptive name of the + referenced object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject + names, to be included in Object + References
School year for which the information is + applicable.
+ StartDate: + type: string + format: date + description:Starting date of this attendance reporting + period.
+ EndDate: + type: string + format: date + description:Ending date of this attendance reporting + period.
+ StartDay: + type: integer + description:Number of the school day represented in + StartDate.
+ EndDay: + type: integer + description:Number of the school day represented in + EndDate.
+ FTE: + description:Full time equivalent numeric value of the + student's course load during this attendance + period, expressed in decimal form, where 1.00 + represents a full time enrollment.
+ AttendancePercentageHalfDays: + description:The percentage of half days the student was + present when school was in session between the + StartDate and EndDate, inclusive. Number of + Sessions Present / Total Number of possible + sessions = Percentage, e.g. 294/319 = 92.2%.
+ AttendanceUnjustifiedHalfDays: + description:The percentage of half days the student had + unjustified absences when school was in session + between the StartDate and EndDate, + inclusive.
+ HalfDaysYearPresent: + description:The number of half days the student was + present when school was in session between the + StartDate and EndDate, inclusive.
+ HalfDaysYearAbsent: + description:The number of half days the student was + absent when school was in session between the + StartDate and EndDate, inclusive.
+ HalfDaysYearJustified: + description:The number of half days the student was + absent that were justified when school was in + session between the StartDate and EndDate, + inclusive.
+ HalfDaysYearTotal: + description:The total number of half days.
+ HalfDaysYearIntermittantUnjustified: + description:The number of days the student was absent + from school for an unjustifiable reason when + school was in session between the StartDate and + EndDate, inclusive, and weren't absence for the + complete half-day.
+ HalfDaysYearPercentagePresent: + description:The percentage of half days the student was + present when school was in session between the + StartDate and EndDate, inclusive.
+ HalfDaysYearUnjustified: + description:The number of days the student was absent + from school for an unjustifiable reason when + school was in session between the StartDate and + EndDate, inclusive.
+ description:Provides a summary of a student's daily + attendance and membership information for a given + provider during the time period between the + StartDate and EndDate, inclusive. There will be + multiple instances of this object for a student in a + school over the course of a school year. This + summary may be generated by aggregating more + granular attendance records, in which case all + fields will be read-only; and RefId element may not + be applicable.
+ x-accessControl: + create: [] + read: + - 1001 + - 2401 + - 2403 + update: [] + delete: [] + aggregate: + - 2002 + - 2102 + example: + StudentAttendanceSummarys: + StudentAttendanceSummary: + - StudentAttendanceSummaryRefId: d3476fae-8647-384b-da24-31eda3583211 + Student: + RefId: 7c834ea9-eda1-2090-347f-83297e1c290c + Provider: + RefId: ca285746-359d-7510-1a8c-36432a901a16 + SchoolCalendarYear: 2015 + StartDate: 2014-08-30 + EndDate: 2015-06-10 + StartDay: 1 + EndDay: 180 + FTE: 1 + HalfDaysYearPresent: 178 + HalfDaysYearJustified: 2 + HalfDaysYearTotal: 2 + application/xml: + schema: + type: object + properties: + StudentAttendanceSummarys: + type: object + description: A List of StudentAttendanceSummary objects + properties: + StudentAttendanceSummary: + type: array + items: + $ref: "#/paths/~1StudentAttendanceSummarys/get/responses/\ + 200/content/application~1json/schema/properties/Stu\ + dentAttendanceSummarys/properties/StudentAttendance\ + Summary/items" + example: >- +An ID (GUID) for this summary of attendance information being + reported on. This GUID would be used to form a REST URL.
+ required: true + schema: + type: string + operationId: createStudentAttendanceSummary + requestBody: + description: CRUD operation on StudentAttendanceSummary + content: + application/json: + schema: + type: object + properties: + StudentAttendanceSummary: + $ref: "#/paths/~1StudentAttendanceSummarys/get/responses/200/cont\ + ent/application~1json/schema/properties/StudentAttendanceSu\ + mmarys/properties/StudentAttendanceSummary/items" + example: + StudentAttendanceSummary: + StudentAttendanceSummaryRefId: d3476fae-8647-384b-da24-31eda3583211 + Student: + RefId: 7c834ea9-eda1-2090-347f-83297e1c290c + Provider: + RefId: ca285746-359d-7510-1a8c-36432a901a16 + SchoolCalendarYear: 2015 + StartDate: 2014-08-30 + EndDate: 2015-06-10 + StartDay: 1 + EndDay: 180 + FTE: 1 + HalfDaysYearPresent: 178 + HalfDaysYearJustified: 2 + HalfDaysYearTotal: 2 + application/xml: + schema: + type: object + properties: + StudentAttendanceSummary: + $ref: "#/paths/~1StudentAttendanceSummarys/get/responses/200/cont\ + ent/application~1json/schema/properties/StudentAttendanceSu\ + mmarys/properties/StudentAttendanceSummary/items" + example: >- +An ID (GUID) for this summary of attendance information being + reported on. This GUID would be used to form a REST URL.
+ required: true + schema: + type: string + operationId: updateStudentAttendanceSummary + requestBody: + description: CRUD operation on StudentAttendanceSummary + content: + application/json: + schema: + type: object + properties: + StudentAttendanceSummary: + type: object + properties: + StudentAttendanceSummaryRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-\ + 9]{4}-[a-fA-F0-9]{12}" + StudentAttendanceSummaryLocalId: + description:This is a common element used to define the locally + assigned identifier associated with an entity.
+ type: string + Student: + description:A reference to another SIF Data Object
+ type: object + properties: + RefId: + $ref: "#/paths/~1StudentAttendanceSummarys~1%7BStudentAtt\ + endanceSummaryRefId%7D/put/requestBody/content/appl\ + ication~1json/schema/properties/StudentAttendanceSu\ + mmary/properties/StudentAttendanceSummaryRefId" + LocalId: + $ref: "#/paths/~1StudentAttendanceSummarys~1%7BStudentAtt\ + endanceSummaryRefId%7D/put/requestBody/content/appl\ + ication~1json/schema/properties/StudentAttendanceSu\ + mmary/properties/StudentAttendanceSummaryLocalId" + Name: + type: string + description:The normal descriptive name of the referenced + object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject names, to + be included in Object References
School year for which the information is + applicable.
+ StartDate: + type: string + format: date + description:Starting date of this attendance reporting period.
+ EndDate: + type: string + format: date + description:Ending date of this attendance reporting period.
+ StartDay: + type: integer + description:Number of the school day represented in StartDate.
+ EndDay: + type: integer + description:Number of the school day represented in EndDate.
+ FTE: + description:Full time equivalent numeric value of the student's + course load during this attendance period, expressed in + decimal form, where 1.00 represents a full time + enrollment.
+ AttendancePercentageHalfDays: + description:The percentage of half days the student was present + when school was in session between the StartDate and + EndDate, inclusive. Number of Sessions Present / Total + Number of possible sessions = Percentage, e.g. 294/319 = + 92.2%.
+ AttendanceUnjustifiedHalfDays: + description:The percentage of half days the student had + unjustified absences when school was in session between + the StartDate and EndDate, inclusive.
+ HalfDaysYearPresent: + description:The number of half days the student was present when + school was in session between the StartDate and EndDate, + inclusive.
+ HalfDaysYearAbsent: + description:The number of half days the student was absent when + school was in session between the StartDate and EndDate, + inclusive.
+ HalfDaysYearJustified: + description:The number of half days the student was absent that + were justified when school was in session between the + StartDate and EndDate, inclusive.
+ HalfDaysYearTotal: + description:The total number of half days.
+ HalfDaysYearIntermittantUnjustified: + description:The number of days the student was absent from school + for an unjustifiable reason when school was in session + between the StartDate and EndDate, inclusive, and + weren't absence for the complete half-day.
+ HalfDaysYearPercentagePresent: + description:The percentage of half days the student was present + when school was in session between the StartDate and + EndDate, inclusive.
+ HalfDaysYearUnjustified: + description:The number of days the student was absent from school + for an unjustifiable reason when school was in session + between the StartDate and EndDate, inclusive.
+ description:Provides a summary of a student's daily attendance and + membership information for a given provider during the time + period between the StartDate and EndDate, inclusive. There + will be multiple instances of this object for a student in a + school over the course of a school year. This summary may be + generated by aggregating more granular attendance records, + in which case all fields will be read-only; and RefId + element may not be applicable.
+ x-accessControl: + create: [] + read: + - 1001 + - 2401 + - 2403 + update: [] + delete: [] + aggregate: + - 2002 + - 2102 + example: + StudentAttendanceSummary: + StudentAttendanceSummaryRefId: d3476fae-8647-384b-da24-31eda3583211 + Student: + RefId: 7c834ea9-eda1-2090-347f-83297e1c290c + Provider: + RefId: ca285746-359d-7510-1a8c-36432a901a16 + SchoolCalendarYear: 2015 + StartDate: 2014-08-30 + EndDate: 2015-06-10 + StartDay: 1 + EndDay: 180 + FTE: 1 + HalfDaysYearPresent: 178 + HalfDaysYearJustified: 2 + HalfDaysYearTotal: 2 + application/xml: + schema: + type: object + properties: + StudentAttendanceSummary: + $ref: "#/paths/~1StudentAttendanceSummarys~1%7BStudentAttendanceS\ + ummaryRefId%7D/put/requestBody/content/application~1json/sc\ + hema/properties/StudentAttendanceSummary" + example: >- +An ID (GUID) for this summary of attendance information being + reported on. This GUID would be used to form a REST URL.
+ required: true + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + StudentAttendanceSummary: + $ref: "#/paths/~1StudentAttendanceSummarys/get/responses/200/co\ + ntent/application~1json/schema/properties/StudentAttendan\ + ceSummarys/properties/StudentAttendanceSummary/items" + example: + StudentAttendanceSummary: + StudentAttendanceSummaryRefId: d3476fae-8647-384b-da24-31eda3583211 + Student: + RefId: 7c834ea9-eda1-2090-347f-83297e1c290c + Provider: + RefId: ca285746-359d-7510-1a8c-36432a901a16 + SchoolCalendarYear: 2015 + StartDate: 2014-08-30 + EndDate: 2015-06-10 + StartDay: 1 + EndDay: 180 + FTE: 1 + HalfDaysYearPresent: 178 + HalfDaysYearJustified: 2 + HalfDaysYearTotal: 2 + application/xml: + schema: + type: object + properties: + StudentAttendanceSummary: + $ref: "#/paths/~1StudentAttendanceSummarys/get/responses/200/co\ + ntent/application~1json/schema/properties/StudentAttendan\ + ceSummarys/properties/StudentAttendanceSummary/items" + example: >- +An ID (GUID) for this summary of attendance information being + reported on. This GUID would be used to form a REST URL.
+ required: true + schema: + type: string + responses: + "200": + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + 200" + default: + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + default" + /StudentAttendanceTimeLists: + get: + tags: + - StudentAttendanceTimeList + summary: Default operation to get a list of all available + StudentAttendanceTimeLists + description: Search the set of available StudentAttendanceTimeList records, according + to the search criteria in the URL parameters. Returns the first 20 + objects located; with SIF defined navigation headers, indicating how to + retrieve subsequent sets of 20 objects. + parameters: + - name: LocalId + in: path + description: Search for object by LocalId, within the context of the organisation + represented by the ZoneId of the request. + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + StudentAttendanceTimeLists: + type: object + description: A List of StudentAttendanceTimeList objects + properties: + StudentAttendanceTimeList: + type: array + items: + required: + - Date + - Provider + - Student + type: object + properties: + StudentAttendanceTimeListRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[\ + a-fA-F0-9]{4}-[a-fA-F0-9]{12}" + StudentAttendanceTimeListLocalId: + description:This is a common element used to define the + locally assigned identifier associated with an + entity.
+ type: string + Student: + description:A reference to another SIF Data Object
+ type: object + required: + - ObjectType + properties: + RefId: + $ref: "#/paths/~1StudentAttendanceTimeLists/get/r\ + esponses/200/content/application~1json/sche\ + ma/properties/StudentAttendanceTimeLists/pr\ + operties/StudentAttendanceTimeList/items/pr\ + operties/StudentAttendanceTimeListRefId" + LocalId: + $ref: "#/paths/~1StudentAttendanceTimeLists/get/r\ + esponses/200/content/application~1json/sche\ + ma/properties/StudentAttendanceTimeLists/pr\ + operties/StudentAttendanceTimeList/items/pr\ + operties/StudentAttendanceTimeListLocalId" + Name: + type: string + description:The normal descriptive name of the + referenced object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject + names, to be included in Object + References
The time the student's attendance was + taken.
+ Date: + type: string + format: date + description:The calendar date to which this attendance + reporting period relates.
+ SchoolYear: + description:The year for which the attendance record is + being made.
+ AttendanceTimeList: + description:Breakdown of times that the student was + recorded as being present or absent from school + or class.
+ type: object + required: + - AttendanceTime + properties: + AttendanceTime: + type: array + items: + description:Time span that the student entered or + returned to school
+ type: object + required: + - AttendanceCode + - AttendanceTimeType + - StartTime + properties: + AttendanceType: + type: string + description:Nature of the attendance e.g. + 'Taken at Roll Call'
+ AttendanceCode: + type: string + title: Attendance Code + description: >- +Code denoting presence, absence or + the reason for non-attendance at + school, or class.
Code denoting the status of the + attendance record: Excused, Unexcused, + Unknown, etc.
The start of this particular time + span.
+ EndTime: + description:The end of this particular time + span.
+ DurationValue: + description:The number of minutes the student + was present or absent.
+ AttendanceNote: + type: string + description:Note related to this particular + time span.
+ PeriodAttendanceList: + description:List of any period attendances that need to + be captured as part of a full list of student + attendance types. Reserved for future use with + TimeTableCell, Session or Scheduled Activity. +
+ type: object + required: + - PeriodAttendance + properties: + PeriodAttendance: + type: array + items: + description:This container type allows recording of + period level attendance for a student.
+ type: object + required: + - AttendanceCode + - EndTime + - PeriodAttendanceType + - StartTime + properties: + AttendanceCode: + $ref: "#/paths/~1StudentAttendanceTimeLists\ + /get/responses/200/content/applicatio\ + n~1json/schema/properties/StudentAtte\ + ndanceTimeLists/properties/StudentAtt\ + endanceTimeList/items/properties/Atte\ + ndanceTimeList/properties/AttendanceT\ + ime/items/properties/AttendanceCode" + AttendanceStatus: + $ref: "#/paths/~1StudentAttendanceTimeLists\ + /get/responses/200/content/applicatio\ + n~1json/schema/properties/StudentAtte\ + ndanceTimeLists/properties/StudentAtt\ + endanceTimeList/items/properties/Atte\ + ndanceTimeList/properties/AttendanceT\ + ime/items/properties/AttendanceStatus" + TeachingGroupEvent: + $ref: "#/paths/~1StudentAttendanceTimeLists\ + /get/responses/200/content/applicatio\ + n~1json/schema/properties/StudentAtte\ + ndanceTimeLists/properties/StudentAtt\ + endanceTimeList/items/properties/Stud\ + ent" + StartTime: + description:Optional Start Time of Curriculum + Session
+ EndTime: + description:Optional End Time of Curriculum + Session
+ StudentTimeIn: + description:The time the student entered or + returned to this class.
+ StudentTimeOut: + description:The time the student left this + class.
+ SubjectAreaList: + description:List of learning / subject areas + that apply to the period the + attendance record was taken for.
+ type: object + properties: + SubjectAreaList: + type: array + items: + SubjectArea: + type: string + title: Subject Area + description: >- +Codes denoting Subject + Areas defined by the NZ + Curriculum and Te Marautanga o + Aotearoa.
Codes denoting Subject + Areas defined by the NZQA for + NCEA.
List of teachers
+ type: object + required: + - StaffMember + properties: + StaffMember: + type: array + items: + description:The individual staff member + as a member of the StaffList and + their role.
+ type: object + required: + - ObjectType + - Role + properties: + Role: + type: string + title: Staff Role + description: >- +Describes the role a + staff member has at a + Provider or other + EducationOrganisation.
+List of rooms that apply to the + period the attendance record was taken + for.
+ type: object + required: + - RoomId + properties: + RoomId: + type: array + items: + $ref: "#/paths/~1StudentAttendanceTim\ + eLists/get/responses/200/conten\ + t/application~1json/schema/prop\ + erties/StudentAttendanceTimeLis\ + ts/properties/StudentAttendance\ + TimeList/items/properties/Stude\ + nt" + AttendanceNote: + type: string + description:Note related to this particular + attendance.
+ PeriodName: + type: string + description:The name of the period in this + curriculum session.
+ description: "This object provides more detail about the + attendance spans for a single student during the + day: it provides more detailed information than the + single TimeIn and TimeOut elements in + StudentDailyAttendance.
" + x-accessControl: + create: + - 1001 + - 2401 + - 2403 + read: + - 1001 + - 2401 + - 2403 + update: + - 1001 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: + - 2002 + - 2102 + example: + StudentAttendanceTimeLists: + StudentAttendanceTimeList: + - StudentAttendanceTimeListRefId: 45e9c39e-0e77-40b4-8ce7-6a6fa156249e + Student: + RefId: 7f11e3ed-3ac5-4673-9fdc-bcdbcd971811 + Provider: + RefId: e7c15fb4-48a6-4c11-b66f-fe93520444b6 + Date: 2018-06-26 + SchoolYear: 2018 + AttendanceTimeList: + AttendanceTime: + - AttendanceCode: E + AttendanceStatus: UNE + StartTime: 09:00:00 + EndTime: 10:30:00 + DurationValue: 90 + AttendanceNote: Explained absence, but unjustified, 9:00 to 10:30am + application/xml: + schema: + type: object + properties: + StudentAttendanceTimeLists: + type: object + description: A List of StudentAttendanceTimeList objects + properties: + StudentAttendanceTimeList: + type: array + items: + $ref: "#/paths/~1StudentAttendanceTimeLists/get/responses\ + /200/content/application~1json/schema/properties/St\ + udentAttendanceTimeLists/properties/StudentAttendan\ + ceTimeList/items" + example: >- +This is a common element used to define the locally + assigned identifier associated with an entity.
+ type: string + Student: + description:A reference to another SIF Data Object
+ type: object + properties: + RefId: + $ref: "#/paths/~1StudentAttendanceTimeLists~1%7BStudentAt\ + tendanceTimeListRefId%7D/put/requestBody/content/ap\ + plication~1json/schema/properties/StudentAttendance\ + TimeList/properties/StudentAttendanceTimeListRefId" + LocalId: + $ref: "#/paths/~1StudentAttendanceTimeLists~1%7BStudentAt\ + tendanceTimeListRefId%7D/put/requestBody/content/ap\ + plication~1json/schema/properties/StudentAttendance\ + TimeList/properties/StudentAttendanceTimeListLocalI\ + d" + Name: + type: string + description:The normal descriptive name of the referenced + object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject names, to + be included in Object References
The time the student's attendance was taken.
+ Date: + type: string + format: date + description:The calendar date to which this attendance reporting + period relates.
+ SchoolYear: + description:The year for which the attendance record is being + made.
+ AttendanceTimeList: + description:Breakdown of times that the student was recorded as + being present or absent from school or class.
+ type: object + properties: + AttendanceTime: + type: array + items: + description:Time span that the student entered or returned + to school
+ type: object + properties: + AttendanceType: + type: string + description:Nature of the attendance e.g. 'Taken at + Roll Call'
+ AttendanceCode: + type: string + title: Attendance Code + description: >- +Code denoting presence, absence or the + reason for non-attendance at school, or + class.
Code denoting the status of the attendance + record: Excused, Unexcused, Unknown, etc.
+The start of this particular time span.
+ EndTime: + description:The end of this particular time span.
+ DurationValue: + description:The number of minutes the student was + present or absent.
+ AttendanceNote: + type: string + description:Note related to this particular time + span.
+ PeriodAttendanceList: + description:List of any period attendances that need to be + captured as part of a full list of student attendance + types. Reserved for future use with TimeTableCell, + Session or Scheduled Activity.
+ type: object + properties: + PeriodAttendance: + type: array + items: + description:This container type allows recording of period + level attendance for a student.
+ type: object + properties: + AttendanceCode: + $ref: "#/paths/~1StudentAttendanceTimeLists~1%7BStu\ + dentAttendanceTimeListRefId%7D/put/requestBod\ + y/content/application~1json/schema/properties\ + /StudentAttendanceTimeList/properties/Attenda\ + nceTimeList/properties/AttendanceTime/items/p\ + roperties/AttendanceCode" + AttendanceStatus: + $ref: "#/paths/~1StudentAttendanceTimeLists~1%7BStu\ + dentAttendanceTimeListRefId%7D/put/requestBod\ + y/content/application~1json/schema/properties\ + /StudentAttendanceTimeList/properties/Attenda\ + nceTimeList/properties/AttendanceTime/items/p\ + roperties/AttendanceStatus" + TeachingGroupEvent: + $ref: "#/paths/~1StudentAttendanceTimeLists~1%7BStu\ + dentAttendanceTimeListRefId%7D/put/requestBod\ + y/content/application~1json/schema/properties\ + /StudentAttendanceTimeList/properties/Student" + StartTime: + description:Optional Start Time of Curriculum + Session
+ EndTime: + description:Optional End Time of Curriculum Session
+ StudentTimeIn: + description:The time the student entered or returned to + this class.
+ StudentTimeOut: + description:The time the student left this class.
+ SubjectAreaList: + description:List of learning / subject areas that apply + to the period the attendance record was taken + for.
+ type: object + properties: + SubjectAreaList: + type: array + items: + SubjectArea: + type: string + title: Subject Area + description: >- +Codes denoting Subject Areas + defined by the NZ Curriculum and Te + Marautanga o Aotearoa.
Codes denoting Subject Areas + defined by the NZQA for NCEA.
List of teachers
+ type: object + properties: + StaffMember: + type: array + items: + description:The individual staff member as a + member of the StaffList and their + role.
+ type: object + properties: + Role: + type: string + title: Staff Role + description: >- +Describes the role a staff member + has at a Provider or other + EducationOrganisation.
List of rooms that apply to the period the + attendance record was taken for.
+ type: object + properties: + RoomId: + type: array + items: + $ref: "#/paths/~1StudentAttendanceTimeLists~1\ + %7BStudentAttendanceTimeListRefId%7D/pu\ + t/requestBody/content/application~1json\ + /schema/properties/StudentAttendanceTim\ + eList/properties/Student" + AttendanceNote: + type: string + description:Note related to this particular + attendance.
+ PeriodName: + type: string + description:The name of the period in this curriculum + session.
+ description: "This object provides more detail about the attendance + spans for a single student during the day: it provides more + detailed information than the single TimeIn and TimeOut + elements in StudentDailyAttendance.
" + x-accessControl: + create: + - 1001 + - 2401 + - 2403 + read: + - 1001 + - 2401 + - 2403 + update: + - 1001 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: + - 2002 + - 2102 + example: + StudentAttendanceTimeList: + StudentAttendanceTimeListRefId: 45e9c39e-0e77-40b4-8ce7-6a6fa156249e + Student: + RefId: 7f11e3ed-3ac5-4673-9fdc-bcdbcd971811 + Provider: + RefId: e7c15fb4-48a6-4c11-b66f-fe93520444b6 + Date: 2018-06-26 + SchoolYear: 2018 + AttendanceTimeList: + AttendanceTime: + - AttendanceCode: E + AttendanceStatus: UNE + StartTime: 09:00:00 + EndTime: 10:30:00 + DurationValue: 90 + AttendanceNote: Explained absence, but unjustified, 9:00 to 10:30am + application/xml: + schema: + type: object + properties: + StudentAttendanceTimeList: + $ref: "#/paths/~1StudentAttendanceTimeLists~1%7BStudentAttendance\ + TimeListRefId%7D/put/requestBody/content/application~1json/\ + schema/properties/StudentAttendanceTimeList" + example: >- +This is a common element used to define the + locally assigned identifier associated with an + entity.
+ type: string + Student: + description:A reference to another SIF Data Object
+ type: object + required: + - ObjectType + properties: + RefId: + $ref: "#/paths/~1WellbeingAlerts/get/responses/20\ + 0/content/application~1json/schema/properti\ + es/WellbeingAlerts/properties/WellbeingAler\ + t/items/properties/WellbeingAlertRefId" + LocalId: + $ref: "#/paths/~1WellbeingAlerts/get/responses/20\ + 0/content/application~1json/schema/properti\ + es/WellbeingAlerts/properties/WellbeingAler\ + t/items/properties/WellbeingAlertLocalId" + Name: + type: string + description:The normal descriptive name of the + referenced object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject + names, to be included in Object + References
The calendar date on which this wellbeing + alert was published.
+ StartDate: + type: string + format: date + description:The date the wellbeing alert period + commenced.
+ EndDate: + type: string + format: date + description:The date the wellbeing alert is due to + finish.
+ AlertCategory: + type: string + title: Wellbeing Alert Category + description: >- +Standard codes denoting the category of the + Wellbeing Alert.
Description of this particular wellbeing + alert.
+ AcknowledgementList: + description:Key Contact to get information about this + wellbeing alert from.
+ type: object + required: + - Acknowledgement + properties: + Acknowledgement: + type: array + items: + description:A provider or staff member that has + been sent the alerts and have acknowledged + they have been read.
+ type: object + required: + - Acknowledged + - AcknowledgedDate + properties: + Acknowledged: + type: string + title: Yes Or No Category + description: >- +A reusable code set for yes, no, + unknown and not provided values.
+The date the provider acknowledged + a staff member has viewed the + alerts.
+ Provider: + $ref: "#/paths/~1WellbeingAlerts/get/respon\ + ses/200/content/application~1json/sch\ + ema/properties/WellbeingAlerts/proper\ + ties/WellbeingAlert/items/properties/\ + Student" + StaffMember: + $ref: "#/paths/~1WellbeingAlerts/get/respon\ + ses/200/content/application~1json/sch\ + ema/properties/WellbeingAlerts/proper\ + ties/WellbeingAlert/items/properties/\ + Student" + AlertSeverity: + type: string + description:Severity of this wellbeing alert.
+ KeyContactList: + description:A list of key contacts for the alert.
+ type: object + required: + - KeyContact + properties: + KeyContact: + type: array + items: + description:A key contact for the Wellbeing Alert + and their role, e.g. Parent, Doctor, + Principal.
+ type: object + properties: + Role: + type: string + title: Key Contact Role + description: >- +The role of the key contact in the + Wellbeing Alert.
A list of the Wellbeing Responses that + contributed to the creation of this Wellbeing + Alert.
+ type: object + required: + - WellbeingResponse + properties: + WellbeingResponse: + type: array + items: + $ref: "#/paths/~1WellbeingAlerts/get/responses/\ + 200/content/application~1json/schema/prop\ + erties/WellbeingAlerts/properties/Wellbei\ + ngAlert/items/properties/Student" + WellbeingAppealList: + description:A list of the Wellbeing Appeal outcomes that + contributed to the creation of this Wellbeing + Alert.
+ type: object + required: + - WellbeingAppeal + properties: + WellbeingAppeal: + type: array + items: + $ref: "#/paths/~1WellbeingAlerts/get/responses/\ + 200/content/application~1json/schema/prop\ + erties/WellbeingAlerts/properties/Wellbei\ + ngAlert/items/properties/Student" + WellbeingCharacteristicList: + description:A list of the Wellbeing Characteristics that + contributed to the creation of this Wellbeing + Alert.
+ type: object + required: + - WellbeingCharacteristic + properties: + WellbeingCharacteristic: + type: array + items: + $ref: "#/paths/~1WellbeingAlerts/get/responses/\ + 200/content/application~1json/schema/prop\ + erties/WellbeingAlerts/properties/Wellbei\ + ngAlert/items/properties/Student" + description:Alert indicating to teachers and systems that + this student has a 'concern' that needs to be known + for 'duty of care', which could be Medical, Legal or + other.
The alert may merely draw attention to + Wellbeing Characteristics or Events, that contain + more detail.
+ x-accessControl: + create: + - 1001 + - 1306 + - 2103 + - 2401 + - 2403 + read: + - 1001 + - 1306 + - 2103 + - 2401 + - 2403 + update: + - 1001 + - 1306 + - 2103 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: [] + example: + WellbeingAlerts: + WellbeingAlert: + - WellbeingAlertRefId: 2FFB63B4-CFEF-4820-8501-E7D1E54555CB + Student: + RefId: D3E34B35-9D75-101A-8C3D-00AA001A1652 + Provider: + RefId: CA285746-359D-7510-1A8C-36432A901A16 + StaffMember: + RefId: BA265776-359D-7510-1A8C-77432A901A16 + PublishedDate: 2017-11-01 + StartDate: 2017-11-01 + AlertCategory: MED + AlertDescription: This Student is allergic to peanuts + application/xml: + schema: + type: object + properties: + WellbeingAlerts: + type: object + description: A List of WellbeingAlert objects + properties: + WellbeingAlert: + type: array + items: + $ref: "#/paths/~1WellbeingAlerts/get/responses/200/conten\ + t/application~1json/schema/properties/WellbeingAler\ + ts/properties/WellbeingAlert/items" + example: >- +The ID (GUID) assigned to uniquely identify this + WellbeingAlert.
+ required: true + schema: + type: string + operationId: createWellbeingAlert + requestBody: + description: CRUD operation on WellbeingAlert + content: + application/json: + schema: + type: object + properties: + WellbeingAlert: + $ref: "#/paths/~1WellbeingAlerts/get/responses/200/content/applic\ + ation~1json/schema/properties/WellbeingAlerts/properties/We\ + llbeingAlert/items" + example: + WellbeingAlert: + WellbeingAlertRefId: 2FFB63B4-CFEF-4820-8501-E7D1E54555CB + Student: + RefId: D3E34B35-9D75-101A-8C3D-00AA001A1652 + Provider: + RefId: CA285746-359D-7510-1A8C-36432A901A16 + StaffMember: + RefId: BA265776-359D-7510-1A8C-77432A901A16 + PublishedDate: 2017-11-01 + StartDate: 2017-11-01 + AlertCategory: MED + AlertDescription: This Student is allergic to peanuts + application/xml: + schema: + type: object + properties: + WellbeingAlert: + $ref: "#/paths/~1WellbeingAlerts/get/responses/200/content/applic\ + ation~1json/schema/properties/WellbeingAlerts/properties/We\ + llbeingAlert/items" + example: >- +The ID (GUID) assigned to uniquely identify this + WellbeingAlert.
+ required: true + schema: + type: string + operationId: updateWellbeingAlert + requestBody: + description: CRUD operation on WellbeingAlert + content: + application/json: + schema: + type: object + properties: + WellbeingAlert: + type: object + properties: + WellbeingAlertRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-\ + 9]{4}-[a-fA-F0-9]{12}" + WellbeingAlertLocalId: + description:This is a common element used to define the locally + assigned identifier associated with an entity.
+ type: string + Student: + description:A reference to another SIF Data Object
+ type: object + properties: + RefId: + $ref: "#/paths/~1WellbeingAlerts~1%7BWellbeingAlertRefId%\ + 7D/put/requestBody/content/application~1json/schema\ + /properties/WellbeingAlert/properties/WellbeingAler\ + tRefId" + LocalId: + $ref: "#/paths/~1WellbeingAlerts~1%7BWellbeingAlertRefId%\ + 7D/put/requestBody/content/application~1json/schema\ + /properties/WellbeingAlert/properties/WellbeingAler\ + tLocalId" + Name: + type: string + description:The normal descriptive name of the referenced + object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject names, to + be included in Object References
The calendar date on which this wellbeing alert was + published.
+ StartDate: + type: string + format: date + description:The date the wellbeing alert period commenced.
+ EndDate: + type: string + format: date + description:The date the wellbeing alert is due to finish.
+ AlertCategory: + type: string + title: Wellbeing Alert Category + description: >- +Standard codes denoting the category of the Wellbeing + Alert.
Description of this particular wellbeing alert.
+ AcknowledgementList: + description:Key Contact to get information about this wellbeing + alert from.
+ type: object + properties: + Acknowledgement: + type: array + items: + description:A provider or staff member that has been sent + the alerts and have acknowledged they have been + read.
+ type: object + properties: + Acknowledged: + type: string + title: Yes Or No Category + description: >- +A reusable code set for yes, no, unknown + and not provided values.
The date the provider acknowledged a staff + member has viewed the alerts.
+ Provider: + $ref: "#/paths/~1WellbeingAlerts~1%7BWellbeingAlert\ + RefId%7D/put/requestBody/content/application~\ + 1json/schema/properties/WellbeingAlert/proper\ + ties/Student" + StaffMember: + $ref: "#/paths/~1WellbeingAlerts~1%7BWellbeingAlert\ + RefId%7D/put/requestBody/content/application~\ + 1json/schema/properties/WellbeingAlert/proper\ + ties/Student" + AlertSeverity: + type: string + description:Severity of this wellbeing alert.
+ KeyContactList: + description:A list of key contacts for the alert.
+ type: object + properties: + KeyContact: + type: array + items: + description:A key contact for the Wellbeing Alert and their + role, e.g. Parent, Doctor, Principal.
+ type: object + properties: + Role: + type: string + title: Key Contact Role + description: >- +The role of the key contact in the + Wellbeing Alert.
A list of the Wellbeing Responses that contributed to + the creation of this Wellbeing Alert.
+ type: object + properties: + WellbeingResponse: + type: array + items: + $ref: "#/paths/~1WellbeingAlerts~1%7BWellbeingAlertRefI\ + d%7D/put/requestBody/content/application~1json/sc\ + hema/properties/WellbeingAlert/properties/Student" + WellbeingAppealList: + description:A list of the Wellbeing Appeal outcomes that + contributed to the creation of this Wellbeing Alert.
+ type: object + properties: + WellbeingAppeal: + type: array + items: + $ref: "#/paths/~1WellbeingAlerts~1%7BWellbeingAlertRefI\ + d%7D/put/requestBody/content/application~1json/sc\ + hema/properties/WellbeingAlert/properties/Student" + WellbeingCharacteristicList: + description:A list of the Wellbeing Characteristics that + contributed to the creation of this Wellbeing Alert.
+ type: object + properties: + WellbeingCharacteristic: + type: array + items: + $ref: "#/paths/~1WellbeingAlerts~1%7BWellbeingAlertRefI\ + d%7D/put/requestBody/content/application~1json/sc\ + hema/properties/WellbeingAlert/properties/Student" + description:Alert indicating to teachers and systems that this + student has a 'concern' that needs to be known for 'duty of + care', which could be Medical, Legal or other.
The + alert may merely draw attention to Wellbeing Characteristics + or Events, that contain more detail.
+ x-accessControl: + create: + - 1001 + - 1306 + - 2103 + - 2401 + - 2403 + read: + - 1001 + - 1306 + - 2103 + - 2401 + - 2403 + update: + - 1001 + - 1306 + - 2103 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: [] + example: + WellbeingAlert: + WellbeingAlertRefId: 2FFB63B4-CFEF-4820-8501-E7D1E54555CB + Student: + RefId: D3E34B35-9D75-101A-8C3D-00AA001A1652 + Provider: + RefId: CA285746-359D-7510-1A8C-36432A901A16 + StaffMember: + RefId: BA265776-359D-7510-1A8C-77432A901A16 + PublishedDate: 2017-11-01 + StartDate: 2017-11-01 + AlertCategory: MED + AlertDescription: This Student is allergic to peanuts + application/xml: + schema: + type: object + properties: + WellbeingAlert: + $ref: "#/paths/~1WellbeingAlerts~1%7BWellbeingAlertRefId%7D/put/r\ + equestBody/content/application~1json/schema/properties/Well\ + beingAlert" + example: >- +The ID (GUID) assigned to uniquely identify this + WellbeingAlert.
+ required: true + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + WellbeingAlert: + $ref: "#/paths/~1WellbeingAlerts/get/responses/200/content/appl\ + ication~1json/schema/properties/WellbeingAlerts/propertie\ + s/WellbeingAlert/items" + example: + WellbeingAlert: + WellbeingAlertRefId: 2FFB63B4-CFEF-4820-8501-E7D1E54555CB + Student: + RefId: D3E34B35-9D75-101A-8C3D-00AA001A1652 + Provider: + RefId: CA285746-359D-7510-1A8C-36432A901A16 + StaffMember: + RefId: BA265776-359D-7510-1A8C-77432A901A16 + PublishedDate: 2017-11-01 + StartDate: 2017-11-01 + AlertCategory: MED + AlertDescription: This Student is allergic to peanuts + application/xml: + schema: + type: object + properties: + WellbeingAlert: + $ref: "#/paths/~1WellbeingAlerts/get/responses/200/content/appl\ + ication~1json/schema/properties/WellbeingAlerts/propertie\ + s/WellbeingAlert/items" + example: >- +The ID (GUID) assigned to uniquely identify this + WellbeingAlert.
+ required: true + schema: + type: string + responses: + "200": + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + 200" + default: + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + default" + /WellbeingCharacteristics: + get: + tags: + - WellbeingCharacteristic + summary: Default operation to get a list of all available WellbeingCharacteristics + description: Search the set of available WellbeingCharacteristics, according to the + search criteria in the URL parameters. Returns the first 20 objects + located; with SIF defined navigation headers, indicating how to retrieve + subsequent sets of 20 objects. + parameters: + - name: LocalId + in: path + description: Search for object by LocalId, within the context of the organisation + represented by the ZoneId of the request. + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + WellbeingCharacteristics: + type: object + description: A List of WellbeingCharacteristic objects + properties: + WellbeingCharacteristic: + type: array + items: + required: + - RecordingProvider + - Student + type: object + properties: + WellbeingCharacteristicRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[\ + a-fA-F0-9]{4}-[a-fA-F0-9]{12}" + WellbeingCharacteristicLocalId: + description:This is a common element used to define the + locally assigned identifier associated with an + entity.
+ type: string + Student: + description:A reference to another SIF Data Object
+ type: object + required: + - ObjectType + properties: + RefId: + $ref: "#/paths/~1WellbeingCharacteristics/get/res\ + ponses/200/content/application~1json/schema\ + /properties/WellbeingCharacteristics/proper\ + ties/WellbeingCharacteristic/items/properti\ + es/WellbeingCharacteristicRefId" + LocalId: + $ref: "#/paths/~1WellbeingCharacteristics/get/res\ + ponses/200/content/application~1json/schema\ + /properties/WellbeingCharacteristics/proper\ + ties/WellbeingCharacteristic/items/properti\ + es/WellbeingCharacteristicLocalId" + Name: + type: string + description:The normal descriptive name of the + referenced object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject + names, to be included in Object + References
The date the characteristic was first created + for the student in the source system.
+ LastUpdatedBy: + $ref: "#/paths/~1WellbeingCharacteristics/get/respons\ + es/200/content/application~1json/schema/propert\ + ies/WellbeingCharacteristics/properties/Wellbei\ + ngCharacteristic/items/properties/Student" + LastUpdatedDate: + type: string + format: date + description:The date the characteristic was last updated + in the source system.
+ CharacteristicClassification: + type: string + title: Wellbeing Characteristic Class + description: >- +Standard codes denoting the first level + category of the Wellbeing Characteristic. (Note: + The second and third levels are Category and + SubCategory)
Starting Date for this Characteristic to be + noted.
+ EndDate: + type: string + format: date + description:End date for this Characteristic to be noted, + if there is one.
+ ReviewDate: + type: string + format: date + description:Date at which this information should be + reviewed.
+ CharacteristicNotes: + type: string + description:Text relating to the particular + WellbeingCharacteristic.
+ CharacteristicCategory: + description:Category of WellbeingCharacteristic.
+ CharacteristicSubCategory: + description:Sub category of the + WellbeingCharacteristic.
+ CharacteristicSeverity: + type: string + description:The severity of the wellbeing + characteristic
+ CharacteristicPriority: + type: string + title: Wellbeing Characteristic Priority + description: >- +Codes denoting the priority level of the + characteristic in relation to other + characteristics within the same + classification.
A reusable code set for yes, no, unknown and + not provided values.
A list of the medications required for this + Wellbeing Characteristic.
+ type: object + required: + - Medication + properties: + Medication: + type: array + items: + description:The medication, dosage and frequency, + required by the student to manage the + Wellbeing Characteristic.
+ type: object + properties: + MedicationName: + type: string + description:Name of medication required for the + student.
+ Dosage: + type: string + description:Dosage and strength of medication + required for the student.
+ Frequency: + type: string + description:Frequency of Administration.
+ AdministrationInformation: + type: string + description:Information about how the + medication is to be administered.
+ Method: + type: string + description:Method of administration.
+ MedicationConsentList: + description:A list consents that have been + provided for administration of a + medicine to a student.
+ type: object + required: + - MedicationConsent + properties: + MedicationConsent: + type: array + items: + description:Contains information about + when, by whom, and who consent + was given to for the + administration of a medicine to + a student.
+ type: object + required: + - ConsentedBy + - StartDate + properties: + StartDate: + type: string + format: date + description:The date from which the + student or student caretaker + consented to the medicine + being administered to the + student by a particular + individual.
+ EndDate: + type: string + format: date + description:The date the consent for + administration of the + medicine ends or is + revoked.
+ ConsentedBy: + $ref: "#/paths/~1WellbeingCharact\ + eristics/get/responses/200/\ + content/application~1json/s\ + chema/properties/WellbeingC\ + haracteristics/properties/W\ + ellbeingCharacteristic/item\ + s/properties/Student" + ProviderApplicableTo: + $ref: "#/paths/~1WellbeingCharact\ + eristics/get/responses/200/\ + content/application~1json/s\ + chema/properties/WellbeingC\ + haracteristics/properties/W\ + ellbeingCharacteristic/item\ + s/properties/Student" + AdministeredBy: + $ref: "#/paths/~1WellbeingCharact\ + eristics/get/responses/200/\ + content/application~1json/s\ + chema/properties/WellbeingC\ + haracteristics/properties/W\ + ellbeingCharacteristic/item\ + s/properties/Student" + DocumentList: + description:Describes the Location of any associated + documents kept in relation to this + Characteristic.
+ type: object + required: + - Document + properties: + Document: + type: array + items: + $ref: "#/paths/~1WellbeingCharacteristics/get/r\ + esponses/200/content/application~1json/sc\ + hema/properties/WellbeingCharacteristics/\ + properties/WellbeingCharacteristic/items/\ + properties/Student" + WellbeingEventList: + description:A list of any Wellbeing Events that have + arisen as a result of this Characteristic.
+ type: object + required: + - WellbeingEvent + properties: + WellbeingEvent: + type: array + items: + $ref: "#/paths/~1WellbeingCharacteristics/get/r\ + esponses/200/content/application~1json/sc\ + hema/properties/WellbeingCharacteristics/\ + properties/WellbeingCharacteristic/items/\ + properties/Student" + WellbeingAlertList: + description:A list of any Wellbeing Alerts that have + arison as a result of this Chracteristic.
+ type: object + required: + - WellbeingAlert + properties: + WellbeingAlert: + type: array + items: + $ref: "#/paths/~1WellbeingCharacteristics/get/r\ + esponses/200/content/application~1json/sc\ + hema/properties/WellbeingCharacteristics/\ + properties/WellbeingCharacteristic/items/\ + properties/Student" + SpecialAssessmentConditionList: + description:A list of the special assessment conditions + that a student is entitled to have when sitting + an assessment.
+ type: object + required: + - SpecialAssessmentCondition + properties: + SpecialAssessmentCondition: + type: array + items: + type: string + title: Special Assessment Condition + description: >- +Standard codes denoting special + assessment conditions that a student + requires when sitting an assessment.
+Code set denoting the status of the Wellbeing + Characteristic.
A list of the consents given by the stiudent + or their caregiver in relation to this Wellbeing + Characteristic.
+ type: object + required: + - StudentConsent + properties: + StudentConsent: + type: array + items: + $ref: "#/paths/~1WellbeingCharacteristics/get/r\ + esponses/200/content/application~1json/sc\ + hema/properties/WellbeingCharacteristics/\ + properties/WellbeingCharacteristic/items/\ + properties/Student" + TeWharikiDomainList: + description:A list of the Te Whāriki Domains that are + relevant to this Wellbeing Characteristic. Only + used for Early Childhood Education.
+ type: object + required: + - TeWharikiDomain + properties: + TeWharikiDomain: + type: array + items: + type: string + title: Learning Support Te Whariki Domain + description: >- +Code set denoting the Te Whariki Domain + an Early Childhood Education related + intervention is part of.
A list of the expected learning support + outcome for the Wellbeing Characteristic. Only + used for Schools.
+ type: object + required: + - LearningSupportOutcome + properties: + LearningSupportOutcome: + type: array + items: + type: string + title: Learning Support Outcome + description: >- +Code set denoting the outcome for the + student that the intervention is seeking + to achieve for an area of need. Only + applies to Compulsive Schooling.
Core Wellbeing Characteristic that is integral to + the Student. This may be a Medical condition, + special needs or a characteristic such as a known + disability or any other characteristic or condition + that is student specific and impacts their + learning.
+ x-accessControl: + create: + - 1001 + - 1306 + - 2103 + - 2401 + - 2403 + read: + - 1001 + - 1306 + - 2101 + - 2103 + - 2401 + - 2403 + update: + - 1001 + - 1306 + - 2103 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: + - 2002 + - 2102 + example: + WellbeingCharacteristics: + WellbeingCharacteristic: + - WellbeingCharacteristicRefId: 2FFB63B4-CFEF-4820-8501-E7D1E54555CB + Student: + RefId: D3E34B35-9D75-101A-8C3D-00AA001A1652 + RecordingProvider: + RefId: CA285746-359D-7510-1A8C-36432A901A16 + StartDate: 2017-11-01 + EndDate: 2017-11-10 + CharacteristicNotes: This Student has a special need. + CharacteristicCategory: S + application/xml: + schema: + type: object + properties: + WellbeingCharacteristics: + type: object + description: A List of WellbeingCharacteristic objects + properties: + WellbeingCharacteristic: + type: array + items: + $ref: "#/paths/~1WellbeingCharacteristics/get/responses/2\ + 00/content/application~1json/schema/properties/Well\ + beingCharacteristics/properties/WellbeingCharacteri\ + stic/items" + example: >- +The ID (GUID) assigned to uniquely identify this + WellbeingCharacteristic.
+ required: true + schema: + type: string + operationId: createWellbeingCharacteristic + requestBody: + description: CRUD operation on WellbeingCharacteristic + content: + application/json: + schema: + type: object + properties: + WellbeingCharacteristic: + $ref: "#/paths/~1WellbeingCharacteristics/get/responses/200/conte\ + nt/application~1json/schema/properties/WellbeingCharacteris\ + tics/properties/WellbeingCharacteristic/items" + example: + WellbeingCharacteristic: + WellbeingCharacteristicRefId: 2FFB63B4-CFEF-4820-8501-E7D1E54555CB + Student: + RefId: D3E34B35-9D75-101A-8C3D-00AA001A1652 + RecordingProvider: + RefId: CA285746-359D-7510-1A8C-36432A901A16 + StartDate: 2017-11-01 + EndDate: 2017-11-10 + CharacteristicNotes: This Student has a special need. + CharacteristicCategory: S + application/xml: + schema: + type: object + properties: + WellbeingCharacteristic: + $ref: "#/paths/~1WellbeingCharacteristics/get/responses/200/conte\ + nt/application~1json/schema/properties/WellbeingCharacteris\ + tics/properties/WellbeingCharacteristic/items" + example: >- +The ID (GUID) assigned to uniquely identify this + WellbeingCharacteristic.
+ required: true + schema: + type: string + operationId: updateWellbeingCharacteristic + requestBody: + description: CRUD operation on WellbeingCharacteristic + content: + application/json: + schema: + type: object + properties: + WellbeingCharacteristic: + type: object + properties: + WellbeingCharacteristicRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-\ + 9]{4}-[a-fA-F0-9]{12}" + WellbeingCharacteristicLocalId: + description:This is a common element used to define the locally + assigned identifier associated with an entity.
+ type: string + Student: + description:A reference to another SIF Data Object
+ type: object + properties: + RefId: + $ref: "#/paths/~1WellbeingCharacteristics~1%7BWellbeingCh\ + aracteristicRefId%7D/put/requestBody/content/applic\ + ation~1json/schema/properties/WellbeingCharacterist\ + ic/properties/WellbeingCharacteristicRefId" + LocalId: + $ref: "#/paths/~1WellbeingCharacteristics~1%7BWellbeingCh\ + aracteristicRefId%7D/put/requestBody/content/applic\ + ation~1json/schema/properties/WellbeingCharacterist\ + ic/properties/WellbeingCharacteristicLocalId" + Name: + type: string + description:The normal descriptive name of the referenced + object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject names, to + be included in Object References
The date the characteristic was first created for the + student in the source system.
+ LastUpdatedBy: + $ref: "#/paths/~1WellbeingCharacteristics~1%7BWellbeingCharac\ + teristicRefId%7D/put/requestBody/content/application~1j\ + son/schema/properties/WellbeingCharacteristic/propertie\ + s/Student" + LastUpdatedDate: + type: string + format: date + description:The date the characteristic was last updated in the + source system.
+ CharacteristicClassification: + type: string + title: Wellbeing Characteristic Class + description: >- +Standard codes denoting the first level category of + the Wellbeing Characteristic. (Note: The second and + third levels are Category and SubCategory)
Starting Date for this Characteristic to be noted.
+ EndDate: + type: string + format: date + description:End date for this Characteristic to be noted, if + there is one.
+ ReviewDate: + type: string + format: date + description:Date at which this information should be reviewed.
+ CharacteristicNotes: + type: string + description:Text relating to the particular + WellbeingCharacteristic.
+ CharacteristicCategory: + description:Category of WellbeingCharacteristic.
+ CharacteristicSubCategory: + description:Sub category of the WellbeingCharacteristic.
+ CharacteristicSeverity: + type: string + description:The severity of the wellbeing characteristic
+ CharacteristicPriority: + type: string + title: Wellbeing Characteristic Priority + description: >- +Codes denoting the priority level of the + characteristic in relation to other characteristics + within the same classification.
A reusable code set for yes, no, unknown and not + provided values.
A list of the medications required for this Wellbeing + Characteristic.
+ type: object + properties: + Medication: + type: array + items: + description:The medication, dosage and frequency, required + by the student to manage the Wellbeing + Characteristic.
+ type: object + properties: + MedicationName: + type: string + description:Name of medication required for the + student.
+ Dosage: + type: string + description:Dosage and strength of medication required + for the student.
+ Frequency: + type: string + description:Frequency of Administration.
+ AdministrationInformation: + type: string + description:Information about how the medication is to + be administered.
+ Method: + type: string + description:Method of administration.
+ MedicationConsentList: + description:A list consents that have been provided for + administration of a medicine to a student.
+ type: object + properties: + MedicationConsent: + type: array + items: + description:Contains information about when, by + whom, and who consent was given to for + the administration of a medicine to a + student.
+ type: object + properties: + StartDate: + type: string + format: date + description:The date from which the student + or student caretaker consented to + the medicine being administered to + the student by a particular + individual.
+ EndDate: + type: string + format: date + description:The date the consent for + administration of the medicine ends + or is revoked.
+ ConsentedBy: + $ref: "#/paths/~1WellbeingCharacteristics\ + ~1%7BWellbeingCharacteristicRefId%7\ + D/put/requestBody/content/applicati\ + on~1json/schema/properties/Wellbein\ + gCharacteristic/properties/Student" + ProviderApplicableTo: + $ref: "#/paths/~1WellbeingCharacteristics\ + ~1%7BWellbeingCharacteristicRefId%7\ + D/put/requestBody/content/applicati\ + on~1json/schema/properties/Wellbein\ + gCharacteristic/properties/Student" + AdministeredBy: + $ref: "#/paths/~1WellbeingCharacteristics\ + ~1%7BWellbeingCharacteristicRefId%7\ + D/put/requestBody/content/applicati\ + on~1json/schema/properties/Wellbein\ + gCharacteristic/properties/Student" + DocumentList: + description:Describes the Location of any associated documents + kept in relation to this Characteristic.
+ type: object + properties: + Document: + type: array + items: + $ref: "#/paths/~1WellbeingCharacteristics~1%7BWellbeing\ + CharacteristicRefId%7D/put/requestBody/content/ap\ + plication~1json/schema/properties/WellbeingCharac\ + teristic/properties/Student" + WellbeingEventList: + description:A list of any Wellbeing Events that have arisen as a + result of this Characteristic.
+ type: object + properties: + WellbeingEvent: + type: array + items: + $ref: "#/paths/~1WellbeingCharacteristics~1%7BWellbeing\ + CharacteristicRefId%7D/put/requestBody/content/ap\ + plication~1json/schema/properties/WellbeingCharac\ + teristic/properties/Student" + WellbeingAlertList: + description:A list of any Wellbeing Alerts that have arison as a + result of this Chracteristic.
+ type: object + properties: + WellbeingAlert: + type: array + items: + $ref: "#/paths/~1WellbeingCharacteristics~1%7BWellbeing\ + CharacteristicRefId%7D/put/requestBody/content/ap\ + plication~1json/schema/properties/WellbeingCharac\ + teristic/properties/Student" + SpecialAssessmentConditionList: + description:A list of the special assessment conditions that a + student is entitled to have when sitting an + assessment.
+ type: object + properties: + SpecialAssessmentCondition: + type: array + items: + type: string + title: Special Assessment Condition + description: >- +Standard codes denoting special assessment + conditions that a student requires when sitting an + assessment.
Code set denoting the status of the Wellbeing + Characteristic.
A list of the consents given by the stiudent or their + caregiver in relation to this Wellbeing + Characteristic.
+ type: object + properties: + StudentConsent: + type: array + items: + $ref: "#/paths/~1WellbeingCharacteristics~1%7BWellbeing\ + CharacteristicRefId%7D/put/requestBody/content/ap\ + plication~1json/schema/properties/WellbeingCharac\ + teristic/properties/Student" + TeWharikiDomainList: + description:A list of the Te Whāriki Domains that are relevant to + this Wellbeing Characteristic. Only used for Early + Childhood Education.
+ type: object + properties: + TeWharikiDomain: + type: array + items: + type: string + title: Learning Support Te Whariki Domain + description: >- +Code set denoting the Te Whariki Domain an + Early Childhood Education related intervention is + part of.
A list of the expected learning support outcome for + the Wellbeing Characteristic. Only used for Schools. +
+ type: object + properties: + LearningSupportOutcome: + type: array + items: + type: string + title: Learning Support Outcome + description: >- +Code set denoting the outcome for the student + that the intervention is seeking to achieve for an + area of need. Only applies to Compulsive + Schooling.
Core Wellbeing Characteristic that is integral to the + Student. This may be a Medical condition, special needs or a + characteristic such as a known disability or any other + characteristic or condition that is student specific and + impacts their learning.
+ x-accessControl: + create: + - 1001 + - 1306 + - 2103 + - 2401 + - 2403 + read: + - 1001 + - 1306 + - 2101 + - 2103 + - 2401 + - 2403 + update: + - 1001 + - 1306 + - 2103 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: + - 2002 + - 2102 + example: + WellbeingCharacteristic: + WellbeingCharacteristicRefId: 2FFB63B4-CFEF-4820-8501-E7D1E54555CB + Student: + RefId: D3E34B35-9D75-101A-8C3D-00AA001A1652 + RecordingProvider: + RefId: CA285746-359D-7510-1A8C-36432A901A16 + StartDate: 2017-11-01 + EndDate: 2017-11-10 + CharacteristicNotes: This Student has a special need. + CharacteristicCategory: S + application/xml: + schema: + type: object + properties: + WellbeingCharacteristic: + $ref: "#/paths/~1WellbeingCharacteristics~1%7BWellbeingCharacteri\ + sticRefId%7D/put/requestBody/content/application~1json/sche\ + ma/properties/WellbeingCharacteristic" + example: >- +The ID (GUID) assigned to uniquely identify this + WellbeingCharacteristic.
+ required: true + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + WellbeingCharacteristic: + $ref: "#/paths/~1WellbeingCharacteristics/get/responses/200/con\ + tent/application~1json/schema/properties/WellbeingCharact\ + eristics/properties/WellbeingCharacteristic/items" + example: + WellbeingCharacteristic: + WellbeingCharacteristicRefId: 2FFB63B4-CFEF-4820-8501-E7D1E54555CB + Student: + RefId: D3E34B35-9D75-101A-8C3D-00AA001A1652 + RecordingProvider: + RefId: CA285746-359D-7510-1A8C-36432A901A16 + StartDate: 2017-11-01 + EndDate: 2017-11-10 + CharacteristicNotes: This Student has a special need. + CharacteristicCategory: S + application/xml: + schema: + type: object + properties: + WellbeingCharacteristic: + $ref: "#/paths/~1WellbeingCharacteristics/get/responses/200/con\ + tent/application~1json/schema/properties/WellbeingCharact\ + eristics/properties/WellbeingCharacteristic/items" + example: >- +The ID (GUID) assigned to uniquely identify this + WellbeingCharacteristic.
+ required: true + schema: + type: string + responses: + "200": + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + 200" + default: + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + default" + /WellbeingEvents: + get: + tags: + - WellbeingEvent + summary: Default operation to get a list of all available WellbeingEvents + description: Search the set of available WellbeingEvents, according to the search + criteria in the URL parameters. Returns the first 20 objects located; + with SIF defined navigation headers, indicating how to retrieve + subsequent sets of 20 objects. + parameters: + - name: LocalId + in: path + description: Search for object by LocalId, within the context of the organisation + represented by the ZoneId of the request. + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + WellbeingEvents: + type: object + description: A List of WellbeingEvent objects + properties: + WellbeingEvent: + type: array + items: + required: + - ReportingProvider + - Student + type: object + properties: + WellbeingEventRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[\ + a-fA-F0-9]{4}-[a-fA-F0-9]{12}" + WellbeingEventLocalId: + description:This is a common element used to define the + locally assigned identifier associated with an + entity.
+ type: string + Student: + description:A reference to another SIF Data Object
+ type: object + required: + - ObjectType + properties: + RefId: + $ref: "#/paths/~1WellbeingEvents/get/responses/20\ + 0/content/application~1json/schema/properti\ + es/WellbeingEvents/properties/WellbeingEven\ + t/items/properties/WellbeingEventRefId" + LocalId: + $ref: "#/paths/~1WellbeingEvents/get/responses/20\ + 0/content/application~1json/schema/properti\ + es/WellbeingEvents/properties/WellbeingEven\ + t/items/properties/WellbeingEventLocalId" + Name: + type: string + description:The normal descriptive name of the + referenced object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject + names, to be included in Object + References
Text relating to the particular + WellbeingEvent.
+ PossibleMotivationList: + description:A list of the possible motivations that + triggered the event.
+ type: object + required: + - PossibleMotivation + properties: + PossibleMotivation: + type: array + items: + type: string + title: Wellbeing Event Possible Motivation + description: >- +Code set denoting the possible + motivation that triggered the Wellbeing + Event.
Standard codes denoting the first level + category of the Wellbeing Event. (Note: The + second and third levels are Category and + SubCategory)
List of Categories of WellbeingEvent.
+ type: object + required: + - EventCategory + properties: + EventCategory: + type: array + items: + description: + type: object + required: + - Category + properties: + Category: + type: string + title: Wellbeing Event Category + description: >- +Standard codes denoting the second + level category of the Wellbeing Event. + (Note: The first and third levels are + CategoryClass and SubCategory)
+List of Categories of the + WellbeingEvent.
+ type: object + required: + - EventSubCategory + properties: + EventSubCategory: + type: array + items: + description: + type: object + required: + - SubCategory + properties: + SubCategory: + type: string + title: Wellbeing Event Sub Category + description: >- +Standard codes denoting + the third level category of + the Wellbeing Event. (Note: + The first and second levels + are CategoryClass and + Category)
Code set denoting the severity of the + Wellbeing Event.
A list of the locations where the incident + took place.
+ type: object + required: + - Location + properties: + Location: + type: array + items: + type: string + title: Wellbeing Event Location + description: >- +Code set denoting locations where a + Wellbeing Event incident may have took + place.
Details of Event Location.
+ EventCreationTimeStamp: + description:Date and time of the WellbeingEvent record + creation.
+ EventDate: + type: string + format: date + description:The calendar date on which this + WellbeingEvent occured.
+ EventTime: + description:The time when WellbeingEvent occured.
+ EventDescription: + type: string + description:A description of the WellbeingEvent.
+ EventTimePeriod: + type: string + title: Wellbeing Event Time Period + description: >- +Standard codes denoting the time period of + the Wellbeing Event.
A reusable code set for yes, no, unknown and + not provided values.
List of People involved in the Wellbeing + event. Mandatory if more people than the student + to which this event occurs is involved.
+ type: object + required: + - PersonInvolvement + properties: + PersonInvolvement: + type: array + items: + description:A repeatable element recording the + identifier and details of another person + that was involved in the Wellbeing + Event/Response.
+ type: object + required: + - ObjectType + properties: + HowInvolved: + type: string + description:Optional free text detailing + involvement.
+ PersonType: + type: string + title: Person Involved Type + description: >- +Code set denoting the type of + person that was involved.
Standard codes denoting the status of the + Wellbeing Response.
A list of the problem behaviours identified + for the student as a result of the Wellbeing + Event. There are both minor and major + behaviours.
+ type: object + properties: + BehaviourIdentifiedList: + type: object + properties: + MinorBehaviour: + type: array + items: + - type: string + title: Wellbeing Event Minor Behaviour + description: >- +Code set denoting the type of + minor behaviour problem identified + as part of the Wellbeing Event.
+Code set denoting the type of + major behaviour problem identified + as part of the Wellbeing Event.
+Codes denoting the type of restraint used on + a student during a Wellbeing Event.
A list of the actions taken as a result of + this WellbeingEvent.
+ type: object + required: + - ActionTaken + properties: + ActionTaken: + type: array + items: + type: string + title: Wellbeing Event Action Taken + description: >- +Code set denoting the actions that can + be taken as a result of the Wellbeing + event.
Describes the Location of any associated + documents kept in relation to this Response.
+ type: object + required: + - Document + properties: + Document: + type: array + items: + $ref: "#/paths/~1WellbeingEvents/get/responses/\ + 200/content/application~1json/schema/prop\ + erties/WellbeingEvents/properties/Wellbei\ + ngEvent/items/properties/Student" + RelatedWellbeingEventList: + description:A Wellbeing Event gets created for every + student involved in an event. This list links + together all related Wellbeing Events.
+ type: object + required: + - RelatedWellbeingEvent + properties: + RelatedWellbeingEvent: + type: array + items: + $ref: "#/paths/~1WellbeingEvents/get/responses/\ + 200/content/application~1json/schema/prop\ + erties/WellbeingEvents/properties/Wellbei\ + ngEvent/items/properties/Student" + description:Record of an event happening that impacts on a + school's duty of care to its students. The event + records both 'positive' and 'negative' behaviours + and is not just the recording of a discipline + incident or an accident.
+ x-accessControl: + create: + - 1001 + - 2401 + - 2403 + read: + - 1001 + - 2401 + - 2403 + update: + - 1001 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: [] + example: + WellbeingEvents: + WellbeingEvent: + - WellbeingEventRefId: 2FFB63B4-CFEF-4820-8501-E7D1E54555CB + Student: + RefId: D3E34B35-9D75-101A-8C3D-00AA001A1652 + ReportingProvider: + RefId: CA285746-359D-7510-1A8C-36432A901A16 + EventCategoryClass: POS + EventDate: 2017-11-01 + EventTimePeriod: AM + RestraintType: NON + ActionTakenList: + ActionTaken: ININ + application/xml: + schema: + type: object + properties: + WellbeingEvents: + type: object + description: A List of WellbeingEvent objects + properties: + WellbeingEvent: + type: array + items: + $ref: "#/paths/~1WellbeingEvents/get/responses/200/conten\ + t/application~1json/schema/properties/WellbeingEven\ + ts/properties/WellbeingEvent/items" + example: >- +The ID (GUID) assigned to uniquely identify this + WellbeingEvent.
+ required: true + schema: + type: string + operationId: createWellbeingEvent + requestBody: + description: CRUD operation on WellbeingEvent + content: + application/json: + schema: + type: object + properties: + WellbeingEvent: + $ref: "#/paths/~1WellbeingEvents/get/responses/200/content/applic\ + ation~1json/schema/properties/WellbeingEvents/properties/We\ + llbeingEvent/items" + example: + WellbeingEvent: + WellbeingEventRefId: 2FFB63B4-CFEF-4820-8501-E7D1E54555CB + Student: + RefId: D3E34B35-9D75-101A-8C3D-00AA001A1652 + ReportingProvider: + RefId: CA285746-359D-7510-1A8C-36432A901A16 + EventCategoryClass: POS + EventDate: 2017-11-01 + EventTimePeriod: AM + RestraintType: NON + ActionTakenList: + ActionTaken: ININ + application/xml: + schema: + type: object + properties: + WellbeingEvent: + $ref: "#/paths/~1WellbeingEvents/get/responses/200/content/applic\ + ation~1json/schema/properties/WellbeingEvents/properties/We\ + llbeingEvent/items" + example: >- +The ID (GUID) assigned to uniquely identify this + WellbeingEvent.
+ required: true + schema: + type: string + operationId: updateWellbeingEvent + requestBody: + description: CRUD operation on WellbeingEvent + content: + application/json: + schema: + type: object + properties: + WellbeingEvent: + type: object + properties: + WellbeingEventRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-\ + 9]{4}-[a-fA-F0-9]{12}" + WellbeingEventLocalId: + description:This is a common element used to define the locally + assigned identifier associated with an entity.
+ type: string + Student: + description:A reference to another SIF Data Object
+ type: object + properties: + RefId: + $ref: "#/paths/~1WellbeingEvents~1%7BWellbeingEventRefId%\ + 7D/put/requestBody/content/application~1json/schema\ + /properties/WellbeingEvent/properties/WellbeingEven\ + tRefId" + LocalId: + $ref: "#/paths/~1WellbeingEvents~1%7BWellbeingEventRefId%\ + 7D/put/requestBody/content/application~1json/schema\ + /properties/WellbeingEvent/properties/WellbeingEven\ + tLocalId" + Name: + type: string + description:The normal descriptive name of the referenced + object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject names, to + be included in Object References
Text relating to the particular WellbeingEvent.
+ PossibleMotivationList: + description:A list of the possible motivations that triggered the + event.
+ type: object + properties: + PossibleMotivation: + type: array + items: + type: string + title: Wellbeing Event Possible Motivation + description: >- +Code set denoting the possible motivation that + triggered the Wellbeing Event.
Standard codes denoting the first level category of + the Wellbeing Event. (Note: The second and third levels + are Category and SubCategory)
List of Categories of WellbeingEvent.
+ type: object + properties: + EventCategory: + type: array + items: + description: + type: object + properties: + Category: + type: string + title: Wellbeing Event Category + description: >- +Standard codes denoting the second level + category of the Wellbeing Event. (Note: The + first and third levels are CategoryClass and + SubCategory)
List of Categories of the + WellbeingEvent.
+ type: object + properties: + EventSubCategory: + type: array + items: + description: + type: object + properties: + SubCategory: + type: string + title: Wellbeing Event Sub Category + description: >- +Standard codes denoting the third + level category of the Wellbeing + Event. (Note: The first and second + levels are CategoryClass and + Category)
Code set denoting the severity of the Wellbeing + Event.
A list of the locations where the incident took + place.
+ type: object + properties: + Location: + type: array + items: + type: string + title: Wellbeing Event Location + description: >- +Code set denoting locations where a Wellbeing + Event incident may have took place.
Details of Event Location.
+ EventCreationTimeStamp: + description:Date and time of the WellbeingEvent record + creation.
+ EventDate: + type: string + format: date + description:The calendar date on which this WellbeingEvent + occured.
+ EventTime: + description:The time when WellbeingEvent occured.
+ EventDescription: + type: string + description:A description of the WellbeingEvent.
+ EventTimePeriod: + type: string + title: Wellbeing Event Time Period + description: >- +Standard codes denoting the time period of the + Wellbeing Event.
A reusable code set for yes, no, unknown and not + provided values.
List of People involved in the Wellbeing event. + Mandatory if more people than the student to which this + event occurs is involved.
+ type: object + properties: + PersonInvolvement: + type: array + items: + description:A repeatable element recording the identifier + and details of another person that was involved in + the Wellbeing Event/Response.
+ type: object + properties: + HowInvolved: + type: string + description:Optional free text detailing + involvement.
+ PersonType: + type: string + title: Person Involved Type + description: >- +Code set denoting the type of person that + was involved.
Standard codes denoting the status of the Wellbeing + Response.
A list of the problem behaviours identified for the + student as a result of the Wellbeing Event. There are + both minor and major behaviours.
+ type: object + properties: + BehaviourIdentifiedList: + type: object + properties: + MinorBehaviour: + type: array + items: + - type: string + title: Wellbeing Event Minor Behaviour + description: >- +Code set denoting the type of minor + behaviour problem identified as part of the + Wellbeing Event.
Code set denoting the type of major + behaviour problem identified as part of the + Wellbeing Event.
Codes denoting the type of restraint used on a + student during a Wellbeing Event.
A list of the actions taken as a result of this + WellbeingEvent.
+ type: object + properties: + ActionTaken: + type: array + items: + type: string + title: Wellbeing Event Action Taken + description: >- +Code set denoting the actions that can be taken + as a result of the Wellbeing event.
Describes the Location of any associated documents + kept in relation to this Response.
+ type: object + properties: + Document: + type: array + items: + $ref: "#/paths/~1WellbeingEvents~1%7BWellbeingEventRefI\ + d%7D/put/requestBody/content/application~1json/sc\ + hema/properties/WellbeingEvent/properties/Student" + RelatedWellbeingEventList: + description:A Wellbeing Event gets created for every student + involved in an event. This list links together all + related Wellbeing Events.
+ type: object + properties: + RelatedWellbeingEvent: + type: array + items: + $ref: "#/paths/~1WellbeingEvents~1%7BWellbeingEventRefI\ + d%7D/put/requestBody/content/application~1json/sc\ + hema/properties/WellbeingEvent/properties/Student" + description:Record of an event happening that impacts on a school's + duty of care to its students. The event records both + 'positive' and 'negative' behaviours and is not just the + recording of a discipline incident or an accident.
+ x-accessControl: + create: + - 1001 + - 2401 + - 2403 + read: + - 1001 + - 2401 + - 2403 + update: + - 1001 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: [] + example: + WellbeingEvent: + WellbeingEventRefId: 2FFB63B4-CFEF-4820-8501-E7D1E54555CB + Student: + RefId: D3E34B35-9D75-101A-8C3D-00AA001A1652 + ReportingProvider: + RefId: CA285746-359D-7510-1A8C-36432A901A16 + EventCategoryClass: POS + EventDate: 2017-11-01 + EventTimePeriod: AM + RestraintType: NON + ActionTakenList: + ActionTaken: ININ + application/xml: + schema: + type: object + properties: + WellbeingEvent: + $ref: "#/paths/~1WellbeingEvents~1%7BWellbeingEventRefId%7D/put/r\ + equestBody/content/application~1json/schema/properties/Well\ + beingEvent" + example: >- +The ID (GUID) assigned to uniquely identify this + WellbeingEvent.
+ required: true + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + WellbeingEvent: + $ref: "#/paths/~1WellbeingEvents/get/responses/200/content/appl\ + ication~1json/schema/properties/WellbeingEvents/propertie\ + s/WellbeingEvent/items" + example: + WellbeingEvent: + WellbeingEventRefId: 2FFB63B4-CFEF-4820-8501-E7D1E54555CB + Student: + RefId: D3E34B35-9D75-101A-8C3D-00AA001A1652 + ReportingProvider: + RefId: CA285746-359D-7510-1A8C-36432A901A16 + EventCategoryClass: POS + EventDate: 2017-11-01 + EventTimePeriod: AM + RestraintType: NON + ActionTakenList: + ActionTaken: ININ + application/xml: + schema: + type: object + properties: + WellbeingEvent: + $ref: "#/paths/~1WellbeingEvents/get/responses/200/content/appl\ + ication~1json/schema/properties/WellbeingEvents/propertie\ + s/WellbeingEvent/items" + example: >- +The ID (GUID) assigned to uniquely identify this + WellbeingEvent.
+ required: true + schema: + type: string + responses: + "200": + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + 200" + default: + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + default" + /WellbeingResponses: + get: + tags: + - WellbeingResponse + summary: Default operation to get a list of all available WellbeingResponses + description: Search the set of available WellbeingResponses, according to the search + criteria in the URL parameters. Returns the first 20 objects located; + with SIF defined navigation headers, indicating how to retrieve + subsequent sets of 20 objects. + parameters: + - name: LocalId + in: path + description: Search for object by LocalId, within the context of the organisation + represented by the ZoneId of the request. + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + WellbeingResponses: + type: object + description: A List of WellbeingResponse objects + properties: + WellbeingResponse: + type: array + items: + required: + - Provider + - Student + type: object + properties: + WellbeingResponseRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[\ + a-fA-F0-9]{4}-[a-fA-F0-9]{12}" + WellbeingResponseLocalId: + description:This is a common element used to define the + locally assigned identifier associated with an + entity.
+ type: string + Student: + description:A reference to another SIF Data Object
+ type: object + required: + - ObjectType + properties: + RefId: + $ref: "#/paths/~1WellbeingResponses/get/responses\ + /200/content/application~1json/schema/prope\ + rties/WellbeingResponses/properties/Wellbei\ + ngResponse/items/properties/WellbeingRespon\ + seRefId" + LocalId: + $ref: "#/paths/~1WellbeingResponses/get/responses\ + /200/content/application~1json/schema/prope\ + rties/WellbeingResponses/properties/Wellbei\ + ngResponse/items/properties/WellbeingRespon\ + seLocalId" + Name: + type: string + description:The normal descriptive name of the + referenced object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject + names, to be included in Object + References
The calendar date on which this + WellbeingResponse was published.
+ StartDate: + type: string + format: date + description:The date the WellbeingResponse period + commenced.
+ EndDate: + type: string + format: date + description:The date the WellbeingResponse is due to + finish.
+ ResponseStatus: + type: string + title: Wellbeing Status + description: >- +Standard codes denoting the status of the + Wellbeing Response.
Standard codes denoting the category a + Wellbeing Response belongs to.
Text relating to the particular + WellbeingResponse.
+ PersonInvolvementList: + description:List of People involved in the Wellbeing + Event/Response. Mandatory if more people than + the student to which this event/response occurs + is involved.
+ type: object + required: + - PersonInvolvement + properties: + PersonInvolvement: + type: array + items: + description:A repeatable element recording the + identifier and details of another person + that was involved in the Wellbeing + Event/Response.
+ type: object + required: + - ObjectType + properties: + HowInvolved: + type: string + description:Optional free text detailing + involvement.
+ PersonType: + type: string + title: Person Involved Type + description: >- +Code set denoting the type of + person that was involved.
Container for details of a Suspension or + Expulsion.
+ type: object + properties: + SuspensionCategory: + type: string + title: Suspension Category + description: >- +Standard codes denoting the suspension + category a Wellbeing Response belongs + to.
Where a student is to be removed or + withdrawn partially for particular times in + a week within the Start and End dates of the + Response.
+ type: object + required: + - Withdrawal + properties: + Withdrawal: + type: array + items: + description:Repeatable Withdrawal.
+ type: object + properties: + WithdrawalStartDate: + type: string + format: date + description:The start date of the + withdrawal.
+ WithdrawalEndDate: + type: string + format: date + description:The end date of the + withdrawal.
+ WithdrawalStartTime: + description:Start time of the Withdrawal on + that day.
+ WithdrawalEndTime: + description:End time of the Withdrawal on + that day.
+ SchoolTerm: + type: integer + description:The school term the withdrawal + took place in.
+ WithdrawalFrom: + $ref: "#/paths/~1WellbeingResponses/get\ + /responses/200/content/applicatio\ + n~1json/schema/properties/Wellbei\ + ngResponses/properties/WellbeingR\ + esponse/items/properties/Student" + Duration: + description:The duration of a Suspension in days 0.00 + – X.xx. (Half Day = 0.5, Full Day = 1.0 or + the percentage of any day.) Must be provided + for a Suspension when known.
+ AdvisementDate: + type: string + format: date + description:The date parent/carers were officially + notified.
+ ResolutionMeetingTime: + description:The date and time at which a meeting with + the student’s parents/carers was held to + resolve the Suspension.
+ ResolutionNotes: + type: string + description:Comments about how the Suspension has + been resolved, including any reparative + actions the student needs to take.
+ EarlyReturnDate: + type: string + format: date + description:The date at which the student was + permitted to return to school earlier than + the agreed duration would have allowed.
+ Detention: + description:Container for details of a Detention.
+ type: object + properties: + DetentionCategory: + type: string + title: Detention Category + description: >- +Standard codes denoting the detention + category a Wellbeing Response belongs + to.
The date of the detention.
+ DetentionLocation: + type: string + description:Eventually to be typed for initial draft + will be string to try and determine a valid + code set.
+ DetentionNotes: + type: string + description:Any notes that can be provided regarding + the need/response that led to the + detention.
+ PlanRequiredList: + description:List of plans that are required to be + generated as part of the WellbeingResponse
+ type: object + required: + - Plan + properties: + Plan: + type: array + items: + description:Repeatable Plan information.
+ type: object + properties: + PlanNotes: + type: string + description:Any notes that can be provided + regarding the need that led to the + plan.
+ PlanDocument: + $ref: "#/paths/~1WellbeingResponses/get/res\ + ponses/200/content/application~1json/\ + schema/properties/WellbeingResponses/\ + properties/WellbeingResponse/items/pr\ + operties/Student" + Award: + description:Container for details of an Award.
+ type: object + properties: + AwardDate: + type: string + format: date + description:Date when to be awarded.
+ AwardType: + type: string + description:Type of Award.
+ AwardDescription: + type: string + description:Description of the Award.
+ AwardNotes: + type: string + description:Any comments/notes associated with the + Award.
+ OtherResponse: + description:Container for details of another type of + Response.
+ type: object + properties: + OtherResponseDate: + type: string + format: date + description:Date of the other response
+ OtherResponseDescription: + type: string + description:Description of the other response.
+ OtherResponseNotes: + type: string + description:Any comments/notes associated with the + other response.
+ DocumentList: + description:Describes the Location of any associated + documents kept in relation to this Response.
+ type: object + required: + - Document + properties: + Document: + type: array + items: + $ref: "#/paths/~1WellbeingResponses/get/respons\ + es/200/content/application~1json/schema/p\ + roperties/WellbeingResponses/properties/W\ + ellbeingResponse/items/properties/Student" + WellbeingAlert: + $ref: "#/paths/~1WellbeingResponses/get/responses/200\ + /content/application~1json/schema/properties/We\ + llbeingResponses/properties/WellbeingResponse/i\ + tems/properties/Student" + WellbeingEvent: + $ref: "#/paths/~1WellbeingResponses/get/responses/200\ + /content/application~1json/schema/properties/We\ + llbeingResponses/properties/WellbeingResponse/i\ + tems/properties/Student" + WellbeingAppealList: + description:A list of any appeals that have been made in + relation to this Wellbeing Response.
+ type: object + required: + - WellbeingAppeal + properties: + WellbeingAppeal: + type: array + items: + $ref: "#/paths/~1WellbeingResponses/get/respons\ + es/200/content/application~1json/schema/p\ + roperties/WellbeingResponses/properties/W\ + ellbeingResponse/items/properties/Student" + description:A record of the outcome and follow ups generated + by a WellbeingEvent
+ x-accessControl: + create: + - 1001 + - 2401 + - 2403 + read: + - 1001 + - 2401 + - 2403 + update: + - 1001 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: [] + example: + WellbeingResponses: + WellbeingResponse: + - WellbeingResponseRefId: 2FFB63B4-CFEF-4820-8501-E7D1E54555CB + Student: + RefId: D3E34B35-9D75-101A-8C3D-00AA001A1652 + Provider: + RefId: CA285746-359D-7510-1A8C-36432A901A16 + PublishedDate: 2017-11-01 + StartDate: 2017-11-01 + EndDate: 2017-11-10 + ResponseCategory: S + ResponseNotes: This Student is to be withdrawn. + application/xml: + schema: + type: object + properties: + WellbeingResponses: + type: object + description: A List of WellbeingResponse objects + properties: + WellbeingResponse: + type: array + items: + $ref: "#/paths/~1WellbeingResponses/get/responses/200/con\ + tent/application~1json/schema/properties/WellbeingR\ + esponses/properties/WellbeingResponse/items" + example: >- +The ID (GUID) assigned to uniquely identify this + WellbeingResponse.
+ required: true + schema: + type: string + operationId: createWellbeingResponse + requestBody: + description: CRUD operation on WellbeingResponse + content: + application/json: + schema: + type: object + properties: + WellbeingResponse: + $ref: "#/paths/~1WellbeingResponses/get/responses/200/content/app\ + lication~1json/schema/properties/WellbeingResponses/propert\ + ies/WellbeingResponse/items" + example: + WellbeingResponse: + WellbeingResponseRefId: 2FFB63B4-CFEF-4820-8501-E7D1E54555CB + Student: + RefId: D3E34B35-9D75-101A-8C3D-00AA001A1652 + Provider: + RefId: CA285746-359D-7510-1A8C-36432A901A16 + PublishedDate: 2017-11-01 + StartDate: 2017-11-01 + EndDate: 2017-11-10 + ResponseCategory: S + ResponseNotes: This Student is to be withdrawn. + application/xml: + schema: + type: object + properties: + WellbeingResponse: + $ref: "#/paths/~1WellbeingResponses/get/responses/200/content/app\ + lication~1json/schema/properties/WellbeingResponses/propert\ + ies/WellbeingResponse/items" + example: >- +The ID (GUID) assigned to uniquely identify this + WellbeingResponse.
+ required: true + schema: + type: string + operationId: updateWellbeingResponse + requestBody: + description: CRUD operation on WellbeingResponse + content: + application/json: + schema: + type: object + properties: + WellbeingResponse: + type: object + properties: + WellbeingResponseRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-\ + 9]{4}-[a-fA-F0-9]{12}" + WellbeingResponseLocalId: + description:This is a common element used to define the locally + assigned identifier associated with an entity.
+ type: string + Student: + description:A reference to another SIF Data Object
+ type: object + properties: + RefId: + $ref: "#/paths/~1WellbeingResponses~1%7BWellbeingResponse\ + RefId%7D/put/requestBody/content/application~1json/\ + schema/properties/WellbeingResponse/properties/Well\ + beingResponseRefId" + LocalId: + $ref: "#/paths/~1WellbeingResponses~1%7BWellbeingResponse\ + RefId%7D/put/requestBody/content/application~1json/\ + schema/properties/WellbeingResponse/properties/Well\ + beingResponseLocalId" + Name: + type: string + description:The normal descriptive name of the referenced + object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject names, to + be included in Object References
The calendar date on which this WellbeingResponse was + published.
+ StartDate: + type: string + format: date + description:The date the WellbeingResponse period commenced.
+ EndDate: + type: string + format: date + description:The date the WellbeingResponse is due to finish.
+ ResponseStatus: + type: string + title: Wellbeing Status + description: >- +Standard codes denoting the status of the Wellbeing + Response.
Standard codes denoting the category a Wellbeing + Response belongs to.
Text relating to the particular WellbeingResponse.
+ PersonInvolvementList: + description:List of People involved in the Wellbeing + Event/Response. Mandatory if more people than the + student to which this event/response occurs is + involved.
+ type: object + properties: + PersonInvolvement: + type: array + items: + description:A repeatable element recording the identifier + and details of another person that was involved in + the Wellbeing Event/Response.
+ type: object + properties: + HowInvolved: + type: string + description:Optional free text detailing + involvement.
+ PersonType: + type: string + title: Person Involved Type + description: >- +Code set denoting the type of person that + was involved.
Container for details of a Suspension or + Expulsion.
+ type: object + properties: + SuspensionCategory: + type: string + title: Suspension Category + description: >- +Standard codes denoting the suspension category a + Wellbeing Response belongs to.
Where a student is to be removed or withdrawn + partially for particular times in a week within the + Start and End dates of the Response.
+ type: object + properties: + Withdrawal: + type: array + items: + description:Repeatable Withdrawal.
+ type: object + properties: + WithdrawalStartDate: + type: string + format: date + description:The start date of the withdrawal.
+ WithdrawalEndDate: + type: string + format: date + description:The end date of the withdrawal.
+ WithdrawalStartTime: + description:Start time of the Withdrawal on that + day.
+ WithdrawalEndTime: + description:End time of the Withdrawal on that + day.
+ SchoolTerm: + type: integer + description:The school term the withdrawal took + place in.
+ WithdrawalFrom: + $ref: "#/paths/~1WellbeingResponses~1%7BWellbei\ + ngResponseRefId%7D/put/requestBody/conten\ + t/application~1json/schema/properties/Wel\ + lbeingResponse/properties/Student" + Duration: + description:The duration of a Suspension in days 0.00 – X.xx. + (Half Day = 0.5, Full Day = 1.0 or the percentage of + any day.) Must be provided for a Suspension when + known.
+ AdvisementDate: + type: string + format: date + description:The date parent/carers were officially + notified.
+ ResolutionMeetingTime: + description:The date and time at which a meeting with the + student’s parents/carers was held to resolve the + Suspension.
+ ResolutionNotes: + type: string + description:Comments about how the Suspension has been + resolved, including any reparative actions the + student needs to take.
+ EarlyReturnDate: + type: string + format: date + description:The date at which the student was permitted to + return to school earlier than the agreed duration + would have allowed.
+ Detention: + description:Container for details of a Detention.
+ type: object + properties: + DetentionCategory: + type: string + title: Detention Category + description: >- +Standard codes denoting the detention category a + Wellbeing Response belongs to.
The date of the detention.
+ DetentionLocation: + type: string + description:Eventually to be typed for initial draft will be + string to try and determine a valid code set.
+ DetentionNotes: + type: string + description:Any notes that can be provided regarding the + need/response that led to the detention.
+ PlanRequiredList: + description:List of plans that are required to be generated as + part of the WellbeingResponse
+ type: object + properties: + Plan: + type: array + items: + description:Repeatable Plan information.
+ type: object + properties: + PlanNotes: + type: string + description:Any notes that can be provided regarding + the need that led to the plan.
+ PlanDocument: + $ref: "#/paths/~1WellbeingResponses~1%7BWellbeingRe\ + sponseRefId%7D/put/requestBody/content/applic\ + ation~1json/schema/properties/WellbeingRespon\ + se/properties/Student" + Award: + description:Container for details of an Award.
+ type: object + properties: + AwardDate: + type: string + format: date + description:Date when to be awarded.
+ AwardType: + type: string + description:Type of Award.
+ AwardDescription: + type: string + description:Description of the Award.
+ AwardNotes: + type: string + description:Any comments/notes associated with the Award.
+ OtherResponse: + description:Container for details of another type of Response.
+ type: object + properties: + OtherResponseDate: + type: string + format: date + description:Date of the other response
+ OtherResponseDescription: + type: string + description:Description of the other response.
+ OtherResponseNotes: + type: string + description:Any comments/notes associated with the other + response.
+ DocumentList: + description:Describes the Location of any associated documents + kept in relation to this Response.
+ type: object + properties: + Document: + type: array + items: + $ref: "#/paths/~1WellbeingResponses~1%7BWellbeingRespon\ + seRefId%7D/put/requestBody/content/application~1j\ + son/schema/properties/WellbeingResponse/propertie\ + s/Student" + WellbeingAlert: + $ref: "#/paths/~1WellbeingResponses~1%7BWellbeingResponseRefI\ + d%7D/put/requestBody/content/application~1json/schema/p\ + roperties/WellbeingResponse/properties/Student" + WellbeingEvent: + $ref: "#/paths/~1WellbeingResponses~1%7BWellbeingResponseRefI\ + d%7D/put/requestBody/content/application~1json/schema/p\ + roperties/WellbeingResponse/properties/Student" + WellbeingAppealList: + description:A list of any appeals that have been made in relation + to this Wellbeing Response.
+ type: object + properties: + WellbeingAppeal: + type: array + items: + $ref: "#/paths/~1WellbeingResponses~1%7BWellbeingRespon\ + seRefId%7D/put/requestBody/content/application~1j\ + son/schema/properties/WellbeingResponse/propertie\ + s/Student" + description:A record of the outcome and follow ups generated by a + WellbeingEvent
+ x-accessControl: + create: + - 1001 + - 2401 + - 2403 + read: + - 1001 + - 2401 + - 2403 + update: + - 1001 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: [] + example: + WellbeingResponse: + WellbeingResponseRefId: 2FFB63B4-CFEF-4820-8501-E7D1E54555CB + Student: + RefId: D3E34B35-9D75-101A-8C3D-00AA001A1652 + Provider: + RefId: CA285746-359D-7510-1A8C-36432A901A16 + PublishedDate: 2017-11-01 + StartDate: 2017-11-01 + EndDate: 2017-11-10 + ResponseCategory: S + ResponseNotes: This Student is to be withdrawn. + application/xml: + schema: + type: object + properties: + WellbeingResponse: + $ref: "#/paths/~1WellbeingResponses~1%7BWellbeingResponseRefId%7D\ + /put/requestBody/content/application~1json/schema/propertie\ + s/WellbeingResponse" + example: >- +The ID (GUID) assigned to uniquely identify this + WellbeingResponse.
+ required: true + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + WellbeingResponse: + $ref: "#/paths/~1WellbeingResponses/get/responses/200/content/a\ + pplication~1json/schema/properties/WellbeingResponses/pro\ + perties/WellbeingResponse/items" + example: + WellbeingResponse: + WellbeingResponseRefId: 2FFB63B4-CFEF-4820-8501-E7D1E54555CB + Student: + RefId: D3E34B35-9D75-101A-8C3D-00AA001A1652 + Provider: + RefId: CA285746-359D-7510-1A8C-36432A901A16 + PublishedDate: 2017-11-01 + StartDate: 2017-11-01 + EndDate: 2017-11-10 + ResponseCategory: S + ResponseNotes: This Student is to be withdrawn. + application/xml: + schema: + type: object + properties: + WellbeingResponse: + $ref: "#/paths/~1WellbeingResponses/get/responses/200/content/a\ + pplication~1json/schema/properties/WellbeingResponses/pro\ + perties/WellbeingResponse/items" + example: >- +The ID (GUID) assigned to uniquely identify this + WellbeingResponse.
+ required: true + schema: + type: string + responses: + "200": + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + 200" + default: + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + default" + /WellbeingAppeals: + get: + tags: + - WellbeingAppeal + summary: Default operation to get a list of all available WellbeingAppeals + description: Search the set of available WellbeingAppeals, according to the search + criteria in the URL parameters. Returns the first 20 objects located; + with SIF defined navigation headers, indicating how to retrieve + subsequent sets of 20 objects. + parameters: + - name: LocalId + in: path + description: Search for object by LocalId, within the context of the organisation + represented by the ZoneId of the request. + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + WellbeingAppeals: + type: object + description: A List of WellbeingAppeal objects + properties: + WellbeingAppeal: + type: array + items: + required: + - Provider + - Student + - WellbeingResponse + type: object + properties: + WellbeingAppealRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[\ + a-fA-F0-9]{4}-[a-fA-F0-9]{12}" + WellbeingAppealLocalId: + description:This is a common element used to define the + locally assigned identifier associated with an + entity.
+ type: string + Student: + description:A reference to another SIF Data Object
+ type: object + required: + - ObjectType + properties: + RefId: + $ref: "#/paths/~1WellbeingAppeals/get/responses/2\ + 00/content/application~1json/schema/propert\ + ies/WellbeingAppeals/properties/WellbeingAp\ + peal/items/properties/WellbeingAppealRefId" + LocalId: + $ref: "#/paths/~1WellbeingAppeals/get/responses/2\ + 00/content/application~1json/schema/propert\ + ies/WellbeingAppeals/properties/WellbeingAp\ + peal/items/properties/WellbeingAppealLocalI\ + d" + Name: + type: string + description:The normal descriptive name of the + referenced object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject + names, to be included in Object + References
Standard codes denoting the status of the + Wellbeing Appeal.
The calendar date on which this + WellbeingAppeal was registered.
+ AppealNotes: + type: string + description:Text relating to the particular + WellbeingAppeal.
+ AppealOutcome: + type: string + title: Wellbeing Appeal Outcome + description: >- +Code set denoting the outcome of a wellbeing + appeal.
Code set denoting the type of individual or + group that determined the appeal outcome.
+Describes the Location of any associated + documents kept in relation to this Appeal.
+ type: object + required: + - Document + properties: + Document: + type: array + items: + $ref: "#/paths/~1WellbeingAppeals/get/responses\ + /200/content/application~1json/schema/pro\ + perties/WellbeingAppeals/properties/Wellb\ + eingAppeal/items/properties/Student" + description:Records detail of any "appeal" or "request" made + by involved parties in regard to a negative/punitive + Wellbeing Response that was the result of a student + Wellbeing Event.
+ x-accessControl: + ? create + ? read + ? update + ? delete + ? aggregate + example: + WellbeingAppeals: + WellbeingAppeal: + - WellbeingAppealRefId: 2FFB63B4-CFEF-4820-8501-E7D1E54555CB + Student: + RefId: D3E34B35-9D75-101A-8C3D-00AA001A1652 + Provider: + RefId: CA285746-359D-7510-1A8C-36432A901A16 + WellbeingResponse: + RefId: BC385746-359D-7510-1A8C-36432A901A36 + AppealStatus: SU + RegisteredDate: 2017-11-01 + AppealNotes: This Appeal was successful. + application/xml: + schema: + type: object + properties: + WellbeingAppeals: + type: object + description: A List of WellbeingAppeal objects + properties: + WellbeingAppeal: + type: array + items: + $ref: "#/paths/~1WellbeingAppeals/get/responses/200/conte\ + nt/application~1json/schema/properties/WellbeingApp\ + eals/properties/WellbeingAppeal/items" + example: >- +The ID (GUID) assigned to uniquely identify this + WellbeingAppeal.
+ required: true + schema: + type: string + operationId: createWellbeingAppeal + requestBody: + description: CRUD operation on WellbeingAppeal + content: + application/json: + schema: + type: object + properties: + WellbeingAppeal: + $ref: "#/paths/~1WellbeingAppeals/get/responses/200/content/appli\ + cation~1json/schema/properties/WellbeingAppeals/properties/\ + WellbeingAppeal/items" + example: + WellbeingAppeal: + WellbeingAppealRefId: 2FFB63B4-CFEF-4820-8501-E7D1E54555CB + Student: + RefId: D3E34B35-9D75-101A-8C3D-00AA001A1652 + Provider: + RefId: CA285746-359D-7510-1A8C-36432A901A16 + WellbeingResponse: + RefId: BC385746-359D-7510-1A8C-36432A901A36 + AppealStatus: SU + RegisteredDate: 2017-11-01 + AppealNotes: This Appeal was successful. + application/xml: + schema: + type: object + properties: + WellbeingAppeal: + $ref: "#/paths/~1WellbeingAppeals/get/responses/200/content/appli\ + cation~1json/schema/properties/WellbeingAppeals/properties/\ + WellbeingAppeal/items" + example: >- +The ID (GUID) assigned to uniquely identify this + WellbeingAppeal.
+ required: true + schema: + type: string + operationId: updateWellbeingAppeal + requestBody: + description: CRUD operation on WellbeingAppeal + content: + application/json: + schema: + type: object + properties: + WellbeingAppeal: + type: object + properties: + WellbeingAppealRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-\ + 9]{4}-[a-fA-F0-9]{12}" + WellbeingAppealLocalId: + description:This is a common element used to define the locally + assigned identifier associated with an entity.
+ type: string + Student: + description:A reference to another SIF Data Object
+ type: object + properties: + RefId: + $ref: "#/paths/~1WellbeingAppeals~1%7BWellbeingAppealRefI\ + d%7D/put/requestBody/content/application~1json/sche\ + ma/properties/WellbeingAppeal/properties/WellbeingA\ + ppealRefId" + LocalId: + $ref: "#/paths/~1WellbeingAppeals~1%7BWellbeingAppealRefI\ + d%7D/put/requestBody/content/application~1json/sche\ + ma/properties/WellbeingAppeal/properties/WellbeingA\ + ppealLocalId" + Name: + type: string + description:The normal descriptive name of the referenced + object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject names, to + be included in Object References
Standard codes denoting the status of the Wellbeing + Appeal.
The calendar date on which this WellbeingAppeal was + registered.
+ AppealNotes: + type: string + description:Text relating to the particular WellbeingAppeal.
+ AppealOutcome: + type: string + title: Wellbeing Appeal Outcome + description: >- +Code set denoting the outcome of a wellbeing + appeal.
Code set denoting the type of individual or group + that determined the appeal outcome.
Describes the Location of any associated documents + kept in relation to this Appeal.
+ type: object + properties: + Document: + type: array + items: + $ref: "#/paths/~1WellbeingAppeals~1%7BWellbeingAppealRe\ + fId%7D/put/requestBody/content/application~1json/\ + schema/properties/WellbeingAppeal/properties/Stud\ + ent" + description:Records detail of any "appeal" or "request" made by + involved parties in regard to a negative/punitive Wellbeing + Response that was the result of a student Wellbeing + Event.
+ x-accessControl: + ? create + ? read + ? update + ? delete + ? aggregate + example: + WellbeingAppeal: + WellbeingAppealRefId: 2FFB63B4-CFEF-4820-8501-E7D1E54555CB + Student: + RefId: D3E34B35-9D75-101A-8C3D-00AA001A1652 + Provider: + RefId: CA285746-359D-7510-1A8C-36432A901A16 + WellbeingResponse: + RefId: BC385746-359D-7510-1A8C-36432A901A36 + AppealStatus: SU + RegisteredDate: 2017-11-01 + AppealNotes: This Appeal was successful. + application/xml: + schema: + type: object + properties: + WellbeingAppeal: + $ref: "#/paths/~1WellbeingAppeals~1%7BWellbeingAppealRefId%7D/put\ + /requestBody/content/application~1json/schema/properties/We\ + llbeingAppeal" + example: >- +The ID (GUID) assigned to uniquely identify this + WellbeingAppeal.
+ required: true + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + WellbeingAppeal: + $ref: "#/paths/~1WellbeingAppeals/get/responses/200/content/app\ + lication~1json/schema/properties/WellbeingAppeals/propert\ + ies/WellbeingAppeal/items" + example: + WellbeingAppeal: + WellbeingAppealRefId: 2FFB63B4-CFEF-4820-8501-E7D1E54555CB + Student: + RefId: D3E34B35-9D75-101A-8C3D-00AA001A1652 + Provider: + RefId: CA285746-359D-7510-1A8C-36432A901A16 + WellbeingResponse: + RefId: BC385746-359D-7510-1A8C-36432A901A36 + AppealStatus: SU + RegisteredDate: 2017-11-01 + AppealNotes: This Appeal was successful. + application/xml: + schema: + type: object + properties: + WellbeingAppeal: + $ref: "#/paths/~1WellbeingAppeals/get/responses/200/content/app\ + lication~1json/schema/properties/WellbeingAppeals/propert\ + ies/WellbeingAppeal/items" + example: >- +The ID (GUID) assigned to uniquely identify this + WellbeingAppeal.
+ required: true + schema: + type: string + responses: + "200": + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + 200" + default: + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + default" + /StudentActivityParticipations: + get: + tags: + - StudentActivityParticipation + summary: Default operation to get a list of all available + StudentActivityParticipations + description: Search the set of available StudentActivityParticipations, according to + the search criteria in the URL parameters. Returns the first 20 objects + located; with SIF defined navigation headers, indicating how to retrieve + subsequent sets of 20 objects. + parameters: + - name: LocalId + in: path + description: Search for object by LocalId, within the context of the organisation + represented by the ZoneId of the request. + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + StudentActivityParticipations: + type: object + description: A List of StudentActivityParticipation objects + properties: + StudentActivityParticipation: + type: array + items: + required: + - ActivityName + - Provider + - StartDate + - Student + type: object + properties: + StudentActivityParticipationRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[\ + a-fA-F0-9]{4}-[a-fA-F0-9]{12}" + StudentActivityParticipationLocalId: + description:This is a common element used to define the + locally assigned identifier associated with an + entity.
+ type: string + Student: + description:A reference to another SIF Data Object
+ type: object + required: + - ObjectType + properties: + RefId: + $ref: "#/paths/~1StudentActivityParticipations/ge\ + t/responses/200/content/application~1json/s\ + chema/properties/StudentActivityParticipati\ + ons/properties/StudentActivityParticipation\ + /items/properties/StudentActivityParticipat\ + ionRefId" + LocalId: + $ref: "#/paths/~1StudentActivityParticipations/ge\ + t/responses/200/content/application~1json/s\ + chema/properties/StudentActivityParticipati\ + ons/properties/StudentActivityParticipation\ + /items/properties/StudentActivityParticipat\ + ionLocalId" + Name: + type: string + description:The normal descriptive name of the + referenced object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject + names, to be included in Object + References
Standard codes denoting the group of the + activity the student is participating in, e.g. + sport, art, cultural, music.
Standard codes denoting the type of activity + the student is participating in, e.g. rugby, + drama, Kapa Haka, Violin.
The name of the activity the student + participated in.
+ LearningArea: + type: string + title: Learning Area + description: >- +Codes denoting Learning Areas defined by the + NZ Curriculum and Te Marautanga o Aotearoa.
+Comment related to the student's + participation in the activity.
+ StartDate: + type: string + format: date + description:This is the date from which the activity + participation is valid (inclusive).
+ EndDate: + type: string + format: date + description:This is the date through which the activity + participation is valid (inclusive). If element + is supported by the publisher/responder, should + contain a date if the student withdraws from the + activity before the end of the school year.
+ Role: + type: string + description:Specific role the student plays in the + activity (e.g., band leader, student body + president).
+ RecognitionList: + description:List of awards and other types of recognition + given to the student for this activity.
+ type: object + required: + - Recognition + properties: + Recognition: + type: array + items: + type: string + description: This object provides information on a co-curricular + or extra-curricular activity in which a student + participates during a given school year. + x-accessControl: + ? create + ? read + ? update + ? delete + ? aggregate + example: + StudentActivityParticipations: + StudentActivityParticipation: + - StudentActivityParticipationRefId: 9ECC9683-0E02-406F-926C-1C4D3542D122 + Student: + RefId: 646C5D4A-C829-4886-A02B-971695C7BC06 + Provider: + RefId: 33d610cd-40d3-44db-b21b-3cffe695503a + ActivityGroup: SPO + ActivityType: CRI + ActivityName: First XI + ParticipationComment: First year of participation + StartDate: 2008-09-01 + Role: Team Member + RecognitionList: + Recognition: Player of the Day + application/xml: + schema: + type: object + properties: + StudentActivityParticipations: + type: object + description: A List of StudentActivityParticipation objects + properties: + StudentActivityParticipation: + type: array + items: + $ref: "#/paths/~1StudentActivityParticipations/get/respon\ + ses/200/content/application~1json/schema/properties\ + /StudentActivityParticipations/properties/StudentAc\ + tivityParticipation/items" + example: >- +This is a common element used to define the locally + assigned identifier associated with an entity.
+ type: string + Student: + description:A reference to another SIF Data Object
+ type: object + properties: + RefId: + $ref: "#/paths/~1StudentActivityParticipations~1%7BStuden\ + tActivityParticipationRefId%7D/put/requestBody/cont\ + ent/application~1json/schema/properties/StudentActi\ + vityParticipation/properties/StudentActivityPartici\ + pationRefId" + LocalId: + $ref: "#/paths/~1StudentActivityParticipations~1%7BStuden\ + tActivityParticipationRefId%7D/put/requestBody/cont\ + ent/application~1json/schema/properties/StudentActi\ + vityParticipation/properties/StudentActivityPartici\ + pationLocalId" + Name: + type: string + description:The normal descriptive name of the referenced + object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject names, to + be included in Object References
Standard codes denoting the group of the activity the + student is participating in, e.g. sport, art, cultural, + music.
Standard codes denoting the type of activity the + student is participating in, e.g. rugby, drama, Kapa + Haka, Violin.
The name of the activity the student participated + in.
+ LearningArea: + type: string + title: Learning Area + description: >- +Codes denoting Learning Areas defined by the NZ + Curriculum and Te Marautanga o Aotearoa.
Comment related to the student's participation in the + activity.
+ StartDate: + type: string + format: date + description:This is the date from which the activity + participation is valid (inclusive).
+ EndDate: + type: string + format: date + description:This is the date through which the activity + participation is valid (inclusive). If element is + supported by the publisher/responder, should contain a + date if the student withdraws from the activity before + the end of the school year.
+ Role: + type: string + description:Specific role the student plays in the activity + (e.g., band leader, student body president).
+ RecognitionList: + description:List of awards and other types of recognition given + to the student for this activity.
+ type: object + properties: + Recognition: + type: array + items: + type: string + description: This object provides information on a co-curricular or + extra-curricular activity in which a student participates + during a given school year. + x-accessControl: + ? create + ? read + ? update + ? delete + ? aggregate + example: + StudentActivityParticipation: + StudentActivityParticipationRefId: 9ECC9683-0E02-406F-926C-1C4D3542D122 + Student: + RefId: 646C5D4A-C829-4886-A02B-971695C7BC06 + Provider: + RefId: 33d610cd-40d3-44db-b21b-3cffe695503a + ActivityGroup: SPO + ActivityType: CRI + ActivityName: First XI + ParticipationComment: First year of participation + StartDate: 2008-09-01 + Role: Team Member + RecognitionList: + Recognition: Player of the Day + application/xml: + schema: + type: object + properties: + StudentActivityParticipation: + $ref: "#/paths/~1StudentActivityParticipations~1%7BStudentActivit\ + yParticipationRefId%7D/put/requestBody/content/application~\ + 1json/schema/properties/StudentActivityParticipation" + example: >- +This is a common element used to define the + locally assigned identifier associated with an + entity.
+ type: string + Provider: + description:A reference to another SIF Data Object
+ type: object + required: + - ObjectType + properties: + RefId: + $ref: "#/paths/~1StudentPhysicalRestraints/get/re\ + sponses/200/content/application~1json/schem\ + a/properties/StudentPhysicalRestraints/prop\ + erties/StudentPhysicalRestraint/items/prope\ + rties/StudentPhysicalRestraintRefId" + LocalId: + $ref: "#/paths/~1StudentPhysicalRestraints/get/re\ + sponses/200/content/application~1json/schem\ + a/properties/StudentPhysicalRestraints/prop\ + erties/StudentPhysicalRestraint/items/prope\ + rties/StudentPhysicalRestraintLocalId" + Name: + type: string + description:The normal descriptive name of the + referenced object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject + names, to be included in Object + References
Free text description on why the physical + restraint of the student was considered + necessary.
+ FirstTimeStudentRestrained: + type: string + title: Yes Or No Category + description: >- +A reusable code set for yes, no, unknown and + not provided values.
The date the physical restraint was used on + the student.
+ LocationDescription: + type: string + description:Free text description of the location the + physical restraint of the student occurred + in.
+ OtherComment: + type: string + description:Any other comments on the physical restraint + incident.
+ ReportedDate: + type: string + format: date + description:The date the use of physical restraint on the + student was report.
+ RestraintEndedTime: + description:The time the physical restraint stopped being + used.
+ RestraintStartedTime: + description:The time the physical restraint started being + used.
+ RestraintReason: + type: string + title: Restraint Reason + description: >- +A code set denoting the reason physical + restraint was used on the student.
Year Level defines the values that are valid + for describing Funding Year Level and Current + Year Level for a student enrolment.
+Current Year Level indicates the year level + of the student’s class cohort and the level at + which the student spends most of their time at + school. While a student may be enrolled in + subjects at varying instructional year levels, + in relation to the student enrolment this value + represents the year level at which the student + is considered to be predominantly taught.
+Funding Year Level measures the actual number + of years that the student has attended a school. + It provides the Ministry with a method of + counting students for funding purposes which is + independent of the way schools are organised or + the particular programme of study that a student + may undertake. Funding Year Level for most + students is based on the date they first started + school.
School Year Level is used to + indicate the instructional year levels offered + by a school, i.e. those years for which student + enrolments may be accepted.
Describes the Location of any associated + documents kept in relation to this physical + restraint incident.
+ type: object + required: + - Document + properties: + Document: + type: array + items: + $ref: "#/paths/~1StudentPhysicalRestraints/get/\ + responses/200/content/application~1json/s\ + chema/properties/StudentPhysicalRestraint\ + s/properties/StudentPhysicalRestraint/ite\ + ms/properties/Provider" + RestraintWitnessList: + description:A list of the people that witnessed the + physical constraint.
+ type: object + required: + - Witness + properties: + Witness: + type: array + items: + $ref: "#/paths/~1StudentPhysicalRestraints/get/\ + responses/200/content/application~1json/s\ + chema/properties/StudentPhysicalRestraint\ + s/properties/StudentPhysicalRestraint/ite\ + ms/properties/Provider" + RestraintAdministeredByList: + description:A list of the people who administered the + physical restraint to the student.
+ type: object + required: + - RestraintAdministeredBy + properties: + RestraintAdministeredBy: + type: array + items: + description:The person who administered the + physical restraint to the student.
+ type: object + properties: + AdministeredBy: + $ref: "#/paths/~1StudentPhysicalRestraints/\ + get/responses/200/content/application\ + ~1json/schema/properties/StudentPhysi\ + calRestraints/properties/StudentPhysi\ + calRestraint/items/properties/Provide\ + r" + SafePhysicalRestraintTraining: + $ref: "#/paths/~1StudentPhysicalRestraints/\ + get/responses/200/content/application\ + ~1json/schema/properties/StudentPhysi\ + calRestraints/properties/StudentPhysi\ + calRestraint/items/properties/FirstTi\ + meStudentRestrained" + TrainingDescription: + type: string + description:Free text providing additional + information about any training the + person has had on the safe use pf + physical restraint.
+ Role: + type: string + title: Restraint Administered By Role + description: >- +Code set denoting the role of the + person who administered the physical + restraint to the student.
The list of the people and/or property that + the student, who was restrained, was directing + their behaviour at.
+ type: object + required: + - BehaviourDirectedAt + properties: + BehaviourDirectedAt: + type: array + items: + description:The person and/or piece of property + that the student, who was restrained, was + directing their behaviour at.
+ type: object + properties: + DirectedAt: + $ref: "#/paths/~1StudentPhysicalRestraints/\ + get/responses/200/content/application\ + ~1json/schema/properties/StudentPhysi\ + calRestraints/properties/StudentPhysi\ + calRestraint/items/properties/Provide\ + r" + BehaviourDescription: + type: string + description:Free text describing the behaviour + the student showed towards a person of + piece of property.
+ DirectedAtType: + type: string + title: Behaviour Directed At Type + description: >- +Code set denoting type of object or + person the student was directing their + behaviour at, e.g. Staff Member, + Student, Desk, Chair.
A list of the reflections made by the staff + members who applied the physical restraint.
+ type: object + required: + - StaffReflection + properties: + StaffReflection: + type: array + items: + description:The reflections performed by the staff + member who applied the physical restraint + to the student.
+ type: object + properties: + ReflectionDate: + type: string + format: date + description:The date the staff member performed + their reflection on the use of + physical restraint on the student.
+ WitnessedBy: + $ref: "#/paths/~1StudentPhysicalRestraints/\ + get/responses/200/content/application\ + ~1json/schema/properties/StudentPhysi\ + calRestraints/properties/StudentPhysi\ + calRestraint/items/properties/Provide\ + r" + Staff: + $ref: "#/paths/~1StudentPhysicalRestraints/\ + get/responses/200/content/application\ + ~1json/schema/properties/StudentPhysi\ + calRestraints/properties/StudentPhysi\ + calRestraint/items/properties/Provide\ + r" + ReflectionList: + description:A list of the reflections the staff + member performed.
+ type: object + required: + - Reflection + properties: + Reflection: + type: array + items: + description:A reflection that a staff + member performed about the + physical restraint incident.
+ type: object + properties: + ReflectionDescription: + type: string + description:Free text outlining the + staff members thoughts on a + type of reflection.
+ Type: + type: string + title: Staff Restraint Reflection + Type + description: >- +Code set denoting the + type of reflection that the + staff member performed.
+A list of the debriefings that took place + after the physical restraint incident + occurred.
+ type: object + required: + - RestraintDebriefing + properties: + RestraintDebriefing: + type: array + items: + description:A debriefing that took place after the + physical restraint incident occurred. A + debriefing can be with a staff member or + with the student and their + parent/caregiver.
+ type: object + properties: + DebriefingDate: + type: string + format: date + description:The date the debriefing about the + use of physical restraint on the + student occurred.
+ DebriefingTime: + description:The time the debriefing about the + use of physical restraint on the + student occurred.
+ Findings: + type: string + description:Free text outlining the findings of + the debriefing in the use of physical + restraint on the student.
+ NextStepsActions: + type: string + description:Free text about the next steps + and/or actions that will be taken in + as a result of the debriefing on the + use of physical restraint on the + student.
+ ParentCaregiverComment: + type: string + description:Parent/caregiver comments made + about the use physical restraint on + the student.
+ StudentComment: + type: string + description:Student comments made about the use + physical restraint on the them.
+ DebriefingType: + type: string + title: Restraint Debriefing Type + description: >- +Code set denoting the type of + debriefing that occurred, e.g. staff, + or student and parent/caregiver.
+A list of the people that attended + the debriefing.
+ type: object + required: + - Attendee + properties: + Attendee: + type: array + items: + $ref: "#/paths/~1StudentPhysicalRestr\ + aints/get/responses/200/content\ + /application~1json/schema/prope\ + rties/StudentPhysicalRestraints\ + /properties/StudentPhysicalRest\ + raint/items/properties/Provider" + RestraintQuestionList: + description:A list of questions and their answers about + the physical restraint incident.
+ type: object + required: + - RestraintQuestion + properties: + RestraintQuestion: + type: array + items: + description:A question and it's answer about the + physical restraint incident that occurred. + Additional free text information to + support the answer may also be + supplied.
+ type: object + required: + - Question + properties: + Question: + type: string + title: Restraint Question + description: >- +Code set denoting a question that + was asked about a student physical + restraint incident.
A free text description providing + additional information about the + question if required.
+ description:Provides information about an incident where + staff members or other parties used physical + restraint on a child.
+ x-accessControl: + ? create + ? read + ? update + ? delete + ? aggregate + application/xml: + schema: + type: object + properties: + StudentPhysicalRestraints: + type: object + description: A List of StudentPhysicalRestraint objects + properties: + StudentPhysicalRestraint: + type: array + items: + $ref: "#/paths/~1StudentPhysicalRestraints/get/responses/\ + 200/content/application~1json/schema/properties/Stu\ + dentPhysicalRestraints/properties/StudentPhysicalRe\ + straint/items" + default: + $ref: "#/paths/~1ScheduleTerms/get/responses/default" + "/StudentPhysicalRestraints/{StudentPhysicalRestraintRefId}": + post: + tags: + - StudentPhysicalRestraint + summary: Default operation to create a single StudentPhysicalRestraint + parameters: + - name: StudentPhysicalRestraintRefId + in: path + description:A GUID that identifies an instance of this object.
+ required: true + schema: + type: string + operationId: createStudentPhysicalRestraint + requestBody: + description: CRUD operation on StudentPhysicalRestraint + content: + application/json: + schema: + type: object + properties: + StudentPhysicalRestraint: + $ref: "#/paths/~1StudentPhysicalRestraints/get/responses/200/cont\ + ent/application~1json/schema/properties/StudentPhysicalRest\ + raints/properties/StudentPhysicalRestraint/items" + application/xml: + schema: + type: object + properties: + StudentPhysicalRestraint: + $ref: "#/paths/~1StudentPhysicalRestraints/get/responses/200/cont\ + ent/application~1json/schema/properties/StudentPhysicalRest\ + raints/properties/StudentPhysicalRestraint/items" + responses: + "200": + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/post/responses/200" + default: + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/post/responses/de\ + fault" + put: + tags: + - StudentPhysicalRestraint + summary: Default operation to update a single StudentPhysicalRestraint + parameters: + - name: StudentPhysicalRestraintRefId + in: path + description:A GUID that identifies an instance of this object.
+ required: true + schema: + type: string + operationId: updateStudentPhysicalRestraint + requestBody: + description: CRUD operation on StudentPhysicalRestraint + content: + application/json: + schema: + type: object + properties: + StudentPhysicalRestraint: + type: object + properties: + StudentPhysicalRestraintRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-\ + 9]{4}-[a-fA-F0-9]{12}" + StudentPhysicalRestraintLocalId: + description:This is a common element used to define the locally + assigned identifier associated with an entity.
+ type: string + Provider: + description:A reference to another SIF Data Object
+ type: object + properties: + RefId: + $ref: "#/paths/~1StudentPhysicalRestraints~1%7BStudentPhy\ + sicalRestraintRefId%7D/put/requestBody/content/appl\ + ication~1json/schema/properties/StudentPhysicalRest\ + raint/properties/StudentPhysicalRestraintRefId" + LocalId: + $ref: "#/paths/~1StudentPhysicalRestraints~1%7BStudentPhy\ + sicalRestraintRefId%7D/put/requestBody/content/appl\ + ication~1json/schema/properties/StudentPhysicalRest\ + raint/properties/StudentPhysicalRestraintLocalId" + Name: + type: string + description:The normal descriptive name of the referenced + object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject names, to + be included in Object References
Free text description on why the physical restraint + of the student was considered necessary.
+ FirstTimeStudentRestrained: + type: string + title: Yes Or No Category + description: >- +A reusable code set for yes, no, unknown and not + provided values.
The date the physical restraint was used on the + student.
+ LocationDescription: + type: string + description:Free text description of the location the physical + restraint of the student occurred in.
+ OtherComment: + type: string + description:Any other comments on the physical restraint + incident.
+ ReportedDate: + type: string + format: date + description:The date the use of physical restraint on the student + was report.
+ RestraintEndedTime: + description:The time the physical restraint stopped being + used.
+ RestraintStartedTime: + description:The time the physical restraint started being + used.
+ RestraintReason: + type: string + title: Restraint Reason + description: >- +A code set denoting the reason physical restraint was + used on the student.
Year Level defines the values that are valid for + describing Funding Year Level and Current Year Level for + a student enrolment.
Current Year Level indicates + the year level of the student’s class cohort and the + level at which the student spends most of their time at + school. While a student may be enrolled in subjects at + varying instructional year levels, in relation to the + student enrolment this value represents the year level + at which the student is considered to be predominantly + taught.
Funding Year Level measures the actual + number of years that the student has attended a school. + It provides the Ministry with a method of counting + students for funding purposes which is independent of + the way schools are organised or the particular + programme of study that a student may undertake. Funding + Year Level for most students is based on the date they + first started school.
School Year Level is used + to indicate the instructional year levels offered by a + school, i.e. those years for which student enrolments + may be accepted.
Describes the Location of any associated documents + kept in relation to this physical restraint + incident.
+ type: object + properties: + Document: + type: array + items: + $ref: "#/paths/~1StudentPhysicalRestraints~1%7BStudentP\ + hysicalRestraintRefId%7D/put/requestBody/content/\ + application~1json/schema/properties/StudentPhysic\ + alRestraint/properties/Provider" + RestraintWitnessList: + description:A list of the people that witnessed the physical + constraint.
+ type: object + properties: + Witness: + type: array + items: + $ref: "#/paths/~1StudentPhysicalRestraints~1%7BStudentP\ + hysicalRestraintRefId%7D/put/requestBody/content/\ + application~1json/schema/properties/StudentPhysic\ + alRestraint/properties/Provider" + RestraintAdministeredByList: + description:A list of the people who administered the physical + restraint to the student.
+ type: object + properties: + RestraintAdministeredBy: + type: array + items: + description:The person who administered the physical + restraint to the student.
+ type: object + properties: + AdministeredBy: + $ref: "#/paths/~1StudentPhysicalRestraints~1%7BStud\ + entPhysicalRestraintRefId%7D/put/requestBody/\ + content/application~1json/schema/properties/S\ + tudentPhysicalRestraint/properties/Provider" + SafePhysicalRestraintTraining: + $ref: "#/paths/~1StudentPhysicalRestraints~1%7BStud\ + entPhysicalRestraintRefId%7D/put/requestBody/\ + content/application~1json/schema/properties/S\ + tudentPhysicalRestraint/properties/FirstTimeS\ + tudentRestrained" + TrainingDescription: + type: string + description:Free text providing additional information + about any training the person has had on the + safe use pf physical restraint.
+ Role: + type: string + title: Restraint Administered By Role + description: >- +Code set denoting the role of the person + who administered the physical restraint to the + student.
The list of the people and/or property that the + student, who was restrained, was directing their + behaviour at.
+ type: object + properties: + BehaviourDirectedAt: + type: array + items: + description:The person and/or piece of property that the + student, who was restrained, was directing their + behaviour at.
+ type: object + properties: + DirectedAt: + $ref: "#/paths/~1StudentPhysicalRestraints~1%7BStud\ + entPhysicalRestraintRefId%7D/put/requestBody/\ + content/application~1json/schema/properties/S\ + tudentPhysicalRestraint/properties/Provider" + BehaviourDescription: + type: string + description:Free text describing the behaviour the + student showed towards a person of piece of + property.
+ DirectedAtType: + type: string + title: Behaviour Directed At Type + description: >- +Code set denoting type of object or person + the student was directing their behaviour at, + e.g. Staff Member, Student, Desk, Chair.
+A list of the reflections made by the staff members + who applied the physical restraint.
+ type: object + properties: + StaffReflection: + type: array + items: + description:The reflections performed by the staff member + who applied the physical restraint to the + student.
+ type: object + properties: + ReflectionDate: + type: string + format: date + description:The date the staff member performed their + reflection on the use of physical restraint on + the student.
+ WitnessedBy: + $ref: "#/paths/~1StudentPhysicalRestraints~1%7BStud\ + entPhysicalRestraintRefId%7D/put/requestBody/\ + content/application~1json/schema/properties/S\ + tudentPhysicalRestraint/properties/Provider" + Staff: + $ref: "#/paths/~1StudentPhysicalRestraints~1%7BStud\ + entPhysicalRestraintRefId%7D/put/requestBody/\ + content/application~1json/schema/properties/S\ + tudentPhysicalRestraint/properties/Provider" + ReflectionList: + description:A list of the reflections the staff member + performed.
+ type: object + properties: + Reflection: + type: array + items: + description:A reflection that a staff member + performed about the physical restraint + incident.
+ type: object + properties: + ReflectionDescription: + type: string + description:Free text outlining the staff + members thoughts on a type of + reflection.
+ Type: + type: string + title: Staff Restraint Reflection Type + description: >- +Code set denoting the type of + reflection that the staff member + performed.
A list of the debriefings that took place after the + physical restraint incident occurred.
+ type: object + properties: + RestraintDebriefing: + type: array + items: + description:A debriefing that took place after the physical + restraint incident occurred. A debriefing can be + with a staff member or with the student and their + parent/caregiver.
+ type: object + properties: + DebriefingDate: + type: string + format: date + description:The date the debriefing about the use of + physical restraint on the student + occurred.
+ DebriefingTime: + description:The time the debriefing about the use of + physical restraint on the student + occurred.
+ Findings: + type: string + description:Free text outlining the findings of the + debriefing in the use of physical restraint on + the student.
+ NextStepsActions: + type: string + description:Free text about the next steps and/or + actions that will be taken in as a result of + the debriefing on the use of physical + restraint on the student.
+ ParentCaregiverComment: + type: string + description:Parent/caregiver comments made about the + use physical restraint on the student.
+ StudentComment: + type: string + description:Student comments made about the use + physical restraint on the them.
+ DebriefingType: + type: string + title: Restraint Debriefing Type + description: >- +Code set denoting the type of debriefing + that occurred, e.g. staff, or student and + parent/caregiver.
A list of the people that attended the + debriefing.
+ type: object + properties: + Attendee: + type: array + items: + $ref: "#/paths/~1StudentPhysicalRestraints~1%\ + 7BStudentPhysicalRestraintRefId%7D/put/\ + requestBody/content/application~1json/s\ + chema/properties/StudentPhysicalRestrai\ + nt/properties/Provider" + RestraintQuestionList: + description:A list of questions and their answers about the + physical restraint incident.
+ type: object + properties: + RestraintQuestion: + type: array + items: + description:A question and it's answer about the physical + restraint incident that occurred. Additional free + text information to support the answer may also be + supplied.
+ type: object + properties: + Question: + type: string + title: Restraint Question + description: >- +Code set denoting a question that was asked + about a student physical restraint + incident.
A free text description providing + additional information about the question if + required.
+ description:Provides information about an incident where staff + members or other parties used physical restraint on a child. +
+ x-accessControl: + ? create + ? read + ? update + ? delete + ? aggregate + application/xml: + schema: + type: object + properties: + StudentPhysicalRestraint: + $ref: "#/paths/~1StudentPhysicalRestraints~1%7BStudentPhysicalRes\ + traintRefId%7D/put/requestBody/content/application~1json/sc\ + hema/properties/StudentPhysicalRestraint" + responses: + "200": + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/put/responses/200" + default: + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/put/responses/def\ + ault" + get: + tags: + - StudentPhysicalRestraint + summary: Default operation to get a single StudentPhysicalRestraint + parameters: + - name: StudentPhysicalRestraintRefId + in: path + description:A GUID that identifies an instance of this object.
+ required: true + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + StudentPhysicalRestraint: + $ref: "#/paths/~1StudentPhysicalRestraints/get/responses/200/co\ + ntent/application~1json/schema/properties/StudentPhysical\ + Restraints/properties/StudentPhysicalRestraint/items" + application/xml: + schema: + type: object + properties: + StudentPhysicalRestraint: + $ref: "#/paths/~1StudentPhysicalRestraints/get/responses/200/co\ + ntent/application~1json/schema/properties/StudentPhysical\ + Restraints/properties/StudentPhysicalRestraint/items" + default: + $ref: "#/paths/~1ScheduleTerms/get/responses/default" + delete: + tags: + - StudentPhysicalRestraint + summary: Default operation to delete a single StudentPhysicalRestraint + parameters: + - name: StudentPhysicalRestraintRefId + in: path + description:A GUID that identifies an instance of this object.
+ required: true + schema: + type: string + responses: + "200": + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + 200" + default: + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + default" + /StudentVoices: + get: + tags: + - StudentVoice + summary: Default operation to get a list of all available StudentVoices + description: Search the set of available StudentVoice entries, according to the + search criteria in the URL parameters. Returns the first 20 objects + located; with SIF defined navigation headers, indicating how to retrieve + subsequent sets of 20 objects. + parameters: + - name: LocalId + in: path + description: Search for object by LocalId, within the context of the organisation + represented by the ZoneId of the request. + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + StudentVoices: + type: object + description: A List of StudentVoice objects + properties: + StudentVoice: + type: array + items: + required: + - Provider + - Student + type: object + properties: + StudentVoiceRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[\ + a-fA-F0-9]{4}-[a-fA-F0-9]{12}" + StudentVoiceLocalId: + description:This is a common element used to define the + locally assigned identifier associated with an + entity.
+ type: string + Student: + description:A reference to another SIF Data Object
+ type: object + required: + - ObjectType + properties: + RefId: + $ref: "#/paths/~1StudentVoices/get/responses/200/\ + content/application~1json/schema/properties\ + /StudentVoices/properties/StudentVoice/item\ + s/properties/StudentVoiceRefId" + LocalId: + $ref: "#/paths/~1StudentVoices/get/responses/200/\ + content/application~1json/schema/properties\ + /StudentVoices/properties/StudentVoice/item\ + s/properties/StudentVoiceLocalId" + Name: + type: string + description:The normal descriptive name of the + referenced object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject + names, to be included in Object + References
Extra notes about the student, and their + voice
+ StudentInterestList: + description:A list of the diffent interests the student + has expressed.
+ type: object + required: + - StudentInterest + properties: + StudentInterest: + type: array + items: + description:Object recording an interest the + student has expressed.
+ type: object + properties: + InterestRecordedDate: + type: string + format: date + description:The date the Student's interest was + recorded.
+ InterestDescription: + type: string + description:A description of the interest the + student wants to achieve
+ InterestName: + type: string + description:The name of the interest the + student has expressed
+ InterestType: + type: string + title: Student Interest Type + description: >- +Standard codes denoting the type of + interest the student likes to do.
+Codes denoting Subject Areas + defined by the NZ Curriculum and Te + Marautanga o Aotearoa.
A list of the diffent social goals the + student has expressed.
+ type: object + required: + - SocialGoal + properties: + SocialGoal: + type: array + items: + description:Base complex type defining elements + common to all flavours of StudentGoal.
+ type: object + properties: + GoalRecordedDate: + type: string + format: date + description:The date the Student's goal was + recorded.
+ GoalAchievedDate: + type: string + format: date + description:The date the Student achieved their + goal.
+ GoalDescription: + type: string + description:A description of the goal the + student wants to achieve
+ GoalName: + type: string + description:The name of the goal the student + wants to achieve
+ AcademicGoalList: + description:A list of the diffent academic goals the + student has expressed.
+ type: object + required: + - AcademicGoal + properties: + AcademicGoal: + type: array + items: + description:Defining elements of the Academic + flavour of student goal.
+ type: object + properties: + SubjectArea: + $ref: "#/paths/~1StudentVoices/get/response\ + s/200/content/application~1json/schem\ + a/properties/StudentVoices/properties\ + /StudentVoice/items/properties/Studen\ + tInterestList/properties/StudentInter\ + est/items/properties/SubjectArea" + CareerGoalList: + description:A list of the diffent career goals the + student has expressed.
+ type: object + required: + - CareerGoal + properties: + CareerGoal: + type: array + items: + description:Base complex type defining elements + common to all flavours of StudentGoal.
+ type: object + properties: + GoalRecordedDate: + type: string + format: date + description:The date the Student's goal was + recorded.
+ GoalAchievedDate: + type: string + format: date + description:The date the Student achieved their + goal.
+ GoalDescription: + type: string + description:A description of the goal the + student wants to achieve
+ GoalName: + type: string + description:The name of the goal the student + wants to achieve
+ description: A record of a student's interests as well as their + social, academic and academic goals. + x-accessControl: + ? create + ? read + ? update + ? delete + ? aggregate + example: + StudentVoices: + StudentVoice: + - StudentVoiceRefId: 7C834EA9-EDA1-2090-347F-83297E1C290C + StudentVoiceLocalId: 2234523 + Student: + RefId: 5c33548a-1141-40eb-94d3-9267a2258435 + StudentVoiceNote: Timothy doesn't like talking about setting goals. These + goals have been gathered through observation. + StudentInterestList: + StudentInterest: + InterestRecordedDate: 2018-11-30 + InterestDescription: Timothy spends most lunchtimes playing with the + piano, or watching others playing music + InterestName: Music/Piano + InterestType: MUS + SubjectArea: MUSP + SocialGoalList: + SocialGoal: + GoalRecordedDate: 2018-11-30 + GoalDescription: Timothy would like to have more friends to play with + at lunchtime. + GoalName: Have more friends + AcademicGoalList: + AcademicGoal: + GoalRecordedDate: 2018-11-30 + GoalDescription: Timothy wants to excel at Te Reo Māori + GoalName: Excel Te Reo + SubjectArea: MAOR + CareerGoalList: + CareerGoal: + GoalRecordedDate: 2018-11-30 + GoalDescription: Timothy would like to be a Marine Biologist, or Deep + Sea Diver + GoalName: Marine Biologist + application/xml: + schema: + type: object + properties: + StudentVoices: + type: object + description: A List of StudentVoice objects + properties: + StudentVoice: + type: array + items: + $ref: "#/paths/~1StudentVoices/get/responses/200/content/\ + application~1json/schema/properties/StudentVoices/p\ + roperties/StudentVoice/items" + example: >- +This is a common element used to define the + locally assigned identifier associated with an + entity.
+ type: string + AreaOfNeed: + type: string + title: Wellbeing Characteristic Category + description: >- +Standard codes denoting the second level + category of the Wellbeing Characteristic.
+Standard codes denoting the third level + category of the Wellbeing Characteristic.
+Standard codes denoting the learning support + intervention type, e.g. ESOL, First STEPs, + MST.
Code set denoting the target audience of the + learning support intervention for the area of + need.
Code set denoting the resource that is + required to support the learning support + intervention in addressing the area of need.
+Free text description describing the + resources required for the intervention. Only + populated if a Resource of 'Other' is + selected.
+ FundedBy: + type: string + title: Learning Support Funded By + description: >- +Code set denoting who can fund a learning + support intervention, i.e. who provides + co-ordination, manages the contents etc. for the + intervention.
Free text description of who is funding the + intervention. Only populated if a Funded By of + 'Other' is selected.
+ ProvidedBy: + type: string + title: Learning Support Provided By + description: >- +Code set denoting who can provide a learning + support intervention, e.g. who provides + co-ordination, manages the contents etc. for the + intervention.
Free text description of who is providing the + intervention. Only populated if a Provided By of + 'Other' is selected.
+ DeliveredByDesc: + type: string + description:Free text description of who is delivered the + intervention on behalf of the Provider.
+ PreRequisiteDesc: + type: string + description:Free text description of any pre-requisites + required before the intervention can be + implemented.
+ InterventionStatus: + type: string + title: Learning Support Intervention Status + description: >- +Code set denoting the status of a learning + support intervention, e.g. In Development, + Active.
Learning Support Needs are grouped by similarity. + The Learning Support Directory maps those groups to + Learning Support Interventions so when a Learning + Support Need is identified for the Student only + applicable Interventions for the group it belongs to + are presented to the user. It also holds additional + information about the Learning Support + Interventions, e.g. Description, Funded By, Provided + by.
+ x-accessControl: + create: + - 2401 + read: + - 2401 + update: + - 2401 + delete: + - 2401 + aggregate: [] + application/xml: + schema: + type: object + properties: + LearningSupportRegisterDirectorys: + type: object + description: A List of LearningSupportRegisterDirectory objects + properties: + LearningSupportRegisterDirectory: + type: array + items: + $ref: "#/paths/~1LearningSupportRegisterDirectorys/get/re\ + sponses/200/content/application~1json/schema/proper\ + ties/LearningSupportRegisterDirectorys/properties/L\ + earningSupportRegisterDirectory/items" + default: + $ref: "#/paths/~1ScheduleTerms/get/responses/default" + "/LearningSupportRegisterDirectorys/{LearningSupportRegisterDirectoryRefId}": + post: + tags: + - LearningSupportRegisterDirectory + summary: Default operation to create a single LearningSupportRegisterDirectory + parameters: + - name: LearningSupportRegisterDirectoryRefId + in: path + description:Unique identifier (GUID) that uniquely identifies this Learning + Support Register Directory record.
+ required: true + schema: + type: string + operationId: createLearningSupportRegisterDirectory + requestBody: + description: CRUD operation on LearningSupportRegisterDirectory + content: + application/json: + schema: + type: object + properties: + LearningSupportRegisterDirectory: + $ref: "#/paths/~1LearningSupportRegisterDirectorys/get/responses/\ + 200/content/application~1json/schema/properties/LearningSup\ + portRegisterDirectorys/properties/LearningSupportRegisterDi\ + rectory/items" + application/xml: + schema: + type: object + properties: + LearningSupportRegisterDirectory: + $ref: "#/paths/~1LearningSupportRegisterDirectorys/get/responses/\ + 200/content/application~1json/schema/properties/LearningSup\ + portRegisterDirectorys/properties/LearningSupportRegisterDi\ + rectory/items" + responses: + "200": + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/post/responses/200" + default: + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/post/responses/de\ + fault" + put: + tags: + - LearningSupportRegisterDirectory + summary: Default operation to update a single LearningSupportRegisterDirectory + parameters: + - name: LearningSupportRegisterDirectoryRefId + in: path + description:Unique identifier (GUID) that uniquely identifies this Learning + Support Register Directory record.
+ required: true + schema: + type: string + operationId: updateLearningSupportRegisterDirectory + requestBody: + description: CRUD operation on LearningSupportRegisterDirectory + content: + application/json: + schema: + type: object + properties: + LearningSupportRegisterDirectory: + type: object + properties: + LearningSupportRegisterDirectoryRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-\ + 9]{4}-[a-fA-F0-9]{12}" + LearningSupportRegisterDirectoryLocalId: + description:This is a common element used to define the locally + assigned identifier associated with an entity.
+ type: string + AreaOfNeed: + type: string + title: Wellbeing Characteristic Category + description: >- +Standard codes denoting the second level category of + the Wellbeing Characteristic.
Standard codes denoting the third level category of + the Wellbeing Characteristic.
Standard codes denoting the learning support + intervention type, e.g. ESOL, First STEPs, MST.
Code set denoting the target audience of the learning + support intervention for the area of need.
Code set denoting the resource that is required to + support the learning support intervention in addressing + the area of need.
Free text description describing the resources + required for the intervention. Only populated if a + Resource of 'Other' is selected.
+ FundedBy: + type: string + title: Learning Support Funded By + description: >- +Code set denoting who can fund a learning support + intervention, i.e. who provides co-ordination, manages + the contents etc. for the intervention.
Free text description of who is funding the + intervention. Only populated if a Funded By of 'Other' + is selected.
+ ProvidedBy: + type: string + title: Learning Support Provided By + description: >- +Code set denoting who can provide a learning support + intervention, e.g. who provides co-ordination, manages + the contents etc. for the intervention.
Free text description of who is providing the + intervention. Only populated if a Provided By of 'Other' + is selected.
+ DeliveredByDesc: + type: string + description:Free text description of who is delivered the + intervention on behalf of the Provider.
+ PreRequisiteDesc: + type: string + description:Free text description of any pre-requisites required + before the intervention can be implemented.
+ InterventionStatus: + type: string + title: Learning Support Intervention Status + description: >- +Code set denoting the status of a learning support + intervention, e.g. In Development, Active.
Learning Support Needs are grouped by similarity. The + Learning Support Directory maps those groups to Learning + Support Interventions so when a Learning Support Need is + identified for the Student only applicable Interventions for + the group it belongs to are presented to the user. It also + holds additional information about the Learning Support + Interventions, e.g. Description, Funded By, Provided by. +
+ x-accessControl: + create: + - 2401 + read: + - 2401 + update: + - 2401 + delete: + - 2401 + aggregate: [] + application/xml: + schema: + type: object + properties: + LearningSupportRegisterDirectory: + $ref: "#/paths/~1LearningSupportRegisterDirectorys~1%7BLearningSu\ + pportRegisterDirectoryRefId%7D/put/requestBody/content/appl\ + ication~1json/schema/properties/LearningSupportRegisterDire\ + ctory" + responses: + "200": + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/put/responses/200" + default: + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/put/responses/def\ + ault" + get: + tags: + - LearningSupportRegisterDirectory + summary: Default operation to get a single LearningSupportRegisterDirectory + parameters: + - name: LearningSupportRegisterDirectoryRefId + in: path + description:Unique identifier (GUID) that uniquely identifies this Learning + Support Register Directory record.
+ required: true + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + LearningSupportRegisterDirectory: + $ref: "#/paths/~1LearningSupportRegisterDirectorys/get/response\ + s/200/content/application~1json/schema/properties/Learnin\ + gSupportRegisterDirectorys/properties/LearningSupportRegi\ + sterDirectory/items" + application/xml: + schema: + type: object + properties: + LearningSupportRegisterDirectory: + $ref: "#/paths/~1LearningSupportRegisterDirectorys/get/response\ + s/200/content/application~1json/schema/properties/Learnin\ + gSupportRegisterDirectorys/properties/LearningSupportRegi\ + sterDirectory/items" + default: + $ref: "#/paths/~1ScheduleTerms/get/responses/default" + delete: + tags: + - LearningSupportRegisterDirectory + summary: Default operation to delete a single LearningSupportRegisterDirectory + parameters: + - name: LearningSupportRegisterDirectoryRefId + in: path + description:Unique identifier (GUID) that uniquely identifies this Learning + Support Register Directory record.
+ required: true + schema: + type: string + responses: + "200": + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + 200" + default: + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + default" + /StudentLearningSupportParticipations: + get: + tags: + - StudentLearningSupportParticipation + summary: Default operation to get a list of all available + StudentLearningSupportParticipations + description: Search the set of available StudentLearningSupportParticipations, + according to the search criteria in the URL parameters. Returns the + first 20 objects located; with SIF defined navigation headers, + indicating how to retrieve subsequent sets of 20 objects. + parameters: + - name: LocalId + in: path + description: Search for object by LocalId, within the context of the organisation + represented by the ZoneId of the request. + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + StudentLearningSupportParticipations: + type: object + description: A List of StudentLearningSupportParticipation objects + properties: + StudentLearningSupportParticipation: + type: array + items: + required: + - Student + type: object + properties: + StudentLearningSupportParticipationRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[\ + a-fA-F0-9]{4}-[a-fA-F0-9]{12}" + StudentLearningSupportParticipationLocalId: + description:This is a common element used to define the + locally assigned identifier associated with an + entity.
+ type: string + Student: + description:A reference to another SIF Data Object
+ type: object + required: + - ObjectType + properties: + RefId: + $ref: "#/paths/~1StudentLearningSupportParticipat\ + ions/get/responses/200/content/application~\ + 1json/schema/properties/StudentLearningSupp\ + ortParticipations/properties/StudentLearnin\ + gSupportParticipation/items/properties/Stud\ + entLearningSupportParticipationRefId" + LocalId: + $ref: "#/paths/~1StudentLearningSupportParticipat\ + ions/get/responses/200/content/application~\ + 1json/schema/properties/StudentLearningSupp\ + ortParticipations/properties/StudentLearnin\ + gSupportParticipation/items/properties/Stud\ + entLearningSupportParticipationLocalId" + Name: + type: string + description:The normal descriptive name of the + referenced object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject + names, to be included in Object + References
The date the student's participation in the + learning support intervention is considered + complete.
+ FundApprovedDate: + type: string + format: date + description:The date the learning support participation + record for the student was created in the source + system.
+ RequestSentToAgencyDate: + type: string + format: date + description:The date the learning support participation + request was sent to the agency providing the + intervention.
+ ParticipationStartDate: + type: string + format: date + description:The date the student started participating in + the learning support.
+ ParticipationEndDate: + type: string + format: date + description:The date the student stopped participating in + the learning support.
+ ParticipationNote: + type: string + description:Free text note pertaining to the student's + learning support participation.
+ PermissionEndDate: + type: string + format: date + description:The date the permission for learning support + ended or was revoked, if provided, by the + student's parent/caregiver.
+ PermissionStartDate: + type: string + format: date + description:The date the permission for learning support + was provided or was declined by the student's + parent/caregiver.
+ PermissionToParticipate: + type: string + title: Yes Or No Category + description: >- +A reusable code set for yes, no, unknown and + not provided values.
A list of wellbeing characteristics that + require learning support.
+ type: object + required: + - WellbeingCharacteristic + properties: + WellbeingCharacteristic: + type: array + items: + $ref: "#/paths/~1StudentLearningSupportParticip\ + ations/get/responses/200/content/applicat\ + ion~1json/schema/properties/StudentLearni\ + ngSupportParticipations/properties/Studen\ + tLearningSupportParticipation/items/prope\ + rties/Student" + LearningSupportIntervention: + type: string + title: Learning Support Intervention + description: >- +Standard codes denoting the learning support + intervention type, e.g. ESOL, First STEPs, + MST.
Code set denoting the possible outcomes of a + student's participation on a learning support + intervention.
Standard codes denoting the type of learning + support, e.g. Fund, Programme, Service.
Free text description of the learning support + type that is being provided to the student. Only + populated if a Learning of Support Type of + 'Other' is selected.
+ ProvidedBy: + type: string + title: Learning Support Provided By + description: >- +Code set denoting who can provide a learning + support intervention, e.g. who provides + co-ordination, manages the contents etc. for the + intervention.
Code set denoting the status of the learning + support participation.
A list of reviews made in regards to the + student's learning support participation.
+ type: object + required: + - Review + properties: + Review: + type: array + items: + description:A review made in regards to the + student's learning support + participation.
+ type: object + required: + - ReviewDate + - ReviewNote + properties: + ReviewDate: + type: string + format: date + description:The date the review was made of the + student's learning support + participation.
+ ReviewNote: + type: string + description:Free text comment about a review + that was made of the student's + learning support participation.
+ DocumentList: + description:A list of the documents associated the + student's learning support participation.
+ type: object + required: + - Document + properties: + Document: + type: array + items: + $ref: "#/paths/~1StudentLearningSupportParticip\ + ations/get/responses/200/content/applicat\ + ion~1json/schema/properties/StudentLearni\ + ngSupportParticipations/properties/Studen\ + tLearningSupportParticipation/items/prope\ + rties/Student" + CreatedBy: + $ref: "#/paths/~1StudentLearningSupportParticipations\ + /get/responses/200/content/application~1json/sc\ + hema/properties/StudentLearningSupportParticipa\ + tions/properties/StudentLearningSupportParticip\ + ation/items/properties/Student" + LastUpdatedBy: + $ref: "#/paths/~1StudentLearningSupportParticipations\ + /get/responses/200/content/application~1json/sc\ + hema/properties/StudentLearningSupportParticipa\ + tions/properties/StudentLearningSupportParticip\ + ation/items/properties/Student" + CreatedDate: + type: string + format: date + description:The date the learning support participation + record for the student was created in the source + system.
+ LastUpdatedDate: + type: string + format: date + description:The date the learning support participation + record for the student was last updated in the + source system.
+ description:Contains information pertaining to a student's + participation in learning support.
+ x-accessControl: + create: + - 1001 + - 1306 + - 2103 + - 2401 + - 2403 + read: + - 1001 + - 1306 + - 2101 + - 2103 + - 2401 + - 2403 + update: + - 1001 + - 1306 + - 2103 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: [] + example: + StudentLearningSupportParticipations: + StudentLearningSupportParticipation: + - StudentLearningSupportParticipationRefId: 2FFB63B4-CFEF-4820-8501-E7D1E54555CB + Student: + RefId: CA285746-359D-7510-1A8C-36432A901A16 + application/xml: + schema: + type: object + properties: + StudentLearningSupportParticipations: + type: object + description: A List of StudentLearningSupportParticipation objects + properties: + StudentLearningSupportParticipation: + type: array + items: + $ref: "#/paths/~1StudentLearningSupportParticipations/get\ + /responses/200/content/application~1json/schema/pro\ + perties/StudentLearningSupportParticipations/proper\ + ties/StudentLearningSupportParticipation/items" + example: >- +The ID (GUID) assigned to uniquely identify this Student Learning + Support Participation record.
+ required: true + schema: + type: string + operationId: createStudentLearningSupportParticipation + requestBody: + description: CRUD operation on StudentLearningSupportParticipation + content: + application/json: + schema: + type: object + properties: + StudentLearningSupportParticipation: + $ref: "#/paths/~1StudentLearningSupportParticipations/get/respons\ + es/200/content/application~1json/schema/properties/StudentL\ + earningSupportParticipations/properties/StudentLearningSupp\ + ortParticipation/items" + example: + StudentLearningSupportParticipation: + StudentLearningSupportParticipationRefId: 2FFB63B4-CFEF-4820-8501-E7D1E54555CB + Student: + RefId: CA285746-359D-7510-1A8C-36432A901A16 + application/xml: + schema: + type: object + properties: + StudentLearningSupportParticipation: + $ref: "#/paths/~1StudentLearningSupportParticipations/get/respons\ + es/200/content/application~1json/schema/properties/StudentL\ + earningSupportParticipations/properties/StudentLearningSupp\ + ortParticipation/items" + example: >- +The ID (GUID) assigned to uniquely identify this Student Learning + Support Participation record.
+ required: true + schema: + type: string + operationId: updateStudentLearningSupportParticipation + requestBody: + description: CRUD operation on StudentLearningSupportParticipation + content: + application/json: + schema: + type: object + properties: + StudentLearningSupportParticipation: + type: object + properties: + StudentLearningSupportParticipationRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-\ + 9]{4}-[a-fA-F0-9]{12}" + StudentLearningSupportParticipationLocalId: + description:This is a common element used to define the locally + assigned identifier associated with an entity.
+ type: string + Student: + description:A reference to another SIF Data Object
+ type: object + properties: + RefId: + $ref: "#/paths/~1StudentLearningSupportParticipations~1%7\ + BStudentLearningSupportParticipationRefId%7D/put/re\ + questBody/content/application~1json/schema/properti\ + es/StudentLearningSupportParticipation/properties/S\ + tudentLearningSupportParticipationRefId" + LocalId: + $ref: "#/paths/~1StudentLearningSupportParticipations~1%7\ + BStudentLearningSupportParticipationRefId%7D/put/re\ + questBody/content/application~1json/schema/properti\ + es/StudentLearningSupportParticipation/properties/S\ + tudentLearningSupportParticipationLocalId" + Name: + type: string + description:The normal descriptive name of the referenced + object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject names, to + be included in Object References
The date the student's participation in the learning + support intervention is considered complete.
+ FundApprovedDate: + type: string + format: date + description:The date the learning support participation record + for the student was created in the source system.
+ RequestSentToAgencyDate: + type: string + format: date + description:The date the learning support participation request + was sent to the agency providing the intervention.
+ ParticipationStartDate: + type: string + format: date + description:The date the student started participating in the + learning support.
+ ParticipationEndDate: + type: string + format: date + description:The date the student stopped participating in the + learning support.
+ ParticipationNote: + type: string + description:Free text note pertaining to the student's learning + support participation.
+ PermissionEndDate: + type: string + format: date + description:The date the permission for learning support ended or + was revoked, if provided, by the student's + parent/caregiver.
+ PermissionStartDate: + type: string + format: date + description:The date the permission for learning support was + provided or was declined by the student's + parent/caregiver.
+ PermissionToParticipate: + type: string + title: Yes Or No Category + description: >- +A reusable code set for yes, no, unknown and not + provided values.
A list of wellbeing characteristics that require + learning support.
+ type: object + properties: + WellbeingCharacteristic: + type: array + items: + $ref: "#/paths/~1StudentLearningSupportParticipations~1\ + %7BStudentLearningSupportParticipationRefId%7D/pu\ + t/requestBody/content/application~1json/schema/pr\ + operties/StudentLearningSupportParticipation/prop\ + erties/Student" + LearningSupportIntervention: + type: string + title: Learning Support Intervention + description: >- +Standard codes denoting the learning support + intervention type, e.g. ESOL, First STEPs, MST.
Code set denoting the possible outcomes of a + student's participation on a learning support + intervention.
Standard codes denoting the type of learning support, + e.g. Fund, Programme, Service.
Free text description of the learning support type + that is being provided to the student. Only populated if + a Learning of Support Type of 'Other' is selected.
+ ProvidedBy: + type: string + title: Learning Support Provided By + description: >- +Code set denoting who can provide a learning support + intervention, e.g. who provides co-ordination, manages + the contents etc. for the intervention.
Code set denoting the status of the learning support + participation.
A list of reviews made in regards to the student's + learning support participation.
+ type: object + properties: + Review: + type: array + items: + description:A review made in regards to the student's + learning support participation.
+ type: object + properties: + ReviewDate: + type: string + format: date + description:The date the review was made of the + student's learning support participation.
+ ReviewNote: + type: string + description:Free text comment about a review that was + made of the student's learning support + participation.
+ DocumentList: + description:A list of the documents associated the student's + learning support participation.
+ type: object + properties: + Document: + type: array + items: + $ref: "#/paths/~1StudentLearningSupportParticipations~1\ + %7BStudentLearningSupportParticipationRefId%7D/pu\ + t/requestBody/content/application~1json/schema/pr\ + operties/StudentLearningSupportParticipation/prop\ + erties/Student" + CreatedBy: + $ref: "#/paths/~1StudentLearningSupportParticipations~1%7BStu\ + dentLearningSupportParticipationRefId%7D/put/requestBod\ + y/content/application~1json/schema/properties/StudentLe\ + arningSupportParticipation/properties/Student" + LastUpdatedBy: + $ref: "#/paths/~1StudentLearningSupportParticipations~1%7BStu\ + dentLearningSupportParticipationRefId%7D/put/requestBod\ + y/content/application~1json/schema/properties/StudentLe\ + arningSupportParticipation/properties/Student" + CreatedDate: + type: string + format: date + description:The date the learning support participation record + for the student was created in the source system.
+ LastUpdatedDate: + type: string + format: date + description:The date the learning support participation record + for the student was last updated in the source + system.
+ description:Contains information pertaining to a student's + participation in learning support.
+ x-accessControl: + create: + - 1001 + - 1306 + - 2103 + - 2401 + - 2403 + read: + - 1001 + - 1306 + - 2101 + - 2103 + - 2401 + - 2403 + update: + - 1001 + - 1306 + - 2103 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: [] + example: + StudentLearningSupportParticipation: + StudentLearningSupportParticipationRefId: 2FFB63B4-CFEF-4820-8501-E7D1E54555CB + Student: + RefId: CA285746-359D-7510-1A8C-36432A901A16 + application/xml: + schema: + type: object + properties: + StudentLearningSupportParticipation: + $ref: "#/paths/~1StudentLearningSupportParticipations~1%7BStudent\ + LearningSupportParticipationRefId%7D/put/requestBody/conten\ + t/application~1json/schema/properties/StudentLearningSuppor\ + tParticipation" + example: >- +The ID (GUID) assigned to uniquely identify this Student Learning + Support Participation record.
+ required: true + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + StudentLearningSupportParticipation: + $ref: "#/paths/~1StudentLearningSupportParticipations/get/respo\ + nses/200/content/application~1json/schema/properties/Stud\ + entLearningSupportParticipations/properties/StudentLearni\ + ngSupportParticipation/items" + example: + StudentLearningSupportParticipation: + StudentLearningSupportParticipationRefId: 2FFB63B4-CFEF-4820-8501-E7D1E54555CB + Student: + RefId: CA285746-359D-7510-1A8C-36432A901A16 + application/xml: + schema: + type: object + properties: + StudentLearningSupportParticipation: + $ref: "#/paths/~1StudentLearningSupportParticipations/get/respo\ + nses/200/content/application~1json/schema/properties/Stud\ + entLearningSupportParticipations/properties/StudentLearni\ + ngSupportParticipation/items" + example: >- +The ID (GUID) assigned to uniquely identify this Student Learning + Support Participation record.
+ required: true + schema: + type: string + responses: + "200": + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + 200" + default: + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + default" + /AssessmentTasks: + get: + tags: + - AssessmentTask + summary: Default operation to get a list of all available AssessmentTasks + description: Search the set of available AssessmentTasks, according to the search + criteria in the URL parameters. Returns the first 20 objects located; + with SIF defined navigation headers, indicating how to retrieve + subsequent sets of 20 objects. + parameters: + - name: LocalId + in: path + description: Search for object by LocalId, within the context of the organisation + represented by the ZoneId of the request. + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + AssessmentTasks: + type: object + description: A List of AssessmentTask objects + properties: + AssessmentTask: + type: array + items: + required: + - AssessmentName + - ProviderInvolvedList + type: object + properties: + AssessmentTaskRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[\ + a-fA-F0-9]{4}-[a-fA-F0-9]{12}" + AssessmentTaskLocalId: + description:This is a common element used to define the + locally assigned identifier associated with an + entity.
+ type: string + AssessmentName: + type: string + description:The name of the assessment task.
+ ProviderInvolvedList: + description:A list of the providers involved and their + role, e.g. assessing provider, assessment + provider, assessment location provider, + registering provider.
+ type: object + required: + - ProviderInvolved + properties: + ProviderInvolved: + type: array + items: + description:The provider involved with the + assessment task and the role they play, + e.g. assessing provider, assessment + location provider, assessment provider, + registering provider.
+ type: object + required: + - ObjectType + - ProviderRole + properties: + ProviderRole: + type: string + title: Assessment Provider Role + description: >- +Code set denoting the role of the + provider in the assessment, e.g. + Assessing Provider, Location + Provider.
A reference to another SIF Data Object
+ type: object + required: + - ObjectType + properties: + RefId: + $ref: "#/paths/~1AssessmentTasks/get/responses/20\ + 0/content/application~1json/schema/properti\ + es/AssessmentTasks/properties/AssessmentTas\ + k/items/properties/AssessmentTaskRefId" + LocalId: + $ref: "#/paths/~1AssessmentTasks/get/responses/20\ + 0/content/application~1json/schema/properti\ + es/AssessmentTasks/properties/AssessmentTas\ + k/items/properties/AssessmentTaskLocalId" + Name: + type: string + description:The normal descriptive name of the + referenced object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject + names, to be included in Object + References
The GUIDs for students that are the intended + participants for this Assessement Task.
+ type: object + required: + - Student + properties: + Student: + type: array + items: + $ref: "#/paths/~1AssessmentTasks/get/responses/\ + 200/content/application~1json/schema/prop\ + erties/AssessmentTasks/properties/Assessm\ + entTask/items/properties/TeachingGroup" + StaffInvolvedList: + description:A list of the staff involved and their role + in relation to the assessment task, e.g. the + moderator, the marker.
+ type: object + required: + - StaffInvolved + properties: + StaffInvolved: + type: array + items: + description:The staff member involved with the + assessment task and their role, e.g. + created the assessment task, moderator, + marker.
+ type: object + required: + - ObjectType + - StaffRole + properties: + StaffRole: + type: string + title: Assessment Staff Role + description: |- + +A particular grading category for the + assignment, used to provide grouping and type + information.
+ Description: + type: string + description:The text-based description of the + assignment.
+ PointsPossible: + type: integer + description:The points possible on the assignment.
+ CreatedDate: + type: string + format: date + description:Creation date of the assignment.
+ DueDate: + type: string + format: date + description:Date the assignment is due.
+ Weight: + description:The weight of the assignment.
+ MaxAttemptsAllowed: + type: integer + description:How many attempts the student is allowed on + the assignment (applicable particularly to + online activities).
+ DetailedDescriptionURL: + type: string + format: uri + description:The location of the document that describes + the assignment. If Type is PDF, this element + will contain the Base64 encoding of the entire + document. Preferred against + DetailedDescriptionBinary for online + assessment.
+ AssessmentType: + type: string + description:Type of assessment (e.g. diagnostic vs + paedagogical).
+ LevelAssessed: + type: string + description:Level at which assessment is aimed; may be + year level.
+ FormativeIndicator: + type: string + title: Yes Or No Category + description: >- +A reusable code set for yes, no, unknown and + not provided values.
The type of assessment tool used for the + assessment task.
+ AssessmentPurpose: + type: string + description:Purpose for the assessment.
+ SubAssessmentTaskList: + type: object + required: + - SubAssessmentTask + properties: + SubAssessmentTask: + type: array + items: + $ref: "#/paths/~1AssessmentTasks/get/responses/\ + 200/content/application~1json/schema/prop\ + erties/AssessmentTasks/properties/Assessm\ + entTask/items/properties/TeachingGroup" + description:AssessmentTasks which this assessment task is + composed of.
+ PrerequisiteList: + description:References to objects (Course, + LearningStandard, AssessmentTask etc.) being + prerequisite conditions to be met for + assessment.
+ type: object + required: + - Prerequisite + properties: + Prerequisite: + type: array + items: + $ref: "#/paths/~1AssessmentTasks/get/responses/\ + 200/content/application~1json/schema/prop\ + erties/AssessmentTasks/properties/Assessm\ + entTask/items/properties/TeachingGroup" + SubjectArea: + type: string + title: Subject Area + description: >- +Codes denoting Subject Areas defined by the + NZ Curriculum and Te Marautanga o Aotearoa.
+Year Level defines the values that are valid + for describing Funding Year Level and Current + Year Level for a student enrolment.
+Current Year Level indicates the year level + of the student’s class cohort and the level at + which the student spends most of their time at + school. While a student may be enrolled in + subjects at varying instructional year levels, + in relation to the student enrolment this value + represents the year level at which the student + is considered to be predominantly taught.
+Funding Year Level measures the actual number + of years that the student has attended a school. + It provides the Ministry with a method of + counting students for funding purposes which is + independent of the way schools are organised or + the particular programme of study that a student + may undertake. Funding Year Level for most + students is based on the date they first started + school.
School Year Level is used to + indicate the instructional year levels offered + by a school, i.e. those years for which student + enrolments may be accepted.
A list of references to LearningStandards + that will be assessed as part of this + AssessmentTask.
+ SpecialAssessmentConditionExclusionList: + description:A list of SACs that are excluded for this + particular assessment task.
+ type: object + required: + - SpecialAssessmentCondition + properties: + SpecialAssessmentCondition: + type: array + items: + type: string + title: Special Assessment Condition + description: >- +Standard codes denoting special + assessment conditions that a student + requires when sitting an assessment.
+The timeframe of the assessment, e.g. + Mid-Year, End of Year.
This object provides information about a + particular assignment, allows applications to + synchronize each other's assignment tables, gathers + the definition for a StudentAssessmentTask object, + etc.
+ x-accessControl: + create: + - 1001 + - 2401 + - 2403 + read: + - 1001 + - 2401 + - 2403 + update: + - 1001 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: + - 2002 + - 2102 + example: + AssessmentTasks: + AssessmentTask: + - AssessmentTaskRefId: 359D7510-1AD0-A9D7-A8C3-DAD0A85103A2 + AssessmentName: NZ History Classroom Test + ProviderInvolvedList: + ProviderInvolved: + RefId: 11737EA4-301C-ADCA-75C8-7214A7C46BDB + ProviderRole: PRO + TeachingGroup: + RefId: D0A0A27A-D0A8-510A-D9D7-5101A8C3DA39 + StaffInvolvedList: + StaffInvolved: + RefId: cd106d6d-d9d5-41fb-9943-5feb967c9435 + StaffRole: ASS + GradingCategory: Classroom Test + Description: Pop Quiz + PointsPossible: 100 + CreatedDate: 2018-11-21 + DueDate: 2018-11-25 + Weight: 1 + DetailedDescriptionURL: http://www.assignmentinfo.com/assignment1.pdf + application/xml: + schema: + type: object + properties: + AssessmentTasks: + type: object + description: A List of AssessmentTask objects + properties: + AssessmentTask: + type: array + items: + $ref: "#/paths/~1AssessmentTasks/get/responses/200/conten\ + t/application~1json/schema/properties/AssessmentTas\ + ks/properties/AssessmentTask/items" + example: >- +A GUID that identifies an instance of this object.
+ required: true + schema: + type: string + operationId: createAssessmentTask + requestBody: + description: CRUD operation on AssessmentTask + content: + application/json: + schema: + type: object + properties: + AssessmentTask: + $ref: "#/paths/~1AssessmentTasks/get/responses/200/content/applic\ + ation~1json/schema/properties/AssessmentTasks/properties/As\ + sessmentTask/items" + example: + AssessmentTask: + AssessmentTaskRefId: 359D7510-1AD0-A9D7-A8C3-DAD0A85103A2 + AssessmentName: NZ History Classroom Test + ProviderInvolvedList: + ProviderInvolved: + RefId: 11737EA4-301C-ADCA-75C8-7214A7C46BDB + ProviderRole: PRO + TeachingGroup: + RefId: D0A0A27A-D0A8-510A-D9D7-5101A8C3DA39 + StaffInvolvedList: + StaffInvolved: + RefId: cd106d6d-d9d5-41fb-9943-5feb967c9435 + StaffRole: ASS + GradingCategory: Classroom Test + Description: Pop Quiz + PointsPossible: 100 + CreatedDate: 2018-11-21 + DueDate: 2018-11-25 + Weight: 1 + DetailedDescriptionURL: http://www.assignmentinfo.com/assignment1.pdf + application/xml: + schema: + type: object + properties: + AssessmentTask: + $ref: "#/paths/~1AssessmentTasks/get/responses/200/content/applic\ + ation~1json/schema/properties/AssessmentTasks/properties/As\ + sessmentTask/items" + example: >- +A GUID that identifies an instance of this object.
+ required: true + schema: + type: string + operationId: updateAssessmentTask + requestBody: + description: CRUD operation on AssessmentTask + content: + application/json: + schema: + type: object + properties: + AssessmentTask: + type: object + properties: + AssessmentTaskRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-\ + 9]{4}-[a-fA-F0-9]{12}" + AssessmentTaskLocalId: + description:This is a common element used to define the locally + assigned identifier associated with an entity.
+ type: string + AssessmentName: + type: string + description:The name of the assessment task.
+ ProviderInvolvedList: + description:A list of the providers involved and their role, e.g. + assessing provider, assessment provider, assessment + location provider, registering provider.
+ type: object + properties: + ProviderInvolved: + type: array + items: + description:The provider involved with the assessment task + and the role they play, e.g. assessing provider, + assessment location provider, assessment provider, + registering provider.
+ type: object + properties: + ProviderRole: + type: string + title: Assessment Provider Role + description: >- +Code set denoting the role of the provider + in the assessment, e.g. Assessing Provider, + Location Provider.
A reference to another SIF Data Object
+ type: object + properties: + RefId: + $ref: "#/paths/~1AssessmentTasks~1%7BAssessmentTaskRefId%\ + 7D/put/requestBody/content/application~1json/schema\ + /properties/AssessmentTask/properties/AssessmentTas\ + kRefId" + LocalId: + $ref: "#/paths/~1AssessmentTasks~1%7BAssessmentTaskRefId%\ + 7D/put/requestBody/content/application~1json/schema\ + /properties/AssessmentTask/properties/AssessmentTas\ + kLocalId" + Name: + type: string + description:The normal descriptive name of the referenced + object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject names, to + be included in Object References
The GUIDs for students that are the intended + participants for this Assessement Task.
+ type: object + properties: + Student: + type: array + items: + $ref: "#/paths/~1AssessmentTasks~1%7BAssessmentTaskRefI\ + d%7D/put/requestBody/content/application~1json/sc\ + hema/properties/AssessmentTask/properties/Teachin\ + gGroup" + StaffInvolvedList: + description:A list of the staff involved and their role in + relation to the assessment task, e.g. the moderator, the + marker.
+ type: object + properties: + StaffInvolved: + type: array + items: + description:The staff member involved with the assessment + task and their role, e.g. created the assessment + task, moderator, marker.
+ type: object + properties: + StaffRole: + type: string + title: Assessment Staff Role + description: |- + +A particular grading category for the assignment, + used to provide grouping and type information.
+ Description: + type: string + description:The text-based description of the assignment.
+ PointsPossible: + type: integer + description:The points possible on the assignment.
+ CreatedDate: + type: string + format: date + description:Creation date of the assignment.
+ DueDate: + type: string + format: date + description:Date the assignment is due.
+ Weight: + description:The weight of the assignment.
+ MaxAttemptsAllowed: + type: integer + description:How many attempts the student is allowed on the + assignment (applicable particularly to online + activities).
+ DetailedDescriptionURL: + type: string + format: uri + description:The location of the document that describes the + assignment. If Type is PDF, this element will contain + the Base64 encoding of the entire document. Preferred + against DetailedDescriptionBinary for online + assessment.
+ AssessmentType: + type: string + description:Type of assessment (e.g. diagnostic vs + paedagogical).
+ LevelAssessed: + type: string + description:Level at which assessment is aimed; may be year + level.
+ FormativeIndicator: + type: string + title: Yes Or No Category + description: >- +A reusable code set for yes, no, unknown and not + provided values.
The type of assessment tool used for the assessment + task.
+ AssessmentPurpose: + type: string + description:Purpose for the assessment.
+ SubAssessmentTaskList: + type: object + properties: + SubAssessmentTask: + type: array + items: + $ref: "#/paths/~1AssessmentTasks~1%7BAssessmentTaskRefI\ + d%7D/put/requestBody/content/application~1json/sc\ + hema/properties/AssessmentTask/properties/Teachin\ + gGroup" + description:AssessmentTasks which this assessment task is + composed of.
+ PrerequisiteList: + description:References to objects (Course, LearningStandard, + AssessmentTask etc.) being prerequisite conditions to be + met for assessment.
+ type: object + properties: + Prerequisite: + type: array + items: + $ref: "#/paths/~1AssessmentTasks~1%7BAssessmentTaskRefI\ + d%7D/put/requestBody/content/application~1json/sc\ + hema/properties/AssessmentTask/properties/Teachin\ + gGroup" + SubjectArea: + type: string + title: Subject Area + description: >- +Codes denoting Subject Areas defined by the NZ + Curriculum and Te Marautanga o Aotearoa.
Year Level defines the values that are valid for + describing Funding Year Level and Current Year Level for + a student enrolment.
Current Year Level indicates + the year level of the student’s class cohort and the + level at which the student spends most of their time at + school. While a student may be enrolled in subjects at + varying instructional year levels, in relation to the + student enrolment this value represents the year level + at which the student is considered to be predominantly + taught.
Funding Year Level measures the actual + number of years that the student has attended a school. + It provides the Ministry with a method of counting + students for funding purposes which is independent of + the way schools are organised or the particular + programme of study that a student may undertake. Funding + Year Level for most students is based on the date they + first started school.
School Year Level is used + to indicate the instructional year levels offered by a + school, i.e. those years for which student enrolments + may be accepted.
A list of references to LearningStandards that will + be assessed as part of this AssessmentTask.
+ SpecialAssessmentConditionExclusionList: + description:A list of SACs that are excluded for this particular + assessment task.
+ type: object + properties: + SpecialAssessmentCondition: + type: array + items: + type: string + title: Special Assessment Condition + description: >- +Standard codes denoting special assessment + conditions that a student requires when sitting an + assessment.
The timeframe of the assessment, e.g. Mid-Year, End + of Year.
This object provides information about a particular + assignment, allows applications to synchronize each other's + assignment tables, gathers the definition for a + StudentAssessmentTask object, etc.
+ x-accessControl: + create: + - 1001 + - 2401 + - 2403 + read: + - 1001 + - 2401 + - 2403 + update: + - 1001 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: + - 2002 + - 2102 + example: + AssessmentTask: + AssessmentTaskRefId: 359D7510-1AD0-A9D7-A8C3-DAD0A85103A2 + AssessmentName: NZ History Classroom Test + ProviderInvolvedList: + ProviderInvolved: + RefId: 11737EA4-301C-ADCA-75C8-7214A7C46BDB + ProviderRole: PRO + TeachingGroup: + RefId: D0A0A27A-D0A8-510A-D9D7-5101A8C3DA39 + StaffInvolvedList: + StaffInvolved: + RefId: cd106d6d-d9d5-41fb-9943-5feb967c9435 + StaffRole: ASS + GradingCategory: Classroom Test + Description: Pop Quiz + PointsPossible: 100 + CreatedDate: 2018-11-21 + DueDate: 2018-11-25 + Weight: 1 + DetailedDescriptionURL: http://www.assignmentinfo.com/assignment1.pdf + application/xml: + schema: + type: object + properties: + AssessmentTask: + $ref: "#/paths/~1AssessmentTasks~1%7BAssessmentTaskRefId%7D/put/r\ + equestBody/content/application~1json/schema/properties/Asse\ + ssmentTask" + example: >- +A GUID that identifies an instance of this object.
+ required: true + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + AssessmentTask: + $ref: "#/paths/~1AssessmentTasks/get/responses/200/content/appl\ + ication~1json/schema/properties/AssessmentTasks/propertie\ + s/AssessmentTask/items" + example: + AssessmentTask: + AssessmentTaskRefId: 359D7510-1AD0-A9D7-A8C3-DAD0A85103A2 + AssessmentName: NZ History Classroom Test + ProviderInvolvedList: + ProviderInvolved: + RefId: 11737EA4-301C-ADCA-75C8-7214A7C46BDB + ProviderRole: PRO + TeachingGroup: + RefId: D0A0A27A-D0A8-510A-D9D7-5101A8C3DA39 + StaffInvolvedList: + StaffInvolved: + RefId: cd106d6d-d9d5-41fb-9943-5feb967c9435 + StaffRole: ASS + GradingCategory: Classroom Test + Description: Pop Quiz + PointsPossible: 100 + CreatedDate: 2018-11-21 + DueDate: 2018-11-25 + Weight: 1 + DetailedDescriptionURL: http://www.assignmentinfo.com/assignment1.pdf + application/xml: + schema: + type: object + properties: + AssessmentTask: + $ref: "#/paths/~1AssessmentTasks/get/responses/200/content/appl\ + ication~1json/schema/properties/AssessmentTasks/propertie\ + s/AssessmentTask/items" + example: >- +A GUID that identifies an instance of this object.
+ required: true + schema: + type: string + responses: + "200": + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + 200" + default: + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + default" + /StudentAssessmentTaskRegistrations: + get: + tags: + - StudentAssessmentTaskRegistration + summary: Default operation to get a list of all available + StudentAssessmentTaskRegistrations + description: Search the set of available StudentAssessmentTaskRegistrations, + according to the search criteria in the URL parameters. Returns the + first 20 objects located; with SIF defined navigation headers, + indicating how to retrieve subsequent sets of 20 objects. + parameters: + - name: LocalId + in: path + description: Search for object by LocalId, within the context of the organisation + represented by the ZoneId of the request. + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + StudentAssessmentTaskRegistrations: + type: object + description: A List of StudentAssessmentTaskRegistration objects + properties: + StudentAssessmentTaskRegistration: + type: array + items: + required: + - AssessmentTask + - AssessmentYear + - DateRegistered + - ProviderInvolvedList + - Student + type: object + properties: + StudentAssessmentTaskRegistrationRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[\ + a-fA-F0-9]{4}-[a-fA-F0-9]{12}" + StudentAssessmentTaskRegistrationLocalId: + description:This is a common element used to define the + locally assigned identifier associated with an + entity.
+ type: string + ProviderInvolvedList: + description:A list of the providers involved and their + role, e.g. assessment provider, registering + provider.
+ type: object + required: + - ProviderInvolved + properties: + ProviderInvolved: + type: array + items: + description:The provider involved with the + assessment task and the role they play, + e.g. assessing provider, assessment + location provider, assessment provider, + registering provider.
+ type: object + required: + - ObjectType + - ProviderRole + properties: + ProviderRole: + type: string + title: Assessment Provider Role + description: >- +Code set denoting the role of the + provider in the assessment, e.g. + Assessing Provider, Location + Provider.
A reference to another SIF Data Object
+ type: object + required: + - ObjectType + properties: + RefId: + $ref: "#/paths/~1StudentAssessmentTaskRegistratio\ + ns/get/responses/200/content/application~1j\ + son/schema/properties/StudentAssessmentTask\ + Registrations/properties/StudentAssessmentT\ + askRegistration/items/properties/StudentAss\ + essmentTaskRegistrationRefId" + LocalId: + $ref: "#/paths/~1StudentAssessmentTaskRegistratio\ + ns/get/responses/200/content/application~1j\ + son/schema/properties/StudentAssessmentTask\ + Registrations/properties/StudentAssessmentT\ + askRegistration/items/properties/StudentAss\ + essmentTaskRegistrationLocalId" + Name: + type: string + description:The normal descriptive name of the + referenced object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject + names, to be included in Object + References
A list of references identifying any Special + Assessment Conditions that the student is + entitled to for the assessment task they are + registering for.
+ type: object + required: + - SpecialAssessmentCondition + properties: + SpecialAssessmentCondition: + type: array + items: + type: string + title: Special Assessment Condition + description: >- +Standard codes denoting special + assessment conditions that a student + requires when sitting an assessment.
+Codes denoting Subject Areas defined by the + NZ Curriculum and Te Marautanga o Aotearoa.
+Year Level defines the values that are valid + for describing Funding Year Level and Current + Year Level for a student enrolment.
+Current Year Level indicates the year level + of the student’s class cohort and the level at + which the student spends most of their time at + school. While a student may be enrolled in + subjects at varying instructional year levels, + in relation to the student enrolment this value + represents the year level at which the student + is considered to be predominantly taught.
+Funding Year Level measures the actual number + of years that the student has attended a school. + It provides the Ministry with a method of + counting students for funding purposes which is + independent of the way schools are organised or + the particular programme of study that a student + may undertake. Funding Year Level for most + students is based on the date they first started + school.
School Year Level is used to + indicate the instructional year levels offered + by a school, i.e. those years for which student + enrolments may be accepted.
The date the student's intent to participate + in the assessment task was registered.
+ AssessmentYear: + description:The assessment year the student's intent to + participate in the assessment task was + registered for.
+ description:The student's registration for an assessment task + they are intending to participate in.
+ x-accessControl: + ? create + ? read + ? update + ? delete + ? aggregate + example: + StudentAssessmentTaskRegistrations: + StudentAssessmentTaskRegistration: + - StudentAssessmentTaskRegistrationRefId: 359D7510-1AD0-A9D7-A8C3-DAD0A85103A2 + ProviderInvolvedList: + ProviderInvolved: + - RefId: 5556b4eb-850f-4102-800c-9a3fde8bfa9f + ProviderRole: ASR + - RefId: 6661f830-13a6-44d7-bd96-be00cbad68f1 + ProviderRole: PRO + Student: + RefId: 19059103-3c50-4970-bc48-341349c32858 + Name: Harry Potter + StaffMember: + RefId: c23c6fa1-4093-4c21-9ea8-4cdd3c7dd7fb + AssessmentTask: + RefId: cedd0ce7-f555-482b-887b-d130e5c40d02 + SpecialAssessmentConditionList: + SpecialAssessmentCondition: + - COM + - EXT + - SEP + SubjectArea: PHYS + YearLevel: 12 + DateRegistered: 2018-03-30 + AssessmentYear: 2018 + application/xml: + schema: + type: object + properties: + StudentAssessmentTaskRegistrations: + type: object + description: A List of StudentAssessmentTaskRegistration objects + properties: + StudentAssessmentTaskRegistration: + type: array + items: + $ref: "#/paths/~1StudentAssessmentTaskRegistrations/get/r\ + esponses/200/content/application~1json/schema/prope\ + rties/StudentAssessmentTaskRegistrations/properties\ + /StudentAssessmentTaskRegistration/items" + example: >- +A GUID that identifies an instance of this object.
+ required: true + schema: + type: string + operationId: createStudentAssessmentTaskRegistration + requestBody: + description: CRUD operation on StudentAssessmentTaskRegistration + content: + application/json: + schema: + type: object + properties: + StudentAssessmentTaskRegistration: + $ref: "#/paths/~1StudentAssessmentTaskRegistrations/get/responses\ + /200/content/application~1json/schema/properties/StudentAss\ + essmentTaskRegistrations/properties/StudentAssessmentTaskRe\ + gistration/items" + example: + StudentAssessmentTaskRegistration: + StudentAssessmentTaskRegistrationRefId: 359D7510-1AD0-A9D7-A8C3-DAD0A85103A2 + ProviderInvolvedList: + ProviderInvolved: + - RefId: 5556b4eb-850f-4102-800c-9a3fde8bfa9f + ProviderRole: ASR + - RefId: 6661f830-13a6-44d7-bd96-be00cbad68f1 + ProviderRole: PRO + Student: + RefId: 19059103-3c50-4970-bc48-341349c32858 + Name: Harry Potter + StaffMember: + RefId: c23c6fa1-4093-4c21-9ea8-4cdd3c7dd7fb + AssessmentTask: + RefId: cedd0ce7-f555-482b-887b-d130e5c40d02 + SpecialAssessmentConditionList: + SpecialAssessmentCondition: + - COM + - EXT + - SEP + SubjectArea: PHYS + YearLevel: 12 + DateRegistered: 2018-03-30 + AssessmentYear: 2018 + application/xml: + schema: + type: object + properties: + StudentAssessmentTaskRegistration: + $ref: "#/paths/~1StudentAssessmentTaskRegistrations/get/responses\ + /200/content/application~1json/schema/properties/StudentAss\ + essmentTaskRegistrations/properties/StudentAssessmentTaskRe\ + gistration/items" + example: >- +A GUID that identifies an instance of this object.
+ required: true + schema: + type: string + operationId: updateStudentAssessmentTaskRegistration + requestBody: + description: CRUD operation on StudentAssessmentTaskRegistration + content: + application/json: + schema: + type: object + properties: + StudentAssessmentTaskRegistration: + type: object + properties: + StudentAssessmentTaskRegistrationRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-\ + 9]{4}-[a-fA-F0-9]{12}" + StudentAssessmentTaskRegistrationLocalId: + description:This is a common element used to define the locally + assigned identifier associated with an entity.
+ type: string + ProviderInvolvedList: + description:A list of the providers involved and their role, e.g. + assessment provider, registering provider.
+ type: object + properties: + ProviderInvolved: + type: array + items: + description:The provider involved with the assessment task + and the role they play, e.g. assessing provider, + assessment location provider, assessment provider, + registering provider.
+ type: object + properties: + ProviderRole: + type: string + title: Assessment Provider Role + description: >- +Code set denoting the role of the provider + in the assessment, e.g. Assessing Provider, + Location Provider.
A reference to another SIF Data Object
+ type: object + properties: + RefId: + $ref: "#/paths/~1StudentAssessmentTaskRegistrations~1%7BS\ + tudentAssessmentTaskRegistrationRefId%7D/put/reques\ + tBody/content/application~1json/schema/properties/S\ + tudentAssessmentTaskRegistration/properties/Student\ + AssessmentTaskRegistrationRefId" + LocalId: + $ref: "#/paths/~1StudentAssessmentTaskRegistrations~1%7BS\ + tudentAssessmentTaskRegistrationRefId%7D/put/reques\ + tBody/content/application~1json/schema/properties/S\ + tudentAssessmentTaskRegistration/properties/Student\ + AssessmentTaskRegistrationLocalId" + Name: + type: string + description:The normal descriptive name of the referenced + object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject names, to + be included in Object References
A list of references identifying any Special + Assessment Conditions that the student is entitled to + for the assessment task they are registering for.
+ type: object + properties: + SpecialAssessmentCondition: + type: array + items: + type: string + title: Special Assessment Condition + description: >- +Standard codes denoting special assessment + conditions that a student requires when sitting an + assessment.
Codes denoting Subject Areas defined by the NZ + Curriculum and Te Marautanga o Aotearoa.
Year Level defines the values that are valid for + describing Funding Year Level and Current Year Level for + a student enrolment.
Current Year Level indicates + the year level of the student’s class cohort and the + level at which the student spends most of their time at + school. While a student may be enrolled in subjects at + varying instructional year levels, in relation to the + student enrolment this value represents the year level + at which the student is considered to be predominantly + taught.
Funding Year Level measures the actual + number of years that the student has attended a school. + It provides the Ministry with a method of counting + students for funding purposes which is independent of + the way schools are organised or the particular + programme of study that a student may undertake. Funding + Year Level for most students is based on the date they + first started school.
School Year Level is used + to indicate the instructional year levels offered by a + school, i.e. those years for which student enrolments + may be accepted.
The date the student's intent to participate in the + assessment task was registered.
+ AssessmentYear: + description:The assessment year the student's intent to + participate in the assessment task was registered + for.
+ description:The student's registration for an assessment task they + are intending to participate in.
+ x-accessControl: + ? create + ? read + ? update + ? delete + ? aggregate + example: + StudentAssessmentTaskRegistration: + StudentAssessmentTaskRegistrationRefId: 359D7510-1AD0-A9D7-A8C3-DAD0A85103A2 + ProviderInvolvedList: + ProviderInvolved: + - RefId: 5556b4eb-850f-4102-800c-9a3fde8bfa9f + ProviderRole: ASR + - RefId: 6661f830-13a6-44d7-bd96-be00cbad68f1 + ProviderRole: PRO + Student: + RefId: 19059103-3c50-4970-bc48-341349c32858 + Name: Harry Potter + StaffMember: + RefId: c23c6fa1-4093-4c21-9ea8-4cdd3c7dd7fb + AssessmentTask: + RefId: cedd0ce7-f555-482b-887b-d130e5c40d02 + SpecialAssessmentConditionList: + SpecialAssessmentCondition: + - COM + - EXT + - SEP + SubjectArea: PHYS + YearLevel: 12 + DateRegistered: 2018-03-30 + AssessmentYear: 2018 + application/xml: + schema: + type: object + properties: + StudentAssessmentTaskRegistration: + $ref: "#/paths/~1StudentAssessmentTaskRegistrations~1%7BStudentAs\ + sessmentTaskRegistrationRefId%7D/put/requestBody/content/ap\ + plication~1json/schema/properties/StudentAssessmentTaskRegi\ + stration" + example: >- +A GUID that identifies an instance of this object.
+ required: true + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + StudentAssessmentTaskRegistration: + $ref: "#/paths/~1StudentAssessmentTaskRegistrations/get/respons\ + es/200/content/application~1json/schema/properties/Studen\ + tAssessmentTaskRegistrations/properties/StudentAssessment\ + TaskRegistration/items" + example: + StudentAssessmentTaskRegistration: + StudentAssessmentTaskRegistrationRefId: 359D7510-1AD0-A9D7-A8C3-DAD0A85103A2 + ProviderInvolvedList: + ProviderInvolved: + - RefId: 5556b4eb-850f-4102-800c-9a3fde8bfa9f + ProviderRole: ASR + - RefId: 6661f830-13a6-44d7-bd96-be00cbad68f1 + ProviderRole: PRO + Student: + RefId: 19059103-3c50-4970-bc48-341349c32858 + Name: Harry Potter + StaffMember: + RefId: c23c6fa1-4093-4c21-9ea8-4cdd3c7dd7fb + AssessmentTask: + RefId: cedd0ce7-f555-482b-887b-d130e5c40d02 + SpecialAssessmentConditionList: + SpecialAssessmentCondition: + - COM + - EXT + - SEP + SubjectArea: PHYS + YearLevel: 12 + DateRegistered: 2018-03-30 + AssessmentYear: 2018 + application/xml: + schema: + type: object + properties: + StudentAssessmentTaskRegistration: + $ref: "#/paths/~1StudentAssessmentTaskRegistrations/get/respons\ + es/200/content/application~1json/schema/properties/Studen\ + tAssessmentTaskRegistrations/properties/StudentAssessment\ + TaskRegistration/items" + example: >- +A GUID that identifies an instance of this object.
+ required: true + schema: + type: string + responses: + "200": + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + 200" + default: + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + default" + /StudentAssessmentTasks: + get: + tags: + - StudentAssessmentTask + summary: Default operation to get a list of all available StudentAssessmentTasks + description: Search the set of available StudentAssessmentTasks, according to the + search criteria in the URL parameters. Returns the first 20 objects + located; with SIF defined navigation headers, indicating how to retrieve + subsequent sets of 20 objects. + parameters: + - name: LocalId + in: path + description: Search for object by LocalId, within the context of the organisation + represented by the ZoneId of the request. + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + StudentAssessmentTasks: + type: object + description: A List of StudentAssessmentTask objects + properties: + StudentAssessmentTask: + type: array + items: + required: + - AssessmentTask + - ProviderInvolvedList + - Student + type: object + properties: + StudentAssessmentTaskRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[\ + a-fA-F0-9]{4}-[a-fA-F0-9]{12}" + StudentAssessmentTaskLocalId: + description:This is a common element used to define the + locally assigned identifier associated with an + entity.
+ type: string + Student: + description:A reference to another SIF Data Object
+ type: object + required: + - ObjectType + properties: + RefId: + $ref: "#/paths/~1StudentAssessmentTasks/get/respo\ + nses/200/content/application~1json/schema/p\ + roperties/StudentAssessmentTasks/properties\ + /StudentAssessmentTask/items/properties/Stu\ + dentAssessmentTaskRefId" + LocalId: + $ref: "#/paths/~1StudentAssessmentTasks/get/respo\ + nses/200/content/application~1json/schema/p\ + roperties/StudentAssessmentTasks/properties\ + /StudentAssessmentTask/items/properties/Stu\ + dentAssessmentTaskLocalId" + Name: + type: string + description:The normal descriptive name of the + referenced object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject + names, to be included in Object + References
A list of the providers involved and their + role, e.g. assessing provider, assessment + provider, assessment location provider.
+ type: object + required: + - ProviderInvolved + properties: + ProviderInvolved: + type: array + items: + description:The provider involved with the + assessment task and the role they play, + e.g. assessing provider, assessment + location provider, assessment provider, + registering provider.
+ type: object + required: + - ObjectType + - ProviderRole + properties: + ProviderRole: + type: string + title: Assessment Provider Role + description: >- +Code set denoting the role of the + provider in the assessment, e.g. + Assessing Provider, Location + Provider.
A list of the staff involved and their role + in relation to the assessment task, e.g. the + staff members that supervise the undertaking of + the assessment task by the student.
+ type: object + required: + - StaffInvolved + properties: + StaffInvolved: + type: array + items: + description:The staff member involved with the + assessment task and their role, e.g. + created the assessment task, moderator, + marker.
+ type: object + required: + - ObjectType + - StaffRole + properties: + StaffRole: + type: string + title: Assessment Staff Role + description: |- + +The date and time the student is scheduled to + be assessed against the assessment task.
+ DateTimeAssessmentOccurred: + description:The date and time the student was assessed + against the assessment task.
+ YearAssessmentOccurred: + description:The year the student was assessed against the + assessment task.
+ AssessmentType: + type: string + title: Assessment Type + description: >- +Standard codes denoting the type of + assessment the student is sitting for the + assessment task.
Codes denoting the current status of the + assessment task.
The timeframe of the assessment, e.g. + Mid-Year, End of Year.
Date the current NCEA status was set.
+ AchievementAttempt: + type: integer + description:The attempt number the student is making to + pass this assessment, e.g. is it their first, + second attempt.
+ SubjectAreaList: + description:The list of Subject Area the assessment task + pertains to.
+ type: object + properties: + SubjectAreaList: + type: array + items: + SubjectArea: + type: string + title: Subject Area + description: >- +Codes denoting Subject Areas defined + by the NZ Curriculum and Te Marautanga o + Aotearoa.
Codes denoting Subject Areas defined + by the NZQA for NCEA.
Year Level defines the values that are valid + for describing Funding Year Level and Current + Year Level for a student enrolment.
+Current Year Level indicates the year level + of the student’s class cohort and the level at + which the student spends most of their time at + school. While a student may be enrolled in + subjects at varying instructional year levels, + in relation to the student enrolment this value + represents the year level at which the student + is considered to be predominantly taught.
+Funding Year Level measures the actual number + of years that the student has attended a school. + It provides the Ministry with a method of + counting students for funding purposes which is + independent of the way schools are organised or + the particular programme of study that a student + may undertake. Funding Year Level for most + students is based on the date they first started + school.
School Year Level is used to + indicate the instructional year levels offered + by a school, i.e. those years for which student + enrolments may be accepted.
The list of the special assessment conditions + that the student is entitled to have when + sitting this assessment task.
+ type: object + required: + - SpecialAssessmentCondition + properties: + SpecialAssessmentCondition: + type: array + items: + type: string + title: Special Assessment Condition + description: >- +Standard codes denoting special + assessment conditions that a student + requires when sitting an assessment.
+Record of a student's attempt at a particular + assessment task.
+ x-accessControl: + create: + - 1001 + - 2401 + - 2403 + read: + - 1001 + - 2401 + - 2403 + update: + - 1001 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: + - 2002 + - 2102 + example: + StudentAssessmentTasks: + StudentAssessmentTask: + - StudentAssessmentTaskRefId: 359D7510-1AD0-A9D7-A8C3-DAD0A85103A2 + Student: + RefId: cd106d6d-d9d5-41fb-9943-5feb967c9435 + LocalId: HP-850139 + Name: Harry Potter + AssessmentTask: + RefId: D0A0A27A-D0A8-510A-D9D7-5101A8C3DA39 + ProviderInvolvedList: + ProviderInvolved: + - RefId: 11737EA4-301C-ADCA-75C8-7214A7C46BDB + ProviderRole: LOC + - RefId: ad30d3a6-e663-4d5b-8975-6c4ffc745bfb + ProviderRole: PRO + ProviderCourse: + RefId: 2c55ec5e-7def-4815-ae08-caad3b9f274d + StaffInvolvedList: + StaffInvolved: + RefId: 228a2cbe-93c4-46ba-91fa-b3ae689eb437 + Name: Prof. McGonnegal + StaffRole: INV + DateTimeAssessmentScheduled: 2018-11-25T09:00:00+12:00 + AssessmentType: EXT + SubjectAreaList: + SubjectArea: PHYS + YearLevel: 11 + application/xml: + schema: + type: object + properties: + StudentAssessmentTasks: + type: object + description: A List of StudentAssessmentTask objects + properties: + StudentAssessmentTask: + type: array + items: + $ref: "#/paths/~1StudentAssessmentTasks/get/responses/200\ + /content/application~1json/schema/properties/Studen\ + tAssessmentTasks/properties/StudentAssessmentTask/i\ + tems" + example: >- +A GUID that identifies an instance of this object.
+ required: true + schema: + type: string + operationId: createStudentAssessmentTask + requestBody: + description: CRUD operation on StudentAssessmentTask + content: + application/json: + schema: + type: object + properties: + StudentAssessmentTask: + $ref: "#/paths/~1StudentAssessmentTasks/get/responses/200/content\ + /application~1json/schema/properties/StudentAssessmentTasks\ + /properties/StudentAssessmentTask/items" + example: + StudentAssessmentTask: + StudentAssessmentTaskRefId: 359D7510-1AD0-A9D7-A8C3-DAD0A85103A2 + Student: + RefId: cd106d6d-d9d5-41fb-9943-5feb967c9435 + LocalId: HP-850139 + Name: Harry Potter + AssessmentTask: + RefId: D0A0A27A-D0A8-510A-D9D7-5101A8C3DA39 + ProviderInvolvedList: + ProviderInvolved: + - RefId: 11737EA4-301C-ADCA-75C8-7214A7C46BDB + ProviderRole: LOC + - RefId: ad30d3a6-e663-4d5b-8975-6c4ffc745bfb + ProviderRole: PRO + ProviderCourse: + RefId: 2c55ec5e-7def-4815-ae08-caad3b9f274d + StaffInvolvedList: + StaffInvolved: + RefId: 228a2cbe-93c4-46ba-91fa-b3ae689eb437 + Name: Prof. McGonnegal + StaffRole: INV + DateTimeAssessmentScheduled: 2018-11-25T09:00:00+12:00 + AssessmentType: EXT + SubjectAreaList: + SubjectArea: PHYS + YearLevel: 11 + application/xml: + schema: + type: object + properties: + StudentAssessmentTask: + $ref: "#/paths/~1StudentAssessmentTasks/get/responses/200/content\ + /application~1json/schema/properties/StudentAssessmentTasks\ + /properties/StudentAssessmentTask/items" + example: >- +A GUID that identifies an instance of this object.
+ required: true + schema: + type: string + operationId: updateStudentAssessmentTask + requestBody: + description: CRUD operation on StudentAssessmentTask + content: + application/json: + schema: + type: object + properties: + StudentAssessmentTask: + type: object + properties: + StudentAssessmentTaskRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-\ + 9]{4}-[a-fA-F0-9]{12}" + StudentAssessmentTaskLocalId: + description:This is a common element used to define the locally + assigned identifier associated with an entity.
+ type: string + Student: + description:A reference to another SIF Data Object
+ type: object + properties: + RefId: + $ref: "#/paths/~1StudentAssessmentTasks~1%7BStudentAssess\ + mentTaskRefId%7D/put/requestBody/content/applicatio\ + n~1json/schema/properties/StudentAssessmentTask/pro\ + perties/StudentAssessmentTaskRefId" + LocalId: + $ref: "#/paths/~1StudentAssessmentTasks~1%7BStudentAssess\ + mentTaskRefId%7D/put/requestBody/content/applicatio\ + n~1json/schema/properties/StudentAssessmentTask/pro\ + perties/StudentAssessmentTaskLocalId" + Name: + type: string + description:The normal descriptive name of the referenced + object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject names, to + be included in Object References
A list of the providers involved and their role, e.g. + assessing provider, assessment provider, assessment + location provider.
+ type: object + properties: + ProviderInvolved: + type: array + items: + description:The provider involved with the assessment task + and the role they play, e.g. assessing provider, + assessment location provider, assessment provider, + registering provider.
+ type: object + properties: + ProviderRole: + type: string + title: Assessment Provider Role + description: >- +Code set denoting the role of the provider + in the assessment, e.g. Assessing Provider, + Location Provider.
A list of the staff involved and their role in + relation to the assessment task, e.g. the staff members + that supervise the undertaking of the assessment task by + the student.
+ type: object + properties: + StaffInvolved: + type: array + items: + description:The staff member involved with the assessment + task and their role, e.g. created the assessment + task, moderator, marker.
+ type: object + properties: + StaffRole: + type: string + title: Assessment Staff Role + description: |- + +The date and time the student is scheduled to be + assessed against the assessment task.
+ DateTimeAssessmentOccurred: + description:The date and time the student was assessed against + the assessment task.
+ YearAssessmentOccurred: + description:The year the student was assessed against the + assessment task.
+ AssessmentType: + type: string + title: Assessment Type + description: >- +Standard codes denoting the type of assessment the + student is sitting for the assessment task.
Codes denoting the current status of the assessment + task.
The timeframe of the assessment, e.g. Mid-Year, End + of Year.
Date the current NCEA status was set.
+ AchievementAttempt: + type: integer + description:The attempt number the student is making to pass this + assessment, e.g. is it their first, second attempt.
+ SubjectAreaList: + description:The list of Subject Area the assessment task pertains + to.
+ type: object + properties: + SubjectAreaList: + type: array + items: + SubjectArea: + type: string + title: Subject Area + description: >- +Codes denoting Subject Areas defined by the + NZ Curriculum and Te Marautanga o Aotearoa.
+Codes denoting Subject Areas defined by the + NZQA for NCEA.
Year Level defines the values that are valid for + describing Funding Year Level and Current Year Level for + a student enrolment.
Current Year Level indicates + the year level of the student’s class cohort and the + level at which the student spends most of their time at + school. While a student may be enrolled in subjects at + varying instructional year levels, in relation to the + student enrolment this value represents the year level + at which the student is considered to be predominantly + taught.
Funding Year Level measures the actual + number of years that the student has attended a school. + It provides the Ministry with a method of counting + students for funding purposes which is independent of + the way schools are organised or the particular + programme of study that a student may undertake. Funding + Year Level for most students is based on the date they + first started school.
School Year Level is used + to indicate the instructional year levels offered by a + school, i.e. those years for which student enrolments + may be accepted.
The list of the special assessment conditions that + the student is entitled to have when sitting this + assessment task.
+ type: object + properties: + SpecialAssessmentCondition: + type: array + items: + type: string + title: Special Assessment Condition + description: >- +Standard codes denoting special assessment + conditions that a student requires when sitting an + assessment.
Record of a student's attempt at a particular assessment + task.
+ x-accessControl: + create: + - 1001 + - 2401 + - 2403 + read: + - 1001 + - 2401 + - 2403 + update: + - 1001 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: + - 2002 + - 2102 + example: + StudentAssessmentTask: + StudentAssessmentTaskRefId: 359D7510-1AD0-A9D7-A8C3-DAD0A85103A2 + Student: + RefId: cd106d6d-d9d5-41fb-9943-5feb967c9435 + LocalId: HP-850139 + Name: Harry Potter + AssessmentTask: + RefId: D0A0A27A-D0A8-510A-D9D7-5101A8C3DA39 + ProviderInvolvedList: + ProviderInvolved: + - RefId: 11737EA4-301C-ADCA-75C8-7214A7C46BDB + ProviderRole: LOC + - RefId: ad30d3a6-e663-4d5b-8975-6c4ffc745bfb + ProviderRole: PRO + ProviderCourse: + RefId: 2c55ec5e-7def-4815-ae08-caad3b9f274d + StaffInvolvedList: + StaffInvolved: + RefId: 228a2cbe-93c4-46ba-91fa-b3ae689eb437 + Name: Prof. McGonnegal + StaffRole: INV + DateTimeAssessmentScheduled: 2018-11-25T09:00:00+12:00 + AssessmentType: EXT + SubjectAreaList: + SubjectArea: PHYS + YearLevel: 11 + application/xml: + schema: + type: object + properties: + StudentAssessmentTask: + $ref: "#/paths/~1StudentAssessmentTasks~1%7BStudentAssessmentTask\ + RefId%7D/put/requestBody/content/application~1json/schema/p\ + roperties/StudentAssessmentTask" + example: >- +A GUID that identifies an instance of this object.
+ required: true + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + StudentAssessmentTask: + $ref: "#/paths/~1StudentAssessmentTasks/get/responses/200/conte\ + nt/application~1json/schema/properties/StudentAssessmentT\ + asks/properties/StudentAssessmentTask/items" + example: + StudentAssessmentTask: + StudentAssessmentTaskRefId: 359D7510-1AD0-A9D7-A8C3-DAD0A85103A2 + Student: + RefId: cd106d6d-d9d5-41fb-9943-5feb967c9435 + LocalId: HP-850139 + Name: Harry Potter + AssessmentTask: + RefId: D0A0A27A-D0A8-510A-D9D7-5101A8C3DA39 + ProviderInvolvedList: + ProviderInvolved: + - RefId: 11737EA4-301C-ADCA-75C8-7214A7C46BDB + ProviderRole: LOC + - RefId: ad30d3a6-e663-4d5b-8975-6c4ffc745bfb + ProviderRole: PRO + ProviderCourse: + RefId: 2c55ec5e-7def-4815-ae08-caad3b9f274d + StaffInvolvedList: + StaffInvolved: + RefId: 228a2cbe-93c4-46ba-91fa-b3ae689eb437 + Name: Prof. McGonnegal + StaffRole: INV + DateTimeAssessmentScheduled: 2018-11-25T09:00:00+12:00 + AssessmentType: EXT + SubjectAreaList: + SubjectArea: PHYS + YearLevel: 11 + application/xml: + schema: + type: object + properties: + StudentAssessmentTask: + $ref: "#/paths/~1StudentAssessmentTasks/get/responses/200/conte\ + nt/application~1json/schema/properties/StudentAssessmentT\ + asks/properties/StudentAssessmentTask/items" + example: >- +A GUID that identifies an instance of this object.
+ required: true + schema: + type: string + responses: + "200": + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + 200" + default: + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + default" + /StudentAssessmentTaskResults: + get: + tags: + - StudentAssessmentTaskResult + summary: Default operation to get a list of all available + StudentAssessmentTaskResults + description: Search the set of available StudentAssessmentTaskResults, according to + the search criteria in the URL parameters. Returns the first 20 objects + located; with SIF defined navigation headers, indicating how to retrieve + subsequent sets of 20 objects. + parameters: + - name: LocalId + in: path + description: Search for object by LocalId, within the context of the organisation + represented by the ZoneId of the request. + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + StudentAssessmentTaskResults: + type: object + description: A List of StudentAssessmentTaskResult objects + properties: + StudentAssessmentTaskResult: + type: array + items: + required: + - ProviderInvolvedList + - Student + - StudentAssessmentTask + type: object + properties: + StudentAssessmentTaskResultRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[\ + a-fA-F0-9]{4}-[a-fA-F0-9]{12}" + StudentAssessmentTaskResultLocalId: + description:This is a common element used to define the + locally assigned identifier associated with an + entity.
+ type: string + StudentAssessmentTask: + description:A reference to another SIF Data Object
+ type: object + required: + - ObjectType + properties: + RefId: + $ref: "#/paths/~1StudentAssessmentTaskResults/get\ + /responses/200/content/application~1json/sc\ + hema/properties/StudentAssessmentTaskResult\ + s/properties/StudentAssessmentTaskResult/it\ + ems/properties/StudentAssessmentTaskResultR\ + efId" + LocalId: + $ref: "#/paths/~1StudentAssessmentTaskResults/get\ + /responses/200/content/application~1json/sc\ + hema/properties/StudentAssessmentTaskResult\ + s/properties/StudentAssessmentTaskResult/it\ + ems/properties/StudentAssessmentTaskResultL\ + ocalId" + Name: + type: string + description:The normal descriptive name of the + referenced object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject + names, to be included in Object + References
Standard codes denoting the type of + assessment the student is sitting for the + assessment task.
A list of the providers involved and their + role, e.g. assessing provider, assessment + provider, assessment location provider, + registering provider.
+ type: object + required: + - ProviderInvolved + properties: + ProviderInvolved: + type: array + items: + description:The provider involved with the + assessment task and the role they play, + e.g. assessing provider, assessment + location provider, assessment provider, + registering provider.
+ type: object + required: + - ObjectType + - ProviderRole + properties: + ProviderRole: + type: string + title: Assessment Provider Role + description: >- +Code set denoting the role of the + provider in the assessment, e.g. + Assessing Provider, Location + Provider.
A list of the staff involved and their role + in relation to the assessment task, e.g. the + moderator, the marker.
+ type: object + required: + - StaffInvolved + properties: + StaffInvolved: + type: array + items: + description:The staff member involved with the + assessment task and their role, e.g. + created the assessment task, moderator, + marker.
+ type: object + required: + - ObjectType + - StaffRole + properties: + StaffRole: + type: string + title: Assessment Staff Role + description: |- + +A list of the subject areas that the + assessment pertains to.
+ type: object + properties: + SubjectAreaList: + type: array + items: + SubjectArea: + type: string + title: Subject Area + description: >- +Codes denoting Subject Areas defined + by the NZ Curriculum and Te Marautanga o + Aotearoa.
Codes denoting Subject Areas defined + by the NZQA for NCEA.
Year Level defines the values that are valid + for describing Funding Year Level and Current + Year Level for a student enrolment.
+Current Year Level indicates the year level + of the student’s class cohort and the level at + which the student spends most of their time at + school. While a student may be enrolled in + subjects at varying instructional year levels, + in relation to the student enrolment this value + represents the year level at which the student + is considered to be predominantly taught.
+Funding Year Level measures the actual number + of years that the student has attended a school. + It provides the Ministry with a method of + counting students for funding purposes which is + independent of the way schools are organised or + the particular programme of study that a student + may undertake. Funding Year Level for most + students is based on the date they first started + school.
School Year Level is used to + indicate the instructional year levels offered + by a school, i.e. those years for which student + enrolments may be accepted.
Codes denoting the two curricula used in New + Zealand.
Codes denoting the levels of the two + Curricula used in New Zealand.
The type of assessment tool used for the + assessment task.
+ Timeframe: + type: string + title: Assessment Timeframe + description: >- +The timeframe of the assessment, e.g. + Mid-Year, End of Year.
The attempt number the student is making to + pass this assessment, e.g. is it their first or + second attempt.
+ SummativeIndicator: + type: string + title: Yes Or No Category + description: >- +A reusable code set for yes, no, unknown and + not provided values.
Date the assessment task was marked.
+ DateAssessed: + type: string + format: date + description:Date the student was asssessed against this + assessment.
+ DateStudentNotified: + type: string + format: date + description:The date the student was notified of their + final mark for the assessment task.
+ PublishedDate: + type: string + format: date + description:The date the assessment task result was first + published in a report.
+ Iteration: + type: integer + description:The iteration of this result for the + assessment, e.g. some tasks require multiple + assessments before being achieved.
+ CreditsAchieved: + type: integer + description:The number of credits the student + achieved.
+ ResultScoreList: + description:A list of the assessment result scores that + the student received for this assessment + task.
+ type: object + required: + - ResultScore + properties: + ResultScore: + type: array + items: + description:An individual result score for the + assessment task.
+ type: object + properties: + Competency: + type: string + description:String describing a particular + competency that is being reported in + the assessment.
+ ScoreMetric: + type: string + title: Score Metric + description: >- +The type of score metric used for + an assessment task result.
The actual score
+ FinalResultValue: + type: string + description:The final result that was given to the + student for this assessment task.
+ EffortComment: + type: string + description:Free text comment about the effort the + student made for the assessment.
+ OtherComment: + type: string + description:Free text comments providing additional + information for the students assessment + result.
+ DocumentList: + description:List which describes the meta-data for, and + the Location of any associated documents.
+ type: object + required: + - Document + properties: + Document: + type: array + items: + $ref: "#/paths/~1StudentAssessmentTaskResults/g\ + et/responses/200/content/application~1jso\ + n/schema/properties/StudentAssessmentTask\ + Results/properties/StudentAssessmentTaskR\ + esult/items/properties/StudentAssessmentT\ + ask" + description:Records the result achieved by a single student + at a particular assessment task.
+ x-accessControl: + create: + - 1001 + - 2401 + - 2403 + read: + - 1001 + - 2401 + - 2403 + update: + - 1001 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: + - 2002 + - 2102 + example: + StudentAssessmentTaskResults: + StudentAssessmentTaskResult: + - StudentAssessmentTaskResultRefId: 359D7510-1AD0-A9D7-A8C3-DAD0A85103A2 + AssessmentType: INT + Student: + RefId: A75A0010-1A8C-301D-02E3-A05B359D0A00 + ProviderInvolvedList: + ProviderInvolved: + RefId: 11737EA4-301C-ADCA-75C8-7214A7C46BDB + ProviderRole: PRO + SubjectAreaList: + SubjectArea: MATH + SummativeIndicator: N + FormativeIndicator: Y + DateAssessed: 2018-11-21 + ResultScoreList: + ResultScore: + - ScoreMetric: RAW + ScoreValue: 25 + - ScoreMetric: SCA + ScoreValue: 38.5 + - ScoreMetric: MAR + ScoreValue: 5 + - ScoreMetric: STA + ScoreValue: 6 + - ScoreMetric: YEA + ScoreValue: 4 + application/xml: + schema: + type: object + properties: + StudentAssessmentTaskResults: + type: object + description: A List of StudentAssessmentTaskResult objects + properties: + StudentAssessmentTaskResult: + type: array + items: + $ref: "#/paths/~1StudentAssessmentTaskResults/get/respons\ + es/200/content/application~1json/schema/properties/\ + StudentAssessmentTaskResults/properties/StudentAsse\ + ssmentTaskResult/items" + example: >- +A GUID that identifies an instance of this object.
+ required: true + schema: + type: string + operationId: createStudentAssessmentTaskResult + requestBody: + description: CRUD operation on StudentAssessmentTaskResult + content: + application/json: + schema: + type: object + properties: + StudentAssessmentTaskResult: + $ref: "#/paths/~1StudentAssessmentTaskResults/get/responses/200/c\ + ontent/application~1json/schema/properties/StudentAssessmen\ + tTaskResults/properties/StudentAssessmentTaskResult/items" + example: + StudentAssessmentTaskResult: + StudentAssessmentTaskResultRefId: 359D7510-1AD0-A9D7-A8C3-DAD0A85103A2 + AssessmentType: INT + Student: + RefId: A75A0010-1A8C-301D-02E3-A05B359D0A00 + ProviderInvolvedList: + ProviderInvolved: + RefId: 11737EA4-301C-ADCA-75C8-7214A7C46BDB + ProviderRole: PRO + SubjectAreaList: + SubjectArea: MATH + SummativeIndicator: N + FormativeIndicator: Y + DateAssessed: 2018-11-21 + ResultScoreList: + ResultScore: + - ScoreMetric: RAW + ScoreValue: 25 + - ScoreMetric: SCA + ScoreValue: 38.5 + - ScoreMetric: MAR + ScoreValue: 5 + - ScoreMetric: STA + ScoreValue: 6 + - ScoreMetric: YEA + ScoreValue: 4 + application/xml: + schema: + type: object + properties: + StudentAssessmentTaskResult: + $ref: "#/paths/~1StudentAssessmentTaskResults/get/responses/200/c\ + ontent/application~1json/schema/properties/StudentAssessmen\ + tTaskResults/properties/StudentAssessmentTaskResult/items" + example: >- +A GUID that identifies an instance of this object.
+ required: true + schema: + type: string + operationId: updateStudentAssessmentTaskResult + requestBody: + description: CRUD operation on StudentAssessmentTaskResult + content: + application/json: + schema: + type: object + properties: + StudentAssessmentTaskResult: + type: object + properties: + StudentAssessmentTaskResultRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-\ + 9]{4}-[a-fA-F0-9]{12}" + StudentAssessmentTaskResultLocalId: + description:This is a common element used to define the locally + assigned identifier associated with an entity.
+ type: string + StudentAssessmentTask: + description:A reference to another SIF Data Object
+ type: object + properties: + RefId: + $ref: "#/paths/~1StudentAssessmentTaskResults~1%7BStudent\ + AssessmentTaskResultRefId%7D/put/requestBody/conten\ + t/application~1json/schema/properties/StudentAssess\ + mentTaskResult/properties/StudentAssessmentTaskResu\ + ltRefId" + LocalId: + $ref: "#/paths/~1StudentAssessmentTaskResults~1%7BStudent\ + AssessmentTaskResultRefId%7D/put/requestBody/conten\ + t/application~1json/schema/properties/StudentAssess\ + mentTaskResult/properties/StudentAssessmentTaskResu\ + ltLocalId" + Name: + type: string + description:The normal descriptive name of the referenced + object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject names, to + be included in Object References
Standard codes denoting the type of assessment the + student is sitting for the assessment task.
A list of the providers involved and their role, e.g. + assessing provider, assessment provider, assessment + location provider, registering provider.
+ type: object + properties: + ProviderInvolved: + type: array + items: + description:The provider involved with the assessment task + and the role they play, e.g. assessing provider, + assessment location provider, assessment provider, + registering provider.
+ type: object + properties: + ProviderRole: + type: string + title: Assessment Provider Role + description: >- +Code set denoting the role of the provider + in the assessment, e.g. Assessing Provider, + Location Provider.
A list of the staff involved and their role in + relation to the assessment task, e.g. the moderator, the + marker.
+ type: object + properties: + StaffInvolved: + type: array + items: + description:The staff member involved with the assessment + task and their role, e.g. created the assessment + task, moderator, marker.
+ type: object + properties: + StaffRole: + type: string + title: Assessment Staff Role + description: |- + +A list of the subject areas that the assessment + pertains to.
+ type: object + properties: + SubjectAreaList: + type: array + items: + SubjectArea: + type: string + title: Subject Area + description: >- +Codes denoting Subject Areas defined by the + NZ Curriculum and Te Marautanga o Aotearoa.
+Codes denoting Subject Areas defined by the + NZQA for NCEA.
Year Level defines the values that are valid for + describing Funding Year Level and Current Year Level for + a student enrolment.
Current Year Level indicates + the year level of the student’s class cohort and the + level at which the student spends most of their time at + school. While a student may be enrolled in subjects at + varying instructional year levels, in relation to the + student enrolment this value represents the year level + at which the student is considered to be predominantly + taught.
Funding Year Level measures the actual + number of years that the student has attended a school. + It provides the Ministry with a method of counting + students for funding purposes which is independent of + the way schools are organised or the particular + programme of study that a student may undertake. Funding + Year Level for most students is based on the date they + first started school.
School Year Level is used + to indicate the instructional year levels offered by a + school, i.e. those years for which student enrolments + may be accepted.
Codes denoting the two curricula used in New Zealand. +
Codes denoting the levels of the two Curricula used + in New Zealand.
The type of assessment tool used for the assessment + task.
+ Timeframe: + type: string + title: Assessment Timeframe + description: >- +The timeframe of the assessment, e.g. Mid-Year, End + of Year.
The attempt number the student is making to pass this + assessment, e.g. is it their first or second + attempt.
+ SummativeIndicator: + type: string + title: Yes Or No Category + description: >- +A reusable code set for yes, no, unknown and not + provided values.
Date the assessment task was marked.
+ DateAssessed: + type: string + format: date + description:Date the student was asssessed against this + assessment.
+ DateStudentNotified: + type: string + format: date + description:The date the student was notified of their final mark + for the assessment task.
+ PublishedDate: + type: string + format: date + description:The date the assessment task result was first + published in a report.
+ Iteration: + type: integer + description:The iteration of this result for the assessment, e.g. + some tasks require multiple assessments before being + achieved.
+ CreditsAchieved: + type: integer + description:The number of credits the student achieved.
+ ResultScoreList: + description:A list of the assessment result scores that the + student received for this assessment task.
+ type: object + properties: + ResultScore: + type: array + items: + description:An individual result score for the assessment + task.
+ type: object + properties: + Competency: + type: string + description:String describing a particular competency + that is being reported in the assessment.
+ ScoreMetric: + type: string + title: Score Metric + description: >- +The type of score metric used for an + assessment task result.
The actual score
+ FinalResultValue: + type: string + description:The final result that was given to the student for + this assessment task.
+ EffortComment: + type: string + description:Free text comment about the effort the student made + for the assessment.
+ OtherComment: + type: string + description:Free text comments providing additional information + for the students assessment result.
+ DocumentList: + description:List which describes the meta-data for, and the + Location of any associated documents.
+ type: object + properties: + Document: + type: array + items: + $ref: "#/paths/~1StudentAssessmentTaskResults~1%7BStude\ + ntAssessmentTaskResultRefId%7D/put/requestBody/co\ + ntent/application~1json/schema/properties/Student\ + AssessmentTaskResult/properties/StudentAssessment\ + Task" + description:Records the result achieved by a single student at a + particular assessment task.
+ x-accessControl: + create: + - 1001 + - 2401 + - 2403 + read: + - 1001 + - 2401 + - 2403 + update: + - 1001 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: + - 2002 + - 2102 + example: + StudentAssessmentTaskResult: + StudentAssessmentTaskResultRefId: 359D7510-1AD0-A9D7-A8C3-DAD0A85103A2 + AssessmentType: INT + Student: + RefId: A75A0010-1A8C-301D-02E3-A05B359D0A00 + ProviderInvolvedList: + ProviderInvolved: + RefId: 11737EA4-301C-ADCA-75C8-7214A7C46BDB + ProviderRole: PRO + SubjectAreaList: + SubjectArea: MATH + SummativeIndicator: N + FormativeIndicator: Y + DateAssessed: 2018-11-21 + ResultScoreList: + ResultScore: + - ScoreMetric: RAW + ScoreValue: 25 + - ScoreMetric: SCA + ScoreValue: 38.5 + - ScoreMetric: MAR + ScoreValue: 5 + - ScoreMetric: STA + ScoreValue: 6 + - ScoreMetric: YEA + ScoreValue: 4 + application/xml: + schema: + type: object + properties: + StudentAssessmentTaskResult: + $ref: "#/paths/~1StudentAssessmentTaskResults~1%7BStudentAssessme\ + ntTaskResultRefId%7D/put/requestBody/content/application~1j\ + son/schema/properties/StudentAssessmentTaskResult" + example: >- +A GUID that identifies an instance of this object.
+ required: true + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + StudentAssessmentTaskResult: + $ref: "#/paths/~1StudentAssessmentTaskResults/get/responses/200\ + /content/application~1json/schema/properties/StudentAsses\ + smentTaskResults/properties/StudentAssessmentTaskResult/i\ + tems" + example: + StudentAssessmentTaskResult: + StudentAssessmentTaskResultRefId: 359D7510-1AD0-A9D7-A8C3-DAD0A85103A2 + AssessmentType: INT + Student: + RefId: A75A0010-1A8C-301D-02E3-A05B359D0A00 + ProviderInvolvedList: + ProviderInvolved: + RefId: 11737EA4-301C-ADCA-75C8-7214A7C46BDB + ProviderRole: PRO + SubjectAreaList: + SubjectArea: MATH + SummativeIndicator: N + FormativeIndicator: Y + DateAssessed: 2018-11-21 + ResultScoreList: + ResultScore: + - ScoreMetric: RAW + ScoreValue: 25 + - ScoreMetric: SCA + ScoreValue: 38.5 + - ScoreMetric: MAR + ScoreValue: 5 + - ScoreMetric: STA + ScoreValue: 6 + - ScoreMetric: YEA + ScoreValue: 4 + application/xml: + schema: + type: object + properties: + StudentAssessmentTaskResult: + $ref: "#/paths/~1StudentAssessmentTaskResults/get/responses/200\ + /content/application~1json/schema/properties/StudentAsses\ + smentTaskResults/properties/StudentAssessmentTaskResult/i\ + tems" + example: >- +A GUID that identifies an instance of this object.
+ required: true + schema: + type: string + responses: + "200": + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + 200" + default: + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + default" + /StudentAttainments: + get: + tags: + - StudentAttainment + summary: Default operation to get a list of all available StudentAttainments + description: Search the set of available StudentAttainments, according to the search + criteria in the URL parameters. Returns the first 20 objects located; + with SIF defined navigation headers, indicating how to retrieve + subsequent sets of 20 objects. + parameters: + - name: LocalId + in: path + description: Search for object by LocalId, within the context of the organisation + represented by the ZoneId of the request. + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + StudentAttainments: + type: object + description: A List of StudentAttainment objects + properties: + StudentAttainment: + type: array + items: + required: + - Attainment + - GrantingProvider + - Student + type: object + properties: + StudentAttainmentRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[\ + a-fA-F0-9]{4}-[a-fA-F0-9]{12}" + StudentAttainmentLocalId: + description:This is a common element used to define the + locally assigned identifier associated with an + entity.
+ type: string + GrantingProvider: + description:A reference to another SIF Data Object
+ type: object + required: + - ObjectType + properties: + RefId: + $ref: "#/paths/~1StudentAttainments/get/responses\ + /200/content/application~1json/schema/prope\ + rties/StudentAttainments/properties/Student\ + Attainment/items/properties/StudentAttainme\ + ntRefId" + LocalId: + $ref: "#/paths/~1StudentAttainments/get/responses\ + /200/content/application~1json/schema/prope\ + rties/StudentAttainments/properties/Student\ + Attainment/items/properties/StudentAttainme\ + ntLocalId" + Name: + type: string + description:The normal descriptive name of the + referenced object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject + names, to be included in Object + References
The date the student achieved the + attainment.
+ YearAttained: + description:The year the student achieved the + attainment.
+ JustificationList: + description:A list of references identifying the + assessment task results that justify the student + achieving this attainment.
+ type: object + required: + - Justification + properties: + Justification: + type: array + items: + description:Details of an assessment task result or + other student attainment that justifies + the student achieving this attainment. +
+ type: object + required: + - Date + - ObjectType + - Result + properties: + AssessmentType: + type: string + title: Assessment Type + description: >- +Standard codes denoting the type of + assessment the student is sitting for + the assessment task.
The final result of the assessment + task that justifies the + attainment.
+ Date: + type: string + format: date + description:The date the justifying assessment + task was achieved.
+ CreditValue: + description:The number of credits the + justifying assessment task contributes + towards this attainment.
+ SubjectAreaList: + description:Code denoting the Learning or Subject Area + the assessment task is for.
+ type: object + properties: + SubjectAreaList: + type: array + items: + SubjectArea: + type: string + title: Subject Area + description: >- +Codes denoting Subject Areas defined + by the NZ Curriculum and Te Marautanga o + Aotearoa.
Codes denoting Subject Areas defined + by the NZQA for NCEA.
The level of NCEA endorsement the student + received for the attainment.
Records a student gaining an Attainment e.g. NCEA + Qualification, Learning Standard etc.
+ x-accessControl: + create: + - 1001 + - 2401 + - 2403 + read: + - 1001 + - 2401 + - 2403 + update: + - 1001 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: + - 2002 + - 2102 + example: + StudentAttainments: + StudentAttainment: + - StudentAttainmentRefId: 359D7510-1AD0-A9D7-A8C3-DAD0A85103A2 + GrantingProvider: + RefId: 11737EA4-301C-ADCA-75C8-7214A7C46BDB + Attainment: + RefId: D0A0A27A-D0A8-510A-D9D7-5101A8C3DA39 + Name: NCEA Level 2 Chemistry - Endorsed with merit + ObjectType: Credential + Student: + RefId: cd106d6d-d9d5-41fb-9943-5feb967c9435 + LocalId: HP85-1039 + Name: Harry Potter + DateAttained: 2018-07-25 + JustificationList: + Justification: + - RefId: 2752a16b-b62a-4973-9d44-23e13e1c037b + LocalId: 91165-v2 + Name: Demonstrate understanding of the properties of + selected organic compounds + ObjectType: StudentAssessmentTaskResult + AssessmentType: EXT + Result: Achieved + Date: 2016-06-28 + CreditValue: 4 + - RefId: eca0da5d-94af-4223-aaa6-7c0083006efd + LocalId: 91166-v2 + Name: Demonstrate understanding of chemical reactivity + ObjectType: StudentAssessmentTaskResult + AssessmentType: INT + Result: Achieved with merit + Date: 2016-06-01 + CreditValue: 3 + - RefId: 12f4761d-5e97-4e12-804e-e16d882c86c7 + LocalId: 91167-v2 + Name: Demonstrate understanding of oxidation-reduction + ObjectType: StudentAssessmentTaskResult + AssessmentType: EXT + Result: Achieved + Date: 2016-06-28 + CreditValue: 3 + SubjectAreaList: + SubjectArea: CHEM + application/xml: + schema: + type: object + properties: + StudentAttainments: + type: object + description: A List of StudentAttainment objects + properties: + StudentAttainment: + type: array + items: + $ref: "#/paths/~1StudentAttainments/get/responses/200/con\ + tent/application~1json/schema/properties/StudentAtt\ + ainments/properties/StudentAttainment/items" + example: >- +A GUID that identifies an instance of this object.
+ required: true + schema: + type: string + operationId: createStudentAttainment + requestBody: + description: CRUD operation on StudentAttainment + content: + application/json: + schema: + type: object + properties: + StudentAttainment: + $ref: "#/paths/~1StudentAttainments/get/responses/200/content/app\ + lication~1json/schema/properties/StudentAttainments/propert\ + ies/StudentAttainment/items" + example: + StudentAttainment: + StudentAttainmentRefId: 359D7510-1AD0-A9D7-A8C3-DAD0A85103A2 + GrantingProvider: + RefId: 11737EA4-301C-ADCA-75C8-7214A7C46BDB + Attainment: + RefId: D0A0A27A-D0A8-510A-D9D7-5101A8C3DA39 + Name: NCEA Level 2 Chemistry - Endorsed with merit + ObjectType: Credential + Student: + RefId: cd106d6d-d9d5-41fb-9943-5feb967c9435 + LocalId: HP85-1039 + Name: Harry Potter + DateAttained: 2018-07-25 + JustificationList: + Justification: + - RefId: 2752a16b-b62a-4973-9d44-23e13e1c037b + LocalId: 91165-v2 + Name: Demonstrate understanding of the properties of selected + organic compounds + ObjectType: StudentAssessmentTaskResult + AssessmentType: EXT + Result: Achieved + Date: 2016-06-28 + CreditValue: 4 + - RefId: eca0da5d-94af-4223-aaa6-7c0083006efd + LocalId: 91166-v2 + Name: Demonstrate understanding of chemical reactivity + ObjectType: StudentAssessmentTaskResult + AssessmentType: INT + Result: Achieved with merit + Date: 2016-06-01 + CreditValue: 3 + - RefId: 12f4761d-5e97-4e12-804e-e16d882c86c7 + LocalId: 91167-v2 + Name: Demonstrate understanding of oxidation-reduction + ObjectType: StudentAssessmentTaskResult + AssessmentType: EXT + Result: Achieved + Date: 2016-06-28 + CreditValue: 3 + SubjectAreaList: + SubjectArea: CHEM + application/xml: + schema: + type: object + properties: + StudentAttainment: + $ref: "#/paths/~1StudentAttainments/get/responses/200/content/app\ + lication~1json/schema/properties/StudentAttainments/propert\ + ies/StudentAttainment/items" + example: >- +A GUID that identifies an instance of this object.
+ required: true + schema: + type: string + operationId: updateStudentAttainment + requestBody: + description: CRUD operation on StudentAttainment + content: + application/json: + schema: + type: object + properties: + StudentAttainment: + type: object + properties: + StudentAttainmentRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-\ + 9]{4}-[a-fA-F0-9]{12}" + StudentAttainmentLocalId: + description:This is a common element used to define the locally + assigned identifier associated with an entity.
+ type: string + GrantingProvider: + description:A reference to another SIF Data Object
+ type: object + properties: + RefId: + $ref: "#/paths/~1StudentAttainments~1%7BStudentAttainment\ + RefId%7D/put/requestBody/content/application~1json/\ + schema/properties/StudentAttainment/properties/Stud\ + entAttainmentRefId" + LocalId: + $ref: "#/paths/~1StudentAttainments~1%7BStudentAttainment\ + RefId%7D/put/requestBody/content/application~1json/\ + schema/properties/StudentAttainment/properties/Stud\ + entAttainmentLocalId" + Name: + type: string + description:The normal descriptive name of the referenced + object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject names, to + be included in Object References
The date the student achieved the attainment.
+ YearAttained: + description:The year the student achieved the attainment.
+ JustificationList: + description:A list of references identifying the assessment task + results that justify the student achieving this + attainment.
+ type: object + properties: + Justification: + type: array + items: + description:Details of an assessment task result or other + student attainment that justifies the student + achieving this attainment.
+ type: object + properties: + AssessmentType: + type: string + title: Assessment Type + description: >- +Standard codes denoting the type of + assessment the student is sitting for the + assessment task.
The final result of the assessment task + that justifies the attainment.
+ Date: + type: string + format: date + description:The date the justifying assessment task was + achieved.
+ CreditValue: + description:The number of credits the justifying + assessment task contributes towards this + attainment.
+ SubjectAreaList: + description:Code denoting the Learning or Subject Area the + assessment task is for.
+ type: object + properties: + SubjectAreaList: + type: array + items: + SubjectArea: + type: string + title: Subject Area + description: >- +Codes denoting Subject Areas defined by the + NZ Curriculum and Te Marautanga o Aotearoa.
+Codes denoting Subject Areas defined by the + NZQA for NCEA.
The level of NCEA endorsement the student received + for the attainment.
Records a student gaining an Attainment e.g. NCEA + Qualification, Learning Standard etc.
+ x-accessControl: + create: + - 1001 + - 2401 + - 2403 + read: + - 1001 + - 2401 + - 2403 + update: + - 1001 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: + - 2002 + - 2102 + example: + StudentAttainment: + StudentAttainmentRefId: 359D7510-1AD0-A9D7-A8C3-DAD0A85103A2 + GrantingProvider: + RefId: 11737EA4-301C-ADCA-75C8-7214A7C46BDB + Attainment: + RefId: D0A0A27A-D0A8-510A-D9D7-5101A8C3DA39 + Name: NCEA Level 2 Chemistry - Endorsed with merit + ObjectType: Credential + Student: + RefId: cd106d6d-d9d5-41fb-9943-5feb967c9435 + LocalId: HP85-1039 + Name: Harry Potter + DateAttained: 2018-07-25 + JustificationList: + Justification: + - RefId: 2752a16b-b62a-4973-9d44-23e13e1c037b + LocalId: 91165-v2 + Name: Demonstrate understanding of the properties of selected + organic compounds + ObjectType: StudentAssessmentTaskResult + AssessmentType: EXT + Result: Achieved + Date: 2016-06-28 + CreditValue: 4 + - RefId: eca0da5d-94af-4223-aaa6-7c0083006efd + LocalId: 91166-v2 + Name: Demonstrate understanding of chemical reactivity + ObjectType: StudentAssessmentTaskResult + AssessmentType: INT + Result: Achieved with merit + Date: 2016-06-01 + CreditValue: 3 + - RefId: 12f4761d-5e97-4e12-804e-e16d882c86c7 + LocalId: 91167-v2 + Name: Demonstrate understanding of oxidation-reduction + ObjectType: StudentAssessmentTaskResult + AssessmentType: EXT + Result: Achieved + Date: 2016-06-28 + CreditValue: 3 + SubjectAreaList: + SubjectArea: CHEM + application/xml: + schema: + type: object + properties: + StudentAttainment: + $ref: "#/paths/~1StudentAttainments~1%7BStudentAttainmentRefId%7D\ + /put/requestBody/content/application~1json/schema/propertie\ + s/StudentAttainment" + example: >- +A GUID that identifies an instance of this object.
+ required: true + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + StudentAttainment: + $ref: "#/paths/~1StudentAttainments/get/responses/200/content/a\ + pplication~1json/schema/properties/StudentAttainments/pro\ + perties/StudentAttainment/items" + example: + StudentAttainment: + StudentAttainmentRefId: 359D7510-1AD0-A9D7-A8C3-DAD0A85103A2 + GrantingProvider: + RefId: 11737EA4-301C-ADCA-75C8-7214A7C46BDB + Attainment: + RefId: D0A0A27A-D0A8-510A-D9D7-5101A8C3DA39 + Name: NCEA Level 2 Chemistry - Endorsed with merit + ObjectType: Credential + Student: + RefId: cd106d6d-d9d5-41fb-9943-5feb967c9435 + LocalId: HP85-1039 + Name: Harry Potter + DateAttained: 2018-07-25 + JustificationList: + Justification: + - RefId: 2752a16b-b62a-4973-9d44-23e13e1c037b + LocalId: 91165-v2 + Name: Demonstrate understanding of the properties of + selected organic compounds + ObjectType: StudentAssessmentTaskResult + AssessmentType: EXT + Result: Achieved + Date: 2016-06-28 + CreditValue: 4 + - RefId: eca0da5d-94af-4223-aaa6-7c0083006efd + LocalId: 91166-v2 + Name: Demonstrate understanding of chemical reactivity + ObjectType: StudentAssessmentTaskResult + AssessmentType: INT + Result: Achieved with merit + Date: 2016-06-01 + CreditValue: 3 + - RefId: 12f4761d-5e97-4e12-804e-e16d882c86c7 + LocalId: 91167-v2 + Name: Demonstrate understanding of oxidation-reduction + ObjectType: StudentAssessmentTaskResult + AssessmentType: EXT + Result: Achieved + Date: 2016-06-28 + CreditValue: 3 + SubjectAreaList: + SubjectArea: CHEM + application/xml: + schema: + type: object + properties: + StudentAttainment: + $ref: "#/paths/~1StudentAttainments/get/responses/200/content/a\ + pplication~1json/schema/properties/StudentAttainments/pro\ + perties/StudentAttainment/items" + example: >- +A GUID that identifies an instance of this object.
+ required: true + schema: + type: string + responses: + "200": + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + 200" + default: + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + default" + /StudentCurriculumProgressReports: + get: + tags: + - StudentCurriculumProgressReport + summary: Default operation to get a list of all available + StudentCurriculumProgressReports + description: Search the set of available StudentCurriculumProgressReports, according + to the search criteria in the URL parameters. Returns the first 20 + objects located; with SIF defined navigation headers, indicating how to + retrieve subsequent sets of 20 objects. + parameters: + - name: LocalId + in: path + description: Search for object by LocalId, within the context of the organisation + represented by the ZoneId of the request. + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + StudentCurriculumProgressReports: + type: object + description: A List of StudentCurriculumProgressReport objects + properties: + StudentCurriculumProgressReport: + type: array + items: + required: + - Provider + - Student + - TeachingGroup + type: object + properties: + StudentCurriculumProgressReportRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[\ + a-fA-F0-9]{4}-[a-fA-F0-9]{12}" + StudentCurriculumProgressReportLocalId: + description:This is a common element used to define the + locally assigned identifier associated with an + entity.
+ type: string + Student: + description:A reference to another SIF Data Object
+ type: object + required: + - ObjectType + properties: + RefId: + $ref: "#/paths/~1StudentCurriculumProgressReports\ + /get/responses/200/content/application~1jso\ + n/schema/properties/StudentCurriculumProgre\ + ssReports/properties/StudentCurriculumProgr\ + essReport/items/properties/StudentCurriculu\ + mProgressReportRefId" + LocalId: + $ref: "#/paths/~1StudentCurriculumProgressReports\ + /get/responses/200/content/application~1jso\ + n/schema/properties/StudentCurriculumProgre\ + ssReports/properties/StudentCurriculumProgr\ + essReport/items/properties/StudentCurriculu\ + mProgressReportLocalId" + Name: + type: string + description:The normal descriptive name of the + referenced object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject + names, to be included in Object + References
A list of StaffMembers who are the authors of + the curriculum progress report
+ type: object + required: + - Author + properties: + Author: + type: array + items: + $ref: "#/paths/~1StudentCurriculumProgressRepor\ + ts/get/responses/200/content/application~\ + 1json/schema/properties/StudentCurriculum\ + ProgressReports/properties/StudentCurricu\ + lumProgressReport/items/properties/Studen\ + t" + RepositoryReceivedDate: + type: string + format: date + description:The date the repository received the students + technology centre progress and achievement + report.
+ TimeFrame: + type: string + title: Curriculum Progress Report Timeframe + description: >- +Codes denoting the period of time that a + Curriculum Progress Report applies to.
A list of records of the Student's progress + in particular classes from the Technology + curriculum. e.g. Hard Materials, Food + Technology, Digital Design etc.
+ type: object + required: + - TechnologyClass + properties: + TechnologyClass: + type: array + items: + description:A record of the Student's progress in a + particular class from the Technology + curriculum.
+ type: object + required: + - Class + properties: + Class: + type: string + title: Technology Class + description: >- +Code set denoting a class or + subject area from the technology + curriculum that the progress report + covers.
Overall comment about the behaviour + of the student over the course of the + lessons in the Class.
+ EffortComment: + type: string + description:Overall comment about the effort + the student has made in class
+ StrandList: + description:A record of the Student's progress + in a set of learning strands from the + Technology curriculum, that were + covered in the class
+ type: object + required: + - Strand + properties: + Strand: + type: array + items: + description:A record of the Student's + progress in a particular + learning strand from the + Technology curriculum, that was + covered in the class.
+ type: object + required: + - LearningStrand + properties: + LearningStrand: + type: string + title: Technology Learning Strand + description: >- +Code list denoting the + learning strands from the + Technology curriculum that + can be covered as part of a + technology class.
A record of the Student's + progress in a set of + achievement objectives from + the from the Technology + curriculum strand, that was + covered in the class.
+ type: object + required: + - AchievementObjective + properties: + AchievementObjective: + type: array + items: + description:A record of the + Student's progress in + a particular + achievement objective + from the Technology + curriculum strand, + that was covered in + the class.
+ type: object + required: + - AchievementObjective + properties: + AchievementObjective: + type: string + title: Strand Achievement + Objective + description: >- +Code set + denoting achievement + objectives against + which a student can + be assessed within a + Learning Strand.
+Code set + denoting the + technology + curriculum level + that the student's + progress report is + being made against. + e.g. 2, 3, 4 or + 5.
Code set + denoting the level + of progress the + student has made + against the learning + strand achievement + objectiv. e.g. + Beginner, + Proficient, and + Advanced.
A description + of what the + achievement + objective + covers.
+ OverallStudentEffortNote: + type: string + description:A note about + the student's + overall effort in + relation to this + achievement + objective for this + strand.
+ PracticalAbilityDesc: + type: string + description:A description + of practical ability + covered by the + achievement + objective for the + strand.
+ PracticalAbilityProgressNote: + type: string + description:A note about + the student's + practical ability + progress in relation + to this achievement + objective for this + strand.
+ DocumentList: + description:Documents that + relate to students + progress in this + strand achievement + objective, e.g. + report, photos, + media, documents + etc.
+ type: object + required: + - Document + properties: + Document: + type: array + items: + $ref: "#/paths/~1\ + StudentCurriculumPr\ + ogressReports/get/r\ + esponses/200/conten\ + t/application~1json\ + /schema/properties/\ + StudentCurriculumPr\ + ogressReports/prope\ + rties/StudentCurric\ + ulumProgressReport/\ + items/properties/St\ + udent" + description:A single curriculum progress and achievement + report provided for a student. Used in technology + centres allowing the host provider to report on + student progress to their base school.
May + be extended in the future to cover reporting on + other curriculum areas.
+ x-accessControl: + create: + - 1001 + - 2401 + - 2403 + read: + - 1001 + - 2401 + - 2403 + update: + - 1001 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: + - 2002 + - 2102 + example: + StudentCurriculumProgressReports: + StudentCurriculumProgressReport: + - StudentCurriculumProgressReportRefId: 2FFB63B4-CFEF-4820-8501-E7D1E54555CB + Student: + RefId: CA285746-359D-7510-1A8C-36432A901A16 + Provider: + RefId: 407405d9-caae-4853-a397-4053e0cda895 + TeachingGroup: + RefId: 4f6dce25-cca6-49ef-8be4-675e2cfce8b8 + LocalId: HM8P + Name: Year 8 Hard Materials, Pinehurst School + AuthorList: + Author: + - RefId: 1b6fabed-2af9-4395-b48c-f46c8edb1b78 + LocalId: SMcG + Name: Steve McGannaway + TimeFrame: TRM + TechnologyClassList: + TechnologyClass: + - Class: HM + BehaviourComment: Excellent + EffortComment: Not particularly interested, attention wanders + StrandList: + Strand: + - LearningStrand: TP + AchievementObjectiveList: + AchievementObjective: + - AchievementObjective: BD + CurriculumLevel: 2 + ProgressLevel: B + AchievementObjectiveDesc: Brief Development in hard materials + OverallStudentEffortNote: Not particularly interested, attention + wanders + PracticalAbilityDesc: Beginner + PracticalAbilityProgressNote: Struggles with the planning required + application/xml: + schema: + type: object + properties: + StudentCurriculumProgressReports: + type: object + description: A List of StudentCurriculumProgressReport objects + properties: + StudentCurriculumProgressReport: + type: array + items: + $ref: "#/paths/~1StudentCurriculumProgressReports/get/res\ + ponses/200/content/application~1json/schema/propert\ + ies/StudentCurriculumProgressReports/properties/Stu\ + dentCurriculumProgressReport/items" + example: >- +The ID (GUID) assigned to uniquely identify this Student + Curriculum Progress Report.
+ required: true + schema: + type: string + operationId: createStudentCurriculumProgressReport + requestBody: + description: CRUD operation on StudentCurriculumProgressReport + content: + application/json: + schema: + type: object + properties: + StudentCurriculumProgressReport: + $ref: "#/paths/~1StudentCurriculumProgressReports/get/responses/2\ + 00/content/application~1json/schema/properties/StudentCurri\ + culumProgressReports/properties/StudentCurriculumProgressRe\ + port/items" + example: + StudentCurriculumProgressReport: + StudentCurriculumProgressReportRefId: 2FFB63B4-CFEF-4820-8501-E7D1E54555CB + Student: + RefId: CA285746-359D-7510-1A8C-36432A901A16 + Provider: + RefId: 407405d9-caae-4853-a397-4053e0cda895 + TeachingGroup: + RefId: 4f6dce25-cca6-49ef-8be4-675e2cfce8b8 + LocalId: HM8P + Name: Year 8 Hard Materials, Pinehurst School + AuthorList: + Author: + - RefId: 1b6fabed-2af9-4395-b48c-f46c8edb1b78 + LocalId: SMcG + Name: Steve McGannaway + TimeFrame: TRM + TechnologyClassList: + TechnologyClass: + - Class: HM + BehaviourComment: Excellent + EffortComment: Not particularly interested, attention wanders + StrandList: + Strand: + - LearningStrand: TP + AchievementObjectiveList: + AchievementObjective: + - AchievementObjective: BD + CurriculumLevel: 2 + ProgressLevel: B + AchievementObjectiveDesc: Brief Development in hard materials + OverallStudentEffortNote: Not particularly interested, attention + wanders + PracticalAbilityDesc: Beginner + PracticalAbilityProgressNote: Struggles with the planning required + application/xml: + schema: + type: object + properties: + StudentCurriculumProgressReport: + $ref: "#/paths/~1StudentCurriculumProgressReports/get/responses/2\ + 00/content/application~1json/schema/properties/StudentCurri\ + culumProgressReports/properties/StudentCurriculumProgressRe\ + port/items" + example: >- +The ID (GUID) assigned to uniquely identify this Student + Curriculum Progress Report.
+ required: true + schema: + type: string + operationId: updateStudentCurriculumProgressReport + requestBody: + description: CRUD operation on StudentCurriculumProgressReport + content: + application/json: + schema: + type: object + properties: + StudentCurriculumProgressReport: + type: object + properties: + StudentCurriculumProgressReportRefId: + description: An object or element identifier. + type: string + pattern: "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-\ + 9]{4}-[a-fA-F0-9]{12}" + StudentCurriculumProgressReportLocalId: + description:This is a common element used to define the locally + assigned identifier associated with an entity.
+ type: string + Student: + description:A reference to another SIF Data Object
+ type: object + properties: + RefId: + $ref: "#/paths/~1StudentCurriculumProgressReports~1%7BStu\ + dentCurriculumProgressReportRefId%7D/put/requestBod\ + y/content/application~1json/schema/properties/Stude\ + ntCurriculumProgressReport/properties/StudentCurric\ + ulumProgressReportRefId" + LocalId: + $ref: "#/paths/~1StudentCurriculumProgressReports~1%7BStu\ + dentCurriculumProgressReportRefId%7D/put/requestBod\ + y/content/application~1json/schema/properties/Stude\ + ntCurriculumProgressReport/properties/StudentCurric\ + ulumProgressReportLocalId" + Name: + type: string + description:The normal descriptive name of the referenced + object.
+ ObjectType: + type: string + title: Referrable Data Objects + description: >- +An enumeration of valid SIF DataObject names, to + be included in Object References
A list of StaffMembers who are the authors of the + curriculum progress report
+ type: object + properties: + Author: + type: array + items: + $ref: "#/paths/~1StudentCurriculumProgressReports~1%7BS\ + tudentCurriculumProgressReportRefId%7D/put/reques\ + tBody/content/application~1json/schema/properties\ + /StudentCurriculumProgressReport/properties/Stude\ + nt" + RepositoryReceivedDate: + type: string + format: date + description:The date the repository received the students + technology centre progress and achievement report.
+ TimeFrame: + type: string + title: Curriculum Progress Report Timeframe + description: >- +Codes denoting the period of time that a Curriculum + Progress Report applies to.
A list of records of the Student's progress in + particular classes from the Technology curriculum. e.g. + Hard Materials, Food Technology, Digital Design etc.
+ type: object + properties: + TechnologyClass: + type: array + items: + description:A record of the Student's progress in a + particular class from the Technology curriculum. +
+ type: object + properties: + Class: + type: string + title: Technology Class + description: >- +Code set denoting a class or subject area + from the technology curriculum that the + progress report covers.
Overall comment about the behaviour of the + student over the course of the lessons in the + Class.
+ EffortComment: + type: string + description:Overall comment about the effort the + student has made in class
+ StrandList: + description:A record of the Student's progress in a set + of learning strands from the Technology + curriculum, that were covered in the class
+ type: object + properties: + Strand: + type: array + items: + description:A record of the Student's progress in + a particular learning strand from the + Technology curriculum, that was covered + in the class.
+ type: object + properties: + LearningStrand: + type: string + title: Technology Learning Strand + description: >- +Code list denoting the learning + strands from the Technology + curriculum that can be covered as + part of a technology class.
A record of the Student's + progress in a set of achievement + objectives from the from the + Technology curriculum strand, that + was covered in the class.
+ type: object + properties: + AchievementObjective: + type: array + items: + description:A record of the Student's + progress in a particular + achievement objective from the + Technology curriculum strand, + that was covered in the class. +
+ type: object + properties: + AchievementObjective: + type: string + title: Strand Achievement + Objective + description: >- +Code set denoting + achievement objectives + against which a student + can be assessed within a + Learning Strand.
Code set denoting the + technology curriculum + level that the student's + progress report is being + made against. e.g. 2, 3, 4 + or 5.
Code set denoting the + level of progress the + student has made against + the learning strand + achievement objectiv. e.g. + Beginner, Proficient, and + Advanced.
A description of what + the achievement objective + covers.
+ OverallStudentEffortNote: + type: string + description:A note about the + student's overall effort + in relation to this + achievement objective for + this strand.
+ PracticalAbilityDesc: + type: string + description:A description of + practical ability covered + by the achievement + objective for the + strand.
+ PracticalAbilityProgressNote: + type: string + description:A note about the + student's practical + ability progress in + relation to this + achievement objective for + this strand.
+ DocumentList: + description:Documents that relate + to students progress in + this strand achievement + objective, e.g. report, + photos, media, documents + etc.
+ type: object + properties: + Document: + type: array + items: + $ref: "#/paths/~1StudentC\ + urriculumProgressRe\ + ports~1%7BStudentCu\ + rriculumProgressRep\ + ortRefId%7D/put/req\ + uestBody/content/ap\ + plication~1json/sch\ + ema/properties/Stud\ + entCurriculumProgre\ + ssReport/properties\ + /Student" + description:A single curriculum progress and achievement report + provided for a student. Used in technology centres allowing + the host provider to report on student progress to their + base school.
May be extended in the future to cover + reporting on other curriculum areas.
+ x-accessControl: + create: + - 1001 + - 2401 + - 2403 + read: + - 1001 + - 2401 + - 2403 + update: + - 1001 + - 2401 + - 2403 + delete: + - 1001 + - 2401 + - 2403 + aggregate: + - 2002 + - 2102 + example: + StudentCurriculumProgressReport: + StudentCurriculumProgressReportRefId: 2FFB63B4-CFEF-4820-8501-E7D1E54555CB + Student: + RefId: CA285746-359D-7510-1A8C-36432A901A16 + Provider: + RefId: 407405d9-caae-4853-a397-4053e0cda895 + TeachingGroup: + RefId: 4f6dce25-cca6-49ef-8be4-675e2cfce8b8 + LocalId: HM8P + Name: Year 8 Hard Materials, Pinehurst School + AuthorList: + Author: + - RefId: 1b6fabed-2af9-4395-b48c-f46c8edb1b78 + LocalId: SMcG + Name: Steve McGannaway + TimeFrame: TRM + TechnologyClassList: + TechnologyClass: + - Class: HM + BehaviourComment: Excellent + EffortComment: Not particularly interested, attention wanders + StrandList: + Strand: + - LearningStrand: TP + AchievementObjectiveList: + AchievementObjective: + - AchievementObjective: BD + CurriculumLevel: 2 + ProgressLevel: B + AchievementObjectiveDesc: Brief Development in hard materials + OverallStudentEffortNote: Not particularly interested, attention + wanders + PracticalAbilityDesc: Beginner + PracticalAbilityProgressNote: Struggles with the planning required + application/xml: + schema: + type: object + properties: + StudentCurriculumProgressReport: + $ref: "#/paths/~1StudentCurriculumProgressReports~1%7BStudentCurr\ + iculumProgressReportRefId%7D/put/requestBody/content/applic\ + ation~1json/schema/properties/StudentCurriculumProgressRepo\ + rt" + example: >- +The ID (GUID) assigned to uniquely identify this Student + Curriculum Progress Report.
+ required: true + schema: + type: string + responses: + "200": + description: successful operation + content: + application/json: + schema: + type: object + properties: + StudentCurriculumProgressReport: + $ref: "#/paths/~1StudentCurriculumProgressReports/get/responses\ + /200/content/application~1json/schema/properties/StudentC\ + urriculumProgressReports/properties/StudentCurriculumProg\ + ressReport/items" + example: + StudentCurriculumProgressReport: + StudentCurriculumProgressReportRefId: 2FFB63B4-CFEF-4820-8501-E7D1E54555CB + Student: + RefId: CA285746-359D-7510-1A8C-36432A901A16 + Provider: + RefId: 407405d9-caae-4853-a397-4053e0cda895 + TeachingGroup: + RefId: 4f6dce25-cca6-49ef-8be4-675e2cfce8b8 + LocalId: HM8P + Name: Year 8 Hard Materials, Pinehurst School + AuthorList: + Author: + - RefId: 1b6fabed-2af9-4395-b48c-f46c8edb1b78 + LocalId: SMcG + Name: Steve McGannaway + TimeFrame: TRM + TechnologyClassList: + TechnologyClass: + - Class: HM + BehaviourComment: Excellent + EffortComment: Not particularly interested, attention wanders + StrandList: + Strand: + - LearningStrand: TP + AchievementObjectiveList: + AchievementObjective: + - AchievementObjective: BD + CurriculumLevel: 2 + ProgressLevel: B + AchievementObjectiveDesc: Brief Development in hard materials + OverallStudentEffortNote: Not particularly interested, attention + wanders + PracticalAbilityDesc: Beginner + PracticalAbilityProgressNote: Struggles with the planning required + application/xml: + schema: + type: object + properties: + StudentCurriculumProgressReport: + $ref: "#/paths/~1StudentCurriculumProgressReports/get/responses\ + /200/content/application~1json/schema/properties/StudentC\ + urriculumProgressReports/properties/StudentCurriculumProg\ + ressReport/items" + example: >- +The ID (GUID) assigned to uniquely identify this Student + Curriculum Progress Report.
+ required: true + schema: + type: string + responses: + "200": + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + 200" + default: + $ref: "#/paths/~1ScheduleTerms~1%7BScheduleTermRefId%7D/delete/responses/\ + default" +components: + errors: + query: + description: Failed to retrieve object(s). content: application/json: schema: - allOf: - - description: My Pet - title: Pettie - - $ref: '#/components/schemas/Pet' + type: object + properties: + error: + required: + - code + - message + - scope + type: object + properties: + id: + type: string + description:Optional identifier for the error, that can be used to + track the failed operation through the system audit + logs
+ 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).\"
" application/xml: schema: - type: 'object' + type: object properties: - name: - type: string - description: hooray - description: Pet object that needs to be added to the store - required: true - UserArray: + error: + $ref: "#/components/errors/query/content/application~1json/schema/p\ + roperties/error" + create: + description: Failed to create object(s). content: application/json: schema: - type: array - items: - $ref: '#/components/schemas/User' - description: List of user object - required: true - securitySchemes: - petstore_auth: - description: | - Get access to data while protecting your account credentials. - OAuth2 is also a safer and more secure way to give you access. - type: oauth2 - flows: - implicit: - authorizationUrl: 'http://petstore.swagger.io/api/oauth/dialog' - scopes: - 'write:pets': modify pets in your account - 'read:pets': read your pets - api_key: - description: > - For this sample, you can use the api key `special-key` to test the - authorization filters. - type: apiKey - name: api_key - in: header + type: object + required: + - creates + properties: + creates: + type: object + description: For each requested object successfully created, an internal + status of 201 (Created) and the service-assigned refId of the + newly created object. For each requested object that failed + to be created indicated by an error statusCode and a + corresponding error payload. + required: + - create + properties: + create: + type: array + items: + type: object + required: + - advisoryId + properties: + id: + type: string + description: For successful create requests, the RefId of the + newly created object, which may not be the RefId + from the original create object request; indeed the + original request create request may have only + provided a LocalId. qv. advisoryId. + xml: + attribute: true + advisoryId: + type: string + description: The RefId, or LocalId from the object create + request; Used to cross-reference this create + response to the original create request, allowing + the client to correctly followup successful and + failed create requests. + xml: + attribute: true + statusCode: + type: string + description: The internal HTTP status for this particular create + object request; Use code 201 (Created) for + successful object creations Where the object create + has failed, use standard HTTP error codes in the 4xx + (Client Error) and 5xx (Server Error) ranges. + xml: + attribute: true + error: + type: object + description: Detailed description of the operation that failed, + and the reasons why. + required: + - code + - message + - scope + properties: + id: + type: string + description: An optional identifier for the Error, that may + be used to track the failed create operation + through the system audit logs. + 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).\"
" + 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 + (Created) and the service-assigned refId. Any requested object + that failed to be created is indicated by an error statusCode and + a corresponding error payload.
+ application/xml: + schema: + $ref: "#/components/errors/create/content/application~1json/schema" + update: + description: Failed to update object(s). + content: + application/json: + schema: + required: + - updates + type: object + properties: + updates: + type: object + description: For each requested object successfully updated, an internal + status of 20O (Ok) and the service-assigned refId of the + updated object. For each requested object that failed to be + updated indicated by an error statusCode and a corresponding + error payload. + required: + - update + properties: + update: + type: array + items: + type: object + properties: + id: + description: For successful update requests, the RefId of the + newly updated object + type: string + xml: + attribute: true + statusCode: + type: string + description: "The internal HTTP status for this particular update + object request; Use code 200 (Ok) for successful + object updates Where the update has failed use + standard HTTP error codes in the 4xx (Client Error) + and 5xx (Server Error) ranges. " + xml: + attribute: true + error: + required: + - code + - message + - scope + type: object + properties: + id: + type: string + description: An optional identifier for the Error, that may + be used to track the failed update operation + through the system audit logs. + 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).\"
" + 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.
+ application/xml: + schema: + $ref: "#/components/errors/update/content/application~1json/schema" + delete: + description: Failed to delete object(s). + content: + application/json: + schema: + required: + - deletes + type: object + properties: + deletes: + type: object + description: "For each requested object successfully deleted, an internal + status of 200 (Ok) and the service-assigned refId of the + deleted object. For each requested object that failed to be + deleted indicated by an error statusCode and a corresponding + error payload. " + required: + - delete + properties: + delete: + type: array + items: + type: object + properties: + id: + type: string + description: "For successful delete requests, the RefId of the + newly deleted object. " + xml: + attribute: true + statusCode: + type: string + description: The internal HTTP status for this particular delete + object request; Use code 200 (Ok) for successful + object deletions Where the object delete has failed, + use standard HTTP error codes in the 4xx (Client + Error) and 5xx (Server Error) ranges. + xml: + attribute: true + error: + required: + - code + - message + - scope + type: object + properties: + id: + type: string + description: An optional identifier for the Error, that may + be used to track the failed delete operation + through the system audit logs. + 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).\"
" + description:An HTTP Response with a status of 200 (success). It contains a + payload consisting of a single "deleteResponse" element.
+ application/xml: + schema: + $ref: "#/components/errors/delete/content/application~1json/schema" + responses: + create: + description: Successfully created object(s). + content: + application/json: + schema: + $ref: "#/components/errors/create/content/application~1json/schema" + application/xml: + schema: + $ref: "#/components/errors/create/content/application~1json/schema" + update: + description: Successfully updated object(s). + content: + application/json: + schema: + $ref: "#/components/errors/update/content/application~1json/schema" + application/xml: + schema: + $ref: "#/components/errors/update/content/application~1json/schema" + delete: + description: Successfully deleted object(s). + content: + application/json: + schema: + $ref: "#/components/errors/delete/content/application~1json/schema" + application/xml: + schema: + $ref: "#/components/errors/delete/content/application~1json/schema" diff --git a/demo/petstore.openapi.yaml b/demo/petstore.openapi.yaml new file mode 100644 index 00000000..fc3ce073 --- /dev/null +++ b/demo/petstore.openapi.yaml @@ -0,0 +1,928 @@ +openapi: 3.0.0 +servers: + - url: //petstore.swagger.io/v2 + description: Default server + - url: //petstore.swagger.io/sandbox + description: Sandbox server +info: + description: | + This is a sample server Petstore server. + You can find out more about Swagger at + [http://swagger.io](http://swagger.io) or on [irc.freenode.net, #swagger](http://swagger.io/irc/). + For this sample, you can use the api key `special-key` to test the authorization filters. + + # Introduction + This API is documented in **OpenAPI format** and is based on + [Petstore sample](http://petstore.swagger.io/) provided by [swagger.io](http://swagger.io) team. + It was **extended** to illustrate features of [generator-openapi-repo](https://github.com/Rebilly/generator-openapi-repo) + tool and [ReDoc](https://github.com/Rebilly/ReDoc) documentation. In addition to standard + OpenAPI syntax we use a few [vendor extensions](https://github.com/Rebilly/ReDoc/blob/master/docs/redoc-vendor-extensions.md). + + # OpenAPI Specification + This API is documented in **OpenAPI format** and is based on + [Petstore sample](http://petstore.swagger.io/) provided by [swagger.io](http://swagger.io) team. + It was **extended** to illustrate features of [generator-openapi-repo](https://github.com/Rebilly/generator-openapi-repo) + tool and [ReDoc](https://github.com/Rebilly/ReDoc) documentation. In addition to standard + OpenAPI syntax we use a few [vendor extensions](https://github.com/Rebilly/ReDoc/blob/master/docs/redoc-vendor-extensions.md). + + # Cross-Origin Resource Sharing + This API features Cross-Origin Resource Sharing (CORS) implemented in compliance with [W3C spec](https://www.w3.org/TR/cors/). + And that allows cross-domain communication from the browser. + All responses have a wildcard same-origin which makes them completely public and accessible to everyone, including any code on any site. + + # Authentication + + Petstore offers two forms of authentication: + - API Key + - OAuth2 + OAuth2 - an open protocol to allow secure authorization in a simple + and standard method from web, mobile and desktop applications. + +