サービス/API Thinklet

サービス/API Thinkletは、次のコネクタ認証情報タイプをサポートしています:

ベーシック

ベアラー

OAuth 2.0 - クライアント認証情報

OAuth 2.0 - 認可コード

認証なし

サービス/API Thinkletは外部の公開APIにRESTコールを行います。追加の情報を取得したり、アクションの実行をリクエストするために使用します。

サービス/API Thinkletは次の呼び出し方法をサポートしています:

サービス/API Thinkletのサポートされるペイロードと応答はJSONフォーマットです。

名前: サービス/API Thinkletのためのユニークな名前を入力してください。
ID: システムは名前に基づいてIDを自動的に生成します。
説明 (オプション): Thinkletの目的とその機能を説明してください。この情報は、ワークフロー内であまり知られていない他のユーザーにとって役立ちます。
資格情報: 統合のための接続認証情報を選択してください。まず、管理モジュールのコネクタ認証情報ページでそれを設定する必要があります。詳細については、コネクタ認証情報ドキュメントを参照してください。
リクエストメソッド: リクエスト接続方法を選択してください。
リソース: 接続のエンドポイントを入力してください。
カスタムヘッダーを追加: 必要に応じて最大5つのカスタムヘッダーを追加して追加のメタデータを渡します。認証ヘッダーは代わりに クレデンシャル に追加する必要があります
ペイロード: 外部システムに送信されるJSONペイロードを入力してください。

サービス/API Thinkletは、外部システムへの呼び出しから得られた応答のデータを読み取ることができます。

最大5つの出力をサポートしています。

応答を待っているとき、サービス\API Thinkletは外部システムからの応答を最大10秒間待ち、それ以上経過した場合、呼び出しは失敗したと見なされます。

応答を受信した場合、外部システムから受信した応答の総サイズは、出力が設定されているかどうかに関わらず2MBを超えないこととされます。

これらの出力を設定するには:

出力を追加をクリックします。
名前: コンディションやThinklet入力で参照するための名前を入力してください。
JSON パス: システムが受信することを期待しているデータに対して JSONPath を使用してください。このパスは常に $. で始まり、データへのパスがピリオドで区切られた形式で続きます。
JSON から値を抽出するための重要な要素:
- ルート要素: $
- キーへのアクセス: $.key
- ネストされた要素へのアクセス: $.parent.child
- 最初の配列要素: $.array[0]
- 特別なキーをシングルクォートで囲む: $['@key'], $['key.with.dots']

ヒント: テスト中に JSONPath を解析するためにオンラインコンバーターツールを利用してください。

ServiceNow からインシデント番号を取得する例:

$.result.number

結果の配列から "displayName" 要素を取得する例:

$.value[0].displayName

JSONパス出力の最大サイズは30KBまたは3840文字です。

ワークフローの実行中に収集されたデータと共に users と devices のデータを リソース と ペイロード フィールドで参照してください。

パラメーターと動的な値のドキュメントを参照して、動的な値を参照する方法の詳細を確認してください。

Last updated 1 month ago

Was this helpful?