Componentes padrão facilitam a criação, a personalização e a reutilização de diagramas consistentes de alta qualidade. Esse estilo profissional é usado para todos os modelos do Salesforce Diagram e está disponível em nossas ferramentas de parceiro para diagramar casos de uso:

Lucidograma Elementos Miro Google Slides

Encontre exemplos de como usar componentes na Galeria de arquitetura de referência

As seções a seguir apresentam as melhores práticas detalhadas para o Cabeçalho, Cartões, Ícones e Conectores incluídos nos Componentes padrão.

O Cabeçalho deve estar presente em todos os diagramas e incluir:

• Um título que pode ser rapidamente compreendido pelo seu público
• Uma descrição clara do que o diagrama abrange, seu propósito e intenção
• (opcional) seu logotipo ou nome da empresa para transmitir o autor
• (opcional) uma chave para esclarecer ícones, designs ou símbolos usados como classificações

O tamanho deve ocupar pelo menos 10% da altura do diagrama e 100% da largura.

O tamanho da fonte da descrição deve ser pelo menos metade do tamanho do título.

Uma chave deve ser incluída quando Ícones, conectores, cores etc. são usados que não são especificados com títulos no diagrama em si. A chave deve ser agrupada em linhas iguais quando possível.

Todas as propriedades do seu diagrama devem ser representadas com um cartão. Os cartões podem ser redimensionados e ter preenchimentos transparentes ou coloridos. Há várias seções do cartão que fornecem variações que você pode usar para representar diferentes conceitos no seu diagrama.

Um cartão de exemplo está abaixo, com as diferentes seções descritas. O único conteúdo necessário do Cartão é o Título. As outras seções estão disponíveis para uso conforme necessário para casos de uso específicos.

Ícone de cartão
Ícones de cartão são ativos visuais que representam a propriedade do cartão

Título do cartão
O título do cartão é um nome para o cartão que pode ser rapidamente compreendido, capturando qual propriedade, área ou conceito o cartão representa

Atributos do cartão
Atributos de cartão são detalhes baseados em texto sobre a propriedade, representados como uma lista e usados quando você precisa capturar e transmitir vários pontos de dados

Rodapé de cartão
O rodapé do cartão fornece características adicionais da propriedade. Os exemplos incluem: Nomes de API/Objeto/Pacote, Propriedade, Recursos etc.

Ícones de rodapé de cartão
A seção de ícones de rodapé é para ativos visuais exibirem informações adicionais sobre a propriedade. Exemplos incluem: canais, serviços compartilhados, recursos etc. Os ícones de rodapé devem ser incluídos/explicados na sua chave de diagrama.

A utilização de seções diferentes fornece variações de cartão diferentes para diferentes usos. Você pode combinar a anatomia do cartão conforme necessário para criar essas variações em seus diagramas. Veja exemplos abaixo:

Consulte a Galeria de arquitetura de referência para obter ideias sobre como usar essas variações.

Use a capacidade de ajustar o tamanho e a cor dos seus cartões conforme necessário para distinguir tipos e criar diagramas claros e compreensíveis.

Os cartões também podem atuar como contêineres, ou seja, agrupamentos para várias propriedades. Você pode aninhar cartões dentro de outro cartão para representar relacionamentos hierárquicos ou classificar propriedades relacionadas conforme necessário.

Os Diagramas do Salesforce fornecem um conjunto básico de Logotipos de produto do Salesforce, bem como ícones adicionais para representar propriedades e outras áreas no seu diagrama.

Você pode encontrar exemplos de como usar Ícones na Galeria de Arquitetura de Referência

Para mais ícones, consulte os ícones do Lightning Design System.

Os conectores devem sempre usar linhas de conexão de cotovelo e ser retos sempre que possível para maior legibilidade.

Os conectores representam uma relação, integração ou etapa de processo entre dois cartões. Os estilos de linha indicam um tipo diferente de conexão e devem ser representados em sua chave de diagrama. Os pontos de extremidade indicam a direção de um conector de processo ou integração. Os pontos de extremidade também indicam a cardinalidade e a ordinalidade em um conector de relacionamento.

As pílulas são usadas para fornecer detalhes sobre as conexões. Consulte os diagramas Arquitetura de soluções e Fluxo de processo de interação, por exemplo, usos de pílulas.

Em todo o mundo, cerca de 1,3 bilhões de pessoas vivem com alguma forma de deficiência, o que representa 15% da população mundial. Acessibilidade significa tornar seu diagrama compreensível para todos os seus visualizadores. Há duas áreas de foco específicas que podem ajudar seus diagramas a ficarem mais acessíveis: otimizar para leitores de tela e usar o contraste de cores adequado.

Você pode encontrar mais recursos sobre design para acessibilidade no blog Salesforce Design.

Leitor de tela
Um leitor de tela é um aplicativo de software que lê em voz alta as palavras em um arquivo, aplicativo ou site. Um leitor de tela pode ler diagramas para indivíduos que não conseguem vê-los claramente. O melhor formato para compatibilidade com o leitor de tela é PDF (Formato de documento portátil). Diferentemente de imagens e aplicativos inacessíveis, os PDFs podem ser acessados por leitores de tela para ler palavras, formas e cores. Exportar seus diagramas para o formato PDF ao compartilhar com outras pessoas pode aumentar a acessibilidade.

Contraste de cor
Aumentar o contraste de cores é outra maneira de ajudar seu diagrama a ficar mais acessível. As pessoas poderão reconhecer e ler melhor seus diagramas quando cumprirem o contraste de cores mínimo das Diretrizes de acessibilidade de conteúdo da Web (WCAG) de ter uma proporção de 4,5:1 entre a cor de segundo plano atrás do texto e a cor do próprio texto.

Cada cor no sistema de cores do Salesforce tem um número, entre 0 e 100, associado a ela. Ao escolher cores para seus diagramas, certifique-se de que a cor de segundo plano atrás do texto seja pelo menos 50 pontos maior ou menor que a cor do texto. Por exemplo, se a cor do segundo plano for 80, a cor do texto não deve ser maior que 30. Considere usar a regra de 50 pontos conforme necessário para bordas e esboços também.

Tem informações ou perguntas sobre o Salesforce Diagrams? Por favor, informe-nos seus pensamentos aqui.