Use metadados para gerar diagramas de entidades
Publicado: novembro de 2016
Aplicável a: Dynamics CRM 2015
Uma representação visual dos metadados pode ser muito útil, principalmente ao tentar descrever o relacionamento entre as entidades do sistema. É possível usar o código de exemplo do Diagrama de Metadados fornecido para o Atualização do Microsoft Dynamics CRM 2015 e Microsoft Dynamics CRM Online 2015 para gerar diagramas de relacionamento entre entidades. É possível criar um diagrama simples que mostra um relacionamento somente para uma entidade ou um diagrama complexo que abrange várias entidades relacionadas, incluindo entidades do sistema e personalizadas.
Faça o download de um conjunto completo de diagramas de relacionamento entre entidades para o CRM 2015: Diagramas de relacionamento entre entidades do CRM 2015
Neste tópico
Relacionamentos nos diagramas de entidades
Sobre os diagramas
Gerar diagramas de entidades com a ferramenta Diagrama de Metadados
Relacionamentos nos diagramas de entidades
O exemplo a seguir mostra duas novas entidades personalizadas criadas no Microsoft Dynamics 365. A primeira entidade representa uma conta bancária e a segunda representa um cofre de segurança para depósitos. O diagrama de entidades a seguir foi gerado com a ferramenta Diagrama de Metadados. Ele mostra o relacionamento entre a entidade new_bankaccount, a entidade new_safedepositbox e outras entidades do sistema. Os nomes mostrados são os nomes lógicos da entidade. Observe que se houver vários relacionamentos entre as duas entidades idênticas, somente uma linha é desenhada no diagrama por questões de simplicidade.
.jpeg "Diagrama de relacionamentos de entidade para entidades personalizadas")
A tabela a seguir mostra o relacionamento de uma entidade em relação a várias, onde a entidade principal é uma conta bancária ou um cofre de segurança para depósitos.
Nome do esquema do relacionamento |
Entidade de referência |
|---|---|
new_bankaccount_ActivityPointers |
activitypointer |
new_bankaccount_Appointments |
compromisso |
new_bankaccount_Emails |
|
new_bankaccount_Faxes |
fax |
new_bankaccount_Letters |
letter |
new_bankaccount_PhoneCalls |
phonecall |
new_bankaccount_ServiceAppointments |
serviceappointment |
new_bankaccount_Tasks |
tarefa |
new_bankaccount_RecurringAppointmentMasters |
recurringappointmentmaster |
new_bankaccount_DuplicateMatchingRecord |
duplicaterecord |
new_bankaccount_DuplicateBaseRecord |
duplicaterecord |
new_bankaccount_Annotations |
anotação |
new_bankaccount_AsyncOperations |
asyncoperation |
new_bankaccount_UserEntityInstanceDatas |
userentityinstancedata |
new_bankaccount_ProcessSession |
processsession |
new_bankaccount_BulkDeleteFailures |
bulkdeletefailure |
new_bankaccount_PrincipalObjectAttributeAccesses |
principalobjectattributeaccess |
new_new_bankaccount_new_safedepositbox |
new_safedepositbox |
new_safedepositbox_ActivityPointers |
activitypointer |
new_safedepositbox_Appointments |
compromisso |
new_safedepositbox_Emails |
|
new_safedepositbox_Faxes |
fax |
new_safedepositbox_Letters |
letter |
new_safedepositbox_PhoneCalls |
phonecall |
new_safedepositbox_ServiceAppointments |
serviceappointment |
new_safedepositbox_Tasks |
tarefa |
new_safedepositbox_RecurringAppointmentMasters |
recurringappointmentmaster |
new_safedepositbox_DuplicateMatchingRecord |
duplicaterecord |
new_safedepositbox_DuplicateBaseRecord |
duplicaterecord |
new_safedepositbox_Annotations |
anotação |
new_safedepositbox_AsyncOperations |
asyncoperation |
new_safedepositbox_UserEntityInstanceDatas |
userentityinstancedata |
new_safedepositbox_ProcessSession |
processsession |
new_safedepositbox_BulkDeleteFailures |
bulkdeletefailure |
new_safedepositbox_PrincipalObjectAttributeAccesses |
principalobjectattributeaccess |
A tabela a seguir mostra o relacionamento de várias entidades em relação a uma, onde a entidade principal é uma conta bancária ou um cofre de segurança para depósitos.
Nome do esquema do relacionamento |
Entidade de referência |
|---|---|
lk_new_bankaccount_createdby |
systemuser |
lk_new_bankaccount_createdonbehalfby |
systemuser |
lk_new_bankaccount_modifiedby |
systemuser |
lk_new_bankaccount_modifiedonbehalfby |
systemuser |
user_new_bankaccount |
systemuser |
team_new_bankaccount |
equipe |
owner_new_bankaccount |
proprietário |
business_unit_new_bankaccount |
businessunit |
new_account_new_bankaccount |
conta |
lk_new_safedepositbox_createdby |
systemuser |
lk_new_safedepositbox_createdonbehalfby |
systemuser |
lk_new_safedepositbox_modifiedby |
systemuser |
lk_new_safedepositbox_modifiedonbehalfby |
systemuser |
user_new_safedepositbox |
systemuser |
team_new_safedepositbox |
equipe |
owner_new_safedepositbox |
proprietário |
business_unit_new_safedepositbox |
businessunit |
new_new_bankaccount_new_safedepositbox |
new_bankaccount |
A entidade da conta que é exibida no diagrama representa um cliente do banco. Como cliente de um banco, é possível abrir várias contas bancárias, como contas-corrente e poupança, além de vários cofre de segurança para depósitos. Este é um exemplo de um tipo de relacionamento de várias entidades em relação a uma entre uma conta bancária e um cliente e um cofre de segurança para depósitos e um cliente. É possível associar várias atividades, como tarefas, emails e compromissos, a uma conta bancária. Para fornecer informações adicionais sobre uma conta bancária ou um cofre de segurança para depósitos, use anotações e anexos.
Sobre os diagramas
É possível encontrar os diagramas das várias entidades do sistema na documentação do SDK, nos tópicos que descrevem os recursos da entidade. Em cada caixa do diagrama, a primeira linha do texto em negrito refere-se ao nome da entidade. As linhas subsequentes contêm os nomes dos atributos usados para definir os relacionamentos em relação a essa entidade. A ferramenta não gera as linhas que mostram os relacionamentos com as seguintes entidades: organização, unidade de negócios e usuário (systemuser). Isso é feito para simplificar o diagrama. A codificação por cores é usada para indicar o relacionamento do proprietário em relação a cada entidade. O diagrama a seguir descreve a codificação por cores:
.jpeg "Chave do diagrama para os diagramas do relacionamento da entidade CRM")
Gerar diagramas de entidades com a ferramenta Diagrama de Metadados
Para usar o código de exemplo que gerará de forma programática os diagramas de metadados do Microsoft Office Visio, compile e execute uma das soluções encontradas no pacote do SDK: SDK\SampleCode\CS\Metadata\Diagram. A pasta contém um arquivo Readme com instruções para seu uso. Um código de exemplo é um aplicativo de console autônomo que cria um diagrama de relacionamentos entre entidades. O programa requer o Microsoft Office Visio.
É possível executar o programa no prompt de comando. Liste somente as entidades que você deseja incluir no diagrama como argumentos de linha de comando. Outras entidades podem ser incluídas no diagrama se necessário para mostrar todos os relacionamentos para cada entidade solicitada. Para gerar um diagrama que mostra os relacionamentos das entidades new_bankaccount e new_safedepositbox, use o seguinte comando:
MetadataDiagramConsole.exe new_bankaccount new_safedepositbox
O nome do arquivo Visio gerado é new_bankaccount.vsd.
Observação
A ferramenta usa o nome da primeira entidade na linha de comando como o nome do arquivo do Visio. Se você executar os dois comandos a seguir, o segundo comando substituirá o diagrama gerado pelo primeiro. Isso ocorre porque os arquivos do Visio têm o mesmo nome – “new_bankaccount.vsd“:
MetadataDiagramConsole.exe new_bankaccount
MetadataDiagramConsole.exe new_bankaccount new_safedepositbox
Para evitar a substituição de um arquivo de diagrama gerado, é necessário renomear o primeiro arquivo antes de executar o segundo comando.
Confira Também
Introdução às entidades no Microsoft Dynamics CRM 2015
Estender o modelo de metadados
Chave para diagramas de entidades
Diagramas de relacionamentos entre entidades do CRM 2015
© 2017 Microsoft. Todos os direitos reservados. Direitos autorais