ServiceNow

ServiceNow サービス レベルを向上させ、従業員に活力を与え、企業が光速で作業できるようにします。 インシデント、質問、ユーザーなどを含む ServiceNow 内に保存されているレコードを、作成、読み取り、更新を実行します。

このコネクタは、次の製品および地域で利用可能です。

Service クラス 地域
Logic Apps 標準 以下を除くすべての Logic Apps 地域 :
     -   米国国防総省 (DoD)
Power Automate Premium 以下を除くすべての Power Automate 地域 :
     -   21 Vianet が運用する中国のクラウド
Power Apps プレミアム 以下を除くすべての Power Apps 地域 :
     -   21 Vianet が運用する中国のクラウド
Connector Metadata
発行者 マイクロソフト
Web サイト https://www.servicenow.com/
プライバシー ポリシー https://www.servicenow.com/privacy-statement.html

注意

「サポート情報記事を取得」操作は、Knowledge API (sn_km_api) プラグインがアクティブ化されている場合にのみ使用できます。

既知の問題と制限事項

  1. レコードの作成アクションを使用するときに、レコードの完全な説明を指定することができません。 Service-Now REST API の制限により、フィールドの値は無視されます。

  2. レコード取得アクションは、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 をコンマで区切ったリストです。

戻り値

レコードの一覧を表示

「インシデント」のような特定の 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

参照リンクを除外する必要があるかどうかを決定

戻り値

この操作の出力は状況に応じて変わります。

レコードの種類を取得

使用可能なレコードタイプを一覧表示

戻り値

本文​​
GetTypesResponse

レコードを取得

「インシデント」のような 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

サポート情報記事の簡単な説明またはタイトル