Import command for business glossary assets

Use the istool glossary import command to import your business glossary assets from a file of previously archived assets, or to import a glossary model (*.ndm) file from IBM® InfoSphere® Data Architect.

Command syntax

You must have the Business Glossary Administrator role to import business glossary assets.

You must run the command from a computer on the client tier where IBM InfoSphere Business Glossary is installed.

istool glossary import 
authentication parameters
[generic parameters] 
-filename pathname
[-format XML | XMI | CSV | NDM]
[-mergemethod overwrite | ignore | mergeignore | mergeoverwrite]
[-mappingfile pathname]

Command options

authentication parameters

Specifies connection details for a specific IBM InfoSphere Information Server.

generic parameters

Use the generic parameters to request help on command syntax, or specify silent or verbose operation.

-filename pathname or -f pathname

Specifies the file to import business glossary assets from. If the path name contains space characters, you must enclose the path name in double quotation marks (").

-format XML | XMI | CSV | NDM or -fm XML | XMI | CSV | NDM

Specifies the format of the import file. By default the format is XML.

XML, XMI, and CSV files must contain business glossary content that adheres to the format required by InfoSphere Business Glossary. For more information about format, download the sample files available from the InfoSphere Business Glossary import and export wizard or see Importing and exporting glossary content.

Files imported with the NDM option must be glossary model files (*.ndm) that were created with or imported into IBM InfoSphere Data Architect. The glossaries and words in the glossary model file are converted into InfoSphere Business Glossary categories and terms according to the mapping described in Generating business glossary content from InfoSphere Data Architect glossary models.

Only applies when assets are imported from XML or XMI files. Specifies one of the following merge methods:

overwrite: Specify this option to overwrite assets that exist in the target repository with imported assets.
ignore: This is the default option. Assets that exist in the target repository are not overwritten.
mergeignore: Specify this option to merge the asset and ignore imported attributes that cannot be merged.
mergeoverwrite: Specify this option to merge the asset and overwrite existing attributes that cannot be merged.

-mapping pathname or -map pathname

Applies only when assets are imported from XMI files. Specifies a mapping file to use to modify the imported assets. If the path name contains space characters, you must enclose the pathname in double quotation marks ("). A mapping file enables you to change attributes of exported business glossary content before you import it.

Examples

The following command imports all the business glossary assets contained in the CSV format file named bgexp.csv:

istool glossary import –dom ABC:9080 –u xmetauser –p xmetapwd 
-filename c:\bgexp.csv -format CSV

The following command imports all the business glossary assets contained in the XML format file named bg x imp.xml. If assets with the same name are encountered in the target repository, they are overwritten with the imported assets:

istool glossary import –dom ABC:9080 –u xmetauser –p xmetapwd 
-filename "c:\bg x imp.xml"  -format XML -mergemethod overwrite

The following command imports a glossary model created with InfoSphere Data Architect. It converts the glossary model elements in the file named NDMTest.ndm to InfoSphere Business Glossary categories and terms.

istool glossary import -dom ABC:9080 -u xmetauser -p xmetapwd -format ndm
-f "C:\tmp\NDMTest.ndm"