Generic import procedure

Use this procedure to import a file that contains one or more ION entities.

Importing entities

Import entities into the target environment from an import file.

  1. Open the menu and select the required option.
  2. Navigate to the entity page for the models to import.
  3. Click Import.
    A dialog box opens where you can locate and select the file.
  4. Select the file to import.
  5. If the import file contains entities that already exist in ION, select how to handle duplicates.
    • Skip existing models. Existing entities are not imported. Unique entities are imported.
    • Rename duplicates. Existing entities are imported with a unique name. The suffix _# is added to the original name.
  6. Click OK.
    The entities from the file are imported.
  7. If the import includes connection points with secret properties that were skipped during import, configure these properties manually in the target environment before activating the connection point.

Import handling of secret properties

During import, ION evaluates each secret property value and applies these rules:

Value in import file Import behavior
Plain-text credential Imported and applied to the connection point.
[PASSWORD] Skipped. The property is not imported.
Encrypted value Skipped. The property is not imported.
Null or empty value Skipped. The property is not imported.

Non-secret properties are imported regardless of their value.

Note: 

Exports created in earlier releases can contain encrypted credentials. During import, encrypted credentials are skipped and must be configured manually in the target environment.

Service Account value format for import

The Service Account file contains four values: Access Key, Secret Key, Description, and User Name.

The encrypted credentials no longer form part of the export.

During export, Service Account credentials are replaced with [PASSWORD] in the export file.

During import, placeholder and encrypted values are excluded. To import Service Account credentials, specify these values in the serviceAccount ConnectionPointProperties as plain-text values.

Use this format:

  • The value consists of two lines:
    • Line 1: Access Key, Secret Key, Description, User Name
    • Line 2: values in double quotation marks, separated by commas
  • In API JSON, line break is \n and quotes are escaped as \".

Examples

Using import file in ION:

<ConnectionPointProperties>
					<ConnectionPointProperty>
					<Name>serviceAccount</Name>
					<Value>Access Key, Secret Key, Description, User Name
					"Access Key","Secret Key","Description","User Name"</Value>
					<Required>true</Required>
					<Encrypted>false</Encrypted>
					</ConnectionPointProperty>
					</ConnectionPointProperties>

Using ION API:

"connectionPointProperties": [
					{
					"name": "serviceAccount",
					"value": "Access Key, Secret Key, Description, User Name\n\"Access Key\",\"Secret Key\",\"Description\",\"User Name\"",
					"required": true,
					"encrypted": false
					}
					]