Knowledge Base

User Tools

Site Tools

Trace:
ubiquity:flows_management

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision		Previous revision
ubiquity:flows_management [2026/01/15 09:11] – created finconsubiquity:flows_management [2026/01/15 15:41] (current) – [Manual Flow Creation] fincons
Line 1: Line 1:
-10. Gestione dei Flussi (Flows Management)+====== Flows Management ======
  
-10.1 Descrizione generale +===== General Description =====
-La piattaforma uBIQUity consente agli utenti autenticati di salvare, gestire e riutilizzare le proprie ricerche tramite un sistema chiamato Flows (flussi di ricerca). +
- Un flow rappresenta l’insieme delle informazioni relative a una specifica ricerca: +
-• i parametri utilizzati (lingua, corpus, criteri di confronto, filtri); +
-• i risultati ottenuti; +
-• e le eventuali annotazioni o confronti effettuati. +
-I flussi consentono di riprendere in qualsiasi momento un lavoro interrotto, mantenendo la configurazione originale, l’ordine dei risultati e la modalità di visualizzazione. +
- Questa funzionalità è essenziale per garantire continuità operativa e persistenza dei dati di ricerca nel tempo.+
  
-10.2 Creazione e salvataggio di un Flow +The uBIQUITY platform allows authenticated users to save, manage, and reuse their searches through a system called Flows (research flows). 
-La piattaforma consente di salvare i flussi di confronto (Flows) tramite un sistema che distingue chiaramente fra creazione del flusso e salvataggio successivo delle modifiche. +A flow represents the set of information related to a specific search:
-Modalità di creazione e salvataggio +
-• Create Flow +
-Viene mostrato quando l’utente salva un flusso per la prima volta. +
-Questo comando crea un nuovo Flow associato alla configurazione corrente. +
-• Save Flow +
-Una volta creato il Flow, il pulsante passa automaticamente a “Save Flow”. +
-Tale comando salva eventuali modifiche apportate a un Flow esistente senza crearne uno nuovo , ma salvando una nuova versione del flusso. +
-La creazione o il salvataggio può avvenire in due modi: +
-1. Dalla finestra di confronto (Compare), tramite la toolbar presente nella parte superiore della schermata. +
-2. Dalla sezione “Flows”, dove è possibile creare nuovi flussi, rinominarli o gestire quelli esistenti. +
-________________________________________ +
-Informazioni salvate in un Flow +
-Ogni volta che un Flow viene creato o aggiornato, il sistema memorizza: +
-• l’utente che ha eseguito l’operazione; +
-• la data e l’ora; +
-• la configurazione dei filtri e dei criteri di ricerca; +
-• la modalità di visualizzazione (tabellare, comparativa, ecc.); +
-• eventuali metadati associati. +
-I flussi vengono salvati nel database utente e possono essere ricaricati nelle sessioni successive o gestiti dalla sezione dedicata.+
  
-10.2.1 Creazione manuale di un Flow +  * the used parameters (language, corpus, comparison criteria, filters); 
-La piattaforma consente anche la creazione manuale di un nuovo Flow direttamente dalla finestra “Flows”, utilizzando il pulsante “Create Flow”. +  * the obtained results; 
-Questa modalità è utile per predisporre flussi di lavoro vuoti, da riempire successivamente con una ricerca o da utilizzare come struttura di riferimento. +  * any annotations or comparisons performed.
-________________________________________ +
-Procedura +
-1. L’utente clicca sul pulsante “Create Flow” nella toolbar della finestra Flows. +
-2. Si apre una finestra modale che richiede l’inserimento del Flow Name (campo obbligatorio). +
-3. Confermando tramite Save, il nuovo Flow viene aggiunto all’elenco ed è inizialmente marcato come empty finché non viene associato a una ricerca. +
-Per la distinzione completa tra “Create Flow” e “Save Flow”, si veda la sezione 10.2. +
-________________________________________ +
-Funzionalità aggiuntive +
-• È possibile rinominare un Flow tramite l’icona ✏️. +
-• I flussi creati manualmente possono essere utilizzati come template o contenitori preliminari per organizzare sessioni di lavoro. +
-________________________________________ +
-Vantaggi +
-Questo metodo consente di pianificare attività complesse preparando in anticipo flussi di lavoro strutturati.+
  
-________________________________________+Flows allow users to resume interrupted work at any time, preserving the original configuration, result order, and visualization mode. 
 +This functionality is essential to ensure operational continuity and long-term persistence of research data.
  
-10.3 Finestra di gestione dei Flows +----
-La finestra “Flows” raccoglie tutti i flussi salvati dall’utente e consente di gestirli in maniera semplice e ordinata. +
- Ogni riga della tabella rappresenta un singolo flusso, accompagnato da una serie di icone operative. +
-Le principali azioni disponibili sono: +
-Icona Funzione Descrizione +
-  Modifica nome (Rename) Permette di rinominare il flusso selezionato. +
-  Cronologia modifiche (History) Mostra la cronologia delle modifiche o versioni precedenti del flusso. +
-  Elimina (Delete) Cancella definitivamente il flusso dal database, previa conferma. +
-Tutte le operazioni sono immediate e accompagnate da messaggi di conferma o stato, per evitare cancellazioni accidentali. +
-È possibile ricercare  la lista dei flussi per data di creazione o nome.+
  
-Barra di ricerca e filtri nella gestione Flows +===== Flow Creation and Saving =====
-Nella parte superiore della finestra “Flows” è presente una barra di ricerca che permette di individuare rapidamente un flusso specifico all’interno dell’elenco. +
-Caratteristiche: +
-• L’utente può digitare parte del nome del flusso per filtrare dinamicamente la tabella. +
-• Il filtro è case-insensitive e applicato in tempo reale. +
-Questa barra di ricerca semplifica la gestione dei flussi quando l’utente dispone di un numero elevato di sessioni salvate, migliorando la produttività e l’organizzazione.+
  
-________________________________________+The platform allows saving comparison flows through a system that clearly distinguishes between flow creation and subsequent saving of modifications.
  
-10.4 Modifica e aggiornamento dei Flussi +**Creation and saving modes**
-Quando l’utente modifica un flusso (ad esempio cambiando i parametri di ricerca o l’ordinamento dei risultati), può: +
-• aggiornare il flusso esistente, sovrascrivendo i dati precedenti; +
-• oppure creare una nuova versione, mantenendo entrambe le configurazioni. +
-Il sistema registra automaticamente: +
-• la data dell’ultima modifica, +
-• il nome dell’utente che ha eseguito l’aggiornamento, +
-• e l’elenco delle modifiche principali. +
-Questa cronologia è accessibile tramite l’icona   History). +
- In caso di errore, è possibile ripristinare una versione precedente del flusso con un solo clic.+
  
-Visualizzazione cronologia Flow +**Create Flow**   
-La funzione Flow History apre una finestra modale che mostra tutte le versioni precedenti di un flusso, ordinate cronologicamente. +Displayed when the user saves a flow for the first time. 
-Elementi visualizzati: +This command creates a new Flow associated with the current configuration.
-• Version Number → numero progressivo della versione (es. v1.0, v1.1, v2.0); +
-• Modified By → nome utente che ha eseguito la modifica; +
-• Date / Time → data e ora dell’aggiornamento; +
-• Description / Change Log → riepilogo delle modifiche effettuate. +
-Azioni disponibili: +
-• View → consente di aprire la versione precedente in sola lettura; +
-• Restore → ripristina la versione selezionata come flusso attivo; +
-• Delete → rimuove una versione specifica dalla cronologia. +
-Comportamento del sistema: +
- Ogni volta che viene salvata una nuova versione, il sistema conserva automaticamente la precedente, creando una traccia storica completa. +
- In questo modo l’utente può ripercorrere l’evoluzione di ogni flusso, garantendo trasparenza, tracciabilità e controllo delle revisioni.+
  
-________________________________________+**Save Flow**   
 +Once the Flow has been created, the button automatically switches to “Save Flow”. 
 +This command saves any modifications made to an existing Flow without creating a new one, but by saving a new version of the flow.
  
-10.5 Eliminazione dei Flussi +Creation or saving can occur in two ways: 
-La rimozione di un flusso avviene tramite l’icona 🗑️ (cestino rosso) posizionata accanto a ciascun elemento della lista. + 
- Al clic, il sistema mostra una finestra di conferma che richiede all’utente di validare l’operazione. +  * from the Compare window, using the toolbar located at the top of the screen; 
-• Se l’utente conferma, il flusso viene eliminato definitivamente dal database. +  * from the “Flows” section, where it is possible to create new flows, rename them, or manage existing ones. 
-• Se annulla, l’operazione viene ignorata senza alcuna modifica. + 
-La cancellazione è irreversibile, ma i flussi eliminati vengono registrati nei log di sistema per finalità di tracciabilità. +---- 
- In caso di eliminazione accidentale, l’utente può comunque ricreare un flusso identico importando un file precedentemente esportato.+ 
 +===== Information Saved in a Flow ===== 
 + 
 +Each time a Flow is created or updated, the system stores: 
 + 
 +  * the user who performed the operation; 
 +  * the date and time; 
 +  * the configuration of filters and search criteria; 
 +  * the visualization mode (tabular, comparative, etc.); 
 +  * any associated metadata. 
 + 
 +Flows are saved in the user database and can be reloaded in subsequent sessions or managed from the dedicated section. 
 + 
 +---- 
 + 
 +===== Manual Flow Creation ===== 
 + 
 +The platform also allows manual creation of a new Flow directly from the “Flows” window, using the “Create Flow” button. 
 +This mode is useful for preparing empty workflows, to be filled later with a search or used as reference structures. 
 + 
 +**Procedure** 
 + 
 +  * the user clicks the “Create Flow” button in the Flows window toolbar; 
 +  * a modal window opens requesting the insertion of the Flow Name (mandatory field); 
 +  * by confirming with Save, the new Flow is added to the list and is initially marked as empty until it is associated with a search. 
 + 
 +For a complete distinction between “Create Flow” and “Save Flow”, see section 10.2. 
 + 
 +**Additional functionalities** 
 + 
 +  * it is possible to rename a Flow using the rename icon; 
 +  * manually created flows can be used as templates or preliminary containers to organize working sessions. 
 + 
 +**Advantages** 
 + 
 +This method allows planning complex activities by preparing structured workflows in advance. 
 + 
 +---- 
 + 
 +===== Flows Management Window ===== 
 + 
 +The “Flows” window collects all flows saved by the user and allows them to be managed in a simple and orderly manner. 
 +Each row of the table represents a single flow, accompanied by a set of operational icons. 
 + 
 +The main available actions are: 
 + 
 +^ Icon ^ Function ^ Description ^ 
 +| {{ubiquity:ubiquity_rename_icon.png?30|Rename}} | Rename | Allows renaming the selected flow. | 
 +| {{ubiquity:ubiquity_history_icon.png?30|History}} | History | Displays the modification history or previous versions of the flow. | 
 +| {{ubiquity:ubiquity_bin_icon.png?30|Delete}} | Delete | Permanently deletes the flow from the database, after confirmation. | 
 + 
 +All operations are immediate and accompanied by confirmation or status messages, to avoid accidental deletions. 
 +It is possible to search the list of flows by creation date or name. 
 + 
 +---- 
 + 
 +===== Search Bar and Filters in Flows Management ===== 
 + 
 +At the top of the “Flows” window, a search bar is available that allows quick identification of a specific flow within the list. 
 + 
 +**Features** 
 + 
 +  * the user can type part of the flow name to dynamically filter the table; 
 +  * the filter is case-insensitive and applied in real time. 
 + 
 +This search bar simplifies flow management when the user has a large number of saved sessions, improving productivity and organization. 
 + 
 +---- 
 + 
 +===== Flow Editing and Updating ===== 
 + 
 +When the user modifies a flow (for example by changing search parameters or result sorting), they can: 
 + 
 +  * update the existing flow, overwriting previous data; 
 +  * or create a new version, keeping both configurations. 
 + 
 +The system automatically records: 
 + 
 +  * the date of the last modification; 
 +  * the name of the user who performed the update; 
 +  * the list of main changes. 
 + 
 +This history is accessible via the History icon. 
 +In case of error, it is possible to restore a previous version of the flow with a single click. 
 + 
 +---- 
 + 
 +===== Flow History Visualization ===== 
 + 
 +The Flow History function opens a modal window displaying all previous versions of a flow, ordered chronologically. 
 + 
 +Displayed elements: 
 + 
 +  * Version Number → progressive version number (e.g. v1.0, v1.1, v2.0); 
 +  * Modified By → username who performed the modification; 
 +  * Date / Time → date and time of the update; 
 +  * Description / Change Log → summary of the changes made. 
 + 
 +Available actions: 
 + 
 +  * View → opens the previous version in read-only mode; 
 +  * Restore → restores the selected version as the active flow; 
 +  * Delete → removes a specific version from the history. 
 + 
 +**System behavior** 
 + 
 +Each time a new version is saved, the system automatically preserves the previous one, creating a complete historical trace. 
 +In this way, the user can retrace the evolution of each flow, ensuring transparency, traceability, and revision control. 
 + 
 +---- 
 + 
 +===== Flow Deletion ===== 
 + 
 +Flow removal is performed using the red bin icon located next to each item in the list. 
 +Upon clicking, the system displays a confirmation window requesting user validation. 
 + 
 +  * If the user confirms, the flow is permanently deleted from the database. 
 +  * If the user cancels, the operation is ignored without any modification. 
 + 
 +Deletion is irreversible, but deleted flows are recorded in system logs for traceability purposes. 
 +In case of accidental deletion, the user can recreate an identical flow by importing a previously exported file.
  
ubiquity/flows_management.1768464660.txt.gz · Last modified: by fincons