Skip to content

Commit

Permalink
Update WCS client section (#9528)
Browse files Browse the repository at this point in the history
  • Loading branch information
DelazJ authored Jan 10, 2025
2 parents 86bb686 + 37383b8 commit c0fa165
Show file tree
Hide file tree
Showing 2 changed files with 61 additions and 7 deletions.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
68 changes: 61 additions & 7 deletions docs/user_manual/working_with_ogc/ogc_client_support.rst
Original file line number Diff line number Diff line change
Expand Up @@ -640,14 +640,66 @@ network settings (especially proxy). It is also possible to select cache mode
('always cache', 'prefer cache', 'prefer network', 'always network'), and the provider also
supports selection of time position, if temporal domain is offered by the server.

.. warning::
**Loading a WCS Layer**

To be able to load a WCS Layer, first create a connection to the WCS server:

#. Open the :guilabel:`Data Source Manager` dialog by pressing the
|dataSourceManager| :sup:`Open Data Source Manager` button
#. Enable the |addWcsLayer| :guilabel:`WCS` tab
#. Click on :guilabel:`New...` to open the :guilabel:`Create a New WCS
Connection` dialog

.. _figure_OGC_create_wcs_connection:

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

Creating a connection to a WCS server

* :guilabel:`Name`: A name for the connection. This name will be used in
the Server Connections drop-down box so that you can distinguish it from
other WCS servers.
* :guilabel:`URL`: URL of the server providing the data. This must be a
resolvable host name -- the same format as you would use to open a telnet
connection or ping a host, i.e. the base URL only.
For example, you shouldn't have fragments such as ``request=GetCapabilities``
or ``version=1.0.0`` in your URL.
* :guilabel:`Authentication` (optional): using a :ref:`stored configuration
<authentication_workflow>` or a basic authentication with
:guilabel:`Username` and :guilabel:`Password`.

.. warning::

Entering **username** and **password** in the :guilabel:`Authentication`
tab will keep unprotected credentials in the connection configuration.
Those **credentials will be visible** if, for instance, you shared the
project file with someone. Therefore, it's advisable to save your
credentials in an *Authentication configuration* instead
(:guilabel:`Configurations` tab).
See :ref:`authentication_index` for more details.

* HTTP :guilabel:`Referer`
* |unchecked| :guilabel:`Ignore GetCoverage URI reported in capabilities`:
if checked, use given URI from the :guilabel:`URL` field above.
* |unchecked| :guilabel:`Ignore reported layer extents`: because the extent
reported by raster layers may be smaller than the actual area which can
be rendered (notably for WCS servers with symbology which takes more space
than the data extent), check this option to avoid cropping raster layers
to their reported extents, resulting in truncated symbols on the borders
of these layers.
* |unchecked| :guilabel:`Ignore axis orientation`
* |unchecked| :guilabel:`Invert axis orientation`
* |unchecked| :guilabel:`Smooth pixmap transformation`

#. Press :guilabel:`OK` to create the connection.

Note that any proxy settings you may have set in your preferences are also recognized.
Also note that it is possible to :guilabel:`Load` the connection parameters
from a :file:`.XML` file or :guilabel:`Save` them to a :file:`.XML` file.

Now we are ready to load WCS layers from the above connection.

Entering **username** and **password** in the :guilabel:`Authentication` tab
will keep unprotected credentials in the connection configuration. Those
**credentials will be visible** if, for instance, you shared the project file
with someone. Therefore, it's advisable to save your credentials in a
*Authentication configuration* instead (:guilabel:`configurations` tab).
See :ref:`authentication_index` for more details.

.. _`ogc-wfs`:

Expand Down Expand Up @@ -780,6 +832,8 @@ features and view the attribute table.
please add it also to the substitutions.txt file in the
source folder.
.. |addWcsLayer| image:: /static/common/mActionAddWcsLayer.png
:width: 1.5em
.. |addWfsLayer| image:: /static/common/mActionAddWfsLayer.png
:width: 1.5em
.. |addWmsLayer| image:: /static/common/mActionAddWmsLayer.png
Expand Down

0 comments on commit c0fa165

Please sign in to comment.