Skip to content

Commit

Permalink
Update WCS client section
Browse files Browse the repository at this point in the history
- Add screenshot of Create a New Connection dialog
- Fix #9466
  • Loading branch information
domi4484 committed Jan 7, 2025
1 parent ebf742b commit 08bb354
Show file tree
Hide file tree
Showing 2 changed files with 60 additions and 8 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: 60 additions & 8 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::

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.
**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 WMS 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 (WMS 1.3/WMTS)`
* |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 WFS layers from the above connection.


.. _`ogc-wfs`:

Expand Down

0 comments on commit 08bb354

Please sign in to comment.