InPort XML Version Changelog
Version 1.7July 22, 2021 Controlled and Uncontrolled KeywordsKeywords in InPort are being revamped. As part of this effort, the most commonly used thesauri in InPort will be standardized and controlled against authoritative sources, and will be referred to within InPort as "Controlled Keywords." Thesauri that InPort does not officially support will be referred to as "Uncontrolled Keywords."
While both Controlled and Uncontrolled Keywords will continue to be emitted in
InPort XML in the Example:
<keywords>
<!-- Controlled Keyword -->
<keyword controlled="Yes">
<keyword-type>Theme</keyword-type>
<thesaurus>Global Master Change Directory (GCMD) Science Keywords</thesaurus>
<keyword>EARTH SCIENCE > TERRESTRIAL HYDROSPHERE > WATER QUALITY/WATER CHEMISTRY > CONTAMINANTS > MAGNESIUM</keyword>
</keyword>
<!-- Uncontrolled Keyword -->
<keyword controlled="No">
<keyword-type>Theme</keyword-type>
<thesaurus>Sample Uncontrolled Thesaurus</thesaurus>
<keyword>Keyword 1</keyword>
</keyword>
</keywords>
TagsIn addition to the new delineation between Controlled and Uncontrolled Keywords, users can also add Tags to records. Tags function in a similar way to Keywords, but are more appropriate for labels and identifiers which do not correspond to a formal vocabulary.
Tags are emitted in the Example:
<catalog-details>
<tags>
<tag>My Tag 1</tag>
<tag>My Tag 2</tag>
</tags>
...
</catalog-details>
For more information on changes coming to InPort for Keywords, please see the full help page on Controlled Keywords, Uncontrolled Keywords and Tags. Version 1.6July 6, 2021 Child Entity Item Identification Fields
Item Identification fields (such as
To be more consistent with the normal structure of a Catalog Item and its sections,
these are now wrapped within an These fields will still appear in their original location (duplicatively) for a temporary deprecation period, to give time for consumers to update their services. Version 1.5 Additional Note 2November 24, 2020 Automatic NOAA Contact Insertion
Contacts referenced in InPort XML files (such as in Support Roles) --
which have a NOAA email address listed in
Note that in this scenario, the This feature is provided as a convenience for users, but we continue to recommend adding Contacts to InPort prior to loading, as the preferred approach. Version 1.5 Additional Note 1September 22, 2020 Contact Name Format Recommendation
Previously the recommended format for [Last Name], [First Name] [Middle Name/Initials] Note that the actual functionality of the XML Loader has not been changed -- both formats have been and will continue to be supported. However, in practice, we have found that the use of the comma provides additional, helpful information for processing full person names, where the division between first, last and middle name can be ambiguous. Since XML Loader functionality has not been modified, we do not consider this recommendation change to be a version change. All XML Loader documentation and samples, however, now reflect this new recommendation. Version 1.5June 4, 2019 Publications and Publication InformationA new Catalog Item Type, Publication, has been added to InPort. In addition, a new section, Publication Information, has also been added. Please see the Publication Information documentation for more information. Date Field ConsolidationCertain date fields which were previously Catalog Item-type specific have now been consolidated into new fields in the Item Identification section, which apply across all Catalog Item Types. Deprecated Fields:
New Consolidated Fields:
The new fields also accept "Unknown" as a value, when it is desired to document the relevant date as being unknown. Version 1.4.1February 28, 2019 Reference SystemsA new subsection, Reference Systems, under the Spatial Information section, has been added. This subsection provides a way of documenting Spatial Reference System information used for a Data Set. Please see the Reference Systems documentation for more information. Coordinate Reference System URL
The field, Coordinate Reference System URL
(
It has been replaced by the
Linking Share LevelThe Linking Share Level field (under the Catalog Details section) is no longer supported. Version 1.4.0November 15, 2018 Support Roles
Support Roles now refer to Contacts, rather than Persons or Organizations.
Consequently, the fields
Instead, a Contact (which can be a Person, Organization or Position)
should now be identified with a
Support Roles using the deprecated See the full InPort XML Loader documentation on Support Roles for more information. Distributors (in Distribution Information)
Since Support Roles now refer to Contacts rather than Persons or Organizations,
references to Distributors in the Distribution Information section should also
refer to these Contacts.
Consequently, the fields
Instead, the Contact specified as the Distributor
should now be identified with a
Distributors using the deprecated Process Contacts (in Lineage Process Steps)
Process Contacts now refer to Contacts, rather than Persons or Organizations.
Consequently, the fields
Instead, a Contact (which can be a Person, Organization or Position)
should now be identified with a
Support Roles using the deprecated
Instead,
Process Contacts using the deprecated See the full InPort XML Loader documentation on Lineage Process Steps for more information. Originators/Publishers (in Lineage Sources)
Previously, the Originator/Publisher for a Source was specified with
Note that unlike other sections, the <contact-name> field for Lineage Source is a standalone free text field, and not a reference to an InPort Contact. Consequently, it does not need to refer to a pre-existing InPort Contact.
Sources using the deprecated See the full InPort XML Loader documentation on Lineage Sources for more information. FGDC Content TypeThe field, FGDC Content Type (from the Distribution Information section) has been deprecated and is no longer supported in the XML loader. Source Media TypeThe field, Source Media Type (from the Data Set Information section) has been deprecated and is no longer supported in the XML loader. Linking Share LevelThe field, Linking Share Level (in the Catalog Details section) has been deprecated, and is no longer supported in the XML loader. This field has been used to restrict what Catalog Items can be linked as Related Items. The field will be completely removed in a future release, after which any Catalog Items can be related to each other without restriction. Version 1.3.1May 24, 2018 Data Set Creation Date, Data Set Revision DateTwo new fields, Data Set Creation Date and Data Set Revision Date, have been added to the Data Set Information section. These are optional fields which refer to the creation date and revision date of the Data Set, respectively. Please see the Data Set Information documentation for more information. InPort XML Date/Time Format ChangesInPort XML now uses ISO 8601 extended format to represent date and time for better readability. However, the Loader will continue to accept both extended and basic format. Version 1.3.0January 23, 2018 A new section, Acquisition Information, has been added. This section provides a more detailed and reusable method for documenting Instruments, Platforms, and Physical Collection / Fishing Gear. It replaces the respective fields under the Data Set Information section, which are now deprecated. Please see the Acquisition Information documentation for more information. A number of additional fields have been added to various sections. Please consult the documentation links below for more information.
Version 1.2.2October 19, 2017 Source ContributionA new field, Lineage Source Contribution, has been added to the Lineage section. This field is an optional brief statement under a Lineage Source which identifies the information contributed by the source to the data set. Please see the Lineage documentation for more information. Version 1.2.1August 8, 2017 Currentness Reference
Previous versions of InPort XML incorrectly used Version 1.2.0July 6, 2017 Spatial Information (Phase One)A new section, Spatial Information, has been added. This represents the first of two phases for supporting the ability to document spatial information-related metadata in InPort. Please see the Spatial Information documentation for detailed information on fields added in this release. Maintenance NoteA new field, Maintenance Note, has been added to the Data Set Information section. This field contains information regarding specific requirements for maintaining the resource. Please see the Data Set Information documentation for more information. CC ID
The previous version of the InPort XML Loader documentation incorrectly listed the CC ID
option as
a child node of the section or element it belonged to, rather than as an attribute of the
containing
element. The documentation has been corrected to fix this error, however the XML Loader
functionality
has not changed, and retains the original correct processing of Version 1.1.1April 4, 2017 Geographic AreasEach geographic area must contain either geographic bounds, or a description, or both. "Blank" geographic areas are not allowed. On an update, if the geographic bounds or description are removed, which results in a blank geographic area, the blank area will also be removed from the list of extents. Version 1.1.0March 14, 2017 Keywords
Keyword thesauri can no longer have the value "None". Keywords with no thesauri should not
include
the Distribution Information (formerly "Downloads")The Downloads (<downloads>) section has been renamed to Distribution Information (<distribution-information>). Each Download (<download>) is now referred to as a Distribution (<distribution>). In addition, three new fields have been added, which are also supported in the InPort XML Loader:
|
