ION Connect import and export

Use ION to import and export ION entities for migration, backup, and configuration reuse.

You can use import and export to:

  • Import ION content delivered by Infor.
  • Copy ION content between ION installations, for example from a test environment to a production environment.
  • Create a backup of your configuration and restore a previous version.
  • Import models from a previous ION release.

You can import and export one or more entities such as connection points or mappings. You can also export and import a complete parent entity as a data flow, including all child connection points and mappings.

File formats

The output of an export operation from most ION entities is an XML file. For custom document definitions, the output is a ZIP file.

Active and inactive status

Status information is not included in the import and export procedure. When you export an active model, the model is not automatically active after import.

Secret properties

ION classifies a connection point property as a secret property when the key name, case-insensitive, matches or ends with one of these identifiers:

  • password
  • serviceAccount
  • accessKey
  • secretKey

For example, a property named dbPassword or apiSecretKey is classified as a secret property because the key ends with a recognized identifier.

Service accounts

When you export a connection point, Service Account credentials are replaced with [PASSWORD] in the export file. The export file does not contain original credential values, whether plain text or encrypted.

You cannot use Service Account credentials from an export file as working credentials. After import, configure or confirm Service Account credentials in the target environment before you activate the connection point. For more information, see Service Account value format for import.

Export handling of secret properties

When you export a connection point that includes connection properties:

  • Service Account properties with a non-null value are replaced with [PASSWORD] in the export file. The original value is not included.
  • Other secret properties with a non-null value are not included in the export.
  • Secret properties with a null value are omitted from the export.
  • Non-secret properties are exported unchanged.

The export file can be used as a configuration template without exposing credentials. Before you import the file into another environment, replace the [PASSWORD] values with the required plain-text credentials.