Syndication Configuration

Ontoserver can act as both a syndication client and a syndication server.

Syndication Client

atom.syndication.feedLocation (https://api.healthterminologies.gov.au/syndication/v1/syndication.xml)

Comma-separated list of URI-encoded absolute URLs of the upstream Syndication feeds. By default, this points to the Australian NCTS Syndication Service (note that this service requires credentials). Minimum is that embedded , and % characters in the URLs must be %-encoded.

It is likely that one or more of the upstream syndication servers requires credentials to be provided in order to download the content it provides. Use the authentication.oauth.endpoint.* family of credentials to provide configuration details for each of the hosts that require authorization. See the list of all configuration parameters for details.

Syndication Server

atom.syndication.publish.enabled (false)

if true, enables the downstream feed endpoint (/synd/syndication.xml) which allows publication of syndication feed entries referring to pre-indexed CodeSystems and to FHIR Resources

atom.syndication.publish.fhir.enabled (false)

If true, and downstream syndication is also enabled, then includes all FHIR Terminology Resources in the downstream feed.

atom.syndication.republishUpstreamEntries (false)

if true and downstream syndication is enabled, then all upstream syndication entries are included in the downstream feed.

ontoserver.synd.base

Base URL for the downstream Syndication API. Set this explicitly if the auto-detected value is wrong (e.g., when your server is sitting behind an API Gateway / Load Balancer / Proxy Server) This affects syndication.xml as well as full URLs in for downloading binary indexes (URLs for downloading syndicated FHIR resources are affected by ontoserver.fhir.base.

Advanced

atom.syndication.timeout.ms (16000)

time in milliseconds that Ontoserver will wait for when fetching the upstream feed. This is used as part of detecting and preventing indirect cyclic requests

atom.syndication.disableChecksums (false)

set to true to disable signature checking of the contents of a requested feed entry

Australian NCTS Syndication

The Australian National Clinical Terminology Service (NCTS) offers a syndication service for retrieving sources and binary indexes for terminology content such as SNOMED CT and LOINC.

Ontoserver is capable of connecting to this service, and most of the configuration for authentication to this service is pre-configured. However, it is necessary to provide your credentials using the variables:

authentication.oauth.endpoint.client_id.0=NCTS_CLIENT_ID (see below)

authentication.oauth.endpoint.client_secret.0=NCTS_CLIENT_SECRET (see below)

The NCTS_CLIENT_ID and NCTS_CLIENT_SECRET values can be retrieved from the NCTS Portal as follows:

  1. Log in to your account (organisation or individual) on the NCTS Portal.
  2. Click on the My Profile link in the top-right of the portal.
  3. At the bottom of the page, select the Client Credentials tab.
  4. Create a credential for Ontoserver (the name and purpose are for information only).
  5. After doing this, the table should include a Client ID and Client Secret that can be used for the configuration NCTS_CLIENT_ID and NCTS_CLIENT_SECRET respectively) above.