Abrir formulários, exibições, caixas de diálogo e relatórios com uma URL

Publicado: novembro de 2016

Aplicável a: Dynamics CRM 2015

Os elementos endereçáveis do URL permitem incluir links para formulários, exibições, caixas de diálogo e relatórios do Microsoft Dynamics 365 em outros aplicativos. Assim, é possível estender facilmente outros aplicativos, relatórios ou sites de modo que os usuários possam exibir informações e executar ações sem alternar aplicativos.

Neste tópico

Formulários e exibições endereçáveis da URL

• Parâmetros de cadeia de caracteres de consulta para a página Main.aspx

• Copiar a URL para uma exibição

• Mostrar uma exibição na navegação do aplicativo usando o mapa do site

Abrir um processo de diálogo usando uma URL

Abrir um relatório usando uma URL

Formulários e exibições endereçáveis da URL

Todos os formulários e exibições da entidade são exibidos na página main.aspx. Os parâmetros da cadeia de caracteres de consulta informados para essa página controlam o que será exibido. Por exemplo:

• Para abrir um novo registro de entidade da conta para o Microsoft Dynamics 365 no local:

  http://mycrm/myOrg/main.aspx?etn=account&pagetype=entityrecord
  

• Para abrir um formulário de registro de entidade da conta para o Microsoft Dynamics CRM Online em que o id é {91330924-802A-4B0D-A900-34FD9D790829}:

  http://myorg.crm.dynamics.com/main.aspx?etn=account&pagetype=entityrecord&id=%7B91330924-802A-4B0D-A900-34FD9D790829%7D
  

• Para abrir a exibição Oportunidades fechadas para o Microsoft Dynamics CRM Online:

  http://myorg.crm.dynamics.com/main.aspx?etn=opportunity&pagetype=entitylist&viewid=%7b00000000-0000-0000-00AA-000010003006%7d&viewtype=1039
  

• Para abrir a exibição Contatos ativos para o Microsoft Dynamics CRM Online sem barra de navegação ou barra de comandos

  http://myorg.crm.dynamics.com/main.aspx?etn=contact&pagetype=entitylist&viewid={00000000-0000-0000-00AA-000010001004}&viewtype=1039&navbar=off&cmdbar=false
  

Geralmente, você usa o método d7d0b052-abca-4f81-9b86-0b9dc5e62a66#BKMK_getClientUrl para recuperar a URL raiz da organização para o Microsoft Dynamics 365 e o Microsoft Dynamics CRM Online no local.

Parâmetros de cadeia de caracteres de consulta para a página Main.aspx

A seguir, estão os parâmetros de cadeia de caracteres de consulta usados com a página main.aspx para abrir formulários e exibições da entidade:

Copiar a URL para uma exibição

Muitas exibições no Microsoft Dynamics 365 permitem que um usuário copie a URL de uma exibição específica ou envie um email com a URL de uma exibição específica incorporada na mensagem. Esse recurso facilita a comunicação entre os usuários e expõe uma maneira para você obter acesso à URL de uma exibição que os usuários podem incluir em outro aplicativo, como o local do SharePoint.

A página exibida pela URL inclui a exibição completa. Isso inclui a faixa de opções, mas não inclui a navegação do aplicativo.

Obter a URL para uma exibição

1. Abra a exibição que você deseja usar.

2. Na barra de comandos, escolha Enviar um link e escolha Da visualização atual.

3. Cole o link no Bloco de Notas e edite-o para extrair apenas a parte da URL com o texto desejado.

Mostrar uma exibição na navegação do aplicativo usando o mapa do site

Ao personalizar a navegação do aplicativo usando o mapa do site, não use a URL de exibição que copiou do aplicativo usando as etapas descritas em Copiar a URL para uma exibição para definir como a URL. Essa URL exibe uma página que inclui a faixa de opções e produz resultados indesejados se for usada em um atributo de URL <SubArea> (SiteMap).

Para exibir uma lista de registros da entidade no aplicativo para uma SubArea, defina o valor de atributo da entidade. Isso mostra a exibição padrão dessa entidade e fornece o título e o ícone corretos.

No entanto, se quiser ter um elemento de SubArea que usa uma exibição padrão inicial específica, use o seguinte padrão de URL.

Url=“/_root/homepage.aspx?etn=<entity logical name >&amp;viewid=%7b<GUID value of view id>%7d”

Ao usar essa URL, especifique também valores adequados para <Titles> (SiteMap) e <Descriptions> (SiteMap) e especifique um ícone para a entidade.

Abrir um processo de diálogo usando uma URL

Uma personalização comum é habilitar um usuário para abrir um processo de diálogo específico no contexto de um determinado registro. Por exemplo, talvez você queira adicionar um botão personalizado na faixa de opções de uma entidade específica usando o valor de ID do registro atual como um parâmetro de entrada do processo de diálogo.

Para abrir uma caixa de diálogo, é necessário o seguinte:

• O identificador exclusivo da caixa de diálogo.

• O nome lógico da entidade para a qual a caixa de diálogo foi criada.

• O identificador exclusivo do registro com o qual você deseja executar a caixa de diálogo.

O exemplo a seguir mostra os parâmetros da URL e da cadeia de caracteres de consulta para abrir uma caixa de diálogo:

[organization url]/cs/dialog/rundialog.aspx?DialogId=[dialog unique identifier]&EntityName=[entity logical name]&ObjectId=[unique identifier for the record]

Por exemplo, para abrir a caixa de diálogo com a id ={6A6E93C9-1FE6-4C07-91A9-E0E2A7C70976} com a ID do registro da conta = {40C9ADFD-90A8-DF11-840E-00155DBA380F}, use a URL no exemplo a seguir.

[organization url]/cs/dialog/rundialog.aspx?DialogId=%7b6A6E93C9-1FE6-4C07-91A9-E0E2A7C70976%7d&EntityName=account&ObjectId=%7b40C9ADFD-90A8-DF11-840E-00155DBA380F%7d

Você pode criar uma função JavaScript para abrir a caixa de diálogo conforme mostrado no exemplo a seguir:

function openDialogProcess(dialogId, entityName, objectId)
{
 var url = Xrm.Page.context.getClientUrl() +
  "/cs/dialog/rundialog.aspx?DialogId=" +
  dialogId + "&EntityName=" +
  entityName + "&ObjectId=" +
  objectId;
 window.open(url);
}

Abrir um relatório usando uma URL

Você pode abrir um relatório transmitindo valores de parâmetro adequados para a seguinte URL: [organization url]/crmreports/viewer/viewer.aspx.

Essa URL aceita os seguintes parâmetros:

• ação
  Dois valores possíveis para esse parâmetro são run ou filter. Quando o run for usado, o relatório será exibido usando os filtros padrão. Quando o filter for usado, o relatório exibirá um filtro que o usuário pode editar antes de escolher o botão Executar relatório para visualizar o relatório.

• helpID
  Esse parâmetro é opcional. Para relatórios incluídos no Microsoft Dynamics 365, o valor desse parâmetro permite que o botão Ajuda exiba o conteúdo apropriado sobre esse relatório quando Ajuda sobre esta página será escolhido. O valor deve coincidir com o valor de atributo de relatório do FileName.

• id
  Esse parâmetro é o valor de atributo de relatório do ReportId.

Os exemplos a seguir mostram as URLs que podem ser usadas para abrir relatórios no Microsoft Dynamics 365.

• Abra o relatório Ocorrências inativas usando o filtro padrão:

  [organization url]/crmreports/viewer/viewer.aspx?action=run&helpID=Neglected%20Cases.rdl&id=%7b8c9f3e6f-7839-e211-831e-00155db7d98f%7d
  

• Abra o relatório Artigos principais da Base de Dados de Conhecimento e solicite que o usuário defina os valores do filtro:

  [organization url]/crmreports/viewer/viewer.aspx?action=filter&helpID=Top%20Knowledge%20Base%20Articles.rdl&id=%7bd84ec390-7839-e211-831e-00155db7d98f%7d
  

A função a seguir mostra como codificar corretamente os valores na URL:

function getReportURL(action,fileName,id) {
 var orgUrl = GetGlobalContext().getClientUrl();
 var reportUrl = orgUrl + 
  "/crmreports/viewer/viewer.aspx?action=" +
  encodeURIComponent(action) +
  "&helpID=" +
  encodeURIComponent(fileName) +
  "&id=%7b" +
  encodeURIComponent(id) +
  "%7d";
 return reportUrl;
}

Confira Também

Escrever as extensões do aplicativo do cliente
Definir valores de campo usando parâmetros transmitidos a um formulário
Configurar um formulário para aceitar parâmetros de cadeia de caracteres de consulta personalizados
Alterar navegação do aplicativo usando o SiteMap
Personalizar os comandos e a faixa de opções
Criar códigos para os formulários do Microsoft Dynamics CRM 2015
Recursos da Web do Microsoft Dynamics CRM 2015
Iniciar um diálogo usando uma URL

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais