Diagrama

Descrição

Editor integrado do diagrams.net para representar processos, arquiteturas, redes e relações com nós e conectores.

Casos de uso

• Criar fluxogramas, processos e diagramas de decisão.
• Documentar arquitetura, redes ou modelos de dados.
• Construir organogramas e mapas conceituais.
• Partilhar uma representação visual editável e exportável.

Como criar o serviço

Selecione Cloud > New item > Diagram, introduza um nome e pasta, e crie o serviço. O Apification abre o editor integrado com um diagrama vazio. Ficheiros compatíveis do diagrams.net também podem ser importados onde a ação esteja disponível.

Interface e controlo

A barra lateral contém bibliotecas de formas e o canvas suporta seleção, texto, conectores, zoom e navegação. As barras de ferramentas gerem estilo, alinhamento, distribuição, camadas, desfazer e refazer. Guardar devolve XML ao Apification; as opções de exportação pertencem ao editor incorporado.

Fluxo completo

1. Definir propósito, público e direção de leitura.
2. Adicionar nós principais e rótulos claros.
3. Conectar elementos e definir a direção e tipo da relação.
4. Alinhar, distribuir e agrupar para reduzir cruzamentos.
5. Aplicar estilos consistentes e rever o diagrama completo.
6. Guardar a definição editável e exportar uma cópia visual.

Ficheiros ou dados suportados

O serviço armazena XML compatível com diagrams.net/draw.io e um pré‑visualização SVG quando gerado. Pode importar XML ou ficheiros reconhecidos pelo fluxo implementado. Imagens externas e bibliotecas dependem das definições do editor incorporado.

Opções de configuração

As opções incluem formas, texto, conectores, setas, cor, borda, preenchimento, tipografia, alinhamento, distribuição, grupos, camadas, páginas, grelha, zoom e definições de página. Os controlos exatos podem variar com a versão do diagrams.net configurada.

Formatos de saída e exportação

O resultado editável é XML de diagrama e o pré‑visualização utiliza SVG. O editor pode oferecer PNG, JPEG, SVG, PDF e XML do diagrams.net dependendo da configuração; verifique o formato seleccionado antes de descarregar.

Guardar, descarregar e partilhar

Guardar mantém XML e SVG e cria uma versão anterior quando aplicável. Partilhe ou gere utilizadores a partir de Cloud. Descarregue um formato fornecido pelo editor ou mantenha o serviço para edição posterior. Não feche até que a gravação seja confirmada.

Limites e requisitos técnicos

O editor carrega a partir de services.diagram.embed_url e requer acesso à rede, políticas iframe compatíveis e mensagens cross‑domain. Diagramas grandes aumentam memória e tempo de renderização. Ativos externos podem tornar‑se indisponíveis posteriormente.

Erros comuns

• O editor não carrega: verifique URL embed, CSP, rede e bloqueio de iframe.
• Falha ao guardar: valide a mensagem e XML.
• Pré‑visualização em branco: guarde novamente para regenerar SVG.
• Exportação cortada: ajuste página, escala e definições incluir‑todo‑diagrama.

Privacidade e processamento de dados

Se o URL embed apontar para um serviço externo, o conteúdo pode ser processado fora do Apification. Use uma instância autorizada para informações sensíveis. Evite credenciais, segredos ou dados pessoais desnecessários em nós e comentários.

Perguntas frequentes

• Diagram e Whiteboard são iguais? Não; Diagram enfatiza formas estruturadas e conectores, enquanto Whiteboard suporta desenho livre.
• Um PNG exportado permanece editável estruturalmente? Não, mantenha o serviço ou XML original.
• São suportadas múltiplas páginas? Depende das funcionalidades do diagrams.net activadas.

Serviços relacionados

Whiteboard, Image Studio, Document e Presentation.