Deleting Dashboard Versions from a Specific Folder in TIBCO Spotfire Server

Product Name: TIBCO Spotfire Server

Keywords: delete-library-versions, specific folder, GUID, parent_id, item_type:dxp, Spotfire CLI

Description: This article explains how to use the delete-library-versions command-line tool to delete dashboard versions from a specific library folder using search queries.

Solution:

To delete dashboard versions from a specific folder, use the -q (search query) parameter and target the correct items.parent_id::<folder GUID> ANDANDitem_type:dxp

Step-by-Step Instructions

1. Obtain the Folder GUID

Find the folder's GUID via the Library Administration tool or a search query like title:"Folder Name" AND item_type:folder.
2. Construct the Search Query

Use the format: parent_id::<GUID> AND item_type:dxp.

Example Query:
parent_id::dac3cd8c-47ec-454a-a8f2-691c60ece052 AND item_type:dxp

3. Run the delete-library-versions Command

delete-library-versions 
  --bootstrap-config=/path/to/bootstrap.xml 
  --user=admin 
  --tool-password=******** 
  --search-query="parent_id::dac3cd8c-47ec-454a-a8f2-691c60ece052 AND item_type:dxp" 
  --keep-named-versions=true 
  --keep-current-version=true 
  --verbose=true

Key Flags:

--keep-named-versions=true: Retains versions with custom names.
--keep-current-version=true: Preserves the latest version.
--verbose=true: Displays detailed logs.

Important Notes

Test with --verbose=true first to preview changes.
Ensure backups are available before deletion.
Verify user permissions (DELETE_VERSIONS required).

Advanced Usage

parent_id::dac3cd8c-47ec-454a-a8f2-691c60ece052 
AND item_type:dxp 
AND modified:<"1 month ago"

Deletes dashboard versions older than one month in the specified folder.

References

Your Notifications (0)