Get School Authority Information (2019 End Point and Prior)

This is the service definition on the 2019 Service Endpoint and prior endpoints. For the current definition of the service, see Get School Authority Information.

The Get School Authority Information service can be used for 2 purposes:

To retrieve information about a School Authority from the PASI Core, and
To obtain updates about a School Authority from the PASI Core as part of the data synchronization processes.

This request can be completed for a specific school authority or a list of school authorities.

Security

The Get School Authority Information service can be accessed by systems with the Hello World User role.

Request Information

The information provided as part of the Get School Authority Information request is a list of:

Request Validations

There are no validations performed on the service request.

Functionality

Information for each of the School Authority records identified in the request will be retrieved from the PASI Core using the current Get School Authority Information service, and mapped to the information in the response. If a list of records has been requested, they will be processed in the order provided.

The School Authority Codes provided in the request are validated and the result is returned in the Availability Status:

Unknown if the School Authority Code provided is unknown in the PASI Core;
No Access if the PASI Client does not have access to the record being requested; or
Normal if the record(s) has been returned.

When an Expected Version is provided in the request for a record:

If the Expected Version requested is ‘0’, the current PASI Version of the record will be returned.
If the Expected Version requested is the same as the PASI Version of the record, the record will be returned.
If the Expected Version requested is not the same as the PASI Version of the record, the record will not be returned and no further requested records will be processed.

Response Information

The following information will be returned for each requested School Authority record.

2019 Response Information	Mapped From 2020 Response Information
Availability Status	Availability Status
Authority Code	School Authority Code

The following information will be returned for each School Authority record requested with an Availability Status of Normal:

2019 Response Information		Mapped From 2020 Response Information
List of Organization Names		Organization Name
	Name	Organization Operating Name
	Effective Date	Organization Name Effective Date
List of Organization Statuses		Organization Status
	Effective Date	Organization Status Effective Date for the period of time in which the organization is active (based on Effective and Expiry Date) Organization Status Expiry Date + 1 for the period of time in which the organization is not active (based on the Effective and Expiry Date)
	Is Active	True for the period of time in which the organization is active (based on the Effective and Expiry Dates) False for the period of time in which the organization is not active (based on the Effective and Expiry Dates)
List of School Authority Classifications		School Authority Classification
	Classification Type	A value School Authority Type based on a mapping of the 2020 School Authority Classification Type response: Adult Education (A) is mapped to Other Provincial Authority (18) Charter (C) is mapped to Charter (10) First Nations (B) is mapped to First Nations (14) Francophone (F) is mapped to Francophone (9) International (I) is mapped to Not in Alberta - International Contracted (21) National - Other Provinces (N) is mapped to Not in Alberta - National Contracted (20) Private (V) is mapped to Private School (12) Private ECS (E) is mapped to Private ECS Operator (11) Public (P) is mapped to Public School District (3) Separate (S) is mapped to Separate School District (7)
	Effective Date	School Authority Classification Effective Date for the period of time in which the type is active School Authority Classification Expiry Date + 1 day for the period of time in which the type is not active
	Is Active	True for the period of time in which the type is active (based on Effective Date and Expiry Date) False for the period of time in which the type is not active (based on the Effective Date and Expiry Date)
List of Addresses		From the Organization Delivery Address and the Organization Mailing Address
	Address Reference ID	Not available on the 2020 response, therefore will contain a value of 0.
	Address Type	Delivery if the address is based on the Organization Delivery Address Mailing if the addressed is based on the Organization Mailing Address
	Street	Street from the Address
	City	City from the Address
	State / Province	Province from the Address
	Postal Code	Postal Code from the Address
	Country	Country from the Address
	Effective Date	Not available on the 2020 response, therefore is populated with: If available, the Organization Status Effective Date from the current Organization Status record, Otherwise, the latest Organization Status Effective Date for the organization.
	Expiry Date	Not available on the 2020 response and therefore will not be populated.
Email Address		Organization Email Address
Phone Number		Organization Phone Number
Fax Number		Organization Fax Number
PASI Core Version		PASI Core Version
Source Version		Not available from the 2020 response, therefore will contain a value of 0.

Related Business Process

No links found.

Related Functionality

Get School Authority Information

CoreService, Functionality, DataSynchronization

PASI Knowledge Base

Table of Contents