This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
bw2:building_a_workflow [2021/02/07 20:13] akoehler [Build a New Workflow] |
bw2:building_a_workflow [2024/01/05 10:28] (current) wgates [Workflow Design] |
||
|---|---|---|---|
| Line 5: | Line 5: | ||
| {{ : | {{ : | ||
| + | |||
| + | ====== Related Pages====== | ||
| + | |||
| + | The following pages contain additional information about the specific components used to construct Bizweaver workflows. | ||
| + | |||
| + | * **[[bw2: | ||
| + | * **[[bw2: | ||
| + | * **[[bw2: | ||
| + | * **[[bw2: | ||
| + | * **[[bw2: | ||
| + | * **[[bw2: | ||
| + | * **[[bw2: | ||
| + | * **[[bw2: | ||
| + | * **[[bw2: | ||
| + | * **[[bw2: | ||
| + | * **[[bw2: | ||
| + | * **[[bw2: | ||
| + | * **[[bw2: | ||
| + | * **[[bw2: | ||
| + | |||
| ===== General Workflow Rules ===== | ===== General Workflow Rules ===== | ||
| + | * Each workflow should have a unique name. | ||
| + | * The application will assign a default name, " | ||
| * Each workflow step must have a unique name. | * Each workflow step must have a unique name. | ||
| - | * The application will assign a default name " | ||
| ===== Basic Information ===== | ===== Basic Information ===== | ||
| + | ====2.6==== | ||
| {{ : | {{ : | ||
| * See the General Workflow Rules above. | * See the General Workflow Rules above. | ||
| - | * It is not necessary to have the workflow-enabled initially. The workflow can be executed in test mode during the development process. However, it will need to be enabled to use the “Run | + | * It is not necessary to have the workflow-enabled initially. The workflow can be executed in test mode during the development process. However, it will need to be enabled to use the “Run” or scheduled options. |
| * Enter any Notes about the workflow. This information can be updated at any time. | * Enter any Notes about the workflow. This information can be updated at any time. | ||
| - | * Click the “Save” button {{ : | + | * Click the “Save” button {{: |
| - | ===== Build a New Workflow ===== | + | ====2.7==== |
| + | {{ : | ||
| + | |||
| + | ====2.9==== | ||
| + | |||
| + | {{ : | ||
| + | |||
| + | * See the General Workflow Rules above. | ||
| + | * It is not necessary to have the workflow-enabled initially. The workflow can be executed in test mode during the. development process. However, it will need to be enabled to use the “Run” or scheduled options. | ||
| + | * Enter any Notes about the workflow by clicking {{: | ||
| + | * {{ : | ||
| + | * 1. **Workflow Name:** The name of the workflow, can be modified on the ribbon or in this window. | ||
| + | * 2. **Notes:** Workflow notes. | ||
| + | * 3. **Folder:** The folder a workflow is saved in, double click on the folder to select it. | ||
| + | * 4. **+ Folder:** Creates a new folder | ||
| + | * Click the “Save” button {{: | ||
| + | |||
| + | ===== Build a New Workflow ===== | ||
| <WRAP center round info 80%> | <WRAP center round info 80%> | ||
| Workflows are constructed using drag-and-drop functionality. Click and hold the left mouse button on the tool icon you want to place on the design pane. Drag the icon to the point where you want it and release the mouse button to “drop” it in place. This same process is used to re-order icons in a workflow on the canvas. | Workflows are constructed using drag-and-drop functionality. Click and hold the left mouse button on the tool icon you want to place on the design pane. Drag the icon to the point where you want it and release the mouse button to “drop” it in place. This same process is used to re-order icons in a workflow on the canvas. | ||
| </ | </ | ||
| - | + | | |
| - | | + | |
| - | * Drag the next tool onto the design pane. | + | |
| * A connector line is automatically added to show the link between the two steps. | * A connector line is automatically added to show the link between the two steps. | ||
| * Continue adding tools as needed. | * Continue adding tools as needed. | ||
| * The workflow should always contain a Stop/ | * The workflow should always contain a Stop/ | ||
| + | * You can no longer drag and drop to add a tool to a workflow with an End tool present. | ||
| + | * There are two ways to add a tool to a workflow if an End tool is present | ||
| + | * Right-click on the tool in the design canvas and select " | ||
| + | * Delete the End tool in the workflow and add it once the modifications are finished. | ||
| <WRAP center round tip 60%> | <WRAP center round tip 60%> | ||
| Line 38: | Line 79: | ||
| ===== Bizweaver Tools Pane ===== | ===== Bizweaver Tools Pane ===== | ||
| - | {{ :bw2:bizweaverbuildingaworkflow21.png |}} | + | {{ :bw2:2_9_tool_pane.png |}} |
| The tools used to construct Bizweaver workflows are found in this area. They are added to a workflow by dragging them from the Tools area into the Design area. See the **// | The tools used to construct Bizweaver workflows are found in this area. They are added to a workflow by dragging them from the Tools area into the Design area. See the **// | ||
| Line 45: | Line 87: | ||
| Save the workflow as you work. Information on saving a workflow is found **// | Save the workflow as you work. Information on saving a workflow is found **// | ||
| - | ===== Workflow Design | + | ===== Workflow Design===== |
| + | Starting with Bizweaver version 2.6, the workflow designer is a separate window from the Bizweaver application. This allows users to open multiple workflows at once. | ||
| This area is the “design area” where a workflow is constructed. See the following sections of this document for more information. | This area is the “design area” where a workflow is constructed. See the following sections of this document for more information. | ||
| Line 53: | Line 96: | ||
| </ | </ | ||
| + | {{ : | ||
| ===== Adding Steps to an Existing Workflow ===== | ===== Adding Steps to an Existing Workflow ===== | ||
| Line 113: | Line 157: | ||
| In this view, the workflow steps are presented in the sequence in which they will be executed. | In this view, the workflow steps are presented in the sequence in which they will be executed. | ||
| + | |||
| + | ====Continue On Error==== | ||
| + | |||
| + | Continue on error if selected will allow a workflow to process past a step that had an error. | ||
| + | |||
| + | ====Breakpoint==== | ||
| + | |||
| + | More information on Breakpoints [[bw2: | ||
| + | |||
| + | ====== Workflow Variables ====== | ||
| + | |||
| + | “Variables” are data values that are held in memory during the execution of a workflow. There are two types of variables in Bizweaver: **User Variables** and **Step Variables**. | ||
| + | |||
| + | To access these variables while in any workflow tool, press F4. This will display the variables menu flyout in the tool window. Workflow steps will be displayed on the right, appearing in the order they are in the workflow. Workflow variables will be displayed under the tool name once the tool is clicked on in the flyout alphabetical order. | ||
| + | |||
| + | <WRAP center round info 80%> | ||
| + | In Bizweaver 2.6.10 and before, the variables selector will be a separate window, but the functionality remains when selecting workflow steps and then associated variables. | ||
| + | </ | ||
| + | |||
| + | To select variables, select the desired tool, click the tool name. This will expand the list and show all available variables from that tool in alphabetical order. Double click on the variable, and it will automatically be inserted into the last place the cursor was in the tool. To close the variable flyout, press the collapse button to the top right of the panel. | ||
| + | |||
| + | {{ : | ||
| + | |||
| + | **User Variables** are defined by the user. These values can be defined in the **// | ||
| + | |||
| + | **Step Variables** are special references created by the Bizweaver application. Most Bizweaver workflow tools create these variables as the step is executed. An example of this would be a reference to an output column from a SQL/HANA Tool or File Reader step. | ||
| + | |||
| + | Bizweaver variables are available to other workflow steps that follow the step where they are created. | ||
| + | |||
| + | More information is found on the **// | ||
| + | |||
| + | |||
| + | ======String Manipulation====== | ||
| + | |||
| + | Starting in Bizweaver 2.7.2, the functionality to modify variables was introduced. This allows a user to manipulate all variables that are inserted in a specific step. | ||
| + | |||
| + | {{ : | ||
| + | |||
| + | * **Escape:** Selecting this checkbox will enable or disable the escaping functionality. | ||
| + | * Only one of these can be selected at once, and they only apply in the step in which they are enabled. | ||
| + | * **JSON:** Selecting this will escape reserved characters for a JSON file. See the table below for more information. | ||
| + | * This will generally be used in a Databuilder step | ||
| + | * **XML:** Selecting this will escape any reserved characters for an XML file. See the table below for more information. | ||
| + | * This will generally be used in a Databuilder step | ||
| + | * **SQL:** Selecting this will escape reserved characters for SQL Server see table below for more information | ||
| + | * **Replace empty values with NULL:** This will take any empty strings or blanks ex '' | ||
| + | * This works independently of the Escape functions. | ||
| + | |||
| + | ^**JSON Reserved Character** | ||
| + | |Backspace | ||
| + | |Form feed | ||
| + | |Newline | ||
| + | |Carriage return | ||
| + | |Tab |A tab in a string | ||
| + | |" | ||
| + | |\ |A backslash | ||
| + | |||
| + | ^**XML Reserved Character** | ||
| + | |< |Less than sign |<| | ||
| + | |> | ||
| + | |& | ||
| + | |" | ||
| + | |' | ||
| + | |||
| + | ^**SQL Reserved Character** | ||
| + | |' | ||
| + | |||