Usar SQL e exibições filtradas para recuperar dados para relatórios
Publicado: janeiro de 2017
Aplicável a: Dynamics 365 (on-premises), Dynamics CRM 2016
Os dados e metadados do Microsoft Dynamics 365 são armazenados em um banco de dados do Microsoft SQL Server chamado <organization_name>_MSCRM no servidor executando o Microsoft SQL Server na implantação do Dynamics 365 (local). Relatórios Baseado em SQL no Microsoft Dynamics 365 usam as exibições filtradas fornecidas por cada entidade para recuperar dados para os relatórios. As exibições filtradas são totalmente compatíveis com o modelo de segurança do Microsoft Dynamics 365. Ao executar um relatório que obtém os dados das exibições filtradas, a função de segurança do Microsoft Dynamics 365 determina quais dados podem ser exibidos no relatório. Os dados das exibições filtradas são restritos para os seguintes níveis: a organização, a unidade de negócios, o proprietário e o nível de campo.
As exibições filtradas existem para todas as entidades do Microsoft Dynamics 365, incluindo entidades personalizadas. Seus relatórios baseados em Baseado em SQL não podem ler dados diretamente do banco de dados do Microsoft Dynamics 365. Em vez disso, você precisa usar as exibições filtradas para recuperar dados para os seus relatórios Baseado em SQL personalizados.
A seguinte consulta SQL retorna todas as colunas da exibição filtrada para a entidade do Account:
SELECT * FROM dbo.FilteredAccount
As exibições filtradas também oferece uma maneira de receber dados de relatório do Microsoft Dynamics 365 em aplicativos do Microsoft Office e o Microsoft Office ExcelMicrosoft Access. Para obter uma lista completa de todas as exibições filtradas padrões organizadas por área de produto, consulte Exibições filtradas no Microsoft Dynamics 365.
Neste tópico
Entidades personalizadas
Esquemas de entidade para criar relatórios baseados em SQL personalizados
Convenções de nomenclatura no banco de dados do Microsoft Dynamics 365
Entidades personalizadas
Ao criar uma nova entidade personalizada no banco de dados do Microsoft Dynamics 365, uma nova exibição filtrada da entidade é criada automaticamente. Além disso, se você adicionar ou alterar um atributo em uma entidade personalizada ou entidade do sistema personalizável, a alteração é incluída automaticamente na exibição filtrada associada.
Esquemas de entidade para criar relatórios baseados em SQL personalizados
Para localizar informações de esquema sobre qualquer exibição filtrada, entidade ou atributo no banco de dados do Microsoft Dynamics 365, use um dos seguintes métodos:
No Microsoft Visual Studio, use o Explorador de Objetos do SQL Server para se conectar ao SQL Server em que o banco de dados da organização Microsoft Dynamics 365 está localizado. Expanda o nó Bancos de dados e expanda o banco de dados <organization_name>_MSCRM. As exibições filtradas, como FilteredContact, podem ser acessadas no nó Exibições. Clicar duas vezes na exibição filtrada exibe um menu de atalho que permite explorar o design da exibição filtrada e os dados que retorna.
Faça logon no aplicativo Web do Microsoft Dynamics 365 usando uma conta que tenha a função de segurança de administrador do sistema. No Microsoft Dynamics 365, escolha Configurações e, em seguida, selecione Personalizações. Em seguida, escolha Personalizar o Sistema, expanda Entidades e clique duas vezes no nome da entidade para exibir os campos (atributos) e relacionamentos.
Escolha Campos para mostrar todos os atributos que incluem o nome de exibição e uma descrição para cada atributo. Para ver as dependências dos atributos, selecione um atributo, escolha Mais Ações e, em seguida, selecione Mostrar Dependências.
Escolha Relacionamento 1:N, Relacionamento N:1 e Relacionamento N:N para mostrar as entidades que têm um relacionamento com a entidade atual e os atributos usados para definir os relacionamentos.
Use o Microsoft SQL Server Management Studio para exibir o conteúdo do banco de dados diretamente.
Todos os métodos listados aqui permite acessar as informações de esquema para entidades e atributos personalizados.
Convenções de nomenclatura no banco de dados do Microsoft Dynamics 365
A seguir estão as convenções de nomenclatura do atributo no banco de dados do Microsoft Dynamics 365.
Atributos obtidos com exibições filtradas
Embora os nomes dos campos no Microsoft Dynamics 365 diferenciem maiúsculas e minúsculas, os nomes do atributo obtidos com as exibições filtradas estão em minúsculas.
Atributos de lista suspensa
Todas as listas suspensas (conjuntos de opções) têm dois campos associados para cada cadeia de caracteres na lista. Para cada cadeia de caracteres, há um valor de campo (código) e um campo de etiqueta (nome), como leadsource e leadsourcename. Por exemplo, a exibição filtrada para clientes potenciais retorna dois campos relacionados ao atributo LeadSource do tipo Picklist: LeadSource = 1 e LeadSourceName = "Anúncio”. Os relatórios exibem o campo de etiqueta e usam o campo de valor para comparações numéricas.
Atributos DateTime
Os atributos DateTime são representados por dois campos na exibição filtrada: DateTime e UTC DateTime. O primeiro campo contém o valor de data e hora para o fuso horário adequado e o segundo campo contém o valor de data e hora no Horário Universal Coordenado (UTC).
Campos de entidades
Para uma tabela de entidades no banco de dados, o campo de chave primária está no formato de nome EntityId, por exemplo, AccountId. Cada campo do EntityId tem um campo associado que contém o valor a ser exibido nos relatórios. Por exemplo, para entidade conta, é o campo Name que contém o nome da conta.
Nesta seção
Exibições filtradas no Microsoft Dynamics 365
Confira Também
Trabalhando com relatórios baseados em SQL (só em Dynamics 365 local)
Formatar o conteúdo de relatório
© 2017 Microsoft. Todos os direitos reservados. Direitos autorais