列名が正しくありません

問題の説明

この成果物タイプに対して列名が無効であるか、必須の列が欠落しているが、実際にはファイル内のすべての列の名前が正しく、いずれの必須列も欠落していないというエラーでインポートが失敗します。

回避策

ヘッダーには、スプレッドシートにもテキスト・エディターにも表示されない空白文字が含まれている場合があります。 空白文字は、列名が認識されないようにします。

• 空白文字を表示するエディターを使用してファイルを編集します。
• ヘッダーを削除して、名前を最初から手動で入力してください。
• ファイル・エンコードが UTF-8であり、 UTF-8 BOM などではないことを確認します。

存在しない成果物への関係はスキップされます

問題の説明

2 つの成果物の間に任意の種類の関係を定義すると、インポート・プロセスは成功しますが、存在しない成果物との関係はスキップされます。 関係をスキップすると、次のようなエラーが発生します。

GIM00015E: Artifact Average balance in column Related Terms is not found in the specified hierarchy.

回避策

相互に関係がある複数のタイプの成果物をインポートする場合は、まずすべての成果物をインポートし、インポートした成果物を公開してから、 「すべての値を置換」 マージ方式を使用して同じ CSV ファイルを再度インポートします。 2 番目のインポート・プロセスでは、既存の成果物に関係が追加されます。

カテゴリーが存在しません

問題の説明

成果物の親カテゴリーが CVS ファイルに定義されていない場合、成果物はデフォルトで [カテゴリー化されていない] カテゴリーにインポートされます。 成果物の親カテゴリーが CSV ファイルに定義されているが、環境に存在しない場合、インポートは失敗します。 インポート・プロセスでは、インポートごとに常に 1 つのタイプの成果物のみが作成されます。 カテゴリー以外の成果物をインポートする場合は、親カテゴリーを作成できません。

回避策

CSV ファイルから成果物をインポートする前に、それらをインポートするカテゴリーが環境内に存在することを確認してください。 インポート・プロセスを開始する前に作成してください。

CSV インポート後に成果物が見つかりません

問題の説明

CSV ファイルによってインポートされた成果物は、「公開済み」ページに表示されません。

回避策

成果物が「公開済み」として表示されて使用可能になる前に、それらの成果物を公開する必要があります。 インポートされたカテゴリーに成果物がある場合は、それらのカテゴリーにコラボレーターとしてユーザーを追加する必要がある場合があります。

ZIP インポート後に成果物が見つかりません

問題の説明

ZIP ファイルによってインポートされた成果物は UI には表示されませんが、API 呼び出しでは使用できます。

回避策

ZIP インポート時に wkc-search サービスが ready 状態でなかった可能性があります。 この問題を解決するには、以下のコマンドを使用して再同期します。

curl -X GET "$CPD_URL/v3/glossary_terms/admin/resync?artifact_type=all" -k -H "accept: application/json" -H "Authorization: Bearer $TOKEN"

ZIP インポート・プロセスで重複する成果物が作成される

問題の説明

エクスポートされた ZIP ファイル内の成果物は、成果物の名前とカテゴリー・パスではなく、 Artifact ID 列内の成果物 ID で識別されます。 ただし、定義済みのビジネス用語、データ・クラス、分類の成果物識別子は、IBM Knowledge Catalogのインスタンスごとに異なります。 そのため、インポートされた事前定義成果物は、既存の事前定義成果物と同じであるとは認識されません。 そのため、インポート・プロセスでは、重複する成果物が作成されます。

回避策

• 成果物をインポートする前に、対象のIBM Knowledge Catalogインスタンスから既存の定義済み成果物を削除します。 同じタイプの公開済み成果物の削除を参照してください。

• 事前定義されたデータ・クラスおよび分類の場合:

  1. 成果物をエクスポートして ZIP ファイルを作成する場合は、 [uncategord] カテゴリーを除外します。
  2. データ・クラスおよび分類の CSV ファイルを編集し、 「親の分類」 列および 「親データ・クラス」 列の事前定義データ・クラスおよび分類の成果物 ID を、同等の事前定義成果物の名前およびカテゴリー・パスに置き換えます。
  3. 他の成果物の CSV ファイルを編集し、事前定義されたデータ・クラスおよび分類の成果物 ID を、事前定義された成果物との関係を持つすべての成果物の 「分類」 列および 「データ・クラス」 列内の同等の事前定義された成果物の名前およびカテゴリー・パスに置き換えます。

  成果物をインポートすると、既存のターゲット事前定義成果物との関係が作成されます。

• 定義済みのビジネス用語の場合:

  1. 成果物をエクスポートして ZIP ファイルを作成する場合は、 「Knowledge Accelerator のサンプル個人データ (Knowledge Accelerator Sample Personal Data)」 カテゴリーを除外します。
  2. ビジネス termsa およびその他の成果物の CSV ファイルを編集し、定義済みビジネス用語の成果物 ID を、 「関連用語」 列およびビジネス用語の関係を定義するその他の列内の同等の定義済み成果物の名前およびカテゴリー・パスに置き換えます。

  成果物をインポートすると、既存のターゲット事前定義成果物との関係が作成されます。

Locationsカテゴリの定義済み参照データセットには、すべてのIBM Knowledge Catalogインスタンスで同じアーティファクトID値があるため、回避策は必要ありません。

ZIP からインポートされた事前定義データ・クラスおよび分類への関係が欠落しています

問題の説明

カスタム・プロパティーおよび関係値はインポートされません。

回避策

CSV ファイルを編集し、成果物 ID から成果物の名前およびカテゴリー・パスへの関連する事前定義データ・クラスおよび分類の値を編集してから、再インポートします。

親トピック IBM Knowledge Catalogのトラブルシューティング