MENU
    Widget personalizzato di pianificazione
    • 14 Mar 2025
    • 4 Minuti da leggere
    • Contributori

    Widget personalizzato di pianificazione


    Sommario dell'articolo

    To download the app, visit: Library

    Scopo

    Il widget personalizzato di pianificazione è una soluzione innovativa per la gestione delle attività. Questo widget di pianificazione è stato progettato per essere utilizzato all'interno delle applicazioni Tulip per recuperare attività o lavori da un database, ciascuno con una durata unica.

    Visualizzati sul lato sinistro del widget, i compiti appaiono in un elenco disposto verticalmente. Trascinando e rilasciando le attività su una delle risorse situate sul lato destro del widget Pianificazione, le attività o i lavori possono essere pianificati su una linea temporale. Questa assegnazione collega l'attività o il lavoro a una risorsa specifica, indicando quando la risorsa lo affronterà.

    In sostanza, questo widget personalizzato semplifica il processo di assegnazione delle attività facilitando l'associazione visiva tra attività e risorse attraverso un'intuitiva funzionalità di trascinamento, assicurando così una gestione e una pianificazione efficaci all'interno dell'interfaccia di Tulip.

    scheduling-printscreen.png

    Configurazione

    Quando si configura il widget, alcuni parametri sono obbligatori, mentre altri sono opzionali con valori predefiniti.

    Per stabilire la connessione con il sistema del cliente, il widget richiede quanto segue:

    • L'URL dell'istanza del client
    • Token di autenticazione per l'accesso al posto delle credenziali di accesso.
    • Se il client non utilizza il Workspace DEFAULT, è necessario fornire anche l'ID del Workspace.

    Dopo l'autenticazione, il widget Scheduling deve accedere alle risorse, che vengono recuperate da un elenco. Le risorse possono provenire da variabili o da una tabella.

    Le attività per il widget Pianificazione sono ottenute dalla tabella Tulip, in base all'ID della tabella e ai suoi campi. Poiché questi sono personalizzabili, il widget Scheduling offre una maggiore flessibilità se si utilizza una tabella diversa.

    Il widget Pianificazione ha i seguenti parametri da impostare:

    Parametri obbligatori

    Risorse: si tratta di un elenco di testo, che può provenire da una tabella, ma in questo caso è gestito come variabile app**. Nomi delle colonne:** gli ID dei campi si trovano a livello della tabella delle attività, da aggiungere uno per uno.

    La tabella Task può essere trovata nel modo seguente:scheduling-table.png

    L'ID del campo si trova nel seguente modo:tablefield-unique-name.png

    • ID dell'attività
    • Nome dell'attività
    • Nome della colonna Stato
    • Nome della colonna Inizio
    • Nome della colonna Fine
    • Nome della colonna Durata
    • Nome della colonna Risorse

    Token di autorizzazione di base: cliccate sul vostro profilo in alto a destra, selezionate le impostazioni dell'account, cliccate su Token API nel pannello di sinistra e seguite le istruzioni per ottenere questo token**.URL dell'account:** ad esempio: your-account.tulip.coTaskTable ID: l'ID della tabella si trova a livello di tabellatableID.png

    Data di pianificazione: per quale giorno si desidera pianificare? Si tratta di un campo datetime.

    Parametri opzionali

    Inizio giorno: inizio della linea temporale. Valore predefinito è 06:00Fine giorno**:** fine della linea temporale. Il valore predefinito è 21:00Unità di tempoall'interno dell'ora: il valore predefinito è 10 (in minuti), il che significa che quando si sposta un'attività sulla timeline, si possono selezionare ad esempio 07:10 o 07:20....., ogni passo è di 10 minuti. Se si cambia di 30, si possono selezionare 07:00, 07:30..... ogni passo è di 30minutiLarghezza unità**:** larghezza di un passo in px, con questo parametro si può impostare la larghezza del widget. Il valore predefinito è 13Larghezza nome risorsa: Larghezza della colonna delle risorse in px. Il valore predefinito è 220Overlap**:** il widget supporta la sovrapposizione delle attività. Il valore predefinito è false**.Infobox:** è una finestra popup per vedere il nome dell'attività se è ritagliata. Il valore predefinito è falseStatuses**(questa opzione è disponibile se l'Infobox è attivato):** Il widget Pianificazione opera con due stati fissi: "Programmato" e "Non programmato". Inoltre, è possibile definire altri stati, come "Completato" o "Annullato". Per gli stati personalizzati è possibile specificare un colore e impostare un comportamento predefinito (ShowByDefault). In base al parametro ShowByDefault, il widget nasconde automaticamente le attività se ShowByDefault è "no" o le visualizza in caso di "sì".

    Gli stati personalizzati si trovano nell'infobox.image.png

    Evidenzia il timeslot corrente: Visualizzazione di una linea verticale che indica l'avanzamento in tempo reale, mostrando la posizione attuale sulla timeline. Il valore predefinito è false.

    Trigger

    Nel widget Pianificazione sono disponibili i seguenti eventi:

    Attività pianificata: un'attività inserita nella timeline Attivitànon pianificata: un'attività rimossa dalla timeline Attività spostata: un'attività appena riprogrammataAggiornamento dello stato dell' attività**:** in caso di utilizzo di stati personalizzati Attivitàselezionata: clic su un'attività pianificata

    image.png

    Tutti i trigger hanno i seguenti risultati, tranne l'Attività selezionata e l'Aggiornamento stato attività:

    scheduling-widget-results.png

    Il risultato di "Attività selezionata" è l'ID dell'attività. Può essere utilizzato ad esempio per il caricamento dei record.

    Come funziona

    Le attività vengono recuperate tramite una chiamata API dalla tabella delle attività di un database, mentre le risorse sono ottenute dai parametri del widget. Le attività sono visualizzate sul lato sinistro, mentre le risorse sono elencate verticalmente sul lato destro del widget Pianificazione. Ogni risorsa ha una timeline giornaliera in cui è possibile inserire le attività. Quando un'attività è collegata a una risorsa, riceve gli orari di inizio e fine per il giorno pianificato e sarà visibile sulla timeline del widget Pianificazione solo in quel particolare giorno.Il widget Pianificazione interagisce con la tabella delle attività CDM nel database per registrare le nuove pianificazioni, gli spostamenti delle attività nel tempo o tra le risorse e la rimozione delle attività dalla timeline di una risorsa tramite doppio clic (ponendole in uno stato non pianificato). Questi processi in background funzionano con la funzione integrata fireEvent. Ulteriori informazioni sulla funzione fireEvent sono disponibili QUI{target=_blank}.Caratteristiche aggiuntive:

    • Supporto per le sovrapposizioni di attività impostando il parametro "Overlap" su true, utile per gestire attività concomitanti sulla stessa Risorsa.
    • Attivazione di un Infobox impostando il parametro "Infobox" su true, per visualizzare una piccola finestra con il nome completo dell'attività al momento del clic, dato che a volte il nome potrebbe non rientrare nella timeline.

    Come creare un token API

    Qui{target=_blank} si possono trovare informazioni dettagliate sulla creazione di un token API.

    Ulteriori letture

    Se desiderate saperne di più sui widget personalizzati, visitate il sito seguente:Panoramicasui widget personalizzati{target=_blank}


    Questo articolo è stato utile?