Algemene & Logica-opties
Gebruikersinteracties zijn acties die worden geactiveerd wanneer een gebruiker op een knop of pictogram tikt. Hoewel deze kunnen worden gebruikt op schermen en formulieren, richt deze gids zich op het Action Button Field, waarmee je tot 5 aangepaste knoppen per veld kunt toevoegen.
Referentie-app: Zoek naar “User Interactions” in de Examples Catalog om een werkende demo van deze functies in je account te installeren.
Gebruik deze tabel om exact te bepalen welke gegevens in een Interaction-veld moeten worden doorgegeven zodat het goed werkt.
| Categorie | Interaction | Vereiste Syntax / Parameter | Voorbeeld |
| Contact | E-mail maken | To e-mailadres |
support@company.com of {{client_email}} |
| SMS / Bellen maken | Internationaal telefoonnummer | +1234567890 of {{phone_field}} |
|
| Locatie | Adres coördineren | Tekstadres of komma-gescheiden velden | {{street}}, {{city}}, {{zip}} |
| Op kaart weergeven | Tekstadres OF lat lon |
{{lat}} {{lon}} |
|
| Scherm | Scherm openen | dataname:value (pipe-gescheiden) |
field1:value1|field2:{{order_id}} |
| Bij terugkeer opnieuw laden | Veld-/Paginanamen (komma-gescheiden) | MyTable, TotalField, All |
|
| Taken | Taak openen | Taak-ID | {{this[0]}} (1e kolom van taakrij) |
| Web | URL openen | Volledige URL (moet protocol bevatten) | https://www.google.com |
| Logica | Geen Interaction | (Geen) – Wijst Label toe aan Data-Name | {{btn_name}} geeft “Label Text” terug |
Volg deze drie gouden syntaxisregels om ervoor te zorgen dat je interactions correct worden geactiveerd:
- De dynamische placeholder:
{{dataname}}Elke waarde omsloten door dubbele accolades vertelt het systeem “kijk naar dit veld” in plaats van letterlijke tekst te gebruiken.
- Statisch:
Seattle(Zoekt altijd naar Seattle) - Dynamisch:
{{city}}(Zoekt naar wat de gebruiker in het ‘city’ veld heeft ingetypt)
- Statisch:
- De pipe-scheidingsteken:
|Wanneer je meerdere waarden naar een nieuw scherm doorgeeft, gebruik je het pipe-symbool (meestal boven de Enter-toets) om verschillende veldtoewijzingen te scheiden.
- Syntax:
field1:value1|field2:value2
- Syntax:
- Taakverwijzing:
{{this[n]}}Bij het werken met Task Data Sources begint de index bij 0.
{{this[0]}}= 1e kolom{{this[1]}}= 2e kolom
Omdat je tot 5 knoppen op een Action Field kunt configureren, prioriteer je ze op basis van gebruiksfrequentie:
- Primaire actie: (bijvoorbeeld uploaden of volgende) — Plaats deze aan de rechterkant.
- Secundaire actie: (bijvoorbeeld concept opslaan) — Plaats in het midden.
- Destructieve actie: (bijvoorbeeld afsluiten/annuleren) — Plaats aan de linkerkant om onopzettelijke tikken te voorkomen.
Algemene & logica-opties
Standaardacties die niet in een specifieke categorie passen, maar essentieel zijn voor formulierlogica.
⚪ Geen Interaction
- Gedrag: De knop activeert geen externe actie. In plaats daarvan wordt het Label van de knop doorgegeven als waarde.
- Syntax: Als de Data-Name
status_btnis en het LabelApprove, stelt het indrukken ervan{{status_btn}}in op"Approve". - Best gebruik: Gebruik dit om verborgen berekeningen, REST API-oproepen of zichtbaarheidslogica te activeren op basis van welke knop werd ingedrukt. (bijvoorbeeld: Toon sectie B alleen als
{{status_btn}}= ‘Approve’).
Interne navigatie (Spring naar locatie)
Gebruik deze om aangepaste “Overslaan”-logica of snellere navigatielinks te maken. Deze zijn vooral handig voor lange, meerdelige formulieren waar gebruikers irrelevante secties moeten omzeilen.
🏃 Spring naar formulierlocatie
- Gedrag: Leidt de gebruiker om naar een specifiek punt in het huidige formulier.
- Opties:
- Begin/Einde van formulier: Gaat onmiddellijk naar de eerste of laatste paginarong> als je wilt dat de knop voorbij bestaande vermeldingen springt en elke keer een frisse, lege gegevenrij opent.
Voltooiing & Verzending
Deze interacties verwerken de laatste fasen van de workflow van de gebruiker en bepalen hoe gegevens worden opgeslagen en hoe de gebruiker afsluit.
💾 Afsluiten & Wijzigingen Opslaan
- Gedrag: Sluit het huidige formulier af en slaat een lokale concept van de gegevens op.
- Beste Gebruik: Een “Opslaan & Later Afmaken”-knop maken zodat gebruikers hun voortgang niet kwijtraken als ze worden onderbroken.
💾 Opslaan Zonder Af Te Sluiten
- Gedrag: Slaat alle huidige veldvermeldingen onmiddellijk op het lokale apparaat op, maar houdt het formulier open.
- Beste Gebruik: Gebruik dit voor zeer lange formulieren of “Observatie”-logboeken waar een gebruiker gegevens mogelijk over enkele uren invoert. Het zorgt ervoor dat als de apparaatbatterij leegraakt of de app opnieuw wordt gestart, de gegevens al veilig zijn opgeslagen.
🛑 Afsluiten Zonder Opslaan
- Gedrag: Sluit het formulier af en verwerpt alle wijzigingen die tijdens de huidige sessie zijn aangebracht.
- Beste Gebruik: Een “Annuleren” of “Verwijderen”-knop om onbedoelde gegevensinvoer te voorkomen.
📤 Formulier Uploaden
- Gedrag: Start het finale verzendingsproces naar onze servers.
- Vereiste: Het best gebruikt aan het einde van een workflow nadat alle validatie is voltooid.
🖨️ Formulier Uploaden en Afdrukken
- Gedrag: Verzendt de gegevens naar de server en start onmiddellijk een afdruktaak.
- Vereiste: Vereist een geconfigureerde App Printing HTML-template in de webportal.
Visuele Indelingsstip: Groepering op Kleur
- Blauw/Grijs voor Navigatie (Naar Locatie Springen)
- Groen voor Succes/Verzending (Uploaden)
- Rood voor Afsluiten/Annuleren (Afsluiten Zonder Opslaan)
Contactopties
Start de native communicatie-apps van het apparaat met vooringevulde gegevens.
✉️ E-mail Maken
- Gedrag: Opent de standaard e-mailclient met “Aan” vooringevuld.
- Parameter: Het doel-e-mailadres.
- Syntaxis:
sales@company.comof{{client_email}}
💬 SMS Maken
- Gedrag: Opent de standaard berichten-app met het “Aan”-nummer vooringevuld.
- Parameter: Het doel-telefoonnummer.
- Syntaxis:
+1234567890(Internationaal formaat aanbevolen).
📞 Telefoonnummer Kiezen
- Gedrag: Opent de apparaattelefoon met het opgegeven nummer klaar om te bellen.
- Parameter: Een statisch of dynamisch telefoonnummer.
- Syntaxis:
{{phone_field}}
Locatie- & Kaartopties
Integreer geografische gegevens met de GPS- en kaartmogelijkheden van het apparaat.
🗺️ Adres Geocoderen
- Gedrag: Converteert tekstaddressen naar coördinaten van decimale breedte-/lengtegraad.
- Syntaxis:
{{street}}, {{city}}, {{zip}} - Uitvoer: Resultaten worden geretourneerd als
lat lon(bv.-13.38 153.98).
📍 Adres op Kaart Weergeven
- Gedrag: Opent de kaart-app van het apparaat op een specifiek tekstadres.
- Syntaxis:
5 My Road, City, Post Codeof{{myaddressfield}}
📍 Coördinaten op Kaart Weergeven
- Gedrag: Opent de kaart-app op specifieke GPS-coördinaten.
- Syntaxis: Spatiescheidende coördinaten:
{{lat}} {{lon}}of-12.34 76.54.
App- & Gegevensopties
Beheer hoe de app gesynchroniseerd blijft met onze servers en lokale gegevens.
🔄 Synchronisatie Forceren
- Gedrag: Maakt verbinding met de server om alle schermen en gegevensbronnen bij te werken.
- Vereiste: Vereist een actieve internetverbinding.
📄 Scherm Vernieuwen
- Gedrag: Herlaadt het huidige formulier en de lokale gegevensbronnen ervan.
- Beste Gebruik: Gebruik dit om onlangs toegevoegde rijen weer te geven die al op het apparaat staan.
Document- & Schermopties
Navigeer tussen verschillende delen van je app of open externe bestanden.
📄 Document Openen
- Gedrag: Opent een bestand uit je “Bestanden & Documenten”-sectie met behulp van de standaardviewer van het apparaat (bv. Adobe Acrobat voor PDF’s).
- Parameter: Geef een hardcoded Bestand-ID of een dynamische veldwaarde op.
🖥️ Scherm Openen
- Gedrag: Start een ander scherm in de app en kan gegevens doorsturen.
- Syntaxis:
target_field:{{current_field}}|another_field:static_value - Filteren: Gebruik
{{target[column]}}voor Listing/Details/Kaart-doelen.
🔁 Herladen bij Terugkeer
- Gedrag: Vernieuwt specifieke velden of pagina’s nadat de gebruiker van een onderliggend scherm terugkeert.
- Syntaxis:
AllofPageName, FieldName, TableName. - Waarschuwing: Het herladen van een veld wist alle niet-opgeslagen gebruikersbewerkingen in dat veld.
URL- & Taakopties
Maak verbinding met externe webresources of specifieke workflowtaken.
🌐 URL-Syntaxis
- Vereiste: Gebruik altijd het volledige protocol (bv.
https://). - URL in App Openen: Gebruikt de interne appbrowser.
- Link in Browser Openen: Start de externe browser van het apparaat (Chrome/Safari).
📋 Taak Openen
- Gedrag: Opent een specifieke taak via de Taak-ID ervan.
- Syntaxis:
{{this[n]}}waarbijnde kolomindex is (vanaf 0) van je Taakgegevensbron.
Probleemoplossing Veelgestelde Problemen
Als een interactie zich niet gedraagt zoals verwacht, gebruik je deze gids om de meest voorkomende configuratiefouten te identificeren en op te lossen.
🔗 URL of E-mail Wordt Niet Geopend
- De Oorzaak: Protocol Ontbreekt.
- De Oplossing: Zorg ervoor dat je URL begint met
https://en niet alleenwww.. Voor e-mails moet je ervoor zorgen dat het e-mailadres geldig is en geen onbedoelde spaties aan het einde van het veld bevat.
📍 Geocodering Retourneert “Geen Resultaten”
- De Oorzaak: Dubbelzinnige of onvolledige adresgegevens.
- De Oplossing: Geocodering werkt het best met specifieke gegevens. In plaats van alleen
{{city}}, probeer je een reeks velden door te geven:
- Begin/Einde van formulier: Gaat onmiddellijk naar de eerste of laatste paginarong> als je wilt dat de knop voorbij bestaande vermeldingen springt en elke keer een frisse, lege gegevenrij opent.
Antwoord niet gevonden?
Staat jouw vraag er niet bij? Neem dan direct contact met ons op.
Contact opnemen