Merge pull request #462 from pvretano/profile

Add profile parameter to fix invalid record media type.

Author: pvretano

core/openapi/ogcapi-records-1-building-blocks.yaml

@@ -431,6 +431,15 @@ components:
             identifier.
         length:
           type: integer
+        profile:
+          type: array
+          description:
+            One or more identifiers that provide information about additional
+            semantics (constraints, conventions, extensions), in addition to 
+            those defined by the media type, that are associated with the
+            target resource.
+          items:
+            type: string
         created:
           type: string
           description:

core/openapi/ogcapi-records-1-example-ref-schema-repo.yaml

@@ -169,7 +169,7 @@ paths:
         - $ref: 'parameters/catalogId.yaml'
         - $ref: 'parameters/q.yaml'
         - $ref: 'parameters/type.yaml'
-        - $ref: 'parameters/externalId.yaml'
+        - $ref: 'parameters/externalIds.yaml'
         - $ref: 'parameters/ids.yaml'
         - $ref: 'parameters/sortby.yaml'
       responses:

core/openapi/parameters/externalId.yaml

@@ -0,0 +1,16 @@
+---
+name: externalIds
+in: query
+description: |-
+  The optional externalIds parameter allows a specific list of records,
+  identified by their external identifiers, to be fetched from a catalog.
+  Only records where one of their associated external identifiers equals
+  one of the values listed for this parameter shall appear in the response.
+required: false
+schema:
+  type: array
+  items:
+    type: string
+    pattern: ([^:]+:)?[^:]+
+explode: false
+style: form

core/openapi/parameters/externalIds.yaml

@@ -2,8 +2,10 @@
 name: ids
 in: query
 description: 
-  The optional ids parameter allows a specified of records to be fetched
-  from a catalog using their identifiers.
+  The optional ids parameter allows a specific list of records, identified
+  by their identifiers, to be fetched from a catalog.  Only records whose
+  identifier matches one of the values listed for this parameter shall appear
+  in the response.
 required: false
 schema:
   type: array

core/openapi/parameters/ids.yaml

@@ -0,0 +1,15 @@
+---
+name: profile
+in: query
+description: 
+  One or more identifiers that provide information about additional
+  semantics (constraints, conventions, extensions), in addition to 
+  those defined by the media type, that are associated with the
+  target resource.
+required: false
+schema:
+  type: array
+  items:
+    type: string
+explode: false
+style: form

core/openapi/parameters/profile.yaml

@@ -5,7 +5,7 @@ description: |-
   The optional q parameter supports keyword searching.  Only records
   whose text fields contain one or more of the specified search terms
   are selected.  The specific set of text keys/fields/properties of a
-  record to which the q operator is applied is up to the description
+  record to which the q operator is applied is up to the discretion
   of the server.   Implementations should, however, apply the q
   operator to the title, description and keywords keys/fields/properties.
 required: false

core/openapi/parameters/q.yaml

@@ -2,13 +2,16 @@
 name: type
 in: query
 description: |-
-  The optional type parameter supports searching by resource type.  Only
-  records whose type, as indicated by the value of the type core
-  queryable, is equal to one of the listed values shall be selected.
+  The optional type parameter allows a specific list of records, identified
+  by their resource type, to be fetched from a catalog.  Only records whose
+  resource type matches one of the values listed for this parameter shall
+  appear in the response.
 required: false
 schema:
   type: array
   items:
     type: string
 explode: false
 style: form
+
+

core/openapi/parameters/type.yaml

@@ -22,6 +22,15 @@ properties:
       identifier.
   length:
     type: integer
+  profile:
+    type: array
+    description:
+      One or more identifiers that provide information about additional
+      semantics (constraints, conventions, extensions), in addition to 
+      those defined by the media type, that are associated with the
+      target resource.
+    items:
+      type: string
   created:
     type: string
     description:

core/openapi/schemas/linkBase.yaml

@@ -0,0 +1,16 @@
+[[ats_query-param-profile]]
+[conformance_class]
+====
+[%metadata]
+identifier:: http://www.opengis.net/spec/ogcapi-records-1/1.0/conf/query-param-profile
+target:: http://www.opengis.net/spec/ogcapi-records-1/1.0/req/query-param-profile
+classification:: Target Type:Web API
+abstract-test:: /conf/query-param-profile/definition
+abstract-test:: /conf/query-param-profile/response
+====
+
+==== Query Parameter Profile
+
+include::query-param-profile/ATS_definition.adoc[]
+
+include::query-param-profile/ATS_response.adoc[]