Passar parâmetros para uma URL usando a faixa de opções
Publicado: janeiro de 2017
Aplicável a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
As ações de faixa de opções são definidas no elemento <Actions> (RibbonDiffXml) de um elemento <CommandDefinition> (RibbonDiffXml). Há várias maneiras de passar informações contextuais de Microsoft Dynamics 365 como parâmetros de cadeia de caracteres da consulta para uma URL, usando a faixa de opções.
Utilize um elemento <Url> (RibbonDiffXml). No elemento Url, utilize o atributo PassParams.
Utilize um elemento <Url> (RibbonDiffXml) juntamente com um elemento <CrmParameter> (RibbonDiffXml). Quando usado a partir de um elemento Url, o valor do atributo de nome deve ser definido.
Utilize um elemento <JavaScriptFunction> (RibbonDiffXml) juntamente com um elemento <CrmParameter> (RibbonDiffXml).
Use o atributo PassParams para definir valores dinâmicos
Passar parâmetros para a URL de destino usando o atributo PassParams fornece informações sobre o contexto do registro ou do usuário ao aplicativo de destino. Todos os parâmetros serão transmitidos, se o controle de faixa de opções for configurado com o atributo PassParams. A tabela a seguir lista os parâmetros passados.
Parâmetro |
Nome |
Descrição |
|---|---|---|
typename |
Nome da Entidade |
Nome da entidade. Para entidades personalizadas, isso inclui o prefixo de personalização, por exemplo, new_entityname. |
type |
Código de tipo de entidade |
Inteiro que identifica a entidade de forma exclusiva na organização atual. Observação Os valores Entity Type Code são determinados por ordem em que uma entidade é criada em uma organização.Entity Type Codes são para entidades personalizadas em diferentes organizações. |
id |
GUID do objeto |
Identificador global exclusivo (GUID) que representa um registro. |
orgname |
Nome da Organização |
Nome exclusivo da organização. |
userlcid |
Código do idioma do usuário |
Identificador do código de idioma usado pelo usuário atual. |
orglcid |
Código do idioma da organização |
Identificador do código de idioma que representa o idioma base da organização. |
Os códigos de idioma são IDs de localidade de quatro ou cinco dígitos. Os valores de ID de localidade válidos podem ser encontrados em Gráfico de LCID (ID de localidade).
Observação
Recomendamos que você utilize o nome da entidade em vez do código de tipo da entidade, pois esse código pode ser diferente entre as instalações do Microsoft Dynamics 365.
Exemplo
O exemplo a seguir mostra a URL sem parâmetros:
http://myserver/mypage.aspx
O exemplo a seguir mostra os parâmetros incluídos quando o controle de faixa de opções é apresentado para a entidade da conta, para uma organização chamada "AdventureWorksCycle", quando o idioma do usuário e o idioma base da organização é o inglês, e o GUID do registro de conta é DBD5DBFB-0666-DC11-A5D9-0003FF9CE217:
http://myserver/mypage.aspx?orgname=AdventureWorksCycle&userlcid=1033&orglcid=1033&type=1&typename=account&id=%7BDBD5DBFB-0666-DC11-A5D9-0003FF9CE217%7D
Utilize um parâmetro Querystring na URL
É possível incluir um parâmetro querystring no atributo da URL. Isso pode ser muito útil se quiser abrir ou visualizar um registro específico do Microsoft Dynamics 365, usando Abrir formulários, exibições, caixas de diálogo e relatórios com uma URL.
Observação
Não será possível importar a faixa de opções, se a URL incluir o caractere de E comercial (&), usado para separar diversos parâmetros de querystring na URL. Esse caractere invalida o XML. Você deve escapar o caractere do E comercial no valor de atributo da URL com “&".
Como fazer a leitura dos parâmetros transmitidos
Os parâmetros passados são geralmente lidos na página .aspx usando a propriedade HttpRequest.QueryString.Para obter mais informações:Propriedade HttpRequest.QueryString
Observação
Se o destino da URL for um recurso da Web, ele só poderá aceitar os parâmetros identificados no tópico Transmitir parâmetros para os recursos da Web em HTML. A única oportunidade de passar valores personalizados é inclui-los no parâmetro de data. Uma administração especial é necessária para incluir diversos valores em um único parâmetro.Para obter mais informações:Amostra: Transmitir vários valores para um recurso Web através do parâmetro de dados
Confira Também
Personalizar os comandos e a faixa de opções
Abrir formulários, exibições, caixas de diálogo e relatórios com uma URL
<Url> (RibbonDiffXml)
Definir regras de exibição da guia de faixa de opções
Exemplo: Exportar definições de faixa de opções
Microsoft Dynamics 365
© 2017 Microsoft. Todos os direitos reservados. Direitos autorais