From 628d971c48de8a5be6eb80205bd507d9d5f4c611 Mon Sep 17 00:00:00 2001 From: Greg Anderson Date: Sun, 16 Aug 2026 15:58:32 -0600 Subject: [PATCH] docs(assets): document exporting the Asset inventory The Assets and Organizations lists gained CSV, Excel and JSON export, and the export carries the metadata that drives prioritization -- business criticality, user records, revenue, audience and reachability, plus platform, lifecycle, origin and the parent Asset. That makes it the practical way to review an inventory in a spreadsheet and fill in the business context only the customer's team knows. Also states the one behavior a reader would otherwise be surprised by: a value beginning with =, +, - or @ is written with a leading apostrophe, because every spreadsheet treats such a cell as a formula. Numbers are left alone so a revenue column still adds up. Documents the Pro feature added in dojo-pro#2481 and the escaping added in dojo-pro#2485, on the same release line. --- .../asset_modelling/engagements_tests/PRO__assets.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/docs/content/asset_modelling/engagements_tests/PRO__assets.md b/docs/content/asset_modelling/engagements_tests/PRO__assets.md index f200be364b..342de6db2f 100644 --- a/docs/content/asset_modelling/engagements_tests/PRO__assets.md +++ b/docs/content/asset_modelling/engagements_tests/PRO__assets.md @@ -110,6 +110,16 @@ All ensuing fields that can be edited are also available when the Asset is being ![image](images/assets_ss2.png) +### Export the Asset Inventory + +The All Assets list can be exported from the dropdown menu in the top-right corner, as CSV, Excel or JSON. The All Organizations list exports the same way. + +The export contains the Assets the list is currently showing, so any filter or search you have applied narrows what you get. You choose which columns to include and the order they appear in, and you can name the file before it downloads. + +Alongside the identifying fields, the export carries the metadata that drives prioritization — business criticality, user records, revenue, external audience, internet accessible — together with platform, lifecycle, origin and the parent Asset. That makes an export a practical way to review the inventory in a spreadsheet, and to fill in the business context that only your team knows before bringing it back into DefectDojo. + +Values are written so a spreadsheet displays them rather than evaluating them. A cell that begins with `=`, `+`, `-` or `@` is treated as a formula by Excel, LibreOffice and Google Sheets, so DefectDojo prefixes such a value with an apostrophe when it writes the file. Numbers are left alone, so a revenue column still adds up. + ### Delete Assets Deleting an Asset can be performed by selecting **Delete Asset** from the Asset’s settings. This action can’t be undone. Assets can’t be closed and reopened later.