I componenti standard semplificano la creazione, la personalizzazione e il riutilizzo di diagrammi coerenti e di alta qualità. Questo stile professionale è utilizzato per tutti i modelli di diagramma Salesforce ed è disponibile negli strumenti dei nostri partner per la creazione di diagrammi di casi d'uso:

Lucidchart Elementi Miro Slide Google

Esempi di utilizzo dei componenti sono disponibili nella galleria Architettura di riferimento

Le sezioni seguenti acquisiscono procedure consigliate dettagliate per l'intestazione, le schede, le icone e i connettori inclusi nei componenti standard.

L'Intestazione deve essere presente in tutti i diagrammi e includere:

• Un titolo che può essere rapidamente compreso dal pubblico
• Una chiara descrizione di ciò che copre il diagramma, il suo scopo e intento
• (facoltativo) il logo o il nome della società per comunicare l'autore
• (facoltativo) una chiave per chiarire icone, disegni o simboli utilizzati come classificazioni

Le dimensioni devono occupare almeno il 10% dell'altezza del diagramma e il 100% della larghezza.

La dimensione del font della descrizione deve essere almeno la metà della dimensione del titolo.

Una chiave deve essere inclusa quando vengono utilizzate icone, connettori, colori, ecc. che non sono specificati con titoli nel diagramma stesso. Ove possibile, la chiave deve essere raggruppata in righe pari.

Tutte le proprietà del diagramma devono essere rappresentate con una scheda. Le schede possono essere ridimensionate e possono avere riempimenti trasparenti o colorati. Esistono più sezioni della scheda che forniscono variazioni che è possibile utilizzare per rappresentare concetti diversi nel diagramma.

Una scheda di esempio è sotto, con le diverse sezioni descritte. L'unico contenuto della scheda richiesto è il Titolo. Le altre sezioni sono disponibili per l'utilizzo in base alle esigenze per casi d'uso specifici.

Icona scheda
Le icone delle schede sono asset visivi che rappresentano la proprietà della scheda

Titolo carta
Il titolo della carta è un nome per la carta che può essere rapidamente compreso, acquisendo quale proprietà, area o concetto rappresenta la carta

Attributi carta
Gli attributi scheda sono dettagli basati su testo sulla proprietà, rappresentati come elenco e utilizzati quando è necessario acquisire e trasmettere più punti di dati

Piè di pagina
Il piè di pagina della scheda fornisce ulteriori caratteristiche della proprietà. Gli esempi includono: Nomi API pacchetto/oggetto, proprietà, funzionalità, ecc.

Icone piè di pagina
La sezione delle icone piè di pagina consente agli asset visivi di visualizzare informazioni aggiuntive sulla proprietà. Gli esempi includono: canali, servizi condivisi, funzionalità, ecc. Le icone piè di pagina devono essere incluse/spiegate nella chiave del diagramma.

L'utilizzo di sezioni diverse offre diverse variazioni delle schede per usi diversi. È possibile combinare e abbinare l'anatomia delle carte in base alle esigenze per creare queste variazioni nei diagrammi. Vedere gli esempi seguenti:

Fare riferimento alla Reference Architecture Gallery per informazioni sull'utilizzo di queste variazioni.

Utilizzare la possibilità di regolare le dimensioni e il colore delle schede in base alle esigenze per distinguere i tipi e creare diagrammi chiari e comprensibili.

Le schede possono anche fungere da contenitori, ovvero raggruppamenti per più proprietà. È possibile nidificare le schede all'interno di un'altra scheda per rappresentare relazioni gerarchiche o classificare le proprietà correlate in base alle esigenze.

I diagrammi Salesforce offrono una serie di base di loghi di prodotto Salesforce e icone aggiuntive per rappresentare le proprietà e altre aree del diagramma.

Esempi di utilizzo delle icone sono disponibili nella galleria Architettura di riferimento

Per ulteriori icone, fare riferimento alle icone Lightning Design System.

I connettori devono sempre utilizzare le linee di connessione a gomito ed essere dritti, ove possibile, per una maggiore leggibilità.

I connettori rappresentano una fase di relazione, integrazione o processo tra due schede. Gli stili di linea indicano un tipo diverso di connessione e devono essere rappresentati nella chiave del diagramma. Gli endpoint indicano la direzione di un connettore di integrazione o di processo. Gli endpoint indicano anche cardinalità e ordinalità in un connettore di relazione.

Le pillole vengono utilizzate per fornire dettagli sulle connessioni. Fare riferimento ai diagrammi di architettura delle soluzioni e di flusso dei processi di interazione per esempi di utilizzo delle pillole.

In tutto il mondo, circa 1,3 miliardi di persone vivono con qualche forma di disabilità, pari al 15% della popolazione mondiale. L'accessibilità consiste nel rendere il diagramma comprensibile per tutti gli utenti. Esistono due particolari aree di interesse che possono aiutare i diagrammi a essere più accessibili: l'ottimizzazione per gli screen reader e l'uso appropriato del contrasto dei colori.

Altre risorse sulla progettazione per l'accessibilità sono disponibili nel blog Salesforce Design.

Lettori di schermo
Uno screen reader è un'applicazione software che legge ad alta voce le parole in un file, un'app o un sito Web. Uno screen reader è in grado di leggere i diagrammi per le persone che non sono in grado di vederlo chiaramente. Il formato migliore per la compatibilità con gli screen reader è PDF (Portable Document Format). A differenza delle immagini e delle applicazioni non accessibili, i file PDF sono accessibili dagli screen reader per la lettura di parole, forme e colori. L'esportazione dei diagrammi in formato PDF durante la condivisione con altri utenti può migliorare l'accessibilità.

Contrasto cromatico
Aumentare il contrasto dei colori è un altro modo per rendere il diagramma più accessibile. Le persone saranno più in grado di riconoscere e leggere i diagrammi quando soddisfano il contrasto cromatico minimo WCAG (Web Content Accessibility Guidelines) di avere un rapporto 4.5:1 tra il colore di sfondo dietro il testo e il colore del testo stesso.

A ogni colore del sistema colori Salesforce è associato un numero, compreso tra 0 e 100. Quando si scelgono i colori per i diagrammi, assicurarsi che il colore di sfondo dietro il testo sia almeno 50 punti maggiore o minore del colore del testo. Ad esempio, se il colore di sfondo è 80, il colore del testo non deve superare 30. Valutare la possibilità di utilizzare la regola dei 50 punti in base alle esigenze anche per i bordi e i contorni.

I diagrammi Salesforce contengono input o domande? Fateci sapere le vostre opinioni qui.