Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Section
Column

’ workflow palette contains all of the forms you have already created in the Forms tab of the project you are currently editing. These forms are available for you to add as steps of the workflow. The palette also contains a new form which lets you create a new form step directly within the Workflow Designer. Additional step types for workflow steps are Summary and http. The purpose of each is described below.
Image Modified

Column
width400px

On This Page:

Table of Contents
maxLevel2

...

  1. Create forms in the Forms designer and then drag the form(s) into the workflow as the steps (Existing Forms).
  2. Create the workflow by dragging a New Form from the palette and drop it onto the workflow canvas. Then click the Image Modifiededit icon and create the form in the forms designer that opens up in the Workflow Designer.

...

  • The designer can go back and edit the forms in the forms designer then drag the updated forms into the workflow.  If you choose to do this, then you have to redo any properties for that step. (assign users/roles, task information, Pending messages, customized Save and Continue buttons etc).
  • Or you can update the form directly in the workflow by clicking the Image Modified edit  edit icon. This approach is quicker but the changes that you make to the form from within the workflow designer DO NOT update the form in the Forms designer.

...

 If you click on a form step in a workflow, you can download that step from the workflow as a standalone form and upload it into the Forms designer. Simply click on the step in the workflow then click the form icon. If you have designed your workflow using Linked Steps in a Workflow the icon to download the form step will only appear on the parent step.

Image Modified

The downloaded file is a _form.zip file and is named according to the convention shown below:

...

Here is an example of the downloaded file for step 1 named Employee in a workflow named Vendor Quote.

Image Modified

This is an easy way to keep your forms and workflows in sync and reuse forms created/updated in the workflow designer in other workflows or as standalone forms.

...

Drag the New Form from the palette and drop it into the guide box. You will only see the guide box when adding the first step.

Image Modified

Click to select it.  A unique and arbitrary name will be generated automatically for the step--Step 29 for example. To change the name of the workflow step:

  • Click anywhere in the General Setting section in the Properties Navigator on the left. This opens the Settings tab. Change the name of the step from the default to something meaningful in the Name field.
    When you click on any step in the workflow,  a series of action icons displays depending on the step type. Creating a workflow step by dragging/dropping an existing form or a New Form from the Palette shows these icons:

    • Image Modified - Cog icon - Click this icon to edit Step Properties. This icon is displayed when you select the workflow step and in the Properties Navigator on the left side of the designer. 
      • Clicking the Image ModifiedEdit Step Properties icon on a workflow step displays tabs to set up Settings, Assignment, Messages, Rejection, Precondition, Escalations, Emails, Web Hook, Quick Approval and Geo Location.
      • Clicking the Image ModifiedEdit Step Properties from the Properties Navigator or simply clicking on a section of the Properties Navigator brings you directly to the tab for immediate editing.
    • Image Modified - Chain link icon - Click this icon to create Linked Steps. Refer to Linked Steps in a Workflow for a discussion of this Workflow Design pattern and when you should use it.
    • Image Modified - Download Arrow over bar - Use this icon to download the step of the workflow as a standalone form. You may want to do this if you update the step in the workflow designer and you want to keep your Forms and Workflow libraries in sync.
    • Image Modified -  Pencil icon - Click this icon to make changes to a workflow step. The form will open in the Forms Designer inside of the Workflow Designer. Remember, the form in the Workflow Designer is a copy and any form changes will not automatically sync up with the original form in your Forms library.
    • - Minus icon - Use this icon to delete a step in a workflow. You will NOT be asked to confirm the deletion. Once clicked, the deletion is permanent.

Image Modified

Existing Forms 

The palette contains all of the forms that you have already created and which are listed in your current project's forms home page. You can use any form as a step in the workflow. Adding an existing form to the workflow creates a copy of that form. If you later edit the form from the forms home page,  those changes will not affect the step in the workflow. It remains as it was at the time you copied it into the workflow. If you want to update the workflow to have a new copy of the form, delete the form from the workflow and drag it in again. You can also edit the form directly in the workflow. Conversely these changes to the form inside the workflow do not affect the original form in the form home page.

Drag the existing Form from the palette and drop it into the guide box. You will only see the guide box when adding the first step.

Image Modified

...

Click to select it.

...

When you click on any step in the workflow,  a series of action icons displays depending on the step type. Creating a workflow step by dragging/dropping an existing form or a New Form from the Palette shows these icons:

  • Image Modified - Cog icon - Click this icon to edit Step Properties. This icon is displayed when you select the workflow step and in the Properties Navigator on the left side of the designer. 
    • Clicking the Image ModifiedEdit Step Properties icon on a workflow step displays property tabs to set up Settings, Assignment, Messages, Rejection, Precondition, Escalations, Emails, Web Hook, Quick Approval and Geo Location.
    • Clicking the Image ModifiedEdit Step Properties from the Properties Navigator or simply clicking on a section of the Properties Navigator brings you directly to the tab for immediate editing.
  • Image Modified - Chain link icon - Click this icon to create Linked Steps. Refer to Linked Steps in a Workflow for a discussion of this Workflow Design pattern and when you should use it.
  • Image Modified - Download Arrow over bar - Use this icon to download the step of the workflow as a standalone form. You may want to do this if you update the step in the workflow designer and you want to keep your Forms and Workflow libraries in sync.
  • Image Modified -  Pencil icon - Click this icon to make changes to a workflow step. The form will open in the Forms Designer inside of the Workflow Designer. Remember, the form in the Workflow Designer is a copy and any form changes will not automatically sync up with the original form in your Forms library.
  • Image Modified - Minus icon - Use this icon to delete a step in a workflow. You will NOT be asked to confirm the deletion. Once clicked, the deletion is permanent.

Image Modified

When you add an existing form as a step in your workflow:

...

Previously completed steps in a workflow can be viewed by all users but editing data is only allowed for the user that initiated the workflow. For example, if the Summary step is part of a screenflow performed by the same user, editing is allowed when this user clicks on the Details button. Once the workflow navigates to a different user, previous steps are rendered read-only and cannot be edited. Refer to Workflow Processing Modes for more information.

The Print button is available on Summary steps by default. Refer to Printing Workflows for the details.

When you click on the Summary step, you will see

  • Image Modified - Cog icon - Click this icon to edit Step Properties. This icon is displayed when you select the workflow step and in the Properties Navigator on the left side of the designer. Click the Image Modified icon on the Properties Navigator or anywhere in the General Settings section takes you directly to the Settings tab.
  • Image Modified - Minus icon - Use this icon to delete a step in a workflow. You will NOT be asked to confirm the deletion. Once clicked, the deletion is permanent.

The designer can specify a CSS class, a Button label and a Decorator for the Summary step on the Settings property tab.

Image Modified

The fields that display on the Summary Step are selected by the designer in the Summary wizard.

HTTP

Drag an HTTP step from the Palette and drop it anywhere in your workflow. If you are adding it as the first step, drop it into the guide box. You will only see the guide box when adding the first step.

Image Modified

Click to select it.
When you click on any step in the workflow,  a series of action icons displays depending on the step type. Creating a workflow step by dragging/dropping an HTTP shows these icons:

  • Image Modified - Cog icon - Click this icon to edit Step Properties. This icon is displayed when you select the workflow step and in the Properties Navigator on the left side of the designer. 
    • Clicking the Image ModifiedEdit Step Properties icon on a workflow step displays tabs to set up Settings, Email and Web Hook properties.
    • Clicking the Image ModifiedEdit Step Properties from the Properties Navigator or simply clicking on a section of the Properties Navigator brings you directly to the tab for immediate editing.
  • Image Modified - Minus icon - Use this icon to delete a step in a workflow. You will NOT be asked to confirm the deletion. Once clicked, the deletion is permanent.

HTTP Wait - Notify

HTTP Wait-Notify is a step, configured with a post url, that can be added to a workflow. The workflow data is posted to this url when the task is executed. A call back url is included in the post. The workflow and task are suspended until the receiver posts back.

...

Now let’s take a look at a simple workflow that will accomplish the scenario described above. This workflow contains the Purchase Request form submitted by the company purchasing manager as the first step. The second step is an HTTP step which provides the url to the web component that handles collecting the signatures from all the required approvers. The third step is a Summary step. Remember the workflow will be suspended until all the approval signatures have been collected by the web component. The web program will then use the callback url to proceed to the Summary step of the workflow.

Image Modified

  • Click on the HTTP step and open the Settings tab. Enter the URL for your post. In the image below, we are entering the URL to a remote test server running a service that can be used to test this feature: http://<server:port>/services/testwaitnotify.
  • Configure Email or a post to a web application if required. These actions will be performed when the HTTP step is completed. Remember to slide the toggle icon to turn on the Email and Web Hook features.

...