The Catalog Ingest Tool (CITool) has been designed to replace several tools that have been utilized over the years to support the catalog submission process. Besides simplifying the process by consolidating tools, it also provides consistency in handling of catalog files because the application is built on top of the Product Tools Library which provides reusable APIs for parsing and validating PDS product labels. The following diagram details the flow of the catalog submission process:
The catalog submission process is divided into three steps:
The following diagram details the inputs and outputs for CITool:
The inputs and outputs for the tool are described below.
The application allows the specification of a target or targets for each of the modes. In the Compare mode, the first target specified is compared against the second target. In the Validate and Ingest modes, the specified targets are taken as a whole and considered the catalog submission.
The application also allows the user to import multiple PDS compliant data dictionaries for use during the Validate mode. The assumption is that the user will load one instance of the Planetary Science Data Dictionary (PSDD) and any number of local data dictionaries appropriate for the design session. In this case, the tool will validate the contents of the data dictionary files. The latest PSDD can be downloaded from the Data Dictionary page on the PDS web site at http://pds.nasa.gov/tools/dictionary.shtml.
In order to perform referential integrity checking against references contained in the catalog files, the application allows the user to import the Allrefs file. This file contains the listing of all references contained in the PDS catalog database. The latest version of this file is also available for download from the the Data Dictionary page on the PDS web site. The link to the file can be found in the menu bar on the left hand side of the page.
Each mode of the application (Compare, Validate, Ingest) produces a report in a slightly different format. The Operation section provides details on these reports and links to example reports. If viewing this document in PDF form, see the appendix for the actual examples.
The other major output of this application is the ingestion of the catalog submission into the PDS catalog database. This interface utilizes the Java Database Connectivity (JDBC) API and supports the proprietary database schema of the PDS catalog database.