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 vous assurer que la valeur de propriété contient un nombre requis 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.

Important : 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 de 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 de déclarations conditionnelles. Si l’une des conditions spécifiées dans la validation est remplie, une erreur est générée. L’erreur invite 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.".

Pour ajouter une validation de valeur 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).
Sélectionnez Définitions de Propriétés.
Soit :
- Dans la liste Définitions de Propriétés, ouvrez le menu contextuel de 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, sélectionnez 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 avec une application pour coffre ou VBScript, puis Détails.
Résultat :La fenêtre VBScript - Détails s'ouvre.

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 VBScript – Détails et sélectionnez Appliquer dans la boîte de dialogue Propriétés de la Propriété.

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).