Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

With the System Exporter, you can export data from your system into a Configuration Export (ZIP file) or a Workflow Package Export (MZP file).

...

Note!

In Desktop Client, you can also export to a directory.

The export can contain your system's data, configurations, and runtime data. You can send this export data to another system, using the System Importer to import it and embed its contents locally.

...

  • Configuration: Workflow configurations, Profiles, Workflow groups, Ultra formats, alarm detectors, etc.

  • Workflow packages: Workflow Packages are compiled versions of configuration, and are created in the Workflow Package mode in the System Exporter.

  • Execution Context Deployments: Created ECDs can be selected. See Execution Context Deployments (ECDs) (4.03).

Note!

When exporting External References profiles of type Properties Database or Kubernetes Properties the External Reference Values will also be exported. In System Importer it can be selected if they should be imported or not.

Note!

When exporting a Workflow Template with Dynamic Workflow Configuration enabled, the Dynamic Workflows will also be exported. You can specify in the System Importer if they should be imported or not. See Workflows(4.03).

This section describes the following:

...

  1. Configuration: The configurations must be compatible with the software packages of the system to which you import the configurations This is normally not a problem as long as you are using the same release. The export will be downloaded as a ZIP file. See Configuration Export , see https://infozone.atlassian.net/wiki/spaces/UEPE4D/pages/edit-v2/304410231#Configuration-Export-Type.

  2. Workflow Package: Export in Workflow Packages(4.03) format. A Workflow Package is read-only and self-contained, with the same binaries as in the exporting system. A Workflow Package is not affected by, nor will it affect, any existing configurations when imported, since the used binaries are not replaced. When selecting Workflow Package Export Type, you compile a Workflow Package by selecting workflows in the Available Entries table. All dependent configurations will also be selected. See Workflow Package Export.

...

  1. , see https://infozone.atlassian.net/wiki/spaces/UEPE4D/pages/edit-v2/304410231#Workflow-Package-Export-Type .

...

3) to learn how to configure a File System Profile when exporting to Git or AWS S3 Bucket.

...

...

Configuration Export Type

You can export a configuration to your local browser or remote with a File System Profile of type Git or AWS S3. Currently, Git is available in Desktop Online only.

...

  • Configuration: Workflow configurations, agent profiles, workflow groups, Ultra formats, or alarm detectors.

  • Run-time: Some data that is generated by the system during workflow run-time. Clear the Option Exclude Runtime Datacheckbox.

  • System: Other customized parts such as; Data Veracity, Event Category, Folder (structure), Pico Host, Ultra, User, or Workflow Alarm Value.

  • Workflow packages: Workflow Packages are compiled versions of configuration, and are created in the Export type Workflow Package in the System Exporter.

  • Execution Context Deployments: Created Execution Context Deployments (ECDs) (4.03) can be selected.

The following options can be found on the toolbar: 

Option

Description

Export

This will export the selected configuration(s). The behavior is different depending on your choice of Destination. Described in detail below.

Refresh

Refreshes the list of shown configurations. 

Options

This will open the Options menu. Each available option can be toggled by the user. See Configurations Export Type Options

Expand all

Expands all folders in the Available entries section. 

Collapse all

Minimizes all folders in the Available entries section.

Anchor
exportoptions
exportoptions
Configurations Export Type Options

...

The following options can be toggled by the users using the Options menu. 

Export Option

Description

Abort on error

Select this option to abort the export process if an error occurs. If an error occurs and you do not select this option, the export will be completed, but the exported data might contain erroneous components.

note

Note!

Invalid Ultra and APL definitions are considered erroneous and result in aborting the export. 

Select Dependencies

Select this option to have dependencies follow along with the entries that you actively select.

Encryption

Activates encryption on the chosen export.

Exclude Runtime Data

When enabled it excludes locally stored runtime data from the export. The runtime data that can be included is, Aggregation Session Data and Archive data

Export as XML

Exporting configuration objects with this option enabled will create compressed XML files instead of JSON.

Exporting to Local Destination

...

When you click the Export button, the following dialog opens and you need to select a File System (4.03) profile. You can select the File System Profile either as Git or AWS S3.

...

When a profile is selected more fields will appear. When a Git File System Profile is selected it will look like this.

...

Option

Description

Commit message

The message will be visible in the Git log.

Repository/Branch

Read-Only Field, showing the Remote repository name and the branch selected in the profile.

Select Target Folder

A table showing the folders in the current repository, see GIT Support (4.3)

New Folder Button

Create a new folder on the root level.

New Folder Icon on each row

Image Modified

Create a new folder under the selected row

When an AWS S3 File System Profile is selected it will look like this.

...

Option

Description

File Name

The file name of the export. It will automatically become a Zip file.

Select Target

A table showing the folders in AWS S3 Bucket. Select a folder to export to, when no folder or file is selected the export will be uploaded to the top level of the Bucket.

...

...

Workflow Package Export Type

When this type is selected,  Workflow Packages(4.03) can be created and exported as a MZP file. A Workflow Package is read-only and self-contained, with the same binaries as in the exporting system. A Workflow Package is not affected by, nor will it affect, any existing configurations when imported, since the used binaries are not replaced. When the Export Type is Workflow Package you can select data from the following types:

...

When one configuration is selected all dependent configurations will also be selected.

Export Option

Description

Export

The behavior is different depending on your choice of Destination. Described in detail below.

Refresh

Refreshes the list of shown configurations. 

Options

This option is not available in workflow package selection mode. 

Expand all

Expands all folders. 

Collapse all

Collapses all folders.

Exporting to Local Destination

...

  • Package name: The name of the workflow package.

  • Package version: The version of the workflow package.

  • Output option: Only Download is valid when the destination is Remote

  • Select Export Folder: A table showing the folders in AWS S3 Bucket. Select a folder to export to, when no folder is selected the export will be uploaded to Bucket top level.

How To Perform an Export

...

Note!

Since no workflow state, i.e. File Sequence Number, is included in the exported data and only the initial value is exported, you need to take note of information such as file sequence numbers in Collector agents.

  1. Select Export Type, Configuration, or Workflow Package.

  2. Select Destination, Local or Remote

  3. In the System Exporter, select options according to your preferences in the Options dialog.

  4. Expand the folders in Available Entries and select the checkboxes in the Include column for the entries you want to export.

  5. Click the Export button to start the export process or to fill in the information regarding the Remote destination or Workflow Package name.