Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

For an instance of CKM, there are several configuration options.

...

BOLD options need to be configured, normal ones are optional. Gray options are usually configured temporarily only.

Parameter

Explanation

locale

The server locale for this CKM instance. This is for example used to send emails in the appropriate language of the server and use log messages to e.g. commit, check-out etc in the correct language.
Note that individual users can choose to display the CKM frontend in any supported language (currently fully supported: English and German).
Possible options:

  • en
  • de
  • nb  
  • sl
  • ru (partly)

resource-display-localeIn some CKM instances it may be useful to have a preferred language for resources such as archetypes that is different to the locale language of the CKM instance - e.g. if CKM has not been translated into this language.

base-url

The base url of the server for use in email templates, e.g. http://www.openehr.org/ckm

 

theme

The header style to use, used to configure the logo displayed on top and in the Known Issues and About tab (available from the About menu).
Possible options at the moment:

  • blue
  • gray
  • gray-red

link-to-introduction

A link to an external introduction to CKM, the URL used for the Help/Introduction/Help menu item, e.g. http://www.openehr.org/wiki/display/healthmod/Clinical+Knowledge+Manager

 

link-to-faq

A link to a FAQ page, displayed as a Menu item in the Help menu if configured. E.g. http://www.openehr.org/wiki/display/healthmod/Frequently+Asked+Questions

 

link-to-get-involved

A link to more information on how to get involved in CKM, displayed as a Menu item in the Help menu if configured. E.g. http://www.openehr.org/wiki/display/healthmod/Getting+involved+in+the+NEHTA+CKM

 

support-email

A support email address. Currently displayed in the Known Issues and About tab (available from the About menu). Currently set to ckm@oceaninformatics.com

notification

A short notification to be displayed in CKM at the bottom. This can e.g. be used to notify users of server downtime etc.

delete-notification

false, true: If true an existing notification will be deleted.

copyright-holder

If set, this is the holder of the copyright of resources in this instance as per overwrite-copyright. Needs to be configured if overwrite-copyright is always or empty

show-custom-schemes-first

If set and true, custom schemes are displayed before any other schemes in classification panels.

root-oid-for-archetype
root-oid-for-template
root-oid-for-termset
root-oid-for-release-set

Root OIDs for the OID registry for the various resource types. Need to be configured for CKM's OID registry functionality.

terms-of-use

Terms of use for this CKM instance. If configured will be displayed in CKM. A html text or link to an external webpage.

privacy-policy

A link to a Privacy Policy page accessible on the web or a html text

code-of-conductAn additional/separate code of conduct. Often this is simply integrated into the terms-of-use. A html text or link to an external webpage.

unregister-text

An html text displayed on registration to ensure people know how to unregister if required.

unregister-text-email

A HTML text to be added to the bottom of most emails: should include a direct link to unregister from this CKM instance, e.g.:
If you wish to unsubscribe from this service, please follow this link: <a href="http://dcm.nehta.org.au/ckm/#unregister" >http://dcm.nehta.org.au/ckm/#unregister</a>

add-about-text

Additional html text displayed on the About page of this CKM instance, e.g. "<a href="http://www.nehta.gov.au" target="_blank">About NeHTA</a>"

resource-type-to-activate-in-resources-explorersThe resource type (archetype, template, termset) that will be activated on the left hand panels in CKM on loading.

Twitter configuration

  • twitter-name
  • twitter-consumer-key
  • twitter-access-key
  • twitter-consumer-secret
  • twitter-access-secret

The twitter configuration for twitter updates. If not configured, twittering is disabled.

The following triggers cause a tweet:

  • A resource (archetype, template, termset, release set) has been imported into CKM. (The resource must be within a publicly visible project)
  • A publicly visible resource (archetype, template, termset, release set) has been updated. This includes:
    • A normal upload of the resource
    • The publication of the resource
    • Changing the archetype id
    • Internalising a resource that was cached from remote
  • A resource is being published.
  • New project has been created (or is becoming visible).
  • A resource is moved from a private incubator to a public incubator or project, i.e. is becoming visible for everybody for the first time.
  • A new review round has been set up.
  • A new Change Request for a publicly visible resource has been created
  • A new discussion comment for a publicly visible resource has been created

Bitly configuration:

  • bitly-name
  • bitly-password (OAuth access key)

URL shortener used for twittering

link-on-logo

The link on the logo in the top-left corner of CKM

ckm-abbreviation

The abbreviation used in emails, e.g. ckm -> Emails start with [ckm]

ots-endpoint

Endpoint for the Terminology Webservice, e.g. "http://ots.oceaninformatics.com/OTS/OTSService.asmx?wsdl". If not configured a default will be used.

opt-endpoint

Endpoint for the OPT generator Webservice. If not configured a default will be used.

default-country

A default country. If configured this is preset in the user registration process.

translator-registration

Enables or disables the registration as a translator [true, false]

restrict-resource-checkout

If true, the checkout of resources is restricted to appropriate project members, otherwise any registered user can checkout a resource. [true, false]

proxy-host / proxy-portIf running CKM behind a proxy, configure the proxy here for CKM.

git

  • repository-url
  • username
  • password

For new and updated resources to be exported to e.g. Github, a Git repository can be configured here.

On import or update of a publicly visible resource, this is being exported to the configured repository.

alert
  - header
  - body

An alert header text and an alert html body can be configured. This will be displayed once to each user that is already registered. Useful for e.g. notifying users about changes in CKM after an upgrade.

editor-description

 A description used to describe an editor of this CKM instance or the CKM instance itself - e.g. "openEHR" for openEHR Editor or openEHR CKM.

Could e.g. be Nehta, Norwegian, UK, ...

publisher-organisationThe organisation of this CKM. To be used in an archetype, e.g. openEHR Foundation or Nehta
publisher-namespaceThe namespace of the publisher, e.g. org.openEHR
licenceThe default licence for resources in this CKM, e.g. Creative Commons SA <https://creativecommons.org/licenses/by-sa/3.0/>
max-primary-assetsA max. number of primary assets in this CKM instance
resource-type-to-activate-in-resources-explorers

By default, the archetypes tabs are activated on loading on the left hand.

Can be any of archetype, template, termset.

...