Data Export tool enable the export of items in the database to multiple formats, and optionally with all related Media files.
The Data Export Tool was made possible by funding from the International Coalition of Sites of Conscience.
The tool needs to be enabled in environment. Check the configuration page for information.
All administrators can make data export requests. An individual permission, Can Request Exports is available to be granted to other active users, regardless of their role(s).
Only administrators can approve or reject export requests.
Data can be exported from Actors, Bulletins and Incidents.
Supported output formats are PDF and JSON in the three components, and CSV (experimental) in Actors and Bulletins. More formats may be added in the future based on feedback and requests from our partners.
Users making export requests can choose whether or not to include the media files attached to Actors and Bulletins. If this option is requested, the export zip archive which will contain the requested data along with any attached media files.
|
Actor |
Bulletin |
Incident |
| PDF |
✅ |
✅ |
✅ |
| JSON |
✅ |
✅ |
✅ |
| CSV |
✅ |
✅ |
❌ |
| Media |
✅ |
✅ |
❌✳ |
✳ Not possible to attach media to Incidents.
%%{ init: { 'flowchart': { 'curve': 'basis', 'htmlLabels': false} } }%%
graph TB
subgraph 0 [ Permission ]
A[Admin]
B[Users with 'Can Request Exports' permission]
end
A & B --> C
subgraph 1 [ Request ]
C(Select items to export)
C --> D(Choose output format and whether or not to include media)
D --> E(Submit export request for approval)
end
E --> G(Sent to Export dashboard for approval by admin)
G --> H
G --> I
subgraph 2 [Approval]
I{Approved}
H{Rejected}
I -.-> L[Admin can reject requests after approval]
L -.-> H
end
I ----> J(Export generated)
J --> K(Download link ready)
K --> T
subgraph 3 [Download]
T(User can view own requests in export dashboard)
T --> V(Approved requested can be downloaded before expiry time)
V -..-> X(Admin can change expiry time of request)
X -..-> V
end
V ----> M(Request expires at the expiry time)
M --> Y
subgraph 4 [Expiry]
Y((Expired))
Y --> Z(Request can no longer be downloaded and expiry date cannot be changed)
Z --> ZZ(Export files are deleted)
end
style A fill:#4a8cff,stroke:#333,stroke-width:2px
style B fill:#4a8cff,stroke:#333,stroke-width:2px
style C fill:#ddd,stroke:#333,stroke-width:2px
style D fill:#ddd,stroke:#333,stroke-width:2px
style E fill:#ddd,stroke:#333,stroke-width:2px
style G fill:#bbb,stroke:#333,stroke-width:2px
style H fill:#dc143c,stroke:#333,stroke-width:2px
style I fill:#61c87b,stroke:#333,stroke-width:2px
style J fill:#61c87b,stroke:#333,stroke-width:2px
style L fill:#bbb,stroke:#333,stroke-width:2px
style 0 fill:#eee,stroke:#333,stroke-width:2px
style 1 fill:#6fa8dc,stroke:#333,stroke-width:2px
style 2 fill:#fff888,stroke:#333,stroke-width:2px
style 3 fill:#61c87b,stroke:#333,stroke-width:2px
style 4 fill:#ccc,stroke:#333,stroke-width:2px
style K fill:#61c87b,stroke:#333,stroke-width:2px
style M fill:#aaa,stroke:#333,stroke-width:2px
style T fill:#fff,stroke:#333,stroke-width:2px
style V fill:#fff,stroke:#333,stroke-width:2px
style X fill:#fff,stroke:#333,stroke-width:2px
style Y fill:#000,stroke:#fff,stroke-width:5px,color:#fff
style Z fill:#000,stroke:#333,stroke-width:2px,color:#fff
style ZZ fill:#000,stroke:#333,stroke-width:2px,color:#fff
Add permission to user
Select items to export
Export request form
Export request waiting for admin approval
Admin can view request along with requested items
Admin can change expiry time or expire the request immediately
Approved request can now be downloaded by the user who requested it
Expired requests can no longer be downloaded