2A/organizational data

From Leapspecs

Belongs to the Leap2A/specification

The core of this has been included in the relevant section of the core documentation but it has also been left here for further reference and notes.

This information belongs within an organization element. To keep this conceptually separate, in parallel with Leap2A/personal data, this is represented by the separate orgdata element.

Contents 1 orgdata 1.1 field 1.2 service 1.3 label 1.4 countrycode 2 Orgdata fields 2.1 legal org name 2.2 preferred org name 2.3 country 2.4 website 2.5 id 2.6 email 2.7 workphone 2.8 minicom 2.9 fax 2.10 other 3 Service abbreviations 4 Postal addresses 5 MIAP data definitions for organizations

orgdata

This element is for non-relational data about an organization. It belongs within an organization-type entry. As with a person, the most important reason for this is to ensure that information about an organization is listed exactly once, rather than duplicated.

Within the organization entry, any number of leap2:orgdata elements can appear.

 <leap2:orgdata leap2:field="legal_org_name">University of Somecity</leap2:orgdata>
 <leap2:orgdata leap2:field="preferred_org_name" leap2:label="Name used">Somecity tech</leap2:orgdata>
 <leap2:orgdata leap2:field="email">info@somecity.ac.uk</leap2:orgdata>
 <leap2:orgdata leap2:field="country" leap2:countrycode="GBR">UK</leap2:orgdata>
 <leap2:orgdata leap2:field="website">http://www.somecity.ac.uk</leap2:orgdata>

For each orgdata element, there is one mandatory attribute and there are three optional attributes.

field

See field.

Each orgdata element has a mandatory leap2:field attribute to distinguish what the field means. The values of the leap2:field attribute should normally be taken from the list below. Otherwise, for extension purposes, the value of the leap2:field attribute can be a URI, identifying a non-Leap2A predicate.

service

See service.

This is similar to service in persondata, except that the services here are mainly for ID purposes.

label

See label.

As elsewhere, label is intended to hold the version of the field name given in the originating system.

countrycode

See countrycode.

This is optional, but specifically only for the "country" field, as in addresses, and is not allowed in other fields.

Orgdata fields

M is the allowed multiplicity within a single organisation entry.

field	M	Attributes needed	Format	Notes
legal org name	0..1		text			.
preferred org name	0..1		text	If not present, assume legal org name is preferred. This can hold "trading name".		.
country	0..*	countrycode (optional)	Text. But, as in addresses, with an optional attribute of leap2:countrycode following SIF(UK): 3-letter ISO 3166-1 code.	This is the country in which the organization, or relevant division, is based. If more than one country is given, the first one listed should be the one of the primary seat or head office.		.
website	0..*		URL	Any URL associated with the organization, usually their own domain default page. If more than one is given, the first one should be the primary one.		.
id	0..*	service	string	Typically, a registration number of the organization with some official body. Order is not significant.		.
email	0..*		e-mail: rfc2822	If more than one is given, the first one should be the primary one.		.
workphone	0..*		recommended format: full international, starting with + (+44 for UK)	If more than one is given, the first one should be the primary one.		.
minicom	0..*		recommended format: full international, starting with + (+44 for UK)	Included because of SIF(UK) having it.		.
fax	0..*		recommended format: full international, starting with + (+44 for UK)	Pretty common for businesses.		.
other	0..*	label				.

Service abbreviations

Please suggest any others for inclusion here. Some attempt may be made to capture MIAP fields for providers and for awarding organizations.

abbreviation	service	notes
uk-company	Companies House	Can search on number or name through their WebCHeck service.
uk-charity	Charity Commission	Can search on number or name
ukprn	UK Register of Learning Providers	Can search on number, name, or geographically

Postal addresses

See leap2:spatial, which applies as much to organizations as to people.

MIAP data definitions for organizations

Leaving aside details of delivery points, MIAP defines details for awarding organizations, and providers of education. Both of these kinds of organization, as well as employers, are potentially relevant to a learner's own records, and their CVs. People reading or processing CVs may benefit from knowing enough about the organization so that they can contact them, and identify them unambiguously against any lists that they might hold. The intention for LEAP2A is to include only the fields that are useful in these contexts.

• Awarding Organisation
• Awarding Organisation Address
• Awarding Organisation Identifier
• Awarding Organisation Legal Name
• Awarding Organisation Primary fax Number
• Awarding Organisation Primary Internet E-mail Address
• Awarding Organisation Primary Telephone Number
• Awarding Organisation Primary Website URL
• Awarding Organisation Trading Name
• Provider
• Provider Identifier (UKPRN)
• Provider Legal Name
• Provider Registered Address
• Provider Trading Name
• Provider Trading Address
• Provider Primary UK telephone Number
• Provider Primary UK fax Number
• Provider Primary Internet Email Address
• Provider Primary Website URL
• Provider Company Registration Number
• Provider Charity Registration Number

---