Difference between revisions of "Observations module"

From InfoEx Help Information
Jump to navigation Jump to search
m
 
(48 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
__NOTOC__
 
__NOTOC__
{{Requirements|UserLevel=Operation administrator and higher|Connectivity=Online and partial offline}}
+
{{Requirements|UserLevel=Submission moderator and higher|Connectivity=Online and partially offline}}
  
This document describes the purpose of an 'observations' step in a workflow, and how to set one up.
+
This page describes the functionality of the 'observations' workflow module and how to properly configure if for a workflow.
==Background==
 
An 'observations' step provides an opportunity to enter a custom set of observations during the course of the workflow. The observations are submitted to the infoEx server to be shared with subscribers.
 
  
==Details of: The '''observations''' step and the information required to set one up==
+
'''Required permissions:'''
 +
* You need to be a Operation administrator to create a [[Definitions#WorkflowTemplate|workflow template]].
 +
* You need to be a Submission moderator to initiate a [[Definitions#WorkflowInstance|workflow instance]].
  
{|class="TblSteps"
+
'''Required connectivity:'''
|-
+
* You need to be online to create a new  or edit an existing [[Definitions#WorkflowTemplate|workflow template]].
|class="StepNum" | observations:  
+
* You need to be online to initiate a [[Definitions#WorkflowInstance|workflow instance]] to download any observations that have been entered and shared by your team. Once the workflow instance has been loaded, you can complete the workflow in an offline mode.
| [[File:ObservationPopup.png|300px|thumb|right|Fig. 4: Workflow 'observations' settings]] An 'observation' step allows you to fill out a customized observation as part of the workflow. The following information is required to set it up:
+
* You can initiate a [[Definitions#WorkflowInstance|workflow instance]] when you are offline.
*A box is provided so you can set the name of the observations step.
+
* If you submit whilst offline the workflow will be uploaded to the InfoEx server the next time you are online. WARNING: If the internet connection is lost whilst this is being done, the workflow will not be submitted and you will lose the data.
*A list of 'observation types to include' is provided. Select the desired combination of options for the observations you want to make as part of the workflow.
 
*Select the 'time constraint on observations to include'. You can submit all unsubmitted observations for the operation, or limit submission to today's observations only.
 
{{Note|You may wish to limit submissions to today's date if there is a possibility that a saved workflow has stale data from a previous day | NoteWithImage}}
 
  
 +
==Functionality==
 +
[[File:ObsModuleOnlyWxObs.png|300px|thumb|right|Fig. 1: Observation workflow module with only weather observations (one observation entered)]] [[File:ObsModuleAllObs.png|300px|thumb|right|Fig. 2: Observation workflow module with all observations included (no observations entered)]] Including the observations module in a workflow template allows you to enter new observations and review observations that have been entered and shared by your team prior to starting the workflow. Click [[Difference between observations and assessments#Observation|here]] to see a full list of supported observation types.
  
|}
+
{{Note|Only observations that have been entered and shared prior to the workflow being started will be pulled into the workflow for review. However a {{ButtonBlue|Refresh}} button in the top left corner of this form allows you to retrieve any observations that have been shared within your operation since you started the workflow.|NoteWithImage}}
 +
 
 +
All of the reviewed or newly entered observations are submitted at the end of the workflow.
 +
 
 +
There are no restrictions on the number of Observation module steps that can be added to a workflow template.
 +
 
 +
Any workflow template with a observation module step will automatically have a [[Workflow summary]] step added at the end of the workflow. This summary allows users to review their observations and assessments before they are submitted.
 +
 
 +
Observations submitted via an observation step in a workflow are associated with the location specified in the entry form of the individual observation.
 +
 
 +
It is possible to enter observations in the observation workflow module without internet connectivity.
 +
 
 +
==Layout==
 +
The observations workflow step has the same functionality and layout as the observation overview tables of the 'Enter & Submit' screen ([[Entering and submitting observations (single computer)|single computer setup]]) or the 'Review & Submit' screen ([[Entering and submitting observations (multiple computers)#Reviewing observation that have been shared by your team (Submission moderator or higher)#Entering observations (all user levels)|multiple computer setup]]) under the OBSERVATION menu.
 +
 
 +
Examples of possible layouts include:
 +
* Observation workflow step with only weather observations (Fig. 1).
 +
* Observation workflow step with all observation types included (Fig. 2).
 +
 
 +
==Settings==
 +
[[File:ObservationPopup.png|300px|thumb|right|Fig. 3: Observations workflow module settings]] The observations workflow module has the following settings (Fig. 3):
 +
 
 +
* '''Name'''<br/>Name of the workflow step shown in the header of the workflow. It is recommended that you choose a short name (e.g., 'Ldg Wx' instead of 'Lodge Weather') to keep the navigation bar of the workflow as tidy as possible.
 +
 
 +
* '''Observation Types to Include'''<br/>Checkboxes that allow you to choose which observation types you would like to include in your observation entry screen. In a morning meeting workflow, for example, you would likely only want weather observations to be included. In an evening meeting you would want to have all observation types included.
 +
 
 +
* '''Time constaint on Observations to Include'''<br/>When a workflow is started, all of the previously entered and shared observations that are associated with locations that fall under the hierarchy of the location that has been associated with the workflow will be downloaded to be reviewed during the workflow. This setting allows you to specify whether you want all unsubmitted observations to be downloaded or only observation of the current day.
 +
 
 +
==<span style="color: #CC0000;">Information shared within the InfoEx</span>==
 +
All of the information entered in this workflow module is shared within the InfoEx in the following manner:
 +
* The full records of all supported observation types are shared in InfoEx reports.
 +
* Each of the observation types have their own table in InfoEx reports.
 +
* The observations are shown under the locations entered in the individual observation entry forms.
 +
* All of the observations submitted are shown in InfoEx reports regardless whether they had been entered via a workflow or directly through the OBSERVATIONS menu.
 +
 
 +
==Other workflow modules==
 +
{{ListWorkflowModules|}}
  
 
==Functionality tested by==
 
==Functionality tested by==
* Date: Nov. 15, 2013 / John Kelly / QA Server / Version 3.0.0
+
* Dec. 24, 2013: Pascal Haegeli
  
[[Category:Workflows]]
+
[[Category:Super User]][[Category:Operation Administrator]][[Category:Submission Moderator]][[Category:Offline]][[Category:Observations]][[Category:Workflows]][[Category:Version 3.4.0]]

Latest revision as of 11:52, 9 November 2017

REQUIREMENTS
Permission Submission moderator and higher
Connectivity Online and partially offline

This page describes the functionality of the 'observations' workflow module and how to properly configure if for a workflow.

Required permissions:

Required connectivity:

  • You need to be online to create a new or edit an existing workflow template.
  • You need to be online to initiate a workflow instance to download any observations that have been entered and shared by your team. Once the workflow instance has been loaded, you can complete the workflow in an offline mode.
  • You can initiate a workflow instance when you are offline.
  • If you submit whilst offline the workflow will be uploaded to the InfoEx server the next time you are online. WARNING: If the internet connection is lost whilst this is being done, the workflow will not be submitted and you will lose the data.

Functionality

Fig. 1: Observation workflow module with only weather observations (one observation entered)
Fig. 2: Observation workflow module with all observations included (no observations entered)

Including the observations module in a workflow template allows you to enter new observations and review observations that have been entered and shared by your team prior to starting the workflow. Click here to see a full list of supported observation types.

NOTE Only observations that have been entered and shared prior to the workflow being started will be pulled into the workflow for review. However a Refresh button in the top left corner of this form allows you to retrieve any observations that have been shared within your operation since you started the workflow.

All of the reviewed or newly entered observations are submitted at the end of the workflow.

There are no restrictions on the number of Observation module steps that can be added to a workflow template.

Any workflow template with a observation module step will automatically have a Workflow summary step added at the end of the workflow. This summary allows users to review their observations and assessments before they are submitted.

Observations submitted via an observation step in a workflow are associated with the location specified in the entry form of the individual observation.

It is possible to enter observations in the observation workflow module without internet connectivity.

Layout

The observations workflow step has the same functionality and layout as the observation overview tables of the 'Enter & Submit' screen (single computer setup) or the 'Review & Submit' screen (multiple computer setup) under the OBSERVATION menu.

Examples of possible layouts include:

  • Observation workflow step with only weather observations (Fig. 1).
  • Observation workflow step with all observation types included (Fig. 2).

Settings

Fig. 3: Observations workflow module settings

The observations workflow module has the following settings (Fig. 3):

  • Name
    Name of the workflow step shown in the header of the workflow. It is recommended that you choose a short name (e.g., 'Ldg Wx' instead of 'Lodge Weather') to keep the navigation bar of the workflow as tidy as possible.
  • Observation Types to Include
    Checkboxes that allow you to choose which observation types you would like to include in your observation entry screen. In a morning meeting workflow, for example, you would likely only want weather observations to be included. In an evening meeting you would want to have all observation types included.
  • Time constaint on Observations to Include
    When a workflow is started, all of the previously entered and shared observations that are associated with locations that fall under the hierarchy of the location that has been associated with the workflow will be downloaded to be reviewed during the workflow. This setting allows you to specify whether you want all unsubmitted observations to be downloaded or only observation of the current day.

Information shared within the InfoEx

All of the information entered in this workflow module is shared within the InfoEx in the following manner:

  • The full records of all supported observation types are shared in InfoEx reports.
  • Each of the observation types have their own table in InfoEx reports.
  • The observations are shown under the locations entered in the individual observation entry forms.
  • All of the observations submitted are shown in InfoEx reports regardless whether they had been entered via a workflow or directly through the OBSERVATIONS menu.

Other workflow modules

Functionality tested by

  • Dec. 24, 2013: Pascal Haegeli