Skip to content

Commit ae8a41d

Browse files
committed
GQL-118: Add Notes to json only fields
1 parent 084ed25 commit ae8a41d

1 file changed

Lines changed: 90 additions & 18 deletions

File tree

src/types/collection.graphql

Lines changed: 90 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -14,28 +14,48 @@ type Collection {
1414
"This element stores DOIs that are associated with the collection such as from campaigns and other related sources."
1515
associatedDois: JSON
1616

17-
"Find collections matching 'archive_center' param value."
17+
"""
18+
Find collections matching 'archive_center' param value.
19+
20+
Note: This field is not supported if you are performing a `collection` query and have provided the `revisionId` parameter. `null` will be returned.
21+
"""
1822
archiveCenter: String
1923

2024
"Allows authors to provide words or phrases outside of the controlled Science Keyword vocabulary, to further describe the collection."
2125
ancillaryKeywords: [String]
2226

2327
"Allows a data provider to provide archive and distribution information up front to an end user, to help them decide if they can use the product."
2428
archiveAndDistributionInformation: JSON
29+
30+
"""
31+
Spatial coverage of the collection.
2532
26-
"Spatial coverage of the collection."
33+
Note: This field is not supported if you are performing a `collection` query and have provided the `revisionId` parameter. `null` will be returned.
34+
"""
2735
boxes: [String]
2836

29-
"True if the metadata contains browse imagery."
37+
"""
38+
True if the metadata contains browse imagery.
39+
40+
Note: This field is not supported if you are performing a `collection` query and have provided the `revisionId` parameter. `null` will be returned.
41+
"""
3042
browseFlag: Boolean
3143

32-
"Data hosted in the cloud."
44+
"""
45+
Data hosted in the cloud.
46+
47+
Note: This field is not supported if you are performing a `collection` query and have provided the `revisionId` parameter. `null` will be returned.
48+
"""
3349
cloudHosted: Boolean
3450

3551
"The unique concept id assigned to the collection."
3652
conceptId: String!
3753

38-
"Consortiums the collection is associated to."
54+
"""
55+
Consortiums the collection is associated to.
56+
57+
Note: This field is not supported if you are performing a `collection` query and have provided the `revisionId` parameter. `null` will be returned.
58+
"""
3959
consortiums: [String]
4060

4161
"Information required to properly cite the collection in professional scientific literature."
@@ -53,7 +73,11 @@ type Collection {
5373
"Information about the personnel responsible for this collection and its metadata."
5474
contactPersons: JSON
5575

56-
"Coordinate system of the metadata."
76+
"""
77+
Coordinate system of the metadata.
78+
79+
Note: This field is not supported if you are performing a `collection` query and have provided the `revisionId` parameter. `null` will be returned.
80+
"""
5781
coordinateSystem: String
5882

5983
"Provider associated with the metadata."
@@ -80,13 +104,21 @@ type Collection {
80104
"This element stores the DOI (Digital Object Identifier) that identifies the collection. note: The values should start with the directory indicator which in ESDIS' case is 10. If the DOI was registered through ESDIS, the beginning of the string should be 10.5067. The DOI URL is not stored here; it should be stored as a RelatedURL. The DOI organization that is responsible for creating the DOI is described in the Authority element. For ESDIS records the value of https://doi.org/ should be used. While this element is not required, NASA metadata providers are strongly encouraged to include DOI and DOI Authority for their collections."
81105
doi: JSON
82106

83-
"The title of the collection described by the metadata."
107+
"""
108+
The title of the collection described by the metadata.
109+
110+
Note: This field is not supported if you are performing a `collection` query and have provided the `revisionId` parameter. `null` will be returned.
111+
"""
84112
datasetId: String
85113

86114
"Entry Title"
87115
entryTitle: String @deprecated(reason: "Use `title`.")
88116

89-
"Entry Id is the concatenation of short name, an underscore, and version of the corresponding collection"
117+
"""
118+
Entry Id is the concatenation of short name, an underscore, and version of the corresponding collection
119+
120+
Note: This field is not supported if you are performing a `collection` query and have provided the `revisionId` parameter. `null` will be returned.
121+
"""
90122
entryId: String
91123

92124
"The File Naming Convention refers to the naming convention of the data set's (Collection's) data files along with a description of the granule file construction."
@@ -98,7 +130,11 @@ type Collection {
98130
"True if there are multiple supported formats for any services associated with the collection."
99131
hasFormats: Boolean
100132

101-
"True if there are granules associated with the collection."
133+
"""
134+
True if there are granules associated with the collection.
135+
136+
Note: This field is not supported if you are performing a `collection` query and have provided the `revisionId` parameter. `null` will be returned.
137+
"""
102138
hasGranules: Boolean
103139

104140
"True if any of its associated services support spatial subsetting."
@@ -125,19 +161,35 @@ type Collection {
125161
"The language used in the metadata record."
126162
metadataLanguage: String
127163

128-
"The format of original collection metadata (Known in CMR as original format)."
164+
"""
165+
The format of original collection metadata (Known in CMR as original format).
166+
167+
Note: This field is not supported if you are performing a `collection` query and have provided the `revisionId` parameter. `null` will be returned.
168+
"""
129169
metadataFormat: String
130170

131-
"True if the data is available online."
171+
"""
172+
True if the data is available online.
173+
174+
Note: This field is not supported if you are performing a `collection` query and have provided the `revisionId` parameter. `null` will be returned.
175+
"""
132176
onlineAccessFlag: Boolean
133177

134-
"Organizations associated with the metadata, including data centers."
178+
"""
179+
Organizations associated with the metadata, including data centers.
180+
181+
Note: This field is not supported if you are performing a `collection` query and have provided the `revisionId` parameter. `null` will be returned.
182+
"""
135183
organizations: [String]
136184

137185
"Original metadata format."
138186
originalFormat: String @deprecated(reason: "Use `metadataFormat`.")
139187

140-
"Spatial coverage of the collection."
188+
"""
189+
Spatial coverage of the collection.
190+
191+
Note: This field is not supported if you are performing a `collection` query and have provided the `revisionId` parameter. `null` will be returned.
192+
"""
141193
lines: [String]
142194

143195
"Provides additional or provider defined identifiers of the collection."
@@ -152,10 +204,18 @@ type Collection {
152204
"Information about the relevant platform(s) used to acquire the data in the collection. The controlled vocabulary for platform types is maintained in the Keyword Management System (KMS), and includes Spacecraft, Aircraft, Vessel, Buoy, Platform, Station, Network, Human, etc."
153205
platforms: JSON
154206

155-
"Spatial coverage of the collection."
207+
"""
208+
Spatial coverage of the collection.
209+
210+
Note: This field is not supported if you are performing a `collection` query and have provided the `revisionId` parameter. `null` will be returned.
211+
"""
156212
points: [String]
157213

158-
"Spatial coverage of the collection."
214+
"""
215+
Spatial coverage of the collection.
216+
217+
Note: This field is not supported if you are performing a `collection` query and have provided the `revisionId` parameter. `null` will be returned.
218+
"""
159219
polygons: [[String]]
160220

161221
"The name of the scientific program, field campaign, or project from which the data were collected."
@@ -209,7 +269,11 @@ type Collection {
209269
"The summary of intentions with which this collection was developed."
210270
summary: String @deprecated(reason: "Use `abstract`")
211271

212-
"Tags associated with the collection. It includes sub-elements of tagKey and optional data which is in embedded JSON."
272+
"""
273+
Tags associated with the collection. It includes sub-elements of tagKey and optional data which is in embedded JSON.
274+
275+
Note: This field is not supported if you are performing a `collection` query and have provided the `revisionId` parameter. `null` will be returned.
276+
"""
213277
tags: JSON
214278

215279
"This class contains attributes which describe the temporal range of a specific collection. Temporal Extent includes a specification of the Temporal Range Type of the collection, which is one of Range Date Time, Single Date Time, or Periodic Date Time."
@@ -221,10 +285,18 @@ type Collection {
221285
"Name of the two-dimensional tiling system for the collection."
222286
tilingIdentificationSystems: JSON
223287

224-
"Start time of the metadata."
288+
"""
289+
Start time of the metadata.
290+
291+
Note: This field is not supported if you are performing a `collection` query and have provided the `revisionId` parameter. `null` will be returned.
292+
"""
225293
timeStart: String
226294

227-
"End time of the metadata."
295+
"""
296+
End time of the metadata.
297+
298+
Note: This field is not supported if you are performing a `collection` query and have provided the `revisionId` parameter. `null` will be returned.
299+
"""
228300
timeEnd: String
229301

230302
"The title of the collection described by the metadata."

0 commit comments

Comments
 (0)