UI から、シングル・カテゴリーから一度に 1 つのタイプの成果物をエクスポートできます。 IBM Knowledge Catalog API を使用して、タイプのすべてのガバナンス成果物をエクスポートできます。 情報は CSV ファイルにエクスポートされ、デフォルトのダウンロード・フォルダーに書き込まれます。 デフォルトのファイル名は <category_name>-<artifact_type>-csv-export.csvです。 このファイルは、カタログの外部で変更し、後でインポートすることができます。
カテゴリーのエクスポートについては、 カテゴリーのインポートまたはエクスポートを参照してください。
カテゴリーからのガバナンス成果物のエクスポート
カテゴリーから、またはカテゴリーとサブカテゴリーからは、一度に 1 つのタイプのガバナンス成果物をエクスポートできます。 カテゴリーまたはそのサブカテゴリーへの 1 次関係を持つ成果物のみがエクスポートされます。
- 必要な権限
- 成果物タイプをエクスポートするには、カテゴリー内で少なくとも ビューアー 役割を持つコラボレーター、または成果物タイプをエクスポートする権限を持つカスタム役割を持つコラボレーターである必要があります。
1 つのタイプのガバナンス成果物をカテゴリーからエクスポートするには、以下のようにします。
「ガバナンス」> 「カテゴリー」を選択してください。
カテゴリー名をクリックして開きます。
「エクスポート」をクリックします。
エクスポートするガバナンス成果物のタイプを選択します。
タイプごとに最大 400 個のガバナンス成果物をエクスポートできます。
オプション。 現行カテゴリーのサブカテゴリーから成果物をエクスポートする場合に選択します。
サブカテゴリーのエクスポートを選択する場合、現在のカテゴリーをエクスポートに含めるオプションもあります。 デフォルトでは、現在のカテゴリーは含まれません。 カテゴリー階層全体 (ツリー内のカテゴリーとすべてのサブカテゴリー) をエクスポートするには、両方のチェック・ボックスにマークを付けます。 すべてのルート・カテゴリーを一度にエクスポートするには、 カテゴリーのインポートまたはエクスポートを参照してください。
「エクスポート」をクリックします。
ご使用のコンピューターに CSV ファイルがダウンロードされます。 エクスポート・ファイルの構造は、インポート・ファイルと同じです。 ファインポート CSV イルの形式を参照してください。 システムのデフォルトのカテゴリー [uncategorized] をエクスポートする場合、エクスポートした CSV ファイルには、選択したタイプのガバナンス成果物のカテゴリー名は含まれません。
1 つのタイプのすべてのガバナンス成果物を同時にエクスポート
REST API を使用して、選択したタイプのガバナンス成果物を最大 400 個エクスポートできます。 GET /v3/governance_artifact_types/{artifact_type}/export 要求を提出してください。 {artifact_type} を、エクスポートしたい成果物タイプに置き換えます。 選択したタイプの成果物をすべてのカテゴリーからエクスポートするには、 category_id フィールドを空のままに残してください。 詳しくは、API の資料を参照してください。
- 必要な権限
- すべてのカテゴリーに対する ビューアー 以上の役割を持つコラボレーター、または成果物タイプをエクスポートする権限を持つカスタム役割を持つコラボレーターである必要があります。
ZIP ファイルへのすべてのガバナンス成果物のエクスポート
REST API を使用して、すべてのガバナンス成果物を単一の ZIP ファイルにエクスポートできます。 この種のエクスポートを使用して、すべてのガバナンス・アーティファクトをIBM Knowledge Catalogサービス・インスタンスから別のインスタンスに移動します。 ZIP ファイルには各成果物タイプのフォルダーが含まれ、各フォルダーには成果物を含む CSV ファイルが含まれます。 すべての成果物タイプをエクスポートすることも、選択したタイプのみをエクスポートすることもできます。 エクスポートできるガバナンス成果物の最大数は 400 です。 この方法では、カテゴリー役割を持つカテゴリー・コラボレーターをエクスポートおよびインポートすることもできます。
GET /v3/governance_artifact_types/export 要求を提出してください。 インポートには成果物 ID の値が必要であるため、 artifact_id_mode フィールドでは、デフォルト値 alwaysを残ったままにします。 詳しくは、API の資料を参照してください。
- 必要な権限
- 管理者 サービス役割を持っている必要があります。
セキュリティーに関する考慮事項
CSV ファイルにエクスポートされたガバナンス・データは、既知の CSV インジェクション攻撃に対してサニタイズされ、CSV データを自動的に解釈するスプレッドシート・プログラムにとって安全です。 結果として、以下のいずれかの文字で始まるテキスト値。
- 等しい (=)
- プラス (+)
- マイナス (-)
- 時刻 (@)
単一引用符文字 (') が接頭部として付きます。 機能を一貫性のあるものにするために、インポートされた CSV ファイルは追加で解析され、単一引用文字 (') が自動的に削除されます。 CSV ファイルが含まれているため、ガバナンス成果物を ZIP ファイルにインポートおよびエクスポートする場合にもサニタイズが適用されます。
この機能を無効にするには:
IBM Knowledge CatalogGlossary Service の展開を編集します：
oc edit deployment wkc-glossary-service環境変数
ESCAPE_FORMULAS_IN_CSV_FILESを値falseに設定します。
詳しくは、 CSV 注入を参照してください。
もっと見る
親トピック: ガバナンス成果物の管理