mirror of
https://github.com/apache/superset.git
synced 2026-09-05 15:01:44 +00:00
f83fb7c0e0
Co-authored-by: Claude Fable 5 <noreply@anthropic.com> Co-authored-by: Amin Ghadersohi <amin.ghadersohi@gmail.com>
75 lines
2.8 KiB
Plaintext
75 lines
2.8 KiB
Plaintext
---
|
|
title: Recently Archived
|
|
hide_title: true
|
|
sidebar_position: 7
|
|
version: 1
|
|
---
|
|
|
|
# Recently Archived
|
|
|
|
When soft-delete is enabled, deleting a chart, dashboard, or dataset archives it
|
|
instead of removing it permanently. The **Recently Archived** view lets owners
|
|
and admins find archived objects and restore them.
|
|
|
|
A chart used by an alert or report cannot be archived while that dependency
|
|
exists. In the chart list view, the archive confirmation lists the alerts and
|
|
reports that use the chart; a blocked attempt names them and asks you to
|
|
detach or delete them first.
|
|
|
|
:::note
|
|
|
|
This view is gated by the `SOFT_DELETE` feature flag. When the flag is off the
|
|
page and its menu entry are hidden, and deletes are permanent as before.
|
|
|
|
:::
|
|
|
|
## Finding archived objects
|
|
|
|
Open **Recently Archived** and pick a type — **Chart**, **Dashboard**, or
|
|
**Dataset** (shown as **Datasource** when semantic layers are enabled) — from
|
|
the Type selector. The view shows one type at a time; each
|
|
type is read from its own list endpoint, so the same row-level access rules that
|
|
govern the normal lists apply here.
|
|
|
|
Each row shows:
|
|
|
|
- **Name** — the object's name. Archived objects cannot be opened from here;
|
|
recover one first and it returns to its normal list, where it opens as usual.
|
|
- **Type** — the selected object type.
|
|
- **Archived** — how long ago the object was archived (sortable).
|
|
- **Archived by** — the user who archived it.
|
|
|
|
## Narrowing the list
|
|
|
|
- **Name** search filters by a substring of the object's name.
|
|
- **Archived** time-range presets (Last 7 / 30 / 90 days, or All time) narrow
|
|
the list to objects archived within the window.
|
|
|
|
The list is sorted by archive time, most recently archived first.
|
|
|
|
## Recovering an object
|
|
|
|
Use the **Recover** action on a row to bring the object back. It immediately
|
|
returns to its normal list and disappears from the archive. Recovering is
|
|
limited to the object's editors and admins; you can only recover objects you
|
|
are able to see in this view.
|
|
|
|
## Deleting an object permanently
|
|
|
|
Use the **Delete permanently** action on a row to remove an object for good.
|
|
You will be asked to confirm.
|
|
|
|
This cannot be undone. Unlike archiving, it does not move the object anywhere
|
|
— the object and its version history are erased, and no retention window
|
|
applies. The same audience that can recover an object can delete it
|
|
permanently: its editors and admins.
|
|
|
|
Some objects cannot be deleted permanently while something still depends on
|
|
them. A chart used by an alert or report, for example, is refused until that
|
|
alert or report is removed, and the reason is shown. Charts that belong to
|
|
dashboards are removed from those dashboards as part of the deletion; the
|
|
dashboards themselves are left in place.
|
|
|
|
Objects are also deleted permanently on their own once they have been in the
|
|
archive longer than the retention window, without anyone acting.
|