インポートセットの主要な概念
インスタンスにデータをインポートする前に、インポートセットについて確認してください。
インポートセットテーブルは、データソースからインポートされたレコードのステージング領域として機能します。
変換マップは、インポートセットテーブルに表示されるフィールドと、インシデントテーブルやユーザーテーブルなどの既存の ServiceNow テーブルのフィールドとの関係を決定します。
インポートセットは、インスタンス内のデータがインポートされるデータと一致する場合にレコードをスキップします。
インポートセットの用語
| 用語 | 定義 |
|---|---|
| インポートセットテーブル |
これらのレコードを変換する前に、データソースからインポートされたレコードのステージング場所として機能するテーブル。これらのテーブルのフィールドは、インポートされたデータに基づいて自動的に生成されるため、手動で変更しないでください。 注:
インポートセットテーブルの列は自動的に生成されるため、手動で追加しないでください。列を手動で追加すると、テーブルのスケジュールされたクリーンアップに悪影響を及ぼし、不完全なクリーンアップや孤立したレコードが発生する可能性があります。 インポートセットテーブルに列を追加する必要がある場合は、まず入力データに列を追加してから、[ 20 件のレコードのテストロード ] または [ すべてのレコードのロード] を選択してインポートセットテーブルに列を自動生成します。 インポートセットテーブルの列のタイプが入力データと同じでない可能性があります。たとえば、通貨列は、通貨タイプのターゲットテーブル列に割り当てられるまで、インポートセットテーブルでは文字列列として表すことができます。 |
| データソース | インポートするデータを取得する場所を定義するレコード。データソースは、ファイル、JDBC 互換データベース、または LDAP 組織単位を指すことができます。 |
| 変換 | 変換マップで定義されたルールに基づく、インポートセットテーブルから別のテーブルへのデータの変換。 |
| 変換マップ | インポートセットのフィールドとテーブルのフィールド (インシデントなど) の間の関係を定義するフィールドマップのセット。 変換時中、データは変換マップに基づいてインポートセットテーブルからターゲットテーブルにコピーされます。 単一のインポートセットフィールドを、他のテーブルの複数のフィールドにマッピングすることができます。 |
| 強力なインポートセットトランスフォーマー | データを抽出、変換、および 1 つ以上のターゲットテーブルにロードします。変換機能と処理機能を分離し、変換マップのより柔軟な代替手段を提供します。 |
| 外部レコードの挿入 | 外部レコードの挿入は、インポートによって、そのインポートのターゲットテーブルではないテーブルが変更されたときに発生します。 この変更は、テーブルの参照フィールドを更新するときに発生します。たとえば、インシデントの発信者の値を更新する場合、実際には sys_user テーブルが更新されます。 |
| 結合 | インポートデータを変換するときに、既存のターゲットテーブルレコードを更新できます。 インポートセットレコードを変換するときに [ターゲット] フィールドを使用して結合するかどうかを指定できます。フィールドマップの [結合] オプションが選択されている場合、インポートセット行が変換されると、インスタンスは [ターゲットフィールド] の値がインポートセット行の [ソースフィールド] と同じであるターゲットテーブルの既存のレコードをチェックします。 ターゲットテーブルに一致する値を持つ既存のレコードが見つかった場合、そのレコードが更新されます。一致するレコードが見つからない場合は、ターゲットテーブルに新しいレコードが作成されます。 |
サポートされているインポート形式
いくつかの異なるファイル形式または外部データソースからデータをインポートできます。
| 形式 | 制限事項 |
|---|---|
| CSV | CSV ファイルは、RFC4180 で提案された CSV 標準に準拠する必要があります。特に、これはフィールド内に二重引用符が表示されないことを意味します。インポートされた CSV ファイル内のデータの最初の行がヘッダー行になり、そのインポートセットの列を定義します。 |
| Excel | Excel ファイルには、XLS または XLSX 拡張子が必要です。 |
| XML | XML ファイルには、データ行ごとに一貫した XPath が必要です。 |
| JSON |
|
| カスタム (スクリプトで解析) | カスタム JavaScript を記述して、マップのリストへの入力行を解析できます。 |
ServiceNow® プラットフォームは、次の外部データソースからデータをインポートできます。
| データソース | 制限事項 |
|---|---|
| JDBC | JDBC インポートには有効な変換マップが必要です。一部のネットワーク構成では ServiceNow® MID サーバー が必要です。 |
| LDAP | LDAP インポートには有効な変換マップが必要です。 |
| OIDC | OIDC インポートには有効な変換マップが必要です。 |
| ServiceNow® REST (統合ハブ) | REST インポートには有効な変換マップが必要です。 |
| カスタム (スクリプトでロード) | カスタムインポートには有効な変換マップが必要です。 |
各種のデータソースの詳細については、「データソース」を参照してください。
変換マップと強力なインポートセットトランスフォーマー
変換マップと強力なインポートセットトランスフォーマーの両方がデータを変換します。変換マップは、データをステージングテーブルから宛先ファイルに変換します。強力なインポートセットトランスフォーマーは、ソーステーブルからメッセージリスナーにデータを変換します。データソースに変換マップと強力なインポートセットトランスフォーマーの両方がある場合、システムは変換マップの代わりに強力なインポートセットトランスフォーマーを使用します。
インポートセットスケジュール設定済みクリーンアップ
Import Set Deleter スケジュール設定済みジョブは、毎日深夜に古いインポートセットデータをクリーンアップします。
手順については、「インポートセットを削除する」を参照してください。
インポートセットテーブル削除ツール
- コンピューター
- ユーザー
- 通知
- ロケーション
手順については、「インポートセットテーブルを削除する」を参照してください。