--- submitting.rst 2012-06-05 13:15:16.000000000 -0700 +++ submitting_mgb.rst 2012-06-06 20:36:40.000000000 -0700 @@ -32,7 +32,7 @@ Using the Registry ------------------ Metacat's optional Registry provides a simple Web-based interface for creating, -editing, and submitting metadata to the Metacat repository (Figure 4.1). The +editing, and submitting metadata to the Metacat repository (below screenshot). The interface includes help documentation, and can be customized using Metacat's configuration settings. The Registry also includes an administrative interface for managing LDAP user accounts, which is useful if you are using LDAP as your @@ -495,7 +495,13 @@ ``delete`` Archive a document and move the pointer in xml_documents to xml_revisions, effectively "deleting" the document from public view, but preserving the - revision for the revision history. + revision for the revision history. No further updates will be allowed for + the Metacat document "deleted". All revisions of this identifier are no longer + public. + +.. warning:: + It is not possible to "delete" one revision without "deleting" all + revisions of a given identifier. The following is an example of a Web form (see figure) that can perform all three tasks. Example HTML code is included in the sidebar. @@ -548,10 +554,10 @@ Metacat server. -When Metacat receives a query via HTTP (Figure 4.8), the server creates a +When Metacat receives a query via HTTP (below screenshot), the server creates a "pathquery" document, which is an XML document populated with the specified -search criteria (Figure 4.10). The pathquery document is then translated into -SQL statements that are executed against the data base. Results are translated +search criteria (pathquery example below). The pathquery document is then translated into +SQL statements that are executed against the database. Results are translated into an XML "resultset" document, which can be returned as XML or transformed into HTML and returned (specify which you would prefer with the returnfield parameter). You can also opt to submit a pathquery document directly, @@ -560,7 +566,7 @@ .. figure:: images/screenshots/image043.jpg :align: center - Example of a basic search form using a query action. + Example of a basic search form using a query action. The HTML code used to create the form is displayed below. :: @@ -602,23 +608,27 @@ unspecified unspecified dataset/title - keyword - originator/individualName/surName + dataset/creator/individualName/surName + eml://ecoinformatics.org/eml-2.1.0 eml://ecoinformatics.org/eml-2.0.1 eml://ecoinformatics.org/eml-2.0.0 - - Plant + + Charismatic megafauna dataset/title - - plant + + sea otter keyword + + Enhydra + abstract/para + -Each ```` parameter specifies a field that the data base will +Each ```` parameter specifies a field that the database will return (in addition to the fields Metacat returns by default) for each search result. @@ -650,44 +660,48 @@ unspecified unspecified dataset/title - keyword - originator/individualName/surName + dataset/creator/individualName/surName + eml://ecoinformatics.org/eml-2.1.0 eml://ecoinformatics.org/eml-2.0.1 eml://ecoinformatics.org/eml-2.0.0 - - Datos + + Charismatic megafauna dataset/title - - plant + + sea otter keyword + + Enhydra + abstract/para + - nceas.44.1 - resource - eml://ecoinformatics.org/eml-2.0.1 - 2001-01-12 16:12:06.0 - 2001-01-12 16:12:06.0 - Datos Meteorologicos - intertidal - Smith - - + nrs.569.3 + eml + eml://ecoinformatics.org/eml-2.0.0 + 2012-06-06 + 2012-06-06 + Marine Mammal slides + Bancroft + + - nceas.42.1 - resource - eml://ecoinformatics.org/eml-2.0.1 - 2001-01-12 16:11:31.0 - 2001-01-12 16:11:31.0 - Ocean Surface Temperature - Plant - Henry - + knb-lter-sbc.61.1 + eml + eml://ecoinformatics.org/eml-2.1.0 + 2012-06-06 + 2012-06-06 + Nelson + Harrer + Reed + SBC LTER: Reef: Sightings of Sea Otters (Enhydra lutris) near Santa Barbara and Channel Islands, ongoing since 2007 + .....