ServiceNowコネクター

​

はじめに

ServiceNowは、ITサービスマネジメントをサポートし、共通のビジネスプラクティスを自動化するソフトウェアプラットフォームです。DomoのServiceNowコネクターを使用すると、リストからデータテーブルを取得したり、カスタムテーブル名を設定したりすることができます。ServiceNow APIの詳細については、ウェブサイト（http://wiki.servicenow.com/index.php…_API#gsc.tab=0）を参照してください。

ServiceNowコネクターは「クラウドApp」コネクターであるため、クラウドに保管されたデータの取得が可能です。Data Centerでウィンドウ上部のツールバーで**［クラウドApp］**をクリックすると、これを含むほかのクラウドAppコネクターのページにアクセスできます。

標準のServiceNowコネクターに加えて、Domoは「ServiceNow Upsert」コネクターも提供しています。このコネクターは、「追加」と「置き換え」のほかに「Upsert」の更新オプションがある点を除いて、標準のServiceNowコネクターとまったく同じものです。このオプションについては、この記事の「その他のペイン」で説明します。

ServiceNowアカウントには、Data Centerからアクセスします。このトピックでは、ServiceNowコネクターユーザーインターフェースに固有のフィールドとメニューについて説明します。DataSetの追加や更新スケジュールの設定、DataSet情報の編集に関する一般的な情報は、「コネクターを使用してDataSetを追加する」を参照してください。

主な使用事例	- インシデントのトレンドを監視し、インシデント数を減らす方法を特定します。 - 変更リクエストの量を追跡し、変更リクエストプロセスのボトルネックを取り除きます。 - 問題の送信数を追跡し、インシデント数との関係を探します。
主なメトリクス	- オープンな高優先度インシデント - インシデントのトレンド - インシデントの平均解決時間（MTTR） - 重大度、優先度、影響、緊急度別のインシデント量 - 変更量のトレンド - オープンな緊急の変更 - 問題量のトレンド
社内における主な権限	ITサービスデスクマネージャー
平均導入時間	3時間
使いやすさ（1～10段階。1が「最も使いやすい」）	5

​

ベストプラクティス

インシデント、問題、変更リクエストのステータスの正確かつ最新の状況を継続的に把握できるように、短い間隔でレポートのスケジュールを設定します。

​

必要条件

ServiceNowアカウントに接続してDataSetを作成するには、ServiceNowのユーザー名とパスワードが必要です。ServiceNowサーバーのURLも必要になります。通常は、https://mycompany.servicenow.comのフォーマットです。

​

ServiceNowアカウントに接続する

このセクションでは、ServiceNowコネクターページの**［認証情報］および［詳細］ペインについて説明します。このページのほかのペインの項目である［スケジュール設定］や［DataSetに名前を付け、説明を入力］**に関しては、ほとんどのタイプのコネクターで共通しています。詳細については、「コネクターを使用してDataSetを追加する」を参照してください。

​

［認証情報］ペイン

このペインには、ServiceNowアカウントにアクセスするための認証情報を入力するフィールドがあります。下表では、各フィールドに必要な内容を説明しています。

フィールド	説明
Host URL	ServiceNowサーバーのURLを入力します。例：https://mycompany.servicenow.com。
Username	ServiceNowのユーザー名を入力します。正確な日付を得るには、タイムゾーンをGMT時間に設定する必要があります。
Password	ServiceNowパスワードを入力します。

有効なServiceNow認証情報を一度入力しておくと、随時同じアカウントを使用して新しいServiceNow DataSetを作成することができます。コネクターのアカウントはData Centerの**［アカウント］**タブで管理できます。このタブの詳細については、「コネクター/アダプターアカウントを管理する」を参照してください。

**注記：**接続されたServiceNowのユーザーアカウントは、必ずグリニッジ標準時（GMT）に設定する必要があります。別のタイムゾーンに設定すると、問題が発生します。自分のプロフィールのタイムゾーンを編集するには、以下を行います。

1. ServiceNowにログインしたら、**［Self Service］>［My Profile］**まで進みます。
2. **［Time Zone］**プロパティに進みます。
3. タイムゾーンに**［GMT］**を選択します。

​

［詳細］ペイン

このペインには、メインの**［Report］**メニューがあり、そこで引き出したいテーブルのタイプを選択することができます。選択したテーブルタイプによっては、ほかのオプションも表示される場合があります。

メニュー	説明
Report	ServiceNowレポートを選択します。以下のレポートが利用できます。 Custom Query カスタムクエリを作成します。どのフィールドがDataSetに返されるかを選べる機能が含まれます。 Custom Table データを取得するためのカスタムテーブル名を設定します。 Standard Table Service Nowの標準テーブルのリストから選択します。
Table	データを取得したいServiceNowのテーブルを選択します。次のテーブルが利用できます。 Incident インパクト、緊急性、説明、クローズノートなど、特定の日付範囲におけるインシデントに関するデータを取得します。 Change Request 特定の日付範囲における変更リクエストを取得します。 Problem 特定の日付範囲において発生した問題に関するデータを取得します。 User Groups 特定の日付範囲におけるユーザーグループに関するデータを取得します。 Users 特定の日付範囲におけるユーザーに関するデータを取得します。
Table Name	データを取得したいテーブルの名前を入力します。
Custom Query	カスタムクエリを入力します。sysparm_queryに直接関係するクエリ値だけを入力するようにします。sysparm_limitとsysparm_offsetのフィールドは含めないようにします。フィールドsys_created_onを含める場合は、その値は次のフォーマットである必要があります：yyyy-MM-dd HH:mm:ss 例： ORDERBYDESCsys_created_on^sys_created_on>2016-09-25+00:00:00^sys_created_on<2016-09-27+23:59:59 クエリの構築方法の詳細については、ウェブサイト（http://wiki.servicenow.com/index.php…le_API#Methods）を参照してください。 **重要：**カスタムクエリを作成する場合は、sysparm_queryに直接関係するクエリ値だけを入力するようにします。sysparm_limitとsysparm_offsetのフィールドは含めないようにします。フィールドsys_created_onを含める場合は、その値は次のフォーマットである必要があります：yyyy-MM-dd HH:mm:ss。
Fields	このDataSetとともに返すフィールドを、カンマ区切りのリストとして入力します。 例： parent,sys_updated_on,number
Data Date Format	ServiceNow APIが日付フィールドを返すフォーマットを選択します。文字列を選択すると、Domoはまったく日付を処理せずに、ServiceNow APIから返されたリテラル文字列を返します。
Upsert/Merge Key	Upsert/結合キーを入力します。デフォルトでは、sys_idがUpsert/結合キーとして使用されます。
Select Date Type for Query 更新方法 説明 --- --- 最初の実行 選択した期間のクエリを選択した日付タイプで作成します。 連続実行 最後に正常に実行された日から今日までのクエリをsys_updated_onで作成し、既存のデータに追加します。 --- --- 最初の実行 選択した期間のクエリを選択した日付タイプで作成します。 連続実行 最後に正常に実行された日から今日までのクエリをsys_updated_onで作成し、既存のデータに結合します。	Append
Duration	レポートの期間を選択します（単一の日付または日付範囲）。
Report Date	データの対象を特定の日付にするか相対的な日付にするかを指定します。現在の日付から特定の日数を遡ったデータ（**［Days Back］で指定）をレポートで取得したい場合は、［Relative］を選択します。例えば、［Days Back］**に「5」を入力し、DataSetを毎日更新するように設定した場合、日が更新されるたびにその日から5日前の日付の情報が表示されます。
Select Specific Date	データを取得する日付を選択します。
Days Back	レポートで、現在の日付から過去何日分を表示するかを入力します。
Start Date	日付範囲の開始日を、特定日付とするか相対日付とするかを指定します。現在の日付から特定の日数を遡ったデータ（**［Days Back to Start From］で指定）をレポートで取得したい場合は、［Relative］を選択します。ここで［Relative］を選択した場合、［End Date］にも［Relative］を選択し、［Days Back to End At］を指定する必要があります。 例えば、［Days Back to Start From］に「10」を入力し、［Days Back to End At］**に「5」を入力し、そのDataSetを毎日更新するように設定した場合、日が更新されるたびにその日の5日前から10日前までの情報が表示されます。
Select Specific Start Date	日付範囲の最初の日付を選択します。
End Date	日付範囲の最終日を、特定日付とするか相対日付とするかを指定します。現在の日付から特定の日数を遡ったデータ（**［Days Back to End At］で指定）をレポートで取得したい場合は、［Relative］を選びます。ここで［Relative］を選択した場合、［Start Date］にも［Relative］を選択し、［Days Back to Start From］を指定する必要があります。 例えば、［Days Back to Start From］に「10」を入力し、［Days Back to End At］**に「5」を入力し、そのDataSetを毎日更新するように設定した場合、日が更新されるたびにその日の5日前から10日前までの情報が表示されます。
Select Specific End Date	日付範囲の最終日を選択します。
Days Back to Start From	開始日として使用する現在の日付前の日数を入力します。 例えば、**［Days Back to Start From］に「10」を入力し、［Days Back to End At］**に「5」を入力し、そのDataSetを毎日更新するように設定した場合、毎日、その日の5日前から10日前までの情報が表示されます。
Days Back to End At	終了日として使用する現在の日付前の日数を入力します。 例えば、**［Days Back to Start From］に「10」を入力し、［Days Back to End At］**に「5」を入力し、そのDataSetを毎日更新するように設定した場合、毎日、その日の5日前から10日前までの情報が表示されます。

​

その他のペイン

このコネクターの「Upsert」バージョンには、標準の「置き換え」と「追加」に加えて、**［Upsert］**の更新オプションが含まれています。このオプションを選択すると、システムが古いデータの照合に使用するUpsertキーを提供するよう求められます。既存のデータ行でそのキーを使用しているものがある場合は、それらの行は新しい行としてDataSetに追加されるのではなく、新しいデータで置き換えられます。

混乱を避けるために、様々な列番号と各種列データタイプを持つスキーマの保存について以下に説明します。

• Domoでは古いスキーマが保持されます。これは、ユーザーが間違って元のスキーマとは異なるスキーマを返し、古いスキーマを使用しているすべてのアセットを破損してしまうことを防ぐためです。
• クエリが以前に入力されたフィールドを返さない場合、DataSet内のフィールドは空白になりますが、削除はされません。
• Domoは、取り込みの際に列のデータタイプを推測しようとします。データタイプを変更しないようにコネクターに指示することもできますが、フィールドを受け取る前にフィールドのインサイトが得られないカスタムクエリの場合は、推奨されません。例えば、最初の実行時に受け取ったのが数値だったため、その列が数値であるとコネクターが最初に推測するとします。次の実行時に文字と数値が含まれるものをクエリが返した場合、コネクターは列を数値ではなく文字列として認識するため、エラーが発生します。
• コネクターは、APIが送信するフィールドを取り込みます。そのため、APIがフィールドを送信しない場合、コネクターはそれを取り込むことができません。

スケジュール設定、再試行、更新に関するオプションなど、コネクターインターフェースのその他のペインに表示されるオプションについては、「コネクターを使用してDataSetを追加する」を参照してください。

​

よくある質問

このコネクターはホワイトリスト登録（許可リスト登録）が必要ですか？

起動するには、ネットワークのホワイトリストにコネクターを追加する必要があります。
また、ITチームと協力してネットワークの許可リストにDomoのIPを追加することで、コネクターがServiceNowインスタンスと通信できるようにDomoのコネクターを許可する必要があります。

このコネクターではどのバージョンのServiceNow APIを使用しますか？

このコネクターは、ServiceNow APIのバージョン1（https:///api/now/v1）を使用します。

各レポートによってこのコネクターで呼び出されるのはどのエンドポイントですか？

レポート名	エンドポイントURL
Custom Query	/table/
Custom Table	/table/
Standard Table	/table/

このコネクターを使用するにはどのような認証情報が必要ですか？

ホストURL（例：https://mycompany.service-now.com）と、ServiceNowインスタンスへのログインに使用するユーザー名とパスワードが必要です。

コネクターを設定するには、データサービスの特定の種類のアカウントが必要ですか？

アカウントには適切な権限が必要で、アクセスしようとしているテーブルでウェブサービスが有効になっている必要があります。

コネクターを作成するにはほかに何をする必要がありますか？

含まれているデフォルトのテーブルのいずれかを選択することもできますが、カスタムテーブルから取得する必要がある場合は、テーブル名が必要です。また、syssparmqueryを指定して、カスタムServiceNowクエリを実行することもできます。このようなクエリの構造については、ServiceNow Table APIのドキュメントを参照してください。

クエリが正しいかどうかを確認する方法はありますか？

適切なアクセス権があれば、ServiceNow内でクエリをテストすることができます。

継続してDataSetのエラーが発生しています。どのように修正すればよいですか？

返された日付が正しくない場合は、データを受け取った時点でDomoが適切にDomoのタイムゾーンに変換できるよう、ServiceNowインスタンスがGMTまたはUTCフォーマットに設定されているかどうかを検証する必要があります。会社全体でこれを変更できない場合は、タイムゾーンをGMTまたはUTCに設定したDomo専用の独立したユーザーを作成してください。

ServiceNowコネクターとServiceNow Upsertコネクターの違いは何ですか？

ServiceNow Upsertコネクターは、DataSetのスケジュールを設定するために、追加モードや置き換えモードのほかにUpsertモードもサポートしています。