重要

翻訳は あなたが参加できる コミュニティの取り組みです。このページは現在 100.00% 翻訳されています。

24.1.4. ファイルツール

24.1.4.1. HTTP(S)でファイルをダウンロード

URLをHTTP(S) GETまたはPOSTリクエストでファイルシステムにダウンロードします。

パラメータ

基本パラメータ

ラベル

名前

データ型

説明

URL

URL

[文字列]

ダウンロードしたいファイルのURL

ファイルのダウンロード先

OUTPUT

[文字列]

デフォルト: [一時ファイルに保存]

ファイルの行先を指定します。次のいずれかです:

  • 一時ファイルに保存

  • ファイルに保存...

詳細パラメータ

ラベル

名前

データ型

説明

方法

METHOD

[列挙型]

デフォルト: 0

リクエストに使うHTTPメソッド。選択肢は:

  • 0 --- GET

  • 1 --- POST

Data

オプション

DATA

[文字列]

リクエストが POSTの場合に本体に加えるデータ。

出力

ラベル

名前

データ型

説明

ファイルのダウンロード先

OUTPUT

[文字列]

ダウンロードしたファイルの保存場所

Python コード

Algorithm ID: qgis:filedownloader

import processing
processing.run("algorithm_id", {parameter_dictionary})

algorithm id は、プロセシングツールボックス内でアルゴリズムにマウスカーソルを乗せた際に表示されるIDです。 parameter dictionary は、パラメータの「名前」とその値を指定するマッピング型です。Python コンソールからプロセシングアルゴリズムを実行する方法の詳細については、 プロセシングアルゴリズムをコンソールから使う を参照してください。

24.1.4.2. HTTP(S) POST/GETリクエスト

HTTP(S) POST/GETリクエストを実行し、HTTPステータスコードと応答データを返します。エラーが発生した場合、エラーコードとメッセージが返されます。オプションで、結果をディスク上のファイルに書き込むことができます。デフォルトでは、アルゴリズムはエラー時に警告を出します。オプションで、アルゴリズムをHTTPエラーを失敗として扱うように設定できます。

パラメータ

ラベル

名前

データ型

説明

URLまたはファイルのパス

URL

[文字列]

URLまたは開くファイルのパス

方法

METHOD

[列挙型]

デフォルト: 0

リクエストに使うHTTPメソッド。選択肢は:

  • 0 --- GET

  • 1 --- POST

POSTデータ

オプション

DATA

[文字列]

リクエストが POSTの場合に本体に加えるデータ。

認証

オプション

AUTH_CONFIG

[authconfig]

デフォルト: 認証なし

通過するための認証設定

HTTPエラーを失敗とみなす

FAIL_ON_ERROR

[ブール値]

デフォルト: False

セットしたとき、HTTPエラーが起きるとアルゴリズムは失敗します。

ファイルのダウンロード先

オプション

OUTPUT

[文字列]

デフォルト: [Skip Output]

結果を文字列として返す代わりにファイルに書き込むことができます。ファイルの行先を指定します。次のいずれかです:

  • 出力をスキップ

  • 一時ファイルに保存

  • ファイルに保存...

出力

ラベル

名前

データ型

説明

ファイルのダウンロード先

OUTPUT

[ファイル]

返された結果を含むダウンロードしたファイル

HTTPステータス

STATUS_CODE

[文字列]

HTTPステータス

ネットワークエラーコード

ERROR_CODE

[文字列]

失敗したときのエラーコード(404 HTTPステータスなどと同様)

ネットワークエラーメッセージ

ERROR_MESSAGE

[文字列]

失敗したときのエラーメッセージを格納する文字列

結果データ

RESULT_DATA

[文字列]

成功したときの結果データを格納する文字列

Python コード

Algorithm ID: native:httprequest

import processing
processing.run("algorithm_id", {parameter_dictionary})

algorithm id は、プロセシングツールボックス内でアルゴリズムにマウスカーソルを乗せた際に表示されるIDです。 parameter dictionary は、パラメータの「名前」とその値を指定するマッピング型です。Python コンソールからプロセシングアルゴリズムを実行する方法の詳細については、 プロセシングアルゴリズムをコンソールから使う を参照してください。

24.1.4.3. ファイルまたはURLを開く

関連づけられたデフォルトのアプリケーションでファイルを開く、若しくは、デフォルトのWebブラウザでURLを開きます。

パラメータ

ラベル

名前

データ型

説明

URLまたはファイルのパス

URL

[文字列]

URLまたは開くファイルのパス

出力

このアルゴリズムに出力はありません。

Python コード

Algorithm ID: native:openurl

import processing
processing.run("algorithm_id", {parameter_dictionary})

algorithm id は、プロセシングツールボックス内でアルゴリズムにマウスカーソルを乗せた際に表示されるIDです。 parameter dictionary は、パラメータの「名前」とその値を指定するマッピング型です。Python コンソールからプロセシングアルゴリズムを実行する方法の詳細については、 プロセシングアルゴリズムをコンソールから使う を参照してください。