Diagrama
Descripción
Editor integrado basado en diagrams.net para representar procesos, arquitecturas, redes y relaciones mediante nodos y conectores.
Casos de uso
- Crear diagramas de flujo, procesos y decisiones.
- Documentar arquitectura, redes o modelos de datos.
- Elaborar organigramas y mapas conceptuales.
- Compartir una representación visual editable y exportable.
Cómo crear el servicio
Selecciona Cloud > Nuevo elemento > Diagrama, indica nombre y carpeta y crea el servicio. Apification abre el editor integrado con un diagrama vacío. También puede importar archivos compatibles con diagrams.net cuando la acción esté disponible.
Interfaz y controles
La barra lateral contiene bibliotecas de formas; el canvas admite selección, texto, conectores, zoom y navegación. Las barras de herramientas gestionan estilo, alineación, distribución, capas, deshacer y rehacer. Guardar devuelve la definición XML a Apification; las opciones de exportación pertenecen al editor integrado.
Flujo de trabajo completo
- Define propósito, audiencia y dirección de lectura.
- Añade los nodos principales y asigna etiquetas claras.
- Conecta elementos y define dirección y tipo de relación.
- Alinea, distribuye y agrupa para reducir cruces.
- Aplica estilos consistentes y revisa el zoom general.
- Guarda la definición editable y exporta una copia visual.
Archivos o datos admitidos
El servicio almacena XML compatible con diagrams.net/draw.io y una representación SVG para previsualización cuando se genera. Puede importar XML o archivos reconocibles por el flujo implementado. Imágenes y bibliotecas externas dependen de la configuración del editor embebido.
Opciones de configuración
- Biblioteca de formas: selecciona familias de nodos para procesos, redes, UML u otros dominios. Activar solo las bibliotecas necesarias reduce ruido visual.
- Forma: define la geometría y semántica visual del nodo. Debe usarse de forma consistente, por ejemplo rombo para decisión.
- Texto y tipografía: configuran etiqueta, fuente, tamaño, color y alineación. Sirven para identificar elementos y jerarquías.
- Relleno, borde y opacidad: diferencian categorías o estados. El borde también controla grosor, estilo y color.
- Conector: une nodos y puede ser recto, ortogonal o curvo. Expresa relación o flujo y permanece vinculado al mover los extremos.
- Punta y dirección de flecha: indican sentido de la relación. Deben evitarse direcciones ambiguas.
- Etiqueta del conector: describe condición, acción o relación sobre la línea y ayuda a interpretar decisiones.
- Alineación y distribución: alinean bordes o centros y reparten espacios de varios objetos. Sirven para ordenar sin calcular posiciones manualmente.
- Orden visual: mueve objetos delante o detrás. Se utiliza cuando formas se superponen.
- Agrupación: trata varios elementos como una unidad para moverlos o redimensionarlos sin perder su disposición relativa.
- Capas: separan conjuntos que pueden bloquearse u ocultarse. Son útiles para versiones, anotaciones o niveles de una arquitectura.
- Páginas: dividen un archivo en varios diagramas relacionados cuando la versión integrada las admite.
- Cuadrícula, guías y ajuste: ayudan a colocar objetos con precisión. No forman parte de la exportación final salvo configuración específica.
- Zoom: cambia la escala de trabajo sin modificar dimensiones reales del diagrama.
- Tamaño, orientación y escala de página: determinan encuadre para impresión o exportación y evitan recortes.
- Formato de exportación: selecciona XML editable o una salida visual como PNG, JPEG, SVG o PDF y puede incluir fondo, escala o todo el diagrama.
Resultado y formatos de exportación
El resultado editable es el XML del diagrama. La previsualización usa SVG. El editor puede ofrecer formatos visuales como PNG, JPEG, SVG o PDF y XML de diagrams.net según su configuración; confirma el formato elegido antes de descargar.
Guardado, descarga y compartición
Guardar conserva XML y SVG y crea una versión previa cuando procede. Comparte o gestiona usuarios desde Cloud. Descarga el formato ofrecido por el editor o conserva el servicio para seguir editándolo. No cierres la ventana hasta recibir confirmación de guardado.
Límites y requisitos técnicos
El editor se carga desde la URL configurada en services.diagram.embed_url; necesita red, políticas de iframe y mensajes entre dominios correctos. Diagramas grandes aumentan memoria y tiempo de renderizado. Recursos externos pueden dejar de estar disponibles.
Errores frecuentes
- El editor no carga: revisa URL embebida, CSP, red y bloqueo de iframes.
- No se guarda: valida el intercambio de mensajes y que el XML sea correcto.
- La previsualización está vacía: guarda de nuevo para regenerar SVG.
- El exportado recorta contenido: ajusta página, escala y opción de incluir todo el diagrama.
Privacidad y tratamiento de datos
Si el editor embebido apunta a un servicio externo, el contenido puede procesarse fuera de Apification según su configuración. Para información sensible utiliza una instancia autorizada. Evita incluir credenciales, secretos o datos personales innecesarios en nodos y comentarios.
Preguntas frecuentes
- ¿Diagrama y Pizarra son iguales? No; Diagrama prioriza formas y conectores estructurados, Pizarra un estilo libre.
- ¿Puedo seguir editando un PNG exportado? No con la misma estructura; conserva el servicio o XML original.
- ¿Admite varias páginas? Depende de las funciones habilitadas en diagrams.net.
Servicios relacionados
Pizarra para bocetos libres, Image Studio para composiciones raster, Documento y Presentación para incorporar el resultado.