前のトピック: 前提条件の確認次のトピック: レガシー マップ ファイルからの削除インポートの作成


データ ファイルからの削除インポートの作成

削除するデータを含むソース データ ファイル(区切られたテキスト ファイル)を使用して、データを削除できます。 ファイルを選択し、インポート パラメータを設定し、ファイル内のデータを区切る区切り文字(たとえばカンマ)を指定します。

以前の製品リリースのレガシー マップ ファイルを使用して、削除インポートを作成することもできます。 詳細については、「レガシー マップ ファイルから削除インポートを作成する」を参照してください。

次の手順に従ってください:

  1. 管理者として CA APM にログインします。

    重要: このシナリオでは、システム管理者が削除インポートを実行します。 ただし、管理者は Data Importer ユーザ アクセスまたは Data Importer 管理者アクセスを任意の CA APM ユーザ役割へ付与できます。 ユーザ アクセスにより、ユーザはインポートの作成、自分のインポートの変更または削除、別のユーザによって作成されたインポートの表示が可能になります。 管理者アクセスにより、ユーザはインポートの作成、任意のユーザによって作成されたインポートの変更または削除が可能になります。

  2. [管理]-[Data Importer]をクリックします。
  3. [新規インポート]をクリックします。
  4. [基本情報]領域に必要な情報を入力し、必要に応じオプションの情報を提供します。 以下のフィールドについて説明します。
    データ ファイル

    ソース データ ファイルを指定します。

    このファイルが CA APM アプリケーション サーバで利用可能な場合は、データ ファイルを検索および選択します。 このファイルがアプリケーション サーバで利用可能でない場合は、データ ファイルをアップロードします。

    データ ファイルのアップロード

    ローカル サーバ上でソース データ ファイルを参照できます。 このファイルは CA APM アプリケーション サーバにアップロードされます。

    重要: ファイル サイズは、製品の環境設定によって制限されます。 詳細については、管理者または CA サポートにお問い合わせください。

    主なインポート先オブジェクト

    削除インポート用の主なオブジェクトを指定します。

    アセットおよびモデル オブジェクトは、それぞれに対応するファミリと共にリスト表示されます。 [すべてのファミリ]を指定することもできます。 リーガル ドキュメントのオブジェクトは、リーガル テンプレートに従ってリスト表示されます。 [すべてのテンプレート]を指定することもできます。 オブジェクトには、インポートまたは削除できるすべてのオブジェクトが含まれます。

    注: 複数のアセット ファミリ タイプを含むアセットまたはモデル、もしくは複数のリーガル テンプレートを含むリーガル ドキュメントの場合は、このフィールドに以下の選択を使用します。 ソース データ ファイルの各レコードの特定のファミリまたはテンプレートを指定します。

    • アセットでは、[アセット](すべてのファミリ)を選択します。
    • モデルでは、[モデル](すべてのファミリ)を選択します。
    • リーガル ドキュメントでは、[リーガル ドキュメント](すべてのテンプレート)を選択します。

      重要: 必ず正しい主なインポート先オブジェクトを選択してください。 インポートを保存またはコピーした後で主なインポート先オブジェクトを変更することはできません。

    最初の行を列名にする

    ソース データ ファイルの最初の行に列名を含めるかどうかを指定します。 最初の行に列名を含めない場合、名前は「フィールド 1」や「フィールド 2」などの一般的な名前で表示されます。

    テナント

    インポートに適用されるテナントを指定します(マルチテナントを使用している場合)。

    テナントを選択できるのは、CA APM でマルチテナントが有効になっていて、さまざまなテナントにアクセスする権限が与えられているときだけです。 公開データへのアクセス権があり、複数のテナントを持っている場合は、すべてのテナントを選択できます。

    すべてのテナントを指定する場合、ソース データ ファイルには[テナント名]フィールドにマップするテナント名の列が必要です。

    注: 1 つのテナントを指定する場合は、ソース データ ファイル内のすべてのデータが選択したテナントに属していることを確認してください。 複数のテナントのデータがある場合、すべてのテナントのデータが選択したテナントに適用されます。

    データ区切り文字

    ソース データ ファイルで使用した区切り文字(たとえばカンマまたはタブ)を指定します。

    重要: ソース データ ファイル内のデータ値に選択された区切り文字が含まれている場合、データ値を二重引用符で囲む必要があります。 たとえば、会社をインポートする際に区切り文字としてカンマを選択したとします。 また、ソース データ ファイルに Document Management Company, Inc. というデータ値を入力するとします。 この場合、このデータ値を二重引用符で囲みます。

    例: "Document Management Company, Inc"。

    データ ファイルのロケール

    ソース データ ファイルのロケールを選択します。 この設定は、日付および時刻の形式を指定します。

  5. [詳細設定]領域に必要な情報を入力し、必要に応じオプションの情報を提供します。

    以下のフィールドについて説明します。

    最大エラーしきい値(%)

    インポートを停止するためのエラーの回数を定義します。 しきい値は、処理されたレコードのパーセンテージに基づきます。 15 パーセント以上のしきい値を推奨します。

    注: Data Importer は、エラーしきい値に達した場合、計算する前の管理、システム構成、Data Importer([最大バッチ レコード サイズ]フィールド)上で指定されるレコードの数を処理します。

    プライマリ ルックアップ オブジェクト処理タイプ

    インポート アクティビティのタイプを指定します。 以下のいずれかのオプションを選択します。

    プライマリ オブジェクトおよび関連する関係の削除

    プライマリ オブジェクトと、それらに関連付けられているセカンダリ オブジェクトとの関係を削除するには、このオプションを選択します。 たとえば、会社(プライマリ オブジェクト)を削除し、関連付けられているアセット配置(セカンダリ オブジェクト)との関係を削除します。

    このオプションを選択するときは、マッピング ルールでプライマリ オブジェクトだけが指定されていることを確認してください。 セカンダリ オブジェクトのマッピング ルールは一切含めないでください。

    注: プライマリ オブジェクトに関連付けられているセカンダリ オブジェクトは削除されません。 プライマリ オブジェクトとセカンダリ オブジェクトとの関係が削除されます。 たとえば、プライマリ オブジェクト Company1 と、関連付けられている被買収会社 Company2 (セカンダリ オブジェクト)があるとします。 Company1 を削除すると、Company2 に対する関係が削除されます。 セカンダリ オブジェクト Company2 は削除されません。

    関係のみの削除(Delete Relationships Only)

    セカンダリ オブジェクトとそのプライマリ オブジェクトとの関係を削除するには、このオプションを選択します。 このオプションを選択するときは、マッピング ルールでプライマリ オブジェクトとセカンダリ オブジェクトだけが指定されていることを確認してください。 セカンダリ オブジェクトのマッピング ルールを含めますが、そのルールの[プライマリ ルックアップ]チェック ボックスをオンにしないでください。

    注: プライマリ オブジェクトに関連付けられているセカンダリ オブジェクトは削除されません。 プライマリ オブジェクトとセカンダリ オブジェクトとの関係が削除されます。

    正規化の動作

    データを正規化するか、またはデータを正規化せずにログ ファイルにエラー メッセージを書き込むかどうかを指定します。

    注: このフィールドは、正規化ルールを定義している場合にのみ表示されます。

    正規化エラー

    削除するデータ内に正規化できるデータが見つかった場合、エラー メッセージを Data Importer ログ ファイルに書き込みます。 該当のデータは削除されません。 ログ ファイル エラー メッセージには、データに関する詳細が含まれます。

    たとえば、データに会社名 Microsoft が含まれるとします。 作成した会社正規化ルールによって、Microsoft は収集(非権限)値として識別され、Microsoft Corporation が正規化された(権限)値として指定されます。 データの削除時にこのオプションを選択すると、会社名 Microsoft を含むオブジェクトは削除されず、エラー メッセージがログ ファイルに書き込まれます。

    エラーなしで正規化を適用

    正規化ルールを使用して、削除するデータを正規化します。 正規化できるデータが見つかった場合、そのデータは正規化および削除されます。 データに関するエラー メッセージはログ ファイルに書き込まれません。

    たとえば、データに会社名 Microsoft が含まれるとします。 作成した会社の正規化ルールによって、Microsoft は収集(非権限)値として識別され、Microsoft Corporation が正規化された(権限)値として指定されます。 データの削除時にこのオプションを選択すると、会社名 Microsoft を含むオブジェクトは正規化されます。 この例では、会社名が Microsoft Corporation に変更され、関連のあるオブジェクトが削除されます。

  6. [保存]をクリックします。

    削除インポートが保存されます。 ページの[マッピング]、[例外フィルタ]および[スケジュール]領域に入力できるようになりました。

例: データ ファイルからの削除インポートの作成

ミリアム(CA APM システム管理者)は以下のアクションを実行して削除インポートを作成します。

  1. [管理]-[Data Importer]に移動して、[新規インポート]をクリックします。
  2. [データ ファイル]フィールドに「Hardware Deletions.csv」と入力します。

    この CSV ファイルは、ラップトップ削除を含むソース データ ファイルです。

  3. [主なインポート先オブジェクト]には[アセット(ハードウェア)]、および[データ区切り文字]にはカンマを選択します。
  4. [プライマリ ルックアップ オブジェクト処理タイプ]フィールドで[プライマリ オブジェクトおよび関連する関係の削除]を選択して、[保存]をクリックします。