gallery.technet.microsoft.com · Web viewAlguns exemplos aqui retratados são fornecidos meramente para fins ilustrativos e são fictícios. Nenhuma associação ou conexão real

Guia de criação de relatórios do Microsoft Dynamics CRM 2013

Versão 6.0.2

Este documento é fornecido "no estado em que se encontra". As informações e os enfoques expressos neste documento, incluindo URLs e outras referências a sites da Internet, podem ser alterados sem prévio aviso.

Alguns exemplos aqui retratados são fornecidos meramente para fins ilustrativos e são fictícios. Nenhuma associação ou conexão real é intencional ou deve ser inferida.

Este documento não lhe concede direitos legais a nenhuma propriedade intelectual de qualquer produto da Microsoft. Você pode copiar e usar este documento internamente e para fins de referência.

© 2013 Microsoft Corporation. Todos os direitos reservados.

Microsoft, Active Directory, ActiveX, Azure, BizTalk, JScript, Microsoft Dynamics, Outlook, SharePoint, SQL Server, Visual Basic, Visual Studio, Windows, Windows Server e Windows Vista são marcas comerciais do grupo Microsoft de empresas.

Todas as outras marcas comerciais pertencem a seus respectivos proprietários.

SumárioGuia de redatores de relatório para Microsoft Dynamics CRM 2013 e Microsoft Dynamics CRM

Online.......................................................................................................................................... 4Send us your comments about this document.............................................................................5Ambiente de elaboração de relatório...........................................................................................5Criar relatórios personalizados usando o Business Intelligence Development Studio.................7Modificar relatórios usando o Business Intelligence Development Studio.................................10Usar SQL e exibições filtradas para recuperar dados para relatórios.......................................12Exibições filtradas no Microsoft Dynamics CRM.......................................................................15[M2RG]]Editar um relatório padrão ou criar um relatório do Reporting Services baseado em

SQL........................................................................................................................................ 35[M2RG]Ambiente de desenvolvimento de relatório para relatórios personalizados com base em

Fetch e SQL........................................................................................................................... 36[M2RG]Criar um relatório personalizado baseado em Fetch.....................................................38Usar parâmetros em relatórios..................................................................................................40Use filtros em relatórios.............................................................................................................46RDL sandboxing para o Microsoft Dynamics CRM Online........................................................52Formatar o conteúdo de relatório..............................................................................................61Adicionar navegação de relatório..............................................................................................63Testar e solucionar problemas com relatórios...........................................................................64Publicar relatórios...................................................................................................................... 66Copiar relatórios entre implantações do Microsoft Dynamics CRM...........................................67Categorizar e exibir relatórios em diferentes idiomas................................................................70Práticas recomendadas para relatórios.....................................................................................71Melhorar o desempenho dos relatórios.....................................................................................73Relatórios de amostra...............................................................................................................73

Exemplo: Limitar o número de itens exibidos em um gráfico.................................................74Exemplo: Exibir os primeiros X valores..................................................................................76Exemplo: Criar um relatório contextual..................................................................................77

Guia de redatores de relatório para Microsoft Dynamics CRM 2013 e Microsoft Dynamics CRM OnlineO Aguardando inclui relatórios que fornecem informações úteis para o usuário. É possível usar esses relatórios como modelos para criar seus próprios relatórios personalizados. Esse guia mostra como criar novos relatórios ou alterar relatórios existentes.

Nesta seçãoAmbiente de elaboração de relatório

Criar relatórios personalizados usando o Business Intelligence Development Studio

Modificar relatórios usando o Business Intelligence Development Studio

Usar SQL e exibições filtradas para recuperar dados para relatórios

Exibições filtradas no Microsoft Dynamics CRM

Usar parâmetros em relatórios

Use filtros em relatórios

RDL sandboxing para o Microsoft Dynamics CRM Online

Formatar o conteúdo de relatório

Adicionar navegação de relatório

Testar e solucionar problemas com relatórios

Publicar relatórios

Copiar relatórios entre implantações do Microsoft Dynamics CRM

Categorizar e exibir relatórios em diferentes idiomas

Práticas recomendadas para relatórios

Melhorar o desempenho dos relatórios

Relatórios de amostra

Seções relacionadosPlanning Guide for Microsoft Dynamics CRM 2013 and Microsoft Dynamics CRM OnlineInstalling Guide for Microsoft Dynamics CRM 2013 and Microsoft Dynamics CRM OnlineAdministration Guide for Microsoft Dynamics CRM 2013 and Microsoft Dynamics CRM OnlineOperating Guide for Microsoft Dynamics CRM 2013 (on-premises)

4

Customization Guide for Microsoft Dynamics CRM 2013 and Microsoft Dynamics CRM Online

Send us your comments about this documentSe você tiver dúvidas ou comentários sobre este documento, clique para enviar uma mensagem de email para a Equipe de conteúdo do Microsoft Dynamics CRM.

Se a sua dúvida for sobre os produtos Microsoft Dynamics CRM, e não sobre o conteúdo deste manual, pesquise a Ajuda da Microsoft e o Centro de Suporte ou a Base de Dados de Conhecimento da Microsoft.

Ambiente de elaboração de relatórioVocê deve ter as ferramentas de desenvolvimento e os privilégios adequados no Aguardando para escrever e publicar um relatório. Além disso, verifique se você tem o conhecimento prático do:

A linguagem Transact-SQL e o Microsoft SQL Server 2008 R2. Criar relatórios do Microsoft SQL Server Reporting Services usando o Business Intelligence

Development Studio. A linguagem FetchXML do Aguardando.

Ferramentas necessáriasOs seguintes são necessários para escrever um relatório personalizado para o Aguardando:

Microsoft SQL Server 2008 Reporting Services ou Microsoft SQL Server 2008 R2 Reporting Services. Deve estar instalado no servidor do Aguardando ou em um servidor de relatórios separado, dependendo de onde os relatórios estão sendo servidos.

O Aguardando oferece suporte somente ao modo nativo de implantação do Microsoft SQL Server Reporting Services. Se você tiver implantado o Microsoft SQL Server Reporting Services usando qualquer outro modo, como o modo de integração do SharePoint, desinstale a instância existente do Microsoft SQL Server Reporting Services e reinstale usando o modo nativo.

Para obter mais informações sobre os vários modos de implantação do Microsoft SQL Server Reporting Services, consulte Planejando um modo de implantação.

Business Intelligence Development Studio. Trata-se de um ambiente de criação de relatórios no Visual Studio 2008 que hospeda o Designer de Relatórios (um componente do Microsoft SQL Server Reporting Services). Você pode instalar o Business Intelligence Development Studio pelo CD de instalação do Microsoft SQL Server 2008.

Observação

5

http://go.microsoft.com/fwlink/?LinkId=166603

http://support.microsoft.com/

http://support.microsoft.com/

mailto://[email protected]?subject=Microsoft%20Dynamics%20CRM%202013%20Reporting%20Guide%20%20(/1:IG/2:V6.0/3:V6.0.2/4:print_doc/5:none/6:en-us/7:OP)

Extensão de Criação de Relatórios do Microsoft Dynamics CRM. É necessário somente se você estiver redigindo relatórios personalizados baseados em fetch, como para o Microsoft Dynamics CRM Online. Deve ser desinstalado no computador onde o Business Intelligence Development Studio estiver instalado. É possível instalar o Extensão de Criação de Relatórios do Microsoft Dynamics CRM em http://go.microsoft.com/fwlink/?LinkId=199124. Como alternativa, você também pode instalar pela pasta BIDSExtension do DVD de instalação do Aguardando.

O Extensão de Criação de Relatórios do Microsoft Dynamics CRM está disponível apenas na versão de 32 bits porque o Business Intelligence Development Studio é um ambiente de desenvolvimento de 32 bits.

Para obter mais informações sobre como configurar o ambiente para redigir relatórios, baixe o Guia de Implementação do Microsoft Dynamics CRM 2011 em http://go.microsoft.com/fwlink/?LinkID=200050.

Privilégios necessáriosPara implantar relatórios personalizados no Aguardando, você deve ter uma função de segurança atribuída a sua conta que inclui os privilégios prvPublishRSReport e prvPublishOrgReport HYPERLINK "javascript:toggleInline('23895_2')" \t "_self" \o "Add Reporting Services Reports"

Processo de desenvolvimento de relatórioA seguir estão as etapas para desenvolver relatórios personalizados do Aguardando. Talvez seja necessário repetir algumas etapas durante o desenvolvimento de um relatório:

1. Desenvolver um conceito de relatório ou uma especificação com base nas informações comerciais que precisam ser exibidas.

2. Defina o tipo de relatório que você deseja criar: baseado em SQL ou baseado em fetch. Os usuários do Microsoft Dynamics CRM Online podem criar apenas relatórios personalizados baseados em fetch.

3. Baixe um arquivo de linguagem de definição de relatório do Aguardando existente e modifique ou crie um novo relatório usando o Business Intelligence Development Studio. Para obter mais informações: Criar relatórios personalizados usando o Business Intelligence Development Studio

4. Criar parâmetros de relatório básicos. Para obter mais informações: Usar parâmetros em relatórios

5. Especificar conjuntos de dados e critérios de filtragem para recuperar dados: Para relatórios baseados em SQL, crie conjunto de dados que contêm os dados do

Aguardando obtidos pelas exibições filtradas. Para obter mais informações: Exibições filtradas no Microsoft Dynamics CRM

Habilitar a pré-filtragem nas entidades primárias. Para obter mais informações: Use filtros em relatórios

Observação

6

http://go.microsoft.com/fwlink/?LinkID=200050



6. Defina o layout básico do relatório, incluindo cabeçalhos e rodapés.7. Adicione itens de relatórios como necessário com base na especificação do relatório. Para

obter mais informações: Adicionar navegação de relatório8. Visualize o relatório no Microsoft Visual Studio e resolva todos os erros. Para obter mais

informações: Testar e solucionar problemas com relatórios9. Implante o relatório ao servidor de relatórios usando o Aguardando. Para obter mais

informações: Publicar relatórios10. Execute o relatório implantado para verificar.

Para obter mais informações, consulte livros sobre como escrever relatórios para os Serviços de Relatório, como "Microsoft SQL Server 2005 Reporting Services” por Brian Larson.

Consulte tambémUsar SQL e exibições filtradas para recuperar dados para relatórios

Guia de redatores de relatório para Microsoft Dynamics CRM 2013 e Microsoft Dynamics CRM Online

Introdução aos relatórios personalizados na nuvem

Business Intelligence Development Studio

Designer de relatórios e Business Intelligence Development Studio

Criar relatórios personalizados usando o Business Intelligence Development StudioO Business Intelligence Development Studio é a ferramenta primária usada para criar ou modificar relatórios. O Business Intelligence Development Studio é um ambiente de criação de relatórios no Microsoft Visual Studio 2008 que permite criar relatórios do Microsoft SQL Server Reporting Services. O resultado final é um arquivo .rdl que contém a definição de relatórios que podem publicar no Aguardando para exibir relatórios.

Como alternativa, é possível criar relatórios usando um editor de texto comum. Para reduzir o esforço para criar um relatório personalizado, use um arquivo de definição do relatório existente (.rdl) que oferece a maioria da funcionalidade desejada e modifique-a. 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 irá verificar a definição de relatório e rejeitará um relatório se a definição for inválido ao tentar carregar um relatório no Aguardando.

Se o arquivo .rdl contém uma consulta FetchXML, a consulta FetchXML no RDL é validada pelo Extensão de Criação de Relatórios do Microsoft Dynamics CRM, que valida internamente no esquema FetchXML. Para obter mais informações, consulte o tópico "Esquema XML de fetch" no SDK do Microsoft Dynamics CRM 2013.

Observação

7



http://msdn.microsoft.com/en-us/library/cc281300.aspx

http://msdn.microsoft.com/en-us/library/ms173767.aspx


Neste tópicoCriar um relatório baseado em SQL personalizado

Criar um relatório baseado em busca personalizado

Diferenças entre o Arquivo RDL de relatórios baseados em SQL e baseados em Fetch

Criar um relatório baseado em SQL personalizadoPara criar um relatório baseado em SQL personalizado usando o Business Intelligence Development Studio:

1. Abrir o Business Intelligence Development Studio e criar um projeto do servidor de relatórios. 2. No Solution Explorer, clique com o botão direito do mouse na pasta Relatórios e clique em

Adicionar Novo Relatório. 3. Clique em Avançar.4. Na página Selecionar a Fonte de Dados, clique em Nova Fonte de Dados e especifique os

seguintes detalhes: Nome: Digite um nome para a fonte de dados. Tipo: Selecione Microsoft SQL Server. Cadeia de Caracteres de Conexão: Especifica a cadeia de caracteres de conexão para

se conectar à instância do banco de dados do Microsoft SQL Server. Para criar a cadeia de caracteres de conexão, clique em Editar. Para fornecer credenciais, clique em Credenciais. Clique em Avançar.

5. Na página Criar a Consulta, digite a consulta SQL para usar no relatório e clique em Avançar.

6. Na página Selecionar Tipo de Relatório, selecione um relatório Tabular ou um relatório Matriz e clique em Avançar.

7. Especifique os campos que serão incluídos no relatório e clique em Avançar.8. Selecione um estilo a ser aplicado ao relatório e clique em Avançar. 9. Verifique os campos que serão incluídos no relatório e o nome do relatório. Clique em

Concluir.Este método gerará um arquivo .rdl com o nome de relatório especificado. Você pode usar o arquivo .rdl para publicar seu relatório personalizado no Aguardando. Para obter mais informações: Publicar relatórios.

Para obter mais informações sobre como criar um relatório usando o Assistente de Relatórios no Business Intelligence Development Studio, consulte Tutorial: Criar um relatório (Reporting Services).

Criar um relatório baseado em busca personalizadoCriar um relatório baseado em fetch personalizado é semelhante a criação de um relatório baseado em SQL personalizado, exceto para o nome da fonte de dados e a consulta de relatório especificada durante a criação da definição do relatório. Para criar um relatório personalizado baseado em fetch

8



1. Execute as etapas 1 a 3 como mencionado anteriormente na seção Criar um relatório baseado em SQL personalizado.

2. Na página Selecionar a Fonte de Dados, clique em Nova Fonte de Dados e especifique os seguintes detalhes: Nome: Digite um nome para a fonte de dados. Tipo: Selecione Microsoft Dynamics CRM Fetch. Cadeia de Caracteres de Conexão: Especifica a cadeia de conexão. A cadeia de

caracteres de conexão deve ser especificada no seguinte formato:

ServerURL;OrganizationName;HomeRealmURL

Nesta cadeia de caracteres de conexão, apenas ServerURL> é obrigatório. Se OrganizationName não for especificado, a primeira organização a qual o usuário executando esta consulta pertence é usada. Se HomeRealmURL não for especificado, o valor será recuperado do valor de registro "HKLM\SOFTWARE\Microsoft\MSCRMBidsExtensions\HomeRealmUrl".

Clique em Credenciais para especificar as credenciais para conectar ao Aguardando ou ao Microsoft Dynamics CRM Online e clique em Avançar.

3. Na página Criar a Consulta, digite a consulta FetchXML para recuperar dados no relatório. Você pode fazer um dos seguintes: Digitar manualmente a consulta FetchXML. Para obter mais informações: Building

Queries with FetchXML no SDK do Microsoft Dynamics CRM. Para obter a consulta FetchXML de um registro, abra o Aguardando, clique em

Localização Avançada e clique em Baixar Fetch XML.

Clique em Avançar.4. O restante das etapas são iguais as mencionadas anteriormente nas etapas 6 a 9 na seção

Criar um relatório baseado em SQL personalizado.

Este método gerará um arquivo .rdl com o nome de relatório especificado. Você pode usar o arquivo .rdl para publicar seu relatório personalizado no Microsoft Dynamics CRM Online usando o Assistente de Relatórios. Para obter mais informações:Publicar relatórios.

Diferenças entre o Arquivo RDL de relatórios baseados em SQL e baseados em FetchA tabela a seguir lista as diferenças entre arquivos .rdl de relatórios baseados em SQL e baseados em fetch no Aguardando.

Área Relatório baseado em SQL Relatório baseado em fetch

Provedor de Dados

O valor do elemento .rdl no arquivo <DataProvider> é definido

O valor do elemento .rdl no arquivo <DataProvider> é definido como

9

Área Relatório baseado em SQL Relatório baseado em fetch

como SQL. Por exemplo:

<DataProvider>SQL</DataProvider>

MSCRMFETCH. Por exemplo:

<DataProvider>MSCRMFETCH</DataProvider>

Consulta de Relatório

A consulta especificada para recuperar dados está no subelemento <CommandText> no elemento do <Query> na definição de relatórios (arquivo .rdl) é uma consulta SQL. Por exemplo, a consulta para recuperar todos os nomes da conta para um relatório baseado em SQL será:

<CommandText>SELECT name FROM

FilteredAccount;</CommandText>

A consulta especificada para recuperar dados está no subelemento <CommandText> no elemento do <Query> na definição de relatórios (arquivo .rdl) é uma consulta FetchXML. Por exemplo, a consulta para recuperar todos os nomes da conta para um relatório baseado em Fetch será:

<CommandText><fetch version="1.0"

output-format="xml-platform"

mapping="logical"> <entity

name="account"> <attribute

name="name" />

</entity></fetch></CommandText>

Consulte tambémGuia de redatores de relatório para Microsoft Dynamics CRM 2013 e Microsoft Dynamics CRM Online

Modificar relatórios usando o Business Intelligence Development Studio

Blog: Introdução aos relatórios personalizados na nuvem

Modificar relatórios usando o Business Intelligence Development StudioEste tópico descreve informações sobre a modificação do arquivo existente de RDL para baixar usando o Business Intelligence Development Studio. Entretanto, verifique se o arquivo RDL modificado está de acordo com o esquema e as especificações do RDL. Para obter mais informações: Relatórios de definição de elementos XML

Neste tópicoTrabalhar com consultas SQL complexas

Modificar um arquivo RDL

Adicionar elementos usando o Designer de Relatórios

Testar o relatório

10


http://community.dynamics.com/product/crm/crmtechnical/b/crmteamblog/archive/2010/10/19/getting-started-with-custom-reports-in-the-cloud.aspx

Trabalhar com consultas SQL complexasAo criar ou modificar um relatório baseado em SQL usando o Assistente de Relatório no Business Intelligence Development Studio, algumas consultas SQL complexas devem ser digitadas no Designer de Consulta Genérico devido às limitações de consulta SQL no Construtor de Consultas. Use o Construtor de Consultas para gerar uma consulta SQL inicial simples e alternar para o Designer de Consulta Genérico para adicionar uma lógica de consulta mais complexa.

As novas consultas SQL ou existentes são limitadas a 260 junções de tabelas. Em uma consulta SQL, a limitação de junção da tabela inclui sua própria junção de tabela, além de qualquer junção de tabela executada dentro da exibições filtradas que são referenciadas.

Ao adicionar várias concatenações de cadeia de caracteres a uma consulta SQL utilizando o Designer ou o Construtor de Consultas, o Business Intelligence Development Studio leva mais tempo para atualizar os itens do relatório associados ao conjunto de dados da consulta. Isso resulta a produtividade reduzida do usuário ao editar um relatório. Para a produtividade de elaboração de relatório aprimorada, você poderá ignorar a atualização do item de relatório editando manualmente o código da consulta SQL no arquivo de RDL.

Modificar um arquivo RDL

1. Abrir o Business Intelligence Development Studio e criar um projeto do servidor de relatórios. Para obter mais informações: Tutorial: Criar um projeto do servidor de relatórios (Serviços de Relatório)

2. No Solution Explorer, clique com o botão direito na pasta Relatórios, selecione Adicionar e clique em Item existente. A caixa de diálogo Assistente de relatório é aberta.

3. Na caixa de diálogo Adicionar item existente, selecione o arquivo RDL necessário e clique em Adicionar. O arquivo RDL será adicionado na pasta Relatórios.

4. Para exibir o código XML do arquivo RDL, clique com o botão direito do mouse no arquivo RDL e clique em Exibir Código. Faça as alterações necessárias e salve o arquivo.

Para obter mais informações: Adicionar um campo ao formulário

Adicionar elementos usando o Designer de Relatórios

Observação

Para editar um arquivo RDL usando o Business Intelligence Development Studio

Para usar o Designer de Relatórios no Business Intelligence Development Studio para adicionar conjunto de dados, selecionar campos da tabela, definir consultas e adicionar parâmetros para um relatório

11

http://rc.crm.dynamics.com/rc/2011/en-us/online/5.1_ctp/help/source_cust_add_form_field.htm



1. Execute as etapas 1 a 3 conforme especificado no Modificar um arquivo RDL.2. Clique com o botão direito do mouse no arquivo RDL e clique em Exibir Designer. O

elemento do relatório é exibido na guia Design.3. Use o painel Dados do Relatório para adicionar conjuntos de dados, selecionar campos

da tabela, definir consultas e adicionar parâmetros a um relatório.4. Salve as alterações. Isso adicionará o código XML necessário para esses elementos do

relatório no arquivo RDL.

Testar o relatórioAo terminar de editar o arquivo RDL, salve as alterações e volte para a guia Visualizar do relatório no Business Intelligence Development Studio para testar o relatório. Qualquer erro do esquema XML ou erros SQL serão relatados no Business Intelligence Development Studio.



Usar SQL e exibições filtradas para recuperar dados para relatóriosOs dados e metadados do Aguardando são armazenados em um banco de dados do Microsoft SQL Server chamado <organization_name>_MSCRM no servidor executando o Microsoft SQL Server na instalação do Aguardando. Relatórios baseados em SQL no Aguardando usam as exibições filtradas fornecidas para cada entidades para recuperar dados para os relatórios. As exibições filtradas são totalmente compatíveis com o modelo de segurança do Aguardando. Ao executar um relatório que obtém os dados das exibições filtradas, a função de segurança do Aguardando 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 Aguardando, incluindo entidades personalizadas. Seus relatórios baseados em SQL não podem ler dados diretamente do banco de dados do Aguardando. Em vez disso, você precisa usar as exibições filtradas para recuperar dados para os seus relatórios baseados em SQL.

O seguinte código de exemplo do SQL retorna todas as colunas da exibição filtrada para uma entidade do Account:SELECT * FROM dbo.FilteredAccount

As exibições filtradas também oferece uma maneira de receber dados de relatório do Aguardando em aplicativos do Microsoft Office e o Microsoft Office Excel Microsoft Access. Para

12

obter uma lista completa de todas as exibições filtradas padrões organizadas por área de produto, consulte Exibições filtradas no Microsoft Dynamics CRM.

Neste tópicoEntidades personalizadas

Esquemas de entidade para criar relatórios baseados em SQL personalizados

As convenções de nomenclatura no banco de dados Microsoft Dynamics CRM

Entidades personalizadasAo criar uma nova entidade personalizada no banco de dados do Aguardando, 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 personalizadosPara localizar informações de esquema sobre qualquer exibição filtrada, entidade ou atributo no banco de dados do Aguardando, use um dos seguintes métodos:

No Microsoft Visual Studio, use o Gerenciador de Servidores para conectar o servidor onde o Aguardando está instalado. Expanda o nó do SQL Server e o nó da instância do SQL Server de destino. As exibições filtradas podem ser acessadas no nó Exibições do banco de dados do <organization_name>_MSCRM. 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 Aguardando usando uma conta que tenha a função de segurança de administrador do sistema. No Aguardando, clique em Configurações e em Personalizações. Em seguida, clique em Personalizar o Sistema, expanda Entidades e clique duas vezes no nome da entidade para exibir os campos (atributos) e relacionamentos.

Campos mostra 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, clique em Mais Ações e em Mostrar Dependências.

Relacionamento 1:N, Relacionamento N:1 e Relacionamento N:N exibem entidades que têm um relacionamento com a entidade atual e os atributos usados para definir os relacionamentos.

Use o Studio de Gerenciamento do Microsoft SQL Server 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.

13

As convenções de nomenclatura no banco de dados Microsoft Dynamics CRMA seguir estão as convenções de nomenclatura do atributo no banco de dados do Aguardando.

Atributos obtidos com exibições filtradasEmbora os nomes dos campos no Aguardando diferenciem maiúsculas e minúsculas, os nomes do atributo obtidos com as exibições filtradas estão em minúsculas.

Atributos de lista suspensaTodas 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 DateTimeOs 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 entidadesPara 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.


Exibições filtradas no Microsoft Dynamics CRM

Exemplo: Limitar o número de itens exibidos em um gráfico

Exemplo: Exibir os primeiros X valores

Exemplo: Criar um relatório contextual

14

Exibições filtradas no Microsoft Dynamics CRMEste tópico lista as exibições filtradas disponíveis no Aguardando local. Você pode usar as exibições filtradas para recuperar dados de forma segura para seus relatórios baseados em SQL e exibir relatórios para um usuário com base na função de segurança do Aguardando.

Nome de esquema da entidade

Código de tipo de entidade

Nome de exibição do relatório Descrição

Account 1 FilteredAccount Empresa que representa um cliente ou um cliente potencial. A empresa que será cobrada nas transações comerciais.

AccountLeads 16 FilteredAccountLeads Representa a tabela de interseção do accountleads_associationrelationship.

ActivityMimeAttachment 1001 FilteredActivityMimeAttachment

Anexo MIME para uma atividade de email.

ActivityParty 135 FilteredActivityParty Pessoa ou grupo associado a uma atividade. Uma atividade pode ter várias partes da atividade.

ActivityPointer 4200 FilteredActivityPointer Tarefa executada ou a ser executada por um usuário. Uma atividade é qualquer ação para que uma entrada possa ser feita em um calendário.

Essa exibição acumula todas as atividades diferentes em uma exibição.

Annotation 5 FilteredAnnotation Anotação (nota) que pode ser anexada a um ou mais objetos, incluindo outras

15




anotações.

AnnualFiscalCalendar 2000 FilteredAnnualFiscalCalendar Calendário fiscal longo do ano de uma organização. Um período durante o qual as atividades financeiras de uma organização são calculadas.

ApplicationFile 4707 FilteredApplicationFile Apenas para uso interno.

Appointment 4201 FilteredAppointment Compromisso representando um intervalo de tempo com horas de início e término e duração.

AsyncOperation 4700 FilteredAsyncOperation Processo cuja execução pode continuar de forma independente ou em segundo plano.

Attachment 1002 FilteredAttachment Apenas para uso interno.

BulkDeleteOperation 4424 FilteredBulkDeleteOperation Trabalho de exclusão em massa enviado pelo usuário.

BulkOperation 4406 FilteredBulkOperation Operação do sistema usada para executar operações demoradas e assíncronas em conjuntos de dados grandes, como distribuição de uma atividade de campanha ou campanha rápida.

BulkOperationLog 4405 FilteredBulkOperationLog Log usado para registrar a execução da operação em massa, sucessos e falhas.

BusinessUnit 10 FilteredBusinessUnit Negócio, divisão ou departamento no banco de dados do Aguardando.

16




BusinessUnitNewsArticle 132 FilteredBusinessUnitNewsArticle

Anúncio associado a uma organização.

Calendar 4003 FilteredCalendar Calendário usado pelo sistema de agendamento para definir quando um compromisso ou uma atividade deve ocorrer.

CalendarRule 4004 FilteredCalendarRule Apenas para uso interno.

Campaign 4400 FilteredCampaign Um recipiente para atividades de campanha e respostas, publicidades de vendas, produtos e listas para criar, planejar, executar e controlar os resultados de uma campanha de marketing específica durante sua vida útil.

CampaignActivity 4402 FilteredCampaignActivity Tarefa executada, ou a ser executada, por um usuário para planejamento e execução de uma campanha.

CampaignActivityItem 4404 FilteredCampaignActivityItem Representa a tabela de interseção para os seguintes relacionamentos:

campaignactivitysalesliterature_association

campaignactivitylist_association

CampaignItem 4403 FilteredCampaignItem Representa a tabela de

17




interseção para os seguintes relacionamentos:

campaignproduct_association

campaigncampaign_association

campaignsalesliterature_association

campaignlist_association

CampaignResponse 4401 FilteredCampaignResponse Respostas de clientes existentes ou potenciais para uma campanha.

Competitor 123 FilteredCompetitor Empresa que está concorrendo à venda representada por um cliente potencial ou oportunidade.

CompetitorAddress 1004 FilteredCompetitorAddress Apenas para uso interno.

CompetitorProduct 1006 FilteredCompetitorProduct Representa a tabela de interseção para o relacionamento do competitorproduct_association.

CompetitorSalesLiterature

26 FilteredCompetitorSalesLiterature

Representa a tabela de interseção do competitorsalesliterature_associationrelationship.

Connection 3234 FilteredConnection Relacionamento entre duas

18




entidades.

ConnectionRole 3231 FilteredConnectionRole Função que descreve um relacionamento entre dois registros.

ConnectionRoleAssociation

3232 FilteredConnectionRoleAssociation

Representa a tabela de interseção para o relacionamento do connectionroleassociation_association.

ConstraintBasedGroup 4007 FilteredConstraintBasedGroup Grupo ou conjunto de pessoas, equipamentos e/ou instalações que pode ser agendado.

Contact 2 FilteredContact Pessoa com a qual uma unidade de negócios tem um relacionamento, como cliente, fornecedor ou colega.

ContactInvoices 17 FilteredContactInvoices Representa a tabela de interseção para o relacionamento do contactinvoices_association.

ContactLeads 22 FilteredContactLeads Representa a tabela de interseção do contactleads_associationrelationship.

ContactOrders 19 FilteredContactOrders Representa a tabela de interseção do contactorders_associationrelationship.

ContactQuotes 18 FilteredContactQuotes Representa a tabela de interseção do contactquotes_associationrel

19




ationship.

Contract 1010 FilteredContract Contrato para prestação de serviços do cliente por um período de tempo ou número de ocorrências específico.

ContractDetail 1011 FilteredContractDetail Item de linha em um contrato que especifica o tipo de serviço que um cliente pode receber.

ContractTemplate 2011 FilteredContractTemplate Modelo para contrato que contém os atributos padrão de um contrato.

CustomerAddress 1071 FilteredCustomerAddress Endereço e informações de entrega. Use para armazenar endereços adicionais para uma conta ou um contato.

CustomerOpportunityRole

4503 FilteredCustomerOpportunityRole

Relacionamento Preterido. entre uma conta ou contato e uma oportunidade.

CustomerRelationship 4502 FilteredCustomerRelationship Relacionamento Preterido. entre um cliente e um parceiro no qual qualquer um deles pode ser uma conta ou um contato.

Discount 1013 FilteredDiscount Redução de preço feita a partir da lista de preços de um produto ou serviço com base na quantidade adquirida.

DiscountType 1080 FilteredDiscountType Tipo de desconto especificado como porcentagem ou quantia.

20




DuplicateRule 4414 FilteredDuplicateRule Regra usada para identificar duplicidades potenciais.

Email 4202 FilteredEmail Atividade que é entregue usando protocolos de email.

Equipment 4000 FilteredEquipment Recurso que pode ser agendado.

Fax 4204 FilteredFax Atividade que registra o resultado da chamada e o número de páginas para um fax e, opcionalmente, armazena uma cópia eletrônica do documento.

FieldSecurityProfile 1200 FilteredFieldSecurityProfile Perfil que define o nível de acesso para atributos protegidos

FixedMonthlyFiscalCalendar

2004 FilteredFixedMonthlyFiscalCalendar

Calendário fiscal mensal fixo de uma organização. Um período durante o qual as atividades financeiras de uma organização são calculadas.

Goal 9600 FilteredGoal Objetivo de destino para um usuário ou equipe por um período de tempo especificado.

GoalRollupQuery 9602 FilteredGoalRollupQuery Consulta usada para filtrar os resultados do acúmulo de meta.

Import 4410 FilteredImport Informações de status e propriedade de um trabalho de importação.

ImportFile 4412 FilteredImportFile Nome do arquivo usado para

21




importação.

ImportLog 4423 FilteredImportLog Motivo da falha e outras informações detalhadas de um registro com falha de importação.

ImportMap 4411 FilteredImportMap Mapa de dados usado na importação.

Incident 112 FilteredIncident Ocorrência da solicitação de serviço associada a um contrato.

IncidentResolution 4206 FilteredIncidentResolution Tipo especial de atividade que inclui descrição da solução, status da cobrança e duração da ocorrência.

IntegrationStatus 3000 FilteredIntegrationStatus Apenas para uso interno.

InternalAddress 1003 FilteredInternalAddress Apenas para uso interno.

Invoice 1090 FilteredInvoice Pedido que já foi cobrado.

InvoiceDetail 1091 FilteredInvoiceDetail Um item de linha em uma fatura que contém informações detalhadas de cobrança de um produto.

KbArticle 127 FilteredKbArticle Conteúdo estruturado que faz parte da base de dados de conhecimento.

KbArticleComment 1082 FilteredKbArticleComment Comentário sobre o artigo da base de dados de conhecimento.

KbArticleTemplate 1016 FilteredKbArticleTemplate Modelo de artigo da base de dados de conhecimento que contém os atributos padrão

22




de um artigo.

Lead 4 FilteredLead Oportunidade de cliente potencial ou vendas potenciais. Os clientes potenciais são convertidos em contas, contatos ou oportunidades se forem qualificados. Caso contrário, são excluídos ou arquivados.

LeadAddress 1017 FilteredLeadAddress Apenas para uso interno.

LeadCompetitors 24 FilteredLeadCompetitors Representa a tabela de interseção do leadcompetitors_associationrelationship.

LeadProduct 27 FilteredLeadProduct Representa a tabela de interseção do leadproduct_associationrelationship.

Letter 4207 FilteredLetter Atividade que rastreia a entrega de uma carta. A atividade pode conter a cópia eletrônica da carta.

List 4300 FilteredList Agrupamento de clientes existentes ou potenciais criado para fins de campanha de marketing ou vendas.

ListMember 4301 FilteredListMember Representa a tabela de interseção para os seguintes relacionamentos:

listaccount_association listcontact_association

23




listlead_association

MailMergeTemplate 9106 FilteredMailMergeTemplate Modelo de um documento de mala direta que contém os atributos padrão desse documento.

Metric 9603 FilteredMetric Tipo de medição de uma meta, como valor ou contagem de dinheiro.

MonthlyFiscalCalendar 2003 FilteredMonthlyFiscalCalendar Calendário fiscal mensal de uma organização. Um período durante o qual as atividades financeiras de uma organização são calculadas.

Opportunity 3 FilteredOpportunity Evento gerador de receita potencial ou venda para uma conta que precisa ser controlado por meio de um processo de vendas para conclusão.

OpportunityClose 4208 FilteredOpportunityClose Atividade criada automaticamente após o fechamento de uma oportunidade, contendo informações como a descrição do fechamento e a receita real.

OpportunityCompetitors 25 FilteredOpportunityCompetitors

Representa a tabela de interseção do opportunitycompetitors_associationrelationship.

OpportunityProduct 1083 FilteredOpportunityProduct Associação entre uma oportunidade e um produto.

24




OrderClose 4209 FilteredOrderClose Atividade gerada automaticamente quando um pedido é fechado.

Organization 1019 FilteredOrganization Nível superior da hierarquia de negócios do Aguardando. A organização pode ser um negócios específico, uma empresa de holding ou corporação.

Este modo de exibição contém o formato usado no Aguardando para formato de moeda, data e hora, formato de número, manipulação de número negativo, precisão decimal de preço e o dia de início da semana. Também define o período fiscal para a organização.

PhoneCall 4210 FilteredPhoneCall Atividade para rastrear um telefonema.

PluginAssembly 4605 FilteredPluginAssembly Assembly que contém um ou mais tipos de plug-in.

PluginType 4602 FilteredPluginType Tipo que herda da interface IPlugin e que está contido dentro de um assembly de plug-in.

PluginTypeStatistic 4603 FilteredPluginTypeStatistic Estatística de tipo de plug-in.

PriceLevel 1022 FilteredPriceLevel Entidade que define os níveis de preço.

Privilege 1023 FilteredPrivilege Permissão para executar uma ação no Aguardando. O

25




Aguardando verificará o privilégio e rejeita a tentativa se o usuário não possuir o privilégio.

ProcessSession 4710 FilteredProcessSession Informações que são geradas quando um diálogo é executado. Cada vez que você executar um diálogo, uma sessão de diálogo é criada.

Product 1024 FilteredProduct Informações sobre produtos e seus preços.

ProductAssociation 1025 FilteredProductAssociation Representa a tabela de interseção do productassociation_associationrelationship.

ProductPriceLevel 1026 FilteredProductPriceLevel Informações sobre como determinar o preço de um produto de acordo com o nível de preço especificado, incluindo método de preço, opção de arredondamento e tipo de desconto com base em determinada unidade de produto.

ProductSalesLiterature 21 FilteredProductSalesLiterature Representa a tabela de interseção do productsalesliterature_associationrelationship.

ProductSubstitute 1028 FilteredProductSubstitute Representa a tabela de interseção do productsubstitute_associationrelationship.

26




Publisher 7101 FilteredPublisher Um publicador de uma solução Aguardando.

PublisherAddress 7102 FilteredPublisherAddress Endereço e informações de entrega. Usado para armazenar endereços adicionais para um fornecedor.

QuarterlyFiscalCalendar 2002 FilteredQuarterlyFiscalCalendar

Calendário fiscal trimestral de uma organização. Um período durante o qual as atividades financeiras de uma organização são calculadas.

Queue 2020 FilteredQueue Uma lista de registros que exige ação como contas, ocorrências e atividades.

QueueItem 2029 FilteredQueueItem Um item específico em uma fila como registro de ocorrência ou registro de atividade.

Quote 1084 FilteredQuote Oferta formal de produtos e/ou serviços, proposta a preços específicos e condições de pagamento relacionadas, que é enviada a um possível cliente.

QuoteClose 4211 FilteredQuoteClose Atividade gerada após o fechamento de uma cotação.

QuoteDetail 1085 FilteredQuoteDetail Item de linha de produtos em uma cotação. Os detalhes incluem informações como ID, descrição, quantidade e custo do produto.

27




RecurringAppointmentMaster

4251 FilteredRecurringAppointmentMaster

O compromisso mestre de uma série de compromissos recorrentes.

RelationshipRole 4500 FilteredRelationshipRole Relacionamento Preterido. entre uma conta ou contato e uma oportunidade.

RelationshipRoleMap 4501 FilteredRelationshipRoleMap Preterido. Mapeamento dos objetos principais associados entre os quais a função no relacionamento é válida.

Report 9100 FilteredReport Resumo de dados em layout de fácil leitura.

ReportCategory 9102 FilteredReportCategory Categorias relacionadas a um relatório. Um relatório pode estar relacionado a várias categorias.

ReportEntity 9101 FilteredReportEntity Entidades relacionadas a um relatório. Um relatório pode estar relacionado a várias entidades.

ReportLink 9104 FilteredReportLink Links e dependências entre relatórios. Um relatório pode executar o detalhamento de outro relatório ou pode ter outro relatório como um sub-relatório.

ReportVisibility 9103 FilteredReportVisibility Área na qual exibir um relatório. Um relatório pode ser exibido em várias áreas.

Resource 4002 FilteredResource Usuário ou instalações/equipamentos que pode ser agendados

28




para um serviço.

ResourceGroup 4005 FilteredResourceGroup Grupo de recursos ou equipe cujos membros podem ser agendados para um serviço.

ResourceSpec 4006 FilteredResourceSpec Regra de seleção que permite ao mecanismo de agendamento selecionar um número de recursos de um pool de recursos. As regras podem ser associadas a um serviço.

RibbonCommand 1116 FilteredRibbonCommand Apenas para uso interno.

RibbonContextGroup 1115 FilteredRibbonContextGroup Apenas para uso interno.

RibbonDiff 1130 FilteredRibbonDiff Apenas para uso interno.

RibbonRule 1117 FilteredRibbonRule Apenas para uso interno.

RibbonTabToCommandMap

1113 FilteredRibbonTabToCommandMap

Apenas para uso interno.

Role 1036 FilteredRole Agrupamento de privilégios de segurança. Os usuários recebem funções que autorizam seu acesso ao Aguardando.

RollupField 9604 FilteredRollupFieldItem Campo a ser acumulado para calcular os valores reais e em andamento em relação à meta.

SalesLiterature 1038 FilteredSalesLiterature Armazenamento de literatura de vendas que pode conter um ou mais documentos.

SalesLiteratureItem 1070 FilteredSalesLiteratureItem Item no conjunto de literatura

29




de vendas.

SalesOrder 1088 FilteredSalesOrder Cotação que foi aceita.

SalesOrderDetail 1089 FilteredSalesOrderDetail Item de linha em um pedido de vendas.

SalesProcessInstance 32 FilteredSalesProcessInstance Apenas para uso interno.

SavedQuery 1039 FilteredSavedQuery Consulta ao banco de dados salva.

SdkMessage 4606 FilteredSdkMessage Mensagem com suporte do SDK do Microsoft Dynamics CRM.

SdkMessageFilter 4607 FilteredSdkMessageFilter Filtro que define quais mensagens do SDK do Microsoft Dynamics CRM são válidas para cada tipo de entidade.

SdkMessagePair 4613 FilteredSdkMessagePair Apenas para uso interno.

SdkMessageProcessingStep

4608 FilteredSdkMessageProcessingStep

Estágio no pipeline de execução que um plug-in deve executar.

SdkMessageProcessingStepImage

4615 FilteredSdkMessageProcessingStepImages


SdkMessageProcessingStepSecureConfig

4616 FilteredSdkMessageProcessingStepSecureConfig


SdkMessageRequest 4609 FilteredSdkMessageRequest Apenas para uso interno.

SdkMessageRequestField

4614 FilteredSdkMessageRequestField


SdkMessageResponse 4610 FilteredSdkMessageResponse


SdkMessageResponseFi 4611 FilteredSdkMessageRespons Apenas para uso interno.

30




eld eField

SemiAnnualFiscalCalendar

2001 FilteredSemiAnnualFiscalCalendar

Calendário representando um período semestral durante o qual as atividades financeiras de uma organização são calculadas.

Service 4001 FilteredService Atividade que representa o trabalho feito para atender à necessidade de um cliente.

ServiceAppointment 4214 FilteredServiceAppointment Atividade oferecida pela organização para atender às necessidades do cliente. Cada atividade de serviço inclui data, hora, duração e recursos necessários.

ServiceContractContacts 20 FilteredServiceContractContacts

Representa a tabela de interseção do servicecontractcontacts_associationrelationship.

ServiceEndpoint 4618 FilteredServiceEndpoint O ponto de extremidade de serviço que pode ser contatado.

SharePointDocumentLocation

9508 FilteredSharePointDocumentLocation

Bibliotecas de documentos ou pastas em um computador que esteja executando o SharePoint Server de documentos que podem ser gerenciados no Aguardando.

SharePointSite 9502 FilteredSharePointSite Site do SharePoint Server de onde os documentos podem ser gerenciados no Aguardando.

31




Site 4009 FilteredSite Local ou filial onde uma organização faz negócios. Uma organização pode ter vários locais.

Solution 7100 FilteredSolution Uma solução que contém personalizações do Aguardando.

SolutionComponent 7103 FilteredSolutionComponent Um componente de uma solução do Aguardando.

StatusMap 1075 FilteredStatusMap Contém razões de status válidas e razão do status padrão. Apenas determinadas razões de status são válidas para cada valor de status.

StringMap 1043 FilteredStringMap Contém valores numéricos válidos para itens da lista suspensa, etiquetas equivalentes para esses valores e a ordem de exibição dos itens da lista.

Subject 129 FilteredSubject Informações sobre assuntos disponíveis no Aguardando.

SystemForm 1030 FilteredSystemForm Personalizações de entidade de propriedade da organização, incluindo layout de formulário e painéis.

SystemUser 8 FilteredSystemUser Pessoa com acesso ao Aguardando e quem pode ter registros.

SystemUserProfiles 1202 FilteredSystemUserProfiles Representa a tabela de interseção do

32




systemuserprofiles_associationrelationship.

SystemUserRoles 15 FilteredSystemUserRoles Representa a tabela de interseção do systemuserroles_associationrelationship.

Task 4212 FilteredTask Atividade genérica representando o trabalho que precisa ser feito.

Team 9 FilteredTeam Coleção de usuários do sistema que rotineiramente colaboram. Equipes podem ser utilizadas para simplificar o compartilhamento de registros e fornecer aos membros da equipe um acesso comum aos dados da organização, quando esses membros de equipe pertencerem a diferentes unidades de negócios.

TeamMembership 23 FilteredTeamMembership Representa a tabela de interseção do teammembership_associationrelationship.

TeamProfiles 1203 FilteredTeamProfiles Representa a tabela de interseção do teamprofiles_associationrelationship.

TeamRoles 40 FilteredTeamRoles Representa a tabela de interseção do teamroles_associationrelationship.

33




Template 2010 FilteredTemplate Modelo para mensagem de email que contém os atributos padrão de um email.

Territory 2013 FilteredTerritory Região representa regiões de vendas.

TransactionCurrency 9105 FilteredTransactionCurrency Moeda na qual uma transação financeira é realizada.

UnresolvedAddress 2012 FilteredUnresolvedAddress Apenas para uso interno.

UoM 1055 FilteredUoM Unidade de medida.

UoMSchedule 1056 FilteredUoMSchedule Agrupamento de unidades.

UserFiscalCalendar 1086 FilteredUserFiscalCalendar Calendário fiscal personalizado usado para controlar cotas de vendas.

UserQuery 4230 FilteredUserQuery Consulta ao banco de dados salva pertencente a um usuário.

UserSettings 150 FilteredUserSettings Configurações preferenciais do usuário.

WebResource 9333 FilteredWebResource Dados equivalentes aos arquivos utilizados no desenvolvimento da Web. Recursos da Web fornecem os componentes do cliente que são usados para fornecer elementos da interface do usuário.

Workflow 4703 FilteredWorkflow Conjunto de regras lógicas que definem as etapas necessárias para automatizar um processo empresarial

34




específico, uma tarefa ou um conjunto de ações a ser executado.

WorkflowDependency 4704 FilteredWorkflowDependency Preterido. Dependências de um processo.

WorkflowLog 4706 FilteredWorkflowLog Log usado para acompanhar a execução do processo.


[M2RG]]Editar um relatório padrão ou criar um relatório do Reporting Services baseado em SQLOs relatórios padrão no Aguardando são todos Reporting Services baseados em SQL. Os relatórios padrão não podem ser editados com o Assistente de Relatório. Para editar relatórios padrão que não sejam os criados por meio do Assistente de Relatório, você precisará de um ambiente de desenvolvimento de relatório.

1. Certifique-se de ter o direito de acesso Administrador do Sistema ou Personalizador de Sistema ou permissões equivalentes. Para obter mais informações: Permissions required for customization tasks

Verifique sua função de segurança

a. Siga as etapas em Exibir seu perfil de usuário.b. Não possui as permissões corretas? Entre em contato com o administrador

do sistema.

35

2. Identifique o relatório existente com o design que mais se assemelha ao novo relatório.

Se estiver usando o aplicativo Web do CRM

a. Na barra de navegação, clique ou toque em Microsoft Dynamics CRM. Em seguida, selecione uma área de trabalho: Vendas, Serviço ou Marketing. O nome da área de trabalho é exibido na barra de navegação.

b. Clique ou toque no nome da área de trabalho e clique ou toque em Relatórios.

Se estiver usando o CRM para Outlook

a. No painel de navegação, expanda a organização se necessário e expanda Local de Trabalho.

b. Expanda Minhas Atividades e clique ou toque em Relatórios.

3. Baixe o relatório do Aguardando para um computador configurado com o ambiente de desenvolvimento de relatórios. Para obter mais informações: Download the report from Microsoft Dynamics CRM

4. Em um produto que usa o IDE (ambiente de desenvolvimento integrado) do Visual Studio, abra o relatório e faça as alterações necessárias.

5. Adicione o relatório atualizado ao Aguardando. Para obter mais informações: Add the report to Microsoft Dynamics CRM

Para compartilhar o relatório atualizado, consulte as instruções em Share your report with other users, teams or organization.

Consulte tambémCreate, edit, or copy a report using the Report WizardCustomizing and Organizing Reports

[M2RG]Ambiente de desenvolvimento de relatório para relatórios personalizados com base em Fetch e SQLVocê deve configurar o ambiente de desenvolvimento de relatório antes de trabalhar com um relatório personalizado. Há dois tipos de relatórios personalizados: baseado em Fetch e baseado em SQL. Os relatórios personalizados baseados em Fetch usam consultas FetchXML, que são de propriedade do Aguardando, para recuperar dados de relatórios. Uso de relatórios

36

personalizados com baseados em consultas SQL e visualizações filtradas para recuperar dados de relatório.

Este artigo descreve os componentes que você deve instalar para configurar o ambiente de desenvolvimento para relatórios baseados em Fetch. Outros recursos que são úteis ao trabalhar com relatórios baseados em Fetch são listados.

Componentes necessários para relatórios baseados em Fetch O Microsoft Visual Studio 2008 ou Microsoft Visual Studio 2010 ou qualquer outro produto

que use o ambiente de desenvolvimento integrado do Visual Studio .NET, como Microsoft Visual Basic .NET.

Business Intelligence Development Studio, que pode ser instalado usando o CD do Microsoft SQL Server 2008. O Business Intelligence Development Studio exige o Visual Studio .NET 2008.

-OU-

Ferramentas de dados do SQL Server e Visual Studio 2010. Você pode instalar o Ferramentas de dados do SQL Server da Rede do desenvolvedor Microsoft.

O Aguardando Extensão de Criação de Relatórios pode ser instalado do Aguardando DVD de Instalação do Servidor ou do Microsoft Dynamics CRM Report Authoring Extension. Aguardando Extensão de Criação de Relatórios é necessário na criação de relatórios baseados em Fetch usando o Business Intelligence Development Studio. Para obter mais informações: Instruções de Instalação do Microsoft Dynamics CRM Report Authoring Extension

Extensões de Relatório do Microsoft Dynamics CRM, que pode ser instalado do Aguardando DVD de Instalação do Servidor. Extensões de Relatório do Microsoft Dynamics CRM é necessário para criar, executar e agendar relatórios baseados em Fetch no Aguardando. Para obter mais informações: Instalar as Extensões de Relatório do Microsoft Dynamics CRM

Certifique-se de que um direito de acesso atribuído à sua conta tenha os privilégios Publicar Relatórios e Adicionar Relatórios do Reporting Services. Para obter mais informações: Criar ou editar uma função de segurança

Componentes necessários para relatórios de Reporting Services com base em SQL O Microsoft Visual Studio 2008 ou Microsoft Visual Studio 2010 ou qualquer outro produto

que use o ambiente de desenvolvimento integrado do Visual Studio .NET, como Microsoft Visual Basic .NET.

Designer de Relatórios do Reporting Services. Ele pode ser instalado a partir do CD Microsoft SQL Server 2008 e requer o Visual Studio .NET 2008.

Verifique se um direito de acesso atribuído à sua conta inclui os privilégios Publicar Relatórios e Adicionar Relatórios do Reporting Services.

Importante

37


http://technet.microsoft.com/en-us/library/hh699807.aspx





http://msdn.microsoft.com/en-us/library/hh500335(v=vs.103).aspx

Outras documentações úteisAlém dos componentes necessários, a seguinte documentação é útil:

Criar relatórios do Microsoft Dynamics CRM com o SQL Server Reporting Services Livros Online do Microsoft SQL Server 2008 Reporting Services

Consulte também[M2RG]]Editar um relatório padrão ou criar um relatório do Reporting Services baseado em SQL

[M2RG]Criar um relatório personalizado baseado em Fetch

Customize and organize reports

[M2RG]Criar um relatório personalizado baseado em FetchVocê pode criar vários relatórios usando o Assistente de Relatórios. Entretanto, para criar relatórios complexos (como relatórios detalhados ou sub-relatórios) ou para alterar o layout e a formatação dos relatórios, crie um relatório personalizado baseado em Fetch usando o Business Intelligence Development Studio ou Ferramentas de dados do SQL Server. Para criar um relatório complexo, é preciso ter um ambiente de desenvolvimento de relatório. Para obter mais informações: [M2RG]Ambiente de desenvolvimento de relatório para relatórios personalizados com base em Fetch e SQL

1. Certifique-se de ter o direito de acesso Administrador do Sistema ou Personalizador de Sistema ou permissões equivalentes. Para obter mais informações: Permissions required for customization tasks

Verifique sua função de segurança

a. Siga as etapas em Exibir seu perfil de usuário.b. Não possui as permissões corretas? Entre em contato com o administrador

do sistema.

2. Abra o Business Intelligence Development Studio ou Ferramentas de dados do SQL Server.

3. Crie um projeto de servidor de relatório.

38



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

O Assistente de Relatório é aberto.

5. Na página Bem-vindo ao Assistente de Relatório, clique em Avançar.6. Na página Selecionar a Fonte de Dados, clique em Nova Fonte de Dados e

especifique os seguintes detalhes: Nome. Digite um nome para a fonte de dados. Tipo. Selecione Aguardando Fetch como o tipo de origem de dados. Cadeia de conexão. Digite a cadeia de conexão da fonte de dados.

A cadeia de conexão deve ser: <ServerURL>;<OrganizationUniqueName>;<HomeRealmURL>

Nela, apenas <ServerURL> é obrigatório.

ObservaçãoPara localizar o nome exclusivo da organização, no Painel de Navegação, clique em Configurações, em Personalizações e em Recursos do Desenvolvedor.Se um nome de organização não for especificado, a primeira organização a que o usuário (que está realizando esta consulta) pertence será usada. Se a URL de realm inicial não for especificada, o valor será recuperado do valor de Registro "HKLM\SOFTWARE\Microsoft\MSCRMBidsExtensions\HomeRealmUrl".

7. Clique em Avançar.8. Especifique as credenciais de conexão para o Microsoft Dynamics CRM Server 2011 e

clique em OK.9. Na página Criar a consulta, digite a consulta do Extensão de Criação de Relatórios do

Microsoft Dynamics CRM a ser usada para o relatório.

Você pode filtrar os registros usando a Localização Avançada no Aguardando e usar essa consulta aqui, ou pode escrever sua própria consulta. Para obter uma consulta do Aguardando, use a Localização Avançada para localizar os registros e clique em Baixar Fetch XML. Cole a consulta do arquivo baixado para a área de consulta.

ObservaçãoAs consultas do Extensão de Criação de Relatórios do Microsoft Dynamics CRM não oferecem suporte ao uso de "Propriedade Gerenciada" como um atributo de tipo de dados.

10. Clique em Avançar.11. Especifique se deseja criar um relatório tabular ou um relatório de matriz.12. Projete o relatório.13. Selecione um estilo a ser aplicado ao relatório e clique em Avançar.14. Verifique se os campos desejados serão incluídos no relatório e, em seguida, nomeie o

39

relatório.

Para mais informações sobre a criação de relatórios baseados em Fetch no Aguardando, consulte Criar, editar ou copiar um relatório usando o Assistente de Relatório. Para obter informações detalhadas sobre criar relatórios usando o Assistente de Relatório no Business Intelligence Development Studio para criar relatórios, consulte Criando um relatório usando o Assistente de Relatório e Como criar um relatório (Reporting Services).

15. Adicione o novo relatório ao Aguardando. Para obter mais informações: Adicionar o relatório ao Microsoft Dynamics CRM

Para compartilhar o novo relatório, consulte as instruções em Share your report with other users.

Consulte tambémCustomize and Organize Reports

Usar parâmetros em relatóriosUse os parâmetros nos relatórios para controlar os dados recuperados por um relatório solicitando o usuário por um valor ou um conjunto de valores quando o usuário executar o relatório. A consulta do conjunto de dados recupera apenas os dados que são pedidos pelo usuário. Você também pode adicionar parâmetros especiais e ocultos nos relatórios que não solicitam o usuário pela entrada, mas pode ser usado para operações como filtragem de dados e detalhamento dinâmico. Para obter mais informações sobre como usar parâmetros em relatórios, consulte Use parâmetros em relatórios.

O tamanho máximo dos valores de parâmetro no Aguardando é de 2.000 caracteres. Por exemplo, se você executar um relatório e criar um filtro de dados na interface de usuário Localização Avançada, a expressão de filtragem resultante transmitida para um parâmetro de filtragem não pode exceder 2.000 caracteres. Não há limite máximo para o número de parâmetros que você pode especificar. Entretanto, você pode precisar limitar o tamanho da cadeia de caracteres na linha da URL e o número de parâmetros para atender aos requisitos do navegador específico.

Neste tópicoAdicionando parâmetros

Parâmetros ocultos

Observação

40

http://msdn.microsoft.com/en-us/library/gg309583








Adicionando parâmetrosVocê pode adicionar parâmetros a um relatório para definir os parâmetros individuais do relatório, transmitir informações através de uma consulta ou fornecer acesso às configurações do usuário, como parâmetros CRM_CurrencySymbol e CRM_CurrencyPositivePattern.

O <ReportParameter> é um elemento no arquivo de definição de relatório (RDL) usado para descrever um parâmetro individual no relatório. O <QueryParameter> contém informações sobre um programa individual transmitido para a fonte de dados como parte de uma consulta. O seguinte código XML levado do arquivo RDL do relatório Resumo da Conta demonstra como usar os parâmetros ReportParameter e QueryParameter.

<ReportParameter Name="FilteredAccount">

<DataType>String</DataType>

<Nullable>true</Nullable>

<DefaultValue>

<Values>

<Value>select account0.* from FilteredAccount as "account0"</Value>

</Values>

</DefaultValue>

<AllowBlank>true</AllowBlank>

<Prompt>FilteredAccount</Prompt>

<Hidden>true</Hidden>

</ReportParameter>

<Query>

<rd:UseGenericDesigner>true</rd:UseGenericDesigner>

<CommandText>declare @sql as nVarchar(max)

set @sql = '

SELECT top 10 CAST(accountid as nvarchar(100)) as AccountID,

name, '''' as None

FROM (' + @FilteredAccount + ') as fa'

exec(@sql)

</CommandText>

<QueryParameters>

<QueryParameter Name="@FilteredAccount">

<Value>=Parameters!FilteredAccount.Value</Value>

41



</QueryParameter>

</QueryParameters>

<DataSourceName>CRM</DataSourceName>

</Query>

Os exemplos a seguir mostram como usar os parâmetros QueryParameter e ReportParameter em um relatório baseado em Fetch:

<ReportParameter Name="FilteredAccount">


<Prompt>Filtered Account</Prompt>

<DefaultValue>

<Values>

<Value>

<fetch version="1.0" output-format="xml-platform"

mapping="logical" distinct="false">

<entity name="account">

<all-attributes/>

</entity>

</fetch>

</Value>

</Values>

</DefaultValue>

</ReportParameter>

<Query>

<DataSourceName>DataSource1</DataSourceName>

<CommandText>

<fetch>

<entity name="account" enableprefiltering="true"

prefilterparametername="FilteredAccount" >

<attribute name="accountid" />

<attribute name="name" />

</entity>

</fetch>

</CommandText>

42

<QueryParameters>

<QueryParameter Name="FilteredAccount">

<Value>=Parameters!FilteredAccount.Value</Value>

</QueryParameter>

</QueryParameters>

<rd:UseGenericDesigner>true</rd:UseGenericDesigner>

</Query>

Parâmetros ocultosO Designer de Relatórios no Business Intelligence Development Studio tem suporte integrado para parâmetros ocultos. Além disso, você pode ocultar parâmetros adicionando um CRM_ prefix ao nome do parâmetro em um relatório do Aguardando. Por padrão, os parâmetros com um CRM_ prefix são ocultos quando o relatório for publicado através do Aguardando. Ao executar o relatório, você não será solicitado a inserir valores de parâmetro para os parâmetros ocultos.

Parâmetros especiaisA tabela a seguir mostra os parâmetros ocultos especiais que podem ser usados nos relatórios.

Parâmetro Descrição

CRM_FilterText Contém o valor texto de filtro que um usuário de relatório cria interativamente no Visualizador de Relatórios quando o usuário executa um relatório. O parâmetro está em uma caixa de texto de resumo do filtro localizada no cabeçalho do relatório. O valor inicial é definido para o filtro padrão.

CRM_URL Definir a URL do aplicativo Web do Aguardando. Use esse parâmetro ao detalhar com o Aguardando.

CRM_FilteredEntity Use em uma expressão de consulta para habilitar a pré-filtragem de dados (com a Localização Avançada).

Você precisa criar todos os parâmetros em um relatório antes de poder consultá-los. Os valores destes parâmetros especiais são preenchidos pelo Aguardando ao executar o relatório.

43

Parâmetros de formato adicionaisA tabela a seguir contém parâmetros adicionais que podem ser usados nos relatórios. Entre eles são os parâmetros que oferecem acesso às informações de configurações do Número do usuário. Você pode usar esses valores para formatar e exibir os valores numéricos. Esses parâmetros são semelhantes aos valores especificados na Classe NumberFormatInfo. Use esses parâmetros nos relatórios personalizados para formatar os dados de acordo com as configurações do usuário.


CRM_FullName O nome completo do usuário em nome de quem o relatório está sendo executando.

CRM_UserTimeZone Nome de fuso horário do usuário, por exemplo, Horário Padrão do Pacífico.

CRM_UILanguageId Localidade atual (LCID) do usuário.

CRM_YearStartWeekCode A primeira semana do ano usada no Microsoft Dynamics CRM 2013.

CRM_WeekStartDayCode O primeiro dia da semana usado no do CRM 2013.

CRM_FiscalCalendarStart A data de início do ano fiscal usado no do CRM 2013.

CRM_FiscalPeriodType Especifica como o ano fiscal é dividido, trimestral, mensal, anualmente, etc.

CRM_FiscalYearDisplayCode Especifica se o nome do ano fiscal será exibido com base em sua data de início ou de término.

CRM_FiscalYearPeriodConnect Especifica como o ano fiscal e o período fiscal são conectados ao exibir em conjunto.

CRM_FiscalYearFormat Especifica como o nome do ano fiscal será exibido.

CRM_FiscalPeriodFormat Especifica como o período fiscal será exibido.

CRM_FiscalYearPrefixFormat Especifica se um prefixo será anexado ao ano fiscal quando exibido.

CRM_FiscalYearSuffixFormat Especifica se um sufixo será anexado ao ano fiscal quando exibido.

CRM_CurrencyDecimalPrecision A precisão decimal da moeda.

CRM_CurrencySymbol O símbolo da moeda da organização.

44



CRM_CurrencyPositivePattern O padrão de formato para valores de moeda positivos.

CRM_CurrencyNegativePattern O padrão de formato para valores de moeda negativos.

CRM_NumberDecimalDigits O número de casas decimais a ser usado em valores numéricos.

CRM_NumberDecimalSeperator A cadeia de caracteres usada como o separador decimal em valores numéricos.

CRM_NumberNegativePattern O padrão de formato para valores de números negativos.

CRM_NumberGroupSizes O número de dígitos em cada grupo à esquerda dos decimais nos valores numéricos.

CRM_NumberGroupSeperator A cadeia de caracteres que separa os grupos de dígitos à esquerda dos decimais nos valores numéricos.

CRM_DateSeperator A cadeia de caracteres que separa os componentes de uma data, como ano e mês e dia.

CRM_TimeSeperator A cadeia de caracteres que separa os componentes de uma hora, como hora, minutos e segundos.

CRM_AMDesignator A cadeia de caracteres que separa os componentes de uma hora, como hora, minutos e segundos

CRM_PMDesignator O designador para as horas que são “post meridiem" (PM).

CRM_ShortDatePattern O padrão de formato para um valor de data curto associado com o padrão do formato “d”.

CRM_LongDatePattern O padrão de formato para um valor de data longo associado com o padrão do formato “D”.

CRM_ShortTimePattern O padrão de formato para um valor de hora curto associado com o padrão do formato “t”.

CRM_MonthDayPattern O padrão de formato para valores de mês e dia associados com os padrões de formato "m" e

45


"M".



Adicionar navegação de relatório

Use filtros em relatórios

Use filtros em relatóriosRelatórios que retornam grandes conjuntos de dados podem ser difíceis de usar e podem causar problemas de desempenho. Para limitar os dados apresentados em um relatório, use filtros de dados.

Além da filtragem de dados suportada pelo Reporting Services, o Aguardando suporte a pré-filtragem de dados. É possível usar a pré-filtragem de dados para:

Executar relatórios contextuais refinando o escopo de um relatório para retornar os dados mais relevantes.

Recuperar e exibir um conjunto de resultados com mais rapidez porque somente os dados mais relevantes são retornados.

Permitir que o relatório seja filtrado usando o recurso Localização Avançada.

Neste tópicoHabilitar a pré-filtragem de dados nos relatórios baseados em SQL

Habilitar a pré-filtragem de dados nos relatórios baseados em fetch

Transmitindo filtros no resumo da filtragem

Filtros padrões

Habilitar a pré-filtragem de dados nos relatórios baseados em SQLHá duas maneiras como você pode habilitar a pré-filtragem de dados nos relatórios baseados em SQL do Aguardando: automático e explícito.

46

Pré-filtragem automáticaA pré-filtragem de dados automática é adequada para consultas simples. Para habilitar a pré-filtragem de dados automática em um relatório, você pode criar um nome de tabelas de entidade nas consultas utilizando o nome de alias que começa com CRMAF_.

Por exemplo, a tabela a seguir mostra uma consulta simples alterada para habilitar a pré-filtragem na entidade Account.

Consulta sem pré-filtragem Consulta modificada com a pré-filtragem automática habilitada

SELECT <column1>, <column2>, <columnN>

FROM FilteredAccount;


FROM FilteredAccount AS

CRMAF_FilteredAccount;

Ao habilitar a funcionalidade de pré-filtragem de dados automática usando o prefixo CRMAF_, o Aguardando modifica a consulta para incluir um parâmetro (por exemplo, P1) quando for carregada no Aguardando, conforme mostrado na seguinte tabela.

Consulta com pré-filtragem automática Modificado porAguardando



CRMAF_FilteredAccount;


FROM (@P1) AS CRMAF_FilteredAccount;

O Aguardando passará uma consulta para o parâmetro P1 dependendo do modo como o relatório estiver sendo filtrado. Em outras palavras, a pré-filtragem de dados automática atua como subconsultas na consulta existente.

Os exemplos a seguir demonstram como o Aguardando transmite consultas para o parâmetro (P1) de acordo com os diferentes requisitos de filtragem. Nestes exemplos, supõe que você está executando o relatório na área Relatórios no Aguardando e usar a opção de filtragem de dados.

Exemplo 1: Se quiser exibir somente as contas ativas, a consulta resultante deve ser a seguinte:


FROM (SELECT FilteredAccount.* FROM FilteredAccount WHERE statecode = 0)

AS CRMAF_FilteredAccount

Exemplo 2: Se estiver em uma conta específica e executar o relatório, a consulta resultante deve ser a seguinte:


FROM (SELECT FilteredAccount.* FROM FilteredAccount WHERE AccountId =

'<CurrentAccountId>')


47

Exemplo 3: Se você estiver vendo uma lista de contas três selecionadas e selecionar a opção para executar o relatório para os registros selecionados, a consulta resultante deve ser a seguinte:


FROM (SELECT FilteredAccount.* FROM FilteredAccount WHERE AccountId in ('<1stAccountId>',

'<2ndAccountId>', '<3rdAccountId>')


Quando qualquer nome da tabela de entidade é nomeado, a interface do usuário Localização Avançada é incluída automaticamente no relatório implantado quando for executada no Aguardando.

Para nomear um nome da tabela de entidade no Construtor de Consultas, clique com o botão direito em cada tabela em seu relatório, clique em Propriedades e insira o valor do alias no formulário CRMAF_FilteredEntity, por exemplo, CRMAF_FilteredAccount.

Limitação de pré-filtragem automáticaQuando você usar o prefixo CRMAF_ para habilitar a pré-filtragem automática, o Aguardando adiciona um parâmetro na consulta. Com um consulta mais complexa, como uma consulta que usa declarações UNION, isso poderá causar resultados inesperados porque o Aguardando pode adicionar apenas o parâmetro na primeira consulta.

Por exemplo, considere a seguinte consulta que contém declarações UNION:


FROM FilteredAccount AS CRMAF_FilteredAccount

WHERE address1_stateorprovince = ‘FL'

UNION



WHERE address1_stateorprovince = 'CA'

Ao carregar o relatório, o Aguardando pode filtrar apenas a primeira consulta usando o parâmetro. Isso resulta na filtrar não ser aplicada à segunda consulta:


FROM (@P1) AS CRMAF_FilteredAccount WHERE address1_stateorprovince = 'FL'

UNION




No exemplo acima, durante a execução do relatório na área Relatórios no Aguardando e ao escolher o filtro como receita anual maior que 1.000.000, o Aguardando transmitirá uma consulta para o parâmetro P1 a seguir:

48


FROM (SELECT FilteredAccount.* from FilteredAccount where AnnualRevenue > 1000000) AS

CRMAF_FilteredAccount

WHERE address1_stateorprovince = 'FL'

UNION




Isso implica que a consulta retornaria apenas as contas na Flórida com uma receita anual superior a $1.000.000 e todas as contas na Califórnia, que não foi o que você pretendeu. Você queria exibir todas as contas na Flórida e Califórnia com a receita anual superior a $1.000.000.

Ao baixar o relatório do Aguardando e abrir no Microsoft Visual Studio, você verá a versão original do relatório carregado no Aguardando. Ao baixar o relatório diretamente do Microsoft SQL Server Reporting Services, você perceberá que o Aguardando modificou uma consulta, mas não colocou o parâmetro onde desejado.

Para consultas complexas como essa, você deve usar a pré-filtragem explícita.

Pré-filtragem explícitaPara consultas complexas como consultas usando declarações UNION, talvez seja necessário usar a pré-filtragem explícita. Diferente da pré-filtragem automática, o Aguardando não reescreve a consulta de relatório passando valores para os parâmetros durante a pré-filtragem explícita quando o relatório for carregado no Aguardando. Você deve executar explicitamente as alterações necessárias no relatório adicionando o parâmetro de pré-filtragem ao relatório e referenciando o parâmetro na consulta. Você pode executar a consulta usando o SQL dinâmico.

Quando você usa o SQL dinâmico, filtrar através da Localização Avançada está habilitado ao criar um parâmetro oculto chamado CRM_FilteredEntity, por exemplo, CRM_FilteredAccount, e usando este parâmetro em uma expressão de consulta do SQL dinâmico. Esse parâmetro habilita a filtragem nos dados da tabela obtidos da exibição filtrada especificada.

Levando o mesmo exemplo discutido anteriormente para realçar a limitação da pré-filtragem automática, a tabela a seguir mostra uma consulta com a pré-filtragem automática modificada para usar a pré-filtragem explícita utilizando o SQL dinâmico. Também supõe que durante a execução do relatório na área Relatórios no Aguardando, o filtro foi aplicado como a receita anual superior a 1.000.000.

Consulta com pré-filtragem automática Consulta modificada para usar a pré-filtragem explícita




DECLARE @SQL nvarchar(4000)

DECLARE @CRM_FilteredAccount nvarchar(2000)

Set @CRM_FilteredAccount = 'Select

49

Consulta com pré-filtragem automática Consulta modificada para usar a pré-filtragem explícita

WHERE address1_stateorprovince = ‘FL'

UNION





FilteredAccount.* FROM FilteredAccount where

AnnualRevenue > 1000000'

SET @SQL = 'SELECT <column1>, <column2>,

<columnN>

FROM ('+@CRM_FilteredAccount+') AS FA where

address1_stateorprovince = ''FL''

UNION


FROM ('+@CRM_FilteredAccount+') as CA where

address1_stateorprovince = ''CA'' '

EXEC (@SQL)

A maioria dos relatórios baseados em SQL padrão do Aguardando usa a opção de pré-filtragem explícita.

Habilitar a pré-filtragem de dados nos relatórios baseados em fetchOs relatórios baseados em fetch suportam apenas a pré-filtragem de dados automática Um relatório pode ter vários conjuntos de dados e várias consultas FetchXML. Um conjunto de dados oferece suporte a consultas FetchXML. . Para habilitar a pré-filtragem na entidade primária ou vinculada em um relatório baseado em fetch, você deve definir o valor do parâmetro enableprefiltering para “1 " e especificar um nome de parâmetro na propriedade prefilterparametername. O nome do parâmetro deve ser iniciado por “CRM_” para como um parâmetro oculto. Como o relatório baseado em SQL, esse parâmetro especificado na consulta FetchXML age como uma subconsulta dentro da consulta FetchXML e a subconsulta é construída com o valor especificado pelo usuário na área Localização Avançada para executar um relatório.

O exemplo a seguir mostra como habilitar a pré-filtragem para a entidade primária na consulta FetchXML:

<CommandText><fetch distinct="false" mapping="logical">

<entity name="account" enableprefiltering="1"

prefilterparametername="CRM_FilteredAccount">



Observação

50

</entity></fetch></CommandText>

<DataSourceName>CRM</DataSourceName>

De maneira semelhante, você pode habilitar a pré-filtragem na entidade vinculada. Também é possível especificar uma condição de pré-filtragem diferente para a entidade vinculada na consulta FetchXML por um nome exclusivo e diferente para o nome do parâmetro na propriedade prefilterparametername.

Se você estiver alterando manualmente uma definição de relatório baseada em fetch sem usar o Assistente de Relatório no aplicativo Web Business Intelligence Development Studio ou Aguardando para habilitar a pré-filtragem em entidades primárias e vinculadas, certifique-se de:

1. Definir o valor do parâmetro enableprefiltering para 1 para a entidade ou as entidades vinculadas exibidas e especificar um nome exclusivo para a propriedade prefilterparametername.

<fetch distinct="false" mapping="logical">

<entity name="account" enableprefiltering="1" prefilterparametername="CRM_FilteredAccount">

2. Criar um parâmetro de consulta correspondente com o mesmo nome conforme especificado para a propriedade prefilterparametername. Certifique-se de que o nome do parâmetro inicie com CRM_ para especificar como um parâmetro oculto.

<QueryParameters>

<QueryParameter Name="CRM_FilteredAccount">

<Value>=Parameters!CRM_FilteredAccount.Value</Value>

</QueryParameter>

3. Criar um parâmetro de relatório correspondente com o mesmo nome.

<ReportParameters>

<ReportParameter Name="CRM_FilteredAccount">


<Prompt>CRM Filtered Account</Prompt>

</ReportParameter>

</ReportParameters>

Transmitindo filtros no resumo da filtragemUm resumo de filtro exibe o valor do filtro usado quando um relatório é executado. Nos relatórios do Aguardando, é exibido como um item de relatório da caixa de texto no cabeçalho do relatório que contém o valor de texto do filtro. Quando o usuário executar o relatório, o Visualizador de Relatórios exibe um botão Editar Filtro. Quando o botão é clicado, permite o usuário definir um filtro de dados. Um exemplo de um resumo de filtro pode ser encontrado no relatório Resumo do Usuário incluído com o Aguardando.

51

Para adicionar um resumo de filtro para um relatório, siga estas etapas:

Criar um parâmetro de cadeia de caracteres oculto chamado CRM_FilterText. Adicionar um item de relatório da caixa de texto ao relatório e definir a propriedade Value

como o seguinte: =Parameters!CRM_FilterText.Value.

Quando o relatório for executado, o valor do parâmetro CRM_FilterText será definido pelo sistema como o texto do filtro atual.

Filtros padrõesQuando você publicar um relatório, é possível definir um filtro padrão. Para todos os relatórios criados com o assistente de relatório, se você não definir um filtro padrão, esse filtro será definido automaticamente para todos os registros da entidade modificada nos últimos 30 dias. Se o procedimento para definir um filtro de relatório padrão, consulte Publicar relatórios.

Consulte tambémUsar parâmetros em relatórios


RDL sandboxing para o Microsoft Dynamics CRM OnlineNo Microsoft Dynamics CRM Online, os relatórios são executados no modo de área restrita. Isso é feito habilitando o RDL Sandboxing no Microsoft SQL Server Reporting Services. O RDL Sandboxing permite detectar e restringir o uso de tipos específicos de recursos. Como resultado, determinados recursos no Microsoft Dynamics CRM Online podem não estar disponíveis. Para obter mais informações, consulte Habilitando e desabilitando o RDL Sandboxing.

As definições de configuração do RDL Sandboxing no Microsoft Dynamics CRM Online atual são descritas nas seguintes seções neste tópico.

Neste tópicoLimites do comprimento do resultado de matriz e comprimento do resultado da cadeia de caracteres

Tipos permitidos e membros negados

Membros negados comuns

Limites do comprimento do resultado de matriz e comprimento do resultado da cadeia de caracteresO número máximo de itens permitidos em um valor de retorno de matriz para uma expressão RDL é aumentado de 250 para 102400. O número máximo de itens permitidos em um valor de

52


retorno de cadeia de caracteres para uma expressão RDL também é aumentado de 250 para 102400. Isso permitirá incluir imagens e logotipos com tamanhos de até 75 KB, que serão armazenados em um banco de dados com codificação Base64.

Tipos permitidos e membros negadosO recurso RDL Sandboxing permite criar uma lista de tipos aprovados e uma lista de membros negados. A lista de tipos aprovados é chamada de lista de permissão. A lista de membros negados que não são permitidos nas expressões RDL é chamada de lista de bloqueio.

A tabela a seguir contém uma lista de tipos permitidos e membros negados disponíveis no modo de área restrita no Microsoft Dynamics CRM Online.

Tipos permitidos Membros negados

System.Array CreateInstance

Finalize

GetType

MemberwiseClone

Resize

System. DateTime FromBinary

GetDateTimeFormats

GreaterThan

GreaterThanOrEqual

System.Object GetType

MemberwiseClone

ReferenceEquals

System.DbNull Finalize

MemberwiseClone

GetObjectData

GetTypeCode

53


System.Math BigMul

DivRem

IEEERemainder

E

PI

Pow

System.String

System.TimeSpan Hours

TicksPerDay

TicksPerHour

TicksPerMillisecond

TicksPerMinute

TicksPerSecond

Zero

TryParse

TryParseExact

System.Convert ChangeType

IConvertible.ToBoolean

IConvertible.ToByte

IConvertible.ToChar

IConvertible.ToDateTime

IConvertible.ToDecimal

IConvertible.ToDouble

IConvertible.ToInt16



IConvertible.ToSByte

54


IConvertible.ToSingle

IConvertible.ToType

IConvertible.ToUInt16



System. StringComparer Criar

Finalize

System. TimeZone Finalize

GetType

MemberwiseClone

System. Uri Unescape

Parse

Escape

Finalize

System. UriBuilder Finalize

System.Globalization.CultureInfo ClearCachedData

System.Text.RegularExpressions.Match Empty

NextMatch

Resultado

Synchronized

System.Text.RegularExpressions.Regex CacheSize

55


CompileToAssembly

GetGroupNames

GetGroupNumbers

GetHashCode

Unescape

UseOptionC

UseOptionR

capnames

caps

capsize

capslist

roptions

pattern

factory

IsMatch

Matches

Iserializable.GetObjectData

InitializeReferences

RightToLeft

Opções

Microsoft.VisualBasic. Constants vbAbort

vbAbortRetryIgnore

vbApplicationModal

vbArchive

vbBinaryCompare

vbCancel

56


vbCritical

vbDefaultButton1

vbDefaultButton2

vbDefaultButton3

vbExclamation

vbFormFeed

vbGet

vbHidden

vbHide

vbHiragana

vbIgnore

vbInformation

vbKatakana

vbLet

vbLinguisticCasing

vbMaximizedFocus

vbMinimizedFocus

vbMinimizedNoFocus

vbMsgBoxHelp

vbMsgBoxRight

vbMsgBoxRtlReading

vbMsgBoxSetForeground

vbNo

vbNormal

vbNormalFocus

vbNormalNoFocus

vbObjectError

vbOK

57


vbOKCancel

vbOKOnly

vbQuestion

vbReadOnly

vbRetry

vbRetryCancel

vbSet

vbSystem

vbSystemModal

VbTypeName

vbVolume

Zero

Microsoft.VisualBasic. ControlChars Finalize

GetType

MemberwiseClone

Microsoft.VisualBasic. Conversion Err

ErrorToString

Fix

Microsoft.VisualBasic. DateInterval Finalize

GetType

MemberwiseClone

Microsoft.VisualBasic. Financial Finalize

GetType

MemberwiseClone

IRR

58


NPV

MIRR

Microsoft.VisualBasic. Interaction AppActivate

Beep

CallByName

Comando

CreateObject

Environ

Finalize

GetAllSettings

GetObject

GetSetting

GetType

InputBox

MemberwiseClone

MsgBox

SaveSetting

Shell

Choose

Switch

Microsoft.VisualBasic. Informações Erl

Err

IsError

IsDBNull

59


Lbound

Ubound

SystemTypeName

Microsoft.VisualBasic. Strings Finalize

GetType

MemberwiseClone

Lset

Rset

Microsoft.Crm.Reporting.RdlHelper

Membros negados comuns A tabela a seguir apresenta uma lista de membros negados comuns em tipos permitidos:

DateString

Duração

Equality

Igual a

Erl

Filtrar

GetChar

GroupNameFromNumber

GroupNumberFromName

Int

MaxValue

MinValue

Negate

60

Timer

TimeString

ToBinary

Finalize

GetType

MemberwiseClone


Formatar o conteúdo de relatórioVocê pode obter os valores de formatação para data, hora, número e moeda usando a função SQL fn_GetFormatStrings disponível no banco de dados do Aguardando. Essa função retorna uma única linha na tabela de dados que contém valores de formatação. Para exibir o conteúdo da tabela retornada, execute o seguinte código SQL no Analisador de Consultas no servidor do banco de dados:

USE <organization>_MSCRM

SELECT * FROM dbo.fn_GetFormatStrings()

1. Crie um conjunto de dados para conter os dados de formatação. Para obter informações sobre como criar um conjunto de dados, consulte Manuais online do Microsoft SQL.a. Nomeie o conjunto de dados DSNumandCurrency ou use outro nome.

DSNumandCurrency é o nome do conjunto de dados usado em relatórios incluídos com o Aguardando.

b. Use o código SQL com a declaração SELECT para preencher o conjunto de dados.2. Consulte o campo de formato no conjunto de dados na propriedade Format do item do

relatório que você deseja formatar.

Para a formatação de data, hora e moeda, defina a propriedade Language do item de relatório ou o relatório para "=First(Fields! NumberLanguageCode.Value, "DSNumandCurrency")".

Relatórios usando a propriedade Fixed Header terá seu cabeçalho renderizado duas vezes devido a um erro no Visualizador de Relatórios do SSRS.

Para usar valores de formatação nos relatórios

Observação

61

http://msdn2.microsoft.com/en-us/library/ms160345.aspx

Valores de data e horaPara a data e hora, você também define a propriedade Calendar de item de relatório para "=First(Fields!CalendarType.Value, "DSNumandCurrency")".

Formatação da cadeia de caracteres Item de relatório do valor de propriedade Format

Data =First(Fields!DateFormat.Value, "DSNumandCurrency")

Hora =First(Fields!TimeFormat.Value, "DSNumandCurrency")

Valores de númeroA função fn_GetFormatStrings retorna o número de cadeias de caracteres de formato com valores de precisão entre 0 e 5. É possível especificar uma precisão colocando um valor decimal entre os caracteres sublinhados no nome do campo.

Formatação da cadeia de caracteres Valor de propriedade do formato do item de relatório

Inteiro =First(Fields!NumberFormat_0_Precision.Value, "DSNumandCurrency")

Decimal com 2 pontos decimais de precisão =First(Fields!NumberFormat_2_Precision.Value, "DSNumandCurrency")

Valor da moeda baseA função fn_GetFormatStrings retorna o as cadeias de caracteres de formato da moeda base com valores de precisão entre 0 e 5. É possível especificar uma precisão colocando um valor decimal entre os caracteres sublinhados no nome do campo.

Formatação da cadeia de caracteres Valor de propriedade do formato do item de relatório

Moeda base até 2 pontos decimais de precisão

=First(Fields!CurrencyFormat_2_Precision.Value, "DSNumandCurrency")

62

Moeda da TransaçãoAo criar um relatório em uma entidade com as informações de moeda da transação, é possível recuperar a cadeia de caracteres do formato de moeda de transações da coluna crm_moneyformatstring na exibição filtrada para uma entidade. Após uma coluna ser adicionada ao conjunto de dados, você pode consultar a coluna na propriedade Format do relatório. Para obter informações sobre como adicionar colunas a um conjunto de dados, consulte http://msdn.microsoft.com/en-us/library/ms156295.aspx. Por exemplo, para recuperar uma unidade de preço e as informações de formatação da moeda de transações da exibição filtrada de detalhes da cotação, use a seguinte declaração SELECT:

SELECT priceperunit, crm_moneyformatstring FROM FilteredQuoteDetail

Você pode referenciar uma nova coluna na propriedade Format do item do relatório da seguinte forma:

=Fields.crm_moneyformatstring.Value

Consulte tambémUsar parâmetros em relatórios

Usar SQL e exibições filtradas para recuperar dados para relatórios

Adicionar navegação de relatórioA navegação de relatórios habilita uma experiência de relatório dinâmico e interativo. Ao usar vários tipos de ações, os relatórios permitem o usuário navegar para relatórios detalhados, registros do Aguardandoou outros sites.

Para obter mais informações sobre a navegação de relatórios, consulte Adicionar relatórios de detalhamento na documentação do Microsoft SQL Server 2008. Este tópico descreve a navegação de relatórios específica para os relatórios do Aguardando.

Detalhamento dinâmico para o Microsoft Dynamics CRMVocê pode detalhar um relatório para navegar em um formulário da Web do Aguardando. Um relatório detalhado é implementado nas seguintes etapas:

1. Um item de imagem ou valor (como uma caixa de texto) é adicionado a um relatório. A propriedade Value desse item contém o código que criar uma URL usando o endereço base do Aguardando, mais os parâmetros que se referem a um registro específico.

2. Quando o usuário clica no item do relatório, uma nova janela do navegador é aberta usando a URL construída passada como o endereço Web de destino.

3. O Aguardando carrega a informação para a entidade especificada em um formulário da Web exibido na janela do navegador.

Observação

Para configurar um relatório detalhado no Microsoft Dynamics CRM63

http://msdn.microsoft.com/en-us/library/cc627584(SQL.100).aspx

http://msdn.microsoft.com/en-us/library/cc627584(SQL.100).aspx


1. Criar um parâmetro oculto da cadeia de caracteres de tipo no relatório com o nome CRM_URL. Para obter mais informações sobre a adição de parâmetros, consulte Usar parâmetros em relatórios. Quando o relatório for executado, esse parâmetro é definido automaticamente ao endereço da Web do Aguardando.

2. Adicionar um item de relatório, como uma Caixa de texto.3. Clique com o botão direito do mouse no item do relatório de detalhamento e selecione

Propriedades no menu de atalho.4. Selecione Avançado.5. Na guia Navegação, clique para selecionar Ir para URL e digite uma expressão no

seguinte formato:

= Parameters!CRM_URL.Value & "?ID={"& GUID &"}&LogicalName=entity logical name"

O GUID da entidade e o nome lógico da entidade precisam ser adicionados à URL para poder detalhar. Por exemplo:

= Parameters!CRM_URL.Value & "?ID={"&Fields!Opportunityid.Value.ToString()&"}&LogicalName=opportunity"

6. Clique em OK.

Neste código de exemplo, o valor de um campo de conjunto de dados que contém o GUID de um objeto Opportunity é convertido em uma cadeia de caracteres e usado como um parâmetro ID na URL. Um parâmetro que contém o valor LogicalName para a entidade oportunidade também é anexado.

O GUID de um registro pode ser obtido do modo de exibição filtrado apropriado, por exemplo, FilteredOpportunity.

Consulte tambémCriar relatórios personalizados usando o Business Intelligence Development Studio

Testar e solucionar problemas com relatórios


Testar e solucionar problemas com relatóriosDepois de criar um relatório, teste para ver se produz os resultados desejados.

Para testar um relatório

1. Teste o relatório no Microsoft Visual Studio na guia Visualizar.2. Se algum erro for relatado, corrija a causa dos erros e execute novamente o teste.3. Quando o relatório funciona corretamente, publique o relatório no servidor de relatórios

64

clicando ou tocando no botão da barra de ferramentas Novo na grade Relatórios do Aguardando e preenchendo as informações solicitadas.

4. Execute o relatório publicado no Aguardando para verificar a operação do relatório.

Sugestões para testar um relatórioA lista a seguir são sugestões fornecidas como um guia para testar seus relatórios:

Somente relatórios baseados em SQL: Verifica se seu relatório acessa dados do Aguardando somente através de exibições filtradas para acompanhar restrições de segurança do Aguardando.

Somente relatórios baseados em SQL: Verifica o número de junções de tabela SQL. Os relatórios não podem executar se houver muitas junções de tabela. Após ter carregado seu relatório, abra a seção pré-filtragem do seu relatório e adicione algumas entidades relacionadas, por exemplo, contas com oportunidades associadas. Execute o relatório com as entidades relacionadas. Se houver um erro de junções SQL máximo em execução, talvez você queira simplificar o relatório ou remover algumas entidades filtráveis de Localização Avançada.

Verifique se os filtros de relatório são especificados para as entidades corretas. Após ter carregado o relatório, abra o relatório e verifique se qualquer entidade nomeada para a filtragem Localização Avançada deve ser exposta para a pré-filtragem de relatório.

Se o relatório foi redigido em uma entidade personalizada, valide que essa entidade pode ser filtrada corretamente. Verifique se o relatório retorna os dados corretos baseados nas funções de usuário com segurança no nível de usuário em entidades, funções de segurança personalizadas e outras funções.

Alguns relatórios são publicados como relatórios contextuais. Portanto, é possível executar nos registros selecionados em uma grade. Para esses tipos de relatórios, verifique se o relatório pode ser executado nas exibições do sistema, exibições do sistema personalizadas, consultas do usuário e registros selecionados.

Verifique se os instantâneos do relatório podem ser obtidos pelo Assistente de Agendamento no aplicativo Web.

Verifique se você pode salvar o relatório em um arquivo PDF. Os relatórios geralmente são impressos melhor com o formato PDF.

Verifique se os sub-relatórios detalhados estão ocultos ao publicar o relatório, para que não sejam executados diretamente pelos usuários.

O detalhamento do relatório falha no Visualizador de Relatórios do Visual StudioAlguns parâmetros nos relatórios gerados pelo Assistente de Relatórios são marcados internamente (somente leitura). Portanto, ao carregar os relatórios no Visual Studio e tentar detalhar, o Visualizador de Relatórios do Visual Studio não exibirá os relatórios. Para corrigir isso, use o Designer de Relatórios do Visual Studio para alterar os parâmetros de interno para

65

oculto. Desmarque a caixa de seleção e Interno e certifique-se de que a caixa de seleção Oculto está marcada para cada um dos seguintes parâmetros:

CRM_Drillthrough CRM_DrillthroughFilterBy CRM_FilterText CRM_URL

Os parâmetros que são prefixados com CRM_Filtered, como CRM_FilteredAccount ou CRM_FilteredContact, também precisam ser marcados como ocultos e não internos.

Seu relatório não pode conter todos os parâmetros listados aqui.

Consulte tambémPublicar relatórios




Publicar um relatório no Microsoft Dynamics CRM usando o aplicativo Web

1. Criar um novo relatório ou modificar um relatório usando o Business Intelligence Development Studio. Para obter mais informações: Criar relatórios personalizados usando o Business Intelligence Development Studio

2. Entre no Aguardando na barra de navegação, clique ou toque em Microsoft Dynamics CRM > Vendas.

Na barra de navegação, clique ou toque em Vendas > Relatórios.

3. Na barra de comandos, clique ou toque em Novo.4. Na caixa de diálogo Relatório: Novo Relatório, na lista de Tipo de Relatório, clique ou

toque em Arquivo Existente e especifique o local do arquivo .rdl na caixa Local do Arquivo.

5. Especifique os dados adequados na seção Detalhes da caixa de diálogo Relatório: Novo Relatório.

6. Clique ou toque em Salvar e Fechar.Depois que o relatório for testado e funcionar corretamente, siga estas etapas para adicionar o relatório às listas contextuais e formulários no Aguardando.

Observação

66

Adicione o relatório às listas contextuais e formulários

1. Selecione o relatório na grade Relatórios e clique em Editar na barra de comandos.2. Na caixa de diálogo Relatório, especifique os valores na seção Categorização de

acordo com as seguintes descrições: Categorias: Categoriza o relatório de acordo com seu propósito. Por exemplo, um

relatório de vendas pode ser incluído nas listas contextuais e nos formulários na área Vendas do Aguardando.

Tipos de Registro Relacionados: Associa o relatório às entidades específicas, como contas ou contatos.

Exibir em: Habilita o relatório para que seja exibido em formulários contextuais e listas. Você pode restringir onde o relatório é exibido. Se você pretende publicar um relatório oculto, desmarque a caixa Exibir em.

Idiomas: Selecione se o relatório estiver disponível somente em inglês ou para todos os idiomas.

3. Clique ou toque em Salvar e Fechar.

Por padrão, um relatório é carregado como um relatório de propriedade do usuário. Para tornar o relatório visível para toda a organização, você pode fazer o seguinte ao editar um relatório:

Na caixa de diálogo Relatório, clique ou toque em Administração e, no campo Visível por, selecione Individual.

Na caixa de diálogo Relatório, no menu Ações, clique ou toque em Publicar Relatório para Uso Externo.

Especificar um filtro padrão para o relatórioVocê pode definir um filtro padrão para um relatório para que os critérios de filtragem sejam usados sempre que o relatório for executado.

1. Selecione um relatório na grade Relatórios e, no menu Mais Ações (…), clique ou toque em Editar Filtro Padrão.

2. Na caixa de diálogo Visualizador de Relatórios, defina os critérios de filtragem padrão que serão usados sempre o relatório for executado e clique ou toque em Salvar Filtro Padrão.

Consulte tambémTestar e solucionar problemas com relatórios

Copiar relatórios entre implantações do Microsoft Dynamics CRMO método preferido para copiar um relatório entre organizações ou implantações é incluir o relatório e quaisquer entidades personalizadas que o relatório usa em uma solução. Se você

67

fizer isso, os tipos de entidade são mapeados automaticamente pelo sistema. Se você escolher copiar manualmente um relatório para outra implantação do Aguardando, você deve modificar os códigos do tipo de entidade para entidades personalizadas conhecidas no relatório.

Neste tópicoCorrija o código de tipo para uma entidade personalizada usada em um relatório

Copiar um relatório de implantações

Corrija o código de tipo para uma entidade personalizada usada em um relatórioO código de tipo para uma entidade personalizada pode ser diferente em diferentes instalações do Aguardando. Se o relatório contém referências a um código de tipo de entidade personalizadas, como quando você executa um detalhamento para uma entidade do Aguardando personalizada, é necessário alterar o código de tipo de entidade personalizada indicada no relatório para o código de tipo real da entidade personalizada no outro sistema no qual você está implantando o relatório.

O código de tipo de entidade para todas as entidades padrão (não personalizadas) é predefinido.

&etc=<entity_type_code>.

O método recomendado para fazer referência a um código de tipo é definir um parâmetro oculto no relatório e definir seu valor como um código de tipo de entidade personalizada no sistema original. Após a implantação para outra instalação do Aguardando, use o Gerenciador de Relatórios para definir o valor do parâmetro para o código de tipo da entidade personalizada no sistema.

1. Obter o valor do código de tipo de entidade personalizada. Para fazer isso, execute o Analisador de Consultas do Microsoft SQL e execute o seguinte comando SQL no banco de dados do Aguardando. Substituir um nome da organização adequado. Localizar o código de tipo da sua entidade personalizada no resultset.

use <organization>_MSCRMselect Name,ObjectTypeCode from dbo.Entity order by ObjectTypeCode

2. No relatório, crie dois parâmetros de relatório: CRM_URL e CRM_OTC. CRM_OTC precisa ser do tipo cadeia de caracteres. O valor CRM_OTC padrão deve ser definido para o valor obtido na etapa 1.

3. No item de relatório que deve ser usado para um link detalhado, adicione o seguinte valor do código:

=Parameters!CRM_URL.Value &"?ID={" & Fields!new_custentityid.Value.ToString() & "}&OTC="+Parameters!

Para usar um parâmetro CRM_OTC em vez de um código de tipo avançado em um link embutido ao Microsoft Dynamics CRM

68

CRM_OTC.Value

4. Visualizar e salvar o relatório.5. Copie o relatório ao servidor de destino de acordo com as instruções na seção a seguir.

Copiar um relatório de implantaçõesApós reimplantar o Aguardando de um servidor para outro, os relatórios personalizados deverão ser copiados individualmente para o servidor reimplantado (destino).

1. Ao copiar um relatório que faça referência a um código de tipo de entidade personalizada, você deve atualizar a definição de parâmetro de relatório CRM_OTC para refletir o código de tipo de objeto da entidade no sistema de destino.

No servidor do Aguardando de destino, abra uma janela do navegador e navegue até o sistema de origem do Aguardando.

2. Na grade Relatórios do Aguardando, selecione o relatório personalizado. Na barra de ferramentas, selecione Editar e selecione Ações. No menu Ações, selecione Baixar Relatório.

3. Clique ou toque em Salvar. Especifique um nome de arquivo quando for solicitado e salve o relatório no sistema de destino. Uma cópia do relatório já existe no sistema de destino.

4. No navegador, navegue até o Aguardando no sistema de destino.5. Na barra de ferramentas localizada acima da grade Relatórios do Aguardando, clique ou

toque em Novo.6. Na caixa de diálogo Relatório: Novo Relatório, preencha a localização do arquivo de

origem. Além disso, preencha a seção Detalhes no formulário.7. Clique ou toque em Salvar e Fechar.8. Seu relatório será agora exibido na grade Relatórios. Talvez seja necessário selecionar

uma categoria ou uma entidade adequada nos menus suspensos acima da barra de ferramentas para ver o relatório.

Se você não deseja definir um filtro padrão, vá para a etapa 14.

9. Selecione seu relatório na grade Relatórios.10. Na barra de ferramentas, aponte para Mais Ações, clique ou toque em Editar Filtro

Padrão no menu.11. Na caixa de diálogo Visualizador de Relatórios, defina os critérios de filtragem padrão

que serão usados sempre o relatório for executado.12. Clique ou toque em Salvar Filtro Padrão.13. Clique ou toque Executar Relatório.

Depois que o relatório for testado e funcionar corretamente, siga estas etapas para adicionar o relatório às listas contextuais e formulários no Aguardando.

Para reimplantar um ou vários relatórios

69

1. Selecione o relatório na grade Relatórios.2. Na barra de ferramentas Ações, clique ou toque em Editar.3. Na caixa de diálogo Relatório, preencha a seção Categorização de acordo com as

seguintes descrições: Categorias: Categoriza o relatório de acordo com seu propósito. Por exemplo, um

relatório de vendas pode ser incluído nas listas contextuais e nos formulários na área Vendas do Aguardando.

Tipos de Registro Relacionados: Associa o relatório às entidades específicas, como conta ou contato. O relatório pode ser exibido em listas contextuais e formulários para essas entidades.

Exibir em: Essa configuração habilita o relatório para que seja exibido em formulários contextuais e listas. Você pode restringir onde o relatório é exibido usando essa configuração. Se você pretende publicar um relatório oculto, desmarque a caixa de texto Exibir em.

Idiomas: Associa o relatório a tudo ou somente ao idioma inglês.4. Clique ou toque em Salvar e Fechar.

Consulte tambémPublicar relatórios

Categorizar e exibir relatórios em diferentes idiomasVocê pode habilitar idiomas adicionais no Aguardando ao instalar pacotes de idiomas. Isso permite exibir o texto na interface do usuário, Ajuda e relatórios em diferentes idiomas. Para obter mais informações sobre como instalar os pacotes de idiomas, consulte o Guia de implementação do Microsoft Dynamics CRM 2013.

Para categorizar os relatórios por idioma, use o atributo Report.LanguageCode. Você pode definir o atributo para uma ID de localidade específica (por exemplo, 1033 para inglês dos EUA) para tornar o relatório visível para os usuários daquele idioma. Por exemplo, o relatório de resumo da conta não incluído em inglês é exibido na grade Relatórios na interface do usuário em inglês, mas não na interface do usuário em espanhol ou alemão na mesma organização.

Você também pode definir o atributo Report.LanguageCode para -1 (menos um) para tornar o relatório visível a todos os usuários na interface do usuário do idioma base, que é instalado durante a instalação original do servidor do Aguardando e nas interfaces do usuário em outros idiomas. Para obter informações sobre os valores de ID de localidade válidos, consulte Valores de ID de localidade da Microsoft.

Para adicionar o relatório às listas contextuais e formulários no Microsoft Dynamics CRM

70

http://msdn.microsoft.com/en-us/library/ms912047(WinEmbedded.10).aspx

http://msdn.microsoft.com/en-us/library/ms912047(WinEmbedded.10).aspx



Você poderá usar as informações de linguagem do relatório em combinação com a informação contida na entidade do relatório, na categoria do relatório e nas entidades de visibilidade do relatório para determinar as áreas e categorias no Aguardando onde o relatório é exibido em diferentes idiomas de interface do usuário.

O elemento Language dentro do arquivo RDL não determina onde o relatório é exibido no Aguardando. Contém uma expressão que avalia a um código de idioma como definido na especificação RFC1766 do Internet Engineering Task Force (IETF). O código de idioma é usado principalmente para formatação de números, datas e horas em um idioma específico. Para obter mais informações: Elemento de idioma (Relatório) (RDL).


Práticas recomendadas para relatóriosAs seguintes práticas recomendadas podem ajudar a gerar relatórios que são mais fáceis redigir, de acordo com os padrões estabelecidos, e executar com mais eficiência.

GeralEsta seção apresenta as práticas recomendadas para criar relatórios baseados em SQL e relatórios baseados em fetch personalizados.

Usar um relatório existente para criar relatórios personalizadosVerifique se há um relatório existente no Aguardando semelhante ao design que você está procurando. Baixe a definição do relatório e modifique o arquivo RDL de em vez de criar um novo do zero. Ao fazer isso, você economizar tempo de desenvolvimento e reduz erros de elaboração de relatório.

Use formatos do Microsoft Dynamics CRM para moeda, número, data e hora, calendárioA exibição FilteredUserSettings contém informações sobre o formato da moeda, formato de data e hora, número de formato, número negativo, dia de início da semana, calendários e outros formatos. O Aguardando fornece a função do banco de dados fn_GetFormatStrings para obter os formatos de data, hora, número, moeda e calendário da exibição do FilteredUserSettings.

Use esses recursos para formatar corretamente os valores de dados nos relatórios.

Observação

71

http://msdn2.microsoft.com/en-us/library/ms153956.aspx

Definir o tamanho da páginaOs Serviços de Relatório não fornecem a orientação de página explícita, como os modos retrato e paisagem ou tamanhos da página predefinidos. Os relatórios padrão do Aguardando foram projetados para tamanhos de página 8,25 x 11 (retrato) ou 11 x 8,25 (paisagem) que funcionam para carta dos EUA e folha A4.

Fazer o backup dos seus relatóriosFaça o backup dos seus relatórios e armazene-os em um computador diferente do servidor de relatórios.

Defina o truncamento se necessárioO envolvimento do texto é o comportamento padrão de um item de relatório da caixa de texto no Reporting Services. Isso significa que, salvo indicação em contrário, todo o texto envolverá a largura definida de qualquer área de texto e crescerá verticalmente. Se o truncamento for especificado, uma caixa de texto truncará o texto na largura da caixa de texto no preenchimento especificado (o padrão é 2 pontos para a esquerda e direita.) Qualquer truncamento de comprimento máximo além disso exigirá uma codificação personalizada.

Os relatórios padrão do Aguardando estão configurados com dicas de ferramenta para mostrar texto estático ou valores de campos de dados quando o usuário passar o ponteiro do mouse sobre o item de relatório. Se você usar o truncamento, considere definir a propriedade ToolTip para o valor de campo para que o texto completo seja exibido quando o usuário passar o mouse sobre o texto truncado.

Relatórios baseados em SQLEsta seção forneceu práticas recomendadas apenas para relatórios baseados em SQL.

Procedimentos armazenados de redaçãoAdicionar procedimentos armazenados personalizados para o banco de dados do Aguardando não tem suporte. Entretanto, você pode criar um banco de dados separado e redigir procedimentos armazenados para o banco de dados.

Limite o tamanho de texto e o número de itens em gráficosOs relatórios do Aguardando usam apenas alguns tipos de gráfico possíveis do Reporting Services. Para qualquer tipo de gráfico, limitar o tamanho da etiqueta e o número de itens é recomendável para que o conteúdo do gráfico seja exibido corretamente. Quando o Reporting Services exibir um gráfico com etiquetas longas, o próprio gráfico se torna muito pequeno para ser útil. Isso pode ser feito de várias maneiras:

Limite o tamanho da área do gráfico explicitamente, truncando se necessário. Considere limitar o número de itens exibidos nos gráficos. Para obter mais informações,

consulte Exemplo: Limitar o número de itens exibidos em um gráfico.

72

Use imagens inseridas em um relatórioA maneira mais fácil de usar imagens com o Reporting Services é inserir imagens em um banco de dados. Se as imagens não estão em um banco de dados, use as imagens inseridas nos formatos .png, .gif ou .jpg em um relatório. Os arquivos de imagem usados por arquivos de imagem do Aguardando estão localizados na pasta C:/Inetpub/wwwroot/_imgs/ico em uma instalação padrão do Aguardando.


Melhorar o desempenho dos relatóriosHá algumas diretrizes que podem ajudá-lo a aprimorar o desempenho dos relatórios.

GeralEssas diretrizes são aplicáveis para relatórios baseados em SQL e baseados em fetch.

Limita um relatório para exibir informações de um período específico, em vez de exibir todos os registros no banco de dados do Aguardando.

Pré-filtra um relatório para que o conjunto de dados seja limitado. Calcule totais agregados usando o código SQL ou as agregações em uma consulta

FetchXML, em vez de passar dados brutos para o Reporting Services e agrupamento. Limita o número de conjunto de dados usados, se possível. Ao comparar datas, use os campos data UTC para comparações. Por exemplo, compare os

campos createdonutc e não os campos createdon em uma exibição filtrada ou em consultas FetchXML.

Relatórios baseados em SQLEssas diretrizes são aplicáveis apenas para relatórios baseados em SQL.

Não crie um relatório que utiliza um grande conjunto de dados ou uma consulta SQL complexa disponível sob demanda para todos os usuários.

Não selecione todas as colunas de uma exibição filtrada do Aguardando. Em vez disso, especifique explicitamente as colunas que você deseja selecionar na declaração SQL.

Use os procedimentos armazenados de SQL em vez do SQL embutido.


73

Relatórios de amostraEsta seção fornece exemplos que mostram como implementar técnicas comuns em seus relatórios do Aguardando.

Nesta seçãoExemplo: Limitar o número de itens exibidos em um gráfico

Exemplo: Exibir os primeiros X valores

Exemplo: Criar um relatório contextual

Seções relacionadosCriar relatórios personalizados usando o Business Intelligence Development Studio

Exemplo: Limitar o número de itens exibidos em um gráficoOs relatórios de gráfico estão limitados a 15 pontos de dados. O conjunto de dados deve limitar o conjunto de resultados às 15 principais linhas para o valor em gráfico. Além disso, um 16º “outro” valor de ponto de dados é opcional. Esse valor representa uma agregação de todas as outras linhas no domínio. O 16º valor é sempre classificado na parte inferior do conjunto de resultados. Isso adiciona um nível de complexidade para relatórios que contém funcionalidade detalhada apropriada para alguns relatórios.

O número de pontos de dados e o comprimento da etiqueta pode ter sido reduzido para exibir corretamente o conteúdo do gráfico.

Example

DescriptionA seguir está um exemplo de consulta SQL que gera os primeiros 15 pontos de dados, mais um 16º outro um ponto de dados para um gráfico:

CodeINSERT INTO @AcctTopTbl SELECT Top 15 accountid FROM FilteredAccount ORDER BY Revenue Desc

SELECT AcctTop.accountid, AcctTop.name, AcctTop.Revenue, 1 As SortOrder FROM (SELECT Top

15 accountid, name, Revenue FROM FilteredAccount ORDER BY Revenue Desc) AS AcctTop

UNION

SELECT Null As accountid, 'Other' As name, Sum(Revenue) As Revenue, 2 As SortOrder FROM

FilteredAccount

WHERE accountid NOT IN (Select accountid FROM @AcctTopTbl)

Observação

74

ORDER BY SortOrder Asc, Revenue Desc

Example

DescriptionO seguinte exemplo demonstra como limitar um número de pontos de dados exibidos na tabela usando a consulta FetchXML. Você precisará fornecer dois conjuntos de dados com uma consulte FetchXML por conjunto de dados. Os resultados da primeira consulta do conjunto de dados são transmitidos pelos parâmetros de vários valores para o segundo conjunto de dados para filtrar os resultados da consulta. Dataset1 recupera os 15 primeiros registros classificados por receita e o Dataset2 recupera “TotalRevenue" agregando todas as contas exceto as contas do DataSet1.

CodeDataSet1:

<fetch count="15">

<entity name="account" >



<attribute name="revenue" />

<order attribute="revenue" descending="true" />

</entity>

</fetch>

DataSet2:

<fetch aggregate="true">

<entity name="account">

<attribute name="revenue" aggregate="sum" alias="TotalRevenue" />

<filter>

<condition attribute="accountid" operator="not-in" value="@TopAccountIds"/>

</filter>

</entity>

</fetch>

Report Parameter:

<ReportParameter Name=" TopAccountIds ">

75

...

<MultiValue>true</MultiValue>

<Hidden>true</Hidden>

<DefaultValue>

<DataSetReference>

<DataSetName>DataSet1</DataSetName>

<ValueField>accountid</ValueField>

</DataSetReference>

</DefaultValue>

</ReportParameter>

Consulte tambémRelatórios de amostra

Guia de redatores de relatório para Microsoft Dynamics CRM 2013 e Microsoft Dynamics CRM Online

Exemplo: Exibir os primeiros X valoresO Aguardando inclui vários relatórios que exibem os X principais itens de uma entidade, onde ele especificar o valor de X.

Para consultar os X principais itens, use o SQL dinâmico. Atribuir a cadeia de caracteres de consulta do SQL que inclui o parâmetro especificado pelo usuário a uma variável. Isso resolver o parâmetro especificado pelo usuário. A cadeia de caracteres de consulta são transmitidas na função SQL EXEC junto com o parâmetro especificado pelo usuário.

Example

DescriptionNo exemplo de SQL a seguir, o parâmetro TopCount contém o valor fornecido pelo usuário:

CodeDeclare @SQL nVarchar (4000)

SET @SQL = '

Select Top ' + CONVERT(nvarchar(10), @TopCount) + ' kb.kbarticleid FROM

(' + @CRM_FilteredKBArticle + ') kb '

Exec (@SQL)

76

CommentsSe você estiver criando um relatório baseado em FetchXML, a consulta FetchXML correspondente é:

<fetch count="@TopCount">

<entity name="kbarticle" enableprefiltering="true"

prefilterparametername="CRM_FilteredKbArticle" >

<attribute name="kbarticleid"/>

</entity>

</fetch>

Consulte tambémCriar relatórios personalizados usando o Business Intelligence Development Studio

Relatórios de amostra

Exemplo: Criar um relatório contextualAs etapas a seguir descrevem como configurar um relatório contextual no Aguardando.

Por exemplo, se um relatório exibe todas as atividades de uma conta específica e você deseja exibir este relatório no Aguardando no formulário de Conta, você deve incluir Atividades e Contas na categorização Tipos de Registro Relacionados e especificar Formulários para tipos de registros relacionados em Exibir no campo do Relatório: Novo formulário.

1. Cria um relatório que contém os campos de uma exibição do base de dados <entity> filtrada e estabelece um ou mais JOINs SQL com outras exibições filtradas relacionadas conforme necessário.

2. Use CRMAF_Filtered<entity> como um nome na declaração de consulta SQL do relatório. Por exemplo:

SELECT CRMAF_FilteredActivityPointer.activitytypecodename as

activitytypecodename,

CRMAF_FilteredActivityPointer.regardingobjectidname as regardingobjectidname,

CRMAF_FilteredActivityPointer.subject as subject,

CRMAF_FilteredAccount.name

FROM FilteredActivityPointer AS CRMAF_FilteredActivityPointer

INNER JOIN FilteredAccount As CRMAF_FilteredAccount on

CRMAF_FilteredAccount.accountid =

CRMAF_FilteredActivityPointer.regardingobjectid

Criar e configurar um relatório contextual

77

Se houver um relatório baseado em fetch, você pode usar a seguinte consulta FetchXML em vez da consulta SQL:

<fetch>

<entity name="activitypointer" enableprefiltering="1" >

<attribute name="activitytypecode" />

<attribute name="regardingobjectid" />

<attribute name="subject" alias="subject" />

<link-entity name="account" from="accountid" to="regardingobjectid" link-type='inner' alias="accountLink">

<attribute name="name" alias="name" />

</link-entity>

</entity>

</fetch>

3. Ao carregar o relatório para o Aguardando através do formulário Relatório: Novo, selecione todas as entidades na categorização Tipos de Registro Relacionados em que as exibições filtradas são conhecidas no código do SQL do relatório.

4. No campo Exibir, selecione Formulários para tipos de registros relacionados ou Listas para tipos de registros relacionados. Selecionar Listas para tipos de registro relacionados permite que você execute um relatório pela grade da lista entidade. Selecionar Formulários para tipos de registro relacionados permite que você execute um relatório pelo formulário da entidade.


78

Documents

gallery.technet.microsoft.com · Web viewAlguns exemplos aqui retratados são fornecidos meramente para fins ilustrativos e são fictícios. Nenhuma associação ou conexão real