Criar uma visualização (gráfico)

  • Artigo

 

Publicado: janeiro de 2017

Aplicável a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Para criar uma visualização usando o SDK do Microsoft Dynamics 365, você deve criar um registro da entidade SavedQueryVisualization ou UserQueryVisualization para criar um gráfico de propriedade da organização ou de propriedade do usuário respectivamente. Este tópico mostra como criar uma visualização de gráfico e uma visualização de recurso da Web.

Neste tópico

Antes de criar uma visualização

Criar uma visualização de gráfico

Criar uma visualização de recurso da Web

Antes de criar uma visualização

Antes de criar uma visualização, certifique-se de que esteja ciente do seguinte:

  • Tipo de visualização: Se quiser que as visualizações estejam disponíveis na organização e não quiser gerenciar os níveis de acesso em um nível mais detalhado, convém criar uma visualização de propriedade da organização. Entretanto, se você estiver preocupado com os privilégios de acesso e com a segurança da sua visualização, considere criar uma visualização de propriedade do usuário onde você tenha mais controle sobre quem pode acessá-la.

    Observação

    Visualizações de propriedade da organização só podem ser criadas pelos usuários que tenham a função de administrador ou de personalizador do sistema.

  • Entidade associada: As visualizações são anexadas a entidades.Para obter mais informações: Entidades suportadas para visualizações. Você pode anexar um gráfico a uma entidade suportada, usando o atributo SavedQueryVisualization.PrimaryEntityTypeCode ou UserQueryVisualization.PrimaryEntityTypeCode.

Criar uma visualização de gráfico

Os gráficos requerem que você especifique os dados subjacentes dos gráficos e como será a aparência deles no formato de cadeias de caracteres XML descrição dos dados e descrição da apresentação.Para obter mais informações: Entender gráficos: Representação de dados subjacentes e gráficos e Gráficos de exemplo.

Por obter um exemplo completo sobre como criar um gráfico de propriedade da organização, consulte Exemplo: Criar, recuperar, atualizar e excluir um gráfico.

Criar um gráfico de várias séries

Gráficos de várias séries mapeiam valores de eixo de várias séries (verticais) para um valor de eixo de categoria única (horizontal). A única diferença de um gráfico de série única é que esses gráficos possuem vários elementos <measurecollection> e elementos <series> correspondentes especificados nas cadeias de caracteres XML. Cada elemento <measurecollection> contém um elemento filho chamado <measure>, que define um valor de eixo de série (vertical) para o mesmo valor de categoria (horizontal).Para obter mais informações: Entender gráficos: Representação de dados subjacentes e gráficos.

Para um gráfico de várias séries de exemplo e as cadeias de caracteres XML de descrição de dados e de descrições de apresentação correspondentes, consulte Gráfico com várias séries.

Criar uma visualização de recurso da Web

As visualizações que contêm recursos da Web não requerem a especificação de cadeias de caracteres XML de descrição de dados e de descrição de apresentação. O exemplo a seguir demonstra como criar uma visualização de propriedade da organização que contém um recurso da Web usando o SDK.

SavedQueryVisualization newWebResourceVisualization = new SavedQueryVisualization()
{
   Name = "Sample Dashboard Visualization",
   Description = "Sample organization-owned visualization",
                           PrimaryEntityTypeCode = Account.EntityLogicalName,
   WebResourceId = new EntityReference(WebResource.EntityLogicalName, _webResourceId))

};
_orgOwnedVisualizationId = _serviceProxy.Create(newWebResourceVisualization);

Se quiser criar uma visualização de recurso da Web usando o aplicativo Web Microsoft Dynamics 365, você deve criar um arquivo XML no seguinte formato e, em seguida, usar Importar gráfico na faixa de opções para importar a visualização.

<visualization>
  <name>Visualization_Name</name>
  <description>Description</description>
  <webresourcename>Name_Of_An_Existing_Web_Resource</webresourcename>
  <primaryentitytypecode>Entity_Logical_Name</primaryentitytypecode>
  <isdefault>Value: true or false</isdefault>
</visualization>

Por exemplo, para criar uma visualização de exemplo que exibe um recurso da Web existente chamado new_TestWebResource, e a visualização deve ser anexada à entidade account, o XML deve ser semelhante.

<visualization>
  <name>Sample Visualization</name>
  <description>Sample Web Resource Visualization.</description>
  <webresourcename>new_TestWebResource</webresourcename>
  <primaryentitytypecode>account</primaryentitytypecode>
  <isdefault>false</isdefault>
</visualization>

Confira Também

Exibir dados com visualizações (gráficos)
Entender gráficos: Representação de dados subjacentes e gráficos
Ações em visualizações (gráficos)
Gráficos de exemplo
Personalizar visualizações e painéis
Exemplo: Criar, recuperar, atualizar e excluir um gráfico

Microsoft Dynamics 365

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais