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 ヘッダー。
| String |
認証タイプ | 認証なし、ベーシック認証、または OAuth 認証を選択します。 ベーシック認証が構成されている場合、ユーザー名とパスワードを入力するための追加フィールドが表示されます。 OAuth 認証が構成されている場合、構成するためのポップアップ ウィンドウが表示されます。
上記を指定すると接続がテストされ、ユーザーはクリックして JSON レスポンス内のアクセス トークンを特定する必要があります。 | さまざまなパラメーター |
URL パラメーター | 指定した Web サイトに送信される HTTP リクエストの URL に含める、オプションの URL パラメーター。 パラメーターは、上述の [URL] パラメーターでも設定できますが、ここで別のパラメーターとして入力された URL パラメーターは [URL] パラメーターで指定された一致するパラメーターをオーバーライドします。 このパラメーターで定義される URL パラメーターは、常に URL エンコードされます。 | キーと値のペア |
カスタム ヘッダー | 指定した Web サイトに送信される HTTP リクエストに含めるオプションのカスタム ヘッダー。 たとえば、カスタム ヘッダーを使用して、サード パーティ API キーや認証ヘッダーを指定できます。 | キーと値のペア |
その他のログ | 必要に応じて、未処理の HTTP リクエストと Velocity が発行した応答のログ出力を有効にします。 注意:このパラメーターは、トラブルシューティングの目的でのみ有効にし、トラブルシューティングが完了したら無効にする必要があります。 有効にした後は、解析を開始すると、デバッグ レベルのログが解析ログ ページで使用できるようになります。 必要に応じて、トラブルシューティングについて Esri テクニカル サポートにお問い合わせください。 | Boolean |
検討事項および制限事項
HTTP 出力を使用する際は、以下の点に注意してください。
- OAuth 認証を使用する場合:
- 出力の作成時に、認証サーバーと関連付けられたデータ エンドポイントへの複数のリクエストが発生します。 一部の API では、特定のリクエストに対するレート制限が実装されており、これが出力の作成に影響する可能性があります。
- セキュリティ上の理由から、アクセス トークン リクエストの POST ボディは、認証パラメーターを編集する際に再構成する必要があります。
- インターネット上で、外部から Web サーバーにアクセスできる必要があります。