Ominaisuuksien arvojen automaattinen tarkistus

Tarkistus-välilehden Ominaisuusmäärittelyn ominaisuudet -ikkunassa voit määrittää ehdot, jotka tietyn ominaisuuden arvojen tulee täyttää. Tarkistuksella voit esimerkiksi varmistaa, että ominaisuuden arvo sisältää vaaditun määrän merkkejä. Näin voidaan varmistaa, että asiakkaan puhelinnumero tai laskunumero lisätään metatietokorttiin oikein. Lisäksi voidaan esimerkiksi tarkistaa, voidaanko arvo hyväksyä muut ominaisuudet huomioon ottaen tai että arvo ei saa olla tyhjä.

Tarkistus määritellään muuttujia, VBScriptin yleisiä ominaisuuksia ja M-Files APIa käyttämällä. Ominaisuuksien arvojen tarkistukseen voidaan käyttää seuraavia M-Files-muuttujia: PropertyDef, PropertyValue, ObjVer, DisplayID, Vault, CurrentUserID, CurrentUserSessionInfo, VaultSharedVariables, SavepointVariables, TransactionCache, MFScriptCancel, GetExtensionObject, MasterTransactionID, CurrentTransactionID ja ParentTransactionID. Katso lisätietoja muuttujista kohdasta Käytettävissä olevat VBScript-muuttujat.

Oletusarvoisesti tarkistuksen oletetaan onnistuvan. Näin ollen virheelliset arvot tunnistetaan ehtolauseiden avulla. Jos jokin tarkistuksen määritellyistä ehdoista täyttyy, tulisi muodostaa virhe ja kehottaa käyttäjää korjaamaan virheellinen arvo (esimerkiksi Err.Raise MFScriptCancel, "Ominaisuuden arvossa on oltava vähintään 10 merkkiä.").

Lisää ominaisuudelle arvon tarkistus 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ä).
  6. Valitse Ominaisuusmäärittelyt.
  7. Joko:
    • Napsauta Ominaisuusmäärittelyt-listassa hiiren oikealla painikkeella ominaisuutta, jonka arvot haluat tarkistaa automaattisesti, ja valitse Ominaisuudet pikavalikosta.
      tai
    • Luo uusi ominaisuusmäärittely automaattisella arvotarkistuksella valitsemalla tehtäväalueella Uusi ominaisuusmäärittely.
    Tulos:Ominaisuusmäärittelyn ominaisuudet -ikkuna avautuu.
  8. Siirry Tarkistus-välilehdelle.
    Tulos:Tarkistus-välilehti avautuu.
  9. Valitse Tarkistus VBScriptillä -vaihtoehto ja napsauta Muokkaa koodia... -painiketta.
    Tulos:Muokkaa VBScript-koodia -ikkuna avautuu.
  10. Kirjoita Muokkaa VBScript-koodia -ikkunaan VBScript-koodia tämän ominaisuuden arvojen tarkistusta varten.
    Esimerkki:Jos tämän ominaisuuden arvossa täytyy olla vähintään 10 merkkiä, voit käyttää seuraavaa koodia:
    Option Explicit

Dim propertyName, value

propertyName = PropertyDef.Name

value = PropertyValue.GetValueAsUnlocalizedText

If Len(value) < 10 Then

    Err.Raise MFScriptCancel, "Ominaisuuden """ & propertyName & """ arvossa on oltava vähintään 10 merkkiä."

End If
    Huomaa: M-FilesAPI -dokumentaatio on saatavilla verkossa: M-Files API. Jos haluat lisätietoja VBScriptin käyttämisestä M-Filesissa, katso Miten kirjoitan VBScript-koodin M-Filesia varten?.
  11. Sulje Muokkaa VBScript-koodia -ikkuna ja napsauta sitten Käytä Ominaisuusmäärittelyn ominaisuudet -ikkunassa, jotta muutoksesi tallentuvat.
Valitun ominaisuuden arvot tarkistetaan nyt automaattisesti. Kun ominaisuudelle annetaan arvo metatietokorttiin, se tarkistetaan. Jos määritetyt ehdot eivät täyty, suoritetaan tarkistuksen komentosarjassa määritetty toiminto (esim. näytetään virheilmoitus).