Expression -handler käyttää Python-lauseketta arvon luomiseen pääattribuutille. Handler laskee lausekkeen ja palauttaa tuloksen automaattisesti pääattribuutin datakenttään sen jälkeen, kun tietokortti on tallennettu. Huomaa, että tuloksen sisältämiä HTML-tageja ei koodata (escape).

Mukautetut moduulit voidaan tallentaa hakemistoon, joka on määritetty alustan asetuksena python.path. Katso esimerkki alta.

Lisätietoja Pythonista saat osoitteesta https://www.python.org . Seuraavasta osoitteesta https://wiki.python.org/moin/BeginnersGuide/ löydät Pythonin aloittelijan oppaan.

Voit käyttää Expression-handleria esimerkiksi laskutoimituksiin, jotka kohdistuvat muiden attribuuttien arvoihin, jotka on merkitty pääattribuutin metatiedoissa niiden yksittäisillä attribuuttikoodeilla.

Expression-handleria voidaan käyttää viiteattribuutissa. Jos lauseke palauttaa PythonEntity, jota käytetään viitteen arvon asettamiseen. Jos lauseke palauttaa merkkijonon (String), sitä käytetään kohdetietokortin hakemiseen.

Jos esimerkiksi haluat laskea keskiarvon attribuuteista attribuutit Q1, Q2, Q3, ja Q4, liitä Expression-handler attribuuttiin Average ja merkitse seuraava Python-lauseke kohteen Average metatietoihin: ([attributeCodeQ1]+[attributeCodeQ2]+[attributeCodeQ3]+[attributeCodeQ4])/4 . Expression-handler laskee merkittyjen attribuuttiarvojen keskiarvon ja asettaa sen attribuutin Average arvoksi seuraavan kuvan mukaisesti.

Arvo Average, joka on luotu Expression-handlerilla:

Seuraavat taulukot sisältävät tietoa attribuuttiasetuksista ja metatietovaatimuksista Expression-handlerille. Pakolliset metatiedot on esitetty pakollisten attribuuttien metatietotaulukossa.

Expression-handlerin määritys poikkeaa muista handlereista. Tarvittavat metatietonimet on annettu valmiiksi, ylläpitäjän tarvitsee antaa vain arvot.

Taulukko 1. Attribuutin asetukset

Taulukko 2. Pakolliset attribuutin metatiedot

Taulukko 3. Valinnaiset attribuutin metatiedot

Expression-handler mahdollistaa myös pääsyn viitattuihin tietokortteihin. Nykyiseen korttiin voidaan viitata sanalla this, ja muihin tietokortteihin niiden luokka-attribuutin koodilla, joka on määritetty pääkortissa. Tällä hetkellä tuetut menetelmät viitatuille tietokorteille ovat:

Taulukko 4. Tietokortin käyttömenetelmät

Taulukko 5. Tietokortin muokkausmenetelmät

Skriptiesimerkkejä

Oletetaan: 1) "car" on monivalintainen viite of _this_ template 2) "limit" on kokonaislukuattribuutti of _car_ template 3) Hae raja yksittäisestä car-viitteestä:

car.get("car_limit")

Laske autojen rajojen kokonaissumma. Tämä edellyttää isScript -vaihtoehtoa:

_result=0
for i in car:
 _result+=i.get("car_limit")

Määritä kentän arvo kahden muun perusteella. Edellyttää isScript-vaihtoehtoa:

_result='No'
if client_status=='Accepted' and dealer_status=='Yes':
 _result='Yes'

Tietokortin näkyvyys (joko this tai tietokortin käyttömenetelmillä löydetty tietokortti) voidaan tarkistaa menetelmällä isHidden. Huomaa, että jos tarkistat sen tietokortin näkyvyyden, johon attribuutti kuuluu, attribuutin, jossa on DatacardHiddenState-handler, on oltava ennen Expression-attribuuttia, jotta menetelmä toimii!

if this.isHidden():
 _result = 'This data card is hidden'
        
car = this.get("car")
if car.isHidden():
 _result = 'Car is hidden'
else:
 _result = 'Car is visible'

Equals-funktiolla voit selvittää esimerkiksi, viittaavatko kaksi viitettä samaan tietokorttiin.

ref1 = this.get("ref1")
ref2 = this.get("ref2")
if ref1 != None and ref2 != None:
if ref1.equals(ref2):
 _result = 'Ref1 and ref2 refer to the same data card'
else:
 _result = 'Ref1 and ref2 refer to different data cards'       

Attribuutit ilman arvoja

Alla oleva skripti havainnollistaa tavan tarkistaa, että tietyllä attribuutilla on arvo. Jos attribuuttia koodilla myDate1 tai myDate2 ei ole olemassa, tai jos tällä tietokortilla ei ole arvoa kummallekaan näistä attribuuteista, tulos on 0. Jos molemmat attribuutit ovat olemassa ja niillä on arvo, palautetaan 1.

date1 = this.get("myDate1")
date2 = this.get("myDate2")

if date1 is None or date2 is None:
 _result = 0
else:
 _result = 1      

Jos haluat käyttää lyhyempää tapaa tarkistaa, onko attribuutilla arvo, käytä tätä (tässä attr_code on attribuutin koodi):

if attr_code:
 _result = '...'

Jos haluat tarkistaa, ettei attribuutilla ole arvoa, käytä tätä (tässä attr_code on attribuutin koodi):

if not attr_code:
 _result = '...'

Erikoismerkkejä sisältävien merkkijonojen käsittely

Virheellisten merkkien välttämiseksi on suositeltavaa käyttää aina u-etuliitettä unicode-merkkijonojen edessä erikoismerkkien sijaan. Esimerkiksi:

 _result = u'Text with some special characters like: ä, ö, ź, ć, ę, ð etc.'          

On myös tärkeää käyttää u-etuliitettä merkkijonoja vertailtaessa. Seuraava vertailu palauttaa aina arvon false:

string_attribute_value == 'ää'  

Yllä oleva vertailu tulisi tehdä näin:

 string_attribute_value == u'ää'    

Satunnaislukujen generointi

Oletetaan, että attribuutin koodi on "random_figure" ja haluamme laskea luvun vain kerran. Tämä skripti antaa sinulle luvun väliltä 1–100. isScript-vaihtoehto tarvitaan moduulien tuomiseen.

import random
if random_figure is None:
 _result = random.randint(1, 100)
else:
 _result = random_figure        

Laskeminen päivämäärillä

Erityistä DateUtil-luokkaa voidaan käyttää päivämäärillä laskemiseen. DateUtil.daysBetween(date1, date2) laskee, kuinka monta päivää on date1 ja date2-päivämäärän välillä. Vastaavat menetelmät kaikille aikaväleille:

DateUtil.yearsBetween(date1, date2)
DateUtil.monthsBetween(date1, date2)
DateUtil.daysBetween(date1, date2)
DateUtil.hoursBetween(date1, date2)
DateUtil.minutesBetween(date1, date2)
DateUtil.secondsBetween(date1, date2)

DateUtil.addDays(date, number) lisää annetun määrän päiviä annettuun päivämäärään ja palauttaa uuden päivämäärän. Jos annettu luku on negatiivinen, päiviä vähennetään annetusta päivämäärästä. Vastaavia menetelmiä on olemassa myös muille aikaväleille:

DateUtil.addYears(date, number)
DateUtil.addMonths(date, number)
DateUtil.addDays(date, number)
DateUtil.addHours(date, number)
DateUtil.addMinutes(date, number)
DateUtil.addSeconds(date, number)

DateUtil.currentDate() palauttaa nykyisen päivämäärän ja kellonajan. Tätä voidaan käyttää muiden menetelmien kanssa, kuten alla olevassa lausekkeessa:

_result = DateUtil.addHours(DateUtil.currentDate(), this.get("priority_high")     

Tässä tapauksessa lauseke lisää kentässä "priority_high" olevan tuntimäärän nykyiseen päivämäärään.

Viitteet ja viitepolut

Arvoja voi hakea viitteistä kahdella tavalla. Suositeltu tapa on käyttää viitepolkuja. Tällä $code1:code2$-merkinnällä ei tarvitse tarkistaa, onko arvoa kohteelle code1 todella olemassa. Jos muokkaat Company-value-arvoa, sinun täytyy lisätä None-tarkistus sille. Kaikki koodit on tietenkin kirjoitettava oikein. Voit käyttää this.getAll("$person:company$") useiden arvojen hakemiseen.

this.get("$person:company$")        

Seuraava esimerkki on vanha ja vanhentunut tapa, jota ei enää suositella. Hakemalla jokaisen polun osan erikseen sinun täytyy lisätä None-tarkistukset jokaiselle osalle (this.get("person") != None).

this.get("person").get("company")         

Muiden attribuuttien arvojen muuttaminen

Yksittäisen arvon asettaminen

this.set("priority", 1)
this.set("description", (description or "") + "\n(For more information, contact service desk)")        

Useiden arvojen asettaminen

this.set("keywords", ["email", "communication"])

Arvojen lisääminen

this.add("keywords", "email")
---
this.add("keywords", ["email", "communication"])
---
if this.get("rollback_count") == None:
this.set("rollback_count", 0)
else:
 this.set("rollback_count", (this.get("rollback_count")+1))      

Arvojen kopioiminen viitepoluista

this.set("prices", this.getAll("$items:price$"))
this.set("total_price", sum(this.getAll("$items:price$") or []))

Arvojen tyhjentäminen

this.set("keywords", None)
this.set("keywords", [])
# Calling add with the same parameters doesn't do anything.

Attribuutit, joissa on CommentHandler

CommentHandler tallentaa kommentit tietokortteina. Lausekkeille kommentit palautetaan muodossa PythonComments. PythonComment sisältää menetelmiä kommentin viestin, kirjoittajan ja päivämäärän hakemiseen. Kirjoittaja on viite henkilön tietokorttiin. Kirjoittaja palautetaan muodossa PythonEntity. Päivämäärä palautetaan päivämäärä-aika-arvona kuten muillakin entiteettitiedoilla. Kommentteja ei voi muokata lausekkeissa. Olemassa olevia kommentteja ei voi asettaa minkään viiteattribuutin kohdearvoksi (eli niitä ei voi siirtää). CommentUtil voidaan käyttää uuden kommentin luomiseen. Kommentin viesti on annettava kommenttia luotaessa. Uusia kommentteja voidaan lisätä CommentHandler-attribuuttiin (set-menetelmää ei tueta). Päivämääräksi asetetaan kommentin luontiajankohta. Kirjoittajaksi asetetaan nykyisen käyttäjän henkilön tietokortti. Jos nykyisellä käyttäjällä ei ole henkilön tietokorttia, kommentin luonti epäonnistuu.

Taulukko 6. PythonComment-käyttömenetelmät

Taulukko 7. CommentUtil -menetelmät

Taulukko 8. Kommentteihin liittyvät PythonEntity-menetelmät

Alla on esimerkkejä kommenttien käytöstä lausekkeissa.

Asettaa kaikki ei-tyhjät kirjoittajat toiseen monivalintaiseen viitekenttään.

_result = []
comments = this.getAll("ngss_comments")
for comment in comments:
    if comment.getAuthor() != None:
        _result.append(comment.getAuthor())

Luo uuden kommentin ja liittää sen CommentHandler -attribuuttiin:

this.add("ngss_comments", CommentUtil.createComment("Added by expression"))

Luo uuden kommentin tietyllä päivämäärällä, kirjoittajalla ja tyypillä ja liittää sen CommentHandler -attribuuttiin:

this.add("ngss_comments", CommentUtil.createComment("Added by expression", "2020-01-01", "admin", "pythonapi-generated"))     

Poistaa kommentin kommentin viestin arvon perusteella:

comments = this.getAll("ngss_comments")
for comment in comments:
   if comment.getComment() != None and 'secret' in comment.getComment():
      CommentUtil.deleteComment(comment)

Tyhjentää kommenttien viestit niiden sisällön perusteella:

comments = this.getAll("ngss_comments")
for comment in comments:
   if comment.getComment() != None and 'secret' in comment.getComment():
      comment.setComment('')  

Hakee kaikki tämän entiteetin kommentit järjestettynä luontiajan mukaan laskevasti:

comments = this.getAllCommentsOrdered("ngss_comments")
for comment in comments:
   if comment.getComment() != None:
      comment.getComment()  

Hakee uusimman kommentin:

comment = this.getLatestComment("ngss_comments")
   if comment != None and comment.getComment() != None:
      comment.getComment()

Mukautettujen moduulien käyttö

Moduulin määrittäminen: Luo tiedosto stringutils.py seuraavalla sisällöllä hakemistoon, joka on ilmoitettu alustan asetuksessa python.path:

def reverse(value):
   if value is None:
       return None
   else:
       return str(value)[::-1]

Moduulin tuominen ja käyttäminen. isScript-vaihtoehto tarvitaan moduulien tuomiseen.

 import stringutils
 _result = stringutils.reverse(attribute_to_be_reversed)

Funktioiden tuominen ja käyttäminen moduulista. Useita funktioita voidaan tuoda erottamalla funktioiden nimet pilkuilla.

 from stringutils import reverse
 _result = reverse(attribute_to_be_reversed)

Moduuleja kehitettäessä käytä reload(module) moduulitiedoston muutosten käyttöönottamiseksi. Moduulin uudelleenlataus heikentää suorituskykyä, joten poista rivi, kun moduuli on valmis käytettäväksi tuotantoympäristössä.

 import stringutils
 reload(stringutils) #remove this line when module is ready

Python-versio

Python-versiota voidaan hallita alustan asetuksella python.version. Tarkista nykyinen versio tällä.

 import sys
 _result = sys.version