Vai alla documentazione

CLASSI DEL MODELLO E CONTRATTI

Diagramma delle classi: guida

Crea classi visivamente. Definisci membri e relazioni, verifica il modello, organizza i package e salva o esporta il diagramma.

Classi e relazioni → diagramma delle classiApri diagramma delle classi

Progetta le classi e le loro responsabilità

Il Diagramma delle classi è uno spazio di lavoro visivo separato per classi, classi astratte, interfacce ed enumerazioni. Ogni classificatore ha un nome, uno scomparto per attributi o valori letterali e uno scomparto per le operazioni. I nomi astratti sono in corsivo; interfacce ed enumerazioni mostrano il loro stereotipo. Seleziona una classe e usa Colore intestazione per scegliere un preset, un colore personalizzato o Neutro. I colori delle intestazioni vengono salvati, supportano Annulla/Ripristina e compaiono nelle esportazioni di immagini; il testo dei membri rimane leggibile.

I nuovi diagrammi chiedono di scegliere Diagramma vuoto o Modello del sistema di ordini. I nuovi diagrammi rimangono in memoria fino a quando non vengono salvati sul cloud o scaricati come JSON. La sua barra dell'editor compatta contiene il nome del diagramma, il menu File, Annulla/Ripristina, il controllo del tema e l'esportazione delle immagini. I file cloud di Diagramma delle classi sono separati dai documenti SQL, Prisma e Editor ERD.

Crea il tuo primo diagramma delle classi

  1. Apri "Diagramma delle classi" e scegli "Diagramma vuoto" o il modello "Sistema ordini". File → "Nuovo diagramma" apre nuovamente il selettore; File → "Vuoto" sostituisce il diagramma corrente con conferma e Annulla.
  2. Fai clic su Classe o trascinala dalla Libreria sull'area di disegno, quindi rinominala in Customer nell'ispettore (usa Modifica dettagli su uno schermo stretto) e aggiungi un attributo id con visibilità Private (-) e tipo UUID.
  3. Per un classificatore personalizzato, scegli Custom classifier o modifica il campo opzionale Stereotype su qualsiasi classificatore esistente. Tag come entity, service o controller appaiono come «il tuo tag» sopra il nome e sono inclusi nei file cloud, JSON e nelle esportazioni di immagini. Mantengono il comportamento del classificatore di base selezionato; lo strumento non convalida i profili UML.
  4. Aggiungi un'altra classe denominata Order. Aggiungi un'operazione come calculateTotal con tipo di ritorno Decimal. I campi guidati mostrano un'anteprima prima di confermare.
  5. Scegli Associazione dalla libreria delle relazioni. Da inizia con la classe selezionata quando ne è selezionata una. Imposta Da su Customer e A su Order, quindi crealo. Seleziona il connettore per aggiungere un'etichetta e le molteplicità.
  6. Per creare entrambi gli elementi insieme, seleziona una classe e scegli Connetti nuovo. Aggiungi classe connessa ti consente di scegliere il nuovo classificatore, il nome opzionale, la relazione e la direzione. Ereditarietà e realizzazione inizialmente puntano il nuovo figlio o implementatore verso il genitore o contratto selezionato; altri tipi inizialmente puntano dalla classe selezionata a quella nuova. Crea classe connessa applica entrambi in un unico passaggio di annullamento; Annulla o Esc scarta il modulo.
  7. Usa Disponi e Adatta diagramma, quindi scarica il JSON da File per un backup modificabile o Esporta diagramma per PNG, JPEG, WebP, SVG vettoriale o PDF.

Attributi, valori letterali e visibilità

Seleziona un classificatore e usa Campi per aggiungere un attributo con un nome, un tipo obbligatorio, una visibilità e un valore predefinito opzionale. I suggerimenti sui tipi includono tipi comuni e nomi di classificatori; sono consentiti tipi personalizzati. Aggiungi o Salva modifiche applica la previsualizzazione in una sola modifica. Annulla o Esc scarta il modulo in sospeso.

Usa + per visibilità pubblica, - per privata, # per protetta e ~ per pacchetto. La modalità testo accetta un membro per riga. Il formato riordina solo le firme valide supportate; la notazione personalizzata rimane testo e viene conservata quando un'altra riga cambia.

Le enumerazioni usano Letterali al posto degli Attributi. Inserisci un nome letterale e un valore facoltativo, ad esempio ACTIVE = "active". I campi guidati rifiutano nomi di membri ripetuti. Il testo personalizzato viene conservato anche quando non può essere rappresentato nei campi.

UML attributes / Firme degli attributi
- id: UUID
+ displayName: String
# active: Boolean = true
~ tags: List<String> = []
La sintassi dei membri è un aiuto alla modifica conservativo, non un controllo dei tipi completo per UML o linguaggi di programmazione. I nomi dei tipi non creano o collegano automaticamente altri classificatori.

Operazioni e parametri tipizzati

Un'operazione ha visibilità, un nome, parametri tipizzati con valori predefiniti opzionali e un tipo di ritorno opzionale. Aggiungi parametro inserisce una riga di input; il suo pulsante di rimozione elimina quel parametro in sospeso. Le nuove operazioni hanno come tipo di ritorno predefinito void.

In modalità Testo, scrivi nome(parametro: Tipo): TipoDiRitorno, con un prefisso di visibilità opzionale. Sono supportati tipi generici annidati e valori predefiniti tra virgolette. Ogni parametro richiede un nome distinto e un tipo. Gli overload possono condividere il nome di un'operazione quando i tipi dei loro parametri differiscono.

UML operations / Firme delle operazioni
+ placeOrder(items: List<OrderItem>): Order
+ findOrders(status: String = "open"): List<Order>
- calculateTotal(): Decimal

Scegli la notazione delle relazioni

Passa il mouse o posizionati con la tastiera su una classe (tocca per selezionare sui touchscreen) per rivelare i suoi punti di connessione, quindi trascina verso un'altra classe per creare un'associazione. I punti rimangono nascosti a riposo e nei diagrammi di sola lettura. Puoi anche scegliere una relazione dalla libreria. L'ispettore ti consente di modificare tipo, endpoint, etichetta e molteplicità degli endpoint come 1, 0..1 o 0..*. Le molteplicità sono testo modificabile; lo strumento non deduce le regole aziendali.

Ogni molteplicità ha preimpostazioni 1, 0..1, 0..* e 1..*. Il testo personalizzato rimane modificabile e viene conservato. Il significato della relazione spiega la direzione effettiva, genitore/contratto o intero/parte, e i conteggi delle associazioni: la molteplicità A conta le istanze per B; la molteplicità B conta il contrario. La guida non aggiunge convalida semantica.

I nomi delle relazioni si trovano direttamente sul connettore vicino al suo punto medio. Le molteplicità rimangono vicine al confine della propria classe e si staccano dalle teste UML. Le etichette seguono il trascinamento in tempo reale, quindi si posizionano rispetto alle altre etichette al rilascio. Il testo lungo va a capo; i percorsi affollati potrebbero richiedere un chiaro ripiego se l'etichetta non entra sulla linea.

Ruoli e navigazione aggiunge i ruoli opzionali Da ruolo e A ruolo accanto alla classe pertinente. Ruoli o etichette diversi distinguono collegamenti strutturali paralleli, come billingAddress e shippingAddress. La navigazione dell'associazione può puntare a Da, A o entrambi. Gli altri tipi di relazione mantengono le loro teste semantiche.

Lo strumento rifiuta endpoint mancanti, duplicati esatti per direzione/tipo/etichetta/ruolo strutturale, cicli di ereditarietà ed auto-ereditarietà o realizzazione. Le sole modifiche di molteplicità, navigazione e percorso non creano un collegamento distinto. Associazione, aggregazione, composizione e dipendenza possono collegare una classe a se stessa. Questi controlli strutturali non garantiscono la completa validità semantica UML.

Scegli la notazione delle relazioni
RelazioneDirezione e simbolo
AssociazioneLa linea tra classificatori associati; le frecce di navigazione opzionali puntano a una classe raggiungibile. I collegamenti ricorsivi sono supportati.
EreditarietàDa è la sottoclasse. Una linea continua termina in un triangolo cavo in A, il genitore.
RealizzazioneDa implementa il contratto in A. Una linea tratteggiata termina in un triangolo cavo in A.
AggregazioneDa è il tutto e A è la parte. Un rombo cavo appartiene a Da.
ComposizioneDa possiede il ciclo di vita di A. Un rombo pieno appartiene a Da.
DipendenzaDa dipende a A. Una freccia aperta tratteggiata punta al fornitore in A.

Lati automatici, teste fisse e percorsi

Curvo è l'impostazione predefinita per un nuovo diagramma. Visualizza → Percorsi di connessione nella barra degli strumenti dell'area di disegno offre Curvo e Angolato per impostare tutti i percorsi e l'impostazione predefinita per le nuove connessioni. Angolato utilizza segmenti orizzontali e verticali con piccoli angoli arrotondati. Seleziona un connettore per sovrascrivere singolarmente il suo percorso di linea.

Le nuove connessioni scelgono automaticamente i lati adatti man mano che le classi si muovono o vengono ridimensionate. Le connessioni a sinistra e a destra si attaccano all'intestazione. In alto e in basso si attaccano al rispettivo bordo della scheda. La scelta di In alto, In basso, A sinistra o A destra nell'ispettore fissa solo quell'estremità; il suo partner può continuare a seguire automaticamente.

Scegli Auto nel selettore del lato di partenza o di arrivo per far seguire a quell’estremità la classe. Lati automatici libera entrambe le estremità. Trascina un’estremità selezionata per cambiare lato oppure il punto centrale per curvare il connettore. Esc annulla; Home o un doppio clic ripristina la curva. Ripristina connessione riattiva il percorso automatico. Le modifiche supportano Annulla, salvataggio ed esportazione di immagini.

I percorsi evitano le schede connesse; i collegamenti ricorsivi formano un ciclo all'esterno della classe e i collegamenti paralleli utilizzano percorsi separati. La disposizione e i lati automatici migliorano la leggibilità ma non garantiscono di evitare ogni scheda non correlata o altra connessione. Le bozze JSON precedenti senza modalità laterali mantengono i lati salvati finché non scegli Auto.

Controlla il tuo modello e rinomina in sicurezza

Checks apre Errori, Avvisi e Suggerimenti per la notazione dei membri, i nomi, i limiti di molteplicità e la struttura di ereditarietà. Seleziona un problema per rivelare la sua classe o relazione e il campo rilevante. I controlli preservano il testo personalizzato, non applicano mai correzioni automatiche e non agiscono come un compilatore di linguaggio di programmazione.

Rinomina con riferimenti… in una classe selezionata mostra in anteprima i riferimenti di tipo esatti negli attributi, nei parametri delle operazioni e nei tipi di ritorno. Scegli i riferimenti da aggiornare, quindi applica il nome e i riferimenti come un'unica operazione di annullamento. La notazione personalizzata, i valori predefiniti, i tipi esterni qualificati e i riferimenti ambigui a nomi di classificatori ripetuti rimangono invariati.

Le sostituzioni del tipo selezionate devono rientrare nel limite di 8.000 caratteri di ciascun compartimento dei membri. Se un aggiornamento proposto lo supera, deseleziona alcuni riferimenti o cancella tutte le selezioni di riferimenti per rinominare solo la classe. Lo strumento rifiuta l'aggiornamento di dimensioni eccessive invece di troncare il testo dei membri.

Allinea, distribuisci e blocca le classi

Il layout offre allineamento della classe selezionata, spazi orizzontali/verticali uguali, Disponi selezione, blocchi di posizione e un interruttore per l'Allineamento alle guide. Ctrl/Cmd-clic per selezionare le classi. Le classi bloccate rimangono fisse durante il trascinamento, il movimento del pacchetto e la disposizione; i blocchi sopravvivono ai salvataggi. Spazi uguali preservano le classi esterne e lasciano inalterati gli intervalli affollati. La disposizione della selezione lascia le altre classi fisse e posiziona il suo blocco lontano da esse, oppure mantiene il grafico intatto se nessuna posizione è adatta. I trascinamenti di classe singola si agganciano entro sei pixel dello schermo; le guide e il relativo interruttore rimangono al di fuori dei file salvati. Le impostazioni di routing seguono il salvataggio, la copia e Annulla/Ripristina.

Disponi e naviga nell'area di disegno

Fai clic su Disponi per la disposizione intelligente. Utilizza le dimensioni delle classi e la struttura delle relazioni, posiziona genitori e interfacce sopra i figli e separa i gruppi disconnessi. Il menu a discesa offre anche Da sinistra a destra, Dall'alto in basso e Compatto.

La disposizione preserva il significato delle relazioni e i lati di endpoint fissi, aggiorna i lati automatici e adatta il risultato. Annulla lo inverte in un solo passaggio. Se il documento cambia mentre il motore di layout si carica, il risultato obsoleto viene scartato; disponi di nuovo per il nuovo documento.

I layout di grandi dimensioni si muovono insieme entro i limiti di posizione salvati. Se una disposizione non entra, il diagramma rimane intatto; prova Solo nomi o un'altra direzione, quindi disponi di nuovo.

Trascina le classi per posizionarle, trascina la canvas vuota per eseguire la panoramica e scorri per ingrandire. Adatta diagramma e i controlli dello zoom aiutano la navigazione; la minimappa mostra una panoramica. Con larghezze fino a 900px, l'ispettore si sposta sotto la canvas. Seleziona una classe o una connessione e scegli Modifica dettagli (Visualizza dettagli per un file condiviso) per accedervi; Torna al diagramma ritorna alla canvas. La scelta di una relazione apre il suo modulo in visualizzazione. La guida del diagramma delle classi si apre in una scheda separata in modo che la bozza corrente rimanga aperta.

Trova o Ctrl/Cmd+K cerca nomi, stereotipi, attributi, operazioni, nomi di pacchetti e note. Usa i tasti Freccia Su/Giù e Invio per selezionare e centrare un risultato; i risultati dei membri rivelano i dettagli completi di quella classe e mettono a fuoco la relativa sezione dell'ispettore. Esc chiude Trova. Concentra le connessioni enfatizza la classe selezionata e i vicini immediati attenuando gli elementi non correlati; Mostra tutto o Esc esce dalla messa a fuoco.

Apri Visualizza nella barra degli strumenti dell'area di disegno per scegliere Dettagli completi, Solo attributi o Solo nomi. Solo attributi mantiene attributi o valori letterali di enumerazione e riassume le operazioni; Solo nomi mostra il conteggio dei membri. Passa il mouse sopra, seleziona o metti a fuoco una classe per sovrascrivere il suo livello di dettaglio, o scegli Predefinito del diagramma per ereditarlo. La modifica del livello globale cancella le sostituzioni. La messa a fuoco e i dettagli funzionano anche nei file condivisi, rimangono al di fuori dei documenti salvati e di Annulla/Ripristina e non modificano il testo dei membri. Le immagini seguono il livello di dettaglio selezionato; i file JSON e cloud mantengono i membri completi.

Tieni premuto Ctrl/Cmd mentre fai clic per selezionare un gruppo. La barra degli strumenti di selezione compatta espone Focus, Duplica e Collega nuovo quando applicabile; Altre azioni di selezione contiene Copia selezione, Crea package ed Elimina selezione. Modifica dettagli o Visualizza dettagli su dispositivi mobili apre comunque l'ispettore. Duplica selezione crea una copia con offset; Copia selezione e Incolla possono trasferire classi o note tra diagrammi di classi quando è disponibile l'accesso agli appunti del browser. Una copia in memoria supporta Incolla all'interno dell'area di lavoro. Le copie ricevono nuovi ID e nomi non utilizzati, mantengono gli offset di gruppo e le relazioni interne, e includono un package solo quando tutte le sue classi vengonope copiate. La selezione di un package copia tutti i suoi membri. Un duplicato o un'operazione di incolla costituisce un singolo passaggio di annullamento; i campi di testo mantengono il comportamento nativo di copia/incolla.

Aggiungi note e raggruppa le classi in package

Nota — "Aggiungi un commento" crea una nota e focalizza il testo della Nota nell'ispettore; una nota vuota sulla tela dice "Scrivi una nota…". "Collega nota" la unisce a una classe o relazione con un legame tratteggiato; la nota rimane dove posizionata mentre il legame segue l'obiettivo. L'eliminazione dell'obiettivo scollega la nota e ne mantiene il testo. Le note lunghe vanno a capo in un'anteprima delimitata; il testo completo rimane modificabile.

Package — Raggruppa classi raggruppa immediatamente le classi selezionate. Senza alcuna selezione, scegli i membri e un nome opzionale per il Package, quindi Crea package. Ogni classe appartiene al massimo a un package. Trascina la sua intestazione per muovere i membri insieme a meno che un membro non abbia la posizione bloccata. Separa classi rimuove solo la cornice. Usa la freccia dell'intestazione o l'ispettore per comprimere un package in un conteggio di classi con connessioni esterne. Trova e Controlla espandono i package per rivelare i membri. I package rimangono gruppi visivi, non namespace o endpoint di relazioni semantiche. La compressione è solo per la visualizzazione: JSON/cloud mantengono tutti i membri e i collegamenti; le immagini corrispondono alla vista mostrata.

File cloud, JSON portabile e immagini

File → Esporta PlantUML mostra l'anteprima del codice sorgente modificabile e offre Copia testo o Scarica .puml. Esporta localmente membri completi, tipi, stereotipi, colori, ruoli/navigazione/molteplicità, pacchetti e note. PlantUML sceglie il proprio layout, quindi le posizioni dell'area di disegno, i lati fissi, i blocchi di posizione e le viste compresse non vengono esportati. Usa JSON per preservare il diagramma modificabile completo. L'importazione PlantUML non è disponibile.

Il Diagramma delle classi non salva i diagrammi nella memoria del browser. I nuovi diagrammi rimangono in memoria. Salva (Ctrl/Cmd+S) effettua l'accesso quando necessario e crea o aggiorna un file cloud indipendente per il diagramma delle classi. File → Apri diagrammi delle classi apre il proprio elenco di file ricercabili. File → Condividi diagramma delle classi controlla l'accesso pubblico; gli spettatori possono ispezionare ed esportare ma non possono modificare. I diagrammi non salvati chiedono conferma prima di uscire o ricaricare. Scarica JSON da File per mantenere una copia modificabile e usa Importa JSON per riaprire una versione esportata del file del diagramma delle classi di Erd Go. Le importazioni vengono convalidate prima della sostituzione.

Vuoto, Esempio e Importa chiedono prima di sostituire un diagramma non vuoto e supportano Annulla. L'esportazione del diagramma offre PNG, JPEG, WebP, SVG vettoriale autonomo e PDF basato su immagini su sfondo bianco. Cattura l'intero diagramma (predefinito), comprese le classi fuorischermo, o la vista corrente. I preset HD, 2K e 4K preservano le proporzioni entro 8192px per lato e 16 megapixel; il formato vettoriale SVG si ridimensiona liberamente. Mantieni il JSON o un file cloud per ulteriori modifiche al diagramma.

Note opzionali e pacchetti estendono il formato esistente della versione 1; i file più vecchi si aprono ancora senza di essi. I limiti sono 200 classificatori, 600 relazioni, 100 note di massimo 2.000 caratteri, 50 pacchetti, 8.000 caratteri per scomparto di membri e un file JSON importato di 32 MB. I nomi dei file cloud devono contenere da 3 a 255 caratteri. Salva sul cloud o scarica il JSON prima di uscire per conservare un diagramma non salvato. Le vecchie bozze locali del browser vengono lasciate intatte e non vengono più aperte automaticamente.

La generazione del codice sorgente, la conversione SQL e l'importazione da testo a diagramma non sono disponibili in questo strumento.

Scorciatoie da tastiera

Scorciatoie da tastiera
AzioneScorciatoia
Salva nel cloudCtrl/Cmd+S. Accedi se richiesto.
Trova una classe, un membro, un pacchetto o una notaCtrl/Cmd+K, quindi Freccia Su/Giù e Invio.
Copia / Incolla selezioneCtrl/Cmd+C / Ctrl/Cmd+V dall'area di disegno. Incolla richiede un diagramma modificabile.
Duplica selezioneCtrl/Cmd+D dall'area di disegno.
Annulla / RipristinaCtrl/Cmd+Z / Ctrl/Cmd+Shift+Z o Ctrl/Cmd+Y dall'area di disegno.
Elimina selezioneCancella o premi Backspace dall'area di disegno. Eliminare una classe rimuove anche le relative relazioni incidenti.
Scegli il lato del connettoreConcentrati su una testa di connettore selezionata e usa un tasto freccia.
Annulla o chiudiIl tasto Esc annulla un modulo membro, di classe connessa o pacchetto o l'anteprima dell'intestazione del connettore, chiude Trova o un menu, o esce dalle connessioni di Focus dall'area di disegno.
Annulla/Ripristina conserva fino a 80 modifiche al documento. Una modifica di testo selezionata o il trascinamento di un nodo vengono raggruppati; le modifiche alla visuale rimangono fuori dalla cronologia. Le scorciatoie della tela non eliminano gli elementi del diagramma mentre modifichi un campo, usi un modulo o apri un menu.

Risolvere i problemi del diagramma

Risolvere i problemi del diagramma
SintomoCosa provare
Una testata rimane su un lato inattesoVerifica se quell'estremità è Fissa. Scegli il suo controllo Automatico per riprendere il posizionamento automatico.
Una relazione viene rifiutataControlla endpoint, duplicati esatti, auto-ereditarietà/realizzazione e cicli di ereditarietà. Assegna ruoli o etichette diversi a collegamenti strutturali distinti.
Un membro non può essere salvatoFornisci i nomi/tipi richiesti, rimuovi i nomi di parametro o le firme di membro duplicate e rivedi il messaggio di convalida. Usa Testo per le notazioni personalizzate non supportate.
Un modulo indica che i membri sono cambiatiAnnulla e riaprilo dopo Annulla o un'altra modifica del testo per utilizzare la versione corrente del membro.
Una classe o un membro non è visibileUsa Trova o Ctrl/Cmd+K. I risultati dei membri rivelano i dettagli completi e mettono a fuoco la sezione corrispondente dell'ispettore; anche Adatta diagramma e la minimappa sono d'aiuto.
Impossibile importare un fileScegli un file JSON di Diagramma delle classi Erd Go esportato, non SQL, un file dell'Editor, SVG o un piano di modellazione. Il tuo diagramma corrente viene mantenuto in caso di errore.
Salvataggio sul cloud non riuscitoTieni il diagramma aperto, controlla l'accesso e la connessione, quindi riprova. Scarica il JSON prima di lasciare la pagina per conservare un backup modificabile.

Pianifica un Diagramma delle classi con l'IA

Usa Copia prompt AI per condividere questa guida con il tuo assistente, quindi descrivi responsabilità, proprietà, ereditarietà e molteplicità. Chiedi chiarimenti dove i requisiti lasciano ambigua una relazione.

Richiedi nomi di classificatori, firme dei membri e un elenco di relazioni con ruoli Da e A espliciti. Costruisci il risultato utilizzando la libreria visiva e l'ispettore. Il seguente piano è descrittivo, non un linguaggio di importazione.

Modeling plan / Piano di modellazione UML
Class Customer
  Attribute: - id: UUID
  Operation: + placeOrder(items: List<OrderItem>): Order

Class Order
  Operation: + calculateTotal(): Decimal

Association: Customer → Order
  Label: places
  Customer end: 1
  Order end: 0..*