HTTP

ArcGIS Velocity の HTTP 出力を使用すると、フィーチャおよびその他のテキストを POST、PUT、または DELETE リクエストを介して HTTP エンドポイントに送信できます。 リクエストは、出力に送信された出力フィーチャごとに送信されます。

あるアナリストは、HTTP 出力を構成して、指定した Webhook にカスタム JSON 形式のフィーチャを送信します。

使用上の注意

HTTP 出力を操作する際には、以下の点に注意してください。

  • リクエストの本文で JSON を送信する際は、JSON の書式を適切に設定するために、JSON を Text() Arcade 条件式で囲みます。
  • HTTP 出力を使用する場合、データの速度を理解することが重要です。 HTTP 出力を使用する場合、データの速度を理解することが重要です。 これによって、すぐに Web サーバーの能力またはレート設定に過度な負荷をかける可能性があります。 発生頻度が低いことが予想されるインシデントには、HTTP 出力を使用します。
  • OAuth 認証を使用する場合:
    • HTTP 出力タイプは、Client Credentials グラント種別または Password グラント種別に準拠した OAuth 2.0 for HTTP エンドポイントを使用した認証をサポートします。 これらの OAuth グラント種別は、アクセス トークンを取得するための HTTP リクエストの構成を含むパターンに準拠します。 アクセス トークン リクエストの構成時に、OAuth 認証サーバーからのレスポンスに含まれるアクセス トークンおよび有効期限 JSON キー フィールドを特定するよう求められます。 有効期限を選択した場合は、有効期限のタイプ (期間またはタイムスタンプ) と単位を定義する必要があります。
    • データ リクエストの構成に戻るとき、グローバル変数 $accessToken を使用して、アクセス トークンが使用される場所を定義する必要があります。 これは多くの場合、Authorization カスタム ヘッダーの Bearer $accessToken 値に含まれています。

パラメーター

以下は、HTTP 出力のパラメーターです。

パラメーター説明データ タイプ

URL

出力リクエストが送信されるときに経由する URL。

String

HTTP メソッド

リクエストの HTTP メソッド。 選択肢は [POST][PUT]、および [DELETE] です。

String

POST body

JSON Arcade 条件式。

Arcade 式

Content-Type

送信リクエストの content-type ヘッダー。

  • [プレーン テキスト]: text/plain
  • [JSON]: application/json
  • [CSV]: text/csv
  • [XML]: text/xml

String

認証タイプ

認証なし、ベーシック認証、または OAuth 認証を選択します。

ベーシック認証が構成されている場合、ユーザー名とパスワードを入力するための追加フィールドが表示されます。

OAuth 認証が構成されている場合、構成するためのポップアップ ウィンドウが表示されます。

  • アクセス トークン エンドポイント
  • HTTP メソッド
  • URL パラメーター
  • カスタム ヘッダー

上記を指定すると接続がテストされ、ユーザーはクリックして JSON レスポンス内のアクセス トークンを特定する必要があります。

さまざまなパラメーター

URL パラメーター

指定した Web サイトに送信される HTTP リクエストの URL に含める、オプションの URL パラメーター。

パラメーターは、上述の [URL] パラメーターでも設定できますが、ここで別のパラメーターとして入力された URL パラメーターは [URL] パラメーターで指定された一致するパラメーターをオーバーライドします。

このパラメーターで定義される URL パラメーターは、常に URL エンコードされます。

キーと値のペア

カスタム ヘッダー

指定した Web サイトに送信される HTTP リクエストに含めるオプションのカスタム ヘッダー。 たとえば、カスタム ヘッダーを使用して、サード パーティ API キーや認証ヘッダーを指定できます。

キーと値のペア

その他のログ

必要に応じて、未処理の HTTP リクエストと Velocity が発行した応答のログ出力を有効にします。

注意:

このパラメーターは、トラブルシューティングの目的でのみ有効にし、トラブルシューティングが完了したら無効にする必要があります。 有効にした後は、解析を開始すると、デバッグ レベルのログが解析ログ ページで使用できるようになります。 必要に応じて、トラブルシューティングについて Esri テクニカル サポートにお問い合わせください。

Boolean

検討事項および制限事項

HTTP 出力を使用する際は、以下の点に注意してください。

  • OAuth 認証を使用する場合:
    • 出力の作成時に、認証サーバーと関連付けられたデータ エンドポイントへの複数のリクエストが発生します。 一部の API では、特定のリクエストに対するレート制限が実装されており、これが出力の作成に影響する可能性があります。
    • セキュリティ上の理由から、アクセス トークン リクエストの POST ボディは、認証パラメーターを編集する際に再構成する必要があります。
  • インターネット上で、外部から Web サーバーにアクセスできる必要があります。