ServiceNowのREST連携、インポートセット、変換マップ
ServiceNowのREST APIで外部と連携するとき、受け取った行はまずインポートセット(import set)に置かれ、変換マップがそれを対象のレコードに書き込みます。変換マップは、元の項目と対象の項目を結び付けます。coalesceのキーは、重複を作らずに更新すべき既存のレコードを見分けます。
ServiceNowのインポートセットの考え方とImport Set API(どちらも英語)が、これらの別々の部品を説明しています。
対応付けの例
架空の連携元が、表示名を変えた機器asset-204を送ってきたとします。既存の機器を見つけるには、変わらない元のIDを使います。表示名だけで対応付けると、同じ機器のレコードがもう1つできることがあります。反対に、一意でない部署名をキーにすると、関係のない機器がまとめられてしまいます。
変換の結果と、対象のレコードを確かめてください。HTTPの成功だけでは、参照が解決されたことも、すべての行が変換されたことも、意図したレコードが変わったことも証明できません。
練習の範囲
ServiceNowのコースは、RESTとインポートの判断を、架空の手元のデータで再現します。実際のインスタンスに接続したり、接続の認証情報を保存したり、インフラを検出したりはしません。続けてインポートセットと変換マップと倉庫のサービス運用の引き継ぎのプロジェクトを練習してください。