SFTP 経由での ServiceNow インポートインストールガイド

このガイドは、SSHファイル転送プロトコル（SFTP）統合を通じたServiceNowへのインポートのインストールおよび設定方法、及び基本的なメンテナンスガイドについての包括的な情報を提供します。

前提条件

• このページの設定手順は、ServiceNow認定のプロフェッショナルが実行する必要があります。

このページは、Nexthinkテクノロジー、ServiceNowテクノロジー、ビジネスルール、スクリプティング、基本的なセキュリティ用語に詳しい読者を対象としています。

この資料に記載されている情報は、予告なしに変更される場合があり、無誤差を保証するものではありません。 エラーを発見した場合は、Nexthinkサポートポータルを通じて報告してください。

ServiceNowのSFTPを経由したインポート概要

ServiceNowのSFTPを経由したインポートでは、Nexthink InfinityからエンドユーザーITデータをServiceNowプラットフォームに統合することができます。

SFTP を介した ServiceNow インポートの設定は、デバイス、ユーザー、ソフトウェアパッケージ、その他の構成アイテム (CI) を ServiceNow に入力する情報セットを選択することで可能です。 さらに、このシステムはこれらの構成アイテム (CI) 間の関係を ServiceNow にインポートすることができます。

この統合には、Nexthink からの対応する情報を含むデフォルト設定の変換マップが提供され、あらかじめ定義されたマッピングセットを提供します。 この統合は、特定の CI タイプに関連する特定フィールドのインポートを活用することを可能にします。

デフォルトのマッピングに加えて、柔軟な統合設計により、非保護の変換マップによって入力される ServiceNow の CMDB テーブルとフィールドを設定することができます。

主な ServiceNow コンポーネントを含む

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

アプリケーションは、インポート セットを管理するためのステージング テーブルとして機能する 8 つのカスタム テーブルを作成します。 これらのテーブルをサブスクリプションに割り当ててはいけません。

カスタム テーブルの割り当てに関する詳細情報：

データエクスポート機能で使用するNQLクエリ

Nexthink Infinityのデータエクスポート機能が前のセクションに記載されているすべてのインポートセットテーブルを作成するために使用されるCSVファイルを生成しました。 これは次のクエリを使用して行われました:

devices
| where hardware.machine_serial_number != "" and (hardware.type == laptop or hardware.type == desktop)
| include cpus
| compute num_of_cores = number_of_cores.count(), number_of_cpus = count(), freq = 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, freq, disk_capacity, operating_system.name, operating_system.build

まだサポートされていません

users
| where name !in ["*Local*"]

package.installed_packages
| list package.name, package.version, package.publisher

session.connects 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

package.installed_packages
| where (device.hardware.type == desktop or device.hardware.type == laptop)
| list package.name, package.version , package.publisher , device.name, device.hardware.type

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

まだサポートされていません

インポートセット、データソース、変換マップおよびスケジュールされたインポート

Nexthink CMDB Populator統合は、インポートできる各CIタイプとリレーションシップに対して1つのインポートセットテーブル、データソース、変換マップ、およびスケジュールされたインポートを提供します:

データソース

データソースは、データがインポートセットに挿入される前に取得される場所と方法を定義します。 それに加え、変換マップはインポートセットから宛先テーブルへのマッピングプロセス中にシステムがデータをどのように変換するかを定義します。

インポートセット

インポートセットは、インポートプロセス中に使用される特別なタイプのServiceNowテーブルです。 これらは、データソースからの生データを受信し、そのデータをServiceNowのターゲットテーブルにプッシュするスタンディングエリアとして機能します。

変換マップ

変換マップは、インポートセットのフィールドと既存のServiceNowテーブルのフィールド間の関係を決定するフィールドマップのセットです。 このプロセスの一部では、インポートセットにインポートされたデータを修正、スライス、または変換して、その結果を要求に応じて最終テーブルに保存することもできます。

スケジュールされたインポート

スケジュールされたインポートは、システムが指定されたインポート操作を実行する定期的な間隔を指定します。これは、毎日、毎週、定期的、または異なる時間枠として定義できます。 デフォルトでは、この統合が提供するスケジュールされたインポートは非アクティブです。なぜなら、異なるスクリプトがプログラム的にそれを実行するからです。 以下のセクションで詳しい情報をご覧ください。

役割

SFTPを介したServiceNowのインポートにより、このアプリケーションを管理するための新たな役割であるx_nexsa_sftp.manager役割が作成されます。

すでに存在するアクセスコントロールリスト(ACL)に応じて、x_nexsa_sftp.manager役割を含めるために一部を変更する必要があるかもしれません。 変更しないと、初期設定の際にいくつかのシステムテーブルとそれに関連するレコードを表示できない可能性があります。

他のServiceNowコンポーネント

参照と選択フィールド

システムは、CMDB内のすべての列が特定のタイプのデータを含むよう構成されています。 特定の方法で動作する2つのタイプがあります。

例えば、文字列フィールドでは、システムは結果的に何も起こらずに任意の受信データを挿入し、保存できます。 しかし、参照と選択タイプのフィールドに関しては、システムはそれらを異なるテーブル内の別のレコードに関連付けます。

例えば、cmdb_ci_computerテーブルの メーカー フィールドは、標準の core_company テーブル内の特定のレコードへの参照です。そのため、 メーカー フィールドに情報を挿入するには、システムはcore_companyテーブル内に参照する既存のレコードを持っていなければなりません。

一方、 選択 フィールドも同様に機能しますが、この場合は、 sys_choice テーブルで選択を作成する必要があります。

デフォルトでは、このアプリケーションに含まれる変換マップは、Nexthinkが新しいデータを受け取るたびに sys_choice およびすべての参照テーブル内にレコードを作成します。 言い換えれば、CSVファイルで受信したメーカーが core_company テーブルに存在しない場合、システムは、それを参照テーブルに挿入する変換を可能にするために 1 つ作成します。

ビジネスルール

たとえアプリケーション内でビジネスルールを定義していなくても、システムはすべての変換マップを、ServiceNowインスタンスで以前に定義されたすべてのルールを尊重するように構成しています。

変換マップ「ビジネスルールの実行」の設定詳細

各インスタンスには独自のビジネスルールがあります。 Nexthinkは、ターゲットテーブルにデータを挿入する際にこれらのルールをバイパスすることを推奨していません。不測の事態や望ましくない行動がインポートプロセス中に浮上する可能性があります。

変換スクリプト

変換マップの中で、システムはNexthinkから受け取ったデータを変換した後に一部のフィールドを埋めます。 以下の表を参照してください:

SFTPによるServiceNowデータインポートの初期設定

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

アプリケーションパッケージは、アップデート設定の形式でのみ利用可能です。 インストールするには、次の手順に従います。

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

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

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

4. アップデートセットテーブルで、 SFTPによるServiceNowデータインポートアップデートセットをクリックします。

5. アップデートセットのプレビューボタンをクリックし、プレビュー処理が完了するのを待ちます。

6. アップデートセットをコミット ボタンをクリックし、プロセスが完了するのを待ちます。

7. アップデートセットステータスは コミット済み に切り替わるはずです。

ロールの割り当て

アップデートに含まれるインポートセットテーブルに書き込むには、管理者権限を持つユーザーまたは_x_nexsa_sftp.manager_役割を持つユーザーのみが必要です。 スケジュールされたインポートを実行するユーザーに、上記の役割のいずれかを提供することが重要です。

さらに、以下の他のルールにより、ターゲットテーブル(コンピュート(),', ソフトウェア',, ピープルリレーションシップ')に書き込む能力に影響が出るかもしれません。 データをインポートする担当者が、以下のすべてのターゲットテーブルに書き込みアクセスを持っていることを確認してください。

• コンピュータ [cmdb_ci_computer]

• ソフトウェア [cmdb_ci_spkg]

• ユーザー [sys_user]

• 人間関係 [cmdb_rel_person]

• ソフトウェアインスタンス [cmdb_software_instance]

クロススコープの許可

システムは、前のセクションで詳述されたすべてのターゲットテーブルを、アウトオブザボックスでクロススコープ権限を有効にするよう構成し、SFTP経由のServiceNowインポートがそれらすべてにレコードを作成し、書き込むことを許可しています。

しかし、システムが次のエラーをインポートプロセス中にトリガーすることがある事態が発生するかもしれません。

そのような場合、影響を受けたテーブル設定を編集し、アプリケーションアクセス設定で必要な操作を許可することで問題を解決します。

たとえば：

データソースの設定

アプリケーションは、各CIタイプと利用可能なリレーションシップについて事前に設定されたデータソースを含んでいます。 通常、これらのデータソースはカスタムテーブルインベントリで開示されたテーブルを入力します。 また、システムは、これらのそれぞれをSFTPサーバーから取得されたCSVファイルを取得するために構成しています。

残りのフィールドはデフォルトですべて空で、SFTPに関連した情報で埋める必要があります。

データソースを設定するには、SFTPを介したServiceNow > データソースモジュールに移動し、必要なデータソースをクリックします。 以下に示すすべてのフィールドを設定します:

ServiceNow での SFTP を通じたインポートのインストール - オプション設定

変換マップの設定

すべてのデータソースにリンクされ、事前に定義された設定で作成された変換マップがあります。 これらは基本的に、インポートセットテーブルにインポートされたカラムを対象テーブルのフィールドとマッピングするように設定されており、必要に応じていくつかの変換を可能にします。

上記のスクリーンショットでは、ステージングテーブルの _u_device_entity フィールドに保存されているすべてのデータが、ターゲットテーブルの _location フィールドに転送されることがわかります。

一方で、システムは、他のカラムで os や os_version などの変換スクリプトから得られたデータを記録します。

新しいフィールドマッピングを作成するか、既存のフィールドマップを編集する必要がある場合は、ServiceNow の標準手順に従ってください:

• フィールドマップを作成 | ServiceNow

• マッピングオプション | ServiceNow

スケジュールされたインポートの設定

スケジュールされたインポート セクションで説明されているように、特定の間隔でインポート手順を実行するようにシステムをスケジュール設定できます。

このための手続は ServiceNow インポート via SFTP > スケジュールされたインポート モジュールに進みます。 このモジュールでは、8種類のCIタイプごとに1つの異なる事前定義されたスケジュールジョブがあります。 設定フォームにアクセスするには、変更したいスケジュールされたインポートをクリックします。

以下のテーブルには、フォーム内の各設定フィールドについて詳細を示しています。

上記の表で最も重要な設定は アクティブ の設定です。 このフィールドをアクティブ化すると、スケジュールされたインポートの日付または間隔の詳細を設定するために 実行 フィールドの下に新しいフィールドが表示されます。 これらのオプションについての詳細は ServiceNow のドキュメント で確認できます。