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:

Avaa M-Files Admin.
Laajenna vasemman reunan puunäkymässä M-Files-palvelinyhteys.
Laajenna Dokumenttivarastot.
Laajenna varasto.
Laajenna Metatietojen rakenne (tasainen näkymä) ja valitse sitten Ominaisuusmäärittelyt.
Tulos:Ominaisuusmäärittely-lista avautuu oikeanpuoleiseen paneeliin.
Kaksoisnapsauta ominaisuusmäärittelyä, jota haluat muokata.
Tulos:Ominaisuusmäärittelyn ominaisuudet -ikkuna avautuu.
Siirry Automaattiset arvot -välilehdelle.
Tulos:Automaattiset arvot -välilehti avautuu.
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ä.
Napsauta Muokkaa koodia ‑painiketta.
Tulos:Muokkaa VBScript-koodia -ikkuna avautuu.
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
```
Sulje Muokkaa VBScript-koodia -ikkuna, kun olet valmis.
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.