Important

翻译是一项社区工作：ref：你可以加入<translation_guidelines>。此页面目前翻译进度为 45.41%。

24.1.11. Metadata tools

24.1.11.1. Add history metadata

Added in 3.42

Adds a new history entry to the layer's metadata.

参数

标注	名称	类型	描述
Layer	INPUT	[layer]	The input layer (vector, raster, etc.) to which the history entry will be added.
History entry	HISTORY	[string]	The text to be appended as a new entry in the layer's history metadata. This will be added to any existing history entries.

输出

标注	名称	类型	描述
Output	OUTPUT	[same as input]	The resulting layer with the updated history in its Metadata properties.

Python代码

Algorithm ID: native:addhistorymetadata

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

当你在数据处理工具箱某个算法前悬停时，算法 id 将会展现。*参数字*将会提供参数的名称与数值。参考详见`数据处理_控制台`以获取如何从Python控制台中运行数据处理算法。

24.1.11.2. Copy Layer Metadata

Added in 3.42

Copies metadata from a source layer to a target layer. Any existing metadata in the target layer will be replaced with the metadata from the source layer. This includes all metadata fields, such as history, abstract, and other properties.

参数

标注	名称	类型	描述
Source layer	SOURCE	[layer]	The layer from which metadata will be copied.
Target layer	TARGET	[layer]	The layer to which metadata will be pasted. Any existing metadata in this layer will be replaced.
Save metadata as default	DEFAULT	[boolean] Default: False	If checked, the metadata information will be saved with the layer, hence available by default in subsequent projects.

输出

标注	名称	类型	描述
Output layer	OUTPUT	[layer]	The target layer with the metadata replaced by the metadata from the source layer. This includes all metadata fields, such as history, abstract, and other properties.

Python代码

Algorithm ID: native:copylayermetadata

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

当你在数据处理工具箱某个算法前悬停时，算法 id 将会展现。*参数字*将会提供参数的名称与数值。参考详见`数据处理_控制台`以获取如何从Python控制台中运行数据处理算法。

24.1.11.3. Export Layer Metadata

Added in 3.42

Exports the metadata of a layer to a QMD file.

参数

标注	名称	类型	描述
Layer	INPUT	[layer]	The layer whose metadata will be exported.
Output	OUTPUT	[file] 默认: [保存到临时文件]	Specification of the output file. One of: 保存到临时文件 保存到文件…

输出

标注	名称	类型	描述
Output file	OUTPUT	[file]	The .qmd file containing the exported metadata. This file can be used to import metadata into another layer.

Python代码

Algorithm ID: native:exportlayermetadata

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

当你在数据处理工具箱某个算法前悬停时，算法 id 将会展现。*参数字*将会提供参数的名称与数值。参考详见`数据处理_控制台`以获取如何从Python控制台中运行数据处理算法。

24.1.11.4. Set Layer Metadata

Added in 3.42

Applies metadata to a layer from a .qmd file.

参数

标注	名称	类型	描述
Layer	INPUT	[layer]	The layer to which the metadata will be applied.
Metadata file	METADATA	[file]	The .qmd file containing the metadata to be applied.
Save metadata as default	DEFAULT	[boolean] Default: False	If checked, the metadata information will be saved with the layer, hence available by default in subsequent projects.

输出

标注	名称	类型	描述
Output layer	OUTPUT	[same as input]	The input layer with the metadata replaced by the metadata from the .qmd file.

Python代码

Algorithm ID: native:setlayermetadata

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

当你在数据处理工具箱某个算法前悬停时，算法 id 将会展现。*参数字*将会提供参数的名称与数值。参考详见`数据处理_控制台`以获取如何从Python控制台中运行数据处理算法。

24.1.11.5. Set Metadata Fields

Added in 3.42

Sets various metadata fields for a layer.

参数

标注	名称	类型	描述
Layer	INPUT	[layer]	The layer whose metadata fields will be updated
Identifier 可选	IDENTIFIER	[string]	A unique identifier for the layer
Parent identifier 可选	PARENT_IDENTIFIER	[string]	The identifier of the parent resource, if applicable
Title 可选	TITLE	[string]	The title of the layer
Type 可选	TYPE	[string]	The type of data stored in the layer
Language 可选	LANGUAGE	[string]	The language of the metadata
Encoding 可选	ENCODING	[string]	The character encoding used in the metadata
Abstract 可选	ABSTRACT	[string]	A brief description or abstract of the layer
Coordinate reference system 可选	CRS	[crs]	The coordinate reference system of the layer
Fees 可选	FEES	[string]	Information about any fees associated with accessing the layer
Ignore empty fields	IGNORE_EMPTY	[boolean] Default: False	If checked, no update will be done to metadata fields that are not filled

输出

标注	名称	类型	描述
Output layer	OUTPUT	[same as input]	The input layer with the specified metadata fields updated.

Python代码

Algorithm ID: native:setmetadatafields

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

当你在数据处理工具箱某个算法前悬停时，算法 id 将会展现。*参数字*将会提供参数的名称与数值。参考详见`数据处理_控制台`以获取如何从Python控制台中运行数据处理算法。

24.1.11.6. Update Layer Metadata

Added in 3.42

Copies all non-empty metadata fields from a source layer to a target layer. Leaves empty input fields unchanged in the target.

参数

标注	名称	类型	描述
Source layer	SOURCE	[layer]	The layer from which non-empty metadata fields will be copied
Target layer	TARGET	[layer]	The layer to which non-empty metadata fields will be pasted. Empty fields in the source layer will not overwrite existing metadata in the target layer.

输出

标注	名称	类型	描述
Target layer	OUTPUT	[layer]	The target layer with updated metadata.

Python代码

Algorithm ID: native:updatelayermetadata

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

当你在数据处理工具箱某个算法前悬停时，算法 id 将会展现。*参数字*将会提供参数的名称与数值。参考详见`数据处理_控制台`以获取如何从Python控制台中运行数据处理算法。