Compartilhar via


Criar um novo relatório usando 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 arquivo .rdl de definição de relatório que contém a definição de relatório que você pode publicar para exibir relatórios.

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

Observação

Se o arquivo .rdl contiver uma consulta FetchXML, a consulta no RDL será validada pela Extensão de Criação de Relatórios do Microsoft Dynamics CRM 2016, que a validará internamente em relação ao esquema FetchXML.

Criar um relatório personalizado baseado em Fetch

Para criar um relatório personalizado baseado em Fetch:

  1. Verifique se você tem uma versão com suporte do Visual Studio, SQL Server Data Tools, Extensão de Criação de Relatórios do Microsoft Dynamics CRM 2016 e os privilégios necessários. Para obter mais informações: Ambiente de gravação de relatórios usando o SQL Server Data Tools

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

  3. No Gerenciador de Soluções, clique com o botão direito do mouse na pasta Relatórios e selecione Adicionar Novo Relatório.

  4. Selecione Próximo.

  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: especifique a cadeia de conexão. A cadeia de conexão deve ser especificada no seguinte formato:

      URL do servidor; Nome da Organização; URL do Domínio Inicial

      Nessa cadeia de conexão, somente ServerURL é obrigatório. Se OrganizationName não for especificado, a primeira organização à qual o usuário que executa essa consulta pertence será usada. HomeRealmURL é a URL Home Realm do Provedor de Identidade usado pela sua organização e é necessária quando sua organização usa a federação para gestão de identidades. Entre em contato com o administrador da rede para determinar a URL do Home Realm.

      Selecione Credenciais para especificar as credenciais para se conectar aos aplicativos do Dynamics 365 for Customer Engagement ou 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 essa consulta, você pode fazer o seguinte:

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

    • Insira 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 Próximo.

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

    • A Extensão de Criação de Relatório adiciona campos extras, dependendo do tipo de dados. Números, datas, pesquisas e conjuntos de opções têm um campo extra fieldNameValue . Por exemplo, se o FetchXML incluir o atributo createdon , haverá dois campos disponíveis: createdon e createdonValue.
      • fieldName (exemplo: createdon)
        • Esse campo é uma cadeia de caracteres formatada de acordo com as configurações de formato do usuário. Ele só se destina à exibição. Converter o valor em seu tipo de dados original pode resultar em um erro. Por exemplo, uma expressão como =CDate(Fields!createdon.Value) pode falhar ou fornecer uma data incorreta se o formato de data não corresponder às configurações de localidade no servidor de relatórios.
        • Para campos de conjunto de opções, o valor é o texto de exibição do valor do conjunto de opções.
        • Para campos de pesquisa, o valor é o campo de nome principal do registro vinculado.
      • fieldNameValor (exemplo: createdonValue)
        • Esse 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 de formato CRM_ ocultos.
        • Para campos de data e hora, é o valor UTC.
        • Para campos de número ou 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 pesquisa, trata-se do Guid do campo de pesquisa.
  8. Selecione um estilo a ser aplicado ao relatório e, em seguida, selecione Avançar.

  9. Verifique os campos que serão incluídos no relatório e insira 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 aparece quando ele é executado, selecione a guia Visualizar .

    Isso gera um arquivo .rdl com o nome de 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ório. Para obter mais informações: Publicar relatórios

Consulte também

Ambiente de Escrita de Relatórios