ServiceNow におけるジェネリック API コールのインストールガイド

このインストールプロセスを実行するには、ServiceNow 認定プロフェッショナルである必要があります。

ServiceNow を初めて使用する場合は、ServiceNow エクスポータードキュメントを参照してください。

このガイドは、アップデートセットパッケージ (XML ファイル) から ServiceNow とのインテグレーションにおける汎用 API コールのインストールと設定方法を説明します。この文書には基本的なメンテナンスガイドラインも含まれています。

ServiceNow に汎用 API コールをインストールするメリット

ServiceNow の汎用 API コールは、Nexthink プラットフォームからエンドユーザーの IT データを ServiceNow に統合するためのデフォルトのフローセットと事前定義されたマッピングを提供します。汎用 API コールでは以下のことが可能です：

Select a set of information about different Configuration Items (CI) such as devices, users, software packages and others, to populate in ServiceNow.
これらの CI 間の関係を ServiceNow にインポートすることを選択できます。
書き込み保護されたフローを使用せずに、異なる CMDB ServiceNow テーブルとフィールドを設定できます。
特定の CI タイプに関連する特定のフィールドのインポートを活用できます。

これらの ServiceNow コンポーネントをアップデートセットパッケージからダウンロードします。

インストールガイドラインについては、初期設定セクションに直接移動してください。

アップデートセットパッケージに含まれる ServiceNow コンポーネント

このセクションではアップデートセットパッケージに含まれる主要な ServiceNow コンポーネントを探ります。

カスタムテーブルの在庫

アプリケーションは、インポートセットを管理するためのステージングテーブルとして使用する 5 つのカスタムテーブルを作成します。 Nexthink データエクスポート機能は下記にリストされたすべてのインポートセットテーブルを作成するための CSV ファイルを生成します。

次のクエリでカスタムテーブルの割り当てについて学びます：

ラベル: インポートセットソフトウェア

名前： x_nexsa_g_api_call_import_set_software

NQL:

package.installed_packages
| summarize nb_installations = count(), unique_packages = package.count() by package.name, package.version, package.type, package.publisher, package.platform, package.parent_name
| list package.name, package.version , package.publisher

ラベル: インポートセットユーザー

名前： x_nexsa_g_api_call_import_set_user

NQL:

users
| where type != system and name !in ["*Local*"]

ラベル: インポートセットワークステーション

名前： x_nexsa_g_api_call_import_set_workstation

NQL:

devices
| where hardware.machine_serial_number != "" and (hardware.type == laptop or hardware.type == desktop)
| include cpus
| compute num_of_cores = number_of_cores.sum() , number_of_cpus = count(), sum_frequency = frequency.sum()
| include disks
| compute disk_capacity = capacity.sum()
| list group_name, entity, hardware.manufacturer, hardware.model , operating_system.architecture , hardware.machine_serial_number , name, hardware.memory, num_of_cores , number_of_cpus , sum_frequency ,disk_capacity, first_seen, last_seen

ラベル: インポートセットワークステーション - ソフトウェア

名前： x_nexsa_g_api_call_import_set_workstation_software

NQL:

package.installed_packages
| summarize c1=count() by package.name, package.version , device.name
| list package.name, package.version , device.name

ラベル: インポートセットユーザー - ワークステーション

名前： x_nexsa_g_api_call_import_set_user_workstation

NQL:

session.logins during past 7d
| where hardware.type == laptop or hardware.type == desktop
| summarize c1 = count() by device.name , user.name , user.ad.full_name
| list device.name , user.name , user.ad.full_name

変換マップ

ServiceNow アップデートセットの汎用 API コールには、CI タイプと関係を挿入するための変換マップを持つ 5 つのデータソースが含まれています。 ServiceNow lists the 5 data sources as shown in the following image:

以下は提供された 5 つのデータソースからの変換マップの例です：

デフォルトの変換マップは書き込み保護されていません。 CMDB テーブルにより多くのフィールドや変換を挿入する必要がある場合は、それらを変更できます。

詳細については、変換マップ ServiceNow ドキュメントを参照してください。

初期設定

アプリケーションのインストール

アプリケーションパッケージはアップデートセット形式でのみ利用可能です。インストール手順に従ってください：

システムアップデートセット > 取得したアップデートセットモジュールに移動します。
XML からアップデートセットをインポートの関連リンクをクリックします。
アプリケーションアップデートセット XML ファイルをアップロードします。
アップデートセットテーブルで、ServiceNow アップデートセットの汎用 API コールをクリックします。
アップデートセットプレビューのボタンをクリックし、プレビュー処理が完了するまで待ちます。
アップデートセットコミットのボタンをクリックし、処理が完了するまで待ちます。
アップデートセットのステータスがコミット済みとして更新される必要があります。

ServiceNow インスタンスでのタイムアウト設定の変更

これらの設定は、一度のリクエストで大量のレコードを送信する際のタイムアウトエラーを防ぐために必要です。

システム定義 > トランザクションクォータルールモジュールに移動します。
REST インポートセット API リクエストタイムアウトと REST および JSON キャッチオールを検索します。
Change the value for Maximum Duration (seconds) to a value according to the recommended times in the Prerequisites section from the Exporter to ServiceNow documentation.

テーブル CI/ユーザー関係タイプにアクセスするためのアプリケーション権限の変更

この設定により、アプリケーションが CI/ユーザーテーブルに情報を記載し、ユーザーとワークステーションの関係を分類することができます。

システム定義 > テーブル モジュールに移動します。
名前で cmdb_rel_user_type 値を検索します。\
アプリケーションアクセス タブに移動し、すべてのスコープに対して 読み込み可、作成可、更新可 を有効にします。\

アップデートセットパッケージ

ファイルをダウンロード。

Last updated 29 days ago