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.

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	Email
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	Email
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:

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