前提条件

CSV ファイルを使用してガバナンス成果物をインポートする前に、正しい形式でファイルを作成し、必要な権限があることを確認してください。

ガバナンス成果物のインポートの準備

ガバナンス成果物をインポートするには、その前に、それらの成果物のインポート・ファイルにリストされているすべてのカテゴリーおよびサブカテゴリーが存在している必要があります。 そうしないと、カテゴリーが未定義の成果物はインポートされません。 詳しくは、 ガバナンス成果物のインポートに関する問題の解決を参照してください。

カテゴリー定義を含む CSV ファイルをインポートするには、その前に上位レベルのカテゴリーが存在している必要があります。ただし、それらのカテゴリーをファイルに定義している場合を除きます。

必要なカテゴリーを作成するには、以下のいずれかの方法を使用できます。

• UI を使用してカテゴリーを作成します。 詳しくは、カテゴリーの管理を参照してください。
• UI を介して 、または API 要求を使用して、CSV ファイルを使用してカテゴリーをインポートします。

インポート・ファイルには、まだインポートしていない他のタイプのガバナンス成果物との関係を含めることができます。 ファイルに定義されている成果物が作成されます。 ただし、存在しない成果物への関係は作成されず、エラー・メッセージを受け取ります。 その他のタイプのガバナンス成果物をインポートして公開した後に、エラーを受け取ったファイルを再度インポートすることで、関係を追加できます。

UI を使用した CSV ファイルのインポート

UI を使用して CSV ファイルをインポートするには、以下のようにします。

1. 必要に応じて、カテゴリーを作成します。 ガバナンス成果物のインポートの準備を参照してください。
2. ナビゲーション・メニューから、 「ガバナンス」 セクションを開き、 「カテゴリー」、 「ビジネス用語」、 「分類」を選択します。 データ・クラス、 「リファレンス・データ」、 「ポリシー」、または 「ルール」。
3. 「追加」 「成果物タイプ」 >「ファイルからインポート」をクリックします。 ボタンが無効になっている場合は、 必要な権限を持っていることを確認してください。
4. CSV ファイルを追加します。
5. 既存の成果物との競合を解決するようにマージ方式を設定します。
   • すべての値を置換
   • 定義済みの値で置換
   • 空の値を置換 : 新規成果物の場合、これらのメソッドのそれぞれが同じ結果を生成します。
6. インポート をクリックします。 インポート・プロセスは非同期的に実行されます。 インポート・ウィンドウを開いたままにしておくと、インポート結果を表示できます。 それ以外の場合は、インポート・ウィンドウを閉じて作業を続行できます。 ただし、インポートが完了しても通知されず、インポート結果にアクセスできません。
7. インポート・プロセスが完了したら、 成果物とカテゴリーを終了します。

API 要求を使用した CSV ファイルのインポート

API 要求では、並列インポート・プロセスを実行するように指定することも、 コンテンツ・タイプ仕様を UTF-8とは異なるエンコードに設定することもできます。

REST API を使用して CSV ファイルをインポートするには、以下のようにします。

1. 必要に応じて、カテゴリーを作成します。 ガバナンス成果物のインポートの準備を参照してください。
2. POST /v3/governance_artifact_types/{artifact_type}/import 要求を提出してください。 照会パラメーターを設定します。
   1. merge option パラメーターを設定して、既存の成果物との競合を解決します。
      • all: すべての値を置換します。
      • specified: 定義済みの値で置換
      • empty: 空の値の置換
   2. オプション。 複数のインポート・プロセスを並行して実行する場合は、 async_mode パラメーターを true に設定します。
   3. 必要に応じて、API 要求にエンコード情報を含めます。 UTF-8以外のエンコードを使用した CSV ファイルのインポートを参照してください。 APIドキュメント指定した CSV ファイルから値をインポートする を参照。 要求が実行依頼されると、応答 (process_id パラメーター) 内にプロセス ID が提供されます。
3. オプション。 応答で指定されたプロセス ID を使用して、インポートの状況を確認できます。 GET /v3/governance_artifact_types/import/status/{process_id} 要求を送信して、インポート・プロセスの状況を返します。 APIドキュメントインポート状況 を参照。
4. インポート・プロセスが完了したら、 成果物とカテゴリーを終了します。

curl -X POST "https://{server}:{port}/v3/governance_artifact_types/{artifact_type}/import?merge_option={merge_option}" -H "accept: application/json" -H "Authorization: $AUTHORIZATION_HEADER" -H "content-type: multipart/form-data" -F "file=@\"./import_glossary.csv\";type=text/csv;charset=windows-1250" -k

成果物とカテゴリーの完成

CSV ファイル内のガバナンス成果物は、ドラフトとしてインポートされ、ワークフローに従います。 ドラフト成果物は、そのタイプのガバナンス成果物のワークフローに従う必要があります。 ドラフトのガバナンス成果物は、それぞれの成果物タイプ (ビジネス用語など) の 「ドラフト」 タブで表示できます。

インポートした成果物を終了するには、以下の手順

1. すべてのタイプの成果物をインポートした後、すべてのドラフト成果物を公開します。 タスク受信トレイ に移動し、公開プロセスを開始します。 成果物を公開するためのアクセス権が必要です。 ガバナンス成果物のワークフローを参照してください。
2. 必要に応じて、 「すべての値を置換 (Replace all values)」 マージ方式を使用して、関係エラーを受け取ったファイルのインポートを再実行します。 次に、更新された成果物を公開します。

カテゴリーはワークフローの対象ではないため、インポートしたカテゴリーは即時に公開されます。 インポートされたカテゴリーには、以下のコラボレーターがあります。

• ユーザーは、 「所有者」 役割を持つ、インポートするすべてのカテゴリーのコラボレーターです。
• 新しい最上位カテゴリーをインポートすると、自分が唯一のコラボレーターになります。
• 既存のカテゴリーにサブカテゴリーをインポートすると、新しいサブカテゴリーは、上位レベルのカテゴリーからすべてのコラボレーターを継承します。

詳しくは、 ガバナンス成果物のインポートに関する問題の解決を参照してください。

インポートしたカテゴリーを終了するには、新しいカテゴリーに他のコラボレーターを追加します。 インポートされたカテゴリーに 「パブリック・アクセス」 グループを追加すると、そのグループには、 「ビューアー」 役割ではなく、デフォルトで 「エディター」 カテゴリー役割が割り当てられます。この役割は、カテゴリーを手動で作成するときにこのグループに割り当てられます。

「 カテゴリー・コラボレーターの管理」を参照してください。

もっと見る

• ガバナンス成果物をインポートするための CSV ファイル・フォーマット

親トピック: ガバナンス成果物のインポート・メソッド