Import an Application

Steps to import an application in the latest version of Operations Hub.

About this task

When you import an application, a copy of the application and its components (that is, plug-ins, pages, entities, queries, events, themes, and settings) is created. If an application or a component with the same name exists in the current site, then a system-generated number is appended to the name of the imported application or component. However, if a plug-in with the same name exists, the plug-in is not imported. Instead, the plug-in that already exists in the site is used in the application.

For steps to import applications in the Operations Hub classic version, refer to Import an Application (Classic).

Before you begin

Export the application that you want to import. To avoid compatibility issues, applications termed as 'legacy' are not supported for import.

Procedure

  1. Log in to Configuration Hub.
  2. On the navigation panel, select Operations Hub > Applications.
    The existing list of applications appear.
  3. On the toolbar, select the import icon.
    An import confirmation message appears.
  4. Optional: If you prefer not to import the data configuration associated with the App(s), then select the Exclude the model check box.
  5. Select Import to navigate your local system.
  6. Locate and choose the application artifact (.zip file) you want to import, then select Open.
    Important: To avoid system related errors, do not modify original exported artifact and repackage them for import.
  7. If the application being imported already exists in Operations Hub with the same name, a Confirm screen appears to resolve the import conflict. Select one of the following:
    Duplicate Creates a duplicate copy of the application and imports to Operations Hub.
    Replace Deletes the existing application in Operations Hub and replaces with the one from the import file.

    It is possible that some conflicting items (query, data source, entity, theme, etc.) detected during application import may have the same name but a different configuration.

    If duplicate data source records are found, you may be asked to confirm before importing the file to Operations Hub. Refer to Handling Duplicate OPC UA Data Sources.

  8. If the system detects that the imported application has widgets/plug-ins eligible for upgrades, then they are automatically updated to their latest versions. See Configure Plug-in Upgrades.

Results

A copy of the selected application is created. The Pages workspace appears, displaying a list of pages copied from the original application.

Import an Application (Classic)

Steps to import an application in the Operations Hub classic version.

About this task

When you import an application, a copy of the application and its components (that is, plug-ins, pages, entities, queries, events, themes, and settings) is created. If an application or a component with the same name exists in the current site, then a system-generated number is appended to the name of the imported application or component. However, if a plug-in with the same name exists, the plug-in is not imported. Instead, the plug-in that already exists in the site is used in the application.

For steps to import applications in the latest version of Operations Hub, refer to Import an Application.

Before you begin

Export the application that you want to import. Default applications are excluded from the import operation.

Procedure

  1. In the main navigation menu, select APPS.
    The APPS workspace appears.

  2. Select Import App.
    A message appears, indicating that if there is already an application or a component with the same name, the imported application or component will contain a new name.
  3. Proceed to import the application.
  4. Navigate to the application artifact (.zip file) that you want to import, then select Open.
    Important: To avoid system related errors, do not modify original exported zip files and repackage them for import.
  5. If the application being imported already exists in Operations Hub with the same name, a Confirm screen appears to resolve the import conflict. Select one of the following:
    Duplicate Creates a duplicate copy of the application and imports to Operations Hub.
    Replace Deletes the existing application in Operations Hub and replaces with the one from the import file.

    It is possible that some conflicting items (query, data source, entity, theme, etc.) detected during application import may have the same name but a different configuration.

    If duplicate data source records are found, you may be asked to confirm before importing the file to Operations Hub. Refer to Handling Duplicate OPC UA Data Sources.

  6. If the system detects that the imported application has widgets/plug-ins eligible for upgrades, then they are automatically updated to their latest versions. See Configure Plug-in Upgrades.

Results

A copy of the selected application is created. The Pages workspace appears, displaying a list of pages copied from the original application.