Reports are the middle-level objects housed under a client and contain report details. The Report object does not hold a list of findings, but each finding includes the ID of a report.
The following table explains the fields and data types stored for a report. Fields are presented in alphabetical order by object field name.
name
name of affected assets
dict {str, {AFFECTED ASSET Object}
status
status of report
string ["Draft", "Ready For Review", "In Review", "Approved", "Published"]
includeEvidence
identifies if the report includes evidence
Boolean
report_id
the UUID of the report
integer
client_id
client that the report belongs to
integer
doc_type
field in database to identify object
"report": DB type identifier
reportType
type of report
"default"
tags
any tags associated with the report
string array
custom_field
custom field(s) added to a report
array[ { "label": str, "value": str } ]
custom_fields
container for fields used to track information about the report executive summary narratives; id (narrative UUID), label (title of narrative), tags (any tags applied to narrative), text (narrative content), isFromNarrativesDB (null/true value identifying if the content is from NarrativesDB).
array[ { "id": str, "label": str, "tags": array[str], "text": str, "isFromNarrativesDB": null or true
template
if the report did not use the default template, the custom report UUID is listed
string || null: UUID of report template
start_date
date report was started
null: Zulu date time format
end_date
date report was closed
null: Zulu date time format
fields_template
if the report did not use the default fields template, the custom fields template UUID is listed
string || null: UUID of fields/finding template
exec_summary
a container field that contains any custom fields created for the report
{ "custom_fields": array[ { "id": str: CUID of report narrative, "label": str, "tags": array[str], "text": str, } ] }
isTrackChanges
defines if the rich-text field track changes feature is turned on at the report level (a value of "true" means it is turned on, while a value of "false" means it is turned off and track changes is done per rich-text field)
null or true
The report object stored in the database is a nested JSON object. Below is a screenshot and sample downloadable file that displays the structure of database objects.