Geoprocessing tool reference > Conversion toolbox > Metadata toolset > Tools
Metadata Publisher (Conversion) |
|
|
Release 9.2
Last modified April 2, 2008 |
Print all topics in : "Tools" |
NOTE: This tool requires the Microsoft .NET Framework 2.0. These tools are installed with the .NET Support install option.
Publishes an XML metadata document to a metadata catalog such as an ArcIMS Metadata Service.
The Metadata Publisher tool retrieves the source item's metadata, then a copy of this metadata document is passed to the Publisher specified in the tool. If the source item is a stand-alone XML file, a copy of the file itself will be passed to the Publisher. The Publisher uses information from the tool and from the metadata document to create a request to publish the document to the specified metadata catalog.
Documents in an ArcIMS Metadata Service are uniqely identified using a GUID. The first time a document is published to a Metadata Service a GUID is generated by the server and this GUID is recorded in the document in the <root element>/Esri/PublishedDocID element. This element will be added to the source item's metadata if it does not already exist and if you have write access to the metadata. This identifier ensures that when the document is later updated and republished, the existing copy on the server is replaced.
Usage tips
-
If you connect to ArcIMS in ArcCatalog with the same user name and password provided with this tool, the Metadata Service's icon will show a hand holding a pencil if you have permission to publish documents to that service.
Command line syntax
An overview of the Command Line window
MDPublisher_conversion <source> <publisher> {url} {service} {user} {password}
| Parameter | Explanation | Data Type |
| <source> |
The item whose metadata will be published, or a stand-alone XML file that will be published. |
Data Element |
| <publisher> |
An XML file that defines the operations that will be performed when publishing the document. The ArcIMS Metadata Service publisher provided with ArcGIS Desktop, arcimsmd.xml, can be found in the <ArcGIS Install Location>\Metadata\Publisher folder. This publisher looks for information in the content of the metadata or XML document and uses the information it finds to construct an appropriate ArcXML PUBLISH_METADATA request. This publisher follows the same procedure as publishing documents in ArcCatalog when examining the content of the data; elements defined by the FGDC metadata standard are checked first, and if relevant information isn't found the publisher will check the contents of elements that follow the ISO 19115 metadata standard. This publisher does not validate a document's content to see if it contains the information required by the Metadata Explorer application. |
File |
| {url} |
The URL of a Web Service that hosts the metadata catalog, if appropriate. For example, the URL of an ArcIMS Server that provides a Metadata Service. |
String |
| {service} |
The name of the service to which you want to publish, if appropriate. For example, for an ArcIMS Metadata Service this is the case-sensitive of the Metadata Service. |
String |
| {user} |
The name you use to log in to the metadata catalog when publishing documents. For example, when publishing documents to an ArcIMS Metadata Service, you must use a log in name that has been granted metadata_publisher privileges for accessing the Metadata Service. |
String |
| {password} |
The password you use to log in to the metadata catalog when publishing documents. |
String |
Command line example
MDPublisher_conversion c:\data\states.shp "c:\program files\arcgis\metadata\publisher\arcimsmd.xml" http://localhost Metadata myUser pub.password
Scripting syntax
About getting started with writing geoprocessing scripts
MDPublisher_conversion (source, publisher, url, service, user, password)
| Parameter | Explanation | Data Type |
| source (Required) |
The item whose metadata will be published, or a stand-alone XML file that will be published. |
Data Element |
| publisher (Required) |
An XML file that defines the operations that will be performed when publishing the document. The ArcIMS Metadata Service publisher provided with ArcGIS Desktop, arcimsmd.xml, can be found in the <ArcGIS Install Location>\Metadata\Publisher folder. This publisher looks for information in the content of the metadata or XML document and uses the information it finds to construct an appropriate ArcXML PUBLISH_METADATA request. This publisher follows the same procedure as publishing documents in ArcCatalog when examining the content of the data; elements defined by the FGDC metadata standard are checked first, and if relevant information isn't found the publisher will check the contents of elements that follow the ISO 19115 metadata standard. This publisher does not validate a document's content to see if it contains the information required by the Metadata Explorer application. |
File |
| url (Optional) |
The URL of a Web Service that hosts the metadata catalog, if appropriate. For example, the URL of an ArcIMS Server that provides a Metadata Service. |
String |
| service (Optional) |
The name of the service to which you want to publish, if appropriate. For example, for an ArcIMS Metadata Service this is the case-sensitive of the Metadata Service. |
String |
| user (Optional) |
The name you use to log in to the metadata catalog when publishing documents. For example, when publishing documents to an ArcIMS Metadata Service, you must use a log in name that has been granted metadata_publisher privileges for accessing the Metadata Service. |
String |
| password (Optional) |
The password you use to log in to the metadata catalog when publishing documents. |
String |
Data types for geoprocessing tool parameters