Difference between revisions of "Summary Templates"

From IMSMA Wiki
Jump to: navigation, search
 
(46 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 
__FORCETOC__
 
__FORCETOC__
 
{{TOC right}}
 
{{TOC right}}
 +
[[Image:ViewDesignerAndVictimView.png|center|500px]]
 +
<div align="center">
 +
'' The Victim Summary - as displayed in the both Summary and Summary Designer Windows''
 +
</div>
  
−
==Editing a View==
+
The Summary Designer window lets you modify how an item's data displays in the [[Summary Window]]. The figure to the left shows an example.
−
#In the IMSMA Navigation window, click Customisation and then select View Manager.
 
−
#Select an object from the Object list.
 
−
#Select a view from the Custom View table and click [[Image:FieldViewIcon.png]].
 
−
:The View Designer opens, with an elements pane on the left and a design pane on the right.
 
  
−
==Using the View Designer Buttons==
+
There are two panes in the Summary Designer window. The pane on the left displays a data tree of elements available for the selected item. You can drag elements to and from the data tree to populate your summary. On the right is the design pane, where you can add, delete, and modify elements. Above the design pane is a series of tabs that let you switch between pages.
  
−
===Tabs===
+
When you have finished customising the summary template, you can either save it with a new name or overwrite an existing summary. In both cases the new version will get the status '''draft''' and you need to [[Publish and Archive Summary Templates#Publishing a Summary template | publish]] it before it is visible to the users.
−
{| class="wikitable" width="500" style="margin:10px;"
+
 
 +
The following sections describe how to complete common tasks in the Summary Designer window. For a complete list of the available functions, refer to [[Summary Templates#Summary Designer User Interface Buttons | Summary Designer User Interface Buttons]].
 +
 
 +
==Customising a Summary template==__NOEDITSECTION__
 +
#In the '''Customisation''' menu &rarr; '''Summary Manager'''.
 +
#Select an item from the '''Object''' menu to display its complete list of Summary Templates.
 +
#Select one of the item's existing Summary Templates from the list.
 +
#Click the [[File:FieldViewIcon.png|20px]] button to open the [[Summary Templates | Summary Designer]] window.
 +
 
 +
===Adding Data Elements===__NOEDITSECTION__
 +
''Data Elements'' are the relevant information (gathered during data entry) that display on an item's summary. You can move existing data elements around in the design pane, and resize, relabel, or delete them. You can also add elements by dragging them from the data tree to the design pane. With certain exceptions, only one instance of the same data element can be added to each tab.
 +
 
 +
# Click the tab on which you want to add the data element.
 +
# Drag an element from the data tree to the design pane.
 +
# Double-click the element's graphic or label to edit its properties.
 +
# If you are editing a table, refer to [[Customise Tables]].
 +
 
 +
[[Image:Summary template designer Links.png|500px|center]]
 +
<div align="center">
 +
'' Link table''
 +
</div>
 +
{{Note | In the Summary template designer it is the calculated subobject Links that should be used for the ''Links'' table. It does '''not''' make sense to use ''Linked IDs'' in Summary templates.}}
 +
 +
===Adding Graphic Elements===__NOEDITSECTION__
 +
''Graphic Elements'' make up the visual layout of an item's summary, and are unaffected by data entry. They are the lines that border or separate sections, text boxes where messages can be written, and images (like photographs, maps, and diagrams) that add to the visual aesthetic. All graphic elements are located in the Summary Designer data tree, inside the '''Tool Folder'''.
 +
 
 +
====Lines====__NOEDITSECTION__
 +
# Click the tab on which you want to add the line.
 +
# Drag the '''Line Tool''' from the Tool folder in the data tree to the design pane.
 +
# Double-click the line to edit its width and height.
 +
 
 +
====Text Boxes====__NOEDITSECTION__
 +
# Click the tab on which you want to add the text box.
 +
# Drag the '''Text Tool''' from the Tool folder in the data tree to the design palette.
 +
# Double-click the text box to add the desired text (in place of the default "Text Tool") and edit the font style and size. Note that the text box borders will expand or contract to fit its contents.
 +
 
 +
====Images====__NOEDITSECTION__
 +
# Click the tab on which you want to add the image.
 +
# Drag the '''Icon Tool''' from the Tool folder in the data tree to the design pane.
 +
# Double-click the Icon Tool widget to resize its boundaries and choose an image file to import. Note that the Icon Tool borders will expand or contract to fit the imported file.
 +
 
 +
===Saving a Summary template===__NOEDITSECTION__
 +
When you have finished customising your Summary Template and saved it, remember to [[Publish and Archive Summary Templates#Publishing a Summary template| publish]] the Summary Template if you want to activate it in IMSMA. Note that you can save separate Summary Templates with the same name in the Summary Manager.
 +
 
 +
===Summary Designer User Interface Buttons===__NOEDITSECTION__
 +
The following table lists all of the GUI buttons available in the Summary Designer window and their purposes:
 +
 
 +
{| class="wikitable"
 +
|+ Summary Designer Interface
 +
! Desired Elements
 +
! Steps to Achieve
 
|-
 
|-
−
| width="250pt" | '''How To'''
+
| Tabs
−
| width="250pt" | '''Step to Complete'''
+
|
 
|-
 
|-
−
| Move a tab to the left or right of other tabs || Click a tab, and then click [[Image:leftRedArrow2.png]] or [[Image:rightRedArrow.png]].
+
| style="padding-left: 2em" | Move a tab to the left or right of other tabs
 +
| Click a tab, and then click the [[Image:ViewDesignerTabLeft.png | Move Tab Left]] or [[Image:ViewDesignerTabRight.png | Move Tab Right]] buttons.
 
|-
 
|-
−
| Add a new tab || Click [[Image:newTab.png]], and then select New Tab to rename it.
+
| style="padding-left: 2em" | Add a new tab
 +
| Click the [[Image:ViewDesignerNewTab.png | New Tab "*"]] and then double-click the ''New Tab'' label to rename it.
 
|-
 
|-
−
| Delete a selected tab || Click the '''x''' by the tab name: [[Image:deleteTab.png]].
+
| style="padding-left: 2em" | Delete a selected tab
 +
| Click the '''x''' by the tab name ([[Image:ViewDesignerDeleteTab.png]]).
 
|-
 
|-
−
| Set page layout and size || Click '''Tab Setup'''.
+
| style="padding-left: 2em" | Set page layout and size
 +
| Click '''Tab Setup'''.
 
|-
 
|-
−
| Location || Click '''Clear Tab'''.
+
| style="padding-left: 2em" | Clear all elements from a selected tab
 +
| Click '''Clear Tab'''.
 
|-
 
|-
−
| Clear all elements from all tabs. || Click '''Clear All Tabs'''.
+
| Elements
−
|}
+
|
−
 
+
|-
−
===Elements===
+
| style="padding-left: 2em" | Delete selected elements from a selected tab
−
{| class="wikitable" width="500" style="margin:10px;"
+
| Click '''Clear'''.
 
|-
 
|-
−
| width="250pt" | '''How To'''
+
| style="padding-left: 2em" | Align selected elements
−
| width="250pt" | '''Step to Complete'''
+
| Click '''Align'''.
 
|-
 
|-
−
| Delete selected elements from the design pane || Click '''Clear'''.
+
| style="padding-left: 2em" | Modify the properties of a selected element
 +
| Click '''Properties'''.
 
|-
 
|-
−
| Align selected elements || Click '''Align'''.
+
| style="padding-left: 2em" | Clear all elements from all tabs
 +
| Click '''Clear All Tabs'''.
 
|-
 
|-
−
| Modify the properties of a selected element || Click '''Properties'''.
+
| General
−
|}
+
|
−
 
 
−
===General===
 
−
{| class="wikitable" width="500" style="margin:10px;"
 
 
|-
 
|-
−
| width="250pt" | '''How To'''
+
| style="padding-left: 2em" | Undo or redo previous actions
−
| width="250pt" | '''Step to Complete'''
+
| Click the [[Image:Undo.jpg | Undo]] or [[Image:Redo.jpg | Redo]] buttons.
 
|-
 
|-
−
| Undo or redo previous actions || Click [[Image:undoBtn.png]] or [[Image:redoBtn.png]].
+
| style="padding-left: 2em" | Save your changes to the summary
 +
| Click '''Save'''.
 
|-
 
|-
−
| Save your changes to the view  || Click '''Save'''.
+
| style="padding-left: 2em" | Save your summary as new
 +
| Click '''Save As'''.
 
|-
 
|-
−
| Save your view as new || Click '''Save As'''.
+
| style="padding-left: 2em" | Print and preview a summary
 +
| Click '''Preview'''.
 
|-
 
|-
−
| Preview and print a view || Click '''Preview'''.
+
| style="padding-left: 2em" | Exit the Summary Designer
 +
| Click '''Close'''.
 
|-
 
|-
−
| Exit the View Designer || Click '''Close'''.
 
−
|}
 
−
 
−
==Adding Data Elements==
 
−
#Drag a data element from the elements pane into the design pane.
 
−
#Double-click the data element or label to edit its properties.
 
−
 
−
{| style="border:2px solid lightgray; float:center; margin:10px;"
 
−
|align="left" style="padding: 5px 10px 5px 10px"|[[Image:bulb2.png|25px|Represents a tip or note for using IMSMA Mobile.]]
 
−
|align="left" style="padding: 5px 10px 5px 10px"| Editing a '''table''':
 
−
*Double-click the left border of a table to edit its size and to pick column headers
 
−
*Double-click a column header to edit it
 
−
*Drag the boundaries of a column to change its width
 
−
|}
 
−
 
−
==Adding Graphic Elements==
 
−
===Adding Lines===
 
−
#Drag the '''Line Tool''' from the Tool folder to the design pane.
 
−
#Double-click the line to edit its shape and properties.
 
−
 
−
===Adding Text Boxes===
 
−
#Drag the '''Text Tool''' from the Tool folder to the design pane.
 
−
#Double-click the text box to edit its contents and properties.
 
−
 
−
{| style="border:2px solid lightgray; float:center; margin:10px;"
 
−
|align="left" style="padding: 5px 10px 5px 10px"|[[Image:bulb2.png|25px|Represents a tip or note for using IMSMA Mobile.]]
 
−
|align="left" style="padding: 5px 10px 5px 10px"| The size and shape of the text box is set automatically as text is entered or deleted.
 
 
|}
 
|}
  
−
===Adding Images===
+
{{NavBox HowTo Current Views}}
−
#Drag the '''Icon Tool''' from the Tool folder to the design pane.
 
−
#Double-click the icon to resize its boundaries and to choose an image to import.
 
−
 
 
−
{| style="border:2px solid lightgray; float:center; margin:10px;"
 
−
|align="left" style="padding: 5px 10px 5px 10px"|[[Image:bulb2.png|25px|Represents a tip or note for using IMSMA Mobile.]]
 
−
|align="left" style="padding: 5px 10px 5px 10px"| Set the size and shape of the actual image before importing the file into IMSMA<sup>NG</sup>.
 
−
 
 
−
T'''he icon element boundaries automatically resize to fit the imported image.
 
−
|}
 
  
−
==Publishing a Custom View==
+
[[Category:NAA]]
−
#In the IMSMA Navigation window, click '''Customisation''' and then select '''View Manager'''.
 
−
#Select a view from the Custom View table and '''click''' [[Image:customView.png]].
 
−
#:The view status changes to '''published''', and the status of the previously published view changes to '''archived'''.
 
−
#Click '''Done'''.
 
−
#Open the same type of object in the items pane on the IMSMA Navigation window.
 
−
#:Object data now display in the newly published view.
 
−
 
 
−
{| style="border:2px solid lightgray; float:center; margin:10px;"
 
−
|align="left" style="padding: 5px 10px 5px 10px"|[[Image:bulb2.png|25px|Represents a tip or note for using IMSMA Mobile.]]
 
−
|align="left" style="padding: 5px 10px 5px 10px"| A view with a '''status''' of:
 
−
*'''published''' is the active view for the selected object
 
−
*'''draft''' has not yet been published
 
−
*'''archived''' has been unpublished
 
−
 
 
−
Draft or archived views can be deleted if they are no longer needed. To '''delete''', select the view and '''Click''' [[Image:EcksButton.png]].
 
−
|}
 

Latest revision as of 16:47, 19 June 2017

ViewDesignerAndVictimView.png

The Victim Summary - as displayed in the both Summary and Summary Designer Windows

The Summary Designer window lets you modify how an item's data displays in the Summary Window. The figure to the left shows an example.

There are two panes in the Summary Designer window. The pane on the left displays a data tree of elements available for the selected item. You can drag elements to and from the data tree to populate your summary. On the right is the design pane, where you can add, delete, and modify elements. Above the design pane is a series of tabs that let you switch between pages.

When you have finished customising the summary template, you can either save it with a new name or overwrite an existing summary. In both cases the new version will get the status draft and you need to publish it before it is visible to the users.

The following sections describe how to complete common tasks in the Summary Designer window. For a complete list of the available functions, refer to Summary Designer User Interface Buttons.

Customising a Summary template

  1. In the Customisation menu → Summary Manager.
  2. Select an item from the Object menu to display its complete list of Summary Templates.
  3. Select one of the item's existing Summary Templates from the list.
  4. Click the FieldViewIcon.png button to open the Summary Designer window.

Adding Data Elements

Data Elements are the relevant information (gathered during data entry) that display on an item's summary. You can move existing data elements around in the design pane, and resize, relabel, or delete them. You can also add elements by dragging them from the data tree to the design pane. With certain exceptions, only one instance of the same data element can be added to each tab.

  1. Click the tab on which you want to add the data element.
  2. Drag an element from the data tree to the design pane.
  3. Double-click the element's graphic or label to edit its properties.
  4. If you are editing a table, refer to Customise Tables.
Summary template designer Links.png

Link table

Note.jpg In the Summary template designer it is the calculated subobject Links that should be used for the Links table. It does not make sense to use Linked IDs in Summary templates.

Adding Graphic Elements

Graphic Elements make up the visual layout of an item's summary, and are unaffected by data entry. They are the lines that border or separate sections, text boxes where messages can be written, and images (like photographs, maps, and diagrams) that add to the visual aesthetic. All graphic elements are located in the Summary Designer data tree, inside the Tool Folder.

Lines

  1. Click the tab on which you want to add the line.
  2. Drag the Line Tool from the Tool folder in the data tree to the design pane.
  3. Double-click the line to edit its width and height.

Text Boxes

  1. Click the tab on which you want to add the text box.
  2. Drag the Text Tool from the Tool folder in the data tree to the design palette.
  3. Double-click the text box to add the desired text (in place of the default "Text Tool") and edit the font style and size. Note that the text box borders will expand or contract to fit its contents.

Images

  1. Click the tab on which you want to add the image.
  2. Drag the Icon Tool from the Tool folder in the data tree to the design pane.
  3. Double-click the Icon Tool widget to resize its boundaries and choose an image file to import. Note that the Icon Tool borders will expand or contract to fit the imported file.

Saving a Summary template

When you have finished customising your Summary Template and saved it, remember to publish the Summary Template if you want to activate it in IMSMA. Note that you can save separate Summary Templates with the same name in the Summary Manager.

Summary Designer User Interface Buttons

The following table lists all of the GUI buttons available in the Summary Designer window and their purposes:

Summary Designer Interface
Desired Elements Steps to Achieve
Tabs
Move a tab to the left or right of other tabs Click a tab, and then click the Move Tab Left or Move Tab Right buttons.
Add a new tab Click the New Tab "*" and then double-click the New Tab label to rename it.
Delete a selected tab Click the x by the tab name (ViewDesignerDeleteTab.png).
Set page layout and size Click Tab Setup.
Clear all elements from a selected tab Click Clear Tab.
Elements
Delete selected elements from a selected tab Click Clear.
Align selected elements Click Align.
Modify the properties of a selected element Click Properties.
Clear all elements from all tabs Click Clear All Tabs.
General
Undo or redo previous actions Click the Undo or Redo buttons.
Save your changes to the summary Click Save.
Save your summary as new Click Save As.
Print and preview a summary Click Preview.
Exit the Summary Designer Click Close.
Designing Summary Templates
Retrieved from "http://mwiki.gichd.org:8090/mediawiki/index.php?title=Summary_Templates&oldid=23668"