Contexto de grid da API do cliente

O contexto de grade da API do Cliente ajuda você a acessar e trabalhar com dados tabulares em grades e subgrids em um formulário. As grades podem abranger todo o formulário ou aparecer como itens de formulário chamados subgrids.

O contexto da grade da API do Cliente fornece uma referência a uma grade ou a uma subgrade em um formulário na qual o código atual é executado.

Use o formContext para obter uma instância do formulário em que o código é executado e, em seguida, recupere o controle de subgrid no formulário. Por exemplo, quando você souber o nome de um controle de subgrid (digamos, o subgrid Contatos no formulário de conta padrão), poderá acessá-lo usando o seguinte código:

function doSomething(executionContext) {
   var formContext = executionContext.getFormContext(); // get the form Context
   var gridContext = formContext.getControl("Contacts"); // get the grid context

   // Perform operations on the subgrid
}

Limitações

• A obtenção do contexto de uma grade (que abrange todo o formulário) tem suporte apenas em comandos da faixa de opções. Para obter mais informações, consulte Contexto de formulário e grade em ações da faixa de opções.
• Chamadas para getControl() não são compatíveis quando você usa gridContext.
• Os contextos de grade têm a mesma validade que o contexto de execução. Depois que o manipulador de eventos do contexto de execução terminar, esses contextos exigem cuidado extra ao serem usados. Consulte Usando objetos de contexto de forma assíncrona.

Artigos relacionados

Contexto de formulário da API do cliente
Contexto de execução da API do cliente
Entender o modelo de objeto da API do cliente
Grades e subgrades