Automatische Validierung der Eigenschaftswerte

In der Validierung Registerkarte des Eigenschaftsdefinition Dialogfelds können Sie die Kriterien definieren, die die Werte einer spezifischen Eigenschaft erfüllen sollten. Mithilfe der Validierung können Sie z. B. überprüfen, ob der Eigenschaftswert die festgelegte Anzahl an Zeichen enthält. Auf diese Art können Sie prüfen, ob die Kundentelefonnummer oder Rechnungsnummer richtig zum Metadatenformular hinzugefügt wurde. Sie können außerdem überprüfen, ob beispielsweise der Wert in Bezug auf andere Eigenschaften akzeptiert werden kann, oder ob überhaupt ein Wert eingetragen ist.

Die Gültigkeit wird mittels Variablen, allgemeinen Funktionen von VBScript und der M-Files API festgelegt. Die folgenden M-Files Variablen könne für die Validierung der Eigenschaftswerte verwendet werden: PropertyDef, PropertyValue, ObjVer, DisplayID, Vault, CurrentUserID, CurrentUserSessionInfo, VaultSharedVariables, SavepointVariables, TransactionCache, MFScriptCancel, GetExtensionObject, MasterTransactionID, CurrentTransactionID, ParentTransactionID. Weitere Informationen zu Variablen finden Sie im Abschnitt Verfügbare VBScript-Variablen.

Hinweis: Wenn Sie neue Erweiterungen entwickeln oder bestehende bearbeiten, empfehlen wir, VBScript-Inhalte für zukünftige Kompatibilität durch Vault Application Framework (VAF)-kompatiblen Code zu ersetzen. Weitere Informationen zu den Vorteilen der VAF-Entwicklung gegenüber VBScript finden Sie unter The Vault Application Framework in M-Files Developer Portal.

Standardmäßig wird die Validierung als erfolgreich betrachtet. Ungültige Werte werden deshalb durch Anweisungen, die an Bedingungen geknüpft sind, erkannt, sodass beim Eintreffen einer solchen Bedingung die von der Validierung betroffen ist, eine Fehlerausgabe erfolgt, die den Benutzer dazu auffordert, den falschen Wert zu korrigieren (beispielsweise Err.Raise MFScriptCancel, „Die Eigenschaft muss eine Eigenschaft aufweisen, die mindestens 10 Zeichen enthält“).

Vervollständigen Sie die folgenden Schritte, um die Validierung des Werts für eine Eigenschaft hinzuzufügen:

  1. M-Files Admin öffnen.
  2. In der hierarchischen Ansicht auf der linken Seite, eine Verbindung zum M-Files Server erweitern.
  3. Dokumentenverwaltungen erweitern.
  4. Eine Dokumentenverwaltung erweitern.
  5. Die Metadatenstruktur (Flache Ansicht) erweitern.
  6. Auf Eigenschaftsdefinitionen klicken.
  7. Entweder:
    • In der Eigenschaftendefinitionen Liste auf Eigenschaft rechtsklicken, deren Werte automatisch validiert werden sollen und Eigenschaften aus dem Kontextmenü auswählen.
      oder
    • Im Aufgabenbereich auf Neue Eigenschaftsdefinition klicken, um eine neue Eigenschaftsdefinition mit einer automatischen Prüfung der Werte herzustellen.
    Ergebnis:Das Eigenschaften der Eigenschaftendefinition Dialogfeld öffnet sich.
  8. Die Gültigkeit Registerkarte öffnen.
    Ergebnis:Das Gültigkeit wird geöffnet.
  9. Die Validierung mit VBScriptOption auswählen und die Code bearbeiten... Schaltfläche anklicken.
    Ergebnis:Das VBScript-Code bearbeiten Fenster wird geöffnet.
  10. Im VBScript Code bearbeiten Fenster den VBScript-Code zur Validierung der Werte dieser Eigenschaft eingeben.
    Beispiel:Falls die Werte dieser Eigenschaft wenigstens 10 Zeichen aufweisen müssen, können Sie folgenden Code verwenden: 
    Option Explicit

Dim propertyName, value

propertyName = PropertyDef.Name

value = PropertyValue.GetValueAsUnlocalizedText

If Len(value) < 10 Then

    Err.Raise MFScriptCancel, "The property """ & propertyName & """ must have a value of at least 10 characters."

End If
    Hinweis: Die M-Files API Dokumentation ist online verfügbar: M-Files API.
  11. Das VBScript-Code bearbeiten Fenster schließen und dann auf Übernehmen im Eigenschaften der Eigenschaftsdefinition Dialogfeld klicken, um die Änderungen zu speichern.
Die eingegebenen Werte für die ausgewählte Eigenschaft werden nun automatisch validiert. Wenn Sie einen Wert für die Eigenschaft im Metadatenformular eingeben, wird dieser Wert validiert und bei Nichterfüllung der spezifizierten Kriterien wird die Aktion, die im Validierungsscript festgehalten ist, ausgeführt (zusätzlich wird eine Fehlermeldung eingeblendet).