Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Document layer metadata search #7770

Merged
merged 4 commits into from Sep 20, 2022
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
177 changes: 104 additions & 73 deletions docs/user_manual/introduction/general_tools.rst

Large diffs are not rendered by default.

Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/user_manual/managing_data_source/img/datasource_manager.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
29 changes: 25 additions & 4 deletions docs/user_manual/managing_data_source/opening_data.rst
Expand Up @@ -897,6 +897,8 @@ checkboxes:
* |checkbox| :guilabel:`Use estimated table metadata`
* |checkbox| :guilabel:`Allow saving/loading QGIS projects in the database`
- more details :ref:`here <saveprojecttodb>`
* |checkbox| :guilabel:`Allow saving/loading QGIS layer metadata in the database`
- more details :ref:`here <savemetadatatodb>`

.. tip:: **Use estimated table metadata to speed up operations**

Expand Down Expand Up @@ -1216,6 +1218,25 @@ To load a layer from a database, you can perform the following steps:
:ref:`DB Manager <dbmanager>` to drag and drop the database tables
into the map canvas.

.. _layer_metadata_search_panel:

The Layer Metadata Search Panel
===============================

The layer metadata search panel allows to browse layers metadata,
filter the results by text, by current project and map canvas extent
and add the selected layers to the map canvas.

The sources of metadata are implemented through a layer metadata provider
system that can be extended by plugins, QGIS provides out of the
box the layer metadata provider that retrieves the metadata from the
connections that allow for metadata storage (for more details
:ref:`here <savemetadatatodb>`).
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sorry but i find this sentence long, with too many "metadata" an do not understand it. Can we split it?
Also could be nice to replace the "here" by a more descriptive expression.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

better now?


.. figure:: img/layer_metadata_search_panel.png
:align: center

Layer Metadata Search Panel

QGIS Custom formats
===================
Expand Down Expand Up @@ -1341,7 +1362,7 @@ Press :guilabel:`New` (respectively :guilabel:`New Connection`) and provide:

.. _interpretation:

* :guilabel:`Interpretation`: converts WMTS/XYZ raster datasets to a raster
* :guilabel:`Interpretation`: converts WMTS/XYZ raster datasets to a raster
layer of single band float type following a predefined encoding scheme.
Supported schemes are :guilabel:`Default` (no conversion is done),
:guilabel:`MapTiler Terrain RGB` and :guilabel:`Terrarium Terrain RGB`.
Expand Down Expand Up @@ -1377,7 +1398,7 @@ The XML file for OpenStreetMap looks like this:
<!DOCTYPE connections>
<qgsXYZTilesConnections version="1.0">
<xyztiles url="https://tile.openstreetmap.org/{z}/{x}/{y}.png"
zmin="0" zmax="19" tilePixelRatio="0" password="" name="OpenStreetMap"
zmin="0" zmax="19" tilePixelRatio="0" password="" name="OpenStreetMap"
username="" authcfg="" referer=""/>
</qgsXYZTilesConnections>

Expand Down Expand Up @@ -1416,7 +1437,7 @@ Using ArcGIS REST Servers
-------------------------

ArcGIS REST Servers can be added via the
|addAfsLayer| :guilabel:`ArcGIS REST Server` tab of the
|addAfsLayer| :guilabel:`ArcGIS REST Server` tab of the
:guilabel:`Data Source Manager` dialog or the contextual menu of the
:guilabel:`ArcGIS REST Servers` entry in the :guilabel:`Browser` panel.
Press :guilabel:`New` (respectively :guilabel:`New Connection`) and provide:
Expand All @@ -1430,7 +1451,7 @@ Press :guilabel:`New` (respectively :guilabel:`New Connection`) and provide:

.. note::

ArcGIS Feature Service connections which have their corresponding Portal
ArcGIS Feature Service connections which have their corresponding Portal
endpoint URLS set can be explored by content groups in the browser panel.

If a connection has the Portal endpoints set, then expanding out the connection
Expand Down