Document toolboxDocument toolbox

Documentatie voor klanten en partners van Digitaal Vlaanderen - bouwstenen Mijn Burgerprofiel, Verenigingsloket en e-loketondernemers


Data afleveren via e-mail

Optie 1: 1 vast email adres per formulier

Kies deze optie als alle inzendingen naar hetzelfde email adres mogen gaan.

1. Ga naar de properties van het formulier

2. Kies het endpoint ā€œEmailā€

In het tabblad ā€œAfhandelingenā€, kies Endpoint ā€œEmailā€

Dan kan u de configuratie van de email aanvullen:

  • Aflever adressen: vul het adres in waarnaar de data gestuurd moet worden

    • U kan ook verschillende email adressen ingeven, gescheiden door een komma. Dan gaat er een email naar elke van deze adressen gestuurd worden.

  • Kies het onderwerp van de mail

  • Kies de body van de email

    • Als u ${fullFormData} ingeeft bevat de body alle data velden uit het formulier, bv

      • Naam: Jan

      • Voornaam: Peeters

      • etc

    • U kan een tekst naar keuze in de body van de email zetten.

    • U kan ook de waarden ingevuld in het formulier gebruiken in de email: gebruik hiervoor het $ teken, gevolgd door de naam van het veld in het formulier tussen accolades, bv ā€œ${Voornaam}ā€

      • dit wordt dan bv:

        • De gebruiker heeft volgende naam ingevuld: ${Voornaam}

      • Als het veld dieper in een hiĆ«rarchie zit in het formulier moet u het hele pad aangeven. bv ${klant.adresgegevens.straat}

  • Als u wil dat de bijlagen niet mee worden verstuurd in de email kan u deze checkbox aanvinken.

  • Kies de maximale grootte voor de som van alle bijlagen van het formulier, rekening houdend met de maximale grootte van bijlages voor de gekozen mailbox (vaak is dit e.g. 5MB of 10MB)

  • Debug mode: deze kan u activeren in geval van problemen, om te zien welke velden beschikbaar zijn om te gebruiken in de body, of welke fout er zich voordoet bij het testen.(u kan zo het volledige pad van alle velden terugvinden)

3. Test de setup

  • vul het formulier in en druk op ā€œverzendenā€

  • Dit kan op de author omgeving, of vanop de publish

  • controleer dat de email aankomt op het gewenste adres.

  • Als er problemen zijn bij het versturen van de email kan u de ā€œdebug modeā€ aanvinken.

    • als er dan een fout is gemaakt, bv bij het gebruik van de parameters zoals ā€œ${Voornaam}ā€, dan zal de mail toch verstuurd worden, en zal u in de mail kunnen zien wat er juist mis gaat.

  • Voorbeeld:

Ā 

Optie 2: email adres afhankelijk van bepaalde data in het formulier

Stel dat 1 formulier gebruikt wordt voor zowel Klachten als Contact, maar beiden zouden naar een andere mailbox gestuurd moeten worden:

1. Ga naar de properties van het formulier

2. Kies het endpoint ā€œEmail (Veld afhankelijk)ā€

In het tabblad ā€œAfhandelingenā€, kies Endpoint ā€œEmail (Veld afhankelijk)ā€

  • Kies het onderwerp van de email

  • Vul een fallback email adres in:

    • als er een waarde in het formulier wordt ingevuld, waarvoor u geen specifiek email adres hebt opgegeven, wordt de email naar dit veld gestuurd. Dit is dus de backup/default/fallback

  • Kies het veld in het formulier waarvan de waarde bepalend is om te weten waar de data naartoe moet

    • Er is een dropdown met alle velden van het formulier

    • Kies het bepalende veld: dit kan een dropdown uit het formulier zijn, maar ook een vrij tekst veld

  • Email veld mapping:

    • Bepaal bij welke waarde van het hierboven gekozen veld er naar welk email adres gestuurd moet worden.

    • bv bij een dropdown als referentie veld zal u voor elke mogelijke waarde van de dropdown een email adres ingeven waar de data naartoe moet voor die bepaalde waarde (zie printscreen)

    • bij een vrij tekstveld zou u kunnen aangeven:

      • bij de waarde ā€œgeelā€, stuur naar adres x, bij de waarde ā€œroodā€ stuur naar adres y. Bij alle andere waarden zal de email naar het Fallback adres gaan.

  • Kies de maximale grootte voor de som van alle bijlagen van het formulier, rekening houdend met de maximale grootte van bijlages voor de gekozen mailbox (vaak is dit e.g. 5MB of 10MB)

3. Test de setup

  • vul het formulier in en druk op ā€œverzendenā€

  • Dit kan op de author omgeving, of vanop de publish

  • controleer dat de email aankomt op het gewenste adres.

  • Doe dit voor de verschillende waardes die invloed hebben op het aflever email adres

Ā 

Optie 3: email adres afhankelijk van een call die in het formulier gebeurt.

Een derde en meer complexe optie is dat u de email laat afleveren op een adres dat bepaald wordt door een call die gedaan wordt vanuit het formulier.

Voorbeeld:

  • de gebruiker die het formulier invult kiest in een dropdown de naam van een bepaalde instelling.

  • Het formulier doet een call naar uw backend systeem, en vraagt wat het afleveradres is voor deze instelling.

  • De email zal bezorgd worden op het email adres dat wij van u ontvangen.

De lijst van email adressen ligt dus niet op voorhand vast. We krijgen het adres dynamisch binnen vanuit uw backend systeem.

Deze optie moet geconfigureerd worden samen met het team van de aanvraagmodule.

Als u nood heeft aan deze optie, gelieve dan contact op te nemen met het team van de aanvraagmodule.

Dit is een officiƫle website van de Vlaamse overheid - Uitgegeven door Digitaal Vlaanderen: https://www.vlaanderen.be/digitaal-vlaanderen

DISCLAIMER: http://www.vlaanderen.be/nl/disclaimer
TOEGANKELIJKHEID: http://www.vlaanderen.be/nl/toegankelijkheid