ServiceNow
ServiceNow サービス レベルを向上させ、従業員に活力を与え、企業が光速で作業できるようにします。 インシデント、質問、ユーザーなどを含む ServiceNow 内に保存されているレコードを、作成、読み取り、更新を実行します。
このコネクタは、次の製品および地域で利用可能です。
| Service | クラス | 地域 |
|---|---|---|
| Logic Apps | 標準 | 以下を除くすべての Logic Apps 地域 : - 米国国防総省 (DoD) |
| Power Automate | Premium | 以下を除くすべての Power Automate 地域 : - 21 Vianet が運用する中国のクラウド |
| Power Apps | プレミアム | 以下を除くすべての Power Apps 地域 : - 21 Vianet が運用する中国のクラウド |
| 連絡先 | |
|---|---|
| 件名 | Microsoft |
| URL | Microsoft LogicApps サポート Microsoft Power Automate サポート Microsoft Power Apps サポート |
| Connector Metadata | |
|---|---|
| 発行者 | マイクロソフト |
| Web サイト | https://www.servicenow.com/ |
| プライバシー ポリシー | https://www.servicenow.com/privacy-statement.html |
注意
「サポート情報記事を取得」操作は、Knowledge API (sn_km_api) プラグインがアクティブ化されている場合にのみ使用できます。
既知の問題と制限事項
レコードの作成アクションを使用するときに、レコードの完全な説明を指定することができません。 Service-Now REST API の制限により、フィールドの値は無視されます。
レコード取得アクションは、Power Apps で「無効なテーブル」等のエラーを返す場合があります。 Power Apps の実装では、Power Automate のレコード取得アクションを利用し、Power Apps にデータを戻すという対処法が提案されています。
接続を作成する
このコネクタは、次の認証タイプをサポートしています:
| 既定 | 接続を作成するためのパラメーター。 | すべての地域 | 共有不可 |
既定
適用できるもの: すべての領域
接続を作成するためのパラメーター。
これは共有可能な接続ではありません。 パワー アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 件名 | タイプ | 内容 | 必要 |
|---|---|---|---|
| インスタンス | 文字列 | service-now.com のインスタンス名または移行したアカウントのカスタム URL | 真 |
| ユーザー名 | 文字列 | このインスタンスのユーザー名 | 真 |
| パスワード | securestring | このアカウントのパスワード | True |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 600 | 60 秒 |
アクション
| サポート情報記事を取得 |
検索およびフィルター処理が可能なサポート情報 (KB) 記事の一覧を返します |
| レコードの一覧を表示 |
「インシデント」のような特定の ServiceNow' オブジェクト タイプのレコードを取得 |
| レコードの作成 |
ServiceNow テーブルで、レコードを作成します。 |
| レコードの削除 |
インシデントのような ServiceNow' オブジェクト タイプのレコードを削除 |
| レコードの更新 |
「インシデント」のような ServiceNow' オブジェクト タイプのレコードを更新 |
| レコードの種類を取得 |
使用可能なレコードタイプを一覧表示 |
| レコードを取得 |
「インシデント」のような ServiceNow' オブジェクト タイプのレコードを取得 |
サポート情報記事を取得
検索およびフィルター処理が可能なサポート情報 (KB) 記事の一覧を返します
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Fields
|
fields | string |
サポート情報テーブルのフィールドをコンマで区切ったリストです。 |
|
|
Limit
|
limit | integer |
返す最大レコード数。 |
|
|
クエリ
|
query | True | string |
検索するテキストです。 |
|
フィルター
|
filter | string |
結果セットのフィルター処理に使用するエンコードされたクエリです。 |
|
|
サポート情報
|
kb | string |
サポート情報の sys_id をコンマで区切ったリストです。 |
戻り値
- Body
- GetArticlesResponse
レコードの一覧を表示
「インシデント」のような特定の ServiceNow' オブジェクト タイプのレコードを取得
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
レコードの種類
|
tableType | True | string |
リストするレコードの種類 |
|
システムの参照を表示
|
sysparm_display_value | boolean |
システム参照を含める必要があるかどうかを決定 |
|
|
参照リンクを除外
|
sysparm_exclude_reference_link | boolean |
参照リンクを除外する必要があるかどうかを決定 |
|
|
Query
|
sysparm_query | string |
結果セットのフィルタリングに使用されるエンコードされたクエリ。 例: active=true^ORDERBYnumber^ORDERBYDESCcategory |
|
|
制限
|
sysparm_limit | integer |
ページ付けに適用される制限。 既定値は 10000 です。 |
|
|
オフセット
|
sysparm_offset | integer |
クエリから除外するレコードの数。 |
戻り値
レコードの作成
ServiceNow テーブルで、レコードを作成します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
レコードの種類
|
tableType | True | string |
リストするレコードの種類 |
|
本文
|
body | True | dynamic | |
|
システムの参照を表示
|
sysparm_display_value | boolean |
システム参照を含める必要があるかどうかを決定 |
|
|
参照リンクを除外
|
sysparm_exclude_reference_link | boolean |
参照リンクを除外する必要があるかどうかを決定 |
戻り値
レコードの削除
インシデントのような ServiceNow' オブジェクト タイプのレコードを削除
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
レコードの種類
|
tableType | True | string |
リストするレコードの種類 |
|
システム ID
|
sysid | True | string |
レコードのシステム ID。 |
レコードの更新
「インシデント」のような ServiceNow' オブジェクト タイプのレコードを更新
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
レコードの種類
|
tableType | True | string |
リストするレコードの種類 |
|
システム ID
|
sysid | True | string |
レコードのシステム ID。 |
|
本文
|
body | True | dynamic | |
|
システムの参照を表示
|
sysparm_display_value | boolean |
システム参照を含める必要があるかどうかを決定 |
|
|
参照リンクを除外
|
sysparm_exclude_reference_link | boolean |
参照リンクを除外する必要があるかどうかを決定 |
戻り値
レコードの種類を取得
レコードを取得
「インシデント」のような ServiceNow' オブジェクト タイプのレコードを取得
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
レコードの種類
|
tableType | True | string |
リストするレコードの種類 |
|
システム ID
|
sysid | True | string |
レコードのシステム ID。 |
|
システムの参照を表示
|
sysparm_display_value | boolean |
システム参照を含める必要があるかどうかを決定 |
|
|
参照リンクを除外
|
sysparm_exclude_reference_link | boolean |
参照リンクを除外する必要があるかどうかを決定 |
戻り値
定義
GetTypesResponse
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
結果
|
result | array of object |
現在のインスタンスのすべてのレコードタイプの結果セット。 |
|
表示名です
|
result.label | string |
レコードの種類の表示名。 |
|
価値
|
result.value | string |
レコードの種類値。 |
GetArticlesResponse
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
数
|
meta.count | integer |
利用可能なサポート技術情報の記事の数 |
|
末尾
|
meta.end | integer |
結果セットの終了インデックス |
|
Fields
|
meta.fields | string |
記事のフィールド |
|
フィルター
|
meta.filter | string |
データの取得に使用するフィルター |
|
サポート情報
|
meta.kb | string |
サポート情報記事 sys_ids の一覧 |
|
Language
|
meta.language | string |
要求されたサポート技術情報の記事のカンマ区切り言語のリスト |
|
クエリ
|
meta.query | string |
指定された要求クエリ |
|
先頭
|
meta.start | string |
結果セットの開始インデックス |
|
Status
|
meta.status.code | string |
呼び出しの状態 |
|
サポート情報
|
meta.ts_query_id | string |
要求されたサポート技術情報の記事のカンマ区切り言語のリスト |
|
記事
|
articles | array of object | |
|
値の表示
|
articles.fields.display_value | string |
要求されたフィールドの表示値 |
|
Label
|
articles.fields.label | string |
要求されたフィールドを表すラベル |
|
件名
|
articles.fields.name | string |
要求されたフィールドの名前 |
|
タイプ
|
articles.fields.type | string |
要求されたフィールドのデータ型 |
|
価値
|
articles.fields.value | string |
要求されたフィールドの値 |
|
Link
|
articles.Link | string |
記事へのリンク |
|
id
|
articles.id | string |
サポート情報 [kb_knowledge] テーブルからのサポート情報記事 sys_id |
|
回数
|
articles.number | string |
サポート情報 [kb_knowledge] テーブルからのサポート情報記事 sys_id |
|
Rank
|
articles.rank | float |
この検索に固有の記事の検索順位 |
|
スコア
|
articles.score | float |
関連性スコア、スコアで降順に並べ替えられた結果 |
|
スニペット
|
articles.snippet | string |
サポート情報記事のごく一部を示すテキスト |
|
肩書き
|
articles.title | string |
サポート情報記事の簡単な説明またはタイトル |