From 5cbdb2d64c60f13a15187e21efb2debdf3aecf78 Mon Sep 17 00:00:00 2001 From: Howard Askew <19271569+howaskew@users.noreply.github.com> Date: Fri, 30 Oct 2026 13:55:54 +0000 Subject: [PATCH 1/4] feat: Allow activity, location and ageRange on Organization For organisation-level publishing. Adds optional activity, location and ageRange fields to Organization, which extends the oa:activity and oa:ageRange domains to schema:Organization (schema:location already applies to Organization). Rewords both published definitions in Course.json, the alphabetically first declaring model, so they are no longer event-only. Co-Authored-By: Claude Opus 5.5 --- versions/2.x/models/Course.json | 4 +- versions/2.x/models/Organization.json | 53 ++++++++++++++++++++++++++- 2 files changed, 54 insertions(+), 3 deletions(-) diff --git a/versions/2.x/models/Course.json b/versions/2.x/models/Course.json index 227aef2b..c9381487 100644 --- a/versions/2.x/models/Course.json +++ b/versions/2.x/models/Course.json @@ -56,7 +56,7 @@ "sameAs": "https://openactive.io/activity", "model": "ArrayOf#Concept", "description": [ - "Specifies the physical activity or activities that will take place during a Course." + "Specifies the physical activity or activities associated with this resource." ], "example": [ { @@ -72,7 +72,7 @@ "sameAs": "https://openactive.io/ageRange", "model": "#QuantitativeValue", "description": [ - "Indicates that an event is recommended as being suitable for or is targetted at a specific age range." + "Indicates that this resource is recommended as being suitable for, or is targeted at, a specific age range." ], "example": { "@type": "QuantitativeValue", diff --git a/versions/2.x/models/Organization.json b/versions/2.x/models/Organization.json index 1fe559db..ccfafea3 100755 --- a/versions/2.x/models/Organization.json +++ b/versions/2.x/models/Organization.json @@ -203,7 +203,10 @@ "address", "termsOfService", "isOpenBookingAllowed", - "hasAccount" + "hasAccount", + "activity", + "location", + "ageRange" ], "fields": { "type": { @@ -355,6 +358,54 @@ "Reference to the CustomerAccount associated with this Customer, for use within the Open Booking API flow.", "Note that this property is in EARLY RELEASE AND IS SUBJECT TO CHANGE, as the [Customer Accounts proposal](https://github.com/openactive/customer-accounts) evolves." ] + }, + "activity": { + "fieldName": "activity", + "sameAs": "https://openactive.io/activity", + "model": "ArrayOf#Concept", + "description": [ + "The physical activity or activities provided by this organization." + ], + "example": [ + { + "@type": "Concept", + "@id": "https://openactive.io/activity-list#6bb8b844-df3e-4cae-bf5f-3e129c6b1a9d", + "prefLabel": "Sailing", + "inScheme": "https://openactive.io/activity-list" + } + ] + }, + "location": { + "fieldName": "location", + "sameAs": "https://schema.org/location", + "model": "#Place", + "allowReferencing": true, + "description": [ + "The location at which this organization provides activity." + ], + "example": { + "@type": "Place", + "@id": "https://example.com/locations/1234ABCD", + "name": "Example Sailing Club", + "address": { + "@type": "PostalAddress", + "postalCode": "SE10 0BW", + "addressCountry": "GB" + } + } + }, + "ageRange": { + "fieldName": "ageRange", + "sameAs": "https://openactive.io/ageRange", + "model": "#QuantitativeValue", + "description": [ + "The age range this organization caters for overall." + ], + "example": { + "@type": "QuantitativeValue", + "minValue": 5, + "maxValue": 16 + } } } } \ No newline at end of file From 68407832f711d047fc135d4e5b74096d67a74994 Mon Sep 17 00:00:00 2001 From: Howard Askew <19271569+howaskew@users.noreply.github.com> Date: Fri, 30 Oct 2026 15:01:55 +0000 Subject: [PATCH 2/4] feat: Align Organization with organisation-level publishing in the spec Brings Organization in line with Modelling Opportunity Data 2.1 Editor's Draft section 5.8.1 (describing an Organization independent of any specific event): - location also accepts an array of Place, a PostalAddress or text. allowReferencing is not set, as the .NET generator does not support it with multiple types; an @id reference is accepted as text. - New optional fields: genderRestriction, alternateName, memberOf (an @id or an Organization) and member (one @id or an array). - A stand-alone Organization in feed mode, either the top-level object ($) or an RPDE item's data, requires name, activity and location, and recommends @id, description, url, sameAs, email and telephone. Organizations in other fields, such as organizer and provider, are unaffected. - FeedItem accepts kind "Organization" and an Organization as data. Co-Authored-By: Claude Opus 5.5 --- versions/2.x/models/Organization.json | 93 ++++++++++++++++++++++++++- versions/2.x/rpde/FeedItem.json | 6 +- 2 files changed, 94 insertions(+), 5 deletions(-) diff --git a/versions/2.x/models/Organization.json b/versions/2.x/models/Organization.json index ccfafea3..300a9386 100755 --- a/versions/2.x/models/Organization.json +++ b/versions/2.x/models/Organization.json @@ -69,6 +69,36 @@ "requiredFields": [ "id" ] + }, + "$": { + "requiredFields": [ + "name", + "activity", + "location" + ], + "recommendedFields": [ + "id", + "description", + "url", + "sameAs", + "email", + "telephone" + ] + }, + "data": { + "requiredFields": [ + "name", + "activity", + "location" + ], + "recommendedFields": [ + "id", + "description", + "url", + "sameAs", + "email", + "telephone" + ] } }, "bookableFeed": { @@ -206,7 +236,11 @@ "hasAccount", "activity", "location", - "ageRange" + "ageRange", + "genderRestriction", + "alternateName", + "memberOf", + "member" ], "fields": { "type": { @@ -379,9 +413,15 @@ "fieldName": "location", "sameAs": "https://schema.org/location", "model": "#Place", - "allowReferencing": true, + "alternativeModels": [ + "ArrayOf#Place", + "#PostalAddress" + ], + "alternativeTypes": [ + "https://schema.org/Text" + ], "description": [ - "The location at which this organization provides activity." + "The main address of the organization, or the key locations of the activities it provides." ], "example": { "@type": "Place", @@ -406,6 +446,53 @@ "minValue": 5, "maxValue": 16 } + }, + "genderRestriction": { + "fieldName": "genderRestriction", + "sameAs": "https://openactive.io/genderRestriction", + "requiredType": "https://openactive.io/GenderRestrictionType", + "description": [ + "Indicates that the organization provides activities that are restricted to male or female participants, or that there are no restrictions." + ], + "example": "https://openactive.io/FemaleOnly" + }, + "alternateName": { + "fieldName": "alternateName", + "sameAs": "https://schema.org/alternateName", + "requiredType": "https://schema.org/Text", + "alternativeTypes": [ + "ArrayOf#https://schema.org/Text" + ], + "description": [ + "Aliases, common acronyms or alternative names for the organization." + ], + "example": [ + "EYC" + ] + }, + "memberOf": { + "fieldName": "memberOf", + "sameAs": "https://schema.org/memberOf", + "model": "#Organization", + "allowReferencing": true, + "description": [ + "The `@id` of an organization that this organization is affiliated to. For example, a club can link to its national governing body." + ], + "example": "https://example.org/id/organisation/national-governing-body" + }, + "member": { + "fieldName": "member", + "sameAs": "https://schema.org/member", + "requiredType": "ArrayOf#https://schema.org/URL", + "alternativeTypes": [ + "https://schema.org/URL" + ], + "description": [ + "The `@id`s of organizations affiliated to this organization. For example, a national governing body can list its affiliated clubs." + ], + "example": [ + "https://example.org/id/organisation/1" + ] } } } \ No newline at end of file diff --git a/versions/2.x/rpde/FeedItem.json b/versions/2.x/rpde/FeedItem.json index 05817e06..2c5b7465 100644 --- a/versions/2.x/rpde/FeedItem.json +++ b/versions/2.x/rpde/FeedItem.json @@ -20,7 +20,8 @@ "fieldName": "data", "model": "#Event", "alternativeModels": [ - "#FacilityUse" + "#FacilityUse", + "#Organization" ], "description": [ "Note this property must not be included if state is \"deleted\"." @@ -51,7 +52,8 @@ "EventSeries", "OnDemandEvent", "Order", - "Place" + "Place", + "Organization" ], "description": [ "The kind property allows for the representation of different entity types, though where possible referenced entities should be embedded into the primary entity. Each entity type (kind) can be synchronised separately, this allows a decoupling of the sync logic from the data structure, and allows the data structure to be reassembled on the data consumer side (at System 2)." From ac46d854352f5379ad5d5c8f45c1fb95453d40fc Mon Sep 17 00:00:00 2001 From: Howard Askew <19271569+howaskew@users.noreply.github.com> Date: Fri, 30 Oct 2026 15:24:09 +0000 Subject: [PATCH 3/4] feat: Require beta:dateVerified on a stand-alone Organization Modelling Opportunity Data section 5.8.1 makes beta:dateVerified REQUIRED for organisation-level data. Add it to the required fields for a stand-alone Organization in feed mode (the top-level object and an RPDE item's data). The validator checks that it is present; data must include the beta namespace in @context for it to be recognised. Co-Authored-By: Claude Opus 5.5 --- versions/2.x/models/Organization.json | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/versions/2.x/models/Organization.json b/versions/2.x/models/Organization.json index 300a9386..6920e9d4 100755 --- a/versions/2.x/models/Organization.json +++ b/versions/2.x/models/Organization.json @@ -74,7 +74,8 @@ "requiredFields": [ "name", "activity", - "location" + "location", + "beta:dateVerified" ], "recommendedFields": [ "id", @@ -89,7 +90,8 @@ "requiredFields": [ "name", "activity", - "location" + "location", + "beta:dateVerified" ], "recommendedFields": [ "id", From 157f1f0ae91b0dff207da5253ff483bbc3e11e58 Mon Sep 17 00:00:00 2001 From: Howard Askew <19271569+howaskew@users.noreply.github.com> Date: Wed, 11 Nov 2026 17:34:28 +0000 Subject: [PATCH 4/4] feat: Require license on a stand-alone Organization --- versions/2.x/models/Organization.json | 15 +++++++++++++-- 1 file changed, 13 insertions(+), 2 deletions(-) diff --git a/versions/2.x/models/Organization.json b/versions/2.x/models/Organization.json index 6920e9d4..75a88d8d 100755 --- a/versions/2.x/models/Organization.json +++ b/versions/2.x/models/Organization.json @@ -75,7 +75,8 @@ "name", "activity", "location", - "beta:dateVerified" + "beta:dateVerified", + "license" ], "recommendedFields": [ "id", @@ -242,7 +243,8 @@ "genderRestriction", "alternateName", "memberOf", - "member" + "member", + "license" ], "fields": { "type": { @@ -495,6 +497,15 @@ "example": [ "https://example.org/id/organisation/1" ] + }, + "license": { + "fieldName": "license", + "sameAs": "https://schema.org/license", + "requiredType": "https://schema.org/URL", + "example": "https://creativecommons.org/licenses/by/4.0/", + "description": [ + "Reference to the license under which the Organization's data is published. Required when an Organization is published on its own outside an RPDE feed; in an RPDE feed, the license is given by each feed page, so it should not be included." + ] } } } \ No newline at end of file