Saved View Commands
The Saved View commands allow you to manage Dodeca saved views and their sharing settings from the command line.
List Saved Views
Use list-saved-views to display a list of saved views in the current tenant. You can optionally specify a user to filter the list to show only saved views created by that user.
list-saved-views [user]
Example:
dshell/SAMPLE:>list-saved-views
ID | User ID | Name | Description | Created Date --------------------------+-------------+--------------------------+---------------------------------+------------------------------- SavedView0_zJ9u6 | user0 | Sample Saved View 0 | This is a test saved view #0 | 2025-05-13T21:11:29 SavedView1_ODlWj | user1 | Sample Saved View 1 | This is a test saved view #1 | 2025-05-13T21:11:29 SavedView2_sLOoC | user2 | Sample Saved View 2 | This is a test saved view #2 | 2025-05-13T21:11:29
You can filter the list to show only saved views for a specific user:
dshell/SAMPLE:>list-saved-views user1
ID | User ID | Name | Description | Created Date --------------------------+-------------+--------------------------+---------------------------------+------------------------------- SavedView1_ODlWj | user1 | Sample Saved View 1 | This is a test saved view #1 | 2025-05-13T21:11:29 SavedView4_JhIug | user1 | Sample Saved View 4 | This is a test saved view #4 | 2025-05-13T21:11:29
List Shared Views
Use list-shared-views to display views that have been shared with specific users or roles. This command offers several filtering options.
list-shared-views [user-or-role] [--shared-by] [--shared-with]
Parameters:
* user-or-role - Optional. The user or role to filter by.
* --shared-by - Optional. When specified with a user parameter, shows views owned by that user and shared with others.
* --shared-with - Optional. When specified with a user or role parameter, shows views shared with that user or role (default if no flags are specified).
Examples:
# List all shared views dshell/SAMPLE:>list-shared-views
View ID | Owner | Shared With | Permission | Access Type ----------------------+-------------+--------------+---------------+--------------- SavedView0_zJ9u6 | user0 | user0 | WRITE | USER SavedView0_zJ9u6 | user0 | ROLE_8 | WRITE | ROLE SavedView1_ODlWj | user1 | user2 | FULL | USER SavedView1_ODlWj | user1 | ROLE_8 | WRITE | ROLE SavedView2_sLOoC | user2 | user1 | FULL | USER SavedView2_sLOoC | user2 | ROLE_9 | WRITE | ROLE SavedView3_hPLzv | user0 | user1 | READ | USER SavedView3_hPLzv | user0 | ROLE_2 | FULL | ROLE SavedView4_JhIug | user1 | user0 | WRITE | USER SavedView4_JhIug | user1 | ROLE_0 | READ | ROLE
# List views shared with a specific user dshell/SAMPLE:>list-shared-views user2
View ID | Owner | Shared With | Permission | Access Type ----------------------+-------------+--------------+---------------+--------------- SavedView1_ODlWj | user1 | user2 | FULL | USER
# List views shared by a specific user dshell/SAMPLE:>list-shared-views user0 --shared-by
View ID | Owner | Shared With | Permission | Access Type ----------------------+-------------+--------------+---------------+--------------- SavedView0_zJ9u6 | user0 | user0 | WRITE | USER SavedView0_zJ9u6 | user0 | ROLE_8 | WRITE | ROLE SavedView3_hPLzv | user0 | user1 | READ | USER SavedView3_hPLzv | user0 | ROLE_2 | FULL | ROLE
# List views either owned by OR shared with a user dshell/SAMPLE:>list-shared-views user1 --shared-by --shared-with
View ID | Owner | Shared With | Permission | Access Type ----------------------+-------------+--------------+---------------+--------------- SavedView1_ODlWj | user1 | user2 | FULL | USER SavedView1_ODlWj | user1 | ROLE_8 | WRITE | ROLE SavedView2_sLOoC | user2 | user1 | FULL | USER SavedView3_hPLzv | user0 | user1 | READ | USER SavedView4_JhIug | user1 | user0 | WRITE | USER SavedView4_JhIug | user1 | ROLE_0 | READ | ROLE
# List views shared with a specific role dshell/SAMPLE:>list-shared-views ROLE_8
View ID | Owner | Shared With | Permission | Access Type ----------------------+-------------+--------------+---------------+--------------- SavedView0_zJ9u6 | user0 | ROLE_8 | WRITE | ROLE SavedView1_ODlWj | user1 | ROLE_8 | WRITE | ROLE
Delete Saved View
Use delete-saved-view to delete a saved view and all its sharing information.
delete-saved-view --id <view-id> [--force]
Parameters:
* --id - Required. The ID of the saved view to delete.
* --force - Optional. Skip confirmation prompt.
Example:
dshell/SAMPLE:>delete-saved-view --id SavedView0_zJ9u6 INFO c.a.d.s.c.SavedViewCommands - About to delete saved view: SavedView0_zJ9u6 INFO c.a.d.s.c.SavedViewCommands - Description: This is a test saved view #0 ? Are you sure you want to delete this saved view? (y/n) y INFO c.a.d.s.c.SavedViewCommands - Successfully deleted saved view: SavedView0_zJ9u6
When a view is deleted, all related sharing information (ViewAccess records) are automatically deleted as well.
Remove Sharing
Use remove-sharing to remove sharing access for a specific user or role from one or all saved views.
remove-sharing --view-id <view-id> --user-or-role <user-or-role>
# OR to remove all sharing for a user/role remove-sharing --user-or-role <user-or-role>
Parameters:
* --view-id - Optional. The ID of the saved view to remove sharing from. If omitted, removes sharing for the user/role from ALL views.
* --user-or-role - Required. The user or role to remove sharing for.
Examples:
# Remove sharing of a specific view for a specific user dshell/SAMPLE:>remove-sharing --view-id SavedView1_ODlWj --user-or-role user2 ? Remove sharing of view SavedView1_ODlWj for user2? (y/n) y INFO c.a.d.s.c.SavedViewCommands - Successfully removed sharing of view SavedView1_ODlWj for user/role user2
# Remove ALL sharing for a specific role across all views dshell/SAMPLE:>remove-sharing --user-or-role ROLE_8 ? Remove ALL sharing for user/role ROLE_8? This will affect 2 view(s). (y/n) y INFO c.a.d.s.c.SavedViewCommands - Successfully removed ALL sharing for user/role ROLE_8 across 2 view(s)