Los diagramas son una herramienta esencial y una parte clave del trabajo arquitectónico. Nos permiten comunicar muchas ideas diferentes a muchos tipos diferentes de partes interesadas.

Los diagramas ayudan a los equipos de entrega a permanecer alineados, sirviendo como una única fuente de verdad sobre las realidades de implementaciones y productos. Los diagramas también son una forma crítica de empoderar a las partes interesadas de negocio para que tomen las decisiones de compra y tecnología correctas.

Los diagramas siempre deben:

• Leer de izquierda a derecha y de arriba a abajo, lo más cerca posible
• Transmitir un mensaje de forma concisa, con un ámbito de información apropiado para la capacidad de lectura
• Utilizar componentes estándar de diagramas de Salesforce, incluyendo tarjetas y un encabezado con una descripción clara que describe el contenido, el ámbito y el propósito del diagrama

El ámbito de un diagrama debe limitarse únicamente a la información crítica que transmitir para un tema específico. Cualquier cosa que no sea necesaria para capturar el mensaje que pretende comunicar debe excluirse. Se pueden (y se deben) crear múltiples diagramas para capturar conceptos variables, con el fin de comunicar y restringir más claramente el enfoque del contenido del diagrama.

• Definir la información/mensaje crítico que necesita transmitir a su audiencia
• Clasificar ámbito(s) lógico(s) con el fin de centrar la información para capturar el mensaje
• Identificar los tipos de diagrama más apropiados para utilizar como plantillas

Diagramas de Salesforce definió nuestros tipos de diagramas más útiles/populares para ayudarle a utilizar plantillas fácilmente y comprender convenciones de diagramas. Nuestros recursos actuales se clasifican como:

• Capturar la combinación de propiedades y funciones clave relevantes incluidas en una solución
• Centrarse en funciones, controladores de negocio y valores

✨ Buscar mapas de funciones en la Galería de arquitectura de referencia

• Capturar los productos y/o sistemas técnicos implicados en una implementación concreta
• Centrarse en las propiedades, los aspectos de propiedades específicos y las conexiones entre propiedades

✨ Encontrar ejemplos y plantillas de Panorama del sistema en la Galería de arquitectura de referencia

• Incluir productos o tecnologías con integración, comportamiento y/o funcionalidad
• Centrarse en las conexiones detalladas y/o aspectos de comunicación entre propiedades

✨ Encontrar ejemplos y plantillas de Arquitectura de soluciones en la Galería de arquitectura de referencia

• Capturar pasos basados en tiempo, flujos de datos o interacciones requeridos para dar cobertura a un proceso
• Centrarse en y aclarar (con numeración secuenciada) el orden de aspectos/propiedades

✨ Buscar ejemplos y plantillas de diagramas de interacción, proceso y flujo en la Galería de arquitectura de referencia

• Capturar entidades (objetos), relaciones y conceptos para implementaciones de metadatos

✨ Encontrar ejemplos y plantillas de modelos de datos en la Galería de modelos de datos

Consulte ejemplos de los tipos de diagramas en la Galería de arquitectura de referencia o nuestra Galería de modelos de datos exclusiva. Utilice una plantilla para crear rápidamente/fácilmente un diagrama para su caso de uso.

• Defina el ámbito del mensaje que necesita transmitir:

  • Piense en su audiencia, qué propiedades/aspectos necesita representar, qué información es necesaria para capturar el mensaje y qué se puede excluir

• Asegúrese de que existe un Encabezado con un Título claro y una Descripción concisa y cuidadosamente redactada que captura el propósito, el ámbito y el mensaje de su diagrama

• Utilice Tarjetas para capturar las propiedades (sistemas, conceptos, entidades, etc.)

• Capturar detalles de propiedad o aspectos clave/capacidades según sea necesario en Atributos de tarjeta

• Representar relaciones según sea necesario con Conectores entre sus propiedades de tarjeta

• Incorporar iconos de tarjeta cuando sea útil, esté disponible o apropiado

• Utilizar pies de página e iconos de pie de página para capturar cualquier otro aspecto de propiedad clave

de página

Consulte la página Componentes estándar para obtener más detalles y mejores prácticas.

¿Tiene Salesforce Diagrams entrada o preguntas? Por favor, háganos saber sus opiniones aquí.