Difference between revisions of "Add Item Attributes to the Design Pane"

From IMSMA Wiki
Jump to: navigation, search
(Created page with "After you have specified the page setup for the field report template, you can begin adding item attributes. To add individual item attributes to the field report: <ol> <li>...")
 
 
(33 intermediate revisions by 4 users not shown)
Line 1: Line 1:
−
After you have specified the page setup for the field report template, you can begin adding item attributes.  
+
After you have specified the page setup for the data entry form template, you can begin adding item attributes/fields.  
−
To add individual item attributes to the field report:  
+
To add attributes to the data entry form in the Data Entry Form Template Designer window:  
 
<ol>
 
<ol>
−
<li>Expand the item folder that contains the attribute by double-clicking the folder name in the elements pane.</li>
+
<li>Expand the item folder that contains the attribute by double-clicking the folder name in the Elements pane.</li>
 
<li>Expand the data category that contains the item attribute.</li>
 
<li>Expand the data category that contains the item attribute.</li>
−
<li>Click the name of the attribute you would like to add to the field report.</li>
+
<li>Click the name of the attribute you would like to add to the data entry form.</li>
 
<li>While holding down the left mouse button, drag the attribute to the form design pane.</li>
 
<li>While holding down the left mouse button, drag the attribute to the form design pane.</li>
−
<li>When the item attribute’s elements are in the desired position, release the mouse button.</li>
+
<li>When the item attribute is in the desired position, release the mouse button.</li>
 
</ol>
 
</ol>
  
−
{{Important|If you drag an item attribute to the design pane which has previously been added, the following message displays:
+
{{Note|If you drag an item attribute to the design pane which has previously been added, the following message displays:
−
:At least one of the components you dragged onto the form already exists. Do you want to create a new entity?
+
:At least one of the fields you dragged on to the template already exists in the template. You cannot add the same field more than once to the template.
−
Click the '''Yes''' button if you would like your field report template to capture data for another item record and add the item attribute to the field report template. Otherwise, click the No button; the item attribute will not be added to the field report template.  
+
Click the '''OK''' button.  
 
}}
 
}}
  
 
<ol>
 
<ol>
−
:The element and its label are placed in the form design pane.
+
The element and its label are placed in the form design pane.
 
</ol>
 
</ol>
  
−
{{note|You can also add all item attributes to the field report by dragging the folder of the item to the design pane.  
+
{{note|You can also add all item attributes in a category to the data entry form by dragging it to the design pane.  
 
}}
 
}}
  
 
<ol start="6">
 
<ol start="6">
−
<li>Repeat the above steps to add additional item attributes to the field report.</li>
+
<li>Repeat the above steps to add additional item attributes to the data entry form.</li>
 
</ol>
 
</ol>
  
−
When item attributes are dragged to the design pane, they typically include both a text label and the data entry field. The data entry field and label should be kept together to ensure the integrity of the data. Although you can change the label text, be sure to provide a meaningful label so that it is clear to users what data they should enter in the field.  
+
{{Warning | When item attributes are dragged to the design pane, they will use widgets for that data type. '''All''' parts of the widget should be present in the template in order to ensure that the widget will work for data entry. Although you can change properties and e.g. the label text. In the geographical widget you may delete the polyline/polygon table.}}
  
−
[[Image:UserManual_LocationNameField.png|center|500px|''Elements'']]
+
Depending on which data type the item attribute is and on the settings in the Data Inventory Manager the control / widget is different.
 +
{| class="wikitable"
 +
! Type in DIM
 +
! Setting in DIM
 +
! Example
 +
! Widget
 +
! Control / widget
 +
|-
 +
| System
 +
| No
 +
| Land ID
 +
| Local ID Generator
 +
| [[Image:Local_ID_Gen.png]]
 +
|-
 +
| Country Structure
 +
| No
 +
| Victim Living In
 +
| Country Structure
 +
| [[Image:cs.png]]
 +
|-
 +
| Date
 +
| No
 +
| Status changed date
 +
| Date
 +
| [[Image:date.png]]
 +
|-
 +
| Geographical information
 +
| No
 +
| All items
 +
| Geo data
 +
| [[Image:geo.png]]
 +
The difference between the columns ''X / Lon & Y / Lat'' and ''X / Longitude & Y / Latitude'' is described [[Summary Window#Data area - Geospatial tab|'''here''']].
 +
|-
 +
| Multiple Select
 +
| No
 +
| Vulnerable group
 +
| Multiple Select
 +
| [[Image:multiselect.png]]
 +
|-
 +
| Number
 +
| No
 +
| Size of Living Space
 +
| Text Field
 +
| [[Image:number.png]]
 +
|-
 +
| Organisation
 +
| No
 +
| Organisation
 +
| Organisation
 +
| [[Image:org.png]]
 +
|-
 +
| Place
 +
| No
 +
| Status changed date
 +
| Place
 +
| [[Image:place.png]]
  
−
In addition to the text label and data entry field, certain item attributes such as date fields, country structure, and geospatial data will also include an icon. You should keep these elements together to ensure the integrity of the data. If any one of the elements is removed, you should remove all related elements.
+
|-
 +
| Single Select
 +
| Yes
 +
| Land Status
 +
| Radio button
 +
| [[Image:rb_std.png]]
 +
|-
 +
| Single Select
 +
| Yes
 +
| Status changed reason
 +
| Combo box
 +
| [[Image:combobox.png]]
 +
|-
 +
| String / Text
 +
| Only for CDFs
 +
| Land Name
 +
| Text Field
 +
| [[Image:Textbox.png]]
 +
|-
 +
| String / Text
 +
| Only for CDFs
 +
| Major Impacts
 +
| Text Area
 +
| [[Image:Textarea.png]]
 +
|-
 +
| Subobject
 +
| No
 +
| Ordnance
 +
| Table
 +
| [[Image:Table.png]]
 +
|-
 +
| Time
 +
| No
 +
| Time to hospital
 +
| Time
 +
| [[Image:Time widget.png]]
 +
|}
  
−
[[Image:UserManual_Elements.png|center|500px|''Elements'']]
+
{{New_6.0 | It is possible to specify in the Data Inventory Manager if the text CDFs should be a Text Field or a Text Area in the template. It is not possible to switch between the two widgets in the Data Entry Form Template Designer. }}
−
<div align="center">
 
−
''Elements''
 
−
</div>
 
  
−
As you add and remove item attributes to the form design pane, the Logical Tree pane is updated.
+
As you add and delete item attributes to the form design pane, the Logical Tree pane is updated.
 +
 
 +
There are other types of elements than item attribute that may be added to the template. These are found in the Tool folder:
 +
* [[Add an Image to the Data Entry Form Template | Icon]] e.g. logotypes
 +
* [[Add a Line to the Data Entry Form Template | Line ]] e.g. as header and footer divider
 +
* [[Add Text to the Data Entry Form Template | Text ]] e.g. template version number
 +
 
 +
{{NavBox HowTo Data Entry Forms}}
 +
 
 +
[[Category:NAA]]

Latest revision as of 20:15, 19 June 2017

After you have specified the page setup for the data entry form template, you can begin adding item attributes/fields. To add attributes to the data entry form in the Data Entry Form Template Designer window:

  1. Expand the item folder that contains the attribute by double-clicking the folder name in the Elements pane.
  2. Expand the data category that contains the item attribute.
  3. Click the name of the attribute you would like to add to the data entry form.
  4. While holding down the left mouse button, drag the attribute to the form design pane.
  5. When the item attribute is in the desired position, release the mouse button.
Note.jpg If you drag an item attribute to the design pane which has previously been added, the following message displays:
At least one of the fields you dragged on to the template already exists in the template. You cannot add the same field more than once to the template.

Click the OK button.

    The element and its label are placed in the form design pane.
Note.jpg You can also add all item attributes in a category to the data entry form by dragging it to the design pane.
  1. Repeat the above steps to add additional item attributes to the data entry form.
Warning.jpg When item attributes are dragged to the design pane, they will use widgets for that data type. All parts of the widget should be present in the template in order to ensure that the widget will work for data entry. Although you can change properties and e.g. the label text. In the geographical widget you may delete the polyline/polygon table.

Depending on which data type the item attribute is and on the settings in the Data Inventory Manager the control / widget is different.

Type in DIM Setting in DIM Example Widget Control / widget
System No Land ID Local ID Generator Local ID Gen.png
Country Structure No Victim Living In Country Structure Cs.png
Date No Status changed date Date Date.png
Geographical information No All items Geo data Geo.png

The difference between the columns X / Lon & Y / Lat and X / Longitude & Y / Latitude is described here.

Multiple Select No Vulnerable group Multiple Select Multiselect.png
Number No Size of Living Space Text Field Number.png
Organisation No Organisation Organisation Org.png
Place No Status changed date Place Place.png
Single Select Yes Land Status Radio button Rb std.png
Single Select Yes Status changed reason Combo box Combobox.png
String / Text Only for CDFs Land Name Text Field Textbox.png
String / Text Only for CDFs Major Impacts Text Area Textarea.png
Subobject No Ordnance Table Table.png
Time No Time to hospital Time Time widget.png
New 6.0.png It is possible to specify in the Data Inventory Manager if the text CDFs should be a Text Field or a Text Area in the template. It is not possible to switch between the two widgets in the Data Entry Form Template Designer.

As you add and delete item attributes to the form design pane, the Logical Tree pane is updated.

There are other types of elements than item attribute that may be added to the template. These are found in the Tool folder:

  • Icon e.g. logotypes
  • Line e.g. as header and footer divider
  • Text e.g. template version number
Design Data Entry Forms
General
Get started
Tools
Elements
Properties
Publish
Published
Retrieved from "http://mwiki.gichd.org:8090/mediawiki/index.php?title=Add_Item_Attributes_to_the_Design_Pane&oldid=23672"