Exporting search results

Content Platform Tenant Management Help

File Size
4269 KB
Part Number

You can export the results of a search as a comma-separated-values (CSV) or XML file for use with other applications. For example, you could use a CSV or XML file containing exported search results to generate a list of selected objects for a regulatory body. Or, you could use an export file as input to an application that analyzes namespace content.

Note: While the metadata query engine is active, you can export up to 102,000 search results. If the search results include more than that, only 102,000 are exported.

For each object in the search results, an export file contains either the object URL alone (metadata query engine only) or the URL along with a specific subset of the object metadata. The file does not contain the object content. However, you can use the object URL to retrieve the object content in a separate operation.

When the export file includes object metadata, the values for each object in the file are, in order:

  • Object URL
  • Object size, in bytes
  • Content format (always blank when the metadata query engine is active)
  • Cryptographic hash algorithm used to calculate the cryptographic hash value of the object
  • Cryptographic hash value of the object
    Note: If HCP has not yet calculated the cryptographic hash value for an object, the value in the export file is an empty string.

The same metadata is exported for each object, regardless of whether its details are showing on the Search Results page and regardless of which search facility is active.

To export the current search results, select the format you want in the Export results field. The available formats for metadata query engine are:

  • To export only the object URLs:
    • XML format (short)
    • CSV format (short)
  • To export both the object URLs and the object metadata:
    • XML format (detailed)
    • CSV format (detailed)
  • Note: Exporting only object URLs is significantly faster than exporting both the URLs and the object metadata. Additionally, when exporting both the URLS and metadata for a large number of objects, the resulting export file may not contain all the expected objects.

Depending on the browser you’re using and the file type you’ve selected, you may be asked whether you want to open or save the export file.

Export files are named results.selected-type, where selected-type is either CSV or XML. To prevent a subsequent export operation from overwriting an exported file, you should give the file a new name that identifies its contents (for example, held_objects_06082012.xml).