(ui-settings)= # Configuration via Experience Builder Settings The ncWMS widget comes with a settings interface to customize it's content via the Experience Builders standard settings UI. Here you can manually create and modify _WMS Configs_ and their visualizations. ```{note} Configuration you do via data sources (see {ref}`datasource-settings`) will be merged into the configuration make via the settings UI. The configuration via the settings UI however takes precedency over the data sources. ``` ## Removing the default configs Likely you do not want to visualize the services that are configured by default, so you just remove them by clicking the little trash icon next to their label in the _WMS configuration_ setting section ![remove config screenshot](screenshots/remove-config.png) You can do so for each and every service, or you customize an existing config as described in the next section. ## Adding a new config To add a new config, you have two options: 1. manually entering a label and modifying it 2. uploading a config from your computer ### Manually Click the ncWMS widget in your experience builder and in the sidebar, look for the section _Add New WMS Configuration_. Select the _Manual_ tab, enter a label for the config and click _Add Configuration_ ![manual way to add a new WMS config](screenshots/manual-new-config.png) You can then add and modify services as described in the next section {ref}`modify-config`. ### Via upload You can upload a json file, such as {download}`this one here ` to create a new config. Click the ncWMS widget in your experience builder and in the sidebar, look for the section _Add New WMS Configuration_. Select the _Upload_ tab, click the _Upload WMS config_ button and select the JSON file with the configuration. ![upload button for new WMS config](screenshots/upload-config.png) You can then modify the config as described in the next section {ref}`modify-config`. (modify-config)= ## Modifying an existing config To modify an existing service, click the _ncWMS widget_ in your experience builder. In the now open settings sidebar for the widget, look for the service in the _WMS Configuration_ section. ### Modifying an existing service Each service in a config (or in other words each netCDF file) is available through a button in the _Services_ section for the config ![service list screenshot](screenshots/service-list.png) To configure a service (i.e. it's label and the `GetCapabilities` url), click it's button and edit the URL and label in the appearing sidebar ![screenshot for modifying a service](screenshots/modify-service.png) label : The label determines the name of the tab for the service. If the _WMS config_ has only one single service, there will be no tabs and the label does not have any effect. url : The URL of the service is the so-called `GetCapabilities` provided by your ncWMS-Server. If your using a THREDDS-Server ([this one here][thredds-example] for instance), you can get this by copying the URL of the _WMS_-Link in the _Access_-Section of your netCDF file ![screenshot for getting a WMS GetCapabilities URL](screenshots/get-wms-url.png) [thredds-example]: https://thredds.hcdc.hereon.de/thredds/catalog/cD4_wfns_offs_E5_chr_ALHFL_S/catalog.html?dataset=cD4_wfns_offs_E5_chr_ALHFL_S/cD4_wfns_offs_E5_chr_ALHFL_S_2022.nc ### Adding a new service To add a new service, simply click the _+ Add Service_ button and then configure it as described in the previous section. ![button to add a new service](screenshots/add-service-button.png) ### Deleting a service Self-explanatory, but for the sake of completeness: click the little trash icon next to the button of the service to delete it ![button to deleta a service](screenshots/delete-service.png) ### Modifying the default dimensions and visualizations At the bottom of each _WMS Config_ section you find a button named _{octicon}`gear` Default dimensions_. It can either be just white text, or it has a little red {octicon}`info;1em;sd-text-danger` symbol at the end ![Button to configure dimensions](screenshots/dimensions-button.png) This little red {octicon}`info;1em;sd-text-danger` symbol indicates that some default visualization and dimensions have been selected for this _WMS Config_. To restore the default state (i.e. let the ncWMS server decide what and how to visualize), click the _Reset_ button next to it. By clicking the _{octicon}`gear` Default dimensions_, another sidebar will open where you can configure the default dimension and visualizations. ![sidebar to modify dimensions](screenshots/dimension-sidebar.png) ```{warning} The available color settings are loaded from the ncWMS server. As such, for technical reasons, you might not see them in the beginning. If so, just click the _{octicon}`gear` Default dimensions_ again. ```