Verifiera egenskapsvärden automatiskt

På fliken Verifiering i dialogrutan Egenskaper för egenskapsdefinition kan du definiera de kriterier som värdena för en specifik egenskap ska uppfylla. Med verifiering kan du till exempel se till att egenskapsvärdena innehåller ett visst antal tecken. På så sätt kan du verifiera att kundens telefonnummer eller fakturanummer läggs till rätt på metadatakortet. Du kan också verifiera bland annat att värdet kan godkännas i relation till andra egenskaper eller att värdet inte är tomt.

Verifiering anges med hjälp av variabler, allmänna funktioner i VBScript och M-Files API. Följande M-Files-variabler kan användas för att verifiera egenskapsvärden: PropertyDef, PropertyValue, ObjVer, DisplayID, Vault, CurrentUserID, CurrentUserSessionInfo, VaultSharedVariables, SavepointVariables, TransactionCache, MFScriptCancel, GetExtensionObject, MasterTransactionID, CurrentTransactionID, ParentTransactionID. Mer information om variablerna finns i Tillgängliga VBScript-variabler.

Som standard anses verifiering ha genomförts. Ogiltiga värden upptäcks med hjälp av villkorssatser och om något av villkoren som anges i verifieringen uppfylls ska ett fel skapas. Det uppmanar användaren att korrigera det felaktiga värdet (till exempel Err.Raise MFScriptCancel, ”Egenskapen måste ha ett värde med minst 10 tecken.”).

Gör följande för att lägga till värdeverifiering för en egenskap:

  1. Öppna M-Files Admin.
  2. I trädvyn på vänster sida visar du den önskade anslutningen till M-Files Server.
  3. I trädvyn på vänster sida visar du Dokumentvalv och sedan önskat valv.
  4. Stanna kvar i den vänstra trädvyn och visa Metadatastruktur (platt vy). Välj sedan Egenskapsdefinitioner.
  5. Du kan antingen göra så här:
    • I listan Egenskapsdefinitioner högerklickar du på egenskapen och de värden som du vill verifiera automatiskt. Välj sedan Egenskaper i kontextmenyn.
      eller
    • Klicka på Ny egenskapsdefinition... på aktivitetsområde för att skapa en ny egenskapsdefinition med automatisk värdeverifiering.
    Resultat:Dialogrutan Egenskaper för egenskapsdefinition öppnas.
  6. Gå till fliken Verifiering.
    Resultat:Fliken Verifiering öppnas.
  7. Välj alternativet Verifiering med VBScript och klicka på knappen Redigera kod....
    Resultat:Fönstret Redigera VBScript-kod öppnas.
  8. I fönstret Redigera VBScript-kod skriver du VBScript-koden för att verifiera egenskapens värden.
    Exempel:Om denna egenskaps värden måste ha minst 10 tecken skulle du kunna använda följande kod:
    Option Explicit Dim propertyName, value propertyName = PropertyDef.Name value = PropertyValue.GetValueAsUnlocalizedText If Len(value) < 10 Then Err.Raise MFScriptCancel, "The property """ & propertyName & """ måste ha ett värde med minst 10 tecken." Avsluta om
    Notera: Dokumentationen om M-Files API finns på www.m-files.com/api/documentation/latest. Mer information om att använda VBScript i M-Files finns i Hur skriver jag VBScript-kod för M-Files-syften?-självstudierna.
  9. Stäng fönstret Redigera VBScript-kod och klicka sedan på Tillämpa i dialogrutan Egenskaper för egenskapsdefinition för att spara ändringarna.
De värden som har angetts för den valda egenskapen verifieras nu automatiskt. När du anger ett värde för egenskapen på metadatakortet verifieras värdet. Om det inte uppfyller angivna kriterier utförs åtgärden som anges i verifieringsscriptet (till exempel att visa ett felmeddelande).