Exporting Standardized Data: Difference between revisions

From IHRIS Wiki
 
(47 intermediate revisions by 3 users not shown)
Line 1: Line 1:
In this tutorial we show how to export standardized ''cadre'' data from a central site to be shared among regional and district installations.
Having standardized data lists is useful for managing multiple systems.  This could be for:
*development, testing and production servers of iHRIS
*district and national iHRIS systems in a decentralized iHRIS installation
*use by other systems that want to know what data lists are being used in iHRIS.
 
 
In this tutorial, learn how to export standardized ''cadre'' data from a central site to be shared among regional and district installations.


''Note:'' This module assume that the ''cadre'' form is stored in [[Form Storage -- Magic Data | magic data]].  This is the default for iHRIS Manage version 4.0.
''Note:'' This module assume that the ''cadre'' form is stored in [[Form Storage -- Magic Data | magic data]].  This is the default for iHRIS Manage version 4.0.


''You can also [[Media:Creating_Standard_List_Modules.odp |download this presentation]] which has further details on how to create standardized data lists into modules by exporting them from the Magic Data Browser of iHRIS Manage.''


==Overview==
==Overview==
We will create a module called '''standard-data-cadre''' that will contain all of the cadre's defined in the system.  The module will have version ''4.0.'''YYYY.MM.DD''''' where we replace ''YYYY'' with the year, ''MM'' with the numeric month and ''DD'' with the numeric day.  For example the version would be ''4.0.2010.08.17'' if the data was exported on August 27, 2010. 
We will create a module called '''standard-data-cadre''' that will contain all of the cadre's defined in the system.  We will use the Magic Data Browser to automatically generate a [[Module Structure#Module Configuration File| configuration .xml]] file which we will save as '''standard-data-cadre.xml'''.
 
If we update the cadre list, at a later date (August 20, 2010), then we can re-export the list into the same module ''standard-data-cadre'' but this time with version ''4.0.2010.08.20.''
 
Once we have created this module, we should make it available and required to  each of the regional and district installations.
Once we have created this module, we should make it available and required to  each of the regional and district installations.


==First Steps -- Enabling the Magic Data Browser==  
==First Steps -- Enabling the Magic Data Browser==  
Line 20: Line 23:
*Click the "Enable" button at the bottom of the page
*Click the "Enable" button at the bottom of the page


==Creating the Module==
==Creating the module==
===Browsing in Magic Data===
Creating the module is very easy.  Go to:
Creating the module is very easy.  Go to:
*Browse to "Configure System"
*Browse to "Configure System"
Line 29: Line 33:
*Click the "cadre" link  
*Click the "cadre" link  
You should now see a page that looks like:
You should now see a page that looks like:
[[image:export_cadre1.png| Exporting Cadre]]
[[image:export_cadre1.png|thumb|center|Magic Data Browser]]
 
===Setting Export Options===
Now that we have browser in magic data to '''/I2CE/formsData/forms/cadre''' we are ready to export the module:
*Click on the "(options)" link under the "Export" button
*Set the following data:
**Module Name: "standard-data-cadre"
**Displayed Named: "Standardized Cadre List"
**Version:  Change it from "'''1.0'''.{{CURRENTYEAR}}.{{CURRENTMONTH}}.{{CURRENTDAY}}" to "'''4.0'''.{{CURRENTYEAR}}.{{CURRENTMONTH}}.{{CURRENTDAY}}"
**Description: "The Standardized Cadre list set by the central office of the Ministry of Health"
Your page should look like:
[[image:export_cadre2.png|thumb|center|Export Options]]
 
Now click the "Export" button and your web-browser should ask you where to save the .xml file.  We will save it as the file ''standard-data-cadre.xml''.  See the next section for some hints about where to save this file.
 
 
'''Note:''' The module in general should have version ''4.0.'''YYYY.MM.DD''''' where we replace ''YYYY'' with the year, ''MM'' with the numeric month and ''DD'' with the numeric day.  For example the version would be ''4.0.2010.08.17'' if the data was exported on August 17, 2010. 
If we update the cadre list, at a later date (August 20, 2010), then we can re-export the list into the same module ''standard-data-cadre'' but this time with version ''4.0.2010.08.20.''
 
==Managing Decentralized iHRIS with Launchpad==
First please see the article [[Decentralized iHRIS Data Policy ]] for some background explanation.
 
Please also read [[Managing A Site In Launchpad]] for some background information on creating teams and working with bazaar on Launchpad.
 
''And you should also [http://wiki.ihris.org/wiki/Decentralized_iHRIS_Structure read this] detailed however less technical overview on how to achieve a Decentralized iHRIS Structure.''
 
Let us assume that we are working with a national site (''National''), and four regional sites (''North'',''South'',''East'' and ''West'') in the fictional country ''Taifeki''
 
 
For example create a launchpad team, called ''ihris+taifeki,'' which you and all members of your development team will join.  You should also create a project ''ihris-manage-taifeki'' with the code hosted on Launchpad.
 
===Code Layout===
Here is a template for the directory layout for Taifeki's customizations which contains both the national and regional sites.  Directories are indicated in blue.
*<span style="color:blue">modules</span>: the main modules directory which will contain all of the modules required by each of the sites. 
**<span style="color:blue">ihris-taifeki</span>: a sub-directory of the modules folder which will contain the ihris-taikeki module
***'''ihris-taikeki.xml''':  Defines the module '''ihris-taifeki''' that will contain all of the requirements, html templates, etc. which are common to the national and regional sites.  In particular, it will require the module standard-data-cadre.  See below.
**<span style="color:blue">standard-data-cadre</span>: a sub-directory of the modules directory which will hold our standard cadre list module
***'''standard-data-cadre.xml''':  the module we exported from the magic data browser
*<span style="color:blue">sites</span>:  A directory which will contain the four sites as well as the data management policy. 
**'''data-policy-national.xml''':  Contains the data storage policy for the national site (see below)
**'''data-policy-regional.xml''':  Contains the data storage policy for each of the regional sites (see below)
**<span style="color:blue">national</span>: contains the national site.
***'''national-site.xml''':  The site configuration file for the southern site. Xincludes the data-policy-national.xml and requires the module ihris-tafeki.  See below.
**<span style="color:blue">north</span>: contains the northern region site.
***'''northern-site.xml''':  The site configuration file for the northern site. Xincludes the data-policy-regional.xml and requires the module ihris-tafeki  See below.
**<span style="color:blue">south</span>: contains the southern region site.
***'''southern-site.xml''':  The site configuration file for the southern site. Xincludes the data-policy-regional.xml and requires the module ihris-tafeki
**<span style="color:blue">east</span>: contains the eastern region site.
***'''eastern-site.xml''':  The site configuration file for the eastern site. Xincludes the data-policy-regional.xml and requires the module ihris-tafeki
**<span style="color:blue">west</span>: contains the western region site.
***'''western-site.xml''':  The site configuration file for the western site. Xincludes the data-policy-regional.xml and requires the module ihris-tafeki
 
==Sample .XML Configuration Files==
===ihris-taifeki.xml===
The is the module that contains all of the requirements, html templates, etc. which are common to the national and regional sites.  In particular, it requires the module standard-data-cadre:
<source lang='xml'>
<?xml version="1.0"?>
<!DOCTYPE I2CEConfiguration SYSTEM "I2CE_Configuration.dtd">
<I2CEConfiguration name='ihris-taifeki'>   
  <metadata>
    <displayName>iHRIS Manage Taifeki</displayName> 
    <category>Site</category>
    <description>the iHRIS Manage customizations for Taikeki that apply across regional and central offices</description>
    <version>4.0.5</version>
    <requirement name='ihris-manage'>
      <atLeast version='4.0'/>
      <lessThan version='4.1'/>
    </requirement>
    <requirement name='standard-data-cadre'>
      <atLeast version='4.0'/>
      <lessThan version='4.1'/>
    </requirement>
    <!-- you should create a standard-data-XXXX module for each form XXXX that is being standardized.  It should be required here-->
    <path name='templates'>
      <value>./templates</value>
    </path>
    <path name='images'>
      <value>./images</value>
    </path>
    <priority>400</priority>
  </metadata>
</I2CEConfiguration>
</source>
 
===national-site.xml===
The is the site module for the nataional/central office site
<source lang='xml'>
<?xml version="1.0"?>
<!DOCTYPE I2CEConfiguration SYSTEM "I2CE_Configuration.dtd">
<I2CEConfiguration name='taifeki-national-site'>   
  <metadata>
    <displayName>iHRIS Manage Taifeki National</displayName> 
    <category>Site</category>
    <description>the iHRIS Manage customizations for National Region of  Taikeki</description>
    <version>4.0.5</version>
    <requirement name='ihris-taifeki'>
      <atLeast version='4.0'/>
      <lessThan version='4.1'/>
    </requirement>
    <path name='modules'>
      <value>../../modules/value> 
      <value>/var/lib/iHRIS/lib/4.0.5</value>
    </path>
    <path name='templates'>
      <value>./templates</value>
    </path>
    <path name='images'>
      <value>./images</value>
    </path>
    <priority>450</priority>
  </metadata>
  <configurationGroup name='taifeki-national-site' path='/'>
 
    <xi:include href="../data-policy-national.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
    <configurationGroup name='template' path='/I2CE/template'>
      <displayName>Template Information</displayName>
      <description>Various Default Information About The Templating System</description>
      <configuration name='prefix_title' values='single'>
        <displayName>Page title prefix</displayName>
        <value>iHRIS Manage Taifeki (Central Office)</value>
      </configuration>
    </configurationGroup>
   
 
    <configurationGroup name='custom_report_pdf_options' path='/modules/CustomReports/displays/PDF/display_options'>
      <displayName>PDF Options</displayName>
      <configurationGroup name='header'>
        <displayName>Header Options</displayName>
        <configuration name='text_prefix' >
          <displayName>Header Text</displayName>
          <value>iHRIS Manage Taifeki (Central Office)</value>
        </configuration>
      </configurationGroup>
    </configurationGroup>
 
  </configurationGroup>
</I2CEConfiguration>
</source>
 
===northern-site.xml===
The is the site module for the northern site
<source lang='xml'>
<?xml version="1.0"?>
<!DOCTYPE I2CEConfiguration SYSTEM "I2CE_Configuration.dtd">
<I2CEConfiguration name='taifeki-northern-site'>   
  <metadata>
    <displayName>iHRIS Manage Taifeki Northern</displayName> 
    <category>Site</category>
    <description>the iHRIS Manage customizations for Northern Region of  Taikeki</description>
    <version>4.0.5</version>
    <requirement name='ihris-taifeki'>
      <atLeast version='4.0'/>
      <lessThan version='4.1'/>
    </requirement>
    <path name='modules'>
      <value>../../modules/value> 
      <value>/var/lib/iHRIS/lib/4.0.5</value>
    </path>
    <path name='templates'>
      <value>./templates</value>
    </path>
    <path name='images'>
      <value>./images</value>
    </path>
    <priority>450</priority>
  </metadata>
  <configurationGroup name='taifeki-northern-site' path='/'>
 
    <xi:include href="../data-policy-regional.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
    <configurationGroup name='template' path='/I2CE/template'>
      <displayName>Template Information</displayName>
      <description>Various Default Information About The Templating System</description>
      <configuration name='prefix_title' values='single'>
        <displayName>Page title prefix</displayName>
        <value>iHRIS Manage Taifeki (Northern Region)</value>
      </configuration>
    </configurationGroup>
   
 
    <configurationGroup name='custom_report_pdf_options' path='/modules/CustomReports/displays/PDF/display_options'>
      <displayName>PDF Options</displayName>
      <configurationGroup name='header'>
        <displayName>Header Options</displayName>
        <configuration name='text_prefix' >
          <displayName>Header Text</displayName>
          <value>iHRIS Manage Taifeki (Northern Region)</value>
        </configuration>
      </configurationGroup>
    </configurationGroup>
 
  </configurationGroup>
</I2CEConfiguration>
</source>
 
===data-policy-national.xml===
In the data-policy-national.xml will be xincluded in our national site's configuration file.  We want to set it so that the national site has the cadre list stored in magic data and is read-write.
 
We will also need to specify that we are aggregating data from each of the regional sites.  This is done via the [[Form Storage -- Multi-Flat Table |multi-flat]] form storage mechanism.
 
It should look like this:
<source lang='xml'>
  <configurationGroup name='form_storage' path='/modules/forms/forms'>
    <version>4.0.5.0</version>
 
    <configuration name='multi_flat_componentized'  path='/modules/forms/storage_options/multi_flat/componentized'>
        <value>1</value>
    </configuration>
    <configurationGroup name='multi_flat_components' path='/modules/forms/storage_options/multi_flat/components'>
        <configuration name='northern' values='many' type='delimited'>
              <value>database:manage_northern</value>
        </configuration>
        <configuration name='southern' values='many' type='delimited'>
              <value>database:manage_southern</value>
        </configuration>
        <configuration name='eastern' values='many' type='delimited'>
              <value>database:manage_eastern</value>
        </configuration>
        <configuration name='western' values='many' type='delimited'>
              <value>database:manage_western</value>
        </configuration>
    </configurationGroup>
 
    <configurationGroup name='cadre'>
        <configuration name='read_only' >
              <value>0</value>
        </configuration>
        <configuration name='storage'>
              <value>magicdata</value>
        </configuration>
    </configurationGroup>
 
    <!-- You need to repeat the read-write magic data storage for each of the forms we are maintaining at the central site-->
 
    <configurationGroup name='person'>
        <configuration name='storage'>
              <value>multi_flat</value>
        </configuration>
    </configurationGroup>
 
    <!-- You need to repeat the multi_flat storage for each of the forms we are aggregating from a regional site-->
  </configurationGroup> 
</source>
 
===data-policy-regional.xml===
In the data-policy-regional.xml will be xincluded in our regional site's configuration files.  We want to set it so that the regional sites have the cadre list stored in magic data and is read-only. It should look like this:
<source lang='xml'>
  <configurationGroup name='form_storage' path='/modules/forms/forms'>
    <version>4.0.5.0</version>
    <configurationGroup name='cadre'>
        <configuration name='read_only' >
              <value>1</value>
        </configuration>
        <configuration name='storage'>
              <value>magicdata</value>
        </configuration>
    </configurationGroup>
    <!-- You need to repeat the read-only magic data storage for each of the forms we are maintaining at the central site-->
 
  </configurationGroup>
</source>
 
[[Category:Developer Resources]]

Latest revision as of 18:56, 1 March 2019

Having standardized data lists is useful for managing multiple systems. This could be for:

  • development, testing and production servers of iHRIS
  • district and national iHRIS systems in a decentralized iHRIS installation
  • use by other systems that want to know what data lists are being used in iHRIS.


In this tutorial, learn how to export standardized cadre data from a central site to be shared among regional and district installations.

Note: This module assume that the cadre form is stored in magic data. This is the default for iHRIS Manage version 4.0.

You can also download this presentation which has further details on how to create standardized data lists into modules by exporting them from the Magic Data Browser of iHRIS Manage.

Overview

We will create a module called standard-data-cadre that will contain all of the cadre's defined in the system. We will use the Magic Data Browser to automatically generate a configuration .xml file which we will save as standard-data-cadre.xml. Once we have created this module, we should make it available and required to each of the regional and district installations.

First Steps -- Enabling the Magic Data Browser

We will export the cadre list using the "Magic Data Browser" module. If it is not available under the "Configure System" menu, then follow these steps to enable it:

  • Browse to "Configure System"
  • Click the "Configure Modules" link
  • Click the link "Sub-Modules" to the right of the "Pages" module
  • Check the check box next to "Magic Data Browser"
  • Click the "Enable" button at the bottom of the page

Creating the module

Browsing in Magic Data

Creating the module is very easy. Go to:

  • Browse to "Configure System"
  • Click the "Browse Magic Data" link
  • Click the "I2CE" link
  • Click the "formsData" link
  • Click the "forms" link
  • Click the "cadre" link

You should now see a page that looks like:

Magic Data Browser

Setting Export Options

Now that we have browser in magic data to /I2CE/formsData/forms/cadre we are ready to export the module:

  • Click on the "(options)" link under the "Export" button
  • Set the following data:
    • Module Name: "standard-data-cadre"
    • Displayed Named: "Standardized Cadre List"
    • Version: Change it from "1.0.2024.11.28" to "4.0.2024.11.28"
    • Description: "The Standardized Cadre list set by the central office of the Ministry of Health"

Your page should look like:

Export Options

Now click the "Export" button and your web-browser should ask you where to save the .xml file. We will save it as the file standard-data-cadre.xml. See the next section for some hints about where to save this file.


Note: The module in general should have version 4.0.YYYY.MM.DD where we replace YYYY with the year, MM with the numeric month and DD with the numeric day. For example the version would be 4.0.2010.08.17 if the data was exported on August 17, 2010. If we update the cadre list, at a later date (August 20, 2010), then we can re-export the list into the same module standard-data-cadre but this time with version 4.0.2010.08.20.

Managing Decentralized iHRIS with Launchpad

First please see the article Decentralized iHRIS Data Policy for some background explanation.

Please also read Managing A Site In Launchpad for some background information on creating teams and working with bazaar on Launchpad.

And you should also read this detailed however less technical overview on how to achieve a Decentralized iHRIS Structure.

Let us assume that we are working with a national site (National), and four regional sites (North,South,East and West) in the fictional country Taifeki


For example create a launchpad team, called ihris+taifeki, which you and all members of your development team will join. You should also create a project ihris-manage-taifeki with the code hosted on Launchpad.

Code Layout

Here is a template for the directory layout for Taifeki's customizations which contains both the national and regional sites. Directories are indicated in blue.

  • modules: the main modules directory which will contain all of the modules required by each of the sites.
    • ihris-taifeki: a sub-directory of the modules folder which will contain the ihris-taikeki module
      • ihris-taikeki.xml: Defines the module ihris-taifeki that will contain all of the requirements, html templates, etc. which are common to the national and regional sites. In particular, it will require the module standard-data-cadre. See below.
    • standard-data-cadre: a sub-directory of the modules directory which will hold our standard cadre list module
      • standard-data-cadre.xml: the module we exported from the magic data browser
  • sites: A directory which will contain the four sites as well as the data management policy.
    • data-policy-national.xml: Contains the data storage policy for the national site (see below)
    • data-policy-regional.xml: Contains the data storage policy for each of the regional sites (see below)
    • national: contains the national site.
      • national-site.xml: The site configuration file for the southern site. Xincludes the data-policy-national.xml and requires the module ihris-tafeki. See below.
    • north: contains the northern region site.
      • northern-site.xml: The site configuration file for the northern site. Xincludes the data-policy-regional.xml and requires the module ihris-tafeki See below.
    • south: contains the southern region site.
      • southern-site.xml: The site configuration file for the southern site. Xincludes the data-policy-regional.xml and requires the module ihris-tafeki
    • east: contains the eastern region site.
      • eastern-site.xml: The site configuration file for the eastern site. Xincludes the data-policy-regional.xml and requires the module ihris-tafeki
    • west: contains the western region site.
      • western-site.xml: The site configuration file for the western site. Xincludes the data-policy-regional.xml and requires the module ihris-tafeki

Sample .XML Configuration Files

ihris-taifeki.xml

The is the module that contains all of the requirements, html templates, etc. which are common to the national and regional sites. In particular, it requires the module standard-data-cadre: <source lang='xml'>

<?xml version="1.0"?>
<!DOCTYPE I2CEConfiguration SYSTEM "I2CE_Configuration.dtd">
<I2CEConfiguration name='ihris-taifeki'>     
  <metadata>
    <displayName>iHRIS Manage Taifeki</displayName>   
    <category>Site</category>
    <description>the iHRIS Manage customizations for Taikeki that apply across regional and central offices</description>
    <version>4.0.5</version>
    <requirement name='ihris-manage'>
      <atLeast version='4.0'/>
      <lessThan version='4.1'/>
    </requirement>
    <requirement name='standard-data-cadre'>
      <atLeast version='4.0'/>
      <lessThan version='4.1'/>
    </requirement>
    <path name='templates'> 
      <value>./templates</value> 
    </path>
    <path name='images'>
      <value>./images</value>
    </path>
    <priority>400</priority>
  </metadata>
</I2CEConfiguration>

</source>

national-site.xml

The is the site module for the nataional/central office site <source lang='xml'>

<?xml version="1.0"?>
<!DOCTYPE I2CEConfiguration SYSTEM "I2CE_Configuration.dtd">
<I2CEConfiguration name='taifeki-national-site'>     
  <metadata>
    <displayName>iHRIS Manage Taifeki National</displayName>   
    <category>Site</category>
    <description>the iHRIS Manage customizations for National Region of  Taikeki</description>
    <version>4.0.5</version>
    <requirement name='ihris-taifeki'>
      <atLeast version='4.0'/>
      <lessThan version='4.1'/>
    </requirement>
    <path name='modules'> 
      <value>../../modules/value>   
      <value>/var/lib/iHRIS/lib/4.0.5</value>
    </path>
    <path name='templates'> 
      <value>./templates</value> 
    </path>
    <path name='images'>
      <value>./images</value>
    </path>
    <priority>450</priority>
  </metadata>
 <configurationGroup name='taifeki-national-site' path='/'>
   <xi:include href="../data-policy-national.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>

   <configurationGroup name='template' path='/I2CE/template'>
     <displayName>Template Information</displayName>
     <description>Various Default Information About The Templating System</description>
     <configuration name='prefix_title' values='single'>
       <displayName>Page title prefix</displayName>
       <value>iHRIS Manage Taifeki (Central Office)</value>
     </configuration>
   </configurationGroup>
   
   <configurationGroup name='custom_report_pdf_options' path='/modules/CustomReports/displays/PDF/display_options'>
     <displayName>PDF Options</displayName>
     <configurationGroup name='header'>
       <displayName>Header Options</displayName>
       <configuration name='text_prefix' >
         <displayName>Header Text</displayName>
         <value>iHRIS Manage Taifeki (Central Office)</value>
       </configuration>
     </configurationGroup>
   </configurationGroup>
 </configurationGroup>
</I2CEConfiguration>

</source>

northern-site.xml

The is the site module for the northern site <source lang='xml'>

<?xml version="1.0"?>
<!DOCTYPE I2CEConfiguration SYSTEM "I2CE_Configuration.dtd">
<I2CEConfiguration name='taifeki-northern-site'>     
  <metadata>
    <displayName>iHRIS Manage Taifeki Northern</displayName>   
    <category>Site</category>
    <description>the iHRIS Manage customizations for Northern Region of  Taikeki</description>
    <version>4.0.5</version>
    <requirement name='ihris-taifeki'>
      <atLeast version='4.0'/>
      <lessThan version='4.1'/>
    </requirement>
    <path name='modules'> 
      <value>../../modules/value>   
      <value>/var/lib/iHRIS/lib/4.0.5</value>
    </path>
    <path name='templates'> 
      <value>./templates</value> 
    </path>
    <path name='images'>
      <value>./images</value>
    </path>
    <priority>450</priority>
  </metadata>
 <configurationGroup name='taifeki-northern-site' path='/'>
   <xi:include href="../data-policy-regional.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>

   <configurationGroup name='template' path='/I2CE/template'>
     <displayName>Template Information</displayName>
     <description>Various Default Information About The Templating System</description>
     <configuration name='prefix_title' values='single'>
       <displayName>Page title prefix</displayName>
       <value>iHRIS Manage Taifeki (Northern Region)</value>
     </configuration>
   </configurationGroup>
   
   <configurationGroup name='custom_report_pdf_options' path='/modules/CustomReports/displays/PDF/display_options'>
     <displayName>PDF Options</displayName>
     <configurationGroup name='header'>
       <displayName>Header Options</displayName>
       <configuration name='text_prefix' >
         <displayName>Header Text</displayName>
         <value>iHRIS Manage Taifeki (Northern Region)</value>
       </configuration>
     </configurationGroup>
   </configurationGroup>
 </configurationGroup>
</I2CEConfiguration>

</source>

data-policy-national.xml

In the data-policy-national.xml will be xincluded in our national site's configuration file. We want to set it so that the national site has the cadre list stored in magic data and is read-write.

We will also need to specify that we are aggregating data from each of the regional sites. This is done via the multi-flat form storage mechanism.

It should look like this: <source lang='xml'>

 <configurationGroup name='form_storage' path='/modules/forms/forms'>
   <version>4.0.5.0</version>
   <configuration name='multi_flat_componentized'   path='/modules/forms/storage_options/multi_flat/componentized'>
        <value>1</value>
   </configuration>
   <configurationGroup name='multi_flat_components' path='/modules/forms/storage_options/multi_flat/components'>
        <configuration name='northern' values='many' type='delimited'>
             <value>database:manage_northern</value>
        </configuration>
        <configuration name='southern' values='many' type='delimited'>
             <value>database:manage_southern</value>
        </configuration>
        <configuration name='eastern' values='many' type='delimited'>
             <value>database:manage_eastern</value>
        </configuration>
        <configuration name='western' values='many' type='delimited'>
             <value>database:manage_western</value>
        </configuration>
   </configurationGroup>
   <configurationGroup name='cadre'>
       <configuration name='read_only' >
             <value>0</value>
       </configuration>
       <configuration name='storage'>
             <value>magicdata</value>
       </configuration>
   </configurationGroup>


   <configurationGroup name='person'>
       <configuration name='storage'>
             <value>multi_flat</value>
       </configuration>
   </configurationGroup>
 </configurationGroup>  

</source>

data-policy-regional.xml

In the data-policy-regional.xml will be xincluded in our regional site's configuration files. We want to set it so that the regional sites have the cadre list stored in magic data and is read-only. It should look like this: <source lang='xml'>

 <configurationGroup name='form_storage' path='/modules/forms/forms'>
   <version>4.0.5.0</version>
   <configurationGroup name='cadre'>
       <configuration name='read_only' >
             <value>1</value>
       </configuration>
       <configuration name='storage'>
             <value>magicdata</value>
       </configuration>
   </configurationGroup>
 </configurationGroup>

</source>