Pergunte a três pessoas como um pedido percorre a sua empresa e você pode receber três respostas. Uma diz que a fatura sai antes da embalagem, outra que sai depois do envio, e ninguém sabe o que acontece quando um item está sem estoque. Um fluxograma no quadro branco ajuda até que duas coisas aconteçam ao mesmo tempo e as setas sugiram uma ordem que não existe.
Um diagrama de atividade UML foi feito para isso: etapas, decisões, trabalho em paralelo e quem faz cada parte. Este artigo constrói um exemplo de processamento de pedidos peça por peça, com um guia de símbolos, as regras de tokens por trás dele, erros comuns e uma comparação dos diagramas de atividade com fluxogramas, BPMN e diagramas de estados.
O que um diagrama de atividade mostra
Um diagrama de atividade mostra um comportamento como ações conectadas por fluxos. As regras vêm da especificação UML 2.5.1, publicada pelo Object Management Group (OMG) em dezembro de 2017 e ainda a versão formal vigente no momento da escrita (novembro de 2026). O capítulo 15 (Activities) e o capítulo 16 (Actions) definem a notação.
Use um quando a pergunta for a ordem do trabalho: um processo de negócio que atravessa equipes, o cenário por trás de um caso de uso ou um pipeline com ramificações e etapas paralelas. Use uma máquina de estados quando a pergunta for em que estado um pedido está, um diagrama de sequência quando for qual serviço chama qual, e um diagrama de classes quando for como os dados se estruturam.
Símbolos do diagrama de atividade
A UML reaproveita duas formas para quatro nós de controle: decisão e merge são losangos, e fork e join são barras. Conte os fluxos de entrada e de saída para distingui-los.
| Símbolo | Aparência | O que significa |
|---|---|---|
| Nó inicial | Pequeno círculo preenchido | Onde o fluxo começa |
| Ação | Retângulo arredondado com uma locução verbal | Uma etapa de trabalho |
| Fluxo de controle | Seta, opcionalmente com uma [guarda] | Ordem de execução |
| Nó de decisão | Losango, um fluxo de entrada, vários de saída | Envia cada token por um único caminho, escolhido pelas guardas |
| Nó merge | Losango, vários fluxos de entrada, um de saída | Combina caminhos alternativos sem esperar |
| Nó fork | Barra, um fluxo de entrada, vários de saída | Inicia todos os fluxos de saída de forma concorrente |
| Nó join | Barra, vários fluxos de entrada, um de saída | Espera por todos os fluxos de entrada e depois continua |
| Fim de atividade | Alvo: círculo preenchido dentro de um anel | Encerra a atividade inteira |
| Fim de fluxo | Círculo com um X | Encerra apenas o fluxo que chega até ele |
| Nó de objeto | Retângulo com um substantivo, ou um pino numa ação | Dados passados entre ações |
| Partição | Raia nomeada em uma ponta | Agrupa as ações de um participante |
Na especificação, fork e join são «simplesmente um segmento de linha»; as ferramentas o engrossam até virar uma barra. A especificação também observa que as partições são «coloquialmente conhecidas como» raias (swimlanes).
Como os tokens se movem pelo diagrama
A UML define esses símbolos com tokens, como peças num tabuleiro. Quando a atividade começa, um token de controle fica no nó inicial. Uma ação roda quando cada fluxo de entrada lhe oferece um token e, em seguida, oferece um token em cada fluxo de saída. Uma decisão envia cada token por no máximo um fluxo de saída, aquele cuja guarda é verdadeira; um merge repassa cada token diretamente; um fork copia o token para todos os fluxos de saída; um join espera até que cada fluxo de entrada ofereça um token e então emite um. O primeiro token que chega a um nó de fim de atividade encerra a atividade, inclusive tudo o que ainda estiver rodando.
Duas consequências surpreendem quem aprendeu primeiro os fluxogramas:
- Duas setas entrando numa ação significam esperar pelas duas, um join implícito. Se as setas vêm dos dois ramos de uma decisão, só uma carrega um token e a ação nunca começa. Caminhos alternativos precisam se encontrar antes num merge.
- Duas setas saindo de uma ação significam fazer as duas, um fork implícito. É válido, mas os leitores deixam passar; desenhe uma barra fork no lugar.
Construindo o exemplo passo a passo
- Desenhe as partições primeiro: Customer, Warehouse e Billing. As raias forçam as perguntas sobre responsabilidade logo no início.
- Inicie o fluxo. Um nó inicial na raia Customer leva a Place order.
- Adicione a decisão. Na raia Warehouse, uma decisão verifica o estoque, com as guardas [in stock] e [out of stock]. As guardas devem se excluir mutuamente e cobrir todos os casos; a guarda predefinida [else] da UML pega o resto.
- Faça o merge dos caminhos. Os pedidos sem estoque passam por Backorder items, e então os dois caminhos se encontram num merge. O merge é obrigatório: um fork aceita exatamente um fluxo de entrada, e uma ação com dois fluxos de entrada esperaria pelos dois.
- Faça o fork do trabalho em paralelo. Uma barra fork inicia Pack items (Warehouse) e Create invoice (Billing). Concorrente significa que nenhum espera pelo outro, não que rodem no mesmo instante.
- Faça o join antes do envio. Uma barra join espera até que ambos terminem; só então Ship order roda.
- Encerre a atividade. Um nó de fim de atividade vem depois de Ship order. Nós de controle não são trabalho, então podem ficar em qualquer raia; este fica na raia Customer, logo acima de Ship order.
No PlantUML, o mesmo fluxo é texto simples: |Customer| para as raias, if, else e endif para as decisões, e fork, fork again e end fork para o trabalho em paralelo. O layout é automático, então você troca controle por velocidade.
Erros comuns
| Erro | O que dá errado | Correção |
|---|---|---|
| Um fork sem join | O primeiro ramo a chegar ao fim de atividade encerra a atividade e interrompe o outro | Fazer o join dos ramos, ou encerrar cada um com um fim de fluxo |
| Uma decisão para trabalho em paralelo | Apenas um ramo é executado | Usar uma barra fork |
| Um merge onde é preciso um join | A próxima ação pode rodar duas vezes, uma por token | Usar uma barra join |
| Um join depois de uma decisão | Só um ramo carrega um token, então o join espera para sempre | Usar um losango merge |
| Guardas sem rótulo ou sobrepostas | Os leitores adivinham; a UML deixa indefinida a ordem de avaliação das guardas | Guardas que se excluam mutuamente, mais [else] |
| Nomes de ação vagos | Processamento não diz nada sobre o trabalho | Um verbo e um objeto: Pack items |
A terceira e a quarta linhas são imagens espelhadas: um merge nunca espera, e um join pode esperar para sempre. Antes de compartilhar um diagrama, acompanhe um token por todos os ramos.
Diagramas de atividade, fluxogramas, BPMN e diagramas de estados
| Diagrama de atividade | Fluxograma | BPMN | Diagrama de máquina de estados | |
|---|---|---|---|---|
| Mostra | Etapas de um comportamento, com dados e trabalho em paralelo | Etapas e decisões | Processos entre participantes, com eventos e mensagens | Os estados de um objeto e os eventos que os alteram |
| Trabalho em paralelo | Barras fork e join | Sem símbolo no conjunto usual | Gateway paralelo | Regiões ortogonais |
| Quem faz o quê | Partições (raias) | Raias em fluxogramas multifuncionais | Pools e lanes | Não mostrado |
| Padrão | UML 2.5.1 (OMG) | ISO 5807 (1985), seguido de forma frouxa | BPMN 2.0.2 (OMG) | UML 2.5.1 (OMG) |
| Melhor para | Comportamento de software, fluxos de casos de uso, pipelines | Esboços rápidos para qualquer público | Automação de processos, fluxos entre organizações | Ciclos de vida de pedidos ou assinaturas |
Os diagramas de atividade e o BPMN são primos: ambos definem o comportamento com tokens, e o BPMN 2.0.2 também especifica a semântica de execução para engines de processo. Escolha BPMN para processos executáveis e mensagens entre organizações (veja o exemplo de diagrama BPMN), uma máquina de estados para o ciclo de vida de um objeto (veja o exemplo de diagrama de estados), um fluxograma para leitores que nunca vão aprender UML, e um diagrama de atividade quando o trabalho em paralelo e a precisão do significado importam.
O diagrama de atividade do processamento de pedidos
Conteúdo do diagrama
- Customer
- Warehouse
- Billing
- Place order
- In stock?
- Backorder items
- Pack items
- Ship order
- Create invoice
- [in stock]
- [out of stock]
Como ler:
- Três raias: Customer, Warehouse e Billing, cada uma com as suas próprias ações.
- Comece no círculo preenchido: o cliente faz o pedido e o fluxo desce para a raia Warehouse.
- A decisão In stock? tem duas saídas com guarda: [in stock] vai até o merge, [out of stock] faz um desvio por Backorder items, em laranja. As marcas Y e N são os marcadores de saída embutidos do editor; as guardas carregam o significado UML.
- O losango pequeno é o merge onde os dois caminhos se reúnem.
- A primeira barra é o fork que inicia Pack items e Create invoice; a segunda é o join que faz Ship order esperar pelos dois.
- O alvo acima de Ship order encerra a atividade, e a tabela abaixo das raias repete a regra de token de cada nó de controle.
Desenhando diagramas de atividade com clareza
- Escolha uma direção. Raias horizontais com fluxo da esquerda para a direita combinam com páginas largas; raias verticais com fluxo para baixo combinam com processos longos.
- Nomeie as ações com um verbo e um objeto: Pack items, Create invoice. Uma ação que precisa de um parágrafo é uma subatividade; desenhe-a como uma ação de chamada de comportamento, marcada com o pequeno símbolo de ancinho da UML, e detalhe-a em seu próprio diagrama.
- Ponha as guardas nos fluxos. Uma pergunta dentro do losango ajuda os leitores, mas as guardas entre colchetes carregam o significado.
- Desenhe todo merge e todo join. Joins e forks implícitos são válidos, mas invisíveis.
- Mantenha poucas raias. De três a cinco continuam legíveis; com oito, divida o processo.
- Deixe de fora o que não muda o fluxo, como logging ou retentativas dentro de uma etapa, e adicione nós de objeto apenas quando os dados importarem.
Para raias sem o resto da UML, veja o exemplo de diagrama de raias.
Monte no Archboard
- Entre com Google ou GitHub e crie um diagrama.
- Adicione três nós Moldura do pacote Básico como raias horizontais: Customer, Warehouse e Billing.
- Adicione uma Elipse pequena do pacote Básico com preenchimento escuro como nó inicial.
- Adicione cinco nós Processo do pacote Fluxograma nas suas raias: Place order, Backorder items, Pack items, Create invoice e Ship order.
- Adicione um nó Decisão do pacote Fluxograma com o rótulo In stock?, e um Losango pequeno do pacote Básico para o merge. Rotule as saídas [in stock] e [out of stock].
- Para o fork e o join, adicione dois nós Quadrado finos e altos do pacote Básico com preenchimento escuro.
- Para o fim de atividade, adicione um Ícone do pacote Básico com o ícone record-circle-outline, um ponto dentro de um anel.
- Conecte os nós e depois adicione duas anotações Texto do Básico e um bloco Markdown do pacote Básico com a tabela da legenda.
Se o fluxo existir como fluxograma do Mermaid, a ferramenta de Mermaid para diagrama dá a você um primeiro rascunho editável para refinar com esses nós. Para um fluxograma simples com raias, comece pelo criador de fluxogramas.
O exemplo usa 15 nós de diagrama e fica dentro do plano Free.
Perguntas frequentes
O que é um diagrama de atividade em UML? Um diagrama de comportamento que mostra um processo como ações conectadas por fluxos, com decisões, fork e join para trabalho em paralelo e raias para indicar quem faz o quê. A UML 2.5.1 o define no capítulo 15.
Qual é a diferença entre um fork e uma decisão? Uma decisão envia cada token por apenas um fluxo de saída, escolhido pelas guardas. Um fork envia uma cópia por cada fluxo de saída, de modo que os ramos rodam de forma concorrente. Decisões são losangos; forks são barras.
Qual é a diferença entre um fim de atividade e um fim de fluxo? Um fim de atividade, um alvo, encerra a atividade inteira e todos os fluxos dentro dela. Um fim de fluxo, um círculo com um X, encerra apenas o fluxo que chega até ele.
Como as raias funcionam em um diagrama de atividade? Raias são partições de atividade da UML. Cada raia agrupa as ações de uma pessoa, equipe ou sistema; os fluxos cruzam as raias livremente, e as raias não mudam a forma como os tokens se movem.
Um diagrama de atividade é a mesma coisa que um fluxograma? Não, embora pareçam semelhantes. Os diagramas de atividade acrescentam fork e join, nós de objeto para dados, partições e regras de token que dão a cada símbolo um significado preciso.