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
  1. On the Management Console, select the
    Applications
     tab.
    The
    Applications Listing
     page is displayed.
    Applications Tab
  2. Click the Add icon.
    The
    Applications Detail
     page is displayed.
    Applications Detail
  3. 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.
  4. 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.
    Machine to Machine Application Details
  5. Provide a description for the application.
  6. 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.
  7. 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.
    Single Page Application Credentials
    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.
  8. Click
    Copy All
    .
    • Open a text file, paste the client secret, and save the file.
  9. Click
    Close and Go to Listing
    .
    The new application displays under Application Listing.
Provide Feedback
Have questions or feedback about this documentation? Please submit your feedback here.