Abrir aplicativos, formulários, exibições e relatórios com uma URL

Os elementos endereçáveis de URL permitem que você inclua links para aplicativos, formulários, exibições e relatórios controlados por modelos em outros aplicativos.

URLs do aplicativo

Você pode abrir qualquer aplicativo controlado por modelos usando os valores AppModule.UniqueName ou AppModule.AppModuleId .

Você pode recuperar esses valores usando a API Web usando a seguinte consulta:

GET [Organization URI]/api/data/v9.1/appmodules?$select=appmoduleid,uniquename

Mais informações: consultar dados usando a API Web

Você pode usar os parâmetros de consulta appname ou appid com os valores Nome Exclusivo ou AppModuleId, respectivamente, mas não pode usar ambas ao mesmo tempo.

Utilizar Nome Exclusivo

Para abrir o aplicativo usando o Nome Exclusivo, acrescente o appname parâmetro de consulta à página main.aspx.

https://myorg.crm.dynamics.com/main.aspx?appname={UniqueName}

Por exemplo, se o Nome Único for msdyn_SolutionHealthHub, você poderá abrir este aplicativo por meio deste URL:

https://myorg.crm.dynamics.com/main.aspx?appname=msdyn_SolutionHealthHub

Usando AppModuleId

Para abrir o aplicativo usando o AppModuleId, adicione o appid parâmetro de consulta à página main.aspx.

https://myorg.crm.dynamics.com/main.aspx?appid={AppModuleId}

Por exemplo:

https://myorg.crm.dynamics.com/main.aspx?appid=00001111-aaaa-2222-bbbb-3333cccc4444

Formulários e modos de exibição com endereço URL

A main.aspx página exibe todos os formulários e visualizações. Parâmetros de cadeia de caracteres de consulta que você passa para esta página controlam o que é exibido. Por exemplo:

Para abrir um formulário de registro de conta onde a ID está {91330924-802A-4B0D-A900-34FD9D790829}:

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

Para abrir o modo de exibição Oportunidades Fechadas :

https://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 sem nenhuma barra de navegação ou barra de comandos

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

Normalmente, você usa o método getClientUrl para recuperar a URL raiz da organização para aplicativos controlados por modelos.

Consultar parâmetros de cadeia de caracteres para a página Main.aspx

A tabela a seguir lista os parâmetros de cadeia de caracteres de consulta usados com a página main.aspx para abrir formulários ou exibições:

Copiar a URL para uma exibição

Muitas exibições em aplicativos controlados por modelo permitem copiar a URL para um modo de exibição específico ou enviar um email com a URL para um modo de exibição específico inserido na mensagem. Esse recurso facilita a comunicação entre os usuários e expõe uma maneira de obter acesso a uma URL para um modo de exibição que os usuários podem incluir em outro aplicativo, como um site do SharePoint.

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

Obter a URL para uma visualização

1. Abra a visualização que deseja usar.
2. Na barra de comandos, selecione Ações e selecione Enviar um Link por Email.
3. Cole o link no Bloco de Notas e edite-o para extrair apenas a parte da URL do texto que você deseja.

Exibir uma visualização na navegação do aplicativo usando o mapa do site

Ao personalizar a navegação do aplicativo utilizando o mapa do site, não use a URL da visualização copiada do aplicativo usando as etapas em Copiar a URL para uma visualização para definir como a URL. Essa URL exibe uma página que inclui a barra de ferramentas e produz resultados indesejados se usada em um <SubArea> parâmetro de URL.

Para exibir uma lista de registros de tabela dentro do aplicativo para uma SubArea, defina o valor da coluna da tabela. Esse valor exibe a exibição padrão dessa tabela e fornece o título e o ícone corretos.

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

Url="/main.aspx?appid=11112222-bbbb-3333-cccc-4444dddd5555&pagetype=entitylist&etn=account&viewid=%7b<GUID value of view id>%7d"

Ao usar essa URL, você também deve especificar valores apropriados para <Titles> e <Descriptions>especificar um ícone para a tabela.

Abrindo um relatório usando uma URL

Você pode abrir um relatório passando os valores de parâmetro apropriados para o seguinte URL: [organization url]/crmreports/viewer/viewer.aspx.

Este URL aceita os seguintes parâmetros:

ação
Dois valores possíveis para este parâmetro são run ou filter. Quando você usa run, o relatório é exibido usando os filtros padrão. Quando você usa filter, o relatório exibe um filtro que o usuário pode editar antes de escolher o botão Executar Relatório para exibir o relatório.

ID de ajuda
Esse parâmetro é opcional. Para relatórios incluídos em aplicativos controlados por modelos, o valor neste parâmetro permite que o botão Ajuda exiba o conteúdo apropriado sobre esse relatório quando a Ajuda nesta Página for escolhida. O valor deve corresponder ao valor do relatório FileName .

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

Os exemplos a seguir mostram URLs que você pode usar para abrir relatórios em aplicativos controlados por modelos.

Abra o relatório Casos Negligenciados 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 Principais artigos da base de dados de conhecimento e solicite que o usuário defina valores de 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;  
}  

Consulte também

Definir valores de coluna usando parâmetros passados para um formulário
Xrm.Navigation.openUrl
Configurar um formulário para aceitar parâmetros querystring personalizados
Personalizar a faixa de opções
Script do cliente usando JavaScript
Recursos da Web
Alterar a navegação do aplicativo usando o SiteMap