DAP4 Extension: CSV Data Encoding and Response: Difference between revisions
EthanDavis (talk | contribs) No edit summary |
EthanDavis (talk | contribs) No edit summary |
||
Line 1: | Line 1: | ||
[[OPULS_Development| << Back to OPULS Development]] | [[OPULS_Development| << Back to OPULS Development]] | ||
This DAP4 Extension describes the DAP4 CSV data encoding, | The DAP4 CSV data encoding represents DAP4 data | ||
requests can constrain the data to be returned using a standard DAP4 Constraint Expression [DAP4 CE] | |||
This DAP4 Extension describes the DAP4 CSV data encoding, the details needed so that a DAP4 server can advertise their support for the DAP4 CSV encoding, and how DAP4 clients can request DAP4 CSV encoded data responses. Though based on the ''text/csv'' media type described in <nowiki>RFC 4180</nowiki><sup><nowiki>[</nowiki>[[#RFC_4180|RFC 4180]]<nowiki>]</nowiki></sup>, the DAP4 CSV is more complex so that it can represent the more complex data structures of the DAP4 data model. | |||
== DAP4 Extension Details == | == DAP4 Extension Details == | ||
Servers list supported DAP4 extensions in Dataset Service Response [DSR] ''extension'' elements. An ''extension'' element contains a name, role URI, and description. | |||
The Role URI for the DAP4 CSV Data Encoding is | |||
'''http://services.opendap.org/dap4/extension/text-csv-data''' | |||
To advertise that a particular dataset support for the DAP4 CSV Data Encoding extension , a DAP4 server MUST include an ''extension'' element in a DSR | |||
A DAP4 server wishing to advertise support for the DAP4 CSV Data Encoding MUST list the following Role URI | |||
Name: Text/CSV Encoded Data Response | Name: Text/CSV Encoded Data Response | ||
Role URI: | Role URI: | ||
Description: | Description: | ||
Line 45: | Line 57: | ||
<div id="DAP4_Vol1"></div> | <div id="DAP4_Vol1"></div> | ||
<nowiki>[DAP4 Vol1]</nowiki> [[DAP4:_Specification_Volume_1|DAP4 Volume 1: Data Model, Persistent Representations, and Constraints]]. | <nowiki>[DAP4 Vol1]</nowiki> [[DAP4:_Specification_Volume_1|DAP4 Volume 1: Data Model, Persistent Representations, and Constraints]]. | ||
<div id="DAP4_Extensions"></div> | |||
<nowiki>[DAP4 Extensions]</nowiki> [DAP4:_Specification_Volume_1#Extensions|DAP4 Volume 1, Section 9.3 Extensions] |
Revision as of 22:35, 20 March 2014
The DAP4 CSV data encoding represents DAP4 data
requests can constrain the data to be returned using a standard DAP4 Constraint Expression [DAP4 CE]
This DAP4 Extension describes the DAP4 CSV data encoding, the details needed so that a DAP4 server can advertise their support for the DAP4 CSV encoding, and how DAP4 clients can request DAP4 CSV encoded data responses. Though based on the text/csv media type described in RFC 4180[RFC 4180], the DAP4 CSV is more complex so that it can represent the more complex data structures of the DAP4 data model.
DAP4 Extension Details
Servers list supported DAP4 extensions in Dataset Service Response [DSR] extension elements. An extension element contains a name, role URI, and description.
The Role URI for the DAP4 CSV Data Encoding is
http://services.opendap.org/dap4/extension/text-csv-data
To advertise that a particular dataset support for the DAP4 CSV Data Encoding extension , a DAP4 server MUST include an extension element in a DSR
A DAP4 server wishing to advertise support for the DAP4 CSV Data Encoding MUST list the following Role URI
Name: Text/CSV Encoded Data Response
Role URI:
Description:
Requesting DAP4 CSV Encoded Data Response
URL Suffix Media Type URL Example ".dap" or ".dap.csv"
- application/vnd.opendap.dap4.data+csv
- DAP4 CSV encoding
http://server/path/dataset.nc.dap http://server/path/dataset.nc.dap.csv
".dap.csv"
- text/csv
- DAP4 CSV (UTF-8) Data encoding with generic media type
http://server/path/dataset.nc.dap.csv
DAP4 CSV Encoding
Normative References
[RFC 4180] Common Format and MIME Type for Comma-Separated Values (CSV) Files
[DAP4 Vol1] DAP4 Volume 1: Data Model, Persistent Representations, and Constraints.
[DAP4 Extensions] [DAP4:_Specification_Volume_1#Extensions|DAP4 Volume 1, Section 9.3 Extensions]