Later hervatten

Gemaakt door Özkan Yilmazer, Gewijzigd op Di, 25 Feb om 10:31 AM op Özkan Yilmazer

Binnen TriplEforms is het mogelijk voor gebruikers om hun formulieren op te slaan, zodat ze deze op een later tijdstip kunnen hervatten.
Dit kan op de volgende manieren worden ingesteld:

Met TFA-bestanden (standaard, kan niet worden uitgeschakeld).
Via e-mail, waarbij het TFA-bestand wordt opgeslagen op de webserver.
Via e-mail, waarbij het TFA-bestand wordt weggeschreven naar een database.

Met TFA-bestanden (standaard, kan niet worden uitgeschakeld).

Om met TFA-bestanden te werken, hoeft u niets speciaals in te richten. Dit staat standaard aan binnen TriplEforms.
Let er wel op dat dit niet uitgeschakeld kan worden.

Door middel van de 'Open' en 'Opslaan' knoppen rechtsboven in het scherm kan de gebruiker het huidige formulier (inclusief antwoorden en bijlagen) opslaan.

Na het klikken op 'Opslaan' wordt de gebruiker gevraagd om een wachtwoord in te voeren om het bestand mee te beveiligen.
Dit is niet het enige waarmee het bestand wordt beveiligd. Standaard wordt het bestand ook versleuteld.

Het gegenereerde bestand kan op een later tijdstip door middel van de 'Open' knop ingeladen worden.
Let er wel op dat dit alleen zal werken als er in de tussentijd geen wijzigingen hebben plaatsgevonden in het formulier.
Mocht het formulier aangepast zijn, dan zal het niet meer mogelijk zijn om eerder opgeslagen formulieren in te laden.

Via e-mail, waarbij het TFA-bestand wordt opgeslagen op de webserver.

Om deze optie te gebruiken, is er een aanpassing nodig in de web.config.

Locatie toevoegen waar de bestanden moeten worden opgeslagen.

<configuration>
  ...
  <appSettings>
    ...
    <!-- Location for storing forms and metadata to be resumed. -->
    <add key="formResumeStoragePath" value="App_Data\FormResume"/>
    ...
  </appSettings>
  ...
</configuration>

Verder moet er ook een e-mailtemplate toegevoegd worden.
Deze moet in de App_Data map opgeslagen worden.

Controleer of het bestand 'FormResumeEmailSettings.xml' bestaat in de App_Data map. Zo niet, maak het dan aan.
De inhoud van het bestand kan er als volgt uitzien.
```
<ef:formResumeEmailSettings xmlns:ef="http://www.kodision.com/tripleforms/v2.0/settings">
 <ef:fromAddress>[email protected]</ef:fromAddress>
 <ef:subject>Verdergaan met uw online aanvraag of melding bij atabix</ef:subject>
 <ef:body><![CDATA[
 Geachte mevrouw / meneer,
 Klik op <a href="{0}">deze link</a> om terug te keren naar het formulier.
 Met vriendelijke groet,
 Atabix
 ]]>
 </ef:body>
 <ef:host>localhost</ef:host>
</ef:formResumeEmailSettings>
```
Zoals hierboven te zien is, zijn er een aantal instelbare velden binnen het XML bestand.
- ```
<ef:fromAddres></ef:fromAddres>
```
 Vanaf dit mailadres worden de 'Later hervatten' mails verstuurd.
- ```
<ef:subject></ef:subject>
```
 Dit is het onderwerp van de e-mail.
- ```
<ef:body><![CDATA[ ]]></ef:body>
```
 Dit is de inhoud van de e-mail. De e-mail kan met html worden opgebouwd.
 Let er wel op dat de HTML binnenin de '<![CDATA[ ]]>' tag blijft staan.
 Zoals te zien is, zijn er ook een aantal placeholders die gebruikt kunnen worden binnen de html.
 - '{0}' bevat de link om het formulier te hervatten.
 - '{1}' bevat de formuliernaam.
 - '{2}' bevat de datum waarop de e-mail werd verzonden.
 - '{3}' bevat het tijdstip waarop de e-mail werd verzonden.

Ook is het noodzakelijk om 'Later hervatten via e-mail' te activeren via de instellingen.

Nu is het mogelijk om met de 'Later hervatten' knop het formulier op te slaan en een e-mail te versturen.

Na het klikken op de 'Later hervatten' knop zal de volgende pop-up weergegeven worden.

Zodra de gebruiker op 'Verstuur' klikt, wordt er een TFA bestand opgeslagen op de server en ontvangt de gebruiker een e-mail met een link om het formulier te hervatten.

Via e-mail, waarbij het TFA-bestand wordt weggeschreven naar een database.

Om deze optie te gebruiken, zijn er een aantal vereisten

De SecureDataStore database moet aangemaakt worden.
Neem contact op met support om de installatie instructies hiervoor te ontvangen.

Database connection string toevoegen in de web.config.

<configuration>
  ...
  <connectionStrings>
    ...
        <add name="SecureDataStore" connectionString="---ENTER-SECUREDATASTORE-CONNECTIONSTRING-HERE---" providerName="System.Data.SqlClient" />
    ...
    </connectionStrings>
  ...
</configuration>

Verder moet er ook een e-mailtemplate toegevoegd worden.
Deze moet in de App_Data map opgeslagen worden.

Controleer of het bestand 'FormResumeEmailSettings.xml' bestaat in de App_Data map. Zo niet, maak het dan aan.
De inhoud van het bestand kan er als volgt uitzien.
```
<ef:formResumeEmailSettings xmlns:ef="http://www.kodision.com/tripleforms/v2.0/settings">
 <ef:fromAddress>[email protected]</ef:fromAddress>
 <ef:subject>Verdergaan met uw online aanvraag of melding bij atabix</ef:subject>
 <ef:body><![CDATA[
 Geachte mevrouw / meneer,
 Klik op <a href="{0}">deze link</a> om terug te keren naar het formulier.
 Met vriendelijke groet,
 Atabix
 ]]>
 </ef:body>
 <ef:host>localhost</ef:host>
</ef:formResumeEmailSettings>
```
Zoals hierboven te zien is, zijn er een aantal instelbare velden binnen het XML bestand.
- ```
<ef:fromAddres></ef:fromAddres>
```
 Vanaf dit mailadres worden de 'Later hervatten' mails verstuurd.
- ```
<ef:subject></ef:subject>
```
 Dit is het onderwerp van de e-mail.
- ```
<ef:body><![CDATA[ ]]></ef:body>
```
 Dit is de inhoud van de e-mail. De e-mail kan met html worden opgebouwd.
 Let er wel op dat de HTML binnenin de '<![CDATA[ ]]>' tag blijft staan.
 Zoals te zien is, zijn er ook een aantal placeholders die gebruikt kunnen worden binnen de html.
 - '{0}' bevat de link om het formulier te hervatten.
 - '{1}' bevat de formuliernaam.
 - '{2}' bevat de datum waarop de e-mail werd verzonden.
 - '{3}' bevat het tijdstip waarop de e-mail werd verzonden.

Ook is het noodzakelijk om 'Later hervatten via e-mail (met database)' te activeren via de instellingen.

Nu is het mogelijk om met de 'Later hervatten' knop het formulier op te slaan en een e-mail te versturen.

Na het klikken op de 'Later hervatten' knop zal de volgende pop-up weergegeven worden.

Zodra de gebruiker op 'Verstuur' klikt, wordt het TFA bestand weggeschreven naar de database en ontvangt de gebruiker een e-mail met een link om het formulier te hervatten.

Met het gebruik van de database is het ook mogelijk een uiterlijke hervatdatum op te geven voor de formulieren.
Standaard is er geen uiterlijke hervatdatum ingesteld.
Op de volgende manier kan een standaard worden ingesteld via de web.config.

<configuration>
  ...
  <securedata.archive saveToSecureDataStore="false" expiration="1" unit="Days" removeOnCompletion="true" />
  ...
</configuration>

Met bovenstaande configuratie zal een standaardtermijn van 1 dag worden gehanteerd voor alle scenario's.

Het is ook mogelijk om per scenario een aparte termijn in te stellen. Dit kan als volgt.

<configuration>
	...		
	<securedata.archive saveToSecureDataStore="false" expiration="1" unit="Days" removeOnCompletion="true"/>
		...
        <add id="scContact" saveToSecureDataStore="false" expiration="5" unit="Days" removeOnCompletion="true"/>
		...
    </securedata.archive>
	...
</configuration>

Met bovenstaande configuratie is er een standaard vervaltermijn van 1 dag en voor 'scContact' een vervaltermijn van 5 dagen.
Voor elk scenario dat een ander vervaltermijn heeft, kunt u een regel toevoegen.