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

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

ServiceNow に不慣れな場合は、Exporter to ServiceNow ドキュメントを参照してください。

このガイドでは、アップデート セットパッケージ (XML ファイル)からServiceNow統合でのGeneric API呼び出しのインストールと設定方法を説明します。 このドキュメントには基本的なメンテナンスガイドラインも含まれています。

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

ServiceNow 内のジェネリック API コールにより、Nexthink プラットフォームから ServiceNow へのエンドユーザー IT データの統合にデフォルトのフローと定義済みのマッピングを提供します。 ジェネリック API コールで以下が可能です：

• デバイス、ユーザー、ソフトウェアパッケージなど、さまざまな構成項目 (CI) に関する情報を選択し、ServiceNow に登録します。

• これらの CI 間の関係を ServiceNow にインポートすることを選択します。

• ServiceNow の CMDB テーブルやフィールドをライト保護されていないフローを使用せずに構成します。

• 特定の CI タイプに関連する特定のフィールドのインポートを活用します。

アップデート セットパッケージからこれらのServiceNowコンポーネントをダウンロードしてください。

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

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

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

カスタムテーブルインベントリ

アプリケーションは5つのカスタムテーブルを作成し、これをインポートセットの管理に使用します。 Nexthink Data Export機能は、以下のすべてのインポートセットテーブルを作成するための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アップデートセットのGeneric APIコールには、CIタイプと関連付けを挿入するための変換マップを含む5つのデータソースが含まれています。 ServiceNowは次の画像のように5つのデータソースをリストしています。

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

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

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

初期設定

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

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

1. システムアップデートセット > 取得されたアップデートセットモジュールに移動します。

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

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

4. アップデートセットテーブルでServiceNowアップデートセットにあるGeneric APIコールをクリックします。

5. 「アップデートセットのプレビュー」ボタンをクリックし、プレビュー処理が終了するのを待ってください。

6. 「アップデートセットのコミット」ボタンをクリックし、プロセスが終了するのを待ってください。

7. アップデートセットのステータスはコミット完了として更新されるはずです。

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

大量のレコードを要求で送信するときにタイムアウトエラーが発生しないようにするために、これらの設定が必要です。

1. システム定義 > トランザクションクオータルールモジュールに移動します。

2. RESTインポートセットAPIリクエストのタイムアウトおよびRESTとJSONキャッチオールを検索します。

3. サービスナウ エクスポータードキュメントの前提条件セクションに記載されている推奨時間に従って、最大持続秒数の値を変更します。

CI/ユーザー関係タイプへのアプリケーションアクセスの変更

この設定は、アプリケーションがCI/ユーザーテーブルに書き込むことを許可し、ユーザーとワークステーションの関係をカテゴライズします。

1. システム定義 > テーブルモジュールに移動します。

2. cmdb_rel_user_typeという値で名前を検索します。

   
3. Application Access タブに移動し、すべてのスコープに対して 読み取り可能、作成可能、および 更新可能 を有効にします。

   

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

ファイルをダウンロードしてください。