ServiceNowでの一般的APIコールのインストールガイド

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

ServiceNow に初めて触れる場合は、Exporter to ServiceNow のドキュメントを参照してください。

このガイドでは、アップデートセット パッケージ (XML ファイル) からの ServiceNow 統合における汎用 API コールのインストールと構成方法を説明しています。 この文書には、基本的な保守ガイドラインも含まれています。

ServiceNow における汎用 API コールのインストールの利点

ServiceNow における汎用 API コールは、Nexthink プラットフォームからのエンドユーザー IT データを ServiceNow に統合するための標準フローと予め定義されたマッピングを提供します。 汎用 API コールで次のことができます。

• デバイス、ユーザー、ソフトウェア パッケージなどの異なる構成アイテム (CI) に関する情報のセットを選択し、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 は、以下の画像に示す 5 つのデータソースを一覧表示します。

以下では、提供された 5 つのデータソースからの変換マップの例を示します。

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

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

初期設定

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

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

1. System Update Sets > Retrieved Update Sets モジュールに移動します。

2. XML 関連リンクからアップデート セットをインポートをクリックします。

3. アプリケーション アップデート セット XML ファイル をアップロードします。

4. アップデート セット テーブルで、Generic API call in ServiceNow アップデート セットをクリックします。

5. Update set をプレビューするボタンをクリックし、プレビュー プロセスが終了するまで待ちます。

6. Update set をコミット ボタンをクリックし、プロセスが終了するまで待ちます。

7. アップデート セットのステータス をコミット済みとして更新されるべきです。

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

リクエストで多くのレコードを送信するときにタイムアウト エラーを回避するために、これらの設定が必要です。

1. System definition > Transaction Quota Rules モジュールに移動します。

2. REST Import Set API request timeout および REST and JSON Catch All を検索します。

3. Exporter to ServiceNow ドキュメントの 必要条件 のセクションで推奨される時間に従って、Maximum Duration (seconds) の値を変更します。

テーブル CI/ユーザーリレーションシップタイプへのアプリケーション アクセスの変更

この設定により、アプリケーションは CI/ユーザー テーブルに書き込みが可能になり、ユーザーとワークステーション間の関係を分類できます。

1. System definition > Tables モジュールに移動します。

2. 名前の値が cmdb_rel_user_type となっているものを検索してください。

   
3. Application Access タブに移動し、すべてのスコープに対して Can read、Can create、Can update を有効にしてください。

   

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

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