Denna version av användarhandledningen gäller för uppdateringen maj 2020 och tidigare. För det senaste innehållet, besök vår engelska användarhandledning.

Ange ett automatiskt egenskapsvärde med hjälp av VBScript

Skapande av anpassade automatiska värden och beräknade värden kan anges mer detaljerat genom att använda M-Files API och generiska funktioner i VBScript ("Microsoft Visual Basic Scripting Edition"). Det här avsnittet innehåller instruktioner för hur du använder VBScript med automatiska värden.

Notera: Användarhandlednigen för VBScript och språkreferens finns i artikeln VBScript MSDN.

VBScript-koden för ett beräknat värde utförs varje gång ett egenskapsvärde redigeras. VBScript-koden används för att beräkna det automatiska värdet. Efter det måste resultatet av beräkningen tilldelas till en variabel med namnet Utdata. Det här värdet lagras som värdet för egenskapen i objektmetadatan.

Den enklaste delen av VBScript för att formulera ett automatiskt värde kan därför se ut så här:

Utdata = "Automatiskt värde"

Vanligtvis använder ett automatiskt värde andra objektegenskaper, till exempel genom att sammanlänka dem. VBScript-kod kan utnyttja egenskapsvärdena och grundläggande information om samma eller ett annat objekt med hjälp av följande VBScript-variabler:

  • CurrentUserID
  • DisplayID
  • LastUsed
  • MFScriptCancel
  • ObjVer
  • Output
  • PropertyDef
  • PropertyValues
  • Vault
  • VaultSharedVariables
Variabelbeskrivningarna finns i Tillgängliga VBScript-variabler.
Notera: Vissa egenskapsdefinitioner visas inte vid användning av PropertyValues-variabeln i script (se Egenskapsdefinitioner visas inte för scripts).

Gör följande steg om du vill använda VBScript för att beräkna ett automatiskt värde 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.
    Resultat:Listan Egenskapsdefinitioner öppnas i höger ruta.
  5. Dubbelklicka på den egenskapsdefinition som du vill redigera.
    Resultat:Dialogrutan Egenskaper för egenskapsdefinition öppnas.
  6. Gå till fliken Automatiska värden.
    Resultat:Fliken Automatiska värden öppnas.
  7. Välj antingen:
    • Anpassad automatisk numrering (VBScript): Välj det här alternativet om du vill definiera automatisk numrering med hjälp av VBScript.
      eller
    • Beräknat värde (VBScript): Välj det här alternativet om du vill definiera någon annan typ av automatisk numrering med hjälp av VBScript.
  8. Klicka på Redigera kod....
    Resultat:Fönstret Redigera VBScript-kod öppnas.
  9. Ange VBScript-koden för att beräkna det automatiska värdet.
    Exempel:Följande kod skapar ett automatiskt värde för egenskapen "Förslagstitel" genom att använda förslagsnumret och kundinformation i objektmetadatan. ID:t för egenskapen Förslagsnummer är 1156 och ID:t för egenskapen Kund är 1288. Om ett dokument har förslagsnummer 5577 och kunden är ESTT skapar koden nedan följande sträng som titel på förslaget: "Förslag nr 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
  10. Stäng fönstret Redigera VBScript Code när du är klar.
  11. Tillbaka i dialogrutan Egenskaper för egenskapsdefinition klickar du på OK för att spara ändringarna och stänga dialogrutan Egenskaper för egenskapsdefinition.
Den valda egenskapen har nu ett automatiskt värde som beräknas av den VBScript-kod som du har angett.