Mobile QR Code Configuration screen

Lets users who have access rights for the Settings module configure the QR code for Android and iOS mobile apps.

The users with Settings module access rights can specify the mobile settings in a centralized location in the AgilePoint NX Portal and then create a QR code based on those settings. The QR code can be scanned by mobile app users to configure their apps without requiring technical details or authentication configuration.

Background and Setup

Video: Configure the Out-of-the-Box Mobile App

Prerequisites

Good to Know

How to Start

  1. Click Settings.

    Settings
  2. Click Mobile > QR Code Configuration.

    QR Code Configuration screen

Mobile QR Code Configuration screen

Configures the QR code for Android and iOS mobile apps.

Figure: Mobile QR Code Configuration screen

Mobile QR Code Configuration screen

Good to Know

  • 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 NameDefinition

Server Instance URL (REST)
Description:
Shows the REST URL for your AgilePoint Server instance.

This field completes by default. However, you can edit this field if you set up proxy server or gateway server because the server URL is different in this case.

For more information, refer to Find Your AgilePoint Service URL in AgilePoint NX.

Allowed Values:
[Your AgilePoint NX Portal URL]/AgilePointServer
Default Value:
http://hostname/AgilePointServer

Default Language
Description:
Specifies the default language to use for the AgilePoint NX mobile app.
Allowed Values:
A language from the list.
Default Value:
English

Default Screen
Description:
Specifies the default view for the mobile app.
Allowed Values:
  • My Apps - Shows a list of eForms applications published for your use.
  • My Task - Shows a list of all of the tasks assigned to you.
  • Team Tasks - Shows a list of all of the tasks assigned to your team.
  • Outbox - Shows a list of eForms and tasks that have been submitted in offline mode. These forms are synchronized with the AgilePoint NX system once the mobile app is online..
  • Home - Shows a summary of tasks, processes, and apps.
Default Value:
Home
Limitations:

Clear Authentication Details In Manual Configuration Mode
Description:
Specifies whether the AgilePoint NX Mobile App shows the configuration settings for the authentication provider on the Settings screen in manual configuration mode.
Allowed Values:
  • On - The AgilePoint NX Mobile App does not show the configuration settings for an authentication provider on the Settings screen.

    After the Mobile App is configured with a QR code, when the mobile app user opens the Settings screen in manual configuration mode, the configuration fields for an authentication provider do not show a value.

    By default, this field is turned on for security reasons.

  • Off - The AgilePoint NX Mobile App shows the configuration settings for the authentication provider when the mobile app user opens the Settings screen in the manual configuration mode.
Default Value:
On
Limitations:

This field is available in these releases:

Enable Logs
Description:
Specifies whether to create log files on the Android mobile device.
Allowed Values:
  • On - Creates log files on the Android mobile device.
  • Off - Disables log files on the Android mobile device.
Default Value:
Off

Select Authentication Providers For Your Mobile App
Description:
Specifies the authentication providers for the AgilePoint NX mobile app.

The authentication types can change based on the AgilePoint NX configuration.

For information about configuring the authentication providers, refer to Authentication.

Allowed Values:

These authentication types are available in AgilePoint NX OnDemand, AgilePoint NX PrivateCloud, or AgilePoint NX OnPremises:

  • AgilePoint ID
  • Active Directory
  • Microsoft Azure Active Directory / Microsoft 365
  • Microsoft Azure Active Directory / Microsoft 365 (China)
  • Google Workspace
  • Salesforce

These authentication types are available in AgilePoint NX PrivateCloud or AgilePoint NX OnPremises only:

  • Amazon Cognito
  • IdentityServer
  • Okta
  • PingFederate
Default Value:
AgilePoint ID
Limitations:

Generate
Description:
Creates and shows the QR code based on the configuration.

Delete
Description:
Deletes the QR code.

Reset
Description:
Deletes your changes and sets the QR code configuration back to the most recently saved QR code configuration.

This field is enabled if you change any value after generating the QR code.

AgilePoint ID

Configures AgilePoint NX account authentication for the mobile app.

Figure: AgilePoint ID Configuration screen

AgilePoint ID Configuration screen

Fields

Field NameDefinition

Use JWT Authentication
Description:
Specifies whether to use JSON Web Token (JWT) for AgilePoint NX account authentication as an alternative to the basic authentication.
To Open this Field:
  1. Click AgilePoint ID.
Allowed Values:
  • On - Specifies JWT authentication for AgilePoint ID authentication.
  • Off - Specifies basic authentication for AgilePoint ID authentication.
Default Value:
Off
Limitations:
This field is available in these releases:

Audience URL
Description:
Specifies the AgilePoint Portal Instance URL.

This field completes by default.

To Open this Field:
  1. Click AgilePoint ID.
  2. Turn on Use JWT Authentication.
Allowed Values:
AgilePoint NX Portal Instance URL.

For more information, refer to Find your Portal Instance URL.

Default Value:
None
Limitations:
This field is available in these releases: