Logo
  • Home

Tutorials

  • Overview
  • Your first custom-type input
  • GeoJSON
    • GeoJSON Point
    • GeoJSON Feature
  • OGC Bounding Box
  • STAC
    • STAC Catalog
    • STAC Collection
    • STAC Item
  • String formats
    • Datetime
    • URI
      • CWL example
      • Input example
      • Execute the example
  • Experimental
    • Experimental Discovery Inputs
    • Experimental Process Inputs

How-to guides

  • Overview
  • Use an existing schema
  • Define new types

Reference

  • Overview
  • GeoJSON
    • Types
    • Schema details
  • OGC API Processes
    • Types
    • Schema details
  • STAC
    • Types
    • Schema details
  • String formats
    • Types
    • Schema details

Explanation

  • Custom types and their limits
EOAP schemas
  • Tutorials
  • String formats
  • URI
  • Edit on eoap/schemas

URI¶

CWL example¶

# Copyright 2025 Terradue
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#     http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

cwlVersion: v1.2
class: CommandLineTool
label: "Echo URI string format"
baseCommand: echo
requirements:
  - class: InlineJavascriptRequirement
  - class: SchemaDefRequirement
    types:
      - $import: https://raw.githubusercontent.com/eoap/schemas/main/string_format.yaml
inputs:
  product_uri:
    type: https://raw.githubusercontent.com/eoap/schemas/main/string_format.yaml#URI
    label: "Product URI"
    doc: "Product URI in string format"
    inputBinding:
      valueFrom: |
        ${
          // parse the URI provided in the input
          var product_uri = inputs.product_uri.value;

          // Validate the URI format
          var uriPattern = /^(https?|ftp):\/\/[^\s/$.?#].[^\s]*$/i;
          if (!uriPattern.test(product_uri)) {
            throw "Invalid URI format: " + product_uri;
          }
          // Return the URI as a string
          return "Product URI: " + product_uri;
        }
outputs:
  echo_output:
    type: stdout
stdout: echo_output.txt

Input example¶

# Copyright 2025 Terradue
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#     http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

product_uri:
  class: https://raw.githubusercontent.com/eoap/schemas/main/ogc.yaml#URI
  value: "https://earth-search.aws.element84.com/v0/collections/sentinel-s2-l2a-cogs/items/S2A_10TFK_20210708_0_L2A"

Execute the example¶

Run the example with:

cwltool examples/string-format/uri.cwl examples/string-format/uri.yaml

This produces the output:

INFO /opt/hostedtoolcache/Python/3.12.14/x64/bin/cwltool 3.3.20260925135507
INFO Resolved '../../examples/string-format/uri.cwl' to 'file:///home/runner/work/schemas/schemas/examples/string-format/uri.cwl'
INFO [job uri.cwl] /tmp/4glos592$ echo \
    'Product URI: https://earth-search.aws.element84.com/v0/collections/sentinel-s2-l2a-cogs/items/S2A_10TFK_20210708_0_L2A' > /tmp/4glos592/echo_output.txt
INFO [job uri.cwl] completed success
INFO Final process status is success

The content of the echo_output.txt file is:

Product URI: https://earth-search.aws.element84.com/v0/collections/sentinel-s2-l2a-cogs/items/S2A_10TFK_20210708_0_L2A
Previous Next

Apache License, Version 2.0

Built with MkDocs using a theme provided by Read the Docs.
eoap/schemas « Previous Next »