Comportamento
Diagramas de Action
Modele um fluxo funcional com construções de sequência, paralelo, decisão, laço e saída, os itens que passam entre as ações, os recursos que elas usam e os assets que as executam, e depois simule-o.
Nesta página
Visão geral
Um Diagrama de Action mostra como uma Action pai é realizada. Ele é o diagrama de comportamento da LML, e o Simulador executa exatamente o que ele mostra.
O diagrama mostra:
- as Actions filhas, na ordem em que são executadas;
- onde o fluxo se divide em caminhos paralelos ou alternativos, e onde ele faz loop;
- os Input/Outputs (I/Os) que passam de uma Action para outra;
- os Resources que cada Action usa;
- os Assets que executam o trabalho.
O diagrama é uma visão do modelo, não um desenho. Cada forma que você adiciona, move ou exclui altera entidades e relacionamentos no projeto. Cada alteração pode ser revertida com um único Desfazer.
O mesmo fluxo também alimenta o Diagrama de blocos de fluxo funcional (FFBD), o Diagrama de atividades SysML e o Diagrama de linha do tempo. Edite o fluxo em qualquer um deles e os outros acompanham.
Conceitos
O fluxo
Um fluxo vai de uma pílula verde Início à esquerda até uma pílula vermelha Fim à direita. Setas unem os elementos entre elas. Cada elemento é um destes:
| Elemento | Forma | O que significa | Entidade |
|---|---|---|---|
| Action (etapa em série) | Caixa azul arredondada com número e nome | Uma etapa que começa quando o elemento anterior termina | Uma Action filha da raiz (decomposed by) |
| Paralelo | Uma barra de bifurcação rotulada paralelo e uma barra de fechamento | Dois ou mais ramos executados ao mesmo tempo. O fluxo continua quando todos os ramos terminam. | Nenhum |
| SYNC | Um bloco marcado SYNC com uma ponta à direita, e uma barra de fechamento | Ramos paralelos com uma entidade própria. A Duração dele é um tempo limite que interrompe os ramos não concluídos. | Uma Action chamada "Sync Action" (tipo de controle SYNC) |
| OR | Um bloco marcado OR com uma ponta à esquerda, e um círculo de fechamento | Uma decisão: exatamente um ramo é executado | Uma Action chamada "Or Action" (tipo de controle OR) |
| LOOP | Um círculo de entrada, o corpo do loop, um bloco marcado LOOP e uma seta de retorno tracejada | O corpo se repete enquanto a condição de continuação for verdadeira. A condição é checada antes de cada passada. | Uma Action chamada "Loop Action" (tipo de controle LOOP) |
| EXIT | Uma caixa vermelha marcada EXIT | Encerra o LOOP que a contém (ou o fluxo em que está) quando alcançada | Nenhum |
Um ramo é um caminho dentro de um Paralelo, SYNC ou OR. Cada ramo é uma sequência própria e pode conter qualquer elemento, inclusive outras construções. Um LOOP contém uma sequência, chamada de corpo.
OR, SYNC e LOOP são construções com uma entidade própria. Essa entidade é filha da raiz como uma etapa, então a construção pode ter um nome, um script e (no caso do SYNC) um tempo limite. As construções não são etapas: nunca aparecem como caixas de Action, e visões como a Linha do tempo as ignoram.
Itens em torno do fluxo
| Item | Forma | Relacionamento | Significado |
|---|---|---|---|
| Input/Output | Paralelogramo acima do fluxo. Verde quando dispara uma Action, cinza nos demais casos. | Action generates I/O; Action receives I/O | Informação, dados ou material passados entre Actions |
| Input/Output do pai | Paralelogramo rotulado entrada do pai (à esquerda do Início) ou saída do pai (à direita do Fim) | A Action raiz o receives ou generates | A interface da Action pai. Desenhado tracejado enquanto nenhuma Action filha o usa. |
| Resource | Hexágono roxo abaixo do fluxo | Action consumes, produces ou seizes Resource, com uma Quantidade | Uma quantidade que as Actions gastam, devolvem ou criam |
| Asset executor | ⟂ e o nome do Asset sob o nome da Action | Asset performs Action | Quem ou o que realiza a Action. Mostrado quando Assets está ativado. |
| Executor | ⟂ e o nome do Asset em um ramo Paralelo ou SYNC | Asset performs todas as Actions do ramo | Um executor para um ramo inteiro. Mantido em sincronia a cada edição. |
Dois termos importam para a simulação:
- Gatilho: um I/O recebido com Gatilho definido (o padrão) faz a Action receptora esperar até que o I/O exista.
- Opcional: um I/O recebido com Gatilho desativado. A Action começa sem esperar por ele.
Uma linha de Resource é rotulada com o relacionamento e a quantidade, por exemplo consumes 1.5. Um Resource que é apenas retido é desenhado mais claro.
Como usá-lo
Quando e por quê
Monte um Diagrama de Action quando tiver um conjunto de funções e antes de alocá-las à arquitetura física. As funções geralmente vêm da Análise funcional dos requisitos.
O diagrama responde a estas perguntas:
- Em que ordem as funções são executadas, e quais rodam em paralelo?
- Onde o sistema toma uma decisão?
- Do que cada função precisa e o que ela produz?
- Quanto tempo leva a sequência inteira?
Use um diagrama por nível de decomposição. Comece com um cenário operacional de nível superior, como uma linha do tempo da missão ou um caso de uso. Depois adicione um diagrama para cada função que precise do seu próprio detalhamento.
O diagrama é executável. Use-o com o Simulador para checar cedo os requisitos de tempo e de recursos, antes de o hardware existir.
Montar um fluxo do zero
Crie o diagrama:
- Abra Diagramas na parte inferior da barra.
- Clique em + Novo diagrama.
- Em Tipo de diagrama, escolha Diagrama de Action (no grupo Comportamento, marcado LML).
- Em Raiz, digite o nome da nova Action, por exemplo
Run Nominal Imaging Pass. (Dê a ela um número comoOPSdepois, no inspetor.) - Clique em Criar.
Você vê Início e Fim, e a dica Arraste um elemento para cá ou clique em + Action.
Adicione etapas em sequência:
- Clique em + Adicionar ▾ → + Action ▾ → Nova Action….
- Digite o nome em Adicionar Action.
- Clique em OK (ou pressione Enter).
Você vê uma caixa de Action numerada no fluxo. Os números continuam a partir do número do pai: OPS.1, OPS.2 e assim por diante. A nova Action é filha da raiz.
- Mantenha a nova Action selecionada e repita as etapas 1 a 3 para a próxima etapa. + Action sempre insere depois do elemento selecionado.
Adicione etapas que rodam ao mesmo tempo:
- Selecione a etapa depois da qual as etapas paralelas começam.
- Clique em + Adicionar ▾ → + Sync.
Você vê um SYNC com dois ramos vazios.
- Clique na linha de um ramo para selecioná-lo.
- Clique em + Adicionar ▾ → + Action ▾ → Nova Action… para adicionar uma etapa a esse ramo.
- Clique em + Ramo se precisar de um terceiro ramo.
Use + Adicionar ▾ → + Action ▾ → Ramos paralelos (sem entidade) em vez de + Sync quando não precisar de tempo limite, nome ou script.
Adicione uma decisão:
- Selecione a etapa anterior à decisão.
- Clique em + Or.
- Digite a pergunta, por exemplo
Contact in view?.Você vê dois ramos, Sim e Não, com 50% cada.
- Selecione o OR e defina os nomes das guardas e as probabilidades no inspetor.
Repita uma etapa:
- Selecione a etapa.
- Clique em + Adicionar ▾ → + Loop.
- Digite o nome do loop.
Você vê a etapa envolvida em um loop que roda duas vezes.
- Defina o número de iterações, ou outra condição, no inspetor.
Defina as durações e confira o resultado:
- Selecione uma Action.
- Preencha Duração no grupo Cronograma do inspetor.
- Para dar a várias Actions a mesma Duração, faça Shift-clique nelas e defina Duração (N Actions) no inspetor.
- Clique no selo de checagens do diagrama na barra de ferramentas (✓ Checagens, ou ⚠ e um número).
O inspetor lista as Actions sem Duração e os itens que não estão conectados.
Montar um fluxo arrastando da paleta
A paleta à esquerda contém as construções e os tipos de item. Arraste-os para a tela em vez de usar a barra de ferramentas.
- Arraste Action para qualquer linha do fluxo. A linha de soltura fica destacada enquanto o item está sobre um lugar válido.
Você vê uma "Nova ação" nesse ponto. O campo de nome dela no inspetor fica selecionado, pronto para digitar.
- Digite o nome.
- Arraste Paralelo, Ou, Sync, Loop ou Saída para uma linha da mesma forma.
- Arraste Input/Output para uma Action. Isso cria um I/O que a Action gera. Solte-o na tela vazia para colocar um I/O não conectado.
- Arraste Resource para uma Action. Isso cria um Resource que a Action consome (Quantidade 1). Solte-o na tela vazia para colocá-lo sem conexão.
- Arraste Executor para a linha de um ramo de um Paralelo ou SYNC e escolha o Asset.
O Asset agora executa todas as Actions desse ramo.
Para reutilizar itens que já estão no modelo:
- Digite um nome em Adicionar ou encontrar…. No projeto lista as Actions, Input/Outputs, Resources e Assets correspondentes.
- Arraste uma correspondência para o diagrama:
- uma Action para uma linha;
- um I/O ou Resource para uma Action ou para a tela;
- um Asset para a linha de um ramo Paralelo ou SYNC.
Com o teclado, coloque o foco em um item da paleta e pressione Enter ou Space. As construções vão para o fim do fluxo principal. Os Input/Outputs e Resources vão para o centro da visão.
Conectar Input/Outputs e Resources
Conecte itens arrastando uma alça de uma forma para outra.
Passe um I/O de uma Action para outra:
- Selecione a primeira Action.
Você vê uma alça verde acima dela.
- Arraste a alça para a segunda Action.
Enquanto o ponteiro está sobre ela, a caixa de destino mostra duas metades.
- Solte na metade Gatilho (superior) para uma entrada de gatilho, ou na metade Opcional (inferior) para uma entrada opcional.
O Holarch cria um novo Input/Output. A primeira Action o gera e a segunda o recebe. O novo I/O fica selecionado com o campo de nome pronto para digitar.
- Digite o nome do I/O.
A alça da Action também pode ir para outros lugares:
- Para um Input/Output existente: a Action o gera.
- Para um Resource: a Action o produz (Quantidade 1).
- Para a tela vazia: o Holarch cria uma nova saída da Action.
Faça uma Action receber um I/O existente:
- Selecione o Input/Output.
- Arraste a alça dele (abaixo da forma) para a Action.
- Solte sobre a Action e escolha Input (gatilho) ou Input (opcional) no seletor de conexão.
Se a Action já recebe esse I/O, só o ajuste de Gatilho muda.
Faça uma Action usar um Resource:
- Selecione o Resource.
- Arraste a alça dele (acima da forma) para a Action.
- Solte na metade Consome (superior) ou na metade Retém (inferior).
Alternar entre consumir e reter mantém a quantidade.
Defina a quantidade de um vínculo de recurso:
- Selecione a Action.
- Na seção Rastreabilidade do inspetor, encontre o Resource em consumes, produces ou seizes e clique em Atributos.
- Edite o atributo de relacionamento Quantidade.
Posicione I/Os e Resources manualmente:
- Arraste uma forma de Input/Output ou Resource para onde quiser. A posição é salva com o diagrama.
- Clique em Redefinir posição no inspetor dela para devolvê-la ao layout automático acima ou abaixo das Actions que a usam.
- Escolha Organizar ▾ → Redefinir posições de Input/Output e Resource para redefinir todas elas.
Atribuir executores
Atribua um Asset a uma Action:
- Selecione a Action e escolha Abrir em ▾ → Visão do item. (No diagrama, performed by fica bloqueado no inspetor, porque o diagrama o gerencia.)
- Na seção Rastreabilidade, adicione performed by com + → Vincular existente….
- Escolha o Asset.
Atribua um Asset a um ramo inteiro de um Paralelo ou SYNC, de uma das duas formas:
- Arraste Executor do painel Adicionar para a linha do ramo.
- Selecione o Paralelo ou SYNC e clique em + Asset ao lado do ramo no inspetor.
Ative Assets na barra de ferramentas para mostrar os executores sob o nome de cada Action.
Decompor e detalhar
Dê a uma Action o seu próprio fluxo filho:
- Selecione a Action.
- Clique em Decompor.
O Diagrama de Action dessa Action abre.
- Monte o fluxo filho dela ali.
- Clique em ▲ Pai no cabeçalho da página para voltar.
Você também pode abrir um fluxo filho clicando duas vezes em uma Action decomposta ou clicando no ícone de decomposição dela.
Agrupe várias etapas em uma nova Action filha:
- Faça Shift-clique em dois ou mais elementos vizinhos na mesma linha.
- Clique em Decompor (agrupar).
Os elementos passam para uma nova Action filha chamada "Nova ação", com fluxo próprio. Você vê o aviso Agrupado em uma nova Action filha. Dê um nome a ela no inspetor. e o campo de nome fica selecionado.
- Digite o novo nome.
Achate um fluxo filho de volta neste diagrama:
- Selecione uma Action decomposta.
- Clique em Achatar (na barra de ferramentas ou no inspetor).
O fluxo filho dela a substitui neste diagrama.
- Escolha Manter a Action para manter a Action esvaziada no modelo (fora deste diagrama), ou Excluir item para excluí-la.
No Simulador, uma Action decomposta executa o seu fluxo filho. A Duração própria dela não é usada.
Simular e validar
- Abra o selo de checagens do diagrama antes da primeira execução e corrija o que ele lista.
Você vê o que o Simulador vai tratar como ausente:
- As Actions sem Duração são simuladas como 0.
- Os I/Os que nenhuma Action gera deixam os receptores esperando (um deadlock).
- Os Resources que nada usa são listados.
- Corrija o que a checagem relata.
- Clique em ▶ Simular ▾ e escolha Eventos discretos para acompanhar uma execução temporizada, ou Monte Carlo para muitas execuções.
O Simulador abre com esta Action como raiz.
- Execute a simulação.
Uma execução que espera para sempre é relatada como deadlock. O Status do Simulador mostra o motivo, e a aba Log o lista:
- aguardando o I/O … (nunca gerado)
- aguardando … (nunca disponível)
Corrija o diagrama e execute de novo. Por exemplo, transforme um gatilho em uma entrada opcional.
Exemplo prático: a passagem de imageamento do CubeSat EO-1
O projeto de demonstração contém o Diagrama de Action OPS Run Nominal Imaging Pass.
- Crie o projeto de demonstração com Gerenciar projetos → Arquivos do projeto ▾ → Novo projeto de demonstração.
- Abra o diagrama em Comportamento → Diagramas de Action.
O fluxo é executado assim:
- Três etapas rodam em sequência:
- OPS.1 Transmit Imaging Plan (Ground Station, triangular de 4–9 minutos, mais provável 6);
- OPS.2 Receive Imaging Plan (UHF Transceiver, 1 minuto);
- OPS.3 Load Command Schedule (C&DH, 2 minutos).
- Um Paralelo executa OPS.4 Rotate to Target (ADCS, normal de 3 ± 0,5 minutos) e OPS.5 Prepare Camera (Payload Camera, 5 minutos) ao mesmo tempo. Ambas recebem Command Schedule como gatilho.
- Um LOOP chamado Each target executa OPS.6 Capture Image Strip e OPS.7 Encode and Store Image quatro vezes (Continue (×4)).
- Um OR chamado Contact in view? escolhe a próxima etapa:
- Yes (75%): OPS.8 Transmit Image Data;
- No (25%): OPS.9 Hold Data Onboard.
- Um Paralelo final recarrega a bateria (OPS.10) enquanto o solo recebe e processa os dados (OPS.11, OPS.12).
O fluxo usa dois Resources:
- Battery Charge (Wh, inicial 62, mínimo 23, máximo 77). OPS.4 (1,5), OPS.5 (0,8), OPS.6 (2), OPS.7 (0,3) e OPS.8 (6) o consomem. OPS.10 (30) o produz.
- Data Storage (GB). OPS.7 (2,5) o produz e OPS.8 (8) o consome.
Image Data Package é uma entrada opcional de OPS.11. Por isso, uma passagem sem contato não deixa o segmento de solo em deadlock.
Experimente estas alterações:
- Selecione o OR e altere Yes para 60 e No para 40.
Os rótulos dos ramos dizem Yes (60%) e No (40%). O inspetor mostra Total 100%.
- Selecione o LOOP e defina Número de iterações como 6.
O texto do loop diz Continue (×6).
- Escolha ▶ Simular ▾ → Monte Carlo e execute.
Mais alvos por passagem consomem mais bateria. A faixa de resumo e a aba Distribuição mostram o tempo de passagem maior.
- Ative Assets para ver cada executor.
- Escolha Organizar ▾ → Gerar Diagrama de Asset.
O Holarch cria o Asset "Run Nominal Imaging Pass performers". Os filhos dele são os Assets executores, com Conduits para cada I/O que passa entre dois deles. O Diagrama de Asset dele abre.
Dicas e boas práticas
- Nomeie as Actions como verbo + objeto (Capture Image Strip) e os I/Os como substantivos (Image Strip). Nomeie as guardas do OR como respostas à pergunta do OR.
- Mantenha cada diagrama com cerca de sete a doze elementos. Agrupe os detalhes em Actions filhas com Decompor (agrupar).
- Use Paralelo (sem entidade) por padrão. Use SYNC somente quando precisar de um tempo limite, um nome ou um script.
- Um OR no modo de probabilidade deve somar 100%. Quando as probabilidades são desconhecidas, escolha Nenhum (perguntar durante a execução, ou aleatório). O Simulador então pergunta, ou o Monte Carlo usa probabilidades iguais.
- Dê uma Duração a toda Action folha antes de simular. Onde o tempo varia, use uma distribuição, por exemplo
=norm.dist(40,6)Segundos. - Torne um I/O recebido Opcional quando a Action puder começar sem ele. Caso contrário, um ramo que nunca o produz deixa a execução em deadlock.
- Numere os filhos na ordem do fluxo com Renumerar filhos… no inspetor da raiz (Organizar ▾ → Ajustes do diagrama), com a ordem dos filhos definida como ordem do fluxo.
Erros comuns
| Sintoma | Causa | Correção |
|---|---|---|
| Solte a construção em uma linha do fluxo. | Uma construção ou Action foi solta sobre uma forma ou na tela vazia | Solte-a sobre uma seta entre elementos |
| As probabilidades dos ramos somam 90 %. Altere-as para totalizar 100 %. | As probabilidades do OR não fecham | Corrija as porcentagens ou adicione um ramo |
| A simulação nunca termina (deadlock) | Uma Action espera por um I/O de gatilho que nada gera neste caminho | Torne a entrada Opcional, ou gere-a em todos os caminhos |
| Uma Action não leva tempo na simulação | Sem Duração, ou a Action está decomposta (o fluxo filho dela é executado em seu lugar) | Defina a Duração dela, ou adicione durações aos filhos dela |
| Uma etapa parece sumir | Ela foi removida do diagrama, mas mantida no modelo | Digite o nome dela em Adicionar ou encontrar… e arraste-a de volta para uma linha |
| Gerar Diagrama de Asset relata Nenhuma Action aqui tem executor… | Nenhuma Action tem um Asset performed by e nenhum ramo tem Executor | Atribua os executores primeiro |
Como se conecta a outros recursos
- Recebe dados de: a Análise funcional cria as funções (Actions filhas) e o fluxo delas. Os requisitos chegam às Actions por satisfied by. Os Assets e Resources vêm da arquitetura.
- Alimenta o Simulador: tempo, custo, níveis de recursos, utilização de Assets e checagens de requisitos. Veja Simulação.
- Alimenta outras visões do mesmo fluxo: o FFBD e o Diagrama de atividades.
- Alimenta visões derivadas:
- o Diagrama de linha do tempo (cronograma a partir de Início e Duração);
- o Diagrama de sequência (as linhas de vida são os Assets executores, as mensagens são os I/Os);
- Gerar Diagrama de Asset (contexto físico e Conduits);
- o Diagrama N² (I/Os entre funções);
- IDEF0 (entradas e saídas).
- Rastreabilidade: a seção Rastreabilidade do inspetor mostra os requisitos de cada Action (satisfies). A RVTM e a Matriz de rastreabilidade leem os mesmos relacionamentos.
O editor
O Diagrama de Action usa o editor de diagramas compartilhado (veja Diagramas). Ele tem uma linha de barra de ferramentas, a paleta à esquerda, a tela e o inspetor à direita.
Cabeçalho da página
- Seletor de Tipo de diagrama: mostra a mesma Action raiz em outro tipo de diagrama que se aplica a Actions. Os tipos são Hierarquia, Spider, Árvore, Risco, Linha do tempo, Action, Sequência, Caso de uso, N2, IDEF0, ICOM (A0), Atividades e FFBD.
- ▲ Pai: abre o Diagrama de Action da Action pai. Mostrado somente quando a raiz tem uma Action pai.
Barra de ferramentas
A barra de ferramentas é uma linha de grupos. As adições do grupo Inserir (+ Action ▾, + Sync, + Or, + Loop, + Saída, + Ramo, + I/O) ficam em uma única lista + Adicionar ▾: elas atuam na seleção (depois dela, em torno dela, nos ramos dela), enquanto o painel Adicionar à esquerda adiciona arrastando ou com Enter. Na lista, ↓ e ↑ movem entre as adições e Esc a fecha. Quando a janela é estreita, os itens passam para ⋯ (Mais ações); + Adicionar ▾ permanece na linha, e apenas Decompor e ▶ Simular ▾ continuam por extenso. Selecionar uma forma abre o inspetor sem mover os botões da barra de ferramentas.
| Grupo | Controle | O que ele faz |
|---|---|---|
| Modo | Mover a vista | Arraste o fundo para mover a visão (o padrão). |
| Modo | Seleção por caixa | Nos Diagramas de Action, seleciona apenas anotações. Selecione os elementos do fluxo com Shift-clique. |
| Inserir | + Adicionar ▾ | Abre a lista das adições abaixo ("Adicionar na seleção"). |
| Inserir | + Action ▾ | Nova Action… pede o nome (padrão Nova ação). Action existente… escolhe uma Action que não seja a raiz, um dos ancestrais dela ou uma que já esteja neste diagrama. Ramos paralelos (sem entidade) adiciona ramos paralelos. Insere depois da seleção, no fim de um ramo selecionado ou no fim do fluxo. |
| Inserir | + Sync | Adiciona um SYNC com dois ramos vazios. |
| Inserir | + Or | Pede o Nome da decisão (uma pergunta) (padrão Or Action) e depois adiciona um OR com os ramos Sim e Não a 50%. |
| Inserir | + Loop | Pede o Nome do loop (a condição de repetição) (padrão Loop Action). Com um elemento selecionado, envolve esse elemento no loop (Colocar o elemento selecionado dentro de um LOOP). Caso contrário, adiciona um loop vazio (Adicionar um LOOP vazio). Os novos loops executam 2 iterações. |
| Inserir | + Saída | Adiciona um EXIT depois da seleção. |
| Inserir | + Ramo | Adiciona um ramo ao Paralelo, SYNC ou OR selecionado (ou àquele cujo ramo está selecionado). As probabilidades de um OR são redistribuídas igualmente. Desativado nos demais casos. |
| Inserir | + I/O | Com uma Action selecionada, escolha a Action receptora (Input/Output de "…" para…) e depois dê nome ao novo I/O. A primeira Action o gera e a segunda o recebe como gatilho. |
| Editar | Desfazer, Refazer | ⌘Z / Ctrl+Z, ⇧⌘Z / Ctrl+Shift+Z. |
| Editar | Conectar… | Conecta a forma selecionada a outra pelo teclado, com as mesmas opções de arrastar a alça dela (veja Teclado e leitores de tela). |
| Editar | ◀, ▶ | Mover o elemento selecionado uma posição para a esquerda ou para a direita dentro da sequência dele. |
| Editar | Remover | Remover a seleção do diagrama; Shift+clique exclui as entidades (veja Excluir e remover). |
| Visão | −, % de zoom, +, ⤢ | Diminuir o zoom, digitar um nível de zoom (10–400%), aumentar o zoom, ajustar o diagrama. |
| Visão | Buscar no diagrama com ‹ › | Destaca as Actions, os I/Os e os Resources cujo nome, número, descrição, id ou valores de atributo correspondem. ↓ / ↑ (ou ‹ ›) movem entre as correspondências; Enter seleciona a atual. |
| Visão | Conteúdo | Conteúdo do diagrama: as formas, as conexões e os relacionamentos como texto. |
| Visão | Configurar | Mostra a raiz e o tipo de diagrama no inspetor, para trocar qualquer um deles no lugar (veja Configurar: raiz e tipo). |
| Visão | Organizar ▾ | Veja Organizar ▾ abaixo. |
| Visão | Selo de Checagens do diagrama | Órfãos e ciclos, mais as checagens do Diagrama de Action (veja Mensagens), listados no inspetor com Mostrar. |
| Visão | I/O, Resources, Assets, I/O do pai | Mostrar ou ocultar os Input/Outputs, os Resources, os Assets executores e os Input/Outputs do pai. A escolha é salva com o diagrama e vira o padrão para novos Diagramas de Action. |
| Ações do tipo | Decompor / Decompor (agrupar) | Uma Action selecionada: abrir o Diagrama de Action filho dela. Vários elementos: agrupá-los em uma nova Action filha. |
| Ações do tipo | Achatar | Substituir a Action decomposta selecionada pelo fluxo filho dela. |
| Ações do tipo | Abertura | Abre a Visão do item da entidade selecionada, ou da raiz. |
| Ações do tipo | ▶ Simular ▾ | Eventos discretos ou Monte Carlo: abre o Simulador com esta raiz. |
| Saída | Exportar… | Diagrama (PNG) com fundo transparente e escala, Diagrama (SVG), Diagrama (HTML), Diagrama (Word), Diagrama (Imprimir). |
| Mais | ⋯ | Os itens que não couberam, depois Abrir visão do item, Todos os diagramas, Ajuda sobre o Diagrama de Action e Excluir diagrama…. |
Organizar ▾
| Item | O que ele faz |
|---|---|
| Restaurar padrões | Limpa as posições manuais de I/Os e Resources. |
| Mostrar / Ocultar | Ocultar Resources, Ocultar todos os Input/Outputs, Ocultar Input/Outputs do pai, Ocultar Assets executores e Ocultar paleta; cada item diz Mostrar … enquanto aquela parte está oculta (por exemplo Mostrar Assets executores). |
| Redefinir posições de Input/Output e Resource | Devolve todos os I/Os e Resources movidos ao layout automático. |
| Gerar Diagrama de Asset | Cria "raiz performers"; veja Gerar Diagrama de Asset. |
| Abrir como FFBD | Abre o mesmo fluxo como um Diagrama de blocos de fluxo funcional. |
| Ajustes do diagrama | A raiz no inspetor com Renumerar filhos… (números antigo → novo; a ordem dos filhos, estrutura ou fluxo, vem de Preferências do projeto → Numeração; um único Desfazer reverte tudo). |
| Ocultar painel Adicionar / Mostrar painel Adicionar | Oculta a barra lateral esquerda (paleta e anotações) em todos os diagramas. |
Gerar Diagrama de Asset
Organizar ▾ → Gerar Diagrama de Asset monta o contexto físico do fluxo a partir dos executores dele.
- Cria o Asset "raiz performers". Esse Asset executa a Action raiz.
- O novo Asset é decomposed by cada Asset executor. Os executores vêm de performed by e dos Executores de ramo, em todos os níveis abaixo da raiz.
- Para cada par de Assets cujas Actions trocam um I/O, reutiliza ou cria um Conduit. O Conduit recebe o nome "A to B", ou "A / B" quando o I/O vai nos dois sentidos, e transfers esses I/Os.
- Depois abre o Diagrama de Asset.
Paleta
O painel Adicionar (dica Arraste para uma linha ou uma forma, ou pressione Enter) lista:
| Item | Soltar sobre | Cria |
|---|---|---|
| Ação | Uma linha | Uma nova Action "Nova ação" |
| Paralelo | Uma linha | Ramos paralelos (sem entidade) |
| Ou | Uma linha | Uma entidade Action OR com os ramos Sim/Não |
| Sync | Uma linha | Uma entidade Action SYNC |
| Laço | Uma linha | Uma entidade Action LOOP (corpo vazio, 2 iterações) |
| Saída | Uma linha | Um EXIT |
| Input/Output | Uma Action, ou qualquer lugar | Um novo I/O chamado "I/O", gerado pela Action quando solto sobre uma |
| Resource | Uma Action, ou qualquer lugar | Um novo Resource chamado "Resource", consumido (Quantidade 1) quando solto sobre uma Action |
| Executor | A linha de um ramo Paralelo ou SYNC | Pede o Asset (Executor deste ramo), que então executa o ramo |
Digite um nome em Adicionar ou encontrar…: Criar oferece "nome" como Action, Or, Sync, Loop, Input/Output ou Resource, e No projeto lista as Actions, os Input/Outputs, os Resources e os Assets correspondentes (até 60; nem a raiz nem entidades de construção). Arraste uma linha para dentro, ou pressione Enter sobre ela.
Abaixo da paleta fica a seção Anotações, compartilhada por todos os diagramas. × no cabeçalho do painel Adicionar o oculta. Organizar ▾ → Mostrar paleta o traz de volta.
Gestos na tela
| Gesto | Resultado |
|---|---|
| Clicar em uma forma | Selecioná-lo; o inspetor o mostra |
| Shift+clique | Adicionar ou remover um elemento da seleção |
| Clicar em uma linha | Selecionar o ramo a que pertence (ou limpar a seleção na linha principal) |
| Clicar no fundo | Limpar a seleção |
| Arrastar uma Action ou construção para uma linha | Movê-la para lá (com tudo o que contém) |
| Arrastar um I/O ou Resource | Posicioná-lo livremente |
| Arrastar a alça verde | Conectar (veja Conectar Input/Outputs e Resources) |
| Clicar duas vezes em uma Action | Abrir o Diagrama de Action filho dela quando estiver decomposta, senão a Visão do item dela |
| Clicar duas vezes em um I/O ou Resource | Abrir a Visão do item dele |
| Clicar no ícone de decomposição | Abrir o Diagrama de Action filho |
| Arrastar o fundo | Mover a vista |
| Rolar / ⌘ / Ctrl+rolar | Deslocar / dar zoom no ponteiro |
O que cada forma mostra
- Caixa de Action: o número (em cima), o nome e uma linha abaixo. Essa linha mostra a Duração (por exemplo 1 minuto), ou os Assets executores quando Assets está ativado.
- { } em roxo no canto inferior esquerdo: a Action ou construção tem um script de simulação.
- Ícone de decomposição no canto superior direito: a Action tem um fluxo filho próprio. Clique no ícone para abri-lo.
- Rótulos dos ramos OR: o nome da guarda e a probabilidade dela (Sim (75%)) ou a condição (Low [< 20], [else]).
- Rótulos dos ramos Paralelo e SYNC: o nome do ramo e o Executor dele.
- Texto do loop sob a seta de retorno: Continue (×4), Continue (50%), Continue while Battery Charge > 20, Continue (script) ou Continue (ask). Exit marca a saída.
- Nome da construção: mostrado em itálico ao lado dos blocos OR, SYNC e LOOP.
Inspetor
O inspetor à direita mostra a seleção. O que ele mostra depende do que você seleciona.
Action, Input/Output, Resource ou Asset: o painel da entidade compartilhado. Ele tem:
- o cabeçalho com a classe, o número e o nome, e Abrir em ▾ (Visão do item e todos os outros diagramas desta entidade);
- Definição: Número, Nome e Descrição;
- Forma: as ações extras da tabela abaixo, e Posição e tamanho;
- os grupos de atributos (Fluxo de trabalho, Cronograma e assim por diante), depois Rastreabilidade, Discussão e Detalhes.
Os relacionamentos que este diagrama gerencia ficam bloqueados na seção Rastreabilidade, para que o diagrama e o modelo fiquem em sincronia. São eles consumed by, decomposed by, generated by, performed by, produced by, received by e seized by.
| Seleção | Ações extras |
|---|---|
| Ação | Diagrama de Action, Editar script…, Achatar (quando decomposta), Remover e Excluir item… |
| Input/Output ou Resource que foi movido | Redefinir posição |
| I/O do pai decomposto em I/Os filhos | Mostrar Input/Outputs do pai mostra os filhos dele no lugar dele; Ocultar Input/Outputs do pai volta |
| Qualquer | Remover e Excluir item… |
OR selecionado (painel OR (decisão)):
- Nome da decisão: o nome da entidade OR.
- Tipo de decisão: Probabilidade, Quantidade do recurso, Script ou Nenhum (perguntar durante a execução, ou aleatório).
- Resource (somente Quantidade do recurso): o Resource cuja quantidade é comparada.
- Ramos: um nome de guarda por ramo. Conforme o tipo, cada ramo também tem uma probabilidade (0–100 %), ou um operador (
==,!=,>,<,>=,<=,else) e um valor. - Linha de total: diz Total 100%, ou o aviso As probabilidades dos ramos somam N %. Altere-as para totalizar 100 %.
- Editar script…/Adicionar script… (tipo Script): onEnd() retorna o nome da guarda do ramo a seguir.
- Nota do tipo Nenhum: Com decisões "Prompt", o simulador pergunta qual caminho seguir; quando automatizado, escolhe um ramo ao acaso.
- + Adicionar ramo, Abrir item.
SYNC selecionado:
- Nome.
- Limite de tempo: Opcional. Depois desse tempo, o SYNC termina e interrompe os ramos ainda em execução.
- A nota N ramos são executados simultaneamente; o fluxo continua quando todos terminam.
- Uma linha por ramo: o nome do ramo e + Asset. Depois que um Asset é definido, a linha mostra ⟂ nome do Asset e × para removê-lo.
- Editar script…/Adicionar script…, + Adicionar ramo, Abrir item.
Paralelo selecionado: o mesmo que SYNC, sem os campos da entidade.
Um ramo selecionado: Ramo N selecionado — + Action adiciona a ele.
LOOP selecionado:
- Nome (condição).
- Repetir enquanto: Iterações, Probabilidade, Quantidade do recurso, Script ou Nenhum (perguntar durante a execução, ou aleatório).
- Conforme a condição: Número de iterações (mínimo 1), Probabilidade de continuar (%), ou Resource mais continuar enquanto a quantidade com um operador e um valor.
- Nota de Script: Antes de cada passada, onEnd() é chamado; retornar true executa o corpo de novo.
- Nota de Nenhum: Com decisões "Prompt", o simulador pergunta o número de iterações; quando automatizado, executa de 0 a 2 passadas ao acaso.
- Editar script…/Adicionar script…, a nota Um EXIT no corpo do loop interrompe o loop antes., Abrir item.
EXIT selecionado: Interrompe o LOOP que o contém, ou este fluxo, quando alcançado.
Vários elementos selecionados: N elementos selecionados, Duração (N Actions) (um campo dinâmico: uma alteração define a Duração em todas as Actions selecionadas como uma única etapa de desfazer; fica vazio quando as durações delas diferem), Decompor (agrupar em uma nova Action filha) e Remover.
Como o diagrama corresponde à LML
| No diagrama | No modelo |
|---|---|
| Raiz do diagrama | A Action pai |
| Caixa de Action | Action filha: pai decomposed by filha |
| Bloco OR, SYNC, LOOP | Action filha com um tipo de controle, decomposed by o pai |
| Ordem, ramos, loops | A estrutura do fluxo salva com o pai (a ordem em que os filhos são executados) |
| Linha de uma Action para um I/O | Action generates Input/Output |
| Linha de um I/O para uma Action | Action receives Input/Output, com o atributo de relacionamento Gatilho (Sim = gatilho, Não = opcional) |
| Linha entre uma Action e um Resource | consumes, produces ou seizes, cada um com o atributo Quantidade |
| ⟂ Asset | Asset performs Action (inverso performed by). O atributo de relacionamento Quantidade é o número de unidades desse Asset que a Action ocupa. |
| Duração em uma caixa | O atributo Duração da Action (um número ou uma distribuição, com unidade) |
| Fluxo filho | O Diagrama de Action próprio da Action filha |
Os atributos das classes deste diagrama:
- Action: Início (data e hora), Duração (valor ou distribuição, mais Segundos, Minutos, Horas, Dias, Semanas, Meses ou Anos) e Percentual concluído.
- Resource: Unidades, Quantidade inicial, Quantidade mínima e Quantidade máxima.
- Input/Output: Tamanho, Unidades, Tipo e Valor.
Scripts de simulação
Um script acrescenta um comportamento que o diagrama sozinho não consegue expressar, como uma duração calculada ou uma decisão baseada em valores do modelo.
Para editar um script:
- Selecione uma Action, OR, SYNC ou LOOP.
- Clique em Editar script… (Action) ou em Editar script…/Adicionar script… (OR, SYNC, LOOP).
- Clique em Adicionar onStart(), Adicionar prompt(), Adicionar onEnd() ou Adicionar duration() para inserir uma função de gancho vazia.
- Escreva o código. Tab insere dois espaços.
- Clique em Salvar. Um script vazio remove o script.
Os ganchos:
onStart()é executado quando o elemento começa.prompt(p)monta uma pergunta para o usuário:p.setTitle(),p.addEnumInput(title, name, choices, default),addTextInput,addNumberInput,addBooleanInput.onEnd(response)é executado no fim. Um OR retorna o nome do ramo a seguir. Um LOOP retornatruepara executar o corpo de novo.duration()retorna a duração da Action quando a Duração dela é=script().
Os scripts podem chamar:
Sim.getEntityByName(n),Sim.getAmount(name),Sim.setResourceByName(name, v);Sim.getCurrentTime(),Sim.getCurrentCost();print(x);globals.put(k, v)/globals.get(k).
As variáveis de nível superior persistem durante a execução. Math.random usa o gerador com semente da execução. A API completa, a sandbox e a pergunta de confiança estão em Simulação.
Excluir e remover
Delete ou Remover tira a seleção do diagrama na hora e mantém as entidades; a nota Removido do diagrama. oferece Desfazer e Excluir item…. ⇧Delete / Shift+Delete ou Excluir item… pergunta primeiro e depois também exclui as entidades. Um único Desfazer reverte qualquer um dos dois (veja Remover e excluir).
| Seleção | Remover tira do diagrama | ⇧Delete / Shift+Delete também exclui |
|---|---|---|
| Action, OR, SYNC ou LOOP | o elemento e os elementos dentro dele | a entidade do elemento |
| Paralelo ou EXIT | a construção e os elementos dentro dela | as entidades dentro dela |
| Um ramo | o ramo e os elementos dele; o último ramo, ou o corpo de um loop, remove a construção inteira | as entidades do ramo |
| Vários elementos | todos os elementos selecionados | as entidades deles |
| Input/Output, Resource ou Asset | os vínculos dele com as Actions mostradas aqui | a entidade |
| Executor (× no inspetor) | Remover executor: "nome" executa N Action(s) neste ramo. Remover também esses relacionamentos performed by? | Manter relacionamentos, Remover relacionamentos |
Remover também remove o vínculo decomposed by da Action com a raiz, então ela deixa de ser filha. A entidade e os outros relacionamentos dela permanecem.
Atalhos de teclado
| Tecla | Ação |
|---|---|
| Delete ou Backspace | Remover a seleção do diagrama (as entidades permanecem) |
| ⇧Delete / Shift+Delete | Excluir as entidades selecionadas do projeto, após uma confirmação |
| Esc | Limpar a seleção |
| Shift+clique | Adicionar à seleção ou remover dela |
| ⌘Z / Ctrl+Z / ⇧⌘Z / Ctrl+Shift+Z | Desfazer / Refazer |
| Enter ou Space em um item da paleta | Inseri-lo (construções no fim do fluxo principal, I/Os e Resources no centro) |
| ⌘ / Ctrl+rolagem | Zoom |
| Enter no campo de zoom | Aplicar o nível de zoom digitado |
| ↓ / ↑ em Buscar no diagrama | Próxima / anterior correspondência; Enter a seleciona, Esc limpa a pesquisa |
Opções e ajustes
- Mostrar/ocultar (alternâncias da barra de ferramentas e Organizar ▾): I/O, Resources, Assets, I/O do pai e Paleta. Salvo por diagrama e lembrado neste navegador como padrão para novos Diagramas de Action. Padrões: I/O, Resources, I/O do pai e Paleta ativados; Assets desativado.
- Posições de I/Os e Resources: salvas por diagrama. Redefina-as com Redefinir posição ou Redefinir posições de Input/Output e Resource.
- Zoom e posição: salvos por diagrama. Um diagrama abre ajustado, mas a no mínimo 70%.
- Exibição somente leitura: as pessoas com a função Leitor veem o diagrama sem os grupos de edição da barra de ferramentas, a paleta, as alças ou o painel de seleção. Elas podem deslocar, dar zoom, pesquisar e exportar.
Mensagens
| Mensagem | Significado |
|---|---|
| Solte a construção em uma linha do fluxo. | Construções e Actions só podem ser inseridas sobre uma seta. |
| Um elemento não pode ficar dentro de si mesmo. Solte-o fora. | Você soltou uma construção dentro do próprio ramo, ou tentou adicionar a raiz ou um dos ancestrais dela. |
| "nome" já está neste diagrama. | Essa Action já está no fluxo. |
| Selecione um Paralelo, SYNC ou OR para adicionar um ramo | + Ramo precisa de um deles (ou de um dos ramos dele) selecionado. |
| Selecione primeiro a Action que produz o Input/Output | + I/O precisa de uma Action selecionada. |
| Selecione uma Action para decompor, ou faça Shift-clique em várias para agrupá-las | Decompor precisa de uma Action (não de uma construção). |
| Não é possível agrupar: os elementos estão em ramos diferentes. Selecione elementos de uma mesma sequência. | Os elementos agrupados devem compartilhar uma sequência. |
| Não é possível agrupar: os elementos não são adjacentes. Selecione elementos que se seguem. | Os elementos agrupados devem ser contíguos. |
| Agrupado em uma nova Action filha. Dê um nome a ela no inspetor. | Decompor (agrupar) foi concluído. |
| Selecione uma Action com diagrama filho para achatar | Achatar precisa de uma Action com fluxo filho. |
| O diagrama filho está vazio. Adicione Actions a ele antes de achatar. | A Action filha não tem filhos. |
| Não é possível achatar: o fluxo de controle filho está malformado. | O fluxo filho se refere a entidades excluídas; abra-o para repará-lo. |
| Este grupo não pode ser achatado: um dos filhos dele já aparece neste nível. | Achatar colocaria uma Action duas vezes. |
| As iterações devem ser 1 ou mais. Digite um número inteiro de pelo menos 1. | Iterações abaixo de 1 são recusadas. |
| As probabilidades dos ramos somam N %. Altere-as para totalizar 100 %. | Corrija as probabilidades do OR. |
| "nome" agora executa as Actions deste ramo. | Um Executor foi definido. |
| Nenhuma Action aqui tem executor. Relacione Actions a Assets (performed by), ou solte um Executor em um ramo. | Gerar Diagrama de Asset não tem nada a posicionar. |
| Criado "nome performers" com N Asset(s) e M Conduit(s). | Gerar Diagrama de Asset foi concluído. |
| Arraste um elemento para cá ou clique em + Action | O fluxo está vazio. |
| Esta Action foi excluída. | A raiz foi excluída. |
| ✓ Checagens no selo de checagens do diagrama | As checagens não encontraram nada. |
| … não tem relacionamento com mais nada neste diagrama. … Conecte-o ou remova-o. | Uma constatação das checagens do diagrama (Órfãos e ciclos), com o motivo: O Input/Output "nome" não é gerado nem recebido por nenhuma Action neste diagrama., O Resource "nome" não é consumido, produzido nem retido por nenhuma Action neste diagrama. ou A Action "nome" não tem Duração (simula como 0). |
| A decomposição forma um ciclo: … Remova um destes relacionamentos decomposed by. | Uma Action é (indiretamente) filha de si mesma. |
| Somente visualização: peça acesso de edição a um proprietário. | A sua função neste projeto é Leitor. |
Limites
- Um fluxo por Action pai.
- Uma Action só pode aparecer uma vez em um fluxo. Use um LOOP para repeti-la.
- Adicionar ou encontrar… lista as primeiras 60 correspondências do projeto. Digite mais do nome para restringir.
- As probabilidades do OR são porcentagens inteiras de 0 a 100.
- As iterações do loop são números inteiros de pelo menos 1.
- As durações nunca são negativas na simulação: um valor negativo amostrado é sorteado de novo.
- A seleção por caixa seleciona apenas anotações. Use Shift-clique para os elementos do fluxo.
Páginas relacionadas
- Diagramas: o editor compartilhado, exportações e anotações.
- Análise funcional: funções, o FFBD e as tabelas dele.
- Simulação: execuções de Eventos discretos e de Monte Carlo, scripts e resultados.
- Diagramas SysML: os Diagramas de atividades e de sequência montados sobre as mesmas Actions.
- Outros diagramas: Diagramas de Asset, de linha do tempo, IDEF0 e N².
- Ajuda: Montar um Diagrama de Action, Diagrama de Action, Scripts de simulação.