Working With Workflow-Type Apps

Overview

The process of creating a workflow is different from other app elements. A workflow can only exist inside a workflow-type app. When you add a workflow-type app, Unqork automatically creates a workflow. When you delete a workflow-type app, its attached workflow also gets deleted. A workflow is an app element tied to its application. So, you'll create and delete workflows the same way you create and delete apps.

Creating a Workflow

You can create workflow-type apps from a workspace. To add a new workflow, you'll first open a workspace. Then, you can create an app and add a workflow to it.

To create a workflow:

If you don't have an existing application, create one from your workspace environment.

To create a workflow-type application:

1. In your Workspace tile, click +Create App.
2. Enter a unique App Name*. The App Path autofills automatically.
3. From the App Type* drop-down, select Workflow.
4. From the App Entrypoint* drop-down, select New Entrypoint.

A static image displaying how to create a workflow-type application.

5. In the App Description field, add a brief description of your workflow application.
6. Click Create.

To open the new workflow, click the workflow's tile.

Navigating the Workflow Element's Ellipsis Menu

Most workflow management takes place within the app. When you click the (ellipsis) on your workflow’s app element tile, a menu displays. Let's look at its settings:

Option

Description

Settings

Lets you update the workflow name and path.

Preview

Lets you preview your workflow in Express View.

Unqork defines applications by their entrypoint module and submission ID value. Workflows have a defined entrypoint module and only one submission ID. You can only have one workflow per app. Also, you can't share or move workflows.

To connect your workflow to another app, consider using a handoff. Handoffs let you continue your workflow submission in other workflow- or module-type apps.

Previewing a Workflow

Previewing your workflows as you build them gives you a glimpse of what the end-user sees. Most workflow management takes place at the Workspace Level. But, you can also preview your workflow at the Application Level from an open workflow app.

To preview a workflow at the Application Level:

1. Navigate to your workflow-type app.
2. From the (ellipsis) menu of the workflow's element tile, select Preview.

Static image displaying the ellipsis preview button on the application elements page.

Deleting a Workflow

Remember, a workflow ties directly to its app. The steps for deleting a workflow are the same as deleting a workflow-type app.

To delete a workflow-type app:

1. From the workspace page, find the workflow-type application you want to delete.
2. From the (ellipsis) menu of the workflow's element tile, select Delete.
3. Retype the name of your app exactly.

Static image of the Delete App modal.

4. Click Yes, Delete.

 

Overview

The process of creating a workflow is different from other app elements. A workflow can only exist inside a workflow-type app. When you add a workflow-type app, Unqork automatically creates a workflow. When you delete a workflow-type app, its attached workflow also gets deleted. A workflow is an app element tied to its application. So, you'll create and delete workflows the same way you create and delete apps.

Creating a Workflow

You can create workflow-type apps from a workspace. To add a new workflow, you'll first open a workspace. Then, you can create an app and add a workflow to it.

To create a workflow:

1. Click the + Create App button.

The Create App modal opens. This modal contains 2 tabs, App Info and Data Settings. The App Info tab shows by default. Data Settings are optional and offer a level of customization for your new app.

2. Enter a unique App Name.
3. Select a preview style from the Style drop-down. A style specifies your application’s appearance in Express View. If left blank, your preview uses the environment's default style.
4. From the App Type drop-down, select Workflow.
5. From the App Entrypoint drop-down, select New Entrypoint.

6. Click Create.

To open the new workflow, click the workflow's tile.

Navigating the Workflow Element's Ellipsis Menu

Most workflow management takes place within the app. When you click the ellipsis (...) on your workflow’s app element tile, a menu displays. Let's look at its settings:

Option

Description

Settings

Lets you update the workflow name and path.

Preview

Lets you preview your workflow in Express View.

Unqork defines applications by their entrypoint module and submission ID value. Workflows have a defined entrypoint module and only one submission ID. You can only have one workflow per app. Also, you can't share or move workflows.

To connect your workflow to another app, consider using a handoff. Handoffs let you continue your workflow submission in other workflow- or module-type apps.

Typically you configure workflows to reference modules. For example, referencing modules with a Signal Start or Task node. To reference your module, it needs to exist in a workflow-type application.

What if you want to reference a module that exists in a completely different application? You can share that module to your workflow-type application. To share a module to your workflow's workspace, you need to add it to the Library.

To add a module to the Library at the Application level:

1. Locate and open the application that contains your referenced module.
2. On the module element tile, click the ··· (ellipsis) button. The Module's options menu displays.
3. Select Share to Library.
4. From the Set Element Access & Usage drop-down, select either Share to Select Workspaces or Share to Environment.

Selecting Share to Environment will share the module to every workspace at that environment level.

5. With Share to Select Workspaces selected, select your workflow's workspace from the Share To column.

By default, the element automatically shares to the workspace in which it already exists. You cannot clear this selection. You can only select other workspaces to which you want to share the element.

6. Click Share.

Your module element is now shared to your workflow's workspace. Next, let's add it to the workflow's application.

To add a shared element to your workflow-type application:

1. Locate the workflow-type application whose workflow references your shared module element.
2. To the left of the page, select the Modules tab.
3. At the top right, click Library Button (Library).

4. Locate your shared module element and click Add.

The module that your workflow references is not a part of its application.

Duplicating Your Workflow-Type Applications

Now, let's duplicate your workflow applications. The only applications you can duplicate are workflow-type applications. If you could duplicate modules, the module ID changes and all workflow references break. But, when you duplicate a workflow-type application, all shared module elements carry over to the duplicate. Module IDs and paths don't change and your workflow works as normal. The duplicate also exists in the same workspace as the original application.

You can duplicate your workflow-type applications from the Workspace or Application Level. Let's look at both.

Duplicating Workflow-Type Applications at the Workspace Level

To duplicate a workflow-type application at the Workspace Level:

1. Navigate to the workspace holding your workflow-type app.
2. From the ellipsis (...) menu of the app's element tile, select Duplicate.

3. Click Duplicate in the pop-up window.

A new tile displays in your workspace. The default name for the duplicated application is name-of-original-app (COPY) (MM/DD/YYY, time-of-creation).

To rename your workflow-type application:

1. From the ellipsis (...) menu of the app's element tile, select Settings.

2. Enter a new Workflow Name in the Workflow Name field.
3. Enter a new Workflow Path in the Workflow Path field.

4. Click Save.

Duplicating Workflow-Type Applications at the Application Level

To duplicate workflow-type applications at the Application Level:

1. Navigate to the workspace holding your workflow-type app.
2. Open your workflow-type app.
3. From the Manage drop-down, select Duplicate.

4. Click Duplicate in the pop-up window.

Your new application opens immediately. The default name for the duplicated application is name-of-original-app (COPY) (MM/DD/YYY, time-of-creation). Similarly, your duplicated workflow has a default name of name-of-original-workflow (COPY) (MM/DD/YYY, time-of-creation).

To rename your workflow element:

1. From the ellipsis (...) menu of the workflow's element tile, select Settings.

2. Enter a new Workflow Name in the Workflow Name field.
3. Enter a new Workflow Path in the Workflow Path field.

4. Click Save.

Previewing a Workflow

Previewing your workflows as you build them gives you a glimpse of what the end-user sees. Most workflow management takes place at the Workspace Level. But, you can also preview your workflow at the Application Level from an open workflow app.

To preview a workflow at the Application Level:

1. Navigate to your workflow-type app.
2. From the ellipsis (...) menu of the workflow's element tile, select Preview.

Deleting a Workflow

Remember, a workflow ties directly to its app. The steps for deleting a workflow are the same as deleting a workflow-type app.

To delete a workflow:

1. Find the workflow-type application you want to delete.
2. From the ellipsis (...) menu of the workflow's element tile, select Delete.
3. Retype the name of your app exactly.

4. Click Yes, Delete.

 

Resource