Technical Overview: Form Storage -- SDMX CrossSectional: Difference between revisions
From IHRIS Wiki
Line 14: | Line 14: | ||
*file: Required scalar node. The SDMX file that the data should be read from. This can either be an absolutely given file path, or a relative file path. If it is a relative file path, then it uses the SDMXHD [[File Search Paths | file search]] category. | *file: Required scalar node. The SDMX file that the data should be read from. This can either be an absolutely given file path, or a relative file path. If it is a relative file path, then it uses the SDMXHD [[File Search Paths | file search]] category. | ||
*namespace: Optional scalar node. defaults to 'ns'. | *namespace: Optional scalar node. defaults to 'ns'. | ||
*parent: optional parent node. The data defining how to associate a parent id DOM Node. | |||
**attribute: Required scalar node. The name of the attribute which contains the parent. If neither 'query' or this is set, there is not parent data. 'query' takes precendence. | |||
*parent: optional parent node. The data defining how to associate a parent id DOM Node | |||
**attribute: | |||
**eval: Optional scalar node. If set it is a code php code which modifies the id, stored in the $val variable. For example '$val = strtoupper($val);' | **eval: Optional scalar node. If set it is a code php code which modifies the id, stored in the $val variable. For example '$val = strtoupper($val);' | ||
*fields: Optional parent node. Specifies how the data of the your form is associate to a row of your table. Each child of this node is the name of a field $field of your form. | *fields: Optional parent node. Specifies how the data of the your form is associate to a row of your table. Each child of this node is the name of a field $field of your form. |
Revision as of 11:40, 3 August 2010
This is a form storage mechanism designed to read data from an SDMX-HD code list file. This form storage mechanism is present in version >= 4.0.6.
This is a read-only form storage mechanism.
This form storage mechanism requires PHP 5.3 or greater
Form Storage Options
The options specifying a SDMX Cross Sectional storage for $form are stored at:
/modules/forms/forms/$form/storage_options/SDMX_CrossSectional
It has the following structure:
- file: Required scalar node. The SDMX file that the data should be read from. This can either be an absolutely given file path, or a relative file path. If it is a relative file path, then it uses the SDMXHD file search category.
- namespace: Optional scalar node. defaults to 'ns'.
- parent: optional parent node. The data defining how to associate a parent id DOM Node.
- attribute: Required scalar node. The name of the attribute which contains the parent. If neither 'query' or this is set, there is not parent data. 'query' takes precendence.
- eval: Optional scalar node. If set it is a code php code which modifies the id, stored in the $val variable. For example '$val = strtoupper($val);'
- fields: Optional parent node. Specifies how the data of the your form is associate to a row of your table. Each child of this node is the name of a field $field of your form.
- $field: Optional parent node with the following child nodes.
- attribute: Required scalar node. The name of the attribute which contains the parent. If neither 'query' nor this is set, there is not data. 'query' takes precendence
- eval: Optional scalar node. If set it is a code php code which modifies the id, stored in the $val variable. For example '$val = strtoupper($val);'
- map_data: Optional parent node. .It is used to map the given field via a SDMX-HD Code List that is in the system
- list: Required scalar node. The list that we want this field to take values in
- codelist: Required scalar node: The name of the SDMX-HD code list which this attribute takes values in, in other words the value we wish to map from.
- mapping_form: Optional scalar node. The name of the form which contains the mapping data between the SDMX-HD Code List and the list we wish to map to. If the module Lists-LinkTo-List is enabled and the value is not set then it defaults to list_linkto_list_XXXX where XXXX is the form storage mechanism of the list
- $field: Optional parent node with the following child nodes.