Promoting Applications

Estimated Reading Time:  5 minutes

Overview

During the application development process, it's important that you understand the different Unqork environments and their purpose. Each environment is used for a different purpose, like creating your application, testing its functionality, and making it available to your end-user End-users, also known as Express Users, are the individuals accessing an application through Express View. In most cases, end-users are the customers using the product.. When you're ready to move an application to the next phase of development, you'll promote it. Promoting applications advances them from their current environment level to the next available one.

What You'll Learn

In this article, you'll learn about Unqork environment levels, how to promote an application, and view its promotion history.

Unqork Environment Levels

Unqork environment levels support each phase of the application development process. Environment levels are intended to be used in sequential order. You can only promote to the next available environment level in the sequence.

Below is a list of Unqork available environment levels, their order in the environment sequence, and descriptions of each:

  Environment Level Description Codebase

1

Staging

Where Unqork Creators Also known as Unqork Users, or Designer Users; is anyone who is inside the Unqork platform. configure applications. This non-production environment level hosts test data only. This level is where you prepare updates before promoting to QA for testing.

Unqork hosts the Staging environment internally. Staging offers both a Designer and Express View interface.

Staging

2

Quality Assurance (QA)

Where Unqork Creators test and verify processes, artifacts, and ensure applications are built using best practices. This non-production environment level hosts test data only.

Unqork hosts the QA environment internally. QA offers both a Designer and Express View interface.

QA

3

User Acceptance Testing (UAT)

Where the Creators and end-users End-users, also known as Express Users, are the individuals accessing an application through Express View. In most cases, end-users are the customers using the product. can view the latest build. Use this environment level to test your application's end-user experience. This non-production environment hosts test data only.

Unqork hosts the UAT environment internally. UAT offers both a Designer and Express View interface.

UAT

4

Production

This is the live application and the only environment level where end-users can access it. This level is also the only environment to host live client data.

IMPORTANT  Following SDLC best practices, development should never take place in Production.

Production

NOTE  Additional environments can also include Pre-Production (Pre-Prod) environment levels. Pre-Prod environments use the Production codebase. The progression order is Staging, QA, UAT, Pre-prod, and Production. Client leads decide the number of environments to use when developing a customer application.

Promotions

Moving your application between these environment levels is called a promotion. It's important to note that you can only promote to the next available environment level in the sequence. For example, from Staging to QA.

Here's how application promotions work:

Action Result

Promoting for the first time.

If your application does not exist in the next environment level, the workspace is promoted with the application the first time you promote your application.

Promoting to the same environment.

If your application exists in the next environment level, your promoted application overwrites its previous version. Unqork also promotes your application to the correct workspace.

Promoting specific modules.

Modules not promoted remain untouched. Your promoted application uses the existing modules in the next environment level.

Promoting when shared modules connect to other applications.

The promotion automatically converts modules to shared modules. If other applications promote to the next environment level, they can still connect to these modules.

Promoting when shared modules do not connect to other applications.

These modules promote as normal application elements instead of shared application elements.

IMPORTANT  You cannot promote an application that has the same app path as an application already promoted.

Promoting an Application

There are two options for promoting Unqork applications. The first is by using the Release Management Dashboard UDLC tool. The second is promoting your applications individually at the Application level.

Promoting an Application Using the Release Management Dashboard Tool

The best practice for promoting your applications is using the Release Management Dashboard tool. This tool makes it easy to create releases with specific apps, modules, and Data Collections. Then, you can promote that release, monitor its progress, and view all of its relevant information.

TIP  To learn more about the Release Management Dashboard tool, view our Release Management Dashboard Tool article.

Promoting an Application at the Application Level

You can also promote applications at the Application level. Doing so takes you to the App Promotion page, where you can select the environment level to promote to, select elements to promote, and view its promotion history.

IMPORTANT  If you use Managed Assets and PDF Templates, you must upload these to each environment level. When promoting an application to the next environment level, you must also promote all other elements and attributes of the application. This includes roles, groups, styles, and Data Collections.

To promote your application at the Application level:

1. Navigate to an application you want to promote.
2. At the top right of the Application page, click Manage ▾.
3. From the drop-down, select Promotion. You'll navigate to the App Promotion page.

A static image displaying how to select the Promotion option from the Manage drop-down at the Application level.

You'll find the following attributes on the App Promotion page:

Attribute

Description

Set Destination Promotion Environment*

Select the environment level where you'd like to promote your application. This application will be promoted with its entrypoint module or workflow and any additional connected modules, workflows, and Data Collections you select in the following sections of the page.

General App Information

Information about the application. This information includes:

  • App Name: The application's name.

  • App Path: The application's path.

  • Style: The style associated with the application.

  • App ID: The application's unique identifier.

  • App Type: The type of application. Application type can be Module or Workflow.

  • Created: The date and time the application was created.

  • Last Modified: The date and time the application was last modified.

Promotion History

After you promote your application, it displays in Promotion History, along with other previous promotions. Applications promoted from the environment display in the Out tab. Those promoted into the environment display in the In tab. Use Promotion History to monitor the promotion's progress and whether it is successful or not.

This section of the page also displays the following information about the promotion:

  • Destination Promotion Environments: The name of the environment stage where the application was promoted.

  • Date: The date and time when the application was promoted.

  • Promoted By: The email address of the user that promoted the application.

  • Status: The status of the promotion. Statuses include Promotion in Progress, Promotion Completed, and Promotion Failed. Below the status, you see the number of elements included in the promotion.

  • NOTE  If any element in the application does not successfully promote, the status is Promotion Failed.

  • View Details: Click this link to displas the promotion details. These details include the elements selected for the promotion.

Workflow & Modules to Promote

Select the workflows and modules you want to promote with the application.

Data Models & Associated Elements to Promote

Select the Data Models and other associated elements you want to promote with the application.

Data Collections to Promote

Select the Data Collections you want to promote with the application.