Difference between revisions of "Executing a workflow instance"

From InfoEx Help Information
Jump to navigation Jump to search
(Saving the results of a workflow and sharing them with the InfoEx community)
 
(23 intermediate revisions by 2 users not shown)
Line 2: Line 2:
 
{{Requirements|UserLevel=Submission Moderator and higher|Connectivity=Online and offline}}
 
{{Requirements|UserLevel=Submission Moderator and higher|Connectivity=Online and offline}}
  
This document describes how to execute a [[Definitions#WorkflowInstance|workflow instance]] from an existing [[Definitions#WorkflowTemplate|workflow template]] during regular operations.
+
This document describes how to execute a [[Definitions#WorkflowInstance|workflow instance]] from an existing [[Definitions#WorkflowTemplate|workflow template]].
  
 
==Background==
 
==Background==
Line 10: Line 10:
  
 
Executing a workflow instance involves three main steps:
 
Executing a workflow instance involves three main steps:
# Starting the desired workflow
+
# [[#Starting the desired workflow|Starting the desired workflow]]
# Completing the steps included in the workflow
+
# [[#Starting the desired workflow|Completing the steps included in the workflow]]
# Saving and sharing the results of a workflow with the InfoEx community
+
# [[#Saving the results of a workflow and sharing them with the InfoEx community|Saving the results of a workflow and sharing them with the InfoEx community]]
  
 
==Step-by-step description==
 
==Step-by-step description==
  
===Step 1: Starting the desired workflow===
+
===Starting the desired workflow===
  
 
{|class="TblSteps"
 
{|class="TblSteps"
 
|-
 
|-
 
|class="StepNum" | 1.
 
|class="StepNum" | 1.
|[[File:WorkflowMenuStartNew.png|300px|thumb|right|Fig. 1: Workflow menu for starting a new workflow instance.]]From the 'Workflows' menu select the workflow you want to execute and click on 'start new'. You need to be a Submission Moderator to have access to this menu item. The system will now load the necessary information for executing the chosen workflow.
+
|[[File:WorkflowMenuStartNew.png|300px|thumb|right|Fig. 1: Workflow menu for starting a new workflow instance.]]From the WORKFLOWS menu select the workflow you want to execute and click on 'start new'. You need to be a Submission Moderator to have access to this menu item. The system will now load the necessary information for executing the chosen workflow.
{{Note|It is desirable to have a live internet connection when you initiate a workflow. This allows the system to pre-populate the fields of the [[Snowpack module]], [[Hazard assessment module]] and [[Hazard comment module]] with the information from the last time a workflow was submitted for the location(s) associated with the chosen workflow.|NoteWithImage}}
+
{{Note|It is desirable to have a live internet connection when you initiate a workflow. This allows the system to pre-populate the fields of the [[Snowpack module]], [[Hazard assessment module]], [[Run list module]] and [[Hazard comment module]] with the information from the last time a workflow was submitted for the location(s) associated with the chosen workflow.|NoteWithImage}}
{{Note|It is possible to initiate a workflow instance completely offline, but it will be completely empty and you will have to start your assessments completely from scratch.|NoteWithImage}}
+
{{Note|You can initiate a workflow when you are offline, and the fields will be filled with the latest cached information on the computer. This will be up to date unless workflows have been submitted using other computers since you were last online on the computer you are currently using. However PWLs cannot be created (but can be updated) whilst offline and the run list extension does not work offline.|NoteWithImage}}
 
|-
 
|-
 
|class="StepNum" | 2.
 
|class="StepNum" | 2.
|[[File:WorkflowProgressSteps.png|300px|thumb|right|Fig. 2: Workflow progress]]After aftert the necessary information has been loaded, the workflow will begin with the first step. The list of workflow steps is presented at the top of the workflow screen below the workflow title.
+
|[[File:WorkflowProgressSteps.png|300px|thumb|right|Fig. 2: Workflow progress]]After the necessary information has been loaded, the workflow will begin with the first step. The list of workflow steps is presented at the top of the workflow screen below the workflow title.
 +
|}
 +
 
 +
===Completing the steps included in the workflow===
 +
{{Note|Once a workflow has been started, you do not need to be online for completing the data entry steps. However, you need to be online to view any external webpages or InfoEx reports that are part of your workflow.}}
  
+
{|class="TblSteps"
 +
|-
 +
|class="StepNum" | 1.
 +
|Complete the first step of the workflow as described in the relevant workflow module help document. See [[Documentation_overview#Workflow_modules|Workflow modules]] for more information on the functionality of individual workflow modules.
 
|-
 
|-
|class="StepNum" | 5.  
+
|class="StepNum" | 2.
|[[File:WorkflowProgressControls.png|300px|thumb|right|Fig. 2 Workflow progress controls]]To move between steps use the controls at the top right of the workflow area (see Figure 2).
+
|[[File:WorkflowProgressControls.png|300px|thumb|right|Fig. 3: Workflow controls]] To move between steps use forward and backwards arrows in the workflow controls at the top right of the workflow area (Fig. 3). If you have specified that the steps of this workflow template can be completed in any order (see [[Creating a workflow template]] for more details), you can also navigate among the steps by clicking on the step labels at the top of the workflow screen below the workflow title.
{{Note|Only the advance arrow will be enabled if the workflow design specified 'steps need to be completed in order' (see [[Creating a workflow template]]).|NoteWithImage}}
+
{{Note|Once a workflow step has been completed, the workflow step label will be turned into a hyperlink and you can always directly go back to this step by clicking on its label.|NoteWithImage}}
 
|-
 
|-
|class="StepNum" | 6.  
+
|class="StepNum" | 3.  
|At any time you can select {{ButtonBlue|Discard & Exit}} from the workflow controls (see Figure 2) this will delete all trace of the workflow execution and no information will be submitted to the infoEx server.
+
|At any time during your workflow, you can click on the {{ButtonBlue|Discard & Exit}} button from the workflow controls (Fig. 3) to exit the workflow and delete all of the information that has been entered.  
 
|-
 
|-
 
|class="StepNum" | 7.
 
|class="StepNum" | 7.
|At any time you can select {{ButtonBlue|Save & Exit}} from the workflow controls (see Figure 2) this will save a local copy of the workflow execution to date as well as share the saved information between all enabled local computers within an operation. However, no information will be shared with the infoEx server.
+
|[[File:WorkflowMenuStartResume.png|300px|thumb|right|Fig. 4: Workflow menu for continuing an existing workflow instance.]]If you want to exit the workflow, but save the information that has been entered into the workflow for future use (e.g., a lead guide prepares the workflow for an upcoming guides meeting), click on the {{ButtonBlue|Save & Exit}} button from the workflow controls (Fig. 3). This will save a copy of the workflow execution to your local computer for future use and redirect you to the report section.
 +
{{Note|The information of a partially completed workflow is only stored on the computer where the workflow was started. This information is ''not'' stored on the InfoEx server or shared among the computers of the same operation.|NoteWithImage}}
 +
To continue this particular workflow, click on the WORKFLOWS menu, select the particular workflow template and click on 'resume' (Fig. 4).
 +
|}
 +
 
 +
===Saving the results of a workflow and sharing them with the InfoEx community===
 +
[[File:WorkflowProgressControlsSubmit.png|300px|thumb|right|Fig. 5: Workflow controls with submit button enabled.]] Any workflow that includes workflow modules with data submission (click [[Documentation_overview#Workflow_modules|here]] for list of workflow modules with data entry), automatically has a [[Workflow summary|summary step]] included at the end of the workflow. Once you get to the summary step at the end of your workflow, the {{ButtonDarkBlue|Submit}} button will become enabled.
 +
 
 +
{|class="TblSteps"
 +
|-
 +
|class="StepNum" | 1.
 +
|On the workflow summary page, click on the {{ButtonDarkBlue|Submit}} button to save all of the associated observations and assessments and share the appropriate elements within the InfoEx community. See the documentation for the individual workflow modules for more information on what is shared.
 +
{{Note|Please note that it is not possible to permanently save a workflow without sharing its content with the InfoEx community.}}
 +
|-
 +
|class="StepNum" | 2.
 +
|Confirm that you want to submit the information in the confirmation dialog.
 +
{{Note|Note that once a workflow and the associated observations are submitted, you will not be able to edit them anymore.}}
 +
|-
 +
|class="StepNum" | 3.
 +
|Once you confirmed the submission, you will receive a series of system messages informing you about the upload status and the workflow navigation buttons will become disabled.
 +
{{Note|See [[Viewing previously completed workflows]] for how to access completed workflows.}}
 
|-
 
|-
|class="StepNum" | 8.  
+
|class="StepNum" | 4.  
|When the {{ButtonGreyWhite|Submit}} button activates by turning blue {{ButtonBlue|Submit}} you may submit all entered information to the infoEx Server
+
|You can then generate or email (to the email list designated in the workflow definition) a pdf view of the workflow summary. Any single step can also be generated or emailed as a pdf.
{{Note|Once information is submitted to the infoEx server it will be deleted from all local computers. You may review previously submitted workflows. See: [[Viewing previously completed workflows]]}}.
 
 
|}
 
|}
  
 
==Related documents==
 
==Related documents==
 +
* [[Workflow overview]]
 +
* [[Executing a workflow instance]]
 
* [[Viewing previously completed workflows]]
 
* [[Viewing previously completed workflows]]
* [[Workflow overview]]
+
 
  
 
==Functionality tested by==
 
==Functionality tested by==
*Nov. 17, 2013: John Kelly / Training / Version 3.1.0
+
*Dec. 31, 2013: Pascal Haegeli
[[Category:Help Files]]
+
[[Category:Super User]][[Category:Operation Administrator]][[Category:Submission Moderator]][[Category: Offline]][[Category:Workflows]][[Category:Version 3.4.0]]
[[Category:Super User]][[Category:Operation Administrator]][[Category:Submission Moderator]][[Category:User]]
 
[[Category: Offline]]
 
[[Category:Workflows]][[Category:Version 3.1.0]]
 

Latest revision as of 14:49, 27 May 2019

REQUIREMENTS
Permission Submission Moderator and higher
Connectivity Online and offline

This document describes how to execute a workflow instance from an existing workflow template.

Background

A workflow links together user-specified tasks into a logical order so that users can repeatedly move through the same steps. See the following documents for more background information on workflows:

Executing a workflow instance involves three main steps:

  1. Starting the desired workflow
  2. Completing the steps included in the workflow
  3. Saving the results of a workflow and sharing them with the InfoEx community

Step-by-step description

Starting the desired workflow

1.
Fig. 1: Workflow menu for starting a new workflow instance.
From the WORKFLOWS menu select the workflow you want to execute and click on 'start new'. You need to be a Submission Moderator to have access to this menu item. The system will now load the necessary information for executing the chosen workflow.
NOTE It is desirable to have a live internet connection when you initiate a workflow. This allows the system to pre-populate the fields of the Snowpack module, Hazard assessment module, Run list module and Hazard comment module with the information from the last time a workflow was submitted for the location(s) associated with the chosen workflow.
NOTE You can initiate a workflow when you are offline, and the fields will be filled with the latest cached information on the computer. This will be up to date unless workflows have been submitted using other computers since you were last online on the computer you are currently using. However PWLs cannot be created (but can be updated) whilst offline and the run list extension does not work offline.
2.
Fig. 2: Workflow progress
After the necessary information has been loaded, the workflow will begin with the first step. The list of workflow steps is presented at the top of the workflow screen below the workflow title.

Completing the steps included in the workflow

NOTE Once a workflow has been started, you do not need to be online for completing the data entry steps. However, you need to be online to view any external webpages or InfoEx reports that are part of your workflow.
1. Complete the first step of the workflow as described in the relevant workflow module help document. See Workflow modules for more information on the functionality of individual workflow modules.
2.
Fig. 3: Workflow controls
To move between steps use forward and backwards arrows in the workflow controls at the top right of the workflow area (Fig. 3). If you have specified that the steps of this workflow template can be completed in any order (see Creating a workflow template for more details), you can also navigate among the steps by clicking on the step labels at the top of the workflow screen below the workflow title.
NOTE Once a workflow step has been completed, the workflow step label will be turned into a hyperlink and you can always directly go back to this step by clicking on its label.
3. At any time during your workflow, you can click on the Discard & Exit button from the workflow controls (Fig. 3) to exit the workflow and delete all of the information that has been entered.
7.
Fig. 4: Workflow menu for continuing an existing workflow instance.
If you want to exit the workflow, but save the information that has been entered into the workflow for future use (e.g., a lead guide prepares the workflow for an upcoming guides meeting), click on the Save & Exit button from the workflow controls (Fig. 3). This will save a copy of the workflow execution to your local computer for future use and redirect you to the report section.
NOTE The information of a partially completed workflow is only stored on the computer where the workflow was started. This information is not stored on the InfoEx server or shared among the computers of the same operation.

To continue this particular workflow, click on the WORKFLOWS menu, select the particular workflow template and click on 'resume' (Fig. 4).

Saving the results of a workflow and sharing them with the InfoEx community

Fig. 5: Workflow controls with submit button enabled.

Any workflow that includes workflow modules with data submission (click here for list of workflow modules with data entry), automatically has a summary step included at the end of the workflow. Once you get to the summary step at the end of your workflow, the Submit button will become enabled.

1. On the workflow summary page, click on the Submit button to save all of the associated observations and assessments and share the appropriate elements within the InfoEx community. See the documentation for the individual workflow modules for more information on what is shared.
NOTE Please note that it is not possible to permanently save a workflow without sharing its content with the InfoEx community.
2. Confirm that you want to submit the information in the confirmation dialog.
NOTE Note that once a workflow and the associated observations are submitted, you will not be able to edit them anymore.
3. Once you confirmed the submission, you will receive a series of system messages informing you about the upload status and the workflow navigation buttons will become disabled.
NOTE See Viewing previously completed workflows for how to access completed workflows.
4. You can then generate or email (to the email list designated in the workflow definition) a pdf view of the workflow summary. Any single step can also be generated or emailed as a pdf.

Related documents


Functionality tested by

  • Dec. 31, 2013: Pascal Haegeli