Actions

Niet verzonden e-mail (bounce)

From LimeSurvey Manual

Revision as of 15:13, 20 June 2013 by Han (talk | contribs) (Created page with "Het instellen voor een specifieke enquête kan bij het toegangscode beheer van die enquête.")

Inleiding

Het systeem voor het controleren van niet afgeleverde e-mail (beschikbaar vanaf versie v1.91) ziet welke e-mails niet bij de ontvangers/deelnemers afgeleverd zijn. Dit gaat via de "mail delivery notification failure report" en daarbij wordt het e-mailadres van de beheerder, dat gebruikt wordt om e-mails te verzenden, gebruikt of het speciale account dat alleen voor deze bounces gebruikt wordt. Ook de credentials en de connectie details van dit account worden gebruikt.

Vereisten

De php5-imap module moet op de server zijn geïnstalleerd. Dit kun je controleren, door te kijken in PHPInfo, dat je via LimeSurvey kunt bekijken op de Instellingen.

Zoek naar de imap sectie, het ziet er ongeveer als volgt uit:

Als er geen php5-imap geïnstalleerd is, en je mag ook niet naar de root van de server, dan kun je via de voor jouw geldende procedures proberen te installeren. In geval van: http://www.electrictoolbox.com/install-php-imap-debian/ . Je moet dan wel je webserver opnieuw starten, bijvoorbeeld met "apache/usr/sbin/apache2ctl restart"

Werking

De redenen voor het ontwikkelen van dit bounce-systeem is het verminderen van het werk met de handleiding in de hand en het verminderen van menselijke fouten.

Als er een e-mail verzonden wordt, dan wordt er door dit systeem automatisch een survey-id en token-id aan de e-mailheader toegevoegd.

Deze headers, ook wel "custom headers", worden toegevoegd aan elke uitnodiging die naar deelnemers wordt verzonden.

Wanneer de e-mail bounced, dus niet verzonden kon worden, dan wordt de originele header ontvangen met de header van de "Delivery notification". Het systeem kijkt in de e-mails die ontvangen worden of er een aangepaste header in staat en legt de bounce van die e-mail dan vast in de tabel token.

Installatie

Het systeem kan op algemeen niveau of op enquête niveau werken. Op algemeen niveau kunnen de instellingen worden ingesteld bij Instellingen -> Bounce instllingen.

Het instellen voor een specifieke enquête kan bij het toegangscode beheer van die enquête.

As you can see in the screenshot above the setting to be used in that particular survey is to be selected. Avilable options are

  • No settings to be used
  • Use settings below (survey-specific)
  • Use global settings

Once the settings have been set you can start the bounce processing by clicking on the bounce processing icon in the Token browser toolbar as shown below.

After clicking the icon you will be presented with a popup which shows a progress meter.

Wait for it to complete. Once complete the result of the scan will be shown and after a refresh of the browse responses page (you might have to do that manually) all the entries whose invitation are bounced their e-mail address are marked in red font. Also their "Email status" is chanced from "OK" to "bounced".