Ominaisuuksien arvojen automaattinen tarkistus

Ominaisuusmäärittelyn ominaisuudet -valintaikkunan Tarkistus-välilehdellä voit määrittää ehdot, jotka tietyn ominaisuuden arvojen on täytettävä. Tarkistuksen avulla voit esimerkiksi varmistaa, että ominaisuuden arvo sisältää vaaditun merkkimäärän. 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.

Tärkeää: 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. Lisätietoja VAF-toteutusten hyödyistä VBScript-toteutuksiin nähden löydät The Vault Application Framework -sivulta M-Files Developer Portalista.

Oletusarvoisesti tarkistuksen oletetaan onnistuvan. Virheelliset arvot havaitaan tällöin ehdollisilla lausekkeilla. Jos jokin tarkistuksessa määritetyistä ehdoista täyttyy, järjestelmä antaa virheilmoituksen. Virheilmoitus kehottaa käyttäjää korjaamaan virheellisen arvon. Esimerkiksi Err.Raise MFScriptCancel, "Ominaisuuden arvossa on oltava vähintään 10 merkkiä."

Arvon tarkistuksen lisääminen ominaisuuteen:

  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-luettelossa hiiren oikealla painikkeella ominaisuutta, jonka arvot haluat tarkistaa automaattisesti, ja valitse pikavalikosta Ominaisuudet.
      tai
    • Luo uusi ominaisuusmäärittely, joka sisältää automaattisen arvojen tarkistuksen, 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 varastosovelluksella tai VBScriptillä ja sitten Tiedot.
    Tulos:VBScript – Tiedot -ikkuna avautuu.
  10. Syötä VBScript-koodi 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.
  11. Sulje VBScript – Tiedot -ikkuna ja valitse Ominaisuusmäärittelyn ominaisuudet -valintaikkunasta Käytä.
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).