Difference between revisions of "Tabular Data Manager: Template Management"
Lucio.lelii (Talk | contribs) (→Definition and Validation Template) |
(→Template Save) |
||
(21 intermediate revisions by 3 users not shown) | |||
Line 1: | Line 1: | ||
+ | [[Category:Tabular Data Manager]] | ||
+ | |||
== Template == | == Template == | ||
− | + | A template is a predefined data structure (characterizing both the data element entities and a set of rules constraining data values) a Tabular Resource should comply with. | |
+ | |||
+ | The main menu enables to create, open or delete a template as well as to use it to characterise a Tabular Resource. | ||
[[Image:tabular_data_manager_template.png|frame|center|Tabular Data Manager, Template tab]] | [[Image:tabular_data_manager_template.png|frame|center|Tabular Data Manager, Template tab]] | ||
=== New Template === | === New Template === | ||
− | A | + | A Template can be defined in three steps: |
− | # Definition and Validation of initial structure of the Template; | + | # [[#Definition_of_metadata | Definition of metadata]]; |
− | # Definition of Actions to execute | + | # [[#Definition and Validation of initial structure of the Template | Definition and Validation of initial structure of the Template]]; |
− | + | # [[#Definition of Actions to execute | Definition of Actions to execute]]. | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
+ | ==== Definition of metadata ==== | ||
+ | In this step the user has to compile the following elements: | ||
+ | * '''TEMPLATE TYPE''' the TabularResource type that the template will create (DATASET, CODELIST or GENERIC); | ||
+ | * '''NAME''' the given name of the templete; | ||
+ | * '''AGENCY''' the responsible party defining this template; | ||
+ | * '''DESCRIPTION''' a textual description of the template; | ||
+ | * '''ON ERROR''' the behavior of the execution in case of errors selected among the following possible ones: | ||
+ | ** ''ASK'' to stop the execution; | ||
+ | ** ''DISCARD'' to remove all rows with errors and continue the execution; | ||
+ | ** ''SAVE'' to store all rows with errors in a separate file and continue the execution. | ||
+ | * '''NUMBER OF COLUMNS''' the number of columns of the initial structure. | ||
+ | [[Image:choosetemplete.png|700px|thumb|center|Tabular Data Manager, template type: dataset, codelist, generic]] | ||
− | ==== Definition and Validation Template ==== | + | ==== Definition and Validation of initial structure of the Template ==== |
− | In this step the | + | In this step the user specifies the typologies and associated data types for each column. |
+ | Moreover, it specifies [[#Rules | validation rules]] and [[#Flows | data flows]] characterising the behaviour of every TabularResource complying with the template. | ||
− | + | For each type of table the template is intended for, the user is provided with detailed guidelines supporting the selection of proper typologies and related data types. | |
+ | |||
+ | The following picture shows the typologies supported for each column of a Codelist template (Code Name, Code Description, Annotation, Code): | ||
[[Image:codelist.png|700px|thumb|center|Tabular Data Manager, Structure of a codelist template]] | [[Image:codelist.png|700px|thumb|center|Tabular Data Manager, Structure of a codelist template]] | ||
+ | |||
+ | The following picture shows the typologies supported for each column of a Dataset template (Attribute, Dimension, Measure, Time Dimension): | ||
[[Image:dataset.png|700px|thumb|center|Tabular Data Manager, Structure of a dataset template]] | [[Image:dataset.png|700px|thumb|center|Tabular Data Manager, Structure of a dataset template]] | ||
+ | |||
+ | The following picture shows the typologies supported for each column of a Dataset template (Measure, Attribute, Time Dimension): | ||
[[Image:generic.png|700px|thumb|center|Tabular Data Manager, Structure of a generic template]] | [[Image:generic.png|700px|thumb|center|Tabular Data Manager, Structure of a generic template]] | ||
'''''Rules''''' | '''''Rules''''' | ||
− | During definition and validation of a | + | During definition and validation of a template users can add one or more expressions for data validation (Rules). |
+ | Expressions can be defined on columns where data typologies and data types have been previously specified. | ||
+ | Allowed rules will take into account the column characterization (data typology and data type). | ||
[[Image:rules.png|700px|thumb|center|Template, Rule definition on Measure Column]] | [[Image:rules.png|700px|thumb|center|Template, Rule definition on Measure Column]] | ||
[[Image:tworulestemplate.png|700px|thumb|center|Template, e.g. of a template with two rules]] | [[Image:tworulestemplate.png|700px|thumb|center|Template, e.g. of a template with two rules]] | ||
Line 42: | Line 54: | ||
Flows are a special type of TabularResource that can be created only from a Template. | Flows are a special type of TabularResource that can be created only from a Template. | ||
− | + | Adding a flow on Template Definition means that every entry resulted from the application of this template will be copied in the selected FLOW. | |
− | The flow, once created, cannot be modified | + | The flow, once created, cannot be modified. |
+ | It can only be cloned or analysed using the [[Analyse_(Tabular_Data_Manager) | Analyse ]] Tab. | ||
− | User has to fill all the needed metadata (as for the creation of a new TabularResource) | + | User has to fill in all the needed metadata (as for the creation of a new TabularResource). |
+ | The user has to select the behavior in case of duplicate entries. | ||
[[Image:flow.png|700px|thumb|center|Template, Flow dialog creation]] | [[Image:flow.png|700px|thumb|center|Template, Flow dialog creation]] | ||
− | ==== Definition | + | ==== Definition of Actions to execute ==== |
− | Users can add | + | Users can add Actions to be applied to the template defined in step 2. |
The available operations are: | The available operations are: | ||
− | + | *'''Add Column''' | |
− | + | *'''Remove Column''' | |
− | + | *'''Create Time Dimension''' | |
− | + | *'''Aggregate By Time''' | |
− | + | *'''Normalize''' | |
− | + | ||
[[Image:post-operations.png|700px|thumb|center|Template, Post Operations]] | [[Image:post-operations.png|700px|thumb|center|Template, Post Operations]] | ||
− | Users | + | Users are provided with the history of the applied operations by selecting ''History Operations'' |
'''''Add Column''''' | '''''Add Column''''' | ||
+ | |||
+ | This Action adds a new column to the TabularResource. | ||
+ | The new column will be initialized with the expression defined by clicking on the ''Set Value'' button. | ||
[[Image:Addcolumnoperation.png|700px|thumb|center|Template, Add Column Operation]] | [[Image:Addcolumnoperation.png|700px|thumb|center|Template, Add Column Operation]] | ||
'''''Create Time Dimension''''' | '''''Create Time Dimension''''' | ||
+ | |||
+ | This Action creates a new column of type TimeDimension using other columns. | ||
+ | The user has to select the columns for 'YEAR', ''YEAR and MONTH'', ''YEAR, MONTH and DAY'', ''YEAR and QUARTER'' depending on what type of TimeDimension columns he wants to be created. | ||
[[Image:Createtimedimensionoperation.png|700px|thumb|center|Template, Create Time Dimension Operation]] | [[Image:Createtimedimensionoperation.png|700px|thumb|center|Template, Create Time Dimension Operation]] | ||
'''''Aggregate By Time''''' | '''''Aggregate By Time''''' | ||
+ | |||
+ | Aggregates a list of columns by time (see the [[ Modify_(Tabular_Data_Manager)#Time_aggregation | Aggregate By Time]] operation ) | ||
[[Image:Aggregatebytimeoperation.png|700px|thumb|center|Template, Aggregate By Time Operation]] | [[Image:Aggregatebytimeoperation.png|700px|thumb|center|Template, Aggregate By Time Operation]] | ||
'''''Normalize''''' | '''''Normalize''''' | ||
+ | |||
+ | Applies the normalization operation (see [[ Curation_(Tabular_Data_Manager)#Normalize | Normalize ]] operation) | ||
[[Image:Normalizeoperation.png|700px|thumb|center|Template, Normalize Operation]] | [[Image:Normalizeoperation.png|700px|thumb|center|Template, Normalize Operation]] | ||
− | |||
− | |||
− | === | + | ==== Template Save ==== |
− | + | This action saves the template created. Save As to save a copy of your template | |
+ | |||
+ | [[Image:TemplateSaveAs.png|700px|thumb|center|Template Save and Save as]] | ||
=== Apply Template === | === Apply Template === | ||
− | The Apply Template function allows | + | The Apply Template function allows application of a template to the current TabularResource. |
+ | The TabularResource structure MUST be compatible with the initial structure defined in the template otherwise a TemplateNotCompatible error will be thrown. | ||
<!--- da fare--> | <!--- da fare--> | ||
[[Image:Tabular_data_manager_templateapply1.png|frame|center|Tabular Data Manager, Applying the template to a tabular resource]] | [[Image:Tabular_data_manager_templateapply1.png|frame|center|Tabular Data Manager, Applying the template to a tabular resource]] | ||
− | |||
− | |||
− |
Latest revision as of 15:04, 8 October 2015
Contents
Template
A template is a predefined data structure (characterizing both the data element entities and a set of rules constraining data values) a Tabular Resource should comply with.
The main menu enables to create, open or delete a template as well as to use it to characterise a Tabular Resource.
New Template
A Template can be defined in three steps:
- Definition of metadata;
- Definition and Validation of initial structure of the Template;
- Definition of Actions to execute.
Definition of metadata
In this step the user has to compile the following elements:
- TEMPLATE TYPE the TabularResource type that the template will create (DATASET, CODELIST or GENERIC);
- NAME the given name of the templete;
- AGENCY the responsible party defining this template;
- DESCRIPTION a textual description of the template;
- ON ERROR the behavior of the execution in case of errors selected among the following possible ones:
- ASK to stop the execution;
- DISCARD to remove all rows with errors and continue the execution;
- SAVE to store all rows with errors in a separate file and continue the execution.
- NUMBER OF COLUMNS the number of columns of the initial structure.
Definition and Validation of initial structure of the Template
In this step the user specifies the typologies and associated data types for each column. Moreover, it specifies validation rules and data flows characterising the behaviour of every TabularResource complying with the template.
For each type of table the template is intended for, the user is provided with detailed guidelines supporting the selection of proper typologies and related data types.
The following picture shows the typologies supported for each column of a Codelist template (Code Name, Code Description, Annotation, Code):
The following picture shows the typologies supported for each column of a Dataset template (Attribute, Dimension, Measure, Time Dimension):
The following picture shows the typologies supported for each column of a Dataset template (Measure, Attribute, Time Dimension):
Rules
During definition and validation of a template users can add one or more expressions for data validation (Rules). Expressions can be defined on columns where data typologies and data types have been previously specified. Allowed rules will take into account the column characterization (data typology and data type).
Flow
Flows are a special type of TabularResource that can be created only from a Template. Adding a flow on Template Definition means that every entry resulted from the application of this template will be copied in the selected FLOW. The flow, once created, cannot be modified. It can only be cloned or analysed using the Analyse Tab.
User has to fill in all the needed metadata (as for the creation of a new TabularResource). The user has to select the behavior in case of duplicate entries.
Definition of Actions to execute
Users can add Actions to be applied to the template defined in step 2.
The available operations are:
- Add Column
- Remove Column
- Create Time Dimension
- Aggregate By Time
- Normalize
Users are provided with the history of the applied operations by selecting History Operations
Add Column
This Action adds a new column to the TabularResource. The new column will be initialized with the expression defined by clicking on the Set Value button.
Create Time Dimension
This Action creates a new column of type TimeDimension using other columns. The user has to select the columns for 'YEAR', YEAR and MONTH, YEAR, MONTH and DAY, YEAR and QUARTER depending on what type of TimeDimension columns he wants to be created.
Aggregate By Time
Aggregates a list of columns by time (see the Aggregate By Time operation )
Normalize
Applies the normalization operation (see Normalize operation)
Template Save
This action saves the template created. Save As to save a copy of your template
Apply Template
The Apply Template function allows application of a template to the current TabularResource. The TabularResource structure MUST be compatible with the initial structure defined in the template otherwise a TemplateNotCompatible error will be thrown.