Background Executions — Unified Panel
You kick off an ingestion, a rule generation and a data load — and then keep hopping from screen to screen to find out whether each one finished? The background executions panel solves that: a single place, in real time, with everything running on the platform. You reach it through the activity (pulse) icon at the top of the screen, next to the Contextos selector — a counter over the icon shows how many executions are active.
What appears in the panel
| Section | Examples |
|---|---|
| Ingestions and uploads | Legislation URL upload, case-law ingestion |
| Rule generation (AI) | Comprehensive generation of CPC rules in progress (phase + % complete) |
| Streams (real time) | Active stream subscriptions, with processed events and lag |
| DATTA Extract / ETL loads | Loads in planning, validation or execution, with per-record progress |
Each item shows the execution title, a status badge (Executando, Na fila, Planejando, Validando, Ativo), a progress bar when the source reports a percentage, and a detail line (current phase, who started it, context, lag).
When the panel opens, it loads the in-progress executions and the history at the same time.
History — last 10 finished tasks
Below the in-progress executions, the "Histórico (últimas 10)" section lists the last finished tasks (completed, failed or canceled), from any source, sorted by finish time (most recent first):
- Finished ingestions/uploads.
- Finished rule generations — the platform keeps the last ten in memory.
- Finished DATTA Extract / ETL loads.
The history status badge shows Concluída (green), Falhou (red) or Cancelada (gray). Streams are continuous subscriptions and do not enter the history. Each history item is also clickable and leads to the task's screen — for a finished rule generation, it reopens the dialog in its final state (total rules created).
Click to open the execution's screen
Every item is clickable (the "Abrir tela →" link, also reachable by keyboard with Enter/Space): the panel closes and the console navigates straight to the screen where that execution actually happens, without reloading the page:
| Section | Goes to | Behavior |
|---|---|---|
| Ingestions and uploads | Upload | reopens the tracking of that specific ingestion, reconnecting to the live progress |
| Rule generation (AI) | Screening Rules | reopens the progress dialog on exactly that generation, even if it was started in another tab or session |
| Streams (real time) | DATTABI (streams panel) | navigates to the streams screen |
| DATTA Extract / ETL loads | Pipeline Monitor | navigates to the execution monitor |
Even if the destination screen is still loading, the panel guarantees delivery: the request is re-sent at a few intervals until the child screen is ready to receive it. You always land on the tracking of the right task, and clicking again does not duplicate anything.
Behavior
- Automatic refresh: every 5 seconds while the panel is open, every 30 seconds in the background (only for the icon counter).
- Parallel queries: the four sources are queried simultaneously — the panel waits for the slowest source, not for the sum of all of them.
- Per-source degradation: if you lack permission for a source, or it is temporarily unavailable, that section simply does not appear — the others keep going. If all of them fail, the panel shows a friendly message with a retry button.
- Permissions: each source is protected by the permission of the feature that owns it —
DOCUMENT_UPLOAD(ingestions/uploads),RULES_EDIT(rule generation),DATTABI_STREAM_VIEW(streams),PIPELINE_VIEW(ETL). The panel displays only what the logged-in user is allowed to see. - Mobile: on screens narrower than 768px the panel takes the full width.
Worked example — following an ingestion without losing track
- On the Upload screen, send a batch of documents and navigate to another area of the platform — the ingestion keeps running in the background.
- Notice the counter over the activity icon at the top: it signals that there is an active execution.
- Click the icon: the panel opens with the Ingestões e uploads section showing the batch with the Executando badge and the progress bar.
- Click "Abrir tela →": you are back on the Upload screen, already connected to the tracking of that specific batch.
- When it finishes, the item moves to "Histórico (últimas 10)" with the Concluída badge.
Known limitations
- Ad-hoc DATTAX script executions (launched straight from the editor) report progress on the editor's own screen, with no stored state, and therefore do not appear in the panel. Ad-hoc execution is also available through an integration — see the API reference.
- The panel does not cancel executions — clicking leads to the feature's screen, where cancellation is available (e.g. the rule-generation dialog has the cancel button).
- Streams and ETL loads navigate to the screen, with no shortcut to the specific item yet: the destination screen lists what is in progress.