Downloadツール
ダウンロードツールは、ダウンストリーム処理で使用する、またはファイルに保存するために、指定された URL からデータを取得します。 Downloadツールは、FTPとSFTPを介してデータをダウンロードまたはアップロードすることもできます。
ギャラリーの互換性
このツールは、禁止ツールのAlteryx Analytics Galleryリストにあります。 このツールを含むワークフローを gallery.alteryx.com に発行するための免除を適用します。
ツールを設定する
[基本] タブを使用して、ダウンロードツールの必須コントロールを設定します。
- url フィールド: データのプル (またはデータのアップロード) を行う url (統一リソースロケータ-インターネットリソース) を含む受信データストリームのフィールドを指定します。 これは単に テキスト入力ツール URL がフィールド値として指定されている場所。
- url テキストをエンコード:オンにすると、指定した url が必要に応じてエンコードされ、安全でない ASCII 文字がインターネット経由で送信できる形式に変換されます。 これの例は、スペースの%20の代用です。
- 出力:返されるデータの書式設定方法を指定します。 データは、データフィールドに返されるか、ファイルに出力されます。
- フィールドに:ダウンロードされたコンテンツはデータフィールドとしてデータストリームに返されます。 ダウンロードされたコンテンツは、"ownloadData" という単一のフィールドに格納されます。 このデータは、次のようなダウンストリームツールを使用して解析する必要があります。 列分割ツール、 正規表現ツール、または フォーミュラツール。
- string:データは、新しいワイド文字列型フィールドとして返されます。 ワイド文字列は Unicode ®文字をサポートしています。
- blob:データは、新しい blob 型フィールドとして返されます。 Blobは、バイナリラージオブジェクトとも呼ばれます。 画像ファイルは通常、この形式で保存されます。 イメージを使用するには、am 画像ツール を選択し、イメージまたは Blob フィールドを指定します。
- ファイルへ
- 一時ファイル:データは一時ファイルに出力され、ユーザーの一時ディレクトリに格納されます。 Alteryx での一時ファイル処理の詳細については、 Alteryxと一時ファイル。
- フィールドからのファイル名:データは特定のファイルに出力されます。 ドロップダウンを使用して、出力先のファイル名を含むフィールドを選択します。
のいずれかを選択します。 コードページ エンコードに使用します。 デフォルトは utf-8 です。 最も一貫した結果を得るには、アプリケーションで特定のコードページの代わりにUTF-8(コードページ65001)やUTF-16などのUnicodeを使用する必要があります。
[ヘッダー] タブを使用して、 web 要求と共に送信されるHTTP ヘッダーを変更します。
- 次の定数値から追加:固定ヘッダー値を追加できます。
- およびこれらのフィールドの値:レコードデータから値を取得し、ヘッダー値を作成します。
[ペイロード] タブを使用して、実行する HTTP アクションを設定し、必要に応じて web 要求のクエリ文字列または本文を作成します。
- http アクション: web 要求の http アクションを選択します。 選択肢には次が含まれます:
- get (または ftp): get 要求を実行するか、ftp または SFTP サイトからファイルをダウンロードします。 このオプションは、このタブに他のオプションを入力せずに使用することができ、選択したURLをダウンロードします。
- post:選択した URL に対する post 要求を実行します。 通常、このオプションを使用する場合は、以下のオプションを使用してPOST本文を指定します。
- put: put 要求を実行します。 このオプションでは、blob フィールドからクエリ本体を実行できるのは、 Blob入力ツール。 通常、ファイルをリモートサーバーにアップロードするために使用されます。
- 削除:削除要求を実行します。 通常、リモートサーバーに指定されたリソースを削除するよう要求するために使用されます。
- ヘッド:ヘッド要求を実行します。 これは、ヘッダーデータを返すが、本体データは返さないようにサーバーに要求します。
- カスタム:テキストボックスにカスタム動詞を入力できます。 このリクエストに関する他のすべては、POSTと同じように動作します。 POST動詞は、要求が行われる直前にカスタム動詞に置き換えられます。
- 次のクエリ文字列/本文オプションから選択します:
- 作成クエリ文字列/本文:
- 次の定数値から:クエリ文字列/本文に定数名の値のペアを追加します。
- およびこれらのフィールドの値:受信データレコードから名前の値のペアを取得します。 フィールド名は、クエリ文字列/本文で使用されている名前です
- コンテンツタイプ:名前の値のペアのエンコード方法を制御します。
- アプリケーション/x-www-フォーム-urlencoded:例. Name1 = Value1 & Name2 = Value2 & Name3 = Value3 安全でないASCII文字は自動的にエンコードされるため、データがまだエンコードされていないことを確認してください。
- マルチパート/フォームデータ: HTTP アクションの POST と Custom を使用している場合にのみ使用できます。
- [フィールドからクエリ文字列/本文を取る]:クエリ文字列/本文データを含む入力データのフィールドを選択します。 Blobフィールドは、HTTPアクションPOST、PUT、およびカスタムを使用するときに選択できます。
- [クエリ文字列/本文に次を使用]: テキストボックスでは、クエリ文字列または本体の内容を手動で入力できます。
動詞のサポート
これらのオプションは、要求を送信するリモートサーバーが特定の動詞をサポートする場合にのみ機能します。 使用しているURLのAPIドキュメントを見て、サポートされているリクエストは何かを確認します。
すべてのテキストデータは、リモートウェブサーバーに送信される前にUTF-8でエンコードされます。
[接続] タブを使用して、接続資格情報を設定します。
- ユーザー名:上記の URL 仕様で必要に応じて、ユーザの名前を入力します。 これはオプションのフィールドです。
- パスワード:上記の URL 仕様で必要に応じてパスワードを入力します。 これはオプションのフィールドです。
- [最大接続数]: ダウンロードツールが実行する最大同時転送回数を指定します。 Downloadツールに複数の入力レコードが送信された場合にのみ、転送が並行して行われます。 複数のDownloadツールは独立して動作しますが、通常は同時に機能しません。 ワークフローに追加された新しいDownloadツールの場合、デフォルトの接続数は2であり、接続の最大数は32です。
- タイムアウト (秒):応答しない接続が原因でタイムアウトを報告するまでの待ち時間を秒単位で指定します。 0(タイムアウトなし)から10,000までの数値を選択します。
接続数を増やすと、すべての転送を完了するまでの合計時間が短縮されることがありますが、使用されているサーバーに過負荷がかかる可能性があるため、多すぎる数を設定しないように注意してください。 サーバーを誤って使用していると思われる場合、サーバーは応答を停止したり、エラーを報告したり、接続を拒否する可能性があります。 これは、あなたの管理下にないパブリックサイトにアクセスする際には特に重要です。 ほとんどのウェブブラウザでは最大6回の同時転送が行われますが、これらは通常、ウェブページの一部として比較的小さな転送になります。 どのように構成されているかをより詳細に制御できる、自分の業務内にあるサーバーの場合、より多くの接続を使用することもできます。
さらに、Downloadツールは転送が完了するとレコードを下流に送信するため、レコードがツールを通過する際にレコードの順序が変更される可能性があります。 順序がワークフローに関係する場合は、結果をソートしたり、接続数を1に制限したりしてください。 最後に、空のURLは実際の転送が必要なものより先に処理されることに注意してください。
その他の考慮事項
ダウンロードツールの使用時に接続の遅延を回避するには、アカウントのインターネットのプロパティ (コントロールパネル > [インターネットオプション] > [接続] > [LAN の設定]) で [設定を自動的に検出する] オプションが選択解除されていることを確認します。