Importante

A tradução é um esforço comunitário você pode contribuir. Esta página está atualmente traduzida em 24.82%.

24.1.4. File tools

24.1.4.1. Download file via HTTP(S)

Downloads a URL to the file system with an HTTP(S) GET or POST request.

Parâmetros

Basic parameters

Label	Nome	Type	Descrição
URL	URL	[string]	The URL of the file to download.
File destination	OUTPUT	[string] Default: [Save to temporary file]	Specification of the file destination. One of: Save to a Temporary File Save to File…

Advanced parameters

Label	Nome	Type	Descrição
Method	METHOD	[enumeration] Default: 0	The HTTP method to use for the request. Options are: 0 — GET 1 — POST
Data Opcional	DATA	[string]	The data to add in the body if the request is a POST.

Resultados

Label	Nome	Type	Descrição
File destination	OUTPUT	[string]	The location of the downloaded file

Python code

Algorithm ID: qgis:filedownloader

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

The algorithm id is displayed when you hover over the algorithm in the Processing Toolbox. The parameter dictionary provides the parameter NAMEs and values. See Usando os algoritmos do processamento a partir da consola for details on how to run processing algorithms from the Python console.

24.1.4.2. HTTP(S) POST/GET request

Performs a HTTP(S) POST/GET request and returns the HTTP status code and the reply data. If an error occurs then the error code and the message will be returned. Optionally, the result can be written to a file on the disk. By default the algorithm will warn on errors. Optionally, the algorithm can be set to treat HTTP errors as failures.

Parâmetros

Label	Nome	Type	Descrição
URL or file path	URL	[string]	The URL or path of the file to open.
Method	METHOD	[enumeration] Default: 0	The HTTP method to use for the request. Options are: 0 — GET 1 — POST
POST Data Opcional	DATA	[string]	The data to add in the body if the request is a POST.
Authentication Opcional	AUTH_CONFIG	[authconfig] Default: No authentication	An authentication configuration to pass
Consider HTTP errors as failures	FAIL_ON_ERROR	[boolean] Default: False	If set, the algorithm will fail on encountering an HTTP error.
File destination Opcional	OUTPUT	[string] Default: [Skip Output]	The result can be written to a file instead of being returned as a string. Specification of the file destination. One of: Skip Output Save to a Temporary File Save to File…

Resultados

Label	Nome	Type	Descrição
File destination	OUTPUT	[file]	The downloaded file with the returned result
HTTP Status	STATUS_CODE	[string]	The HTTP Status
Network error code	ERROR_CODE	[string]	The error code when it fails (like as well on 404 HTTP Status etc.)
Network error message	ERROR_MESSAGE	[string]	A string containing the error message in case of failure
Result data	RESULT_DATA	[string]	A string containing the result data in case of success

Python code

Algorithm ID: native:httprequest

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

The algorithm id is displayed when you hover over the algorithm in the Processing Toolbox. The parameter dictionary provides the parameter NAMEs and values. See Usando os algoritmos do processamento a partir da consola for details on how to run processing algorithms from the Python console.

24.1.4.3. Open file or URL

Opens files in their default associated application, or URLs in the user’s default web browser.

Parâmetros

Label	Nome	Type	Descrição
URL or file path	URL	[string]	The URL or path of the file to open.

Resultados

The algorithm has no output.

Python code

Algorithm ID: native:openurl

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

The algorithm id is displayed when you hover over the algorithm in the Processing Toolbox. The parameter dictionary provides the parameter NAMEs and values. See Usando os algoritmos do processamento a partir da consola for details on how to run processing algorithms from the Python console.