# Technical

**URL:** https://forum.openreferral.org/c/technical/7.md?page=3

[Latest](https://forum.openreferral.org/latest.md) · [Categories](https://forum.openreferral.org/categories.md) · [Tags](https://forum.openreferral.org/tags.md)

**Page:** 4

---

## [Potentially incorrect data types in the \`schedule\` table](https://forum.openreferral.org/t/potentially-incorrect-data-types-in-the-schedule-table/330)

<div class="topic-metadata">

**Author:** [@skyleryoung](https://forum.openreferral.org/u/skyleryoung)\
**Replies:** 4\
**Last updated:** [February 12, 2023, 9:28pm UTC](https://forum.openreferral.org/t/potentially-incorrect-data-types-in-the-schedule-table/330 "2023-02-12T21:28:50Z")

</div>

My team have surfaced a few potential data type errors in the existing HSDS documentation. @davidraznick may already be all over this in 3.0, but I thought I would document our findings here just in case. schedule sc…

---

## [Update on 3.0 Schema changes](https://forum.openreferral.org/t/update-on-3-0-schema-changes/320)

<div class="topic-metadata">

**Author:** [@Dan-ODS](https://forum.openreferral.org/u/Dan-ODS)\
**Replies:** 6\
**Last updated:** [January 24, 2023, 10:01am UTC](https://forum.openreferral.org/t/update-on-3-0-schema-changes/320 "2023-01-24T10:01:30Z")

</div>

Hi all, Here is a summary of what was agreed at the last workgroup meeting of 2022 with regards to 3.0 schema changes along with the proposed next steps. What we’ve agreed on so far: 3.0 remaining questions were discu…

---

## [HSDS 3.0 - What is "compliance"?](https://forum.openreferral.org/t/hsds-3-0-what-is-compliance/317)

<div class="topic-metadata">

**Author:** [@skyleryoung](https://forum.openreferral.org/u/skyleryoung)\
**Replies:** 18\
**Last updated:** [January 5, 2023, 9:32pm UTC](https://forum.openreferral.org/t/hsds-3-0-what-is-compliance/317 "2023-01-05T21:32:13Z")

</div>

This topic flows from recent HSDS Workgroup meetings, as well as the topic for “HSDS 3.0 - Key Decisions” HSDS 3.0 - Key Decisions - #9 by skyleryoung I looked around for duplicates, and while this topic is alluded to i…

---

## [HSDS 3.0 - Key Decisions](https://forum.openreferral.org/t/hsds-3-0-key-decisions/312)

<div class="topic-metadata">

**Author:** [@Dan-ODS](https://forum.openreferral.org/u/Dan-ODS)\
**Replies:** 10\
**Last updated:** [December 21, 2022, 12:41pm UTC](https://forum.openreferral.org/t/hsds-3-0-key-decisions/312 "2022-12-21T12:41:01Z")

</div>

Hi all, Reflecting on the discussions that took place in last week’s workgroup, there are some key decisions we think need to be made (ideally sooner rather than later) in order to progress with the HSDS 3.0 release. D…

---

## [What constitutes compliance in the UK](https://forum.openreferral.org/t/what-constitutes-compliance-in-the-uk/285)

<div class="topic-metadata">

**Author:** [@MikeThacker-iStandUK](https://forum.openreferral.org/u/MikeThacker-iStandUK)\
**Replies:** 2\
**Last updated:** [December 1, 2022, 1:19pm UTC](https://forum.openreferral.org/t/what-constitutes-compliance-in-the-uk/285 "2022-12-01T13:19:40Z")

</div>

With work progressing on version 3 that uses the concept of “profiles” to distinguish full, core, UK and potentially other representations of the standard, it’s essential that we remain clear on what service directories …

---

## [First draft of HSDS 3.0 proposal](https://forum.openreferral.org/t/first-draft-of-hsds-3-0-proposal/264)

<div class="topic-metadata">

**Author:** [@bloom](https://forum.openreferral.org/u/bloom)\
**Replies:** 8\
**Last updated:** [November 2, 2022, 4:58pm UTC](https://forum.openreferral.org/t/first-draft-of-hsds-3-0-proposal/264 "2022-11-02T16:58:24Z")

</div>

Hi folks – @davidraznick has shared a first draft of the HSDS 3.0 proposal here in this document that outlines major changes, with schemas here: GitHub - openreferral/specification at 3.0-dev We’re eager to hear your in…

---

## [Image field for taxonomy terms](https://forum.openreferral.org/t/image-field-for-taxonomy-terms/208)

<div class="topic-metadata">

**Author:** [@pmackay](https://forum.openreferral.org/u/pmackay)\
**Replies:** 5\
**Last updated:** [October 12, 2022, 7:45pm UTC](https://forum.openreferral.org/t/image-field-for-taxonomy-terms/208 "2022-10-12T19:45:09Z")

</div>

Has an image field for taxonomy terms been considered? I’m using a green map taxonomy that is very structured around icons for use on maps, etc.

---

## [Should we move lat/long to the address table?](https://forum.openreferral.org/t/should-we-move-lat-long-to-the-address-table/246)

<div class="topic-metadata">

**Author:** [@skyleryoung](https://forum.openreferral.org/u/skyleryoung)\
**Replies:** 5\
**Last updated:** [October 3, 2022, 9:28pm UTC](https://forum.openreferral.org/t/should-we-move-lat-long-to-the-address-table/246 "2022-10-03T21:28:46Z")

</div>

This is actually a question that I have wondered at for a while, and it’s coming to me again as I work on a project. If we are defining a one-to-many relationship between location and address, shouldn’t we then move lat…

---

## [API paths should support multiple languages](https://forum.openreferral.org/t/api-paths-should-support-multiple-languages/245)

<div class="topic-metadata">

**Author:** [@skyleryoung](https://forum.openreferral.org/u/skyleryoung)\
**Replies:** 3\
**Last updated:** [October 3, 2022, 9:22pm UTC](https://forum.openreferral.org/t/api-paths-should-support-multiple-languages/245 "2022-10-03T21:22:20Z")

</div>

Connect 211 is working on translating resource data in the database. We decided to do that as it’s more cost effective in the long run, and also improves the value of the raw data for our clients. Internationalization o…

---

## [Rules for the core and extended standard API (HSDA)](https://forum.openreferral.org/t/rules-for-the-core-and-extended-standard-api-hsda/205)

<div class="topic-metadata">

**Author:** [@MikeThacker-iStandUK](https://forum.openreferral.org/u/MikeThacker-iStandUK)\
**Replies:** 7\
**Last updated:** [September 19, 2022, 1:22am UTC](https://forum.openreferral.org/t/rules-for-the-core-and-extended-standard-api-hsda/205 "2022-09-19T01:22:06Z")

</div>

At the request of the Workgroup, I’ve extensively modified the document Por11328 - Aligning Open Referral and Open Referral UK - The API - HSDA. The document proposes: rules for going from the full data structure or a…

---

## [Are we currently working on HSDS 2.1 or 3.0?](https://forum.openreferral.org/t/are-we-currently-working-on-hsds-2-1-or-3-0/197)

<div class="topic-metadata">

**Author:** [@skyleryoung](https://forum.openreferral.org/u/skyleryoung)\
**Replies:** 0\
**Last updated:** [August 1, 2022, 4:27pm UTC](https://forum.openreferral.org/t/are-we-currently-working-on-hsds-2-1-or-3-0/197 "2022-08-01T16:27:55Z")

</div>

The current iteration of the HSDS Workgroup has been operating under the assumptions we are developing HSDS 2.1. However, there are breaking changes, whereby if we decide to stick with semantic versioning standards, we s…

---

## [Use cases for applying the standard](https://forum.openreferral.org/t/use-cases-for-applying-the-standard/188)

<div class="topic-metadata">

**Author:** [@MikeThacker-iStandUK](https://forum.openreferral.org/u/MikeThacker-iStandUK)\
**Replies:** 8\
**Last updated:** [July 15, 2022, 4:57pm UTC](https://forum.openreferral.org/t/use-cases-for-applying-the-standard/188 "2022-07-15T16:57:17Z")

</div>

At the initial working group meeting for the next version of the Open Referral data specification (HSDS) people suggested drawing up use cases to guide our work. Others will contribute detailed cases from their perspect…

---

## [Proposing additions to the LGA Services List?](https://forum.openreferral.org/t/proposing-additions-to-the-lga-services-list/196)

<div class="topic-metadata">

**Author:** [@kevin-digilynx](https://forum.openreferral.org/u/kevin-digilynx)\
**Replies:** 4\
**Last updated:** [July 5, 2022, 1:08pm UTC](https://forum.openreferral.org/t/proposing-additions-to-the-lga-services-list/196 "2022-07-05T13:08:23Z")

</div>

The first stage of our pilot programme with NASP Midlands Region involves consultations with a number of third sector providers. As expected some of them are delivering services that cannot be described by an existing LG…

---

## [How far do we expect HSDS resources to be standalone and re-usable?](https://forum.openreferral.org/t/how-far-do-we-expect-hsds-resources-to-be-standalone-and-re-usable/193)

<div class="topic-metadata">

**Author:** [@robredpath](https://forum.openreferral.org/u/robredpath)\
**Replies:** 1\
**Last updated:** [July 4, 2022, 3:46pm UTC](https://forum.openreferral.org/t/how-far-do-we-expect-hsds-resources-to-be-standalone-and-re-usable/193 "2022-07-04T15:46:57Z")

</div>

At Open Data Services we work on a number of standards, such as 360Giving and Open Contracting Most standards that we work on try to hold to the principle that the standard can, in principle, operate separately from the…

---

## [Codifying "recommendations" and "warnings"](https://forum.openreferral.org/t/codifying-recommendations-and-warnings/194)

<div class="topic-metadata">

**Author:** [@robredpath](https://forum.openreferral.org/u/robredpath)\
**Replies:** 1\
**Last updated:** [July 4, 2022, 3:24pm UTC](https://forum.openreferral.org/t/codifying-recommendations-and-warnings/194 "2022-07-04T15:24:30Z")

</div>

In the HSDS 2.1 upgrade workgroup I’ve seen and heard comments along the lines of “we should recommend this in the standard” or “the validator should warn if this is the case”. The schema language that we use to ship HS…

---

## [Capita integration](https://forum.openreferral.org/t/capita-integration/155)

<div class="topic-metadata">

**Author:** [@Annie](https://forum.openreferral.org/u/Annie)\
**Replies:** 1\
**Last updated:** [March 25, 2022, 10:51am UTC](https://forum.openreferral.org/t/capita-integration/155 "2022-03-25T10:51:29Z")

</div>

Hi all We have some service information about schools, child minders etc stored in Capita at the moment and using it to populate our directories isn’t easy. Does anyone else have this set up? Capita doesn’t have an AP…

---

## [Which taxonomies to use](https://forum.openreferral.org/t/which-taxonomies-to-use/156)

<div class="topic-metadata">

**Author:** [@MikeThacker-iStandUK](https://forum.openreferral.org/u/MikeThacker-iStandUK)\
**Replies:** 0\
**Last updated:** [March 1, 2022, 4:19pm UTC](https://forum.openreferral.org/t/which-taxonomies-to-use/156 "2022-03-01T16:19:58Z")

</div>

I’ve been involved in a Slack conversation with American adopters of Open Referral and want to open the conversation here as the choice of taxonomies is crucial for interoperability between organisations and the move to …

---

## [Closer alignment between international and UK data structures](https://forum.openreferral.org/t/closer-alignment-between-international-and-uk-data-structures/134)

<div class="topic-metadata">

**Author:** [@MikeThacker-iStandUK](https://forum.openreferral.org/u/MikeThacker-iStandUK)\
**Replies:** 4\
**Last updated:** [February 10, 2022, 3:30pm UTC](https://forum.openreferral.org/t/closer-alignment-between-international-and-uk-data-structures/134 "2022-02-10T15:30:14Z")

</div>

UK and international (US-based) teams have been discussing closer alignment of data structures so we can better share learning, documentation, tools etc. This follows: extensions added in the UK following OpenComunity…

---

## [Natural Neighbourhoods Coverage](https://forum.openreferral.org/t/natural-neighbourhoods-coverage/65)

<div class="topic-metadata">

**Author:** [@Ian-DigitalGaps](https://forum.openreferral.org/u/Ian-DigitalGaps)\
**Replies:** 2\
**Last updated:** [November 10, 2021, 6:33pm UTC](https://forum.openreferral.org/t/natural-neighbourhoods-coverage/65 "2021-11-10T18:33:58Z")

</div>

We are using the LGA’s natural neighbourhoods to define the areas within Blackburn as URIs. This will support the OR coverage API but we wondered whether there might be a new API function which accepts a post code and re…

---

## [Enhancements to OR UK - Proposal to enhance Schedule](https://forum.openreferral.org/t/enhancements-to-or-uk-proposal-to-enhance-schedule/125)

<div class="topic-metadata">

**Author:** [@Ian-DigitalGaps](https://forum.openreferral.org/u/Ian-DigitalGaps)\
**Replies:** 5\
**Last updated:** [October 7, 2021, 4:03pm UTC](https://forum.openreferral.org/t/enhancements-to-or-uk-proposal-to-enhance-schedule/125 "2021-10-07T16:03:19Z")

</div>

Enhancements to OR UK - Proposal to enhance Schedule A service can have many schedules (sessions), however attending\_type (whether it is online or telephone or home visit or at a venue) is at the service level. This rea…

---

## [Validation test rules](https://forum.openreferral.org/t/validation-test-rules/136)

<div class="topic-metadata">

**Author:** [@Marcus-DigiCoproduct](https://forum.openreferral.org/u/Marcus-DigiCoproduct)\
**Replies:** 4\
**Last updated:** [October 7, 2021, 4:01pm UTC](https://forum.openreferral.org/t/validation-test-rules/136 "2021-10-07T16:01:23Z")

</div>

I can see there are several feeds within the Open Referral UK dashboard that show as either full or partially compliant. Some have compliance level 1 and others level 2. It is not overly clear what the rules are that l…

---

## [Standardising API calls between international and UK implementations](https://forum.openreferral.org/t/standardising-api-calls-between-international-and-uk-implementations/135)

<div class="topic-metadata">

**Author:** [@MikeThacker-iStandUK](https://forum.openreferral.org/u/MikeThacker-iStandUK)\
**Replies:** 1\
**Last updated:** [September 27, 2021, 10:42pm UTC](https://forum.openreferral.org/t/standardising-api-calls-between-international-and-uk-implementations/135 "2021-09-27T22:42:33Z")

</div>

So far the UK and international (US-based) approaches to an Application Programming Interface (API) standard have been different. The international Human Service Data API Suite (HSDA) defines web methods that cover a bro…

---

## [Service Types taxonomy - use and making changes](https://forum.openreferral.org/t/service-types-taxonomy-use-and-making-changes/91)

<div class="topic-metadata">

**Author:** [@MikeThacker-iStandUK](https://forum.openreferral.org/u/MikeThacker-iStandUK)\
**Replies:** 5\
**Last updated:** [August 31, 2021, 3:04pm UTC](https://forum.openreferral.org/t/service-types-taxonomy-use-and-making-changes/91 "2021-08-31T15:04:18Z")

</div>

I’ve had a query on service type taxonomy terms from a supplier with two councils considering adopting Open Referral UK. The supplier’s software applies terms from the service types list to which they would like to add …

---

## [LocalGov Drupal implementation](https://forum.openreferral.org/t/localgov-drupal-implementation/106)

<div class="topic-metadata">

**Author:** [@ekes](https://forum.openreferral.org/u/ekes)\
**Replies:** 26\
**Last updated:** [August 12, 2021, 1:55pm UTC](https://forum.openreferral.org/t/localgov-drupal-implementation/106 "2021-08-12T13:55:45Z")

</div>

The technical counterpart to Integrating Open Referral UK with LocalGov Drupal In the spirit of LocalGov Drupal developing in the open, I’ll document, and maybe short-circuit some of the hard work by getting feedback on …

---

## [What the validator checks and adding new properties](https://forum.openreferral.org/t/what-the-validator-checks-and-adding-new-properties/131)

<div class="topic-metadata">

**Author:** [@MikeThacker-iStandUK](https://forum.openreferral.org/u/MikeThacker-iStandUK)\
**Replies:** 0\
**Last updated:** [August 4, 2021, 9:12am UTC](https://forum.openreferral.org/t/what-the-validator-checks-and-adding-new-properties/131 "2021-08-04T09:12:29Z")

</div>

The Validator does fuller checks of API feeds than the checks run daily for the Dashboard. The Validator will: complain if an enum property has a value that is not in the enumeration not complain about missing propert…

---

## [Service types, needs and circumstances](https://forum.openreferral.org/t/service-types-needs-and-circumstances/42)

<div class="topic-metadata">

**Author:** [@MikeThacker-iStandUK](https://forum.openreferral.org/u/MikeThacker-iStandUK)\
**Replies:** 2\
**Last updated:** [July 23, 2021, 1:27pm UTC](https://forum.openreferral.org/t/service-types-needs-and-circumstances/42 "2021-07-23T13:27:50Z")

</div>

This week I’ve had a couple of queries from developers who are reading or importing services from ORUK feeds on how to use taxonomies. We’d normally expect each service record to have at least one “service type” from an…

---

## [Recording location accessibility](https://forum.openreferral.org/t/recording-location-accessibility/113)

<div class="topic-metadata">

**Author:** [@MikeThacker-iStandUK](https://forum.openreferral.org/u/MikeThacker-iStandUK)\
**Replies:** 4\
**Last updated:** [July 20, 2021, 9:34am UTC](https://forum.openreferral.org/t/recording-location-accessibility/113 "2021-07-20T09:34:26Z")

</div>

I’ve had discussions with AccessAble who do accessibility assessments of locations. The gist of initial conversations was that a simple taxonomy of accessibility terms might be suitable to convey some simple information…

---

## [Enhancements to OR UK - Proposal to add specific taxonomies](https://forum.openreferral.org/t/enhancements-to-or-uk-proposal-to-add-specific-taxonomies/126)

<div class="topic-metadata">

**Author:** [@Ian-DigitalGaps](https://forum.openreferral.org/u/Ian-DigitalGaps)\
**Replies:** 2\
**Last updated:** [July 19, 2021, 7:27pm UTC](https://forum.openreferral.org/t/enhancements-to-or-uk-proposal-to-add-specific-taxonomies/126 "2021-07-19T19:27:18Z")

</div>

Enhancements to OR UK - Proposal to add specific taxonomies The values for deliverable\_type, attending\_access and attending\_type are given as part of the OR UK. These values perhaps need to become taxonomies but I don’t…

---

## [Enhancements to OR UK - Proposal to add more URLs for Social media, guidance and other information per service](https://forum.openreferral.org/t/enhancements-to-or-uk-proposal-to-add-more-urls-for-social-media-guidance-and-other-information-per-service/124)

<div class="topic-metadata">

**Author:** [@Ian-DigitalGaps](https://forum.openreferral.org/u/Ian-DigitalGaps)\
**Replies:** 2\
**Last updated:** [July 19, 2021, 7:21pm UTC](https://forum.openreferral.org/t/enhancements-to-or-uk-proposal-to-add-more-urls-for-social-media-guidance-and-other-information-per-service/124 "2021-07-19T19:21:00Z")

</div>

Proposal to add more URLs for Social media, guidance and other information per service OR UK is limited to one website field for service. Services have fliers, directions, social media platforms and other information to…

---

## [Cost option amounts - string or number](https://forum.openreferral.org/t/cost-option-amounts-string-or-number/85)

<div class="topic-metadata">

**Author:** [@MikeThacker-iStandUK](https://forum.openreferral.org/u/MikeThacker-iStandUK)\
**Replies:** 2\
**Last updated:** [July 14, 2021, 2:29pm UTC](https://forum.openreferral.org/t/cost-option-amounts-string-or-number/85 "2021-07-14T14:29:05Z")

</div>

The standard guidance shows “cost\_option” as a UK extension to the base international Open Referral standard which just has a single “fees” text field for services. Cost\_option is shown as a new table in blue in the data…

[Previous page](https://forum.openreferral.org/c/technical/7.md?page=2)

[Next page](https://forum.openreferral.org/c/technical/7.md?page=4)
