ServiceNowをデータパイプラインソースとして設定 ​

ServiceNowをデータパイプラインソースとして設定し、レコードを抽出して宛先に同期します。 このガイドには、コネクションのセットアップ、パイプライン設定、サポート対象オブジェクト、同期動作、既知の制限事項が含まれています。

WorkatoはServiceNow REST Table API v2を使用して、標準ITSMテーブル、CMDBテーブル、カスタムテーブルなど、アクセス可能な任意のServiceNowテーブルからデータを抽出して同期します。

サポートされている機能 ​

ServiceNowをデータパイプラインソースとして使用する場合、次の機能がサポートされます。

前提条件 ​

ServiceNowをデータパイプラインソースとして接続する前に、次の要件を満たしてください。

ServiceNowインスタンスの要件 ​

• Istanbulリリース以降を実行しているServiceNowインスタンス（OAuth 2.0認証に必要）。
• OAuth認証を使用する予定の場合、インスタンスでOAuth 2.0プラグイン（com.snc.platform.security.oauth）が有効化されていること。 有効化を確認するには、ServiceNow管理者に連絡してください。
• OAuth認証を使用する予定の場合、Application Registryに外部クライアント用OAuth APIエンドポイントが登録されていること。 セットアップ手順については、ServiceNowでOAuthアプリケーションを登録するを参照してください。

サービスアカウントの要件 ​

データパイプライン専用のサービスアカウントを作成します。 アカウントではREST APIアクセスを有効にし、同期されるすべてのレコードで一貫したタイムスタンプ処理を確保するために、アカウントのタイムゾーンをUTCに設定する必要があります。

ロールと権限 ​

コネクターが機能するには、サービスアカウントに次のシステムテーブルへの読み取りアクセスが必要です。

サービスアカウントには、パイプラインで同期する予定のすべてのテーブルへの読み取りアクセスも必要です。

adminなどの一部のベースシステムロールには、これらすべてのテーブルへのアクセスが含まれています。 詳細については、ServiceNowのBase system rolesページを参照してください。 ベースシステムロールを使用する予定がない場合は、必要最小限のアクセス権を持つカスタムロールを作成します。

カスタムロールの作成 ​

組織が連携アカウントに広範な管理者アクセスを許可していない場合は、データパイプラインに必要な最小限のアクセス権を持つカスタムロールを作成します。

サポートされるコネクションタイプ ​

WorkatoはServiceNowデータパイプラインに対して、次の認証方式をサポートしています。

• ユーザー名/パスワード: ServiceNowログイン資格情報で接続します。 OAuth設定は不要です。
• OAuth 2.0（Authorization Code Grant）: プロダクションでの使用に推奨されます。 インスタンスにOAuth 2.0プラグインが必要です。 ブラウザーベースのフローで認証し、Workatoがトークン更新を自動的に管理します。
• OAuth 2.0（Password Grant）: サービスアカウントおよびヘッドレス連携向けの代替OAuthフローです。 Client ID、Client secret、Username、Passwordを直接指定します。 対話型ブラウザー認証が実用的でない場合に適しています。

OAuth方式では、ServiceNowでOAuthアプリケーションを登録し、コネクションのセットアップ中にClient IDとClient secretを指定する必要があります。 ユーザー名/パスワード認証では、OAuth設定は不要です。

ServiceNowでOAuthアプリケーションを登録する ​

Workatoに接続する前に、ServiceNowインスタンスで外部クライアント用OAuth APIエンドポイントを作成します。 詳細な手順については、ServiceNow OAuthセットアップドキュメントを参照してください。

アプリケーションを登録するときに、Redirect URLをhttps://www.workato.com/oauth/callbackに設定します。

アプリケーションを登録したら、アプリケーションレコードからClient IDとClient secretの値をコピーします。 これらは安全に保管してください。 Workatoコネクションのセットアップ中にこれらを指定する必要があります。

コネクション設定 ​

ServiceNowをデータパイプラインソースとして接続するには、次の手順を完了します。

パイプラインの設定 ​

ServiceNowをデータパイプラインソースとして設定するには、次の手順を完了します。

[minute] [hour] [day of month] [month] [day of week]

0 8 * * *

サポートされるオブジェクト ​

ServiceNowはすべてのデータをREST Table APIからアクセス可能なテーブルに保存します。 パイプラインは、サービスアカウントからアクセス可能な任意のテーブルの同期をサポートします。 これには、標準ITSMテーブル、CMDBテーブル、HRテーブル、カスタムテーブル、アプリケーションスコープテーブルが含まれます。 一般的なServiceNowインスタンスでは1,000を超えるテーブルが公開されますが、正確な数はインストールされているモジュールによって異なります。

Workatoは、コネクションのセットアップ時にServiceNowシステムディクショナリテーブル（sys_db_object, sys_dictionary）にクエリを実行し、使用可能なテーブルを動的に検出します。

オブジェクトウィザードに特定のテーブルが表示されない場合は、サービスアカウントにそのテーブルへの読み取りアクセスがあること、および関連するServiceNowモジュールがインスタンスにインストールされていることを確認してください。

次の表に、一般的に同期されるServiceNowオブジェクトを示します。 すべてのカスタムオブジェクト（u_*プレフィックス）とアプリケーションスコープオブジェクト（x_*プレフィックス）も、動的スキーマ検出によってサポートされます。

ITSMとタスク管理 ​

次のオブジェクトは、インシデント、問題、変更管理などのITサービス管理ワークフローをサポートします。 "Extends task"とマークされたオブジェクトは、Class Table Inheritanceを通じてtask親テーブルから列を継承します。

ユーザーと組織 ​

次のオブジェクトは、ユーザーアカウント、グループ、組織構造、ロケーションデータを保存します。 これらのオブジェクトは、宛先でのJOIN操作の参照先として一般的に使用されます。

CMDB ​

次のオブジェクトは、Configuration Management Database（CMDB）レコードを保存します。 cmdb_ciテーブルはCIクラス階層のルートです。 他のすべてのCIオブジェクトは、Class Table Inheritanceを通じてこれを拡張します。

サービスカタログとナレッジ ​

次のオブジェクトは、サービスカタログ定義とナレッジベースコンテンツを保存します。

HRとアセット管理 ​

次のオブジェクトは、HRケース管理、ITアセット追跡、契約管理をサポートします。 HRオブジェクトには、HR Service Deliveryモジュールが必要です。

ワークフロー ​

次のオブジェクトは、ServiceNow内のワークフロー実行履歴を追跡します。

メトリクス ​

次のオブジェクトは、SLAおよびOLA測定に使用されるメトリクス追跡データを保存します。

システムおよび監査テーブル ​

次のテーブルは、アクティビティログ、メールレコード、監査証跡などのシステムレベルデータを保存します。

これらのテーブルはレコード量が非常に多い傾向があり、同期時間とAPI利用状況を大幅に増加させる可能性があります。

カスタムおよびアプリケーションスコープテーブル ​

すべてのカスタムテーブル（u_プレフィックスを持つテーブル）とアプリケーションスコープテーブル（x_プレフィックスを持つテーブル）を検出できます。 Workatoは、sys_updated_on列またはsys_created_on列が存在するかどうかに基づいて、各カスタムテーブルの同期モードを自動的に決定します。

同期モード ​

ServiceNowデータパイプラインは、増分同期、完全更新、削除追跡をサポートします。 コネクターは、ソーステーブルで使用可能な列に基づいて、各オブジェクトの同期モードを自動的に決定します。

増分同期 ​

増分同期では、各パイプライン実行時に新規および更新済みのレコードのみを抽出します。 ほとんどのServiceNowオブジェクトは、sys_updated_on列を増分同期キーとして使用します。

sys_created_onはあるがsys_updated_onがないオブジェクトは、追加専用の増分同期をサポートします。 パイプラインは新規レコードを取得しますが、既存レコードの更新は検出しません。 sys_journal_fieldオブジェクトとsys_emailオブジェクトは、作成後にレコードが不変であるため、このモードを使用します。

完全更新 ​

完全更新では、パイプラインを実行するたびにソースオブジェクトからすべてのレコードを抽出し、sys_idで並べ替えます。 sys_updated_on列とsys_created_on列の両方がないオブジェクトには、完全更新を使用します。 コネクターはこのモードを自動的に割り当てます。

ローテーション済みテーブル ​

ServiceNowは高ボリュームシステムテーブルにテーブルローテーションを使用します。 パイプラインはsys_table_rotationシステムテーブルを通じてローテーション済みテーブルを検出し、ローテーション済みレコードは作成後に不変であるため、sys_updated_onではなくsys_created_onを増分同期カーソルとして使用します。

削除追跡 ​

削除追跡は、ソースから削除されたレコードを検出し、宛先に削除マーカー行を出力します。 このモードは、sys_updated_onを増分同期キーとして使用するオブジェクトで使用できます。 ローテーション済みオブジェクトと追加専用オブジェクトは、このリリースでは削除追跡をサポートしていません。

各削除マーカー行には、sys_id、trueに設定された_workato_is_deleted、削除タイムスタンプに設定されたsys_updated_onが含まれます。 その他のすべてのフィールドはnullです。 削除追跡には、サービスアカウントにsys_audit_deleteへの読み取りアクセスが必要です。

Class Table Inheritance ​

ServiceNowは、子テーブルが親テーブルを拡張するClass Table Inheritance（CTI）を使用します。 たとえば、incident、problem、change_requestテーブルはいずれもtask親テーブルを拡張します。 incident内のレコードはtaskにも存在します。

継承列モード ​

継承列モードが有効な場合、パイプラインは親テーブル列を子テーブルに同期し、各子テーブルに完全なレコードが含まれるようにします。 データの重複を防ぐため、子テーブルに属するレコードは親テーブルから除外されます。 各レコードのsys_class_nameフィールドは、そのレコードが属する子テーブルを識別します。

継承列モードが無効な場合、子テーブルには独自の列のみが含まれます。 継承列モードが無効な場合、親テーブルには子テーブルのレコードを含むすべてのレコードが含まれます。 これにより、子テーブルでは部分的なレコードが、親テーブルと子テーブル全体では重複レコードが発生します。

主な継承階層は次のとおりです。

• taskはincident、problem、change_request、sc_request、sc_req_item、sc_task、sn_hr_core_caseの親です
• cmdb_ciはcmdb_ci_server、cmdb_ci_computer、cmdb_ci_service、cmdb_ci_app_server、cmdb_ci_databaseの親です
• alm_assetはalm_hardware、alm_consumable、alm_licenseの親です

制限事項 ​

ServiceNowデータパイプラインを設定するときは、次の制限事項を確認してください。

Nullのsys_idレコード ​

ServiceNowテーブルには、sys_idがnullのレコードが含まれることがあります。 これは、レコードが破損している場合、または行レベルのACLポリシーによりサービスアカウントが特定のレコードを読み取れない場合に発生する可能性があります。 パイプラインは抽出中にnullのsys_idレコードをスキップし、宛先にはロードしません。 レコードが欠落していることに気付いた場合は、サービスアカウントに対象テーブルの適切なACL権限があることを確認してください。

sys_updated_onがすべての変更で更新されない ​

sys_updated_onフィールドは、すべてのレコード変更で更新されることが保証されているわけではありません。 XMLインポート、直接データベース操作、一括API操作、およびビジネスルールをスキップするインポートセットでは、このフィールドがバイパスされる可能性があります。 これらのパスを通じて変更されたレコードは、増分同期に表示されない場合があります。 レコードの欠落が疑われる場合は、完全更新を実行して対象オブジェクトのすべてのデータを再抽出します。

ファイル添付はサポートされていません ​

パイプラインは構造化されたテーブルデータのみを抽出します。 このリリースではファイル添付はサポートされていません。

PIIと機密データ ​

ServiceNowテーブルには、個人を特定できる情報（PII）と機密データが含まれます。 次の表では、フィールドレベルのデータマスキングが必要になる可能性がある主要なオブジェクトとフィールドを示します。

パイプライン設定でPIIまたは機密データを含むフィールドには、Workatoの組み込みフィールドレベルデータマスキング（ハッシュオプション）を使用します。 GDPR、HIPAA、またはSOC 2の要件に基づいて運用している組織は、同期されるすべてのフィールドを確認し、必要に応じてマスキングを適用する必要があります。