import custom attribute values command

Purpose

Use this command to import custom attributes values, or when you want to schedule an import. You can edit and import many custom attributes values at the same time rather than editing each custom attribute value.

Requirements

You must have the Information Governance Catalog Information Asset Administrator role.

Information Governance Catalog must be installed on the same IBM® WebSphere® Application Server.

The version of istool command framework must be the same version as InfoSphere® Information Governance Catalog.

Run the command from the client tier, or from the engine tier if InfoSphere Information Governance Catalog was installed there.

Command syntax

The preferred way to run this command is in the istool command-line window. If you run this command in your operating system command-line window or in scripts, you must add istool before the command name.

istool> import custom attribute values 
authentication parameters
-filename import_file
-output log_file_name
[-replace | -force]
[-copy]
[generic parameters] 

Parameters

These parameters are specific to the import custom attribute values command. For authentication parameters and generic parameters, see Common commands and parameters.

-filename | -f import_file

Specifies the name of the document with custom attributes and their values to be imported to the metadata repository.

If the document name has an embedded space, enclose the name in double quotation marks (").

The document must be in a comma-separated value (CSV) format and use valid syntax. If the syntax is not correct, the import fails.

If import_file is a directory path, all CSV files in that directory and in its subdirectories are imported.

-output | -o log_file_name

Specifies the name of the log file that contains the output, including errors, of the command that was run. Include the directory path in log_file_name.

If the directory does not exist, the command fails.

The log file is created if it does not exist. If the log file does exists, the output is appended to the file. If the command is automated to run at different times, the log file displays the ongoing output of each command that was run.

-replace | -r

Replaces the custom attribute values in the metadata repository with the values that are in the import file. However, if the value of the custom attribute in the import file is null, the value in the metadata repository is not overwritten.

If this option is not used, then changes to the custom attributes in the metadata repository are made in the following conditions:

• The existing custom attribute value is null or empty.
• The existing custom attribute value supports multiple values and the specified value in the import file does not exist in the metadata repository.

-force | -fr

Forces the overwrite of existing custom attribute values in the metadata repository with the values that are in the import file. If the value of the custom attribute in the import file is null, the value in the metadata repository is overwritten.

-copy | -c

Copies the custom attribute values to all child assets.

Output

A return value of 0 indicates successful completion; any other value indicates failure. The reason for the failure is displayed in a screen message.