Festlegen eines Automatischen Eigenschaftswerts mittels VBScript

Hinweis: Dieser Inhalt wird nicht mehr aktualisiert. Den neuesten Inhalt finden Sie im Benutzerhandbuch für M-Files Online. Informationen zu den unterstützten Produktversionen finden Sie in unserer Lebenszyklus-Richtlinie.

Benutzerdefinierte automatische und berechnete Werte können mit den allgemeinen Funktionen von M-Files API und VBScript genauer festgelegt werden ("Microsoft Visual Basic Scripting Edition"). Dieser Abschnitt enthält Anweisungen zur Verwendung von VBScript mit automatischen Werten.

Hinweis: Bezüglich VBScript-Benutzerhandbuch und Sprachreferenz, siehe VBScript MSDN Artikel.

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 mithilfe der folgenden VBScript-Variablen verarbeiten.

  • 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 die Code bearbeiten... Schaltfläche klicken.
    Ergebnis:Das VBScript-Code bearbeiten Fenster wird geöffnet.
  10. Den VBScript-Code zur Berechnung des automatischen Werts festlegen.
    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.