Escrever scripts para subgrades

Publicado: novembro de 2016

Aplicável a: Dynamics CRM 2015

Com o Atualização 1 do Microsoft Dynamics CRM Online 2015, você pode fazer mais com controles de subgrade em formulários usando novos eventos e objetos.

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 (referência do cliente)
Coleções (referência do cliente)
Criar códigos para os formulários do Microsoft Dynamics CRM 2015
Escrever as extensões do aplicativo do cliente

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais