Skip to content

Commit b95d48f

Browse files
committed
Added geospatial catalog capabilities
1 parent e142812 commit b95d48f

File tree

1 file changed

+9
-6
lines changed

1 file changed

+9
-6
lines changed

implementation-guide.md

+9-6
Original file line numberDiff line numberDiff line change
@@ -5,17 +5,19 @@ permalink: /implementation-guide/
55
filename: implementation-guide.md
66
---
77

8-
98
## 1) Create and maintain an enterprise data inventory
109
*[Due by 11/9/13]*
1110

1211
Maintain a complete listing of all datasets owned, managed, collected, and/or created by your agency, described in a common format.
1312

1413
### A) Minimum Required for Compliance
1514

16-
Produce a single catalog or list of data managed in a single table, workspace, or other relevant location. Describe each dataset according to the [common core metadata](http://project-open-data.github.io/schema/).
15+
Produce a single catalog or list of data managed in a single table, workspace, or other relevant location. Describe each dataset or existing metadata catalog according to the [common core metadata](http://project-open-data.github.io/schema/).
16+
17+
This listing can be maintained in a Data Management System (DMS) such as the open-source [CKAN](http://www.ckan.org) platform; a single spreadsheet, with each metadata field as its own column; or a DMS of your choosing. A description of a standard metadata catalog, such as CKAN, can be placed in the agency json file in lieu of individual entries. This entry will describe the resource type of "catalog" and the access URL to be used in harvest by data.gov.
18+
19+
Metadata for geographic or geospatial information is often collected using the FGDC Content Standard for Digital Geospatial Metadata or ISO 19115/19139 and represented as XML, providing content that maps to common core metadata. These collections can be exposed using the Open Geospatial Consortium Catalog Service for the Web interface (CSW 2.0.2) or as a read-enabled HTTP directory known as a Web Accessible Folder (WAF). In lieu of posting individual entries for each geospatial dataset in the json file, a single json entry should be prepared for each geospatial metadata collection (WAF) or service (CSW) as a "Harvest Source" enabling harvest of the collections by data.gov. Individual geospatial metadata entries for datasets, applications, or services should not be duplicated in the agency json feed.
1720

18-
This listing can be maintained in a Data Management System (DMS) such as the open-source [CKAN](http://www.ckan.org) platform; a single spreadsheet, with each metadata field as its own column; or a DMS of your choosing.
1921

2022
### B) Best Practices and Examples
2123

@@ -38,16 +40,17 @@ While agencies are only required to list datasets with an "Access Level" value o
3840

3941
Document any datasets or metadata in your enterprise data inventory that your agency does not believe can be made publicly available, in consultation with your Office of General Counsel or its equivalent.
4042

41-
Publish your agency’s enterprise data inventory, with the aforementioned information removed, to a file located at [agency].gov/data.json and described using (at minimum) the [common core metadata](http://project-open-data.github.io/schema/). This file itself must be listed as a dataset within itself (see [an example of format](http://project-open-data.github.io/examples/catalog-sample-extended.json) ); if you have multiple data.json files across your agency, include all of them in the top-level data.json at agency.gov/data.json.
43+
Publish your agency’s enterprise data inventory, with the aforementioned information removed, to a file located at [agency].gov/data.json and described using (at minimum) the [common core metadata](http://project-open-data.github.io/schema/). This file itself must be listed as a dataset within itself (see [an example of format](http://project-open-data.github.io/examples/catalog-sample-extended.json) ); if you have multiple data.json files across your agency, include all of them in the top-level data.json at agency.gov/data.json. If you manage a compatible external metadata directory (e.g. CSW, WAF, CKAN), then the json file would contain an entry for this collection to promote harvest.
4244

43-
While you could manually create this file in a text editor, it is recommended that you use one of the tools provided to generate this file automatically from your existing DMS or enterprise inventory file.
45+
While you could manually create this json file in a text editor, it is recommended that you use one of the tools provided to generate this file automatically from your existing DMS or enterprise inventory file.
4446

4547
### B) Tools
4648

4749
* **Don’t have a DMS?** Use the hosted Catalog Generator to create your data.json file via basic data entry.
4850
* **Is your data inventory stored in a CSV (Excel file)?** Use the [CSV-to-API generator](http://labs.data.gov/csv-to-api/) to automatically convert it into a compliant data.json file.
4951
* **Is your data inventory stored in CKAN?** Use the Data.gov extension (coming soon).
5052
* **Not sure if your data.json file meets the requirements?** Paste your file into the [JSON Validator](https://github.com/project-open-data/json-validator) to receive real-time feedback.
53+
* **Managing a geospatial metadata catalog already?** Register your standard API as an entry in the agency json file.
5154

5255
### C) Best Practices and Examples
5356

@@ -195,4 +198,4 @@ New, or significantly modified, information systems need to support interoperabi
195198

196199
### C) Resources
197200

198-
* [Common Approach to Federal Enterprise Architecture](http://www.whitehouse.gov/sites/default/files/omb/assets/egov_docs/common_approach_to_federal_ea.pdf)
201+
* [Common Approach to Federal Enterprise Architecture](http://www.whitehouse.gov/sites/default/files/omb/assets/egov_docs/common_approach_to_federal_ea.pdf)

0 commit comments

Comments
 (0)