Automaattisen ominaisuusarvon määritys VBScriptin avulla

Mukautettujen automaattisten arvojen ja laskettujen arvojen muodostaminen voidaan määritellä yksityiskohtaisemmin 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 -artikkelista.

Huomaa:

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:

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.