Fonctions EditForm, NewForm, SubmitForm, ResetForm et ViewForm dans PowerAppsEditForm, NewForm, SubmitForm, ResetForm, and ViewForm functions in PowerApps

Affichez, modifiez ou créez un élément, enregistrez le contenu et réinitialisez les contrôles dans un contrôle Edit form.View, edit, or create an item, save the contents, and reset the controls in an Edit form control.

Vue d’ensembleOverview

Ces fonctions modifient l’état du contrôle Edit Form.These functions change the state of the Edit form control. Le contrôle de formulaire peut être dans un des modes suivants :The form control can be in one of these modes:

ModeMode DescriptionDescription
FormMode.EditFormMode.Edit Le formulaire est rempli avec un enregistrement actuel et l’utilisateur peut modifier les valeurs des champs.The form is populated with an existing record and the user can modify the values of the fields. Une fois qu’il a terminé, l’utilisateur peut enregistrer les modifications apportées à l’enregistrement.Once complete, the user can save the changes to the record.
FormMode.NewFormMode.New Le formulaire est rempli avec les valeurs par défaut et l’utilisateur peut modifier les valeurs des champs.The form is populates with default values and the user can modify the values of the fields. Une fois qu’il a terminé, l’utilisateur peut ajouter l’enregistrement à la source de données.Once complete, the user can add the record to the data source.
FormMode.ViewFormMode.View Le formulaire est rempli avec un enregistrement actuel mais l’utilisateur ne peut pas modifier les valeurs des champs.The form is populated with an existing record but the user cannot modify the values of the fields.

DescriptionDescription

Ces fonctions sont souvent appelées à partir de la formule OnSelect d’un contrôle Button ou Image, afin que l’utilisateur puisse enregistrer ou abandonner des modifications, ou créer un enregistrement.These functions are often invoked from the OnSelect formula of a Button or Image control so that the user can save edits, abandon edits, or create a record. Vous pouvez utiliser des contrôles avec ces fonctions, afin de créer une solution complète.You can use controls and these functions together to create a complete solution.

Ces fonctions ne renvoient aucune valeur.These functions return no values.

Fonction SubmitFormSubmitForm

Utilisez la fonction SubmitForm dans la propriété OnSelect d’un contrôle Button pour enregistrer les modifications apportées dans un contrôle de formulaire au sein de la source de données.Use the SubmitForm function in the OnSelect property of a Button control to save any changes in a Form control to the data source.

Avant de soumettre des modifications, cette fonction vérifie les problèmes de validation associés aux champs signalés comme obligatoires, ou dont la valeur présente une ou plusieurs contraintes.Before submitting any changes, this function checks for validation issues with any field that's marked as required or that has one or more constraints on its value. Ce comportement correspond à celui de la fonction Validate.This behavior matches that of the Validate function.

La fonction SubmitForm vérifie également la propriété Valid du formulaire, qui regroupe toutes les propriétés Valid des contrôles Card que contient le contrôle de formulaire.SubmitForm also checks the Valid property of the Form, which is an aggregation of all the Valid properties of the Card controls that the Form control contains. En cas de problème, les données ne sont pas envoyées et les propriétés Error et ErrorKind du contrôle Form sont définies en conséquence.If a problem occurs, the data isn't submitted, and the Error and ErrorKind properties of the Form control are set accordingly.

Si la validation réussit, la fonction SubmitForm soumet la modification à la source de données.If validation passes, SubmitForm submits the change to the data source.

  • En cas de réussite, le comportement OnSuccess du formulaire est exécuté et les propriétés Error et ErrorKind sont effacées.If successful, the Form's OnSuccess behavior runs, and the Error and ErrorKind properties are cleared. Si le formulaire a adopté le mode FormMode.New, il revient au mode FormMode.Edit.If the form was in FormMode.New mode, it is returned to FormMode.Edit mode.
  • En cas d’échec, le comportement OnFailure du formulaire est exécuté et les propriétés Error et ErrorKind sont définies en conséquence.If unsuccessful, the Form's OnFailure behavior runs, and the Error and ErrorKind properties are set accordingly. Le mode du formulaire reste le même.The mode of the form is unchanged.

Fonction EditFormEditForm

La fonction EditForm remplace le mode du contrôle de formulaire par FormMode.Edit.The EditForm function changes the Form control's mode to FormMode.Edit. Dans ce mode, le contenu de la propriété Item du contrôle de formulaire est utilisé pour remplir le formulaire.In this mode, the contents of the Form control's Item property are used to populate the form. Si la fonction SubmitForm s’exécute lorsque le formulaire est dans ce mode, un enregistrement est modifié, et non créé.If the SubmitForm function runs when the form is in this mode, a record is changed, not created. FormMode.Edit est la valeur par défaut pour le contrôle de formulaire.FormMode.Edit is the default for the Form control.

Fonction NewFormNewForm

La fonction NewForm remplace le mode du contrôle de formulaire par FormMode.New.The NewForm function changes the Form control's mode to FormMode.New. Dans ce mode, le contenu de la propriété Item du contrôle de formulaire est ignoré, et les valeurs par défaut de la propriété DataSource sont insérées dans le formulaire.In this mode, the contents of the Form control's Item property are ignored, and the default values of the Form's DataSource property populate the form. Si la fonction SubmitForm s’exécute lorsque le formulaire est dans ce mode, un enregistrement est créé, et non modifié.If the SubmitForm function runs when the form is in this mode, a record is created, not changed.

Fonction ResetFormResetForm

La fonction ResetForm rétablit les valeurs initiales du contenu d’un formulaire, avant toute modification effectuée par l’utilisateur.The ResetForm function resets the contents of a form to their initial values, before the user made any changes. Si le formulaire a adopté le mode FormMode.New, il est réinitialisé sur le mode FormMode.Edit.If the form is in FormMode.New mode, the form is reset to FormMode.Edit mode. Le comportement OnReset du contrôle de formulaire s’exécute également.The OnReset behavior of the form control also runs. Vous pouvez également réinitialiser des contrôles spécifiques avec la fonction Reset, mais uniquement à partir du formulaire.You can also reset individual controls with the Reset function but only from within the form.

ViewFormViewForm

La fonction ViewForm remplace le mode du contrôle de formulaire par FormMode.View.The ViewForm function changes the Form control's mode to FormMode.View. Dans ce mode, le contenu de la propriété Item du contrôle de formulaire est utilisé pour remplir le formulaire.In this mode, the contents of the Form control's Item property are used to populate the form. Les fonctions SubmitForm et RestForm n’ont aucun effet dans ce mode.The SubmitForm and RestForm functions have no effect when in this mode.

Propriété DisplayModeDisplayMode Poperty

Le mode actuel peut être lu par le biais de la propriété Mode.The current mode can be read through the Mode property. Le mode détermine également la valeur de la propriété DisplayMode qui peut être utilisée par des cartes de données et des contrôles dans le contrôle de formulaire.The mode also determines the value of the DisplayMode property which can be used by data cards and controls within the form control. Souvent, la propriété DisplayMode de la carte de données est définie sur Parent.DisplayMode (qui référence le formulaire) ainsi que sur la propriété DisplayMode (qui référence la carte de données) :Often, the data card's DisplayMode property will be set to Parent.DisplayMode (refernceing the form) as will the control's DisplayMode property (referncing the data card):

ModeMode DisplayModeDisplayMode DescriptionDescription
FormMode.EditFormMode.Edit DisplayMode.EditDisplayMode.Edit Les contrôles et les cartes de données sont modifiables, prêts à accepter les modifications apportées à un enregistrement.Data cards and controls are editable, ready to accept changes to a record.
FormMode.NewFormMode.New DisplayMode.EditDisplayMode.Edit Les contrôles et les cartes de données sont modifiables, prêts à accepter un nouvel enregistrement.Data cards and controls are editable, ready to accept a new record.
FormMode.ViewFormMode.View DisplayMode.ViewDisplayMode.View Les contrôles et les cartes de données ne sont pas modifiables ni optimisés pour l’affichage.Data cards and controls are not editable and optimized for viewing.

SyntaxeSyntax

SubmitForm( FormName )SubmitForm( FormName )

  • FormName - Requis.FormName - Required. Contrôle de formulaire à envoyer à la source de données.Form control to submit to the data source.

EditForm( FormName )EditForm( FormName )

  • FormName - Requis.FormName - Required. Contrôle de formulaire devant basculer sur le mode FormMode.Edit.Form control to switch to FormMode.Edit mode.

NewForm( FormName )NewForm( FormName )

  • FormName - Requis.FormName - Required. Contrôle de formulaire devant basculer sur le mode FormMode.New.Form control to switch to FormMode.New mode.

ResetForm( FormName )ResetForm( FormName )

  • FormName - Requis.FormName - Required. Contrôle de formulaire dont les valeurs initiales doivent être rétablies.Form control to reset to initial values. Fait basculer également le formulaire du mode FormMode.New vers le mode FormMode.Edit.Also switches the form from FormMode.New mode to FormMode.Edit mode.

ViewForm( FormName )ViewForm( FormName )

  • FormName - Requis.FormName - Required. Contrôle de formulaire devant basculer sur le mode FormMode.View.Form control to switch to FormMode.View mode.

ExemplesExamples

Consultez la page Understand data forms in Microsoft PowerApps (Comprendre les formulaires de données dans Microsoft PowerApps) pour obtenir des exemples complets.See Understand data forms for complete examples.

  1. Ajoutez un contrôle Button, en définissant sa propriété Text de manière à afficher Save, et définissez sa propriété OnSelect sur la formule suivante :Add a Button control, set its Text property to show Save, and set its OnSelect property to this formula:

    SubmitForm( EditForm )SubmitForm( EditForm )

  2. Définissez la propriété OnFailure d’un contrôle de formulaire sur la valeur vide, et sa propriété OnSuccess sur la formule suivante :Set the OnFailure property of a Form control to blank and its OnSuccess property to this formula:

    Back()Back()

  3. Nommez un contrôle Label ErrorText, et définissez sa propriété Text sur cette formule :Name a Label control ErrorText, and set its Text property to this formula:

    EditForm.ErrorEditForm.Error

    Lorsque l’utilisateur sélectionne le bouton Save (Enregistrer), toutes les modifications apportées dans le contrôle de formulaire sont envoyées à la source de données sous-jacente.When the user selects the Save button, any changes in the Form control are submitted to the underlying data source.

    • Si l’envoi aboutit, toutes les modifications sont enregistrées, ou un enregistrement est créé si le contrôle de formulaire a adopté le mode New.If the submission succeeds, any changes are saved or, if the Form control is in New mode, a record is created. Le paramètre ErrorText est vide et l’écran précédent réapparaît.ErrorText is blank and the previous screen reappears.
    • Si l’envoi échoue, le paramètre ErrorText affiche un message d’erreur convivial ; l’écran actuel reste visible, afin que l’utilisateur puisse corriger le problème et réessayer.If the submission fails, ErrorText shows a user-friendly error message, and the current screen remains visible so that the user can correct the problem and try again.
  4. Ajoutez un contrôle Button, en définissant sa propriété Text de manière à afficher Cancel (Annuler), et définissez sa propriété OnSelect sur la formule suivante :Add a Button control, set its Text property to show Cancel, and set its OnSelect property to this formula:

    ResetForm( EditForm ); Back()ResetForm( EditForm ); Back()

    Lorsque l’utilisateur sélectionne le bouton Cancel (Annuler), les valeurs affichées dans le contrôle de formulaire sont réinitialisées sur leur valeur avant les modifications apportées par l’utilisateur ; l’écran précédent réapparaît et le contrôle de formulaire revient au mode Edit (Modifier) (si son mode était New).When the user selects the Cancel button, the values in the Form control are reset to what they were before the user started to edit it, the previous screen reappears, and the Form control is returned to Edit mode if it was in New mode.

  5. Ajoutez un contrôle Button, en définissant sa propriété New de manière à afficher Save (Enregistrer), et définissez sa propriété OnSelect sur la formule suivante :Add a Button control, set its Text property to show New, and set its OnSelect property to this formula:

    NewForm( EditForm ); Navigate( EditScreen, None )NewForm( EditForm ); Navigate( EditScreen, None )

    Lorsque l’utilisateur sélectionne le bouton New (Nouveau), le contrôle de formulaire bascule sur le mode New. Les valeurs par défaut de la source de données du contrôle de formulaire sont insérées dans ce contrôle, et l’écran qui contient le contrôle de formulaire s’affiche.When the user selects the New button, the Form control switches to New mode, the default values for the Form control's data source populate that control, and the screen that contains the Form control appears. Lorsque la fonction SubmitForm s’exécute, un enregistrement est créé, et non mis à jour.When the SubmitForm function runs, a record is created instead of updated.