Automaatsed teated emailile

ERPLY Booksis on võimalik seadistada ka automaatsed teated, mis saadetakse määratud emailile. Näited, millistel juhtudel võib seda vaja minna:

• Soovid korra kuus emailile saata müügid klientide lõikes ettevõtte juhile.
• Soovid saada mingit konkreetset teadet (näiteks saada mulle email kui minu tehtud müügiarve läheb üle tähtaja 3 päeva või näiteks saada mulle meeldetuletus kui ma pole arvet kinnitanud kolme päeva jooksul pärast päringut)

Selle seadistamiseks kirjuta pealehe otsingusse ‘’Halda märguandeid’’ ja seejärel avaneb järgnev:

Veergude seadistamine

Nüüd tuleb lisada järgnevad reeglid:

• JSON: {“tables”:”DOCUMENT”,”output”:”DOCUMENT.DATETIME|DOCUMENT.NUMBER|DOCUMENT.SUM_NO_VAT”,”groupBy”:””,”parameters”:[{“rules”:[{“tableName”:”DOCUMENT”,”fieldName”:”CREATE_DATETIME”,”referenceType”:”MORE_THAN”,”value”:”2022-09-30T21:00:00.000Z”,”filterName“:”esimene”}],”index”:0}]}

• Sisu: tuleb HTML-ina kirjutada, kirjeldatud allpool
• E-mail: kuhu saadetakse teavitus
• Teema: emaili pealkiri
• Näita gruppides: selle määramine on vajalik sel juhul, kui soovid, et saadetavad emailid oleks erinevad ja grupeeritud kindla tunnuse järgi

Näiteks soovid saata emaili kõikidele hankijatele, siis otsitakse kõik hankijad korraga ja reegliga määrad ära, et groupValue on registrikood ja seejärel saadetakse email kõikidele hankijatele eraldi.

• Summa: Saad lisada summa, mis lisatakse emaili lõppu. Siia on vaja lisada lahtrit mida grupeerid nt. meie JSON näide puhul see on DOCUMENT.SUM_NO_VAT
• Lisa filter: näiteks esimene=DATE_MINUS3 (selgitus allpool)

Lõpuks salvestage muudatused ja logige kontolt välja ja tagasi sisse, et muudatused rakenduksid.

HTML-i kirjeldamine

HTML koosneb erinevatest osadest, mis liidetakse hiljem kokku. Eraldusmärgina kasutatakse | .

Üldiselt näeks HTML välja midagi sellist:

Sissejuhatav tekst lisa siia|FIRST:ENTITY.BILLING_NAME|<table style=”border:1px solid black;width:100%;border-collapse:collapse”><tbody><tr><th>Osakond</th><th>Artikkel</th><th>Kogus</th></tr>|ALL:PROJECT.NAME,ARTICLE.NAME,ARTICLE_ROW.QUANTITY|</tbody></table>|SUM:Kokku:|Emaili lõpp siia

HTML-i osad

HTML-i osade kirjeldus:

• FIRST:BooksContactName – võtab nimekirjast esimeselt objektilt välja BooksContactName.

Näiteks saadate koguste võrdlemise saldosid hankijatele ja soovite määrata hankija nime: <table style=”border:1px solid black;width:100%;border-collapse: collapse”><tbody><tr><th>Veerg 1 nimi</th><th>Veerg 2 nimi</th><th>Veerg 3 nimi</th></tr> – see on tabeli stiil ja päised.

• ALL:BooksWarehouse,categoryName,purchasedQuantity – ALL tähendab, et tabelisse lisatakse kõik read

Stiilina lisab tavapärase <td style=”text-align:right;border:1px solid black;border-collapse: collapse”>

</tbody></table> – see on tabeli lõpp

• SUM:Kokku: – kui Sul on seadistatud summeeriv väärtus, siis pärast “SUM:” väärtust lisab selle, mis sinna kirjutatud on ja selle järgi summeeritud numbri, antud summat ei ümardata. Näiteks kui summa oleks 2482.00, siis oleks väärtus “Kokku: 2482.00”

Toome konkreetsema näitena HTML-i kirjelduse välja juhul kui soovid saata tabeli kliendile, kus on näha dokumendi number, dokumendi kuupäev ja dokumendi summa.

HTML tuleks koostada järgnevalt: 

Tere Sügis OÜ <br><br>Saadame uued dokumendid. |<br><br><table style=”border:1px solid black;width:100%;border-collapse: collapse”><tbody><tr><th>Dokumendi number </th><th>Kuupäev</th><th>Summa</th></tr>|ALL:DOCUMENT.NUMBER,DOCUMENT.DATETIME,DOCUMENT.SUM_NO_VAT|</tbody></table><br><br>|SUM:Kokku: |<br><br>Soovime teile ilusat päeva, <br><br>Teie Kevad OÜ

Emailis näeks see välja järgnevalt: 

Tere Sügis OÜ

Saadame uued dokumendid.

Kokku: 300.00

Soovime teile ilusat päeva,

Teie Kevad OÜ

Kuidas määrata ‘’Lisa filter’’ veergu?

Kuna emaili sisu ja tabel koostatakse vastavalt sellele, millised filtrid Aruandegeneraatoris määratakse, siis peavad kõik filtrid, mis generaatoris määratakse ja mida süsteem peab muutma,  olema määratud vastavalt reeglitele filterName juurde. Selle kaudu teab süsteem, millist filtrit muuta.

Näiteks tahad otsida uusi lepinguid, seega on kindlasti vähemalt kaks filtrit Aruandegeneraatoris:

1. Tüüp = leping
2. Loomiskuupäev = hiljem kui võrdne tänane kuupäev.

Seega tüübi filtrit muuta ei soovi, aga kuupäeva peab süsteem määrama tänase.

Filtrid, mida on võimalik muuta

MONTH, YEAR ja DAY on mõeldud indeksitele, kus väärtus ongi kuu, aasta või päev:

• DATE – mõeldud neile, kus on kuupäeva muutmine
• CURRENT_MONTH, CURRENT_YEAR ja CURRENT_DAY – väärtused, kus pole plussi ja miinust

Ülejäänud töötavad põhimõttel, et lõppu paned numbri (näiteks mitu päeva/kuud/aastat tagasi/edasi tahad minna)

Näited:

• DATE_MINUS10 – võtab kuupäeva, mis oli 10 päeva tagasi
• DAY_PLUS7 võtab päeva nädala aja pärast

Erand: 

• Kui on määratud CURRENT_YEAR ja MONTH_MINUS ja kuuks valiti 12, siis aastaarvuks võetakse -1, sest MONTH_MINUS ütleb, et mine mingid kuud tagasi. Seega kui tuli eelmise aasta detsember, siis peab ka aasta muutuma.
• Analoogselt kui on CURRENT_YEAR ja MONTH_PLUS ja kuu väärtuseks tuleb +1, siis aastale tehakse +1.