Certificati

I certificati sono PDF immutabili generati dai dati di una Scheda. Progetti una sola volta un Modulo di certificato riutilizzabile, costituito da uno sfondo PDF o immagine con aree dati posizionate, e poi lo utilizzi per generare certificati per qualsiasi Scheda i cui dati soddisfino i requisiti del modulo. Una volta emesso, un certificato è una copia permanente: modificare successivamente la Scheda o il modulo non cambia mai un PDF già emesso.

Chi può fare cosa

Le anteprime dei certificati, il controllo preliminare e la generazione utilizzano esclusivamente i Campi, gli Identificatori e le Risorse immagine che sei autorizzato a visualizzare. La condivisione di una Scheda non concede l’accesso alle sue risorse private e il solo riferimento a una Risorsa non concede l’autorizzazione a incorporarla.

Anche gli elenchi, i dettagli e i download dei certificati rispettano la privacy del file PDF. Conoscere l’ID di un Certificato non concede l’accesso a un PDF privato. Per accedere ai design dei Moduli di certificato è necessaria l’appartenenza corrente al Team proprietario.

L’accesso dipende dal tuo ruolo nel Team attivo:

Gli amministratori del Team gestiscono i moduli: possono crearli, modificarne il design e i collegamenti dei campi, importarli e archiviarli.
Tutti i membri del team possono esplorare i moduli e utilizzare quelli attivi per generare PDF di certificati dai dati delle Schede.

Moduli di certificato

Apri Moduli di certificato dalla barra laterale (/app/certificates/forms). I moduli sono «design riutilizzabili che inseriscono i dati delle Schede nei PDF dei Certificati generati». L’elenco mostra il nome, lo stato, il numero di collegamenti e l’ultimo aggiornamento di ciascun modulo; usa Mostra archiviati per includere i moduli archiviati.

Dall’elenco puoi creare un modulo (Nuovo modulo — assegnagli un nome; aggiungerai il design in seguito), Copiare il modulo, Importare la definizione di un modulo esportata in precedenza e Archiviare o Ripristinare un modulo. Lo stato di un modulo può essere Attivo o Archiviato: durante la generazione vengono proposti solo i moduli attivi.

L’editor dei moduli

Aprendo un modulo viene avviato l’Editor dei Moduli di certificato. Un modulo è composto da due elementi:

Un design — carica un PDF o un’immagine (Carica design (PDF o immagine)) da usare come sfondo del certificato. Prima di poter posizionare i campi è necessario un design. La successiva sostituzione del design rimuove tutti i campi posizionati e le rispettive posizioni; i certificati già emessi non vengono modificati.
Campi posizionati — aree che inserisci sul design con un clic, ciascuna collegata a una fonte dati.

Per visualizzare valori realistici durante la progettazione, scegli un Contesto del design («Progettazione basata su»): una Scheda, per usare dati di anteprima reali, oppure un Modello di Scheda, per usare solo i nomi dei campi come base per i collegamenti. Cambiare contesto non modifica mai i campi già posizionati.

Fonti dei campi

Ogni area posizionata recupera il proprio valore da una delle quattro fonti seguenti:

Campi della Scheda — chip che elencano i campi della Scheda o del Modello su cui stai basando il design. I campi già inclusi nel modulo sono contrassegnati e puoi aggiungere il nome di un campo come alias di un’area esistente anziché posizionarlo nuovamente.
Fonti di sistema — valori inseriti da DICE al momento della generazione: Nome della Scheda, Descrizione della Scheda, Miniatura della Scheda, UUID della Scheda, Identificatori della Scheda, Data di emissione, Nome del team emittente e nome, cognome e nome completo dell’emittente. Le fonti di sistema possono inoltre essere associate a un’area di campo come valori di riserva, «utilizzati in ordine quando nessun campo della Scheda corrisponde».
Campo personalizzato — inserisci il nome di un campo, oltre a eventuali alias e a un tipo facoltativo, per dati non ancora mostrati dal contesto del design.
Testo statico — testo letterale, «stampato esattamente come scritto, senza essere recuperato dalla scheda».

I tipi di campo sono Testo, Numero, Data, Booleano e Immagine; un’area può essere visualizzata come semplice Testo oppure come codice: QR, Code 128, Code 39 o PDF417. Le aree dispongono di posizione e dimensioni in millimetri, carattere, dimensione del carattere, colore, allineamento, rotazione, opacità e, per le date, formato della data. Le aree di testo supportano inoltre gli stili grassetto, corsivo e sottolineato: le opzioni vengono applicate all’intera area.

Qualsiasi area QR può contenere un logo centrale: scegli un’immagine (PNG, JPEG o WebP) nelle proprietà dell’area e DICE la sovrapporrà al centro del codice, su uno spazio del colore di sfondo dell’area. Il logo viene ridimensionato e posizionato automaticamente e la correzione degli errori del QR viene aumentata affinché il codice rimanga scansionabile: non è necessario configurare alcun parametro.

Aree QR Vlink stabili

Aggiungi la fonte di sistema URL Vlink quando un Certificato necessita di un codice QR permanente. Puoi posizionarla più volte. Ogni elemento posizionato riceve un Vlink distinto quando viene generato il Certificato, quindi due aree QR possono condurre a destinazioni diverse ed essere gestite successivamente in modo indipendente.

Durante la generazione, DICE mostra una scheda di configurazione per ogni elemento Vlink posizionato. Ogni scheda può rimandare alla Pagina pubblica della Scheda, utilizzare un URL HTTP(S) personalizzato oppure rimanere non configurata come bozza. La Pagina pubblica viene selezionata per impostazione predefinita quando ne esiste una, ma non è necessaria per gli altri elementi posizionati. I codici QR di anteprima sono rappresentativi e distinti; i relativi URL Vlink permanenti vengono creati solo quando fai clic su Genera.

Come vengono risolti i campi: per nome, non per modello

Un modulo non è legato a un Modello di Scheda. Al momento della generazione, il nome e gli alias del campo di ciascuna area vengono confrontati con i nomi dei campi della Scheda senza distinzione tra maiuscole e minuscole: «Nome», «nome» e «NOME» vengono tutti risolti nello stesso campo. Qualsiasi Scheda con nomi di campo corrispondenti può utilizzare il modulo, indipendentemente dal modello, se presente, con cui è stata creata.

Contrassegnare un’area come Obbligatoria «impedisce la generazione quando non è possibile risolvere questo valore». Le aree non obbligatorie vengono semplicemente visualizzate vuote quando non viene trovata alcuna corrispondenza.

Quando una Scheda è selezionata come contesto del design, l’anteprima segnala le aree che non verranno risolte, indicando motivi quali nessun valore, tipo non corrispondente, ambiguo, non verrà risolto o non può essere codificato (per i formati di codice), e mostra un banner con l’elenco dei campi obbligatori che «non verranno risolti rispetto a questa Scheda».

Controllo preliminare

Ogni volta che scegli un modulo per una Scheda, DICE esegue un controllo preliminare: indica quanti campi obbligatori vengono risolti («Risolti 3/4 campi obbligatori») e restituisce un esito complessivo di Compatibile o Non compatibile. Per i campi soddisfatti tramite un alias viene indicato l’alias corrispondente. La generazione è consentita solo se il controllo preliminare viene superato.

Generare un certificato per una Scheda

Apri la Scheda e individua la relativa scheda Certificati («PDF immutabili generati dai dati di questa scheda»).
Fai clic su Genera certificato. Nella finestra di dialogo, scegli un Modulo di certificato oppure seleziona ＋ Nuovo modulo da questa scheda… per creare un modulo precompilato con i campi di questa Scheda.
Esamina il risultato del controllo preliminare per il modulo selezionato rispetto a questa Scheda.
Facoltativamente, imposta un Nome del certificato: viene «mostrato nell’elenco dei certificati e usato come nome del file scaricato» e, per impostazione predefinita, corrisponde al nome del modulo. Se il modulo contiene aree QR Vlink, configura ogni destinazione in modo indipendente. Fai clic su Anteprima certificato per esaminare prima il PDF generato.
Fai clic su Genera. In caso di esito positivo, vedrai Certificato emesso e il certificato comparirà nella scheda con la relativa data di emissione.

Nella scheda, ogni certificato offre le azioni Scarica per il PDF e Annulla.

Generazione in blocco

Per emettere lo stesso certificato per più Schede contemporaneamente:

Nell’elenco delle Schede, seleziona più Schede e scegli Genera certificati. Si apre Generazione di certificati in blocco (/app/certificates/batch) con la selezione in coda. Ogni blocco è limitato a 100 schede.
Seleziona un Modulo di certificato. DICE esegue il controllo preliminare per ogni Scheda in coda e contrassegna ciascuna come Conforme, Non conforme (con l’elenco dei campi mancanti) o Non visualizzabile (non puoi visualizzare la Scheda in questo contesto). Dopo aver corretto i dati della Scheda, utilizza l’azione per ripetere il controllo.
Fai clic su Emetti N conformi. I certificati vengono «emessi uno alla volta»; ogni riga passa da Emissione in corso… a Emesso o Non riuscito.
In seguito, usa Riprova N non riusciti per gli errori, rimuovi le righe con Rimuovi dal blocco ed esegui Esporta CSV per ottenere un registro dell’esecuzione.

Annullare un certificato

I certificati emessi non possono essere modificati né eliminati, ma possono essere annullati. «L’annullamento contrassegna il certificato come non più valido e quindi non più affidabile. Il PDF e il relativo hash restano invariati.»

Nella scheda Certificati della Scheda, fai clic su Annulla accanto al certificato.
Scegli un Motivo: Emesso per errore, Dati della scheda errati, Modulo errato, Certificato duplicato oppure Altro.
Facoltativamente, aggiungi una Nota interna (privata), quindi conferma con Annulla.

I certificati annullati rimangono nell’elenco contrassegnati come Annullati e possono ancora essere scaricati per i tuoi archivi.

Suggerimenti sul ciclo di vita dei moduli

Archivia ritira un modulo senza modificare i certificati già emessi a partire da esso; Ripristina lo rende nuovamente disponibile. I moduli archiviati non compaiono nella finestra di dialogo di generazione.
Copia modulo duplica un modulo, inclusi design e collegamenti, così puoi modificarlo progressivamente senza alterare l’originale.
Esporta un modulo dall’editor e Importalo dall’elenco dei moduli per trasferire un design tra Team: per poter essere esportato, un modulo deve avere un design e un nome.

Schede — i dati da cui vengono generati i certificati
Guida introduttiva — introduzione per i nuovi utenti
Domande frequenti — disponibilità dei moduli e risoluzione dei problemi

Segnala un problema nella documentazione