Festlegen eines Automatischen Eigenschaftswerts mittels VBScript

Benutzerdefinierte automatische und berechnete Werte können mit der M-Files API und den allgemeinen VBScript („Microsoft Visual Basic Scripting Edition“) Funktionen genauer festgelegt werden. Dieser Abschnitt enthält Anweisungen zur Verwendung von VBScript mit automatischen Werten. Bezüglich VBScript-Benutzerhandbuch und Sprachreferenz, siehe VBScript MSDN Artikel.

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.

Der VBScript-Code für einen berechneten Wert wird immer dann ausgeführt, wenn ein Eigenschaftswert bearbeitet wird. Der VBScript-Code wird dazu verwendet, den automatischen Wert zu berechnen, wobei das Resultat der Berechnung anschließend einer Variablen mit Namen Ausgabe zugewiesen werden muss. Dieser Wert wird als Wert der Eigenschaft in den Metadaten des Objekts gespeichert.

Ein grundlegendes VBScript-Element zur Festlegung eines automatischen Werts könnte somit wie folgt aussehen:

Output = "Automatic value"

Normalerweise verwendet ein automatischer Wert andere Objekteigenschaften, indem diese z.B. verknüpft werden. Der VBScript-Code kann die Eigenschaftswerte und grundlegenden Informationen desselben oder eines anderen Objekts mit diesen VBScript-Variablen verwenden:

  • CurrentUserID
  • DisplayID
  • LastUsed
  • MFScriptCancel
  • ObjVer
  • Output
  • PropertyDef
  • PropertyValues
  • Vault
  • VaultSharedVariables
Für die Variablenbeschreibungen, siehe Verfügbare VBScript-Variablen.
Hinweis: Einige Eigenschaftsdefinitionen werden nicht dargestellt, wenn die PropertyValues Variable in Scripts eingesetzt wird (siehe Eigenschaftsdefinitionen, die für Scripts nicht angezeigt werden.).

Die folgenden Schritte ausführen, um VBScript zur Berechnung eines automatischen Wert für eine Eigenschaft zu verwenden:

  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. Metadatenstruktur (Flache Ansicht) erweitern und dann Eigenschaftsdefinitionen auswählen.
    Ergebnis:Die Eigenschaftendefinitionen Liste öffnet sich in der rechten Leiste.
  6. Doppelklicken auf die Eigenschaftendefinition, die Sie bearbeiten wollen.
    Ergebnis:Das Eigenschaften der Eigenschaftendefinition Dialogfeld öffnet sich.
  7. Zur Automatische Werte Registerkarte gehen.
    Ergebnis:Die Automatische Werte Registerkarte wird geöffnet.
  8. Ein der folgenden Versionen auswählen:
    • Benutzerdefinierte automatische Nummerierung (VBScript): Diese Option auswählen, falls Sie die automatische Nummerierung unter Anwendung von VBScript definieren wollen.
      oder
    • Berechneter Wert (VBScript): Diese Option auswählen, falls Sie einen beliebigen anderen automatischen Wert unter Anwendung von VBScript definieren wollen.
  9. Auf Code bearbeiten klicken.
    Ergebnis:Das VBScript-Code bearbeiten Fenster wird geöffnet.
  10. Den VBScript-Code zur Berechnung des automatischen Werts festlegen. Siehe Festlegen eines Automatischen Eigenschaftswerts mittels VBScript für weitere Anleitungen.
    Beispiel:Der nachfolgende Code erstellt einen automatischen Wert für die Eigenschaft „Angebotstitel“. Dabei werden die Angebotsnummer sowie die Kundeninformationen in den Metadaten des Objekts verwendet. Die ID der Eigenschaft Angebotsnummer lautet 1156 und die ID der Eigenschaft Kunde 1288. Falls ein Dokument beispielsweise über die Angebotsnummer 5577 verfügt und der Kunde „ESTT“ heißt, erzeugt der nachfolgende Code als Titel des Angebots folgende Zeichenfolge: "Angebot #5577 / ESTT". 
    Option Explicit

' Get proposal number.

Dim szNumber
szNumber = PropertyValues.SearchForProperty( 1156 ).TypedValue.DisplayValue

' Get customer.

Dim szCustomer
szCustomer = PropertyValues.SearchForProperty( 1288 ).TypedValue.DisplayValue

' Create proposal title.

Dim szName
szName = "Proposal #" & szNumber & " / " & szCustomer

' Set result.

Output = szName
  11. Das VBScript-Code bearbeiten Fenster schließen, nachdem Sie fertig sind.
  12. Zurück im Eigenschaften der Eigenschaftsdefinition Dialogfeld auf OK klicken, um die Änderungen zu speichern und das Eigenschaften der Eigenschaftsdefinition Dialogfeld schließen.
Die ausgewählte Eigenschaft verfügt nun über einen automatischen Wert, der durch den VBScript-Code, den Sie festgelegt haben, berechnet wird.