Escrever scripts para subgrades

 

Publicado: janeiro de 2017

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

Você pode definir manipuladores para executar scripts quando dados forem carregados em subgrades. Isso fornece métodos para alterar a exibição selecionada para obter referências aos dados exibidos na grade.

Importante

Esse recurso foi apresentado na Atualização 1 do CRM Online 2015 e no CRM 2016 (local).

Neste tópico

Evento OnLoad de subgrade

Modelo de objeto de subgrade

Evento OnLoad de subgrade

As subgrades são carregadas de maneira assíncrona do formulário; então, não é possível obter acesso confiável aos dados na subgrade no evento do formulário OnLoad. Mas você pode definir um manipulador do evento para o evento OnLoad da subgrade. Esse evento ocorre sempre que os dados são atualizados na grade; isso inclui quando os usuários classificam as colunas da grade.

Não existe uma interface do usuário para adicionar novos manipuladores de eventos para esse evento; portanto, se você quiser fazer isso, use o código em outro evento, em geral o evento de formulário OnLoad para usar o método GridControl.addOnLoad. Para remover manipuladores de eventos para esse evento, use o método GridControl.removeOnLoad.

Modelo de objeto de subgrade

O diagrama a seguir mostra os objetos que podem ser acessados de uma subgrade em um formulário.

O controle de subgrade é referenciado como um GridControl no contexto. Como um controle Xrm.Page.ui, a subgrade tem todos os métodos disponíveis para todos os controles, além do método refresh.

O GridControl é o mesmo objeto passado para uma barra de comandos ou ações da faixa de opções ou regras usando o <CrmParameter> (RibbonDiffXml) quando disponível ao selecionar o parâmetro SelectedControl.

Alterar exibições com o ViewSelector

Quando uma subgrade está configurada para exibir um seletor de exibição, você pode obter ou definir a exibição atual. Use o método GridControl.getViewSelector para acessar o seletor de exibição, e os métodos ViewSelector.getCurrentViewgetCurrentView e ViewSelector.setCurrentView para obter ou definir a exibição atual com um objeto de pesquisa.

Obter dados da grade

Use o método GridControl.getGrid para acessar a grade. Use o método Grid.getRows ou o método Grid.getSelectedRows para obter uma coleção de objetos GridRow. Você pode acessar uma referência para cada registro na linha, associando os métodos GridRow.getData, GridRowData.getEntity e GridEntity.getEntityReference.

Confira Também

Objetos e métodos de grade (somente leitura) (referência do cliente)
Coleções (referência do cliente)
Crie códigos para os formulários do Microsoft Dynamics 365
Estender o Microsoft Dynamics 365 no cliente

Microsoft Dynamics 365

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais