Transmitir dados do Microsoft Dynamics 365 de uma página como parâmetro para as Ações da Faixa de Opções
Publicado: janeiro de 2017
Aplicável a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
Quando você define uma ação em uma faixa de opções, sempre precisará transmitir dados da página para uma função JavaScript ou um URL. Este tópico descreve opções para usar o elemento <CrmParameter> (RibbonDiffXml) para recuperar esses valores.
Valores de grade
A maioria dos valores disponíveis para o elemento <CrmParameter> (RibbonDiffXml) está relacionada ao trabalho com dados exibidos em uma grade ou gráfico de hierarquia. Usando as opções de enumeração do atributo Value, é fácil isolar itens por:
Itens selecionados
SelectedControlSelectedItemCount
SelectedControlSelectedItemIds
SelectedControlSelectedItemReferences
Todos os Itens
SelectedControlAllItemCount
SelectedControlAllItemIds
SelectedControlAllItemReferences
Itens não selecionados
SelectedControlUnselectedItemCount
SelectedControlUnselectedItemIds
SelectedControlUnselectedItemReferences
Para cada um desses agrupamentos, você pode reunir o número de itens e o identificador de GUID. Se você está passando os valores para um URL, também é possível recuperar os objetos do EntityReference contendo todas as informações necessárias para identificar exclusivamente os objetos na grade. Esses parâmetros são aplicados se a página é exibida a grade principal (HomepageGrid) ou uma subgrade localizada em um formulário. Quando usado em conjunto com o parâmetro SelectedEntityTypeName, você tem todas as informações que você deve transmitir para outro aplicativo.
Valores de formulário
Com uma faixa de opções do formulário, você pode usar a coleção Xrm.Page.data.entity.atributos e Xrm.Page.ui.controls para recuperar valores de campos conhecidos. Entretanto, se você deseja transmitir o valor de um campo de formulário selecionado, será necessário fazer mais script para obter o valor.
Você pode usar o parâmetro PrimaryControlId para obter o valor Id para o controle com foco quando o controle da faixa de opções recebeu o foco. Este Id é o valor Id do Modelo do Objeto de Documentos. Para obter o valor de dados, será necessário tentar usar esse valor usando o código como no exemplo a seguir:
var focusFieldValue = Xrm.Page.ui.controls.get(PrimaryControlId).getAttribute().getValue()
Informações de contexto
Além dos valores de dados, é possível recuperar informações de contexto adicionais usando <CrmParameter> (RibbonDiffXml).
Por questão de conveniência, as opções do atributo OrgName, Value, OrgLcid e UserLcid disponíveis sem exigir que você use Xrm.Page.context para usar os métodos getOrgUniqueName, getOrgLcid e getUserId. Para uma ação <Url> (RibbonDiffXml), use o atributo PassParams para incluir informações contextuais.
As opções PrimaryEntityTypeName, FirstPrimaryItemId e Value fornecem informações de um registro da entidade. Você pode usar PrimaryItemIds para uma faixa de opções HomepageGrid obter uma lista de todos os itens exibidos.
Por fim, você pode usar o valor CommandProperties para obter detalhes sobre o evento do controle da faixa de opções. Você pode usar isso para enviar informações contextuais para uma função central onde as ações específicas podem ser determinadas com base no contexto do evento.
Confira Também
Personalizar os comandos e a faixa de opções
Passar parâmetros para uma URL usando a faixa de opções
<CrmParameter> (RibbonDiffXml)
<JavaScriptFunction> (RibbonDiffXml)
<Url> (RibbonDiffXml)
Definir ações da faixa de opções
Definir as ações personalizadas para modificar a faixa de opções
Microsoft Dynamics 365
© 2017 Microsoft. Todos os direitos reservados. Direitos autorais