Contexte de grille de l’API client

Le contexte de grille d’API client vous permet d’accéder aux données tabulaires et de les utiliser dans des grilles et des sous-réseaux dans un formulaire. Les grilles peuvent s’étendre sur l’intégralité du formulaire ou apparaître sous forme d’éléments de formulaire appelés sous-réseaux.

Le contexte de grille d’API client fournit une référence à un sous-réseau sur un formulaire sur lequel le code actuel est exécuté.

Utilisez formContext pour obtenir une instance du formulaire où le code est exécuté, puis récupérez le contrôle de sous-réseau sur le formulaire. Par exemple, si vous connaissez le nom d’un contrôle de sous-grille (par exemple, la sous-grille Contacts du formulaire de compte par défaut), vous pouvez y accéder en utilisant le code suivant :

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
}

Limites

• La récupération du contexte d’une grille (s’étendant à l’ensemble du formulaire) est uniquement prise en charge par les commandes du ruban. Pour plus d’informations, consultez le contexte de formulaire et de grille dans les actions du ruban.
• Les appels à getControl() ne sont pas pris en charge lorsque vous utilisez gridContext.
• Les contextes de grille ont la même validité que leur contexte d’exécution. Une fois que le gestionnaire d’événements pour le contexte d’exécution a terminé, l’utilisation de ces contextes nécessite un soin particulier. Consultez Utilisation asynchrone d’objets de contexte.

Articles associés

Contexte de formulaire de l’API client
Contexte d’exécution de l’API client
Comprendre le modèle objet de l’API client
Grilles et sous-grilles