Les diagrammes sont un outil essentiel et un élément clé du travail architectural. Ils nous permettent de communiquer de nombreuses idées différentes à de nombreux types de parties prenantes.

Les diagrammes aident les équipes de livraison à rester alignées, en servant de source unique de vérité sur les réalités des implémentations et des produits. Les diagrammes sont également essentiels pour permettre aux parties prenantes de prendre les bonnes décisions en matière d'achat et de technologie.

Les diagrammes doivent toujours :

• Lire de gauche à droite et de haut en bas, le plus près possible
• Transmettez un message concis, avec un éventail d'informations approprié pour faciliter la lecture
• Utiliser les composants standard Salesforce Diagrams, y compris des cartes et un en-tête avec une description claire décrivant le contenu, la portée et l'objet du diagramme

La portée d'un diagramme doit se limiter aux informations critiques à transmettre pour un sujet spécifique. Tout élément qui n'est pas nécessaire pour capturer le message que vous souhaitez communiquer doit être exclu. Plusieurs diagrammes peuvent (et doivent) être créés pour capturer divers concepts, afin de communiquer plus clairement et d'affiner le contenu du diagramme.

• Définir les informations/messages critiques que vous devez transmettre à votre audience
• Classer les étendues logiques afin de concentrer les informations pour capturer le message
• Identifier le ou les types de diagramme les plus appropriés à utiliser en tant que modèles

Salesforce Diagrams a défini nos types de diagramme les plus utiles/populaires afin de vous aider à utiliser des modèles et à comprendre les conventions de diagramme. Nos ressources actuelles sont classées comme suit :

• Capturer la combinaison de propriétés et les capacités clés pertinentes incluses dans une solution
• Mettre l'accent sur les fonctionnalités, les moteurs métiers et les valeurs

✨ Recherche de cartes de capacité dans la galerie d'architecture de référence

• Capturer les produits et/ou les systèmes techniques impliqués dans une implémentation donnée
• Mettre en évidence les propriétés, les aspects spécifiques des propriétés et les connexions entre les propriétés

✨ Recherchez des exemples et des modèles de paysage système dans la galerie Architecture de référence

• Inclure des produits ou des technologies avec une intégration, un comportement et/ou des fonctionnalités
• Mettre l'accent sur les connexions détaillées et/ou les aspects de communication entre les propriétés

✨ Retrouvez des exemples et des modèles d’architecture de solution dans la galerie Architecture de référence

• Capturer les étapes temporelles, les flux de données ou les interactions requis pour prendre en charge un processus
• Mettre en évidence et clarifier (avec la numérotation séquencée) l'ordre des aspects/propriétés

✨ Retrouvez des exemples et des modèles de diagrammes d'interaction, de processus et de flux dans la galerie Architecture de référence

• Capturer des entités (objets), des relations et des concepts pour des implémentations de métadonnées

✨ Recherchez des exemples et des modèles de modèle de données dans la Galerie de modèles de données

Consultez des exemples de types de diagramme dans la galerie d'architecture de référence ou dans notre galerie de modèles de données dédiée. Utilisez un modèle pour créer rapidement et aisément un diagramme adapté à votre cas d'utilisation.

• Définissez la portée du message que vous devez transmettre :

  • Pensez à votre audience, aux propriétés/aspects que vous devez représenter, aux informations nécessaires pour capturer le message et à ce qui peut être exclu

• Assurez-vous qu'il y a un en-tête avec un titre clair et une description concise et réfléchie qui capture l'objet, la portée et le message de votre diagramme

• Utilisez des cartes pour capturer les propriétés (systèmes, concepts, entités, etc.)

• Capturer les détails des propriétés ou les principaux aspects / capacités si nécessaire dans les attributs Carte

• Représenter les relations nécessaires avec les connecteurs entre les propriétés de votre carte

• Incorporer des icônes de carte lorsque cela est utile, disponible et/ou approprié

• Utiliser les pieds de page et les icônes de pied de page pour capturer d'autres aspects clés des propriétés

de page

Pour plus d'informations et les meilleures pratiques, consultez la page Composants standard.

Vous avez une entrée ou des questions sur les diagrammes Salesforce ? S'il vous plaît faites-nous part de vos pensées ici.