Criar um novo relatório usando o SQL Server Data Tools

  • Artigo

SQL Server Data Tools é um ambiente de criação de relatórios que permite que você crie ou edite relatórios no Visual Studio. O resultado final é um arquivo .rdl da definição do relatório que contém a definição do relatório que pode ser publicado para exibir relatórios.

Você também pode criar relatórios ao usar um editor de texto comum. Para reduzir o esforço para criar um relatório personalizado, modifique um arquivo .rdl existente que oferece a maioria da funcionalidade desejada. Para obter mais informações sobre o formato dos elementos XML em um arquivo .rdl, consulte Referência de idioma de definição do relatório. O relatório XML modificado pode ser verificado usando o esquema XML especificado. O Reporting Services também verificará a definição do relatório e rejeitará um relatório se a definição for inválida ao tentar carregar o relatório.

Nota

Se o arquivo .rdl contiver uma consulta FetchXML, a consulta FetchXML no RDL será 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 baseado em busca personalizado

Para criar um relatório personalizado baseado em fetch

  1. Verifique se você tem uma versão compatível do Visual Studio, o SQL Server Data Tools, da Extensão de Criação de Relatórios do Microsoft Dynamics CRM 2016 e os privilégios necessários. Mais informações: Ambiente de elaboração de relatório usando o SQL Server Data Tools

  2. Abra o Visual Studio e crie um projeto do servidor de relatórios.

  3. No Solution Explorer, clique com o botão direito do mouse na pasta Relatórios e selecione Adicionar Novo Relatório.

  4. Selecione Avançar.

  5. Na página Selecionar a Fonte de Dados, selecione Nova Fonte de Dados e especifique os seguintes detalhes:

    • Nome: Digite um nome para a fonte de dados.

    • Tipo: Selecione Microsoft Dynamics 365 Fetch.

    • Cadeia de Conexão: Especifica a cadeia de conexão. A cadeia de conexão deve ser especificada no seguinte formato:

      ServerURL;OrganizationName;HomeRealmURL

      Nela, apenas ServerURL é obrigatório. Se OrganizationName não for especificado, a primeira organização à qual o usuário que está executando esta consulta pertence é usada. HomeRealmURL é a URL de Realm Inicial do Provedor de Identidades usado pela organização e é necessária se a sua organização utilizar Federação para o gerenciamento de identidades. Entre em contato com o administrador de rede para determinar a URL de Realm Inicial.

      Selecione Credenciais para especificar as credenciais a fim de se conectar aos aplicativos do Dynamics 365 for Customer Engagement e selecione Avançar.

  6. Na página Criar a Consulta, digite a consulta FetchXML na caixa Consulta. Para obter esta consulta, você pode ter uma das ações:

    • Obter o FetchXML de uma consulta de Localização Avançada. Para isso, abra um aplicativo Customer Engagement (on-premises), selecione Localização Avançada, crie a consulta desejada e, na guia Localização Avançada, selecione Baixar FetchXML. Copie o FetchXML para a caixa Consulta das Propriedades do Conjunto de Dados no Visual Studio.

    • Inserir manualmente a consulta FetchXML. Este exemplo mostra como criar um relatório que exibe todas as contas com 5.000 ou mais funcionários.

      <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 Avançar.

  7. Verifique os campos que serão incluídos no relatório e selecione Avançar.

    • A Extensão de Criação de Relatórios adiciona campos extras dependendo do tipo de dados. Números, datas, pesquisas e conjuntos de opções têm um campo fieldNameValue extra. Por exemplo, se o FetchXML incluir o atributo createdon, haverá dois campos disponíveis: createdon e createdonValue.
      • fieldName (exemplo: createdon)
        • Este campo é uma cadeia de caracteres formatada de acordo com as configurações de formato do usuário. Ele só se destina à exibição. A conversão do valor no tipo de dados original pode acarretar um 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 configurações de localidade no servidor de relatório.
        • Para campos optionset, o valor é o texto de exibição do valor optionset.
        • Para campos de pesquisa, o valor é o campo de nome principal do registro vinculado.
      • fieldNameValue (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 exibição específica do usuário usando os parâmetros CRM_ format ocultos.
        • Para campos datetime, trata-se do valor UTC.
        • Para campos numéricos ou de moeda, trata-se do valor numérico não formatado.
        • Para campos optionset, trata-se do valor do número da opção.
        • Para campos de pesquisa, trata-se do Guid do campo de pesquisa.

  8. Selecione um estilo a ser aplicado ao relatório e Avançar.

  9. Verifique os campos que serão incluídos no relatório e digite um nome para o relatório, como Contas com mais de 5.000 funcionários. Selecione Concluir.

  10. Se você quiser ver como o relatório será exibido ao ser executado, selecione a guia Versão preliminar.

    Isso gera um arquivo .rdl com o nome do relatório especificado. Você pode usar esse arquivo para publicar seu relatório personalizado nos aplicativos do Dynamics 365 for Customer Engagement usando o Assistente de relatórios. Mais informações: Publicar relatórios

Confira também

Ambiente de elaboração de relatórios