UI: Open Run History (link)

Descrizione

Helper enterprise specializzato per generare deep-link URL canonici verso la view "Run History" dell'editor FlowForge — il pannello slide-out che mostra l'elenco paginato di run di un workflow con filtri rich (status, date range, error type, triggered_by, search nel JSON di input/output), pre-pronto da incorporare in qualunque output testuale del workflow downstream che andrà letto da un essere umano (email, notifica chat, SMS, dashboard print, PDF report) per consentirgli un single-click "vai a vedere i dettagli concreti senza dover navigare manualmente nell'editor". Il workflow target è configurabile: il workflow corrente (self-link, default — il pattern più comune per email di errore: "questo workflow ha avuto X errori oggi, vedi dettagli") oppure un workflow target arbitrario via workflowId (utile per workflow di alerting/orchestration che fanno report cross-workflow). Filtri opzionali query string pre-applicati al link generato che selezionano automaticamente la view nel caricamento: stato (success | partial | error | running | paused | all), dateFrom/dateTo (ISO 8601 oppure espressioni relative tipo "today", "-7d", "last_month"), query search (full-text su input/output JSON content), triggerType (manual, webhook, cron, subworkflow), errorContains (filtro su error_message). URL generato è relativo al baseUrl pubblico del tenant FlowForge (deriva dalla env FLOWFORGE_PUBLIC_BASE_URL del container, tipicamente https://<slug>.app.automazionezeli.com) oppure assoluto se baseUrl override è impostato — il second'use case è quando si vuole forzare il link verso la dashboard portal centrale (https://flowforge.automazionezeli.com) invece del subdomain tenant per casi di multi-tenancy reporting. Output: { url (string completo encoded), workflowId, queryString, isRelative }. Use case principali della pipeline notification: email digest serale "il workflow X ha avuto Y errori oggi → [vedi dettagli]" con click sul link che apre direttamente Run History filtrato per status=error date=today — l'operatore vede subito le 5 run errored senza navigare 4 click; report admin daily inviato via PEC o email che linka cross-workflow gli incident del giorno; notifica Slack/Telegram/Discord automatica con embed che include il link diretto al run history per consentire al team developer di triagare velocemente; alerting su SLO degraded (latency p99 > 10s) con embedded link al history filtrato per i run che hanno triggerato l'alarm; client-portal share token che restituisce un URL preventivamente firmato per consentire al cliente esterno (senza login tenant) di vedere l'history del SUO workflow ordinabile.

⚙️ Parametri di configurazione

Campi mostrati nell’editor quando si configura il nodo. Generati direttamente dal NodeDefconfigFields.

⬆️ Output del nodo

Campi disponibili nei nodi successivi via $node.<alias>.json.<field>:

• url
• workflowId
• filters

💡 Esempio configurazione

Snippet JSON del nodo come compare nel workflow. I valori sono derivati daidefaultValue e dai parametri required.

{
  "id": "node-ui_open_history-1",
  "defId": "ui_open_history",
  "label": "UI: Open Run History (link)",
  "config": {
    "statusFilter": "all"
  }
}

🔗 Nodi correlati nella stessa categoria