Comportamento
Diagrammi di Action
Modellare un flusso funzionale con costrutti di sequenza, parallelo, decisione, ciclo e uscita, gli item che passano tra le azioni, le risorse che usano e gli asset che le eseguono, quindi simularlo.
In questa pagina
- Panoramica
- Concetti
- Come usarlo
- Quando e perché
- Costruire un flusso da zero
- Costruire un flusso trascinando dalla tavolozza
- Collegare Input/Output e Resource
- Assegnare gli esecutori
- Scomporre e approfondire
- Simulare e convalidare
- Esempio pratico: il passaggio di acquisizione immagini di CubeSat EO-1
- Suggerimenti e buone pratiche
- Errori comuni
- Come si collega alle altre funzionalità
- L'editor
- Come il diagramma corrisponde a LML
- Script di simulazione
- Eliminare e rimuovere
- Scorciatoie da tastiera
- Opzioni e impostazioni
- Messaggi
- Limiti
- Pagine correlate
Panoramica
Un Diagramma di Action mostra come viene svolta una Action padre. È il diagramma di comportamento di LML, e il Simulatore esegue esattamente ciò che mostra.
Il diagramma mostra:
- le Action figlie, nell'ordine in cui vengono eseguite;
- dove il flusso si divide in percorsi paralleli o alternative, e dove si ripete;
- gli Input/Output (I/O) che passano da una Action all'altra;
- le Resource usate da ogni Action;
- gli Asset che svolgono il lavoro.
Il diagramma è una vista del modello, non un disegno. Ogni forma aggiunta, spostata o eliminata modifica entità e relazioni nel progetto. Ogni modifica si può annullare con un solo annullamento.
Lo stesso flusso guida anche il Functional Flow Block Diagram (FFBD), il Diagramma di attività SysML e il Diagramma temporale. Modificando il flusso in uno qualsiasi di essi, gli altri si adeguano.
Concetti
Il flusso
Un flusso va da una pillola verde Inizio a sinistra a una pillola rossa Fine a destra. Le frecce uniscono gli elementi intermedi. Ogni elemento è uno di questi:
| Elemento | Forma | Che cosa significa | Entità |
|---|---|---|---|
| Action (passo in serie) | Riquadro blu arrotondato con numero e nome | Un passo che inizia quando termina l'elemento precedente | Una Action figlia della radice (decomposed by) |
| Parallelo | Una barra di biforcazione con l'etichetta parallel e una barra di chiusura | Due o più rami eseguiti contemporaneamente. Il flusso prosegue quando tutti i rami terminano. | Nessuno |
| SYNC | Un blocco contrassegnato SYNC con una punta a destra, e una barra di chiusura | Rami paralleli con un'entità propria. La sua Duration è un timeout che arresta i rami non terminati. | Una Action chiamata “Sync Action” (tipo di controllo SYNC) |
| OR | Un blocco contrassegnato OR con una punta a sinistra, e un cerchio di chiusura | Una decisione: viene eseguito esattamente un ramo | Una Action chiamata “Or Action” (tipo di controllo OR) |
| LOOP | Un cerchio di ingresso, il corpo del ciclo, un blocco contrassegnato LOOP, una freccia di ritorno tratteggiata | Il corpo si ripete finché vale la condizione di continuazione. La condizione viene verificata prima di ogni passaggio. | Una Action chiamata “Loop Action” (tipo di controllo LOOP) |
| EXIT | Un riquadro rosso contrassegnato EXIT | Termina il LOOP che lo contiene (o il flusso in cui si trova) quando viene raggiunto | Nessuno |
Un ramo è un percorso all'interno di un Parallelo, di un SYNC o di un OR. Ogni ramo è una sequenza a sé e può contenere qualsiasi elemento, inclusi altri costrutti. Un LOOP contiene una sequenza, chiamata il suo corpo.
OR, SYNC e LOOP sono costrutti con un'entità propria. Quell'entità è figlia della radice come un passo, così il costrutto può avere un nome, uno script e (per SYNC) un timeout. I costrutti non sono passi: non compaiono mai come riquadri Action, e viste come la Timeline li saltano.
Elementi attorno al flusso
| Elemento | Forma | Relazione | Significato |
|---|---|---|---|
| Input/Output | Parallelogramma sopra il flusso. Verde quando attiva una Action, grigio altrimenti. | Action generates I/O; Action receives I/O | Informazioni, dati o materiale scambiati tra Action |
| Input/Output del padre | Parallelogramma con l'etichetta parent input (a sinistra di Start) o parent output (a destra di End) | La Action radice lo receives o lo generates | L'interfaccia della Action padre. Disegnata tratteggiata finché nessuna Action figlia la usa. |
| Resource | Esagono viola sotto il flusso | Action consumes, produces o seizes Resource, con un Amount | Una quantità che le Action consumano, restituiscono o creano |
| Asset esecutore | ⟂ e il nome dell'Asset sotto il nome della Action | Asset performs Action | Chi o che cosa svolge la Action. Mostrato quando Asset è attivo. |
| Esecutore | ⟂ e il nome dell'Asset su un ramo Parallelo o SYNC | Asset performs ogni Action del ramo | Un esecutore per un intero ramo. Mantenuto allineato a ogni modifica. |
Due termini contano per la simulazione:
- Trigger: un I/O ricevuto con Trigger impostato (l'impostazione predefinita) fa attendere la Action ricevente finché l'I/O non esiste.
- Facoltativo: un I/O ricevuto con Trigger disattivato. La Action inizia senza attenderlo.
Una linea di Resource ha l'etichetta della relazione e della quantità, per esempio consumes 1.5. Una Resource solo trattenuta (seized) è disegnata più chiara.
Come usarlo
Quando e perché
Creare un Diagramma di Action quando si ha un insieme di funzioni e prima di allocarle all'architettura fisica. Le funzioni provengono di solito dall'Analisi funzionale dei requisiti.
Il diagramma risponde a queste domande:
- In quale ordine vengono eseguite le funzioni, e quali in parallelo?
- Dove il sistema prende una decisione?
- Di che cosa ha bisogno e che cosa produce ogni funzione?
- Quanto dura l'intera sequenza?
Usare un diagramma per livello di scomposizione. Iniziare con uno scenario operativo di primo livello, come una timeline di missione o un caso d'uso. Poi aggiungere un diagramma per ogni funzione che richiede un proprio dettaglio.
Il diagramma è eseguibile. Usarlo con il Simulatore per verificare presto i requisiti di tempo e di risorse, prima che esista l'hardware.
Costruire un flusso da zero
Creare il diagramma:
- Aprire Diagrammi in fondo alla barra di navigazione.
- Fare clic su + Nuovo diagramma.
- In Tipo di diagramma, scegliere Diagramma di Action (nel gruppo Comportamento, con l'etichetta LML).
- In Radice, digitare il nome della nuova Action, per esempio
Run Nominal Imaging Pass. (Assegnarle in seguito un numero comeOPSnell'ispettore.) - Fare clic su Crea.
Compaiono Start e End, e il suggerimento Trascinare qui un elemento o fare clic su + Action.
Aggiungere passi in sequenza:
- Fare clic su + Aggiungi ▾ → + Action ▾ → Nuova Action….
- Digitare il nome in Aggiungi Action.
- Fare clic su OK (o premere Enter).
Compare un riquadro Action numerato nel flusso. I numeri proseguono dal numero del padre: OPS.1, OPS.2 e così via. La nuova Action è figlia della radice.
- Mantenere selezionata la nuova Action e ripetere i passi da 1 a 3 per il passo successivo. + Action inserisce sempre dopo l'elemento selezionato.
Aggiungere passi eseguiti contemporaneamente:
- Selezionare il passo dopo il quale iniziano i passi paralleli.
- Fare clic su + Aggiungi ▾ → + Sync.
Compare un SYNC con due rami vuoti.
- Fare clic sulla linea di un ramo per selezionarla.
- Fare clic su + Aggiungi ▾ → + Action ▾ → Nuova Action… per aggiungere un passo a quel ramo.
- Fare clic su + Ramo se serve un terzo ramo.
Usare + Aggiungi ▾ → + Action ▾ → Rami paralleli (senza entità) invece di + Sync quando non servono timeout, nome o script.
Aggiungere una decisione:
- Selezionare il passo prima della decisione.
- Fare clic su + Or.
- Inserire la domanda, per esempio
Contact in view?.Compaiono due rami, Yes e No, al 50% ciascuno.
- Selezionare l'OR e impostare i nomi delle guardie e le probabilità nell'ispettore.
Ripetere un passo:
- Selezionare il passo.
- Fare clic su + Aggiungi ▾ → + Loop.
- Inserire il nome del ciclo.
Compare il passo racchiuso in un ciclo eseguito due volte.
- Impostare il numero di iterazioni, o un'altra condizione, nell'ispettore.
Impostare le durate e controllare il risultato:
- Selezionare una Action.
- Compilare Durata nel gruppo Pianificazione dell'ispettore.
- Per assegnare la stessa durata a più Action, fare Shift+clic su di esse e impostare Durata (N Action) nell'ispettore.
- Fare clic sul badge dei controlli del diagramma nella barra degli strumenti (✓ Controlli, o ⚠ e un numero).
L'ispettore elenca le Action senza Duration e gli elementi non collegati.
Costruire un flusso trascinando dalla tavolozza
La tavolozza a sinistra contiene i costrutti e i tipi di elemento. Trascinarli sull'area di disegno invece di usare la barra degli strumenti.
- Trascinare Action su una qualsiasi linea del flusso. La linea di rilascio si evidenzia mentre l'elemento si trova su una posizione valida.
Compare una “New Action” in quel punto. Il suo campo nome nell'ispettore è selezionato, pronto per la digitazione.
- Digitare il nome.
- Trascinare allo stesso modo Parallelo, Or, Sync, Ciclo o Exit su una linea.
- Trascinare Input/Output su una Action. Si crea un I/O che la Action genera. Rilasciarlo sull'area di disegno vuota per posizionare un I/O non collegato.
- Trascinare Resource su una Action. Si crea una Resource che la Action consuma (Amount 1). Rilasciarla sull'area di disegno vuota per posizionarla non collegata.
- Trascinare Esecutore sulla linea di un ramo di un Parallelo o di un SYNC, poi scegliere l'Asset.
L'Asset ora esegue ogni Action di quel ramo.
Per riutilizzare elementi già presenti nel modello:
- Digitare un nome in Aggiungi o trova…. Nel progetto elenca le Action, gli Input/Output, le Resource e gli Asset corrispondenti.
- Trascinare una corrispondenza sul diagramma:
- una Action su una linea;
- un I/O o una Resource su una Action o sull'area di disegno;
- un Asset sulla linea di un ramo Parallelo o SYNC.
Con la tastiera, portare lo stato attivo su un elemento della tavolozza e premere Enter o Space. I costrutti vanno alla fine del flusso principale. Input/Output e Resource vanno al centro della vista.
Collegare Input/Output e Resource
Collegare gli elementi trascinando una maniglia da una forma all'altra.
Passare un I/O da una Action all'altra:
- Selezionare la prima Action.
Compare una maniglia verde sopra di essa.
- Trascinare la maniglia sulla seconda Action.
Durante il passaggio sopra, il riquadro di destinazione mostra due metà.
- Rilasciare sulla metà Trigger (superiore) per un input di attivazione, o sulla metà Facoltativo (inferiore) per uno facoltativo.
Holarch crea un nuovo Input/Output. La prima Action lo genera e la seconda lo riceve. Il nuovo I/O è selezionato con il suo campo nome pronto per la digitazione.
- Digitare il nome dell'I/O.
La maniglia della Action può andare anche altrove:
- Su un Input/Output esistente: la Action lo genera.
- Su una Resource: la Action la produce (Amount 1).
- Sull'area di disegno vuota: Holarch crea un nuovo output della Action.
Far ricevere a una Action un I/O esistente:
- Selezionare l'Input/Output.
- Trascinarne la maniglia (sotto la forma) sulla Action.
- Rilasciare sulla Action, poi scegliere Input (trigger) o Input (facoltativo) nel selettore di collegamento.
Se la Action riceve già quell'I/O, cambia solo la sua impostazione Trigger.
Far usare una Resource a una Action:
- Selezionare la Resource.
- Trascinarne la maniglia (sopra la forma) sulla Action.
- Rilasciare sulla metà Consuma (superiore) o sulla metà Trattiene (inferiore).
Passando da consumes a seizes la quantità viene mantenuta.
Impostare la quantità di un collegamento a una risorsa:
- Selezionare la Action.
- Nella sezione Tracciabilità dell'ispettore, trovare la Resource sotto consumes, produces o seizes e fare clic su Attributi.
- Modificare l'attributo di relazione Amount.
Posizionare a mano I/O e Resource:
- Trascinare una forma Input/Output o Resource dove si desidera. La posizione viene salvata con il diagramma.
- Fare clic su Reimposta posizione nel suo ispettore per riportarla al layout automatico sopra o sotto le Action che la usano.
- Scegliere Disponi ▾ → Reimposta le posizioni di Input/Output e Resource per reimpostarle tutte.
Assegnare gli esecutori
Assegnare un Asset a una Action:
- Selezionare la Action e scegliere Apri in ▾ → Vista elemento. (Nel diagramma, performed by è bloccato nell'ispettore, perché lo gestisce il diagramma.)
- Nella sezione Tracciabilità, aggiungere performed by con + → Collega esistente….
- Scegliere l'Asset.
Assegnare un Asset a un intero ramo di un Parallelo o di un SYNC, in uno dei due modi:
- Trascinare Esecutore dal pannello Aggiungi sulla linea del ramo.
- Selezionare il Parallelo o il SYNC e fare clic su + Asset accanto al ramo nell'ispettore.
Attivare Asset nella barra degli strumenti per mostrare gli esecutori sotto il nome di ogni Action.
Scomporre e approfondire
Dare a una Action un proprio flusso figlio:
- Selezionare la Action.
- Fare clic su Scomponi.
Si apre il Diagramma di Action proprio di quella Action.
- Costruire lì il suo flusso figlio.
- Fare clic su ▲ Padre nell'intestazione della pagina per tornare.
È anche possibile aprire un flusso figlio facendo doppio clic su una Action scomposta o facendo clic sulla sua icona di scomposizione.
Raggruppare più passi in una nuova Action figlia:
- Fare Shift+clic su due o più elementi adiacenti sulla stessa linea.
- Fare clic su Scomponi (raggruppa).
Gli elementi passano in una nuova Action figlia chiamata “New Action” con un proprio flusso. Compare il messaggio Raggruppati in una nuova Action figlia. Assegnarle un nome nell'ispettore. e il campo nome è selezionato.
- Digitare il nuovo nome.
Riportare un flusso figlio in questo diagramma:
- Selezionare una Action scomposta.
- Fare clic su Appiattisci (nella barra degli strumenti o nell'ispettore).
Il suo flusso figlio la sostituisce in questo diagramma.
- Scegliere Mantieni l'Action per mantenere la Action svuotata nel modello (fuori da questo diagramma), o Elimina elemento per eliminarla.
Nel Simulatore, una Action scomposta esegue il suo flusso figlio. La sua Duration propria non viene usata.
Simulare e convalidare
- Aprire il badge dei controlli del diagramma prima della prima esecuzione e correggere ciò che elenca.
Si vede ciò che il Simulatore considererà mancante:
- Le Action senza Duration vengono simulate come 0.
- Gli I/O che nessuna Action genera lasciano in attesa i loro riceventi (un deadlock).
- Le Resource che nulla usa vengono elencate.
- Correggere ciò che il controllo segnala.
- Fare clic su ▶ Simula ▾ e scegliere Eventi discreti per seguire un'esecuzione temporizzata, o Monte Carlo per molte esecuzioni.
Il Simulatore si apre con questa Action come radice.
- Eseguire la simulazione.
Un'esecuzione che attende per sempre viene segnalata come deadlock. Lo Stato del Simulatore mostra il motivo, e la scheda Log lo elenca:
- waiting for I/O … (never generated)
- waiting for … (never available)
Correggere il diagramma ed eseguire di nuovo. Per esempio, trasformare un trigger in un input facoltativo.
Esempio pratico: il passaggio di acquisizione immagini di CubeSat EO-1
Il progetto demo contiene il Diagramma di Action OPS Run Nominal Imaging Pass.
- Creare il progetto demo con Gestisci progetti → File di progetto ▾ → Nuovo progetto demo.
- Aprire il diagramma da Comportamento → Diagrammi di Action.
Il flusso procede così:
- Tre passi vengono eseguiti in sequenza:
- OPS.1 Transmit Imaging Plan (Ground Station, triangolare 4–9 minuti, più probabile 6);
- OPS.2 Receive Imaging Plan (UHF Transceiver, 1 minuto);
- OPS.3 Load Command Schedule (C&DH, 2 minuti).
- Un Parallelo esegue contemporaneamente OPS.4 Rotate to Target (ADCS, normale 3 ± 0,5 minuti) e OPS.5 Prepare Camera (Payload Camera, 5 minuti). Entrambe ricevono Command Schedule come trigger.
- Un LOOP chiamato Each target esegue OPS.6 Capture Image Strip e OPS.7 Encode and Store Image quattro volte (Continue (×4)).
- Un OR chiamato Contact in view? sceglie il passo successivo:
- Yes (75%): OPS.8 Transmit Image Data;
- No (25%): OPS.9 Hold Data Onboard.
- Un Parallelo finale ricarica la batteria (OPS.10) mentre il segmento di terra riceve ed elabora i dati (OPS.11, OPS.12).
Il flusso usa due Resource:
- Battery Charge (Wh, iniziale 62, minimo 23, massimo 77). OPS.4 (1.5), OPS.5 (0.8), OPS.6 (2), OPS.7 (0.3) e OPS.8 (6) la consumano. OPS.10 (30) la produce.
- Data Storage (GB). OPS.7 (2.5) la produce e OPS.8 (8) la consuma.
Image Data Package è un input facoltativo di OPS.11. Un passaggio senza contatto quindi non blocca il segmento di terra.
Provare queste modifiche:
- Selezionare l'OR e cambiare Sì in 60 e No in 40.
Le etichette dei rami riportano Yes (60%) e No (40%). L'ispettore mostra Totale 100%.
- Selezionare il LOOP e impostare Numero di iterazioni su 6.
Il testo del ciclo riporta Continue (×6).
- Scegliere ▶ Simula ▾ → Monte Carlo ed eseguirlo.
Più bersagli per passaggio consumano più batteria. La striscia di riepilogo e la scheda Distribuzione mostrano il tempo di passaggio più lungo.
- Attivare Asset per vedere ogni esecutore.
- Scegliere Disponi ▾ → Genera diagramma di Asset.
Holarch crea l'Asset “Run Nominal Imaging Pass performers”. I suoi figli sono gli Asset esecutori, con Conduit per ogni I/O che passa tra due di essi. Si apre il suo Diagramma di Asset.
Suggerimenti e buone pratiche
- Dare alle Action nomi verbo + oggetto (Capture Image Strip) e agli I/O nomi sostantivi (Image Strip). Dare alle guardie OR nomi che rispondono alla domanda dell'OR.
- Limitare ogni diagramma a circa sette-dodici elementi. Raggruppare i dettagli in Action figlie con Scomponi (raggruppa).
- Usare Parallelo (senza entità) per impostazione predefinita. Usare SYNC solo quando servono un timeout, un nome o uno script.
- Un OR in modalità probabilità deve totalizzare il 100%. Quando le probabilità non sono note, scegliere Nessuno (chiedere durante l'esecuzione, o casuale). Il Simulatore allora chiede, oppure Monte Carlo usa probabilità uguali.
- Assegnare una Duration a ogni Action foglia prima di simulare. Dove il tempo varia, usare una distribuzione, per esempio
=norm.dist(40,6)Seconds. - Rendere Facoltativo un I/O ricevuto quando la Action può iniziare senza di esso. Altrimenti un ramo che non lo produce mai blocca l'esecuzione.
- Numerare i figli nell'ordine del flusso con Rinumera figli… nell'ispettore della radice (Disponi ▾ → Impostazioni del diagramma), con l'ordine dei figli impostato sull'ordine del flusso.
Errori comuni
| Sintomo | Causa | Correzione |
|---|---|---|
| Rilasciare il costrutto su una linea del flusso. | Un costrutto o una Action è stato rilasciato su una forma o sull'area di disegno vuota | Rilasciarlo su una freccia tra elementi |
| Le probabilità dei rami sommano al 90 %. Modificarle per arrivare al 100 %. | Le probabilità dell'OR non sommano correttamente | Correggere le percentuali, o aggiungere un ramo |
| La simulazione non termina mai (deadlock) | Una Action attende un I/O di attivazione che nulla genera su questo percorso | Rendere l'input Facoltativo, o generarlo su ogni percorso |
| Una Action non richiede tempo nella simulazione | Nessuna Duration, o la Action è scomposta (viene eseguito invece il suo flusso figlio) | Impostarne la Duration, o aggiungere durate ai suoi figli |
| Un passo sembra scomparire | È stato rimosso dal diagramma ma mantenuto nel modello | Digitarne il nome in Aggiungi o trova… e trascinarlo di nuovo su una linea |
| Genera diagramma di Asset segnala Nessuna Action qui ha un esecutore… | Nessuna Action ha un Asset performed by e nessun ramo ha un Esecutore | Assegnare prima gli esecutori |
Come si collega alle altre funzionalità
- Alimentato da: l'Analisi funzionale crea le funzioni (Action figlie) e il loro flusso. I requisiti raggiungono le Action tramite satisfied by. Asset e Resource provengono dall'architettura.
- Alimenta il Simulatore: tempi, costi, livelli delle risorse, utilizzo degli Asset e verifiche dei requisiti. Vedere Simulazione.
- Alimenta altre viste dello stesso flusso: l'FFBD e il Diagramma di attività.
- Alimenta viste derivate:
- il Diagramma temporale (pianificazione da Start e Duration);
- il Diagramma di sequenza (le linee di vita sono gli Asset esecutori, i messaggi sono gli I/O);
- Genera diagramma di Asset (contesto fisico e Conduit);
- il Diagramma N² (I/O tra funzioni);
- IDEF0 (input e output).
- Tracciabilità: la sezione Tracciabilità dell'ispettore mostra i requisiti di ogni Action (satisfies). La RVTM e la Matrice di tracciabilità leggono le stesse relazioni.
L'editor
Il Diagramma di Action usa l'editor di diagrammi condiviso (vedere Diagrammi). Ha una riga di barra degli strumenti, la tavolozza a sinistra, l'area di disegno e l'ispettore a destra.
Intestazione della pagina
- Selettore Tipo di diagramma: mostra la stessa Action radice in un altro tipo di diagramma applicabile alle Action. I tipi sono Gerarchia, Spider, Albero, Risk, Timeline, Action, Sequenza, Casi d'uso, N2, IDEF0, ICOM (A0), Attività e FFBD.
- ▲ Padre: apre il Diagramma di Action della Action padre. Mostrato solo quando la radice ha una Action padre.
Barra degli strumenti
La barra degli strumenti è una riga di gruppi. Le aggiunte del gruppo Inserisci (+ Action ▾, + Sync, + Or, + Ciclo, + Uscita, + Ramo, + I/O) sono in un unico elenco + Aggiungi ▾: agiscono sulla selezione (dopo di essa, attorno a essa, sui suoi rami), mentre il pannello Aggiungi a sinistra aggiunge per trascinamento o con Enter. Nell'elenco, ↓ e ↑ spostano tra le aggiunte e Esc lo chiude. Quando la finestra è stretta, le voci passano in ⋯ (Altre azioni); + Aggiungi ▾ resta nella riga, e solo Scomponi e ▶ Simula ▾ restano in forma estesa. Selezionando una forma si apre l'ispettore senza spostare i pulsanti della barra degli strumenti.
| Gruppo | Controllo | Che cosa fa |
|---|---|---|
| Modalità | Panoramica | Trascinare lo sfondo per spostare la vista (impostazione predefinita). |
| Modalità | Selezione a riquadro | Nei Diagrammi di Action seleziona solo le annotazioni. Selezionare gli elementi del flusso con Shift+clic. |
| Inserisci | + Aggiungi ▾ | Apre l'elenco delle aggiunte sotto (“Aggiungi alla selezione”). |
| Inserisci | + Action ▾ | Nuova Action… chiede il nome (predefinito New Action). Action esistente… sceglie una Action che non sia la radice, uno dei suoi antenati o già presente in questo diagramma. Rami paralleli (senza entità) aggiunge rami paralleli. Inserisce dopo la selezione, alla fine di un ramo selezionato o alla fine del flusso. |
| Inserisci | + Sync | Aggiunge un SYNC con due rami vuoti. |
| Inserisci | + Or | Chiede il Nome della decisione (una domanda) (predefinito Or Action), poi aggiunge un OR con i rami Yes e No al 50%. |
| Inserisci | + Ciclo | Chiede il Nome del ciclo (la condizione di ripetizione) (predefinito Loop Action). Con un elemento selezionato, racchiude quell'elemento nel ciclo (Inserisci l'elemento selezionato in un LOOP). Altrimenti aggiunge un ciclo vuoto (Aggiungi un LOOP vuoto). I nuovi cicli eseguono 2 iterazioni. |
| Inserisci | + Uscita | Aggiunge un EXIT dopo la selezione. |
| Inserisci | + Ramo | Aggiunge un ramo al Parallelo, al SYNC o all'OR selezionato (o a quello di cui è selezionato un ramo). Le probabilità di un OR vengono ridistribuite in parti uguali. Altrimenti è disattivato. |
| Inserisci | + I/O | Con una Action selezionata, scegliere la Action ricevente (Input/Output da “…” a…), poi dare un nome al nuovo I/O. La prima Action lo genera e la seconda lo riceve come trigger. |
| Modificare | Annulla, Ripeti | ⌘Z / Ctrl+Z, ⇧⌘Z / Ctrl+Shift+Z. |
| Modificare | Collega… | Collega da tastiera la forma selezionata a un'altra, con le stesse scelte del trascinamento della sua maniglia (vedere Tastiera e screen reader). |
| Modificare | ◀, ▶ | Spostare l'elemento selezionato di una posizione a sinistra o a destra nella sua sequenza. |
| Modificare | Rimuovi | Rimuovere la selezione dal diagramma; Shift+clic elimina le entità (vedere Eliminare e rimuovere). |
| Vista | −, zoom %, +, ⤢ | Ridurre lo zoom, digitare un livello di zoom (10–400%), aumentare lo zoom, adattare il diagramma. |
| Vista | Cerca nel diagramma con ‹ › | Evidenzia le Action, gli I/O e le Resource il cui nome, numero, descrizione, id o valori di attributo corrispondono. ↓ / ↑ (o ‹ ›) spostano tra le corrispondenze; Enter seleziona quella corrente. |
| Vista | Contenuto | Contenuto del diagramma: forme, connessioni e relazioni come testo. |
| Vista | Configura | Mostra la radice e il tipo di diagramma nell'ispettore, per cambiare l'una o l'altro sul posto (vedere Configura: radice e tipo). |
| Vista | Disponi ▾ | Vedere Disponi ▾ sotto. |
| Vista | Badge Controlli del diagramma | Elementi orfani e cicli più i controlli del Diagramma di Action (vedere Messaggi), elencati nell'ispettore con Mostra. |
| Vista | I/O, Resource, Asset, I/O del padre | Mostrare o nascondere Input/Output, Resource, Asset esecutori e Input/Output del padre. La scelta viene salvata con il diagramma e diventa quella predefinita per i nuovi Diagrammi di Action. |
| Azioni del tipo | Scomponi / Scomponi (raggruppa) | Una Action selezionata: apre il suo Diagramma di Action figlio. Più elementi: li raggruppa in una nuova Action figlia. |
| Azioni del tipo | Appiattisci | Sostituisce la Action scomposta selezionata con il suo flusso figlio. |
| Azioni del tipo | Apertura | Apre la Vista elemento dell'entità selezionata, o della radice. |
| Azioni del tipo | ▶ Simula ▾ | Eventi discreti o Monte Carlo: apre il Simulatore con questa radice. |
| Output | Esporta… | Diagramma (PNG) con Sfondo trasparente e Scala, Diagramma (SVG), Diagramma (HTML), Diagramma (Word), Diagramma (Stampa). |
| Altro | ⋯ | Le voci in eccesso, poi Apri vista elemento, Tutti i diagrammi, Guida al Diagramma di Action ed Elimina diagramma…. |
Disponi ▾
| Elemento | Che cosa fa |
|---|---|
| Ripristina predefiniti | Cancella le posizioni manuali di I/O e Resource. |
| Mostra / Nascondi | Nascondi Resource, Nascondi tutti gli Input/Output, Nascondi Input/Output del genitore, Nascondi Asset esecutori e Nascondi tavolozza; ogni voce diventa Mostra … mentre quella parte è nascosta (per esempio Mostra Asset esecutori). |
| Reimposta le posizioni di Input/Output e Resource | Riporta ogni I/O e Resource spostato al layout automatico. |
| Genera diagramma di Asset | Crea “radice performers”, vedere Genera diagramma di Asset. |
| Apri come FFBD | Apre lo stesso flusso come Functional Flow Block Diagram. |
| Impostazioni del diagramma | La radice nell'ispettore con Rinumera figli… (numeri vecchi → nuovi; l'ordine dei figli, struttura o flusso, proviene da Preferenze del progetto → Numerazione; un solo annullamento revoca tutto). |
| Nascondi pannello Aggiungi / Mostra pannello Aggiungi | Nasconde la barra laterale sinistra (tavolozza e annotazioni) in ogni diagramma. |
Genera diagramma di Asset
Disponi ▾ → Genera diagramma di Asset costruisce il contesto fisico del flusso a partire dai suoi esecutori.
- Crea l'Asset “radice performers”. Quell'Asset esegue la Action radice.
- Il nuovo Asset è decomposed by ogni Asset esecutore. Gli esecutori provengono da performed by e dagli Esecutori dei rami, a tutti i livelli sotto la radice.
- Per ogni coppia di Asset le cui Action si scambiano un I/O, riutilizza o crea un Conduit. Il Conduit si chiama “A to B”, o “A / B” quando l'I/O va in entrambi i sensi, e transfers quegli I/O.
- Poi apre il Diagramma di Asset.
Tavolozza
Il pannello Aggiungi (suggerimento Trascinare su una linea o una forma, o premere Enter) elenca:
| Elemento | Rilascio su | Crea |
|---|---|---|
| Azione | Una linea | Una nuova Action “New Action” |
| Parallelo | Una linea | Rami paralleli (senza entità) |
| Or | Una linea | Un'entità Action OR con i rami Yes/No |
| Sync | Una linea | Un'entità Action SYNC |
| Ciclo | Una linea | Un'entità Action LOOP (corpo vuoto, 2 iterazioni) |
| Uscita | Una linea | Un EXIT |
| Input/Output | Una Action, o ovunque | Un nuovo I/O chiamato “I/O”, generato dalla Action quando viene rilasciato su una |
| Resource | Una Action, o ovunque | Una nuova Resource chiamata “Resource”, consumata (Amount 1) quando viene rilasciata su una Action |
| Esecutore | La linea di un ramo Parallelo o SYNC | Chiede l'Asset (Esecutore di questo ramo), che poi esegue il ramo |
Digitare un nome in Aggiungi o trova…: Crea offre “nome” come Action, Or, Sync, Loop, Input/Output o Resource, e Nel progetto elenca le Action, gli Input/Output, le Resource e gli Asset corrispondenti (fino a 60; non la radice né le entità dei costrutti). Trascinare una riga, o premere Enter su di essa.
Sotto la tavolozza c'è la sezione Annotazioni condivisa da tutti i diagrammi. × nell'intestazione del pannello Aggiungi la nasconde. Disponi ▾ → Mostra tavolozza la riporta.
Gesti sull'area di disegno
| Gesto | Risultato |
|---|---|
| Fare clic su una forma | Selezionarlo; l'ispettore lo mostra |
| Shift+clic | Aggiungere o rimuovere un elemento dalla selezione |
| Fare clic su una linea | Selezionare il ramo a cui appartiene (o cancellare la selezione sulla linea principale) |
| Fare clic sullo sfondo | Cancella la selezione |
| Trascinare una Action o un costrutto su una linea | Spostarlo lì (con tutto ciò che contiene) |
| Trascinare un I/O o una Resource | Posizionarlo liberamente |
| Trascinare la maniglia verde | Collegare (vedere Collegare Input/Output e Resource) |
| Fare doppio clic su una Action | Aprire il suo Diagramma di Action figlio quando è scomposta, altrimenti la sua Vista elemento |
| Fare doppio clic su un I/O o una Resource | Aprirne la Vista elemento |
| Fare clic sull'icona di scomposizione | Aprire il Diagramma di Action figlio |
| Trascinare lo sfondo | Panoramica |
| Scorrimento / ⌘ / Ctrl+scorrimento | Panoramica / zoom sul puntatore |
Che cosa mostra ogni forma
- Riquadro Action: il numero (in alto), il nome e una riga sotto. Quella riga mostra la Duration (per esempio 1 minute), o gli Asset esecutori quando Asset è attivo.
- { } in viola in basso a sinistra: la Action o il costrutto ha uno script di simulazione.
- Icona di scomposizione in alto a destra: la Action ha un proprio flusso figlio. Fare clic sull'icona per aprirlo.
- Etichette dei rami OR: il nome della guardia e la sua probabilità (Yes (75%)) o condizione (Low [< 20], [else]).
- Etichette dei rami Parallelo e SYNC: il nome del ramo e il suo Esecutore.
- Testo del ciclo sotto la freccia di ritorno: Continue (×4), Continue (50%), Continue while Battery Charge > 20, Continue (script) o Continue (ask). Exit indica la via d'uscita.
- Nome del costrutto: mostrato in corsivo accanto ai blocchi OR, SYNC e LOOP.
Ispettore
L'ispettore a destra mostra la selezione. Che cosa mostra dipende da che cosa si seleziona.
Action, Input/Output, Resource o Asset: il pannello dell'entità condiviso. Contiene:
- l'intestazione con classe, numero e nome, e Apri in ▾ (Vista elemento e ogni altro diagramma di questa entità);
- Definizione: Numero, Nome e Descrizione;
- Forma: le azioni aggiuntive nella tabella sotto, e Posizione e dimensioni;
- i gruppi di attributi (Flusso di lavoro, Pianificazione e così via), poi Tracciabilità, Discussione e Dettagli.
Le relazioni gestite da questo diagramma sono bloccate nella sezione Tracciabilità, così diagramma e modello restano allineati. Sono consumed by, decomposed by, generated by, performed by, produced by, received by e seized by.
| Selezione | Azioni aggiuntive |
|---|---|
| Azione | Diagramma di Action, Modifica script…, Appiattisci (se scomposta), Rimuovi ed Elimina elemento… |
| Input/Output o Resource spostati | Reimposta posizione |
| I/O del padre scomposto in I/O figli | Mostra Input/Output del genitore mostra i suoi figli al suo posto; Nascondi Input/Output del genitore torna indietro |
| Qualsiasi | Rimuovi ed Elimina elemento… |
OR selezionato (pannello OR (decisione)):
- Nome della decisione: il nome dell'entità OR.
- Tipo di decisione: Probabilità, Quantità di risorsa, Script o Nessuno (chiedere durante l'esecuzione, o casuale).
- Resource (solo Quantità di risorsa): la Resource la cui quantità viene confrontata.
- Rami: un nome di guardia per ramo. A seconda del tipo, ogni ramo ha anche una probabilità (0–100 %), o un operatore (
==,!=,>,<,>=,<=,else) e un valore. - Riga del totale: riporta Totale 100%, o l'avviso Le probabilità dei rami sommano al N %. Modificarle per arrivare al 100 %.
- Modifica script…/Aggiungi script… (tipo Script): onEnd() restituisce il nome di guardia del ramo da prendere.
- Nota del tipo Nessuno: Con le decisioni “Prompt” il simulatore chiede quale percorso prendere; in modalità automatica sceglie un ramo a caso.
- + Aggiungi ramo, Apri elemento.
SYNC selezionato:
- Nome.
- Limite di tempo: Facoltativo. Dopo questo tempo il SYNC termina e arresta i rami ancora in esecuzione.
- La nota N rami eseguiti contemporaneamente; il flusso prosegue quando tutti terminano.
- Una riga per ramo: il nome del ramo e + Asset. Una volta impostato un Asset, la riga mostra ⟂ nome dell'Asset e × per rimuoverlo.
- Modifica script…/Aggiungi script…, + Aggiungi ramo, Apri elemento.
Parallelo selezionato: lo stesso di SYNC, senza i campi dell'entità.
Un ramo selezionato: Ramo N selezionato — + Action vi aggiunge elementi.
LOOP selezionato:
- Nome (condizione).
- Ripeti finché: Iterazioni, Probabilità, Quantità di risorsa, Script o Nessuno (chiedere durante l'esecuzione, o casuale).
- In base alla condizione: Numero di iterazioni (minimo 1), Probabilità di continuare (%), o Resource più continua finché la quantità con un operatore e un valore.
- Nota dello script: Prima di ogni passaggio viene chiamato onEnd(); restituendo true il corpo viene eseguito di nuovo.
- Nota di Nessuno: Con le decisioni “Prompt” il simulatore chiede il numero di iterazioni; in modalità automatica esegue da 0 a 2 passaggi a caso.
- Modifica script…/Aggiungi script…, la nota Un EXIT nel corpo del ciclo arresta il ciclo in anticipo., Apri elemento.
EXIT selezionato: Arresta il LOOP che lo contiene, o questo flusso, quando viene raggiunto.
Più elementi selezionati: N elementi selezionati, Durata (N Action) (un campo attivo: una modifica imposta la Duration su ogni Action selezionata in un unico passaggio di annullamento; resta vuoto quando le loro durate differiscono), Scomponi (raggruppa in una nuova Action figlia) e Rimuovi.
Come il diagramma corrisponde a LML
| Sul diagramma | Nel modello |
|---|---|
| Radice del diagramma | La Action padre |
| Riquadro Action | Action figlia: padre decomposed by figlio |
| Blocco OR, SYNC, LOOP | Action figlia con un tipo di controllo, decomposed by il padre |
| Ordine, rami, cicli | La struttura del flusso salvata con il padre (l'ordine in cui vengono eseguiti i figli) |
| Linea da una Action a un I/O | Action generates Input/Output |
| Linea da un I/O a una Action | Action receives Input/Output, con l'attributo di relazione Trigger (Yes = trigger, No = facoltativo) |
| Linea tra una Action e una Resource | consumes, produces o seizes, ciascuna con l'attributo Amount |
| ⟂ Asset | Asset performs Action (inversa performed by). L'attributo di relazione Amount è il numero di quell'Asset che la Action occupa. |
| Duration su un riquadro | L'attributo Duration della Action (un numero o una distribuzione, con un'unità) |
| Flusso figlio | Il Diagramma di Action proprio della Action figlia |
Gli attributi delle classi in questo diagramma:
- Action: Start (data e ora), Duration (valore o distribuzione più Seconds, Minutes, Hours, Days, Weeks, Months o Years) e Percent Complete.
- Resource: Units, Initial Amount, Minimum Amount e Maximum Amount.
- Input/Output: Size, Units, Type e Value.
Script di simulazione
Uno script aggiunge un comportamento che il diagramma da solo non può esprimere, come una durata calcolata o una decisione basata sui valori del modello.
Per modificare uno script:
- Selezionare una Action, un OR, un SYNC o un LOOP.
- Fare clic su Modifica script… (Action) o su Modifica script…/Aggiungi script… (OR, SYNC, LOOP).
- Fare clic su Add onStart(), Add prompt(), Add onEnd() o Add duration() per inserire una funzione hook vuota.
- Scrivere il codice. Tab inserisce due spazi.
- Fare clic su Salva. Uno script vuoto rimuove lo script.
Gli hook:
onStart()viene eseguito quando l'elemento inizia.prompt(p)costruisce una domanda per l'utente:p.setTitle(),p.addEnumInput(title, name, choices, default),addTextInput,addNumberInput,addBooleanInput.onEnd(response)viene eseguito alla fine. Un OR restituisce il nome del ramo da prendere. Un LOOP restituiscetrueper eseguire di nuovo il corpo.duration()restituisce la durata della Action quando la sua Duration è=script().
Gli script possono chiamare:
Sim.getEntityByName(n),Sim.getAmount(name),Sim.setResourceByName(name, v);Sim.getCurrentTime(),Sim.getCurrentCost();print(x);globals.put(k, v)/globals.get(k).
Le variabili di primo livello persistono per tutta l'esecuzione. Math.random usa il generatore con seme dell'esecuzione. L'API completa, la sandbox e la richiesta di attendibilità si trovano in Simulazione.
Eliminare e rimuovere
Delete o Rimuovi toglie subito la selezione dal diagramma e mantiene le entità; la nota Rimosso dal diagramma. offre Annulla ed Elimina elemento…. ⇧Delete / Shift+Delete o Elimina elemento… chiede prima conferma, poi elimina anche le entità. Un solo annullamento revoca l'una o l'altra operazione (vedere Rimuovere ed eliminare).
| Selezione | Rimuovi toglie dal diagramma | ⇧Delete / Shift+Delete elimina anche |
|---|---|---|
| Action, OR, SYNC o LOOP | l'elemento e gli elementi al suo interno | l'entità dell'elemento |
| Parallelo o EXIT | il costrutto e gli elementi al suo interno | le entità al suo interno |
| Un ramo | il ramo e i suoi elementi; l'ultimo ramo, o il corpo di un ciclo, rimuove l'intero costrutto | le entità del ramo |
| Più elementi | tutti gli elementi selezionati | le loro entità |
| Input/Output, Resource o Asset | i suoi collegamenti alle Action mostrate qui | l'entità |
| Esecutore (× nell'ispettore) | Rimuovi esecutore: “nome” esegue N Action su questo ramo. Rimuovere anche quelle relazioni performed by? | Mantieni le relazioni, Rimuovi relazioni |
Rimuovi rimuove anche il collegamento decomposed by della Action alla radice, così non è più un figlio. L'entità e le sue altre relazioni restano.
Scorciatoie da tastiera
| Tasto | Azione |
|---|---|
| Delete o Backspace | Rimuove la selezione dal diagramma (le entità restano) |
| ⇧Delete / Shift+Delete | Eliminare le entità selezionate dal progetto, dopo una conferma |
| Esc | Cancella la selezione |
| Shift+clic | Aggiunge alla selezione o rimuove da essa |
| ⌘Z / Ctrl+Z / ⇧⌘Z / Ctrl+Shift+Z | Annulla / Ripeti |
| Enter o Space su un elemento della tavolozza | Inserirlo (costrutti alla fine del flusso principale, I/O e Resource al centro) |
| ⌘ / Ctrl+scorrimento | Zoom |
| Enter nel campo dello zoom | Applicare il livello di zoom digitato |
| ↓ / ↑ in Cerca nel diagramma | Corrispondenza successiva / precedente; Enter la seleziona, Esc cancella la ricerca |
Opzioni e impostazioni
- Mostra/nascondi (interruttori della barra degli strumenti e Disponi ▾): I/O, Resource, Asset, I/O del padre e tavolozza. Salvati per diagramma, e ricordati in questo browser come predefiniti per i nuovi Diagrammi di Action. Predefiniti: I/O, Resource, I/O del padre e tavolozza attivi; Asset disattivati.
- Posizioni di I/O e Resource: salvate per diagramma. Reimpostarle con Reimposta posizione o Reimposta le posizioni di Input/Output e Resource.
- Zoom e posizione: salvati per diagramma. Un diagramma si apre adattato alla vista, ma non sotto il 70%.
- Visualizzazione in sola lettura: le persone con il ruolo Viewer vedono il diagramma senza i gruppi di modifica della barra degli strumenti, la tavolozza, le maniglie o il pannello di selezione. Possono usare panoramica, zoom, ricerca ed esportazione.
Messaggi
| Messaggio | Significato |
|---|---|
| Rilasciare il costrutto su una linea del flusso. | Costrutti e Action possono essere inseriti solo su una freccia. |
| Un elemento non può entrare in sé stesso. Rilasciarlo all'esterno. | Si è rilasciato un costrutto all'interno del proprio ramo, o si è tentato di aggiungere la radice o uno dei suoi antenati. |
| “nome” è già in questo diagramma. | Quella Action è già nel flusso. |
| Selezionare un Parallelo, un SYNC o un OR per aggiungere un ramo | + Ramo richiede che uno di essi (o uno dei suoi rami) sia selezionato. |
| Selezionare prima la Action che produce l'Input/Output | + I/O richiede una Action selezionata. |
| Selezionare una Action da scomporre, o fare Shift+clic su più Action per raggrupparle | Scomponi richiede una Action (non un costrutto). |
| Impossibile raggruppare: gli elementi sono su rami diversi. Selezionare elementi in un'unica sequenza. | Gli elementi raggruppati devono condividere un'unica sequenza. |
| Impossibile raggruppare: gli elementi non sono adiacenti. Selezionare elementi consecutivi. | Gli elementi raggruppati devono essere contigui. |
| Raggruppati in una nuova Action figlia. Assegnarle un nome nell'ispettore. | Scomponi (raggruppa) è riuscito. |
| Selezionare una Action con un diagramma figlio da appiattire | Appiattisci richiede una Action con un flusso figlio. |
| Il diagramma figlio è vuoto. Aggiungervi delle Action prima di appiattire. | La Action figlia non ha figli. |
| Impossibile appiattire: il flusso di controllo figlio non è valido. | Il flusso figlio fa riferimento a entità eliminate; aprirlo per ripararlo. |
| Questo gruppo non può essere appiattito: uno dei suoi figli compare già a questo livello. | L'appiattimento porrebbe una Action due volte. |
| Le iterazioni devono essere 1 o più. Inserire un numero intero di almeno 1. | Le iterazioni sotto 1 vengono rifiutate. |
| Le probabilità dei rami sommano al N %. Modificarle per arrivare al 100 %. | Correggere le probabilità dell'OR. |
| “nome” esegue ora le Action di questo ramo. | È stato impostato un Esecutore. |
| Nessuna Action qui ha un esecutore. Mettere in relazione le Action con gli Asset (performed by), o rilasciare un Esecutore su un ramo. | Genera diagramma di Asset non ha nulla da posizionare. |
| Creato “nome performers” con N Asset e M Conduit. | Genera diagramma di Asset è riuscito. |
| Trascinare qui un elemento o fare clic su + Action | Il flusso è vuoto. |
| Questa Action è stata eliminata. | La radice è stata eliminata. |
| ✓ Controlli sul badge dei controlli del diagramma | I controlli non hanno trovato nulla. |
| … non ha relazioni con nient'altro in questo diagramma. … Collegarlo o rimuoverlo. | Un rilievo dei controlli del diagramma (Orfani e cicli), con il motivo: L'Input/Output “nome” non è generato né ricevuto da alcuna Action in questo diagramma., La Resource “nome” non è consumata, prodotta né trattenuta da alcuna Action in questo diagramma. o La Action “nome” non ha Duration (simulata come 0). |
| La scomposizione forma un ciclo: … Rimuovere una di queste relazioni decomposed by. | Una Action è (indirettamente) figlia di sé stessa. |
| Sola visualizzazione: chiedere a un proprietario l'accesso in modifica. | Il proprio ruolo in questo progetto è Viewer. |
Limiti
- Un flusso per Action padre.
- Una Action può comparire una sola volta in un dato flusso. Usare un LOOP per ripeterla.
- Aggiungi o trova… elenca le prime 60 corrispondenze nel progetto. Digitare più caratteri del nome per restringere.
- Le probabilità dell'OR sono percentuali intere da 0 a 100.
- Le iterazioni del ciclo sono numeri interi di almeno 1.
- Le durate non sono mai negative nella simulazione: un valore negativo campionato viene estratto di nuovo.
- La selezione a riquadro seleziona solo le annotazioni. Usare Shift+clic per gli elementi del flusso.
Pagine correlate
- Diagrammi: l'editor condiviso, le esportazioni e le annotazioni.
- Analisi funzionale: funzioni, l'FFBD e le sue tabelle.
- Simulazione: esecuzioni a eventi discreti e Monte Carlo, script e risultati.
- Diagrammi SysML: i Diagrammi di attività e di sequenza costruiti sulle stesse Action.
- Altri diagrammi: Diagrammi di Asset, temporali, IDEF0 e N².
- Guida: Creare un Diagramma di Action, Diagramma di Action, Script di simulazione.