{"id":2128,"date":"2026-05-26T06:54:30","date_gmt":"2026-05-26T06:54:30","guid":{"rendered":"https:\/\/www.vpascode.com\/pt\/docs\/uncategorized\/plantuml-use-case-diagram-syntax-guide\/"},"modified":"2026-05-26T06:54:30","modified_gmt":"2026-05-26T06:54:30","slug":"plantuml-use-case-diagram-syntax-guide","status":"publish","type":"ld_docs","link":"https:\/\/www.vpascode.com\/pt\/docs\/vpascode-docs\/plantuml-use-case-diagram-syntax-guide\/","title":{"rendered":"Guia de Sintaxe de Diagrama de Caso de Uso do PlantUML"},"content":{"rendered":"

O que \u00e9 um Diagrama de Caso de Uso?<\/h2>\n

Um Diagrama de Caso de Uso<\/strong>\u00e9 um plano comportamental usado para visualizar as rela\u00e7\u00f5es entre os usu\u00e1rios de um sistema (conhecidos como atores) e as a\u00e7\u00f5es ou objetivos espec\u00edficos que eles desejam alcan\u00e7ar (conhecidos como casos de uso). Em vez de mostrar loops l\u00f3gicos passo a passo, um diagrama de caso de uso fornece uma vis\u00e3o geral de alto n\u00edvel do escopo funcional de um sistema, tornando-o uma excelente ferramenta para definir requisitos do projeto, limites do sistema e fluxos de trabalho dos interessados.<\/p>\n

Com VPasCode<\/strong>, voc\u00ea pode criar instantaneamente diagramas de caso de uso claros e profissionais sem lutar contra o alinhamento visual da tela. Este guia ignora as nota\u00e7\u00f5es obscuras e legadas e se concentra exclusivamente nos elementos de sintaxe pr\u00e1ticos que voc\u00ea precisa para documenta\u00e7\u00e3o di\u00e1ria de software.<\/p>\n

Guia de Sintaxe B\u00e1sica: Elementos e Constru\u00e7\u00f5es<\/h2>\n

Construir um diagrama de caso de uso no PlantUML depende de alguns elementos estruturais simples, envoltos nos seus padr\u00f5es @startuml<\/code> e @enduml<\/code> tags.<\/p>\n

1. Declarando Atores<\/h3>\n

Um ator representa uma entidade externa que interage com seu aplicativo (como um usu\u00e1rio humano, um servi\u00e7o em segundo plano ou uma API de hardware externa). Voc\u00ea declara um ator usando a palavra-chave actor<\/code> seguida por um ID de atalho interno:<\/p>\n

\n
\nPlantuml<\/span>
\n
\n<\/path><\/path><\/svg>
\nEditar Plantuml no VPasCode<\/span>
\n<\/a>\n<\/div>\n
\n
\r\n
\r\n Plantuml<\/span>\r\n \r\n <\/path><\/path><\/svg>\r\n Edit Plantuml in VPasCode<\/span>\r\n <\/a>\r\n <\/div>\r\n
\r\n 
actor customer\r\nactor admin como \"Administrador do Sistema\"<\/code><\/pre>                <\/div>\r\n                
\r\n                    \r\n                        <\/path><\/path><\/svg>\r\n                        Edit Plantuml in VPasCode<\/span>\r\n                    <\/a>\r\n                <\/div>\r\n            <\/div>\r\n            \n<\/p><\/div>\n
\n
\n<\/path><\/path><\/svg>
\nEditar Plantuml no VPasCode<\/span>
\n<\/a>\n<\/div>\n<\/div>\n
\"\"<\/p>\n
Dica Profissional:<\/em> Use a palavra-chave como<\/code> para atribuir uma string de exibi\u00e7\u00e3o limpa e leg\u00edvel por humanos a IDs de atores complexos.<\/p>\n
2. Definindo Casos de Uso<\/h3>\n
Um caso de uso representa um objetivo funcional ou um processo de neg\u00f3cios. Voc\u00ea pode definir um caso de uso de duas maneiras: envolvendo o texto entre par\u00eanteses (Seu Caso de Uso)<\/code>, ou usando explicitamente a caso de uso<\/code>palavra-chave para formata\u00e7\u00e3o complexa:<\/p>\n
\n
\nPlantuml<\/span>
\n
\n<\/path><\/path><\/svg>
\nEditar Plantuml no VPasCode<\/span>
\n<\/a>\n<\/div>\n
\n            
\r\n                                
\r\n                    Plantuml<\/span>\r\n                    \r\n                        <\/path><\/path><\/svg>\r\n                        Edit Plantuml in VPasCode<\/span>\r\n                    <\/a>\r\n                <\/div>\r\n                                
\r\n                    
(Entrar no Painel)\r\ncaso de uso checkout como \"Processar Pagamento com Cart\u00e3o de Cr\u00e9dito\"<\/code><\/pre>                <\/div>\r\n                
\r\n                    \r\n                        <\/path><\/path><\/svg>\r\n                        Edit Plantuml in VPasCode<\/span>\r\n                    <\/a>\r\n                <\/div>\r\n            <\/div>\r\n            \n<\/p><\/div>\n
\n
\n<\/path><\/path><\/svg>
\nEditar Plantuml no VPasCode<\/span>
\n<\/a>\n<\/div>\n<\/div>\n
\"\"<\/p>\n
3. Mapeando Intera\u00e7\u00f5es B\u00e1sicas<\/h3>\n
Para conectar seus atores aos seus casos de uso correspondentes, use linhas de relacionamento b\u00e1sicas direcionadas ou n\u00e3o direcionadas. Tamb\u00e9m \u00e9 poss\u00edvel anexar r\u00f3tulos textuais para adicionar contexto cr\u00edtico a uma intera\u00e7\u00e3o:<\/p>\n
\n
\nPlantuml<\/span>
\n
\n<\/path><\/path><\/svg>
\nEditar Plantuml no VPasCode<\/span>
\n<\/a>\n<\/div>\n
\n            
\r\n                                
\r\n                    Plantuml<\/span>\r\n                    \r\n                        <\/path><\/path><\/svg>\r\n                        Edit Plantuml in VPasCode<\/span>\r\n                    <\/a>\r\n                <\/div>\r\n                                
\r\n                    
cliente --> (Entrar no Painel)\r\nadministrador --> checkout : \"Aprova reembolsos\"<\/code><\/pre>                <\/div>\r\n                
\r\n                    \r\n                        <\/path><\/path><\/svg>\r\n                        Edit Plantuml in VPasCode<\/span>\r\n                    <\/a>\r\n                <\/div>\r\n            <\/div>\r\n            \n<\/p><\/div>\n
\n
\n<\/path><\/path><\/svg>
\nEditar Plantuml no VPasCode<\/span>
\n<\/a>\n<\/div>\n<\/div>\n
\"\"<\/p>\n
4. Relacionamentos Avan\u00e7ados: Incluir e Estender<\/h3>\n
Ao modelar comportamentos de sistemas complexos, voc\u00ea frequentemente precisa mostrar depend\u00eancias entre diferentes casos de uso usando estere\u00f3tipos padr\u00e3o UML:<\/p>\n