Handler - AutoMailSender
AutoMailSender-käsittelijä luo ja lähettää automaattisen sähköpostiviestin, joka sisältää pääattribuutin metatiedoissa määrittämäsi tiedot.
Jotta sähköpostia voidaan lähettää, kaikki mail.transport-asetukset on määritettävä alustan asetuksissa.
AutoMailSender-käsittelijää käytetään pääasiassa prosessien ja työnkulkujen hallintaan lähettämällä ilmoituksia, kun jotain tapahtuu.
AutoMailSender-käsittelijä lähettää sähköpostin, kun määritetyt laukaisuehdot täyttyvät - oletusarvoisesti aina, kun attribuutin arvo muuttuu, mutta eri ehtoja voidaan määrittää metatiedoilla Send once, Send if attribute has value ja Do not check for change. Sähköposti voidaan esimerkiksi lähettää vain kerran, kun uusi tietokortti luodaan, tai aina kun olemassa olevan attribuutin arvo muuttuu. Attribuutin metatiedoilla voit määrittää, mitä tietoa sähköposti sisältää - esimerkiksi oletusarvoisen aiheen - sekä vastaanottajan ja lähettäjän sähköpostiosoitteet. Lisäksi metatiedoissa voit merkitä attribuutteja, joiden arvot haluat sisällyttää pääkortilta sähköpostiin.
On myös mahdollista lisätä kansiometatietoja, jotka lisäävät vastaanottajia kyseisen kansion tietokorteilta lähetettäviin sähköposteihin. Voit käyttää seuraavia kansiometatietoja:
automail_recipient [email address]automail_recipient_[attribute_code] [email address]
Ensimmäinen koodi määrittää sähköpostin vastaanottajaosoitteen, jota käytetään kaikille kansion sisällä oleville attribuuteille, joissa on AutoMailSender-käsittelijä. Toisen esimerkin koodi määrittää vastaanottajaosoitteen, jota käytetään vain kyseisen kansion tietyssä attribuutissa (attribuutissa on luonnollisesti oltava AutoMailSender-käsittelijä). Jälkimmäistä koodia voidaan käyttää, kun samassa kansiossa on tietokortteja eri malleista, joissa on määritetty AutoMailsender. Näin voit määrittää, että vastaanottaja lisätään vain tietystä mallista lähetettäviin sähköposteihin. Kansiometatieto ei koskaan ohita muita AutoMailSender-käsittelijän asetuksia, vaan sitä käytetään niiden lisäksi.
Seuraavat taulukot sisältävät tietoa AutoMailSender-käsittelijän attribuuttiasetuksista ja metatietovaatimuksista. Pakolliset metatiedot esitetään Required attribute metadata -taulukossa, joka sisältää myös ehdotuksia mahdollisista metatietoarvoista. Vastaavasti valinnaiset metatiedot esitetään Optional attribute metadata -taulukossa.
Taulukko 1. Attribuuttiasetukset
| Käsittelijän nimi | Tietotyyppi |
|---|---|
| AutoMailSender | Mikä tahansa |
Taulukko 2. Pakolliset attribuutin metatiedot
| Nimi | Arvo | Kuvaus |
|---|---|---|
| Sender email address | [email addresses] |
Lähettäjän sähköpostiosoite. Jos haluat lisätä useita lähettäjiä sähköpostiin, merkitse jokainen omalle rivilleen. Tätä asetusta ei tarvita, jos |
| Recipient email address | [email addresses] |
Vastaanottajan sähköpostiosoite. Jos haluat lisätä useita vastaanottajia sähköpostiin, merkitse jokainen omalle rivilleen. Tätä asetusta ei tarvita, jos |
| Mail subject | [email addresses] |
Sähköpostin aihekentässä näytettävä aihe. |
$attribute_code$ |
Voit sisällyttää avainsanan $attribute_code$ header-, subject- ja footer-metatietoihin lisätäksesi minkä tahansa saman mallin attribuutin arvon kyseiseen sähköpostin osioon. |
|
$name$ |
Voit sisällyttää avainsanan $name$ header-, subject-, body- ja footer-metatietoihin sisällyttääksesi tietokortin nimen automaattisesti kyseiseen sähköpostin osioon. |
|
$template$ |
Voit sisällyttää avainsanan $template$ header-, subject-, body- ja footer-metatietoihin sisällyttääksesi mallin nimen automaattisesti kyseiseen sähköpostin osioon. |
|
$value$ |
Voit sisällyttää avainsanan $value$ header-, subject-, body- ja footer-metatietoihin lisätäksesi tämän attribuutin arvon automaattisesti kyseiseen sähköpostin osioon. |
|
$from$ |
Voit sisällyttää avainsanan $from$ header-, subject-, body- ja footer-metatietoihin lisätäksesi tämän sähköpostin lähettäjän kyseiseen sähköpostin osioon. |
Esimerkki: AutoMailSender-käsittelijällä voit luoda automaattisen viestitekstin, joka lähetetään, kun attribuutin metatiedoissa määrittämäsi ehdot täyttyvät. Voit esimerkiksi haluta saada automaattisen hälytyksen aina, kun yrityksesi auton omistaja vaihtuu. Tätä varten lisäät AutoMailSender-käsittelijän attribuuttiin Owner ja käytät seuraavaa Header-metatiedon arvoa:
"Tietokortti $name$ mallilla $template$ on muutettu $change_date$. Uusi arvo kentässä Owner on $value$"
"Tietokortti Volkswagen Passat 1.6 Firstline mallilla Car on muutettu 24.5.2004. Uusi arvo kentässä Owner on JOHN SMITH."
Taulukko 3. Valinnaiset attribuutin metatiedot
| Nimi | Arvo | Kuvaus |
|---|---|---|
Mail header |
[Hyvä Herra] |
Otsikko ennen viestin runkoa.
|
Mail body |
[Viestin runko] |
Viestin runko.
|
Mail footer |
[Ystävällisin terveisin, ] |
Alatunniste viestin rungon jälkeen.
|
Send if attribute has value |
[attribute_code] |
Viesti lähetetään vain, jos annetulla koodilla olevalla attribuutilla on arvo. Vain itse tietokortin attribuutit ovat sallittuja. Arvo viittauksesta ei ole tuettu, vaikka attribuuttivalitsin sallii sellaisen valitsemisen. Jos useita
Huomaa: |
Send once |
on/off (send_once) |
Jos arvoksi on asetettu on, sähköposti lähetetään vain kerran kutakin tietokorttia kohden. Jos (Taaksepäin yhteensopivuuden vuoksi myös arvo |
Sender(s) from attribute |
[attribute_code] |
Sähköpostiosoitteet, jotka ovat tietokortin arvoja. Arvot voivat olla tällä mallilla tai mallilla, joka on linkitetty tähän malliin. Attribuutin polku määritetään seuraavasti:
Jos määritettynä on useampi kuin yksi Esimerkki (lähetä viesti tietystä tukiryhmästä):
Tämä asetus vaaditaan, jos sender-metatietoa ei ole määritetty. |
Recipient(s) from attribute |
[attribute_code] |
Sähköpostiosoitteet, jotka ovat tietokortin arvoja. Arvot voivat olla tällä mallilla tai mallilla, joka on linkitetty tähän malliin. Attribuutin polku määritetään seuraavasti:
Jos määritettynä on useampi kuin yksi Esimerkki (lähetä raportti asiakasyrityksen projektipäällikölle):
Tämä asetus vaaditaan, jos recipient-metatietoa ei ole määritetty. |
CC recipient email address |
Vastaanottajan sähköpostiosoite. | Sähköpostiosoitteet, jotka näytetään CC-kentässä. |
CC recipient(s) from attribute |
[attribute_code] |
Sähköpostiosoitteet, jotka näytetään CC-kentässä. Arvot voivat olla tällä mallilla tai mallilla, joka on linkitetty tähän malliin. Attribuutin polku määritetään seuraavasti:
Jos määritettynä on useampi kuin yksi Esimerkki (lähetä raportti asiakasyrityksen projektipäällikölle):
|
BCC recipient email address |
Vastaanottajan sähköpostiosoite. | Sähköpostiosoitteet, joita ei tulisi näyttää muille vastaanottajille. |
BCC recipient(s) from attribute |
[attribute_code] |
Sähköpostiosoitteet, joita ei tulisi näyttää muille vastaanottajille. Arvot voivat olla tällä mallilla tai mallilla, joka on linkitetty tähän malliin. Attribuutin polku määritetään seuraavasti:
Jos määritettynä on useampi kuin yksi Esimerkki (lähetä raportti asiakasyrityksen projektipäällikölle):
|
Do not check for change |
on/off (do_not_check_for_change) |
Jos arvoksi on asetettu on, sähköposti lähetetään, vaikka attribuutin arvo ei muuttuisi. (Taaksepäin yhteensopivuuden vuoksi myös arvo |
Mail format |
[text/html | text/plain] | Oletusarvo on text/html. Sähköpostin sisältötyyppi määritetään tällä metatiedolla. Jotkin erikoiskäsittelijät saattavat vaatia arvoa text/plain. |
Attachment |
[text/html | text/plain] | Tässä määritetään automaattisesti lähetettävät liitteet. Arvon tulee olla joko lataushakemistoon ladatun tiedoston nimi tai viittaus seuraavassa muodossa: "$attributeCode:anotherAttributeCode$. Esimerkki: mallilla, jossa on auto mail sender handler, on myös file upload handler, jonka attribuuttikoodi on "attachment_files". Jos nyt auto mail sender -käsittelijän attachment-metatiedon arvoksi on asetettu "$attachment_files$", auto mail sender -käsittelijä liittää sähköpostiin kaikki tiedostot, jotka on ladattu file upload -käsittelijään attachment_files. |
Table of Contents