Create New App screen

Background and Setup

Prerequisites

Configure Default App Settings.
For more information, refer to Default App Settings screen.
AgilePoint NX OnDemand (public cloud), AgilePoint NX PrivateCloud, or AgilePoint NX OnPremises v9.0 Software Update 1 or higher.

How to Start

On the Home screen, click Add App.

What are the basic settings for your app? screen

Specifies the basic configuration information for a custom mobile app.

Fields

Field Name	Definition
Mobile App Name	Description: Specifies a display name for the custom mobile app. Allowed Values: One line of text (a string). Accepted: Letters Numbers Spaces Default Value: None
Version	Description: Specifies the version for the custom mobile app. Allowed Values: An integer. Default Value: None
Default Locale	Description: Specifies the default locale for the custom mobile app. Allowed Values: Default Language - Uses the language on the mobile device. A locale from the list. Default Value: Default Language
Description	Description: A text description for the custom mobile app. Allowed Values: More than one line of text. Accepted: 2000 characters maxiumum Default Value: None
Company Name	Description: Specifies the name of the mobile app user's organization. Allowed Values: One line of text (a string). Accepted: Letters Numbers Spaces Default Value: The value specified in Default App Settings > Company Details tab.
Company Website	Description: Specifies the URL of the mobile app user's organization website. Allowed Values: A valid URL of the website. Default Value: The value specified in Default App Settings > Company Details tab.
Company Support Email	Description: Specifies the mobile app user's organization customer support email address to contact. Allowed Values: One line of text (a string) in email address format. Default Value: The value specified in Default App Settings > Company Details tab.
Company Info Email	Description: Specifies the mobile app user's organization email address for information. Allowed Values: One line of text (a string) in email address format. Default Value: The value specified in Default App Settings > Company Details tab.
Copyright	Description: Specifies the copyright information of the mobile app user's organization. Allowed Values: One line of text (a string). Accepted: Letters Numbers Spaces Default Value: The value specified in Default App Settings > Company Details tab.
Standard EULA / Custom EULA	Description: Specifies the type of end-user license agreement (EULA) to use for the custom mobile app. Allowed Values: Standard EULA - Uses the out-of-the-box or standard EULA for the custom mobile app. Custom EULA - Uses a custom EULA for the custom mobile app. Default Value: The value specified in Default App Settings > Company Details tab.
EULA Text	Description: Specifies a text description for the end-user license agreement (EULA). Allowed Values: More than one line of text. Default Value: The value specified in Default App Settings > Company Details tab.
EULA Link	Description: Specifies the URL for the end-user license agreement (EULA). Allowed Values: One line of text (a string). Format: URL Default Value: The value specified in Default App Settings > Company Details tab.
Next	Opens this Screen: Authentication tab. Function of this Screen: Configures the authentication providers for the custom mobile app.

How will users sign in to your app? screen

Configures the authentication providers for the custom mobile app.

Good to Know

For information about how to configure each authentication type, refer to Configure Authentication for a Custom Mobile App in Mobile App Accelerator.
The AgilePoint Product Documentation only provides information to configure authentication with an AgilePoint ID. For help configuring third-party authentication providers, contact AgilePoint Professional Services.

Fields

Field Name	Definition
Select Authentication Providers for Your Mobile App	Description: Specifies the authentication providers for the custom mobile app. Allowed Values: Active Directory AgilePoint ID Amazon Cognito Google Workspace IdentityServer Microsoft Entra ID / Microsoft 365 Microsoft Entra ID / Microsoft 365 (China) Okta PingFederate Salesforce For information about how to configure each authentication type, refer to Configure Authentication for a Custom Mobile App in Mobile App Accelerator. Default Value: AgilePoint ID
Server Instance URL (REST)	Description: Specifies the REST AgilePoint Service URL for your tenant. For more information, refer to Find Your AgilePoint Service URL in AgilePoint NX. Allowed Values: A valid AgilePoint service URL. Default Value: None
Next	Opens this Screen: App Filters tab Function of this Screen: Specifies the AgilePoint NX apps for the custom mobile app.

Which AgilePoint NX apps do you want users to access? screen

Specifies the AgilePoint NX apps for the custom mobile app.

Fields

Field Name	Definition
Show All AgilePoint NX Apps / Show Only the Selected AgilePoint NX Apps	Description: Specifies whether to show your imported AgilePoint NX apps list to select specific apps for your custom mobile app. Allowed Values: Show All AgilePoint NX Apps - Shows all the AgilePoint NX apps in the custom mobile app from your AgilePoint NX environment. Show Only the Selected AgilePoint NX Apps - Shows the list of AgilePoint NX apps from your imported file and then you can select to show or hide each app in the custom mobile app. Default Value: No
Show	Description: Specifies whether to show the AgilePoint NX app in your custom mobile app. Allowed Values: Selected - Shows the AgilePoint NX app in your custom mobile app. Deselected - Hides the AgilePoint NX app in your custom mobile app. Default Value: No
NX App	Description: Shows the name of AgilePoint NX apps from the imported file. Allowed Values: Read only.
Next	Opens this Screen: Menu Options tab. Function of this Screen: Specifies the features to include in the custom mobile app.

What features will your mobile app use? screen

Specifies the features to include in the custom mobile app.

Fields

Field Name	Definition
Translate Names In	Description: Specifies the language for the translation from the list. Allowed Values: A language from the list. Default Value: None
Menu Options	Description: Shows the default name for a menu, and lets you specify a different name that shows in the Dashboard of the custom mobile app. Allowed Values: My Apps - Specifies a different name for the My Apps menu on the Dashboard of the custom mobile app. My Tasks - Specifies a different name for the My Tasks menu on the Dashboard of the custom mobile app. Home - Specifies a different name for the home menu on the Dashboard of the custom mobile app. Outbox - Specifies a different name for the Outbox menu on the Dashboard of the custom mobile app. My Team - Specifies a different name for the Team Tasks menu on the Dashboard of the custom mobile app. Planned Tasks - Specifies a different name for the Planned Tasks menu on the Dashboard of the custom mobile app. Watchlist - Specifies a different name for the Watchlist menu on the Dashboard of the custom mobile app. External Apps - Specifies a different name for the External Apps menu on the Dashboard of the custom mobile app. Processes I Started - Specifies a different name for the Processes I Started menu on the Dashboard of the custom mobile app. Processes I've Worked - Specifies a different name for the Process I've Worked menu on the Dashboard of the custom mobile app. Delegations - Specifies a different name for the Delegation menu on the Dashboard of the custom mobile app. Settings - Specifies a different name for the Settings menu on the Dashboard of the custom mobile app. Help - Specifies a different name for the Help menu on the Dashboard of the custom mobile app. About - Specifies a different name for the About menu on the Dashboard of the custom mobile app. Default Value: The value specified in Default App Settings > Menu Options tab.
Enable	Description: Specifies whether to show the features in the Dashboard of the custom mobile app. Allowed Values: On - Shows the features in the Dashboard of the custom mobile app. Off - Does not show the features in the Dashboard of the custom mobile app. Default Value: The value specified in Default App Settings > Menu Options tab.
Next	Opens this Screen: Platform tab Function of this Screen: Specifies the mobile operating system for the custom mobile app.

What platforms will your mobile app use? screen (Android)

Specifies the mobile operating system for the custom mobile app.

Fields

Field Name	Definition
Select The Platforms For Your Mobile App	Description: Specifies one or more operating systems for which to build the custom mobile app. Allowed Values: Android - Configures the custom mobile app for Android. iPhone and iPad - Configures the custom mobile app for iOS. Default Value: None
Build Type	Description: Specifies the type of deployment for your custom mobile app. To Open this Field: Select Android or iPhone and iPad. Allowed Values: MDM Build - Lets you deploy the custom mobile app with MDM. In the current release, only Intune is supported for MDM deployment. For more information, refer to MDM Deployment Guide. Store Build - Lets you deploy the custom mobile app to a public app store. Device Specific Build - Lets you deploy the custom mobile app directly to a mobile device. Default Value: MDM Build
Package Name	Description: Specifies a name to append to the build package file for your custom mobile app. To Open this Field: Select Android. Allowed Values: One line of text (a string). Not Accepted: Spaces Default Value: None
Certificate	Description: Specifies your certificate for the Android operating system. To Open this Field: Click Android. In the Build Type field, select Store Build. Allowed Values: Use the Select File button to select your Android Certificate.
Key Alias	Description: Specifies the name for the key. The key name identifies your certificate for the Android operating system. To Open this Field: Click Android. In the Build Type field, select Store Build. Allowed Values: A valid key name from Android. Default Value: None
Key Password	Description: Specifies the password for the key. To Open this Field: Click Android. In the Build Type field, select Store Build. Allowed Values: A valid password. Default Value: None
Store Password	Description: Specifies a password for your keystore. A keystore is a repository of certificates. To Open this Field: Click Android. In the Build Type field, select Store Build. Allowed Values: A valid keystore password. Default Value: None
Next	Opens this Screen: Styling tab. Function of this Screen: Specifies the menu color and button color for the custom mobile app.

What platforms will your mobile app use? screen (iOS)

Specifies the mobile operating system for the custom mobile app.

Fields

Field Name	Definition
Select The Platforms For Your Mobile App	Description: Specifies one or more operating systems for which to build the custom mobile app. Allowed Values: Android - Configures the custom mobile app for Android. iPhone and iPad - Configures the custom mobile app for iOS. Default Value: None
Build Type	Description: Specifies the type of deployment for your custom mobile app. To Open this Field: Select Android or iPhone and iPad. Allowed Values: MDM Build - Lets you deploy the custom mobile app with MDM. In the current release, only Intune is supported for MDM deployment. For more information, refer to MDM Deployment Guide. Store Build - Lets you deploy the custom mobile app to a public app store. Device Specific Build - Lets you deploy the custom mobile app directly to a mobile device. Default Value: MDM Build
Certificate	Description: Specifies your iOS certificate. To Open this Field: Select iPhone and iPad. Allowed Values: Use the Select File button to select your iOS Certificate.
Password	Description: Specifies a password for your certificate. To Open this Field: Select iPhone and iPad. Allowed Values: A valid password for your certificate. Default Value: None
Provisioning Profile	Description: Specifies your provisioning profile for the iOS operating system. To Open this Field: Select iPhone and iPad. Allowed Values: Use the Select File button to select your provisioning profile.
Next	Opens this Screen: Styling tab. Function of this Screen: Specifies the menu color and button color for the custom mobile app.

How do you want your mobile app to look? screen

Specifies the menu color and button color for the custom mobile app.

Fields

Field Name	Definition
Select Styling to be Applied	Description: Specifies a style for the custom mobile app. Allowed Values: Blue - Specifies a blue color for the menus and buttons in the custom mobile app. Violet - Specifies a violet color for the menus and buttons in the custom mobile app. Orange - Specifies an orange color for the menus and buttons in the custom mobile app. Green - Specifies a green color for the menus and buttons in the custom mobile app. Red - Specifies a red color for the menus and buttons in the custom mobile app. Custom - Specifies custom colors for the menus and buttons in the custom mobile app. Default Value: The style specified in Default App Settings > Styling tab.
Next	Opens this Screen: Upload Images tab Function of this Screen: Specifies the branding for an Android custom mobile app.

Field Name

Definition

Select Styling to be Applied

Description:

Specifies a style for the custom mobile app.

Allowed Values:

Blue - Specifies a blue color for the menus and buttons in the custom mobile app.
Violet - Specifies a violet color for the menus and buttons in the custom mobile app.
Orange - Specifies an orange color for the menus and buttons in the custom mobile app.
Green - Specifies a green color for the menus and buttons in the custom mobile app.
Red - Specifies a red color for the menus and buttons in the custom mobile app.
Custom - Specifies custom colors for the menus and buttons in the custom mobile app.

Default Value:

The style specified in Default App Settings > Styling tab.

Opens this Screen:: Upload Images tab
Function of this Screen:: Specifies the branding for an Android custom mobile app.

Do you want to apply your own branding? screen (Android)

Specifies the branding for an Android custom mobile app.

Fields

Field Name	Definition
Logo	Description: Specifies the logo image for the custom mobile app. Allowed Values: To select the logo image, click Upload File. Default Value: The image specified in Default App Settings > Upload Image > Android tab.
Icon	Description: Specifies the icon image for the custom mobile app. Allowed Values: To select the icon image, click Upload File. Default Value: The image specified in Default App Settings > Upload Image > Android tab.
Splash Screen	Description: Specifies the splash screen image for the custom mobile app. Allowed Values: To select the splash screen image, click Upload File. Default Value: The image specified in Default App Settings > Upload Image > Android tab.
Next	Opens this Screen: Build App tab. Function of this Screen: Specifies email addresses to receive a notification when the build is ready for the custom mobile app.

Do you want to apply your own branding? screen (iOS)

Specifies the branding for an iOS custom mobile app.

iOS Upload Images screen — Figure: Do you want to apply your own branding? screen (iOS)

Fields

Field Name	Definition
App Icon	Description: Specifies the icon image for the custom mobile app. Allowed Values: To select the icon image, click Upload File. Default Value: The image specified in Default App Settings > Upload Image > iOS tab.
Logo	Description: Specifies the logo image for the custom mobile app. Allowed Values: To select the logo image, click Upload File. Default Value: The image specified in Default App Settings > Upload Image > iOS tab.
Splash Screen	Description: Specifies the splash screen image for the custom mobile app. Allowed Values: To select the splash screen image, click Upload File. Default Value: The image specified in Default App Settings > Upload Image > iOS tab.
Next	Opens this Screen: Build App tab. Function of this Screen: Specifies email addresses to receive a notification when the build is ready for the custom mobile app.

Who do you want to notify when the build is ready? screen

Specifies email addresses to receive a notification when the build is ready for the custom mobile app.

Fields

Field Name	Definition
Who do you want to notify when the build is ready?	Description: Specifies one or more email addresses to receive a notification when the custom mobile app is complete. Allowed Values: A list of email addresses, separated by commas (,) Default Value: The notification list specified in Default App Settings > Notification List tab.
Clear Notification List	Function: Deletes the list of email addresses from the Who do you want to notify when the build is ready? field.
Save as Draft	Function: Saves the information for custom mobile app as a draft.
Build	Function: Compiles the custom mobile app.