Automaattisen ominaisuusarvon määritys VBScriptin avulla

Mukautettujen automaattisten arvojen ja laskettujen arvojen muodostaminen voidaan määritellä yksityiskohtaisemmin M-Files APIa ja VBScriptin (”Microsoft Visual Basic Scripting Edition”) yleisiä ominaisuuksia käyttämällä. Tässä osiossa kerrotaan ohjeet VBScriptin käyttämiseen automaattisten arvojen kanssa. Lisätietoja VBScript-käyttöoppaasta ja kieliohjeet saat VBScript MSDN -artikkelista.

Huomaa: Kun kehität uusia laajennuksia tai muokkaat olemassa olevia, suosittelemme korvaamaan VBScriptin sisällön Vault Application Framework (VAF) -yhteensopivalla koodilla. Näin varmistat yhteensopivuuden myös jatkossa. Katso lisätietoja VAF-kehityksen hyödyistä VBScriptiin verrattuna M-Files Developer Portalin kohdasta The Vault Application Framework.

Lasketun arvon VBScript-koodi suoritetaan aina, kun ominaisuusarvoa muokataan. VBScript-koodia käytetään automaattisen arvon laskemiseen, minkä jälkeen laskennan tulos on asetettava Output-nimiseen muuttujaan. Tämä arvo tallentuu ominaisuuden arvoksi kohteen metatietoihin.

Yksinkertaisimmillaan automaattisen arvon muodostava VBScript-koodi voisi siksi olla esimerkiksi seuraava:

Output = "Automaattinen arvo"

Yleensä automaattinen arvo halutaan muodostaa kohteen muiden ominaisuuksien perusteella, esimerkiksi yhdistelemällä ominaisuuksia. VBScript-koodissa voidaan hyödyntää saman tai jonkin muun kohteen ominaisuuksien arvoja ja perustietoja seuraavien VBScript-koodin muuttujien avulla:

  • CurrentUserID
  • DisplayID
  • LastUsed
  • MFScriptCancel
  • ObjVer
  • Output
  • PropertyDef
  • PropertyValues
  • Vault
  • VaultSharedVariables
Katso muuttujien kuvaukset kohdasta Käytettävissä olevat VBScript-muuttujat.
Huomaa: Joitakin ominaisuusmäärittelyjä ei näytetä silloin, kun käytetään PropertyValues -muuttujaa komentosarjoissa (katso Ominaisuusmäärittelyt, joita ei näytetä komentosarjoille).

Kun haluat käyttää VBScriptiä automaattisen arvon laskemiseen ominaisuudelle, toimi seuraavasti:

  1. Avaa M-Files Admin.
  2. Laajenna vasemman reunan puunäkymässä M-Files-palvelinyhteys.
  3. Laajenna Dokumenttivarastot.
  4. Laajenna varasto.
  5. Laajenna Metatietojen rakenne (tasainen näkymä) ja valitse sitten Ominaisuusmäärittelyt.
    Tulos:Ominaisuusmäärittely-lista avautuu oikeanpuoleiseen paneeliin.
  6. Kaksoisnapsauta ominaisuusmäärittelyä, jota haluat muokata.
    Tulos:Ominaisuusmäärittelyn ominaisuudet -ikkuna avautuu.
  7. Siirry Automaattiset arvot -välilehdelle.
    Tulos:Automaattiset arvot -välilehti avautuu.
  8. Valitse joko:
    • Mukautettu automaattinen numerointi (VBScript): Valitse tämä vaihtoehto, jos haluat määrittää automaattisen numeroinnin VBScriptillä.
      tai
    • Laskettu arvo (VBScript): Valitse tämä vaihtoehto, jos haluat määrittää jonkin muuntyyppisen automaattisen arvon VBScriptillä.
  9. Napsauta Muokkaa koodia ‑painiketta.
    Tulos:Muokkaa VBScript-koodia -ikkuna avautuu.
  10. Määritä VBScript-koodi automaattisen arvon laskemista varten. Katso ohjeet kohdasta Automaattisen ominaisuusarvon määritys VBScriptin avulla.
    Esimerkki:Seuraava koodi muodostaa ominaisuusmäärittelylle ”Tarjouksen otsikko” automaattisen arvon hyödyntämällä kohteen metatiedoissa olevia tietoja tarjousnumerosta ja asiakkaasta. Tarjousnumero-ominaisuusmäärittelyn ID on tässä esimerkissä 1156 ja Asiakas-ominaisuusmäärittelyn ID on 1288. Jos dokumentin tarjousnumero on 5577 ja asiakas ESTT-yhtiöt, alla oleva koodi muodostaa tarjouksen otsikoksi tekstin "Proposal #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. Sulje Muokkaa VBScript-koodia -ikkuna, kun olet valmis.
  12. Kun olet taas Ominaisuusmäärittelyn ominaisuudet -ikkunassa, napsauta OK. Tekemäsi muutokset tallennetaan ja Ominaisuusmäärittelyn ominaisuudet -ikkuna sulkeutuu.
Valitulla ominaisuudella on nyt automaattinen arvo, joka lasketaan juuri määrittämälläsi VBScript-koodilla.