Guida utente di MultiDatePick

1. I tre componenti: quando usare ciascuno

MultiDatePick include tre Lightning Web Component costruiti su una base comune. Scegli quello adatto ai tuoi dati.

Confronto delle funzionalità

Le funzionalità si sommano. Tutto ciò che c'è in Date c'è anche in Date Time e Booking. Date Time aggiunge gli orari, Booking aggiunge risorse e capacità.

2. Forme dei record: quando usare ciascuna

La forma del record stabilisce come una selezione diventa record. Nasce da tre scelte indipendenti, e ogni combinazione funziona.

La configurazione guidata prevede sei forme: un record per data, uno per intervallo di date, uno per blocco di tempo, padre più sub-block, risorsa singola e più risorse.

Esempi pratici: rispondi alle 3 domande

Per ogni scenario bastano tre risposte per arrivare alla forma giusta. La configurazione guidata pone le stesse tre domande.

La griglia: tutte le combinazioni

Scegli la riga in base alle tue esigenze di orario e risorsa. La colonna dipende da End Date Field API Name: impostato o no. Ogni cella è una configurazione valida.

In sintesi: qualsiasi combinazione delle tre scelte funziona. Se il tuo scenario non corrisponde a uno schema con un nome, imposta ogni scelta separatamente e il componente fa il resto.

3. La configurazione guidata, passo per passo

La configurazione guidata salva una configurazione una volta sola. Scrivi il suo nome in Config Name su qualsiasi pagina o schermata di flusso e quel posizionamento la usa. Se modifichi la configurazione, ogni posizionamento si aggiorna.

1. 1 Nome e tipo
2. 2 Oggetto e campi
3. 3 Campi orario
4. 4 Stato e visualizzazione
5. 5 Rivedi e salva

Scegli da dove partire

La scheda Crea nuovo offre due percorsi. Guidami passo passo pone tre domande e sceglie componente e forma. Configura tutte le proprietà apre tutte le impostazioni. Accanto ci sono altre due schede: Configurazioni esistenti per modificare una configurazione salvata e Importa per incollarne una dalla Config Library.

Passaggio 1: Nome e tipo

Scegli il componente (Date, Date Time o Booking) e dai un nome alla configurazione. Il nome è ciò che scriverai poi in Config Name. In questo passaggio imposti anche le viste: quella predefinita, quelle offerte dal selettore e le opzioni di Cronologia e Agenda.

Passaggio 2: Oggetto e campi

Il passaggio principale. Scegli l'oggetto che contiene i record, il suo campo data e il campo di relazione verso il record padre. I campi facoltativi aggiungono intervalli, risorse, capacità, sub-block e date bloccate. Le configurazioni Booking impostano qui anche l'oggetto risorsa, il campo capacità e l'orario lavorativo.

Passaggio 3: Campi orario

Solo Date Time e Booking. Associa i campi ora di inizio e ora di fine, poi imposta l'Intervallo di tempo (va bene qualsiasi intervallo; di solito 15, 30 o 60 minuti), l'ora minima e massima, la modalità di visualizzazione e cosa succede in caso di conflitto.

Passaggio 4: Stato e visualizzazione

Campo stato e colori, stati da nascondere, stati che gli utenti possono scegliere, campi al passaggio del mouse, Modalità modifica, nomi dei record, etichette dei pulsanti, dimensione del calendario e limiti come Max Dates Allowed.

Passaggio 5: Rivedi e salva

Controlla il riepilogo, prova l'anteprima in tempo reale, poi fai clic su Salva configurazione. La configurazione guidata distribuisce la configurazione per te in 30-60 secondi. Al termine puoi aggiungere una descrizione facoltativa.

Configurazioni esistenti e Importa

Le configurazioni salvate sono elencate in Configurazioni esistenti: fai clic su una per modificarla o esportarla. La scheda Importa accetta il JSON di qualsiasi scheda della Config Library o un'esportazione da un'altra organizzazione.

4. Set di autorizzazioni e accesso

Il pacchetto include quattro set di autorizzazioni. Assegnali in Imposta, Set di autorizzazioni.

I componenti funzionano con le autorizzazioni di ciascun utente, quindi gli utenti devono avere accesso anche ai tuoi oggetti e campi:

• Oggetti: Lettura e Creazione sull'oggetto in cui vengono salvati i record, più Lettura su ogni oggetto risorsa, chiusura o figlio che il calendario legge.
• Campi, lettura: ogni campo che il calendario mostra (data, stato, campi al passaggio del mouse).
• Campi, modifica: ogni campo che scrive (data, orari, stato, secondo elenco di selezione, campo nome, campo di ricerca del record padre). Un campo che l'utente non può modificare fa fallire il salvataggio, anche se la lettura funziona.
• Record collegati: almeno Lettura sul record padre e sulla risorsa a cui punta il nuovo record.

Ogni messaggio di errore con la sua causa è in Risoluzione dei problemi: errori di accesso. I siti guest richiedono qualche passaggio in più: vedi Pagine pubbliche per utenti guest.

5. Salvataggio con un clic o gestito dal flusso

Ci sono due modi per salvare. Scegli quello adatto al posizionamento.

Salvataggio con un clic: le quattro impostazioni

Le compila la configurazione guidata. Quando tutte e quattro hanno un valore, compare il pulsante Salva.

Quale record padre usa una pagina, e quando conviene sceglierlo invece in un flusso, è spiegato in Pagine app, iniziali ed Experience.

Salvataggio gestito dal flusso: gli output

Lascia vuote le quattro impostazioni. Il pulsante Salva si nasconde e la selezione esce da questi output del flusso:

Passa il JSON a Parse Date Entries from JSON. Restituisce un elenco su cui eseguire un ciclo, con data di inizio, data di fine, ora di inizio, ora di fine e Id della risorsa per ogni elemento. Passo per passo: Ricette per i flussi.

Il salvataggio aggiunge soltanto

Il salvataggio con un clic crea solo nuovi record. Deselezionare una data non elimina mai un record salvato, quindi un clic sbagliato non può far perdere dati. Per modificare o rimuovere record, usa la Modalità modifica o l'elenco correlato.

6. Colori di stato e modalità modifica

Colori di stato e filtri

Colora i record in base a qualsiasi elenco di selezione dell'oggetto, nascondi alcuni valori e limita ciò che gli utenti finali possono scegliere.

Modalità modifica

Attiva Abilita modalità modifica e compare un pulsante Modifica. In modalità modifica gli utenti possono:

• Vedere i record esistenti come schede con data e stato
• Fare clic sulle date per aggiungere i loro record all'insieme da modificare
• Cambiare data, orari, risorsa o stato, e il record si aggiorna
• Eliminare con una conferma in due clic, così nulla sparisce per sbaglio

7. Viste: cinque layout, un solo componente

Ogni componente offre cinque layout. Leggono gli stessi record con le stesse associazioni di campi, seguono le stesse regole su conflitti, date bloccate e orario lavorativo, e salvano allo stesso modo. Cambiare vista cambia l'aspetto dei record, mai il loro significato.

Le cinque viste e la domanda a cui risponde ciascuna

Impostazioni

Una vista diversa per ogni pagina

La vista è un'impostazione di ciascun posizionamento, quindi gli stessi record possono apparire in modo diverso a seconda di dove si trovano. Una sola installazione, un solo insieme di associazioni di campi.

La modalità modifica funziona in ogni vista

Con Abilita modalità modifica abilitato, il pulsante Modifica compare in ogni vista. Fai clic su un record in Cronologia, Settimana o Agenda per aggiungerlo all'insieme da modificare, proprio come una data sul calendario mensile. Un cambio di stato in blocco dalla cronologia funziona esattamente come dal calendario.

Cronologia: righe compresse

Quando una risorsa ha prenotazioni sovrapposte, la sua riga si comprime in un'unica striscia con l'indicatore N insieme. Una freccia di espansione apre una corsia per ogni prenotazione. Anche compresse, le righe accettano trascinamento, passaggio del mouse e clic.

Cronologia: trascina per riprogrammare

Con Abilita modalità modifica abilitato, le barre della cronologia si possono trascinare. Afferra il centro per spostare una prenotazione su altri giorni, oppure un bordo per cambiarne l'inizio o la fine. La barra mostra dove finirà e salva quando la rilasci. Con lo zoom Giorno, gli stessi gesti cambiano gli orari.

Pianifica le persone, non solo le sale

Resource Object API Name accetta qualsiasi oggetto. Impostalo su User e la cronologia diventa un piano turni, la settimana una griglia dei turni e Utilizzo una dashboard della capacità del team.

• L'oggetto User non ha un campo capacità standard. Aggiungine uno personalizzato (per esempio Daily Capacity) per vedere Utilizzo in percentuale.
• Associa Campo inizio orario lavorativo e Campo fine orario lavorativo a campi di User e la griglia settimanale segue l'orario di ogni persona.

La Config Library contiene due esempi pronti: Pianificazione della capacità del team e Turni del personale.

8. Prenotazione risorse e capacità (componente Booking)

Risorsa singola

Gli utenti scelgono una risorsa da un menu a discesa. La griglia oraria carica prenotazioni e capacità di quella risorsa.

Più risorse

Attiva Consenti più risorse e il menu a discesa diventa un insieme di caselle di controllo. La griglia mostra solo le fasce libere su tutte le risorse selezionate, e Salva le prenota tutte in una volta.

Capacità

Permetti a più prenotazioni di condividere una fascia, con badge 3/5 in tempo reale. Una fascia piena non accetta altre prenotazioni.

Conflitti

Comportamento conflitto decide cosa succede quando una fascia scelta è già occupata. Giorni di anticipo conflitto stabilisce fin dove controllare (predefinito 360).

Una chiusura vince sempre. Nulla viene salvato su una fascia bloccata, nemmeno con Consenti.

9. Limitare ciò che gli utenti selezionano

Limita quanto può scegliere una persona, in date o in fasce orarie.

10. Bloccare date, orari e risorse (chiusure)

Qualsiasi calendario può leggere le chiusure da un altro oggetto e disattivare le date, le fasce orarie o le risorse interessate, così gli utenti prenotano solo quando sei aperto. Basta puntare alcune impostazioni sull'oggetto delle chiusure e il componente fa il resto. I blocchi di giornate intere funzionano su tutti e tre i componenti. I blocchi di orari e di risorse richiedono la griglia oraria di Date Time o Booking.

Bloccare o nascondere: qual è la differenza?

Sembrano simili, ma fanno cose opposte. Bloccare toglie disponibilità: la fascia è visibile ma non prenotabile. Nascondere toglie i record dalla vista, e così libera le loro fasce.

Le impostazioni delle date bloccate

Tre livelli di blocco

1. Giornata intera: una chiusura senza orari disattiva l'intera data. Tutti e tre i componenti. Una data chiusa resta chiusa anche se ha già delle prenotazioni.
2. Parte della giornata: una chiusura con ora di inizio e di fine blocca solo quelle fasce. Il resto della giornata resta prenotabile. Le fasce bloccate compaiono quando si seleziona una data.
3. Una risorsa: una chiusura che punta a una risorsa chiude solo quella. Nella vista a risorsa singola la fascia è barrata. Nella vista combinata riceve un piccolo segnale nell'angolo e resta prenotabile sulle risorse libere.

Usi la griglia oraria? Ti servono i blocchi di parte della giornata. I blocchi di giornata intera sono adatti ai selettori di sole date.

Due schemi per l'oggetto delle chiusure

• Stesso oggetto, contrassegnato dallo stato: punta Oggetto date bloccate sul tuo oggetto prenotazione e filtra Status = Cancelled, così le prenotazioni annullate valgono anche come chiusure. È il metodo più semplice, ma tutti i calendari su quell'oggetto le condividono. Vedi la configurazione Prenotazione appuntamenti con festività nella Config Library.
• Un oggetto dedicato alle chiusure: un oggetto Office Closure con una data, ora di inizio e di fine facoltative, un campo Region e un campo di ricerca facoltativo verso la risorsa. Ogni calendario filtra per la sua regione, e una chiusura può riguardare una sola risorsa. Vedi la configurazione Chiusure delle risorse per fascia oraria.

Per permettere alle persone di bloccare il proprio tempo (per esempio un titolare che blocca una mattina), inserisci un componente Date Time che salva sull'oggetto delle chiusure in una pagina interna o in un sito.

Come si comportano le fasce bloccate

• Aspetto: una fascia completamente chiusa è barrata e grigia. Una fascia chiusa solo per alcune delle risorse scelte riceve un segnale nell'angolo.
• Selezione: su una fascia completamente chiusa non si può fare clic né trascinare.
• Salvataggio: nulla viene salvato su una combinazione chiusa di risorsa, data e orario. Con più risorse viene esclusa solo quella chiusa; le altre vengono comunque prenotate.

Una tabella di chiusure, molti calendari

Dai all'oggetto delle chiusure un campo etichetta (Region, Location, Building) e metti lo stesso campo sulle risorse. Ogni calendario usa poi Campo / Valore filtro risorsa per mostrare le proprie risorse e Campo / Valore filtro date bloccate per leggere le proprie chiusure.

11. Pagine pubbliche per utenti guest (Experience Cloud)

Inserisci un componente in un sito Experience Cloud e chiunque potrà prenotare senza login. Completa tutti e cinque i passaggi prima di provare come guest.

1. Autorizzazioni sugli oggetti. Concedi all'utente guest del sito Lettura su ogni oggetto, più Creazione se i guest inviano dati. Salesforce non permette mai ai guest di modificare o eliminare record, quindi riserva le pagine di modifica, annullamento ed eliminazione agli utenti che hanno effettuato il login.
2. Protezione a livello di campo su ogni campo usato dal componente, compresi i campi dell'orario lavorativo delle risorse e i campi orario delle chiusure. Basta un campo mancante per bloccare la query di risorse o chiusure.
3. Una regola di condivisione per i guest (Lettura) perché il guest possa vedere i record. Perché la regola si applichi, l'impostazione predefinita esterna a livello di organizzazione dell'oggetto deve essere Privato. Una regola distribuita come metadati richiede un clic su Ricalcola in Imposta, Impostazioni di condivisione.
4. Il set di autorizzazioni MultiDatePick - Guest sull'utente guest del sito. Fornisce l'accesso alle classi Apex con cui il componente carica i dati.
5. Attiva il sito. Pubblicazione e attivazione sono due passaggi distinti.

• Quale record vedono i guest: una pagina pubblica usa Static Parent Record Id, quindi ogni guest prenota sullo stesso record padre (un ufficio, una sede o una risorsa). Per un record diverso per ogni visitatore, gestiscilo da un flusso con un parametro URL. Calendari davvero personali richiedono utenti con login.
• Referenti e account: Salesforce limita molto l'accesso dei guest a questi oggetti. Fai prenotare i guest su un oggetto personalizzato, oppure usa un sito con autenticazione.
• Più componenti nella stessa pagina: non si sincronizzano in tempo reale. Inserisci tra uno e l'altro un invito ad aggiornare, così un blocco creato nel primo compare nel successivo.

I passaggi per il posizionamento sono in Pagine app, iniziali ed Experience. Un sito completo di esempio è in Prenotazioni su Experience Cloud.

12. Insidie comuni (FAQ)

Vedi un banner, manca il pulsante Salva o il calendario è vuoto? Risoluzione dei problemi mostra ogni messaggio con uno screenshot e la soluzione.

I colori di stato non vengono applicati

Controlla tre cose. (a) Campo stato contiene il nome API esatto dell'elenco di selezione? Distingue tra maiuscole e minuscole. (b) Colori di stato usa il formato Value:#hex, Value:#hex senza virgolette? 'Confirmed':'#22C55E' lo rompe senza alcun avviso. (c) I record hanno davvero un valore in quell'elenco di selezione?

I record vengono salvati con nomi inattesi

Controlla Campo nome record: se il campo è corto, i nomi lunghi vengono troncati. Controlla Aggiungi data al nome del record: se è attivo, data e ora selezionate vengono aggiunte a ogni nome.

Come nascondo i record Cancelled dalla griglia della capacità?

Imposta Nascondi record con stato su Cancelled, oppure su un elenco come Cancelled,Rejected. Spariscono dal calendario e dal conteggio della capacità.

Qual è la differenza tra bloccare e nascondere?

Bloccare (chiusure) lascia visibile una data, un orario o una risorsa ma la rende non prenotabile: festività, manutenzione, una sala chiusa. Nascondere toglie dal calendario e dalla capacità record come quelli Cancelled, e così libera la fascia. Vedi Bloccare o nascondere.

Il pulsante Modifica non compare

Attiva Abilita modalità modifica. È l'unico requisito, su tutti e tre i componenti. Il campo stato è facoltativo: aggiunge solo un menu a discesa degli stati nell'editor. Se il pulsante manca ancora, la pagina o la configurazione hanno Abilita modalità modifica disattivato.

Voglio solo alcune risorse (le sale, non le attrezzature)

Usa Campo filtro risorsa e Valore filtro risorsa. Un valore: campo Active__c, valore true. Più valori (OR): North,South. Più campi (AND): campo Type__c;Active__c, valore Conference Room;true.

Date Time continua a mostrare un unico selettore orario condiviso

L'impostazione giusta è Modalità visualizzazione tempo: Griglia o Menu a discesa. In modalità Griglia tutte le date condividono la griglia. Per un orario diverso per ogni data, scegli Menu a discesa e attiva Consenti orari diversi per data.

Come passo dal salvataggio gestito dal flusso al salvataggio con un clic?

Compila Parent Record Id, Nome API dell'oggetto figlio, Nome API del campo data e Nome API del campo di relazione. Rimuovi l'azione Parse Date Entries from JSON e il ciclo che creava i record. Ora è il pulsante Salva del componente a scriverli.

Compare un messaggio di errore senza dettagli

Apri la console per sviluppatori del browser e cerca le righe che iniziano con [MDP:ERROR]. L'errore completo viene sempre registrato lì, anche quando il messaggio a schermo è breve.

13. Ricette per i flussi

Tutto ciò che trovi qui si crea in Flow Builder. Senza Apex.

Eseguire un ciclo sulle date selezionate

1. Aggiungi una schermata con il componente Date Time. Lascia vuote le impostazioni del salvataggio con un clic.
2. Dopo la schermata, aggiungi l'azione Parse Date Entries from JSON e passale Dates With Times JSON (Output).
3. Esegui un ciclo sull'elenco restituito dall'azione. Ogni elemento ha data di inizio, data di fine, ora di inizio e ora di fine.
4. All'interno del ciclo, assegna i valori a una variabile record e aggiungila a una raccolta. Crea i record una sola volta, dopo il ciclo.

Riportare la prima e l'ultima data sul record padre

Vuoi che il record padre mostri la data più vecchia e quella più recente dei record figli? Scegli il metodo senza codice adatto ai tuoi dati.

Altri schemi per i flussi: Guida ai flussi su schermo.

14. Mappatura di oggetti e campi

Ogni pagina dei componenti contiene un diagramma completo della mappatura di oggetti e campi:

• Date: mappatura degli oggetti
• Date Time: mappatura degli oggetti
• Booking: mappatura degli oggetti

I componenti funzionano con qualsiasi oggetto. Gli oggetti di esempio del pacchetto (Schedule, Event, Resource, Sub Block) sono solo valori predefiniti. Punta le impostazioni sui tuoi oggetti personalizzati o standard che hanno i campi giusti.

15. Riferimento di tutte le proprietà

Tutte le impostazioni dei tre componenti, con l'etichetta che vedi in Lightning App Builder, Experience Builder e Flow Builder. Il nome API è sotto ogni etichetta.

16. Sicurezza e accessibilità

• Ha superato la Security Review di Salesforce AppExchange.
• 100% nativo. I tuoi dati restano nella tua organizzazione Salesforce. Nessun server esterno, nessun callout. Vedi Affidabilità e sicurezza.
• Sempre con le tue autorizzazioni. Ogni lettura e salvataggio avviene con l'accesso dell'utente, quindi autorizzazioni sugli oggetti, protezione a livello di campo e condivisione vengono applicate su ogni record.
• Accessibile. WCAG 2.1 AA, testato con axe-core. VPAT 2.5 completo.
• 9 lingue: inglese, spagnolo, francese, tedesco, giapponese, hindi, portoghese (Brasile), italiano, cinese (semplificato).

17. Domande o bug?

Hai trovato una lacuna in questa guida o qualcosa che non funziona? Scrivi a support@multidatepick.com.