Validation automatique des valeurs de propriété

Dans l’onglet Validation de la boîte de dialogue Propriétés de la Propriété, vous pouvez définir les critères que les valeurs d’une propriété spécifique doivent remplir. Par exemple, grâce à la validation, vous pouvez garantir que la valeur de propriété contient un certain nombre de caractères. Ainsi, vous pouvez vérifier que le numéro de téléphone du client ou le numéro de facture est correctement ajouté à la fiche de métadonnées. Par exemple, vous pouvez aussi valider le fait que la valeur puisse être acceptée en relation avec d'autres propriétés ou que la valeur n'est pas vide.

La validation est spécifiée à l'aide de variables, de propriétés communes de VBScript et de M-Files API. Les variables suivantes M-Files peuvent servir à valider les valeurs de propriété : PropertyDef, PropertyValue, ObjVer, DisplayID, Vault, CurrentUserID, CurrentUserSessionInfo, VaultSharedVariables, SavepointVariables, TransactionCache, MFScriptCancel, GetExtensionObject, MasterTransactionID, CurrentTransactionID, ParentTransactionID. Pour davantage d'informations sur les variables, veuillez vous reporter à la section Variables VBScript disponibles.

Remarque : Lorsque vous développez de nouvelles extensions ou que vous modifiez des extensions existantes, nous vous recommandons de remplacer le contenu VBScript par du code compatible Vault Application Framework (VAF) afin d'assurer la compatibilité future. Pour plus d’informations sur les avantages du développement VAF par rapport à VBScript, reportez-vous à The Vault Application Framework dans M-Files Developer Portal.

Par défaut, la validation est considérée comme réussie. Les valeurs non valides sont ainsi détectées à l’aide d’expressions conditionnelles. Si l’une des conditions indiquées dans la validation était remplie, une erreur devrait apparaître, en incitant l’utilisateur à corriger la valeur non valide (par exemple, Err.Raise MFScriptCancel, "La propriété doit avoir une valeur d’au moins 10 caractères.").

Effectuez les étapes suivantes pour ajouter une validation des valeurs pour une propriété :

Ouvrez M-Files Admin.
Dans l'arborescence de gauche, déployez une connexion au serveur M-Files.
Déployez Coffres.
Déployez un coffre.
Développez Structure des Métadonnées (Vue Classique).
Cliquez sur Définitions de Propriétés.
Soit :
- Dans la liste Définitions de Propriétés, cliquez, à l’aide du menu bouton droit, sur la propriété dont vous souhaitez valider les valeurs automatiquement et sélectionnez Propriétés dans le menu contextuel.
  ou
- Dans le volet de commandes, cliquez sur Nouvelle Définition de Propriété pour créer une nouvelle définition de propriété avec validation automatique des valeurs.
Résultat :La boîte de dialogue Propriétés de la Propriété s’ouvre.
Rendez-vous sur l’onglet Validation.
Résultat :L’onglet Validation s’ouvre.
Sélectionnez l’option Validation VbScript et cliquez sur le bouton Editer le Code....
Résultat :La fenêtre Edition du Code VBScript s’ouvre.
Dans la fenêtre Edition du Code VbScript, saisissez le code VBScript pour valider les valeurs de cette propriété.
Exemple :Si les valeurs de cette propriété doivent avoir au moins 10 caractères, vous pouvez vous servir du code suivant :
```
Option Explicit

Dim propertyName, value

propertyName = PropertyDef.Name

value = PropertyValue.GetValueAsUnlocalizedText

If Len(value) < 10 Then

    Err.Raise MFScriptCancel, "The property """ & propertyName & """ doivent avoir une valeur d'au moins 10 caractères."

End If
```
Remarque : La documentation M-Files API est disponible en ligne : M-Files API.
Fermez la fenêtre Edition du Code VbScript, puis cliquez sur Appliquer dans la boîte de dialogue Propriétés de la Propriété afin d’enregistrer les modifications.

Les valeurs saisies pour la propriété sélectionnée sont désormais automatiquement validées. Lors de la saisie d’une valeur de propriété sur la fiche de métadonnées, la valeur est validée et, si elle ne remplit pas les critères indiqués, l’action spécifiée dans le script de validation est exécutée (par exemple, affichage d’une message d’erreur).