The metadata file used by the --file-to-add option is a user-defined XML file. The format of the metadata attributes must be in the format for the discovery metadata in the S-100 exchange catalogue.
The format is fully described in the S-101 ENC Product Specification 1.0.0 document. (December 2018). For further information on dataset metadata see clause 12.
If the dataset/support file is part of an existing S-100 exchange set the metadata node can be copied from the exchange catalogue (CATALOG.XML) and required namespaces added to the root node or created manually, perhaps from a sample file.
Sample dataset metadata
If the new file is a dataset file, the metadata must be in the format defined by S100_DatasetDiscoveryMetadata.
This sample file shows all possible metadata. You do not need to include the entries that do not apply.
<?xml version="1.0" encoding="UTF-8"?> |
<?xml-model href="file:./S101_XC.sch" type="application/xml" schematypens="http://purl.oclc.org/dsdl/schematron"?> |
<S100XC:S100_DatasetDiscoveryMetadata xmlns:S100XC="http://www.iho.int/s100/xc" xmlns:cit="http://standards.iso.org/iso/19115/-3/cit/2.0" xmlns:gco="http://standards.iso.org/iso/19115/-3/gco/1.0" xmlns:gex="http://standards.iso.org/iso/19115/-3/gex/1.0" xmlns:gml="http://www.opengis.net/gml/3.2" xmlns:lan="http://standards.iso.org/iso/19115/-3/lan/1.0" xmlns:mco="http://standards.iso.org/iso/19115/-3/mco/1.0" xmlns:mri="http://standards.iso.org/iso/19115/-3/mri/1.0"> |
<S100XC:fileName>1CFEATREL.000</S100XC:fileName> |
<S100XC:filePath>1CFEATREL</S100XC:filePath> |
<S100XC:description>my description</S100XC:description> |
<S100XC:dataProtection>false</S100XC:dataProtection> |
<S100XC:protectionScheme>my scheme</S100XC:protectionScheme> |
<S100XC:digitalSignatureReference>dsa</S100XC:digitalSignatureReference> |
<S100XC:digitalSignatureValue>my signature</S100XC:digitalSignatureValue> |
<S100XC:copyright>Mine 2018</S100XC:copyright> |
<S100XC:copyright>Mine 2019</S100XC:copyright> |
<S100XC:classification gco:isoType="mco:MD_ClassificationCode"> |
<mco:MD_ClassificationCode codeList="http://standards.iso.org/iso/19115/resources/Codelists/cat/codelists.xml#MD_ClassificationCode" codeListValue="unclassified">unclassified</mco:MD_ClassificationCode> |
</S100XC:classification> |
<S100XC:purpose>New Edition</S100XC:purpose> |
<S100XC:specificUsage> |
<mri:MD_Usage> |
<mri:specificUsage> |
<gco:CharacterString>Transit</gco:CharacterString> |
</mri:specificUsage> |
</mri:MD_Usage> |
</S100XC:specificUsage> |
<S100XC:editionNumber>4</S100XC:editionNumber> |
<S100XC:updateNumber>0</S100XC:updateNumber> |
<S100XC:updateApplicationDate>2018-06-25</S100XC:updateApplicationDate> |
<S100XC:issueDate>2018-06-25</S100XC:issueDate> |
<S100XC:productSpecification> |
<S100XC:name>S-101</S100XC:name> |
<S100XC:version>1.0</S100XC:version> |
<S100XC:date>2018-03-24</S100XC:date> |
<S100XC:number>3</S100XC:number> |
</S100XC:productSpecification> |
<S100XC:producingAgency> |
<cit:CI_Responsibility> |
<cit:role> |
<cit:CI_RoleCode codeList="https://data.noaa.gov/resources/iso19139/schema/resources/Codelist/gmxCodelists.xml#CI_RoleCode" codeListValue="My role">My role</cit:CI_RoleCode> |
</cit:role> |
<cit:party> |
<cit:CI_Organisation> |
<cit:name> |
<gco:CharacterString>CARIS</gco:CharacterString> |
</cit:name> |
<cit:contactInfo> |
<cit:CI_Contact> |
<cit:phone> |
<cit:CI_Telephone> |
<cit:number> |
<gco:CharacterString>1-506-111-1111</gco:CharacterString> |
</cit:number> |
<cit:numberType> |
<cit:CI_TelephoneTypeCode codeList="http://standards.iso.org/iso/19115/resources/Codelist/cat/codelists.xml#CI_TelephoneTypeCode" codeListValue="voice">voice</cit:CI_TelephoneTypeCode> |
</cit:numberType> |
</cit:CI_Telephone> |
</cit:phone> |
<cit:phone> |
<cit:CI_Telephone> |
<cit:number> |
<gco:CharacterString>1-506-222-2222</gco:CharacterString> |
</cit:number> |
<cit:numberType> |
<cit:CI_TelephoneTypeCode codeList="http://standards.iso.org/iso/19115/resources/Codelist/cat/codelists.xml#CI_TelephoneTypeCode" codeListValue="fax">fax</cit:CI_TelephoneTypeCode> |
</cit:numberType> |
</cit:CI_Telephone> |
</cit:phone> |
<cit:address> |
<cit:CI_Address> |
<cit:deliveryPoint> |
<gco:CharacterString>88 My St</gco:CharacterString> |
</cit:deliveryPoint> |
<cit:deliveryPoint> |
<gco:CharacterString>Second address Line</gco:CharacterString> |
</cit:deliveryPoint> |
<cit:city> |
<gco:CharacterString>My town</gco:CharacterString> |
</cit:city> |
<cit:administrativeArea> |
<gco:CharacterString>My admin area</gco:CharacterString> |
</cit:administrativeArea> |
<cit:postalCode> |
<gco:CharacterString>A1B 2C3</gco:CharacterString> |
</cit:postalCode> |
<cit:country> |
<gco:CharacterString>My country</gco:CharacterString> |
</cit:country> |
<cit:electronicMailAddress> |
<gco:CharacterString>email1@gmail.com</gco:CharacterString> |
</cit:electronicMailAddress> |
<cit:electronicMailAddress> |
<gco:CharacterString>email2@hotmail.com</gco:CharacterString> |
</cit:electronicMailAddress> |
</cit:CI_Address> |
</cit:address> |
<cit:onlineResource> |
<cit:CI_OnlineResource> |
<cit:linkage> |
<gco:CharacterString>my link</gco:CharacterString> |
</cit:linkage> |
<cit:protocol> |
<gco:CharacterString>my protocol</gco:CharacterString> |
</cit:protocol> |
<cit:applicationProfile> |
<gco:CharacterString>my app profile</gco:CharacterString> |
</cit:applicationProfile> |
<cit:name> |
<gco:CharacterString>my name</gco:CharacterString> |
</cit:name> |
<cit:description> |
<gco:CharacterString>my desc</gco:CharacterString> |
</cit:description> |
<cit:function> |
<cit:CI_OnLineFunctionCode codeList="http://standards.iso.org/iso/19115/resources/Codelist/cat/codelists.xml#CI_DateTypeCode" codeListValue="my function">my function</cit:CI_OnLineFunctionCode> |
</cit:function> |
</cit:CI_OnlineResource> |
</cit:onlineResource> |
<cit:hoursOfService> |
<gco:CharacterString>Mon-Fri 9-5</gco:CharacterString> |
</cit:hoursOfService> |
<cit:contactInstructions> |
<gco:CharacterString>My instructions</gco:CharacterString> |
</cit:contactInstructions> |
</cit:CI_Contact> |
</cit:contactInfo> |
<cit:individual> |
<cit:CI_Individual> |
<cit:name> |
<gco:CharacterString>Wanitta</gco:CharacterString> |
</cit:name> |
<cit:positionName> |
<gco:CharacterString>my position</gco:CharacterString> |
</cit:positionName> |
</cit:CI_Individual> |
</cit:individual> |
</cit:CI_Organisation> |
</cit:party> |
</cit:CI_Responsibility> |
</S100XC:producingAgency> |
<S100XC:maximumDisplayScale>8000</S100XC:maximumDisplayScale> |
<S100XC:horizontalDatumReference>EPSG</S100XC:horizontalDatumReference> |
<S100XC:horizontalDatumValue>4326</S100XC:horizontalDatumValue> |
<S100XC:epoch>test epoch</S100XC:epoch> |
<S100XC:verticalDatum>meanHighWater</S100XC:verticalDatum> |
<S100XC:soundingDatum>meanLowerLowWater</S100XC:soundingDatum> |
<S100XC:dataType>ISO/IEC 8211</S100XC:dataType> |
<S100XC:dataCoverage> |
<S100XC:ID>1</S100XC:ID> |
<S100XC:boundingBox gco:isoType="gex:EX_GeographicBoundingBox"> |
<gex:westBoundLongitude> |
<gco:Decimal>66.1123102</gco:Decimal> |
</gex:westBoundLongitude> |
<gex:eastBoundLongitude> |
<gco:Decimal>67.1145481</gco:Decimal> |
</gex:eastBoundLongitude> |
<gex:southBoundLatitude> |
<gco:Decimal>44.0811136</gco:Decimal> |
</gex:southBoundLatitude> |
<gex:northBoundLatitude> |
<gco:Decimal>44.9158041</gco:Decimal> |
</gex:northBoundLatitude> |
</S100XC:boundingBox> |
<S100XC:boundingPolygon gco:isoType="gex:EX_BoundingPolygon"> |
<gex:polygon> |
<gml:LineString gml:id="1CFEATREL_DC1" srsName="urn:ogc:def:crs:EPSG::4326"> |
<gml:posList> 66.1123102 44.0811136 66.1123102 44.9158041 67.1145481 44.9158041 67.1145481 44.0811136 66.1123102 44.0811136</gml:posList> |
</gml:LineString> |
</gex:polygon> |
</S100XC:boundingPolygon> |
<S100XC:maximumDisplayScale>7</S100XC:maximumDisplayScale> |
<S100XC:minimumDisplayScale>4</S100XC:minimumDisplayScale> |
</S100XC:dataCoverage> |
<S100XC:dataCoverage> |
<S100XC:ID>2</S100XC:ID> |
<S100XC:boundingBox gco:isoType="gex:EX_GeographicBoundingBox"> |
<gex:westBoundLongitude> |
<gco:Decimal>67.1145481</gco:Decimal> |
</gex:westBoundLongitude> |
<gex:eastBoundLongitude> |
<gco:Decimal>67.9218218</gco:Decimal> |
</gex:eastBoundLongitude> |
<gex:southBoundLatitude> |
<gco:Decimal>44.0811136</gco:Decimal> |
</gex:southBoundLatitude> |
<gex:northBoundLatitude> |
<gco:Decimal>44.9158041</gco:Decimal> |
</gex:northBoundLatitude> |
</S100XC:boundingBox> |
<S100XC:boundingPolygon gco:isoType="gex:EX_BoundingPolygon"> |
<gex:polygon> |
<gml:LineString gml:id="1CFEATREL_DC1" srsName="urn:ogc:def:crs:EPSG::4326"> |
<gml:posList> 67.1145481 44.9158041 67.9218218 44.9066652 67.9126828 44.0841599 67.1145481 44.0811136 67.1145481 44.9158041</gml:posList> |
</gml:LineString> |
</gex:polygon> |
</S100XC:boundingPolygon> |
<S100XC:maximumDisplayScale>9</S100XC:maximumDisplayScale> |
<S100XC:minimumDisplayScale>11</S100XC:minimumDisplayScale> |
</S100XC:dataCoverage> |
<S100XC:comment>My comment</S100XC:comment> |
<S100XC:layerID>3</S100XC:layerID> |
<S100XC:defaultLocale> |
<lan:PT_Locale> |
<lan:language> |
<lan:LanguageCode codeList="http://www.iho.int/S100/4.0.0/resources/Codelists/cat/codelists.xml#S100_MD_LanguageCode" codeListValue="English">English</lan:LanguageCode> |
</lan:language> |
<lan:country> |
<gco:CharacterString>Canada</gco:CharacterString> |
</lan:country> |
<lan:characterEncoding> |
<lan:MD_CharacterSetCode codeList="http://www.iho.int/S100/4.0.0/resources/Codelists/cat/codelists.xml#S100_MD_CharacterSetCode" codeListValue="UTF-8">UTF-8</lan:MD_CharacterSetCode> |
</lan:characterEncoding> |
</lan:PT_Locale> |
</S100XC:defaultLocale> |
<S100XC:metadataFileIdentifier>my id</S100XC:metadataFileIdentifier> |
<S100XC:metadataDateStamp>2019-10-07</S100XC:metadataDateStamp> |
<S100XC:metadataLanguage>English</S100XC:metadataLanguage> |
<S100XC:supportFileDiscoveryMetadataReference>drawline.tiff</S100XC:supportFileDiscoveryMetadataReference> |
<S100XC:supportFileDiscoveryMetadataReference>test1.xml</S100XC:supportFileDiscoveryMetadataReference> |
<S100XC:supportFileDiscoveryMetadataReference>test2.xml</S100XC:supportFileDiscoveryMetadataReference> |
<S100XC:supportFileDiscoveryMetadataReference>US225_105.HTM</S100XC:supportFileDiscoveryMetadataReference> |
</S100XC:S100_DatasetDiscoveryMetadata> |
Sample support file metadata
If the new file is a support file it is expected that the metadata is in the format defined by S100_SupportFileDiscoveryMetadata.
This is an example of a support file metadata file.
<?xml version="1.0" encoding="UTF-8"?> |
<S100XC:S100_SupportFileDiscoveryMetadata xmlns:S100XC="http://www.iho.int/s100/xc" xmlns:gco="http://standards.iso.org/iso/19115/-3/gco/1.0" xmlns:lan="http://standards.iso.org/iso/19115/-3/lan/1.0"> |
<S100XC:fileName>test1.txt</S100XC:fileName> |
<S100XC:fileLocation>support</S100XC:fileLocation> |
<S100XC:purpose>new</S100XC:purpose> |
<S100XC:editionNumber>1</S100XC:editionNumber> |
<S100XC:issueDate>2019-11-26</S100XC:issueDate> |
<S100XC:supportFileSpecification> |
<S100XC:name>ASCII</S100XC:name> |
<S100XC:version>1.0</S100XC:version> |
</S100XC:supportFileSpecification> |
<S100XC:dataType>ASCII</S100XC:dataType> |
<S100XC:otherDataTypeDescription>Test desc</S100XC:otherDataTypeDescription> |
<S100XC:comment>My comment</S100XC:comment> |
<S100XC:digitalSignatureReference>S100p15e4.0.0</S100XC:digitalSignatureReference> |
<S100XC:digitalSignatureValue xsi:nil="true"/> |
<S100XC:defaultLocale> |
<lan:PT_Locale> |
<lan:language> |
<lan:LanguageCode codeList="http://www.iho.int/S100/4.0.0/resources/Codelists/cat/codelists.xml#S100_MD_LanguageCode" codeListValue="English">English</lan:LanguageCode> |
</lan:language> |
<lan:country> |
<gco:CharacterString>Canada</gco:CharacterString> |
</lan:country> |
<lan:characterEncoding> |
<lan:MD_CharacterSetCode codeList="http://www.iho.int/S100/4.0.0/resources/Codelists/cat/codelists.xml#S100_MD_CharacterSetCode" codeListValue="UTF-8">UTF-8</lan:MD_CharacterSetCode> |
</lan:characterEncoding> |
</lan:PT_Locale> |
</S100XC:defaultLocale> |
</S100XC:S100_SupportFileDiscoveryMetadata> |