Wiki Spaces

Documentation
Projects
Resources

Get Help from Others

Q&A: Ask OpenMRS
Discussion: OpenMRS Talk
Real-Time: IRC Chat | Slack

Documentation

Page tree

Versions Compared

Key

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

Settings (formerly global properties Global Properties from 1.8 and below) allow 9 downwards) allow users to configure the OpenMRS system's behavior. Some are provided by the OpenMRS core (see examples), and others by modules.

The Settings (formerly global properties Global Properties from 1.8 and below) portlet 9 downwards) portlet lets you easily display the values of a subset of Settings (formerly global properties Global Properties from 1.8 and below9 downwards), and edit them via ajax. This is especially useful if you want your module to have a configuration page, but you don't want to do a lot of work.

...

  • 'propertyPrefix' will limit to only Settings (formerly global properties 1.8 and below) starting with that prefix (e.g. "formimportexport.")
  • 'excludePrefix' will exclude Settings (formerly global properties 1.8 and below) starting with that prefix (e.g. "formimportexport.started")
  • 'hidePrefix' a boolean decides whether or not to trim the prefix on what is displayed (i.e. "formentry.infopath_url" -> "infopath_url") (default false)
  • 'title' will display that title
  • 'showHeader' whether or not to show a header row in the table (default true)
  • 'readOnly' a boolean decides how Settings (formerly global properties 1.8 and below) appear, if it has set readOnly to true the properties will be displayed non editable, if it is not readOnly there is an additional check to verify whether the user has privileges to manage Settings (formerly global properties 1.8 and below).If user is having the privileges the Settings (formerly global properties 1.8 and below) are displayed editable otherwise readonly.

Example usage of the Settings (formerly Settings (formerly global properties Global Properties from 1.8 and below) 1.8 and below) portlet 9 downwards) portlet (extracted from formimportexport module)

Code Block
<openmrs:portlet
    url="globalProperties"
    parameters="title=${title}|propertyPrefix=formimportexport.|excludePrefix=formimportexport.started|hidePrefix=true|readOnly=false"/>

Settings (formerly Settings (formerly global properties 1.8 and below) 1.8 and belowFormerly Global Properties From 1.9 Downwards) in editable manner

Settings (formerly Settings (formerly global properties 1.8 and below) 1.8 and below) Global Properties in readonly manner