Partager via

getFormContext (référence de l’API client)

  • Article

Renvoie une référence au formulaire ou un élément de la grille selon l’emplacement où la méthode a été appelée.

Syntaxe

ExecutionContextObj.getFormContext()

Valeur retournée

Type : Objet

Description : Renvoie une référence au formulaire ou à un élément du formulaire, par exemple une grille modifiable selon l’emplacement d’appel de la méthode. Cette méthode vous permet de créer des gestionnaires d’événements communs qui peuvent s’exécuter sur un formulaire ou un élément du formulaire selon l’emplacement d’appel.

Exemple

L’exemple de code suivant montre comment créer une méthode qui définit la notification sur une colonne de formulaire ou une cellule de grille modifiable en fonction de l’endroit où vous avez enregistré le script (événement OnChange de colonne ou événement de grille modifiable OnChange) :

function commonEventHandler(executionContext) {
    var formContext = executionContext.getFormContext();    
    var telephoneAttr = formContext.data.entity.attributes.get('telephone1');
    var isNumberWithCountryCode = telephoneAttr.getValue().substring(0,1) === '+';

    // telephoneField will be a form control if invoked from a form OnChange event;
    // telephoneField will be a editable grid GridCell object if invoked from editable grid OnChange event.
    var telephoneField = telephoneAttr.controls.get(0);

    if (!isNumberWithCountryCode) {
        telephoneField.setNotification('Please include the country code beginning with '+'.', 'countryCodeNotification');
    }
    else {
        telephoneField.clearNotification('countryCodeNotification');
    }
}

Contexte d’exécution
Contexte de formulaire

Notes

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).