...

• Anchor
  toml toml

  Configuration files:
  • TOML → https://toml.io

• Anchor
  sld-links sld-links

  Layer Styling
  
  • OGC SLD specification → https://www.ogc.org/standard/sld/
  • GeoServer SLD reference
    • https://docs.geoserver.org/2.21.x/en/user/styling/sld/index.html (release currently used by O2A SDI 01 Nov 2023)
    • https://docs.geoserver.org/main/en/user/styling/sld/index.html (current stable release)

• Anchor
  vef-meta-temp vef-meta-temp

  VEF Metadata Templates: Markdown-based (→ documentation coming soon)→ https://spaces.awi.de/x/7QkQH

• Anchor
  vef-map-files vef-map-files

  VEF Mapping Files: JSON-based
  
  • Gallery Mapping (→ documentation coming soon)Filter Mapping → https://spaces.awi.de/x/TQLeGw
  • Filter Mapping (→ documentation coming soon)

Version 0.1

Repository Schema

...

. <repo>
|-- admin.*
|
|-- <label>
|   |-- admin.*
|   |
|   |-- _styles/<SLD files>
|   |-- _resources/<resource files>
|   |
|   `-- <service>
|       |-- owner.service.toml
|       |-- admin.*
|       |
|       |-- _resources/<resource files>
|       |
|       `-- <layer>
|           |-- owner.resources.toml
|           |-- owner.layer.toml
|           |-- admin.*
|           |
|           `-- _resources
|               |-- popup.md
|               |-- sidebar.md
|               |-- gallery.mapping.json
|               `-- filter.mapping.json
|
|-- _resources/<resource files> 
|
`-- _other
    |
    `-- <arbitrary-service-id>
        |-- owner.urls
        |
        |-- _resources/<resource files>
        |
        `-- <layer>/_resources/<resource files>

...

• VEF Metadata Template files (*.md), to configure presentation of your data in popups and sidebar → (documentation coming soon) https://spaces.awi.de/x/7QkQH
• VEF Filter Mapping files (*.mapping.json) → (documentation coming soon)
• VEF Gallery Mapping files (*.mapping.json) → see https://spaces.awi.de/x/TQLeGw

In general files with specific names inside resources folders will get used automatically. These names are:

• popup.md (VEF Metadata Template for popups)
• sidebar.md (VEF Metadata Template for the sidebar)
• filter.mapping.json (VEF Filter Mapping)
• gallery.mapping.json (VEF Gallery Mapping)

For each layer used in VEF-based viewers, the file within its own _recources folder is prioritised of over that in its serversevice-level _resources folder and so on. This boils down to this priority list:

1. <label>/<service>/<layer>/_resources/<file-by-convention>
2. <label>/<service>/_resources/<file-by-convention>
3. <label>/_resources/<file-by-convention>
4. _resources/<file-by-convention>

...

1. <label>/<service>/<layer>/_resources/<file-from-layer-configuration-if-existing>
2. <label>/<service>/_resources/<file-from-layer-configuration-if-existing>
3. <label>/_resources/<file-from-layer-configuration-if-existing>
4. _resources/<file-from-layer-configuration-if-existing>
5. <label>/<service>/<layer>/_resources/<file-by-convention>
6. <label>/<service>/_resources/<file-by-convention>
7. <label>/_resources/<file-by-convention>
8. _resources/<file-by-convention>

...

owner.layer.toml

Anchor
owner.layer owner.layer

A layer folder results in a layer of the same name withing the OWS representet by its parent service-layer folder. A layer has a human-readable title, an abstract and optional keywords – just like a scientific paper. These metadata can be specified in <label>/<service>/<layer>/owner.layer.toml. Additionally default and alternative styles (referencing SLD files in <label>/_styles/) and VEF resources can be specified. If desired the default mechanism of auto-deploying changes to the GeoServer (styles, metadata) and/or VEF (recoures) can be deactivated.

_other Folder

The _other subfolder is the place to store resources for services/layers which are not hosted in the GeoServer part of the O2A SDI to be used within VEF-based viewers. This subtree only contains resource files (see above for specs), owner.urls files but neither SLD nor any other configuration files.

...

. https://gitlab.awi.de/software-engineering/sdi/de.awi.sdi.o2a_spatial.dataproducts
|
`-- common
    |
    |-- _styles
    |   |-- marehubPhotos.sld 
    |   `-- marehubPhotosPreview.sld 
    |
    `-- media
        |-- owner.service.toml
        |-- admin.service.toml
        |
        `-- photos
            |-- owner.layer.toml
            |-- admin.layer.toml
            |-- admin.databasestore.toml
            |
            `-- _resources
                |-- popup.md
                |-- sidebar.md
                |-- gallery.mapping.json
                `-- filter.mapping.json

[SERVICE]

title = "Media OWS"
abstract = '''
Media service with photo and video data provided by AWI, Geomar and Hereon. Curated metadata is extracted from image FAIR Digital Objects (iFDOs) (<https://marine-imaging.com/fair/>) or automatically harvested from data products in Pangaea (<https://pangaea.de/>).
'''
keywords = [ "WMS", "WFS", "MareHUB", "videos", "photos", "image", "iFDO", "PANGAEA" ]

[LAYER]

title = "Photos"
abstract = "Layer with data provided by the three marine research centers AWI, Geomar and Hereon. It includes data collected during marine research projects as well as data enriched for this layer, i.e., technical metadata taken directly from the file, such as EXIF data. Depending on the data set, the provided metadata varies for each data product. Preview photos that are provided via urls are lossy processed to make them accessible for the web. This results in a loss of data information, even if not visible."
keywords = [ "MareHUB", "photos", "image", "PANGAEA" ]


[LAYER_SETTINGS]

style_default = "marehubPhotos.sld"
style_alternatives = [ "marehubPhotosPreview.sld" ]


[AUTODEPLOY]

resources = false

...