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

このガイドは、ServiceNowのSSHファイル転送プロトコル（SFTP）統合を通じてのインポートをインストールおよび構成する方法、および基本的なメンテナンスガイドを総合的に説明します。

前提条件

このページの構成指示はServiceNow認定プロフェッショナルによって実行されなければなりません。

このページは、Nexthink技術、ServiceNow技術、および業務規則、スクリプティング、基本的なセキュリティ用語などの基本概念を詳細に理解している読者を対象としています。

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

このソフトウェアおよび関連文書は、使用および開示に関する制限が含まれるライセンス契約の下で提供され、知的財産法によって保護されています。ライセンス契約で明示的に許可されている場合または法律により許可されている場合を除き、いかなる形でも、このソフトウェアの使用、複製、翻訳、放送、変更、ライセンス、伝達、配布、展示、実行、出版、または表示を行うことはできません。

法律で相互運用性のために必要な場合を除き、本ソフトウェアのリバースエンジニアリング、分解、または逆コンパイルは禁止されています。

ServiceNowのSFTP経由でのインポート概要

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

異なる構成アイテムに関する情報セットを選択することで、ServiceNowのSFTP経由でのインポートを設定することが可能です。システムはこれらの情報をServiceNowに記録します。さらに、システムはこれらの構成アイテム（CI）間の関係もServiceNowにインポートできます。

統合により、Nexthinkからの対応する情報を提供するデフォルトの変換マップセットが用意され、事前定義されたマッピングセットを提供します。この統合により、特定のCIタイプに関連付けられた特定フィールドのインポートを活用することができます。

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

インストールガイドラインについては、このページの初期設定セクションを参照してください。

含まれる主なServiceNowコンポーネント

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

アプリケーションはシステムがインポートセットを管理するためのステージングテーブルとして使用する8つのカスタムテーブルを作成します。これらのテーブルをサブスクリプションに割り当てないでください。

カスタムテーブルの割り当てに関する詳細情報は以下をご覧ください：

ラベル

名前

インポートセットソフトウェア

x_nexsa_sftp_import_set_software

インポートセットユーザー

x_nexsa_sftp_import_set_user

インポートセットワークステーション

x_nexsa_sftp_import_set_workstation

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

x_nexsa_sftp_import_set_workstation_software

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

x_nexsa_sftp_import_set_user_workstation

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

Nexthink Infinityデータエクスポート機能によって生成されたCSVファイルは、前述のインポートセットテーブルを作成するために使用されました。これには次のクエリを使用しました。

CIタイプ

クエリ

ワークステーション

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

Windowsサーバー

Not supported yet

ユーザー

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

ユーザー-Windowsサーバー関係

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

Windowsサーバー-ソフトウェア関係

Not supported yet

インポートセット、データソース、変換マップおよび定期インポート

Nexthink CMDBポピュレーター統合は、インポート可能なCIタイプおよび関係ごとに1つのインポートセットテーブル、データソース、変換マップ、および定期インポートを提供します。

データソース

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

インポートセット

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

変換マップ

変換マップ 変換マップはインポートセットのフィールドと既存のServiceNowテーブルのフィールドの間の関係を決定するフィールドマップのセットです。

このプロセスのパートでは、要求に応じて、インポートセットにインポートしたデータを修正、スライス、または変換し、その結果データを最終テーブルに保存することも可能です。

定期インポート 定期インポートは、特定のインポート操作が日次、週次、定期的、または別の時間枠として定義できる規則的な間隔でシステムが実行されることを指定します。既定では、統合が提供する定期インポートは非アクティブ状態ですが、異なるスクリプトがプログラムで実行します。

以下のセクションでさらに情報を見つけてください。

䁮の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から受け取ったデータを変換した後にいくつかのフィールドが入力されます。次の表を参照してください：

変換マップ

ソースフィールド

ターゲットフィールド

変換

ワークステーション

u_device_operating_system_name

operating system情報を取得する

ワークステーション

u_device_opera_g_system_build

os_version

operating systemバージョンを取得する

ワークステーション

u_device_hardware_memory

ram

バイトからmegabyteへ変換する

ワークステーション

u_disk_capacity

disk_space

バイトからgigabyteへ変換する

ユーザー-ワークステーション

N/A

type

cmdb_rel_personテーブルに関係タイプを挿入する

ワークステーション-ソフトウェア

N/A

名前

ソフトウェアとCI名に基づいて関係名を設定する

ワークステーション-ソフトウェア

N/A

software

ソフトウェア名とバージョンに基づいて製品名の値を設定する

ServiceNow SFTP経由インポートのインストール - 初期設定

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

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

システムアップデートセット > 取得されたアップデートセットモジュールに移動します。
XMLからのアップデートセットのインポート関連リンクをクリックします。
アプリケーションアップデートセットXMLファイルをアップロードします。
アップデートセットテーブルで、ServiceNow SFTP経由インポートアップデートセットをクリックします。
アップデートセットのプレビューボタンをクリックし、プレビュー処理が完了するのを待ちます。
アップデートセットのコミットボタンをクリックし、処理が完了するのを待ちます。
アップデートセットのステータスがコミット済みに切り替わるはずです。

ロールの割り当て

管理権限を持つユーザーまたは_x_nexsa_sftp.manager_ロールを持つユーザーのみが、アップデートに含まれるインポートセットテーブルに書き込みできます。予定されたインポートを実行するユーザーに、前述のいずれかのロールを提供することが重要です。

さらに、ターゲットテーブル（計算、ソフトウェア、人の関係）への書き込み能力は、他のルールによって影響を受ける可能性があります。データをインポートする担当者が以下にリストされたすべてのターゲットテーブルに書き込み権限を持っていることを確認してください。

コンピュータ [cmdb_ci_computer]
ソフトウェア [cmdb_ci_spkg]
ユーザー [sys_user]
人の関係 [cmdb_rel_person]
ソフトウェアインスタンス [cmdb_software_instance]

スコープ間権限

前回のセクションで詳述されたすべてのターゲットテーブルは、ServiceNow SFTP経由インポートがそれらすべてにレコードを書き込んで作成できるように、デフォルトでスコープ間権限が有効化されています。

しかし、システムがインポートプロセス中に次のエラーを発生させる場合があります：

[Read|Write|Create]操作がスコープ'ServiceNow SFTP経由インポート'からテーブル'{table_name}'に対して拒否されました。アプリケーション'ServiceNow SFTP経由インポート'はスコープ間アクセス特権を宣言する必要があります。アクセスリクエストを更新するために、アプリケーション管理者に連絡してください。

その場合、影響を受けたテーブルの設定を編集し、アプリケーションアクセス設定で必要な操作を付与して問題を解決してください。

たとえば：

データソース設定

アプリケーションには、利用可能な各CIタイプと関係に対して予め設定されたデータソースが含まれています。デフォルトでは、これらのデータソースは、カスタムテーブルインベントリセクションで明らかにされたテーブルを入力します。さらに、システムはこれらのそれぞれがSFTPサーバーから取得したCSVファイルを取得するように設定されています。

残りのフィールドはデフォルトで空です。SFTP関連情報でこれらを埋める必要があります。

データソースを設定するには、ServiceNow SFTP経由インポート > データソースモジュールに移動し、必要なデータソースをクリックします。以下にリストされたすべてのフィールドを設定してください：

フィールド

詳細

サーバ

SFTP サーバのDNS

ポート

サーバーアクセスのためのポート（デフォルトはポート22）

ファイルパス

インポートされるCSVファイルに到達するための絶対パス

ユーザー名

前述のユーザーのパスワード

パスワード

前述のユーザーのパスワード

CSV区切り文字

区切り記号として使用される記号（デフォルト値：“,”）

ServiceNow SFTP経由インポートのインストール - オプション設定

変換マップの設定

すべてのデータソースにリンクされている、いくつかの事前設定がされた変換マップがあります。これらは基本的にインポートセットテーブルでインポートされた列をターゲットテーブルのフィールドにマップするように設定されており、必要に応じていくつかの変換も許可します。

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

一方、システムは変換スクリプトの結果としてのデータを他の列、たとえば_os_や_os_version_の列に記録します。

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

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

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

これを行うために、ServiceNow SFTP経由インポート > スケジュールされたインポートモジュールに移動します。このモジュールには、8つの異なる事前定義されたスケジュールされたジョブ（1つのCIタイプにつき1つ）のセットがあります。設定フォームにアクセスするには、変更したいスケジュールされたインポートをクリックしてください。

以下の表は、フォーム内の各設定フィールドを詳細に説明しています：

フィールド

詳細

アクティブ

システムがスケジュールされたインポートを実行するかどうかを制御します。チェックボックスを選択して有効にします。

実行

システムがインポートを実行する頻度。このフィールドで行なった選択に応じて、下のフィールドは異なります

として実行

インポートジョブが使用するユーザーの資格情報の名前。値を指定しない場合、インポートジョブはゲストユーザーとして実行されます。

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

Last updated 2 months ago

Was this helpful?