Aanmaakformulier
Automatische generatie van bestanden op uw website - diploma's, certificaten en andere documenten. Bezoekers hoeven alleen het formulier in te vullen en ontvangen meteen een bestand.
Om bestanden te genereren moet u een HTML-formulier op uw website aanmaken. Als dit niet mogelijk is, kunt u eenvoudig gebruik maken van een generatiewidget.
Formulier aanmaken
Om aanvragen voor het genereren van bestanden naar DiMaker te sturen, moet u een formulier op uw website maken. Dit formulier kan zowel in het openbare als gesloten deel van uw website geplaatst worden. Maak een pagina en formulier aan via uw CMS.
Actie-URL van het formulier
https://dimaker.app/api/v1/webform-create/Velden van het formulier
U moet een aantal verborgen velden toevoegen met de volgende waarde:
-
secure*
Token (een string van 36 tekens)
-
doc_id*
ID van het document (een string van 36 tekens) dat wordt gebruikt om een bestand te genereren. De ID kunt u vinden in de URL van het geopende document. Het document mag niet in de prullenbak staan, maar kan wel in elke map binnen Documenten liggen.
-
mail_id
ID van de e-mailsjabloon (een string van 36 tekens) die wordt gebruikt om het bestand via e-mail te verzenden. De ID is te vinden in de URL van de geopende sjabloon. Als deze variabele niet wordt meegegeven, wordt er geen e-mail verstuurd.
-
email_send
Het tijdstip waarop de e-mail met het bestand wordt verzonden. Mogelijke waarden:
onfinish - Verstuur e-mails nadat alle bestanden zijn gegenereerd (standaard)
oncreate - Verstuur de e-mails direct na het genereren van een bestand. Bij een enkel bestand werken onfinish en oncreate hetzelfde.
timeout - Verstuur e-mails na een opgegeven tijdsinterval. Hierbij zijn extra parameters nodig:
email_timeout_value - Numerieke waarde van de tijdsduur voordat e-mails worden verstuurd
email_timeout_unit - Tijdseenheid, zoals "m" (minuten), "h" (uren), "d" (dagen).
Voor een specifiek verzendtijdstip kunt u een tijd in unix-tijdformaat opgeven in email_timeout_timestamp. Indien beide, timeout en email_timeout_timestamp, worden meegegeven, heeft de laatste voorrang. -
folder_id
ID van de map op Schijf (een string van 36 tekens) waarin de bestanden worden opgeslagen. Als de map nog niet bestaat, wordt deze automatisch aangemaakt bij het creëren van het eerste bestand.
-
page_id
Het paginanummer (een getal of string), indien het document uit meerdere pagina's bestaat. U kunt één nummer opgeven (eerste pagina = 0) of meerdere nummers (gescheiden door komma's) van pagina's die worden gebruikt voor het genereren van bestanden.
Zelf een bestand ontvangen na aanmaak
Het bestand wordt automatisch naar het e-mailadres van uw account gestuurd zodra het bestand is aangemaakt. In het veld "E-mailsjabloon" kunt u kiezen welke sjabloon u wilt gebruiken. U kunt vooraf een aparte e-mailsjabloon aanmaken in E-mailsjablonen voor het versturen van bestanden naar uw account. Voeg in de tekst van de e-mail de variabele %data in om alle gegevens van het bestand als tabel weer te geven.
Scripts en stijlen
Op de integratiepagina kunt u code ophalen en deze plaatsen in de HEAD-sectie of een andere plek op de pagina. Deze code hoeft slechts op de pagina met het formulier toegevoegd te worden, niet op alle pagina's van uw website.
Daarnaast moet u twee blokken maken met id’s: result-success en result-danger. Beide blokken moeten verborgen zijn (display:none). In het eerste blok kunt u de tekst voor succesvolle bestandsgeneratie plaatsen. Dit blok wordt getoond bij een geslaagde inzending. Bij een fout wordt de foutmelding automatisch in het blok met id result-danger weergegeven.
Veldvervanging in een document
Uw document moet minstens één variabele bevatten die vervangen kan worden, zoals %name of %course. Voeg in het formulier velden toe waarbij de naam van de variabele begint met mask_, bijvoorbeeld mask_name of mask_course. Gegevens die door bezoekers worden ingevuld, vervangen de corresponderende variabelen in het document. Voor het e-mailadres gebruikt u de variabele mask_email. Als u meerdere e-mailadressen wilt opgeven, scheidt deze dan met een komma of een spatie. De verzendstatus op Schijf wordt weergegeven bij het eerste adres.
Werking van het formulier
Na het maken van het formulier kunt u de gepubliceerde pagina openen om het formulier te testen. Er wordt een bestand gegenereerd en weergegeven in een pop-up voor download.
Eén document = één invulling
Optioneel kunt u het aantal invullingen van het formulier beperken. Als er al een bestand met het aangegeven e-mailadres en doc_id is aangemaakt, ziet de gebruiker een waarschuwing dat er slechts één bestand gemaakt kan worden.
Mijn documenten
U kunt bezoekers toegang geven tot hun eigen documenten in het gesloten deel van uw website. Maak hiervoor een formulier zoals hierboven beschreven en voeg verborgen velden toe: email, secure en doc_id. Vul in het email-veld het e-mailadres van de bezoeker in en in het laatste veld de waarde "all". Bij het openen van deze pagina ziet de bezoeker een lijst van alle documenten en heeft hij/zij de mogelijkheid deze te downloaden. Als u wilt dat een bezoeker die het formulier al heeft ingevuld direct zijn/haar bestand ziet in plaats van het formulier, moet het email-veld automatisch door uw CMS worden ingevuld.