Navigating an Application

Estimated Reading Time:  5 minutes

Overview

When you open an application, you're at the Application Level. This is where you'll access and organize app elements in your application. App elements include modules, workflows, and Data Collections. These elements are what you use to build apps. Inside your application, you can also connect shared elements to your application.

Here's where the Application Level is on the Workspaces map:

A static image displaying Unqork's environment, app, and app element level architecture.

Once inside your app, you can open your app elements. Opening a workflow, module, or reference data opens the element in edit mode.

NOTE  Application is also known as an app. You might see these terms used interchangeably across the Documentation Hub. Both words refer to an Unqork application.

What You'll Learn

In this article, you'll learn how to navigate to the App level, explore your app's workflows, modules, and Data Collections, as well as what actions you can perform on your app elements.

Accessing an Application

To access the App level of Workspaces, you must first open a workspace.

1. Click Workspaces at the top right of the page.
2. Click the workspace name in the tile header of the workspace you want to access.
3. Click the app name in the tile header of the application you want to access.

NOTE  You can also search for an app by clicking the icon in the navigation menu.

Navigating an App's Side Menu

Once inside your app, you can access and organize app elements. Depending on the type of app you selected, two or three tabs are visible in the menu to the left. For module-type apps, you'll see Module IconModules and Data Collections Icon Data Collections. For workflow-type apps, you'll see Workflow Icon Workflows, Module IconModules, and Data Collections Icon Data Collections.

Setting Description

Workflow Icon Workflows

Click this tab to display all workflows in your app.

Module Icon Modules

Click this tab to display all modules in your app. This is the default page.

Data Collections Icon Data Collections

Click this tab to display all Data Collections in your app.

Here's how the Workflow Icon Workflows page looks:

A static image displaying the app's workflow elements with the Workflows tab selected.
(click to expand image)

Here's how the Module Icon Modules page looks

A static image displaying the app's module elements with the Modules tab selected.
(click to expand image)

Here's how the Data Collections Icon Data Collections page looks:

A static image displaying the app's Data Collection elements with the Data Collections tab selected.
(click to expand image)

Navigating the App Level

Regardless if you access a module-type app, a workflow-type app, or your app's Data Collection, there are various actions you can take at the App Level. Here are descriptions of what you'll see inside your application:

Attribute Description

(Library)

Only available on the Modules and Data Collections pages. Opens the Library Modules or Library Data Collections panel to the right of the page. From here, you can search for elements, add them directly to your app, and configure their settings.

Manage ▾

Use this drop-down to see a list of administrative actions you can perform on your application.

  • Settings: Opens the App Settings modal A modal is a window that appears on top of the content you are currently viewing. where you can:

    • Modify the App Name* and App Path*.

    • Add or modify Header Modules, Footer Modules, Login Modules, and Footer Modules.

    • Add or modify app styles.

    • Add an App Description to make it easier to onboard team members or hand off projects.

  • Preview: To preview your application from the workspace page: Open your workspace. In the  Applications tab, click the ellipsis (Inline image of an ellipsis icon.) of the application you want to preview. The application settings menu appears.Image showing the Application Settings menu open on the workspaces page.Select Preview to preview your application in Express View Express View is how your end-user views you application. Express View also lets you preview your applications to test your configuration and view the styling. After configuring a module, click Preview in the Module Editor to interact with the module in Express View.To preview your application from the application page:These instructions assume you have already created an application in your workspace. Open the application you want to preview. Click Manage ▾. Select Preview to preview your application in Express View.Image showing the Application Settings menu open on the application page. You can also view an application preview in Express View using the following application URL path: https://www.{your-environment}unqork.io/app/{appPath}#/display/{moduleId}/{submissionId}/{moduleId}.For example, an application named application-settings was created in the training environment. The moduleId of the application is 6517325819f7fec671368ff4 and has no submissionId. So, the Express View preview of this application uses the following URL: https://trainingx.unqork.io/app/application-settings#/display/6517325819f7fec671368ff4.

  • Duplicate: Only available for module-type apps. All app elements in the original app duplicate as a copy of the app. App elements duplicated include the module type and tags. Selecting this option displays a modal where you can change the module name and path, add a description, and select module type.

  • Move: Moves the application to a different workspace. Any shared elements in the app share with both the original workspace and the destination workspace.

  •  Data Model: This link opens the application's Data Model page. Data models are visual representations of an application's data.

  • Promotion: Opens the App Promotion page to promote your app to the next environment stage.

    TIP  To learn more about promoting applications, see our Promoting Applications article.

  • Export CSV: Creates a CSV file of your application. The exported file contains the modules and the components in your app.

  • Delete: Deletes the application.

+ Create New

Create a new app element. Depending on what page you're on at the App Level, you can create a new workflow, module, or Data Collection.

Filter Tags

Use this field to filter your app elements by the tags you created in your app elements.

TIP  To learn about adding tags to module and workflow-type apps, see our Working With Module-Type Apps and Working With Workflow-Type Apps articles.

Recently Modified

Choosing a drop-down option arranges your workspaces, apps, or app elements. You can arrange by Last Modified, Created Date, or Title. Choosing an option a second time reverses its order. You'll see an arrow icon next to your chosen Sort by option. The arrow icon points up (ascending order (A to Z)) or down (descending order (Z to A)) depending on your Sort by order.

Element Tiles

Element tiles contain the following:

  • The app element name at the top of the tile. Clicking the element tile opens your element in edit mode.

  • If the app element is locked or not.

  • Information on when the app element was last modified and by whom.

Element Tile Options

You can also perform specific actions to individual app element tiles. Each tile includes an ... (ellipsis) that lets you access the element's settings, share it to the Library, and so on. Options available are dependent on the element type.

Workflow Tiles

The following options are available when clicking the ... (ellipsis) button on workflow tiles:

A static image displaying the ellipsis options for a workflow tile.

Option Description

Settings

Opens the App Settings modal A modal is a window that appears on top of the content you are currently viewing. where you can:

Modify the App Name* and App Path*. Add or modify app styles. Add or modify Header Module, Footer Module, Login Module, and Footer Module. Add an App Description to make it easier to onboard team members or hand off projects.

Preview

To preview your application from the workspace page:

1. Open your workspace.
2. In the  Applications tab, click the ellipsis (Inline image of an ellipsis icon.) of the application you want to preview. The application settings menu appears.

Image showing the Application Settings menu open on the workspaces page.

3. Select Preview to preview your application in Express View Express View is how your end-user views you application. Express View also lets you preview your applications to test your configuration and view the styling. After configuring a module, click Preview in the Module Editor to interact with the module in Express View.

To preview your application from the application page:

NOTE  These instructions assume you have already created an application in your workspace.

1. Open the application you want to preview.
2. Click Manage ▾.
3. Select Preview to preview your application in Express View.

Image showing the Application Settings menu open on the application page.

 

You can also view an application preview in Express View using the following application URL path: https://www.{your-environment}unqork.io/app/{appPath}#/display/{moduleId}/{submissionId}/{moduleId}.

For example, an application named application-settings was created in the training environment. The moduleId of the application is 6517325819f7fec671368ff4 and has no submissionId. So, the Express View preview of this application uses the following URL: https://trainingx.unqork.io/app/application-settings#/display/6517325819f7fec671368ff4.

Module Tiles

The following options are available when clicking the ... (ellipsis) button on module tiles:

A static image of the ellipsis options for a module tile.

Option Description

Settings

Opens the App Settings modal A modal is a window that appears on top of the content you are currently viewing. where you can:

Modify the App Name* and App Path*. Add or modify app styles. Add or modify Header Module, Footer Module, Login Module, and Footer Module. Add an App Description to make it easier to onboard team members or hand off projects.

Preview

To preview your application from the workspace page:

1. Open your workspace.
2. In the  Applications tab, click the ellipsis (Inline image of an ellipsis icon.) of the application you want to preview. The application settings menu appears.

Image showing the Application Settings menu open on the workspaces page.

3. Select Preview to preview your application in Express View Express View is how your end-user views you application. Express View also lets you preview your applications to test your configuration and view the styling. After configuring a module, click Preview in the Module Editor to interact with the module in Express View.

To preview your application from the application page:

NOTE  These instructions assume you have already created an application in your workspace.

1. Open the application you want to preview.
2. Click Manage ▾.
3. Select Preview to preview your application in Express View.

Image showing the Application Settings menu open on the application page.

 

You can also view an application preview in Express View using the following application URL path: https://www.{your-environment}unqork.io/app/{appPath}#/display/{moduleId}/{submissionId}/{moduleId}.

For example, an application named application-settings was created in the training environment. The moduleId of the application is 6517325819f7fec671368ff4 and has no submissionId. So, the Express View preview of this application uses the following URL: https://trainingx.unqork.io/app/application-settings#/display/6517325819f7fec671368ff4.

Duplicate

Only available for module-type apps. All app elements in the original app duplicate as a copy of the app. App elements duplicated include the module type and tags. Selecting this option displays a modal where you can change the module name and path, add a description, and select module type.

Move

Moves the application to a different workspace. Any shared elements in the app share with both the original workspace and the destination workspace.

Share to Library

Converts the app element into a shared element that you can use across various workspaces.

TIP  To learn more about Library Elements, see our Unqork Library Elements article.

Delete

Deletes the application.

Data Collections Tiles

The following options are available when clicking the ... (ellipsis) button on Data Collection tiles:

A static image displaying the ellipsis options for a Data Collections tile.

Option Description

Reload CSV

Lets you upload a new or modified CSV file to the Data Collection. It's important to note that uploading another CSV file will replace the existing one. Ensure the file won't break any application dependencies you might have.

Export CSV

Creates a CSV file of your application. The exported file contains the modules and the components in your app.

Move

Moves the application to a different workspace. Any shared elements in the app share with both the original workspace and the destination workspace.

Share to Library

Converts the app element into a shared element that you can use across various workspaces.

TIP  To learn more about Library Elements, see our Unqork Library Elements article.

Delete

Deletes the application.

Resources