Herhalende rijen
Na het vastleggen van herhaalbare gegevens, wil je misschien aanpassen hoe deze worden weergegeven in PDF-uitvoer met behulp van Word- of Excel-sjablonen.
Er zijn twee manieren om de antwoorden voor deze herhaalbare velden in je sjabloon uit te voeren:
- Rijen in een Word-tabel of Excel-werkblad herhalen met behulp van de speciale
{{REPEATROW}}placeholder - Definieer het gedeelte van de sjabloon dat voor elk herhaling moet worden uitgevoerd.
Dit maakt gebruik van de speciale{{!REPEATSTART}}en{{!REPEATEND}}placeholders.
Deze opties stellen je in staat om herhalende gegevens op de manier te verwerken die je wilt.
Hoewel er veel flexibele manieren zijn om herhalende gegevens te verwerken, moet je er rekening mee houden dat nesting van REPEATSTART/REPEATEND-syntaxis niet wordt ondersteund — dat wil zeggen dat je geen REPEATSTART in een ander REPEATSTART kunt plaatsen.
Als je inhoud dynamisch wilt verbergen, is de juiste aanpak het gebruik van Secties/Rijen verbergen in aangepaste sjablonen.
Voor downloadbare voorbeelden van sjablonen met herhaalbare gegevens, ga naar het einde van dit artikel.
Rijen herhalen
Vaak is het handig om herhalende gegevens in een Word-tabel of Excel-werkblad te plaatsen.
Je kunt een herhaalbare lijst maken door een speciale {{!REPEATROW}} placeholder toe te voegen aan de eerste cel van de rij die je wilt herhalen.
Het systeem herhaalt dan de omsluitende rij en vervangt alle placeholders met de relevante gegevenswaarden, bijvoorbeeld:
Word – Tabel
| Voornaam | Achternaam | Geslacht |
|---|---|---|
| {{!REPEATROW}}{{firstname}} | {{lastname}} | {{gender}} |
Excel – Werkblad
| Voornaam | Achternaam | Geslacht | |
|---|---|---|---|
| {{!REPEATROW}} | {{firstname}} | {{lastname}} | {{gender}} |
Onthoud dat je de {{!REPEATROW}} placeholder als allereerste item in de rij moet plaatsen!
Meerdere herhalingen per rij
Het kan handig zijn om herhalende waarden naast elkaar in dezelfde rij weer te geven – bijvoorbeeld, als je een herhaalbare fotovastleggingspagina hebt, wil je de foto’s mogelijk naast elkaar in een twee- of driekolomconfiguratie plaatsen.
Dit is mogelijk door speciale syntaxis aan de {{!REPEATROW}} placeholder toe te voegen: je moet een pijpteken volgen met het aantal herhalingen dat per rij moet worden afgehandeld.
Als je bijvoorbeeld drie sets herhalende waarden naast elkaar wilt hebben, gebruik je het volgende:
{{!REPEATROW|3}}
Vervolgens moet je in het herhaalde rijgedeelte van je sjabloon de gewenste herhalingsvelden net zoveel keer opgeven als het aantal sets dat moet worden weergegeven.
Bij generering wordt de antwoordwaarde van elke herhaling opeenvolgend ingevoegd voor elk voorkomen van dezelfde gegevensnaam in de rij, bijvoorbeeld:
Word – Tabel
|
{{!REPEATROW|3}}{{photo}} |
{{photo}} |
{{photo}} |
Excel – Werkblad
|
{{!REPEATROW|3}} |
{{photo}} |
{{photo}} |
{{photo}} |
Herhalende secties
Met deze optie definieer je de placeholders eenmalig voor de gewenste velden in een herhaalbare paginagroep en plaats je deze binnen unieke {{!REPEATSTART}} en {{!REPEATEND}} placeholders.
Het systeem herhaalt alle rijen tussen de START- en END-placeholders voor Excel.
Dit geeft het systeem de opdracht om alles te herhalen wat in de REPEAT-placeholders staat, inclusief opmaak, opsommingstekens, tabelrijen, afbeeldingen, statische tekst, enz.
Bij generering van uitvoer kopieert het systeem het gebied binnen de REPEATs en vervangt het alle reguliere gegevensnaam-placeholders in het gebied voor elke herhaling van de antwoorden.
Stel je bijvoorbeeld voor dat je een formulier hebt met een herhaalbare set velden voor het vastleggen van kinderen:
- Voornaam (gegevensnaam=”firstname”)
- Achternaam (gegevensnaam=”lastname”)
- Geslacht (gegevensnaam=”gender”)
Je kunt een herhaalbare opsomming als volgt definiëren:
{{!REPEATSTART}}
Naam: {{lastname}}, {{firstname}}
Geslacht: {{gender}}
{{!REPEATEND}}
Zowel {{!REPEATSTART}} als {{!REPEATEND}} placeholders moeten respect
"Activities": [
{
"FormId": "",
"FormExternalId": "test",
"FormAnswers": [
{
"Name": "page1",
"Type": "Group",
"Answers": [
{
"Name": "choice",
"Value": "{{choice}}"
},
{{!REPEATSTART}}
{
"Name": "table",
"Type": "RepeatGroup",
"Answers":
[
{
"Name": "company",
"Value": "{{company}}"
},
{
"Name": "job",
"Value": "{{job}}"
}
]
},
{{!REPEATEND}}
]
}
]
}
],
Deze syntaxis kan worden gebruikt bij het uitvoeren van gegevens voor een JSON-template of bij communicatie met JSON REST APIs. De syntaxis is hetzelfde.
Herhalende secties – XML
Voer XML-geformatteerde tekst uit via een XML-template met behulp van de onderstaande syntaxis om door herhalende datasecties te itereren:
{{!REPEATSTART}}
{{the_artist}}
{{country}}
{{company}}
{{price}}
{{year}}
{{!REPEATEND}}
Meerdere herhalingen per sectie
Soms kan het nuttig zijn om herhalingswaarden naast elkaar in dezelfde sectie weer te geven. Als je bijvoorbeeld een herhalende fotocapture-pagina hebt, wil je de foto’s misschien naast elkaar in een twee- of driekoloms-indeling plaatsen, met bijschriften en andere herhaalde gegevens bovenof onder elke foto.
Dit is mogelijk door speciale syntaxis toe te voegen aan de {{!REPEATSTART}} placeholder: je moet een pipe-teken gevolgd door het aantal herhalingen per rij plaatsen.
Als je bijvoorbeeld drie sets herhalingswaarden naast elkaar wilt hebben, gebruik je het volgende:
{{!REPEATSTART|3}}
Vervolgens moet je in het herhaalde sectiegedeelte van je template de gewenste herhalingsvelden zoveel keer opgeven als het aantal weer te geven sets.
Bij generering wordt de antwoordwaarde van elke herhaling sequentieel ingevoegd voor elk voorkomen van dezelfde datanaam in de sectie, bijvoorbeeld:
Word – Pagina & tabel
Foto’s
{{!REPEATSTART|3}}
Fotonaam:{{photoName}} |
Fotonaam: {{photoName}} |
Fotonaam: {{photoName}} |
{{photo}} |
{{photo}} |
{{photo}} |
{{photoCaption}} |
{{photoCaption}} |
{{photoCaption}} |
{{!REPEATEND}}
Excel – Blad
{{REPEATSTART|3}} |
||
Fotonaam:{{photoName}} |
Fotonaam:{{photoName}} |
Fotonaam:{{photoName}} |
{{photo}} |
{{photo}} |
{{photo}} |
{{photoName}} |
{{photoName}} |
{{photoName}} |
{{REPEATEND}} |
Voorbeelden
Hieronder vind je een formulierontwerp en gegevensuitvoertemplates voor Word en Excel om je te helpen begrijpen hoe de bovenstaande functionaliteit werkt.
- Download deze bijlagen en maak vervolgens een nieuw formulier voor je account.
- Ga naar de Designer-pagina van je nieuwe formulier en gebruik de knop “Velden importeren” om het formulier .xlsx-bestand te importeren.
Dit importeert het testformulierontwerp. Nadat je de velden hebt geïmporteerd, moet je het formulier in de testmodus instellen. - Ga vervolgens naar de instellingenpagina van je nieuwe formulier en upload de bijgesloten Template .xlsx- en docx-bestanden in respectievelijk de velden Excel- en Word-standaardtemplate.
- Open nu het formulier op je apparaat en leg een invoer vast. Zorg ervoor dat je meer dan één foto vastlegt.
Voltooi de invoer en upload deze vanuit je app. - Ga ten slotte naar de gegevenspagina van de beveiligde website en zoek je invoer.
Beweeg de muisaanwijzer over de invoeringsrij en klik op de koppeling Exporteren. Kies vervolgens een van de templatebestanden om de uitvoer te downloaden.
Antwoord niet gevonden?
Staat jouw vraag er niet bij? Neem dan direct contact met ons op.
Contact opnemen