Register Application

You can register applications in FactoryTalk DataMosaix. DataMosaix allows you to register applications and generate credentials. The registered applications can be used to visualize data from FactoryTalk DataMosaix.

You can register an application as a Single Page Application or a Machine-to-Machine Application.

You can use a Single Page Application when you have the application URL (callback URL) which can be used to redirect. A client secret is not generated in case of a Single Page Application.

In case you want to generate a token, use the machine-to-machine option. While registering a machine-to-machine application, a client secret is generated. Using the client ID and client secret, you can generate a token to establish the connection using Auth0.

The following table provides information which application type to choose for configuring visualization application with FactoryTalk DataMosaix

FactoryTalk DataMosaix Application Type Compatibility
Single Page Application	Machine to Machine
Power BI	Grafana Jupyter notebook

On the Management Console, select the Applications
tab.

The Applications list displays.

Click the [Add] icon.

The Applications Detail
screen displays.

Provide a unique and meaningful name for your application. The Application Name works as the identifier for your application. You can search for an application with the App Name. By default, FactoryTalk DataMosaix populates an application name.

Application Name example: APP_1206230756_createproject_v1.

Here, APP stands for application, 120623 is the date in ddmmyy format, 0756 is the timestamp in hhmm format, and createproject_v1 is the project in which you are currently working. You can use the default App Name or create your own.

Select the appropriate application type. If you select the Single Page Application type, you must provide the application URL (callback URL).

NOTE: For registering Power BI based Single Page Applications use https://ftdatamosaix-prod.fusion.cognite.com as the application URL (callback URL).

In case of a Machine to Machine application you do not need to provide the URL. While generating credentials you will get a client ID and client secret to generate token.

Provide a description for the application.

From the Associated Roles drop-down list, select at least one role. You can refer to various roles and capabilities by clicking [Role Reference].

NOTE:

The Associated Roles drop-down is visible and available only:

Project Admin users or users within the Organization with a Project Admin role assigned.

When you select the application type as Machine to Machine.

You can select multiple roles from the Associated Roles drop-down list. In the search bar, you can search for any specific role from the list. If you want to apply all the roles to the application, select the [Select All] check box.

Click [Save and Create Credentials] to register the application.

The Credentials and other info
dialog box displays the client secret information.

In case of a Single Page Application, you get the following response.

In case of a Machine to Machine application, you get the following response.

Machine to Machine Application Credentials

NOTE: It is important to copy and save the credentials in a file immediately for future use. Once you close the Credentials and other info
dialog box, this information cannot be viewed later. If you fail to save the client secret information, you will have to regenerate the secret.

Copy the credentials and insert them in the application for it to connect to FactoryTalk DataMosaix.

Click [Copy All].

Open a text file, paste the client secret, and save the file.

Click [Close and Go to Listing].

The new application displays under Application Listing.

Applications

Provide Feedback

Have questions or feedback about this documentation? Please submit your feedback here.