Questo documento offre una panoramica della notazione e delle convenzioni del diagramma di relazione entità (ERD) di Salesforce per facilitare l'interpretazione chiara dei modelli di dati dei prodotti disponibili nella galleria del modello di dati.

Un ERD, noto anche come modello di dati, è una rappresentazione grafica di un sistema informativo. Mostra le relazioni tra persone, oggetti, luoghi, concetti ed eventi in quel sistema. È un modello logico che trasmette la struttura funzionale dei dati. Negli ERD Salesforce, le entità in genere vengono mappate a un oggetto nel database Salesforce.

Un'entità è una cosa o un oggetto significativo, reale o concettuale, su quali informazioni devono essere conosciute o detenute.

Le entità sono rappresentate nei diagrammi come riquadri con angoli arrotondati. Ogni casella entità fornisce in genere due etichette (ove applicabile):

• Il nome logico dell'entità (ad es. “Entità Salesforce” nell'esempio mostrato qui). Può corrispondere all'etichetta singolare dell'oggetto Salesforce rappresentato, ma non sempre.
• Nome API "fisico" o Nome sviluppatore dell'oggetto nell'organizzazione Salesforce (ad es. "Nome API" nell'esempio). Per gli oggetti pacchetto gestito, il nome API indicato nello schema in genere non include lo spazio dei nomi del pacchetto gestito ("vlocity_ins**", ad esempio), a meno che Salesforce o Industry Cloud non utilizzino più pacchetti gestiti. La fine del nome API per gli oggetti del pacchetto gestito indica il tipo di oggetto personalizzato utilizzato: "**c" per gli oggetti personalizzati normali e le impostazioni personalizzate, "**mdt" per i metadati personalizzati, "**x" per gli oggetti esterni.

Le caselle entità possono anche elencare uno o più attributi rappresentativi degli attributi di tale entità. Un attributo è preceduto da un carattere "#" o "-".

• Un "#" indica un attributo che fa parte della chiave univoca logica dell'entità. Nel diagramma di esempio, "Attributo chiave utente" è considerato la chiave principale utente dell'entità.
• Un "•" indica un attributo non chiave.

Ogni diagramma di relazione tra entità illustra il modello di dati Salesforce dalla prospettiva di un cloud specificato, ad esempio Sales Cloud, Service Cloud o Marketing Cloud. Lo schema di colori del diagramma riflette la nuvola a fuoco. Tutti i cloud di settore come Financial Service Cloud, Health Cloud e Media Cloud utilizzano lo stesso schema di colori Settore.

Anche il colore di una determinata entità nel diagramma ha un significato specifico. Il colore della nuvola di fuoco viene indicato utilizzando il colore con immagine aziendale Salesforce, inclusi alcuni esempi seguenti.

La sezione seguente esaminerà la diversa formattazione delle entità che fa riferimento alla legenda di esempio di Sales Cloud riportata di seguito:

Un'entità con i colori della nuvola di focus rappresenta un oggetto fornito con la licenza per quella nuvola.

Un'entità con un riempimento bianco e un bordo nero rappresenta un oggetto fornito con una licenza diversa da quella di focus cloud e non esteso dalla licenza di focus cloud. Le entità Account e Referente visualizzate in un ERD Sales o Service Cloud, ad esempio, saranno visualizzate come bianche con un bordo nero poiché tali oggetti sono disponibili con una licenza piattaforma.

Un'entità con un riempimento grigio chiaro e un bordo nero rappresenta un oggetto dotato di una licenza diversa dalla nuvola di fuoco, ma la nuvola di fuoco estende l'oggetto. Ad esempio, Commerce Cloud estende l'oggetto Product2 di base con campi aggiuntivi. Le estensioni includono campi, relazioni e tipi di record aggiuntivi.

Le entità senza confini sono virtuali. Se utilizzate in un diagramma, queste caselle riconoscono l'esistenza di un'entità nel modello logico per il dominio, ma l'entità non è implementata come oggetto fisico in Salesforce. L'accesso ai dati di questa entità è previsto tramite chiamate API esterne o Salesforce Connect nella soluzione distribuita.

Le entità con un bordo tratteggiato sono modellate come tipi di record in Salesforce. Nell'esempio riportato di seguito, i sottotipi Account aziendale, Account fatturazione, Account consumatore e Account di servizio hanno un bordo tratteggiato perché vengono mappati ai tipi di record forniti con il pacchetto gestito Communications Cloud.

Le entità con un bordo punteggiato sono virtuali. Per differenziare questi sottotipi nella soluzione Salesforce non vengono utilizzati né tipi di record né un oggetto separato. Questi sottotipi descrivono logicamente un concetto del dominio che consente di illustrare le funzionalità del modello di dati.

Un sottotipo di entità è la definizione di un sottoinsieme delle sue occorrenze. Quando viene aggiunto un insieme di sottotipi all'interno di un'entità supertipo, l'entità supertipo rappresenta gli attributi e le relazioni comuni, mentre le entità sottotipo mostrano attributi e relazioni specifici del sottotipo. Nella notazione del diagramma, i sottotipi si escludono a vicenda, ovvero ogni singolo record deve essere di un singolo sottotipo.

I sottotipi possono avere sottotipi nidificati che differenziano ulteriormente le occorrenze. I sottotipi nei diagrammi sono logici ma possono essere mappati a una rappresentazione fisica in uno dei tre modi seguenti. La solidità del bordo dell'entità sottotipo definisce le modalità di implementazione del sottotipo nel modello di dati Salesforce.

Le entità sottotipo con un bordo solido hanno un oggetto effettivo che tiene traccia delle occorrenze di quel sottotipo. Nell'esempio riportato di seguito, il sottotipo Utente esterno Referente ha un bordo solido poiché i Referenti registrati come Utenti esterni vengono tracciati con un record nell'oggetto Utente.

Una relazione è un'associazione denominata e significativa tra due entità.

Le marcature e il testo intorno alle righe descrivono la cardinalità, l'opzionalità e il significato della relazione.

La cardinalità indica il numero relativo di occorrenze su ciascun lato della relazione. Nella notazione, le estremità di una linea di relazione indicano la cardinalità della relazione su tale estremità. Una zampa di gallina su un'estremità indica che molte occorrenze di entità su quell'estremità possono essere correlate a ogni occorrenza sull'estremità opposta. La mancanza di una zampa di gallina su un'estremità indica che al massimo un'occorrenza entità su quell'estremità può essere correlata a una data occorrenza sull'altra estremità.

Salesforce supporta due tipi di campi di relazione: i campi di ricerca e i campi controllante-controllato (chiamati record principale-record dettaglio). I campi controllante-controllato sono simili alle ricerche obbligatorie ma applicano un accoppiamento aggiuntivo tra le entità correlate. I record sui molti lati della relazione vengono eliminati a catena quando viene eliminato il record controllante. Anche la visibilità dei record dettaglio è controllata dalla visibilità del record controllante.

Per illustrare la differenza tra una relazione controllante-controllata e una relazione di ricerca, gli ERD Salesforce prendono in prestito la notazione del diamante da UML. Un diamante sul lato singolare di una relazione significa che l'entità su quel lato svolge il ruolo principale nella relazione. L'entità su molti lati di tale relazione è il dettaglio o l'entità controllata e può essere considerata come contenuta nell'entità controllante.

L'opzione indica se la relazione è obbligatoria o meno per un'occorrenza su ogni estremità. Come concetto, l'opzionalità è strettamente correlata alla cardinalità e la notazione riflette tale vicinanza. L'opzione è indicata a ogni estremità di una relazione attraverso un cerchio o una barra lungo la linea all'altra estremità della relazione. Perché dall'altra parte della relazione? Includere il markup di facoltatività sullo stesso lato della linea della cardinalità.

Sul lato molteplice (cioè la zampa di gallina) della relazione, c’è quasi sempre un cerchio sulla linea. Ciò significa che possono esserci occorrenze da zero a molti su molti lati della relazione per ogni occorrenza sul lato singolare della relazione.

Sul lato singolare della relazione, un cerchio e una barra indicano una relazione facoltativa per l'entità sul lato a zampa di gallina della relazione. Il cerchio e la barra indicano che possono esserci zero o una occorrenza sul lato singolare della relazione per ogni occorrenza sul lato molti.

In alternativa, sul lato singolare della relazione, le barre doppie indicano una relazione obbligatoria per l'entità sui molti lati della relazione. Le doppie barre indicano che deve esserci una e una sola occorrenza sul lato singolare della relazione per ogni occorrenza sul lato molti.

L'opzione di una relazione può essere visualizzata come richiesta anche se la relazione fisica sottostante in Salesforce è facoltativa. Ad esempio, il campo AccountId in Referente è fisicamente una relazione facoltativa, ma se si ignora Referenti privati, la relazione diretta di un Referente con un Account è logicamente obbligatoria. L'indicatore di facoltatività viene utilizzato con parsimonia. Nella maggior parte dei casi, l'opzionalità indicata nell'ERD riflette l'opzionalità sottostante della relazione.

Al di là della cardinalità e dell'opzionalità, ogni relazione tra due entità esprime un certo significato che distingue quella relazione dalle altre relazioni tra le stesse due entità. I nomi finali delle relazioni, ad esempio "parte" e "composto" nello schema sopra, definiscono la natura della relazione.

Quando si combinano cardinalità, facoltatività e nomi di fine di una relazione, è possibile utilizzarli per formare una frase che descrive la relazione.

Da sinistra a destra: Ogni (può/deve) essere <nome finale 1> (uno e solo / uno o più) .

Da destra a sinistra: Ogni (può/deve) essere <nome finale 2> (uno e solo / uno o più) .

Ad esempio,

Da sinistra a destra: "Ogni referente deve essere principalmente un referente per uno e un solo account." Da destra a sinistra: "Ogni account può essere rappresentato principalmente da uno o più referenti."

Le linee di relazione sono codificate per colore. Le relazioni aggiunte dalla nuvola a fuoco per il diagramma sono disegnate a colori. Le linee nere rappresentano una relazione fornita con una licenza diversa da quella di focus cloud.

Le relazioni possono essere tra due occorrenze della stessa entità. Questa è detta relazione ricorsiva. Una linea di relazione curva viene utilizzata per indicare relazioni ricorsive.

Gli ERD Salesforce in genere escludono la maggior parte delle regole aziendali per concentrarsi sulla struttura del modello di dati, ma una relazione che si esclude a vicenda è una regola aziendale che è informativa per la struttura in modo che venga notata. Una relazione che si esclude a vicenda indica che solo una delle numerose relazioni incluse nell'arco verrà utilizzata per una determinata occorrenza. Tenere presente che due, tre o più relazioni possono partecipare alla stessa relazione che si esclude a vicenda. Una frase che descrive la relazione di esclusione reciproca mostrata qui potrebbe essere: "Ogni entità può essere un'istanza di una e una sola Prima altra entità o di una e una sola Seconda altra entità."

Tenere presente che negli ERD Salesforce, una linea di relazione interrotta che passa attraverso l'arco non fa parte della relazione che si esclude a vicenda.

Gli ERD ufficiali dei prodotti Salesforce seguono le convenzioni di layout per migliorare la leggibilità. Queste convenzioni di layout includono quanto segue:

• Le linee di relazione devono essere sempre dritte.
• Le linee di relazione devono essere tracciate verticalmente o orizzontalmente. Nelle rare occasioni in cui ciò non è possibile, utilizzare una linea retta su una diagonale.
• Per mantenere le linee di relazione dritte, le caselle entità possono essere ridimensionate (più alte o più larghe) per fornire un punto di arrivo per le relazioni tra le due entità. Le entità più importanti (che hanno più relazioni che le riguardano) sono visualizzate più in grande nel diagramma, rafforzandone l'importanza.
• In una singola relazione ERD, le zampe di gallina sulle relazioni devono essere costantemente sul lato sinistro e/o superiore della linea di relazione (layout capovolto) o sempre sul lato destro e/o inferiore della linea di relazione (layout capovolto a destra). Questa convenzione offre chiarezza in quanto risulta in entità simili riunite nella stessa area del diagramma, il che è utile per comprendere le entità. L'uso del layout capovolto fa sì che i diagrammi appaiano capovolti con entità controllate che cadono sopra o a sinistra delle entità controllanti, tuttavia ciò garantisce che le entità più specifiche del diagramma cadano nell'angolo superiore sinistro del diagramma, rendendo i diagrammi più distinguibili l'uno dall'altro e riconoscibili. L'uso della convenzione di layout lato destro fa sì che le stesse entità comuni cadano in alto a sinistra di ogni diagramma, ma le entità secondarie si troveranno sotto o a destra delle entità controllanti.

La stretta osservanza di queste convenzioni di layout consente di ottenere un diagramma pulito e facile da leggere.

Assicurarsi di controllare la galleria dei modelli di dati per i modelli di dati Salesforce più recenti che seguono questo standard.