Import App screen (Form-Based App)

This topic shows how to import an app in AgilePoint NX.

Background and Setup

Video: Create a Backup of an AgilePoint NX App

Video: Move an App to a Different AgilePoint NX Environment

Prerequisites

An app in .Zip format saved on your local machine.

Good to Know

When you import an application that already exists in AgilePoint NX, it replaces all application resource files in an application that exists and deletes all files which are not available in an application that you import.
For more information, refer to What Data Is Deleted When I Delete an App or Application Resource?.
When you import an application that already exists in AgilePoint NX, an app level access token also gets imported if the application does not have an access token. If the application that exists in AgilePoint NX has an access token, then it does not have any effect on access tokens. This includes both global access tokens and app level access tokens.
For more information, refer to What Data Is Deleted When I Delete an App or Application Resource?.
When you import an app to AgilePoint NX environment, AgilePoint Server validates the app you import and shows a list of shared resources on the App Dependencies screen. By default, this screen shows a list of shared resources that do not exist in an NX environment. You can also have an option to view a list of shared resources that the app uses. This screen shows only when you import an app that is exported from AgilePoint NX v8.0 or higher.

How to Start

Click App Builder.
Click Import.

Import App screen

Uploads an exported app from your local file system to AgilePoint NX.

Fields

Field Name	Definition
Select File	Function: Specifies a .Zip file that stores the app to import. You can drag the .Zip file from your local machine. Make sure that the .Zip file has the manifest.xml, dependencies.xml, and related JSON files that have necessary information about the app. Accepted Values: A .Zip file that stores an exported app. Click the Select file button to select a file from your local machine. Default Value: None Limitations: The dependencies.xml file exists only when you export an app after these releases: AgilePoint NX OnDemand (public cloud) AgilePoint NX OnDemand (public cloud), or AgilePoint NX Private Cloud or AgilePoint NX OnPremises v8.0 or higher.

Field Name

Definition

Select File

Function:

Specifies a .Zip file that stores the app to import.

You can drag the .Zip file from your local machine.

Make sure that the .Zip file has the manifest.xml, dependencies.xml, and related JSON files that have necessary information about the app.

Accepted Values:

A .Zip file that stores an exported app.

Click the Select file button to select a file from your local machine.

Default Value:

None

Limitations:

The dependencies.xml file exists only when you export an app after these releases:

AgilePoint NX OnDemand (public cloud)
AgilePoint NX OnDemand (public cloud), or AgilePoint NX Private Cloud or AgilePoint NX OnPremises v8.0 or higher.

App Dependencies screen

Shows the list of shared resources that do not exist in AgilePoint NX when you import an app. A shared resource may not exist in an NX environment because it was either exported from a different NX environment where the shared resource exists, or the shared resource was deleted from the NX environment after the app was exported.

Prerequisites

AgilePoint NX OnDemand (public cloud), or AgilePoint NX Private Cloud or AgilePoint NX OnPremises v8.0 or higher.

Good to Know

To view the list of shared resources that are used in the app you import, click Show All Dependencies.

Fields

Field Name	Definition
Shared Resources	Function: Shows the list of shared resources that do not exist in AgilePoint NX when you import an app. Accepted Values: Read only. Default Value: None
Show All Dependencies	Function: Specifies whether to show the list of shared resources that are used in the app you import. Accepted Values: Deselected - Shows only the shared resources that do not exist in the AgilePoint NX environment where you are importing. A shared resource may not exist in an NX environment because it was either exported from a different NX environment where the shared resource exists, or the shared resource was deleted from the NX environment after the app was exported. Selected - Shows the list of shared resources that are used in the app. Default Value: Deselected
Continue with Import	Function: Uploads the app to AgilePoint NX. Before you publish the imported app, make sure that the app has all required shared resources. You may need to create the shared resources or import them individually from another environment.