Heart-Profit ERP

Heart-Profit Boards => Heart-Profit Releasenotes => Topic started by: Heart Informatisering B.V. on June 04, 2009, 07:22:31 am



Title: Formattering Emailbericht Funktietrigger
Post by: Heart Informatisering B.V. on June 04, 2009, 07:22:31 am
Met ingang van deze Releasenote kan het Emailbericht welke vanuit een Funktie Trigger (Profit-Workflow) wordt verzonden worden geformatteerd.

Bij het opnemen van de Funktie Trigger kan worden aangegeven welke personen (email adressen) er een bericht moeten krijgen indien een bepaalde funktie getriggerd wordt. Zo staat onderstaand ingesteld dat bij het Toevoegen van een Kontaktverslag een email verzonden moet worden.

(http://www.heartprofit.com/www/transfer/graphics/forum/pwftwy090603001.png)

Maar, in plaats van de trigger "Kontaktverslag toegevoegd" kan er ook een trigger worden gedefinieerd omdat er een Artikel werd toegevoegd of een Artikelgroep werd gewijzigd. Iedere trigger zal van toepassing zijn op een "sleutelwaarde" binnen een "tabel".

Het emailbericht wat voorheen verstuurd werd bevatte dan ook de tabel waarop de trigger van toepassing was, alsmede de sleutelwaarde van hetgeen zojuist werd toegevoegd danwel werd gewijzigd, voorafgegaan door een waarde instelbaar bij de trigger zelf ("Toevg. verslag").

I.g.v. het wijzigen van een Artikel, bevatte het onderwerp de tabel LOAR (Artikelgegevens) en de sleutelgegevens van het betreffende Artikel, bestaande uit een Bedrijfs-Identifikatie en een Artikelnummer. Bij bijv. een Kontaktverslag werkte dit op dezelfde wijze, doch daar zit de sleutel iets complexer in elkaar:

(http://www.heartprofit.com/www/transfer/graphics/forum/OEMail090603001.png)

Dat het om het "toevoegen van een verslag" ging is duidelij (dat kan nl. bij de Funktie Trigger worden ingesteld) en ook de sleutel kan best ontcijferd worden:  Bedrijf = "Profit-Demo", Kontakt-Id = "Westgron1", Projekt-Id = "Westgron1", Datum "20090525" en Tijd "11:30".

M.i.v. deze Releasenote kan U zelf aangeven wat er wel of niet in het onderwerp van het emailbericht moet worden opgenomen, rekeninghoudend met het feit dat iedere Funktie Trigger verwijst naar een andere tabel (Funktionele Alias, de tabelnaam die door de Funktie geïmpliceerd wordt).

De velden die in het emailbericht kunnen worden opgenomen zijn de velden uit die Funktionele Alias, alsmede velden uit tabellen van verwijzende sleutels (conform data model zoals deze bij ProfitChange-Key wordt toegepast).

Om het emailbericht te kunnen formatteren zal eerst de zgn. Funktionele Alias bekend moeten zijn. Hiertoe dient U de betreffende Funktie Trigger één keer uit te voeren zonder dat werd aangegeven welke velden in het emailbericht moeten worden opgenomen. Tijdens deze eerste keer wordt de Funktionele Alias bepaald, en opgeslagen bij de betreffende Funktie Trigger.

(http://www.heartprofit.com/www/transfer/graphics/forum/pwftra090603001.png)

Via Raadplegen Funktie Triggers wordt aangegeven van welke triggers de Funktionele Alias bekend is. Is deze bekend, dan kan het bericht worden ingesteld (Shift-F5).

 Formattering gegevens Emailbericht

Het scherm bestaat uit een tweetal Tabbladen. Op het eerste Tabblad staat een Listmover control, waarin links alle opneembare velden worden vermeld die o.b.v. de Funktionele Alias kunnen worden geselekteerd. Rechts staan de velden die U reeds geselekteerd heeft, en die tesamen het onderwerp van het emailbericht zullen bepalen.

(http://www.heartprofit.com/www/transfer/graphics/forum/pwftfsmv090603001.png)

Beide Lists hebben hier een indeling bestaande uit:

Tabel: Tabelnaam waaruit de data gelezen wordt.

Veld: Identifikatie van het op te nemen veld uit die tabel.

VrwzVeld: Verwijzende veldnaam (wordt verderop verklaard).

Omschrijving: Omschrijving veldnaam, default bepaald o.b.v. de Helptekst, doch kan door de gebruiker worden overruled (zie tabblad #2).

Volgnummer: Staat hier buiten beeld, zorgt ervoor dat de items in de juiste volgorde komen te staan bij heen-/terug verplaatsen; betreft tevens de volgorde waarin de geselekteerde velden worden verwerkt.

In bovenstaande lijst komen we o.a. een veld PKKO_KID tegen. Dit betreft het Kontakt-Id van het Kontaktverslag. Een Kontakt-Id betreft echter ook een Relatie-Id, en verwijst daarmee naar de tabel LORE (Relaties). O.b.v. de waarde die als Kontakt-Id voorkomt, zal het systeem die waarde kunnen opzoeken in de Relatie tabel, waarna ook alle velden uit die Relatietabel beschikbaar zijn, voor zover bepaald door de waarde van veld PKKO_KID.

(http://www.heartprofit.com/www/transfer/graphics/forum/pwftfsmv090603002.png)

Maar ook PKKO_PID bevat een Projekt-Id, welke tevens als Relatie-Id kan voorkomen, maar ook als Projekt. We kunnen dus ook de velden uit de Relatietabel ophalen v.w.b. de Relatie die werd afgedwongen door de waarde uit veld Projekt-Id.

(http://www.heartprofit.com/www/transfer/graphics/forum/pwftfsmv090603003.png)

En zo is er bijv.ook een veld Aktiekode, welke weer naar de tabel "Aktiekodes" verwijst, en ons toestaat om daar alle gegevens uit op te nemen.

(http://www.heartprofit.com/www/transfer/graphics/forum/pwftfsmv090603004.png)

Het resultaat voor de Funktie Trigger PKKOTV2 komt al uit op 180 opneembare velden.

 Het opnemen van velden

Zoals redelijk vanzelf sprekend voor een Listmover control, kunnen we nu de velden die we willen opnemen overhevelen naar de List "Opgenomen velden". Dit kunnen we doen door te dubbelclicken op een item uit de "beschikbare" lijst, we kunnen ook een of meerdere items markeren, en vervolgens gebruik maken van de pijltjes toetsen om iets van de ene List naar de andere te verplaatsen.

De volgorde waarin de velden worden opgenomen zal de volgorde zijn waarin de velden in het emailbericht worden opgenomen.

Ik selekteer vervolgens de Bedrijfs-Identifikatie, de naam conform tabel LORE horende bij de Relatie-Id die als Kontakt-Id werd gebruikt, de Omschrijving van het Kontakt, en vervolgens de Datum en Tijd van het Kontakt.

(http://www.heartprofit.com/www/transfer/graphics/forum/pwftfsmv090603005.png)

Schakelen we over naar Tabblad #2, dan worden daar de opgenomen velden nogmaals opgesomd, en kunnen we Eigenschappen opnemen voor deze velden.

(http://www.heartprofit.com/www/transfer/graphics/forum/pwftfsmv090603006.png)

Zo kunnen we zelf bepalen wat de omschrijving van het betreffende veld moet zijn, en kunnen we ervoor kiezen om deze omschrijving wel of niet weer te geven voor de waarde van het betreffende veld. Op deze manier kunnen we ervoor kiezen om "Datum: dd-mm-jjjj" weer te geven, maar ook "dd-mm-jjjj". E.e.a. is zichtbaar in de List doordat de omschrijving van een veld waarvan de omschrijving niet getoond moet worden tussen haakjes staat.

Ook kan er een scheidingsteken worden opgegeven welke gebruikt moet worden tussen de verschillende velden.

Nog één extra aanvulling:

Middels bovenstaand scherm triggeren we de indeling van het Onderwerp van het Emailbericht. Naast dit onderwerp wordt (vooralsnog alleen voor PKKOTV2 en PKKOWY2) een uitzondering gemaakt v.w.b. de tekst van het Emailbericht zelf. Zodra het scherm voor een van bovengenoemde Funktie Triggers wordt aangeroepen, zal de lijst met beschikbare velden ook een veld "_TEXT" bevatten. Dit betreft geen echt veld in de database, maar dit betreft een veld waarmee U als gebruiker via dezelfde Listmover kunt aangeven of de tekst van het verslag óók meegenomen moet worden. Dan uiteraard niet in de omschrijving, maar in de tekst van het emailbericht.

Nb: Eigenschappen van dit _TEXT veld kunnen niet worden gewijzigd.

Alleen teksten die middels de DHTML editor zijn gemaakt danwel in de DOS editor werden toegevoegd kunnen vooralsnog gemaild worden; het is nog niet mogelijk om bijv. een Kontaktverslag middels MS-Word aan te maken, en vervolgens de inhoud van het Word document te mailen.

Merk echter op dat de wijze waarop e.e.a. is opgezet niet zo zeer een HTML bericht mailt, maar een MIME bericht verstuurd. De HTML tekst is hier slechts een onderdeel van, en daarmee is dat MIME bericht veel krachtiger. Het mechanisme leent zich er dus voor om bijv. het MS-Word document, een Excelsheet, een Powerpoint presentatie etc. "gewoon" als Attachment mee te laten sturen. Vooralsnog is dat niet ontwikkeld, maar middels aanvullend maatwerk behoort het tot de mogelijkheden.

Uiteindelijk stel ik het scherm in als:

(http://www.heartprofit.com/www/transfer/graphics/forum/pwftfsmv090603007.png)

Vervolgens ga ik een Kontaktverslag toevoegen:

(http://www.heartprofit.com/www/transfer/graphics/forum/pkkotv2090603001.png)

Het bericht welke nu per email binnen komt, ziet er nu uit als:

(http://www.heartprofit.com/www/transfer/graphics/forum/OEMail090603002.png)

Ze begint met "Toevg. verslag" (uit Funktie Trigger), "Bedrijf" welke de omschrijving is van veld PKKO->XXSU_SID, gevolgd door de waarde van dat veld, daarna de Naam van het Kontakt-Id, de Omschrijving van het Kontakt en de datum en tijd.

De email bevat de tekst zoals ingetypt in het verslag:

(http://www.heartprofit.com/www/transfer/graphics/forum/OEMail090603003.png)

FunktieOmschrijvingDtm.Vl.WyzDtm.L.Wyz
PKKDRA      Raadplegen Kontakten (datum)    26-10-2005    03-06-2009
PKKOTV2     Toevoegen Kontakt    14-02-2008    03-06-2009
PKKOWY2     Wijzigen Kontakt    20-12-2007    03-06-2009
PWBHOI      Omschrijving (nog) niet bekend    26-10-2005    26-05-2009
PWFTFSMV    Omschrijving (nog) niet bekend      -  -        25-05-2009
PWFTRA      Raadplegen Funktie-Triggers    26-10-2005    25-05-2009
PWFTUVME    Omschrijving (nog) niet bekend      -  -        02-06-2009
SYER        Omschrijving (nog) niet bekend    02-04-2009    03-06-2009
SYME        Omschrijving (nog) niet bekend    18-07-2008    25-05-2009
SYOF1       Omschrijving (nog) niet bekend    23-04-2009    28-05-2009
SYSS        Omschrijving (nog) niet bekend    01-04-2009    04-06-2009
SYTX        Tekstmechanisme    16-03-2009    03-06-2009


Title: Re: Formattering Emailbericht Funktietrigger
Post by: Wouter Rijnbende on June 11, 2009, 01:41:37 pm
Zie http://ha1.heartprofit.nl/profit/index.php?topic=21682.0 voor een uitbreiding op deze funktionaliteit.