Criar um novo relatório com o SQL Server Data Tools
O SQL Server Data Tools é um ambiente de criação de relatórios que permite criar ou editar relatórios do SQL Server Reporting Services no Visual Studio. O resultado final é um ficheiro. RDL de definição de relatório que contém a definição do relatório que é possível publicar para ver os relatórios.
É também possível criar relatórios utilizando o editor de texto comum. Para reduzir o esforço necessário para criar um relatório personalizado, modifique um ficheiro. RDL existente que forneça a maioria das funcionalidades pretendidas. Para mais informações sobre o formato dos elementos XML de um ficheiro. RDL, consulte Referência da linguagem RDL (Report Definition Language). Poderá verificar o XML do relatório modificado utilizando o esquema XML especificado. O Reporting Services também irá verificar a definição do relatório e rejeitará um relatório se a definição for inválida quando tentar carregar o relatório.
Nota
Se o ficheiro .rdl contiver uma consulta FetchXML, a consulta no RDL é validada pela Extensão de Criação de Relatórios do Microsoft Dynamics CRM 2016, que a valida internamente em relação ao esquema FetchXML.
Criar um relatório personalizado baseado em Fetch
Para criar um relatório personalizado baseado no Fetch:
Certifique-se de que tem uma versão suportada do Visual Studio, SQL Server Data Tools, Extensão de Criação de Relatório do Microsoft Dynamics CRM 2016, bem como os privilégios necessários. Mais informações: Ambiente de escrita de relatórios com o SQL Server Data Tools
Abra o Visual Studio e crie um projeto do servidor de relatórios.
No Explorador de Soluções, clique com o botão direito do rato na pasta Relatórios e, em seguida, selecione Adicionar Novo Relatório.
Selecione Seguinte.
Na página Selecionar a Origem de Dados, selecione Nova Origem de Dados e, em seguida, especifique os seguintes detalhes:
Nome:. Escreva um nome para a origem de dados.
Tipo: selecione Microsoft Dynamics 365 Fetch.
Cadeia de Ligação: especifique a cadeia de ligação. A cadeia de ligação tem de ser especificada no seguinte formato:
ServerURL;OrganizationName;HomeRealmURL
Nesta cadeia de ligação, só é obrigatório ServerURL. Se OrganizationName não for especificado, será utilizada a primeira organização a que o utilizador (que está a executar esta consulta) pertence. HomeRealmURL é o URL de Realm Inicial do Fornecedor de Identidade utilizado pela sua organização e é necessário quando a sua organização utiliza a Federação para gestão de identidades. Contacte o administrador de rede para determinar o URL de Realm Inicial.
Selecione Credenciais para especificar as credenciais para se associar às aplicações Dynamics 365 for Customer Engagement ou às aplicações Dynamics 365 for Customer Engagement e, em seguida, selecione Seguinte.
Na página Estruturar a Consulta, escreva a consulta FetchXML na caixa Consulta. Para obter esta consulta, pode efetuar um dos seguintes procedimentos:
Obtenha o FetchXML de uma consulta de Localização Avançada. Para tal, abra uma aplicação Customer Engagement (on-premises), selecione Localização Avançada, crie a consulta pretendida e, em seguida, no separador Localização Avançada, selecione Transferir Fetch XML. Copie o FetchXML para a caixa Consulta das Propriedades do Conjunto de Dados no Visual Studio.
Introduza manualmente a consulta FetchXML. Este exemplo mostra como criar um relatório que apresenta todas as contas com 5000 colaboradores ou mais.
<fetch version="1.0" output-format="xml-platform" mapping="logical" distinct="false"> <entity name="account"> <attribute name="name" /> <attribute name="numberofemployees" /> <attribute name="accountnumber" /> <order attribute="name" descending="false" /> <filter type="and"> <condition attribute="numberofemployees" operator="gt" value="5000" /> </filter> </entity> </fetch>
Selecione Seguinte.
Verifique os campos que serão incluídos no relatório e depois selecione Seguinte.
- A Extensão de Criação de Relatórios adiciona campos extra dependendo do tipo de dados. Números, datas, pesquisas e conjuntos de opções têm um campo fieldNameValor extra. Por exemplo, se o FetchXML incluir o atributo createdon, existem dois campos disponíveis: createdon e createdonValue.
-
fieldName (exemplo: createdon)
- Este campo é uma cadeia de carateres formatada de acordo com as definições de formato do utilizador. Destina-se apenas a visualização. A conversão do valor para o tipo de dados original pode resultar em erro. Por exemplo, uma expressão como
=CDate(Fields!createdon.Value)
pode falhar ou fornecer uma data incorreta se o formato da data não corresponder às definições da região do servidor de relatórios. - Para campos de conjunto de opções, o valor é o texto de apresentação do valor do conjunto de opções.
- Para campos de procura, o valor é o campo de nome principal do registo associado.
- Este campo é uma cadeia de carateres formatada de acordo com as definições de formato do utilizador. Destina-se apenas a visualização. A conversão do valor para o tipo de dados original pode resultar em erro. Por exemplo, uma expressão como
-
fieldNameValor (exemplo: createdonValue)
- Este campo é o valor bruto não formatado do campo de acordo com o tipo de dados. Os campos podem ser ajustados e formatados para apresentação específica do utilizador usando os parâmetros ocultos de formato CRM_.
- Para campos datetime, é o valor UTC.
- Para campos numéricos ou de moeda, é o valor numérico não formatado.
- Para campos de conjunto de opções, é o valor do número da opção.
- Para campos de procura, é o Guid do campo de procura.
-
fieldName (exemplo: createdon)
- A Extensão de Criação de Relatórios adiciona campos extra dependendo do tipo de dados. Números, datas, pesquisas e conjuntos de opções têm um campo fieldNameValor extra. Por exemplo, se o FetchXML incluir o atributo createdon, existem dois campos disponíveis: createdon e createdonValue.
Selecione um estilo a aplicar ao relatório e depois selecione Seguinte.
Verifique os campos que serão incluídos no relatório e introduza um nome para o relatório, como Contas com mais de 5.000 Colaboradores. Selecione Concluir.
Se pretende ver o aspeto que o relatório tem quando for executado, selecione o separador Pré-visualizar.
Isto gera um ficheiro. RDL com o nome de relatório especificado. Pode utilizar este ficheiro para publicar o relatório personalizado em aplicações Dynamics 365 for Customer Engagement utilizando o Assistente de Relatórios. Mais informações: Publicar relatórios