Formulekaart

Bijgewerkt op 14 juni 2026 · 5 min leestijd

Hieronder vind je een uitgebreide lijst met formule-functies van TaskForm die kunnen worden gebruikt in verschillende veld-eigenschappen binnen het platform, overal waar het hamerpictogram aanwezig is.

CONTEXTUEEL

USEREMAIL()	E-mailadres van gebruiker.
USERFIRSTNAME()	Voornaam van gebruiker.
USERLASTNAME()	Achternaam van gebruiker.
USEREXTERNALID()	Externe ID van gebruiker.
USERINGROUP()	Geeft True/False terug als de groepsnaam of externe ID van de ingelogde gebruiker overeenkomt met de opgegeven naam/externe ID. `USERINGROUP('group name or external Id')`
ORGNAME()	Organisatienaam.
GLOBALVAL(‘keyname’) Globale waarde	Haalt de globale waarde op voor de opgegeven sleutelnaam (indien aanwezig).
ORGMETA(‘key’) Metagegevens organisatie	Haalt de metagegevenswaarde van de provider op voor de opgegeven sleutel (indien aanwezig). Als jouw organisatieinstellingen bijvoorbeeld een metagegevenssleutel van facturerings-ID bevatten, kun je deze waarde via het platform benaderen met `ORGMETA('billing_id')`
USERMETA(‘key’) Metagegevens gebruiker	Haalt de metagegevenswaarde van de gebruiker op voor de opgegeven sleutel (indien aanwezig). Als jouw gebruikersinstellingen bijvoorbeeld een metagegevenssleutel van facturerings-ID bevatten, kun je deze waarde via het platform benaderen met `USERMETA('billing_id')`
DEVICENAME()	Geeft de fabrikant van het systeem en apparaatinformatie terug.
DEVICEOS()	Het besturingssysteem van het apparaat.
DEVICEOSVERSION()	De huidige versie van de app die op het apparaat van de gebruiker is geïnstalleerd.
DEVICEALIAS()	Geeft de door de gebruiker ingestelde naam van het apparaat terug. Let op, voor iOS-apparaten: iOS 15 en lager geeft de door de gebruiker ingestelde naam van het apparaat terug. iOS 16 en hoger geeft het apparaatmodel terug / vergelijkbaar met `DEVICENAME()`
APPVERSION()	De huidige versie van de app die op het apparaat van de gebruiker is geïnstalleerd.
SCREENVERSION()	Het versienummer van het huidige scherm op het apparaat.
SCREENDATE() Scherm laatst bijgewerkt (UTC)	De datum en tijd waarop het huidige scherm op het apparaat voor het laatst is bijgewerkt voor de GMT (UTC) tijdzone
VAL(‘dataname’) Directe waarde	De VAL-formule is bedoeld voor gebruik wanneer een dynamische afhankelijkheid tot circulaire verwijzingsproblemen zou leiden en is niet dynamisch bij gebruik alleen, met terugkeer van de waarde van het veld waarnaar wordt verwezen, ‘dataname’. Voorbeeld: `IF(ISBLANK({{oneField}}), VAL('otherField'), {{oneField}})` Deze formule wordt eenmaal geëvalueerd wanneer het formulier wordt geladen en daarna alleen opnieuw geëvalueerd wanneer de waarde van ‘oneField’ verandert. Deze formule is op geen enkele manier dynamisch afhankelijk van ‘otherField’ omdat deze geen dynamische verwijzing {{otherField}} bevat. Wanneer de waarde van ‘otherField’ verandert, wordt deze formule niet opnieuw geëvalueerd.
COUNTER() Schermparameter	Eenvoudige teller die met 1 toeneemt telkens wanneer een nieuw formulierinvoer in de app wordt aangemaakt. De teller wordt links opgevuld met nullen tot de opgegeven vulbreedte. Combineer counter() met gebruikersgegevens om unieke nummers te genereren. OPMERKING: Tellernummers zijn apparaatspecifiek.
EVAL()	Evalueer een formule dynamisch door generieke geïndexeerde numerieke aanduidingen te gebruiken met een bijbehorende kommagescheiden geordende lijst met velden die in de formule moeten worden vervangen.`EVAL(formula,{{myfield1}}, {{myfield2}}, ..., {{myfieldN}})` Voorbeeld: EVAL(“IF({{0}} = {{1}},’True’,’False'”,{{textField1}},{{textField2}}) waarbij {{0}} wordt vervangen door de waarde van {{textField1}} en {{1}} wordt vervangen door de waarde van {{textField2}}. Alternatief kan ook een gegevensbronverwijzing met een formule worden gebruikt om de formulewaarde in te vullen. Voorbeeld: `EVAL({{ds[0]}},{{textField1}},{{textField2}})` Tekst evalueren als formule
TASK(‘key’) Gekoppelde taakgegevens – ALLEEN APP	Haalt de gegevenswaarde op voor de opgegeven sleutel wanneer dit scherm aan een taak is gekoppeld. Geeft lege waarde terug als geen taak is gekoppeld. De volgende taaksleutels zijn beschikbaar: ADDITIONALINFO, COMPLETEAT, COMPLETEATLAT, COMPLETEATLON, EXTERNALID, ID, ISOVERDUE, NAME, PERFORMWITHIN, COMPLETEBY, COMPLETEBYUTC, STARTTIME, STARTTIMEUTC. bijv. TASK(‘COMPLETEAT’) geeft het adrestekst van de gekoppelde taak terug
USERLANG()	Geeft de momenteel ingestelde gebruikerstaal in de app-instellingen terug. bijv. `IF(USERLANG() = 'English', true, false)` Gebruikt in dit formaat, kun je de zichtbaarheid van bepaalde velden in jouw app beheren. Als een gebruiker bijvoorbeeld Engels spreekt, kan deze zichtbaarheidsformule worden gebruikt om de Franse velden voor hen te verbergen en alleen de Engelse velden weer te geven.

SYSTEEMWAARDEN

TODAY() Huidige datum	De huidige lokale datum gemeld door het apparaat. OPMERKING: Apparaatdatums kunnen onnauwkeurig zijn als de lokale tijd niet correct is.
NOW() Huidige datum en tijd	De huidige lokale datum en tijd gemeld door het apparaat. OPMERKING: Apparaattijden kunnen onnauwkeurig zijn als de lokale tijd niet correct is.
UTCTODAY() Huidige UTC (GMT) datum	De huidige Greenwich Mean Time (GMT) datum gemeld door het apparaat.
UTCNOW() Huidige UTC (GMT) datum & tijd	De huidige Greenwich Mean Time (GMT) datum en tijd gemeld door het apparaat.
TASK-FIRSTAVAILABLE()	Geeft de ‘eerst beschikbare’ automatische gebruikerstoewijzingsidentificatie terug. Handig voor het aanmaken van nieuwe taken die willekeurig aan de eerst beschikbare gebruiker worden toegewezen. Ook handig om te gebruiken als de ‘Formulier verzenden naar’-waarde van een processtapveld. De optionele parameter stelt je in staat de taaktoewijzing te beperken tot alleen gebruikers in de opgegeven gebruikersgroepnaam of externe ID. Gebruiksvoorbeelden: `TASK-FIRSTAVAILABLE()` wijst willekeurig toe aan de eerst beschikbare gebruiker. `TASK-FIRSTAVAILABLE('mygroup')` wijst willekeurig toe aan de eerst beschikbare gebruiker in de gebruikersgroep met de naam ‘mygroup’ `TASK-FIRSTAVAILABLE({{myfield}})` wijst willekeurig toe aan de eerst beschikbare gebruiker in de gebruikersgroepnaam/ID die overeenkomt met het antwoord van het veld met de naam ‘myfield’.
TASK-FIRSTTOCLAIM()	Geeft de ‘eerst te claimen’ gebruikerstoewijzingsidentificatie terug. Handig voor het aanmaken van nieuwe taken die door de eerste gebruiker moeten worden uitgevoerd die ze claimen. Ook handig om te gebruiken als de ‘Formulier verzenden naar’-waarde van een processtapveld. De optionele parameter stelt je in staat de taakzichtbaarheid te beperken tot alleen gebruikers in de opgegeven gebruikersgroepnaam of externe ID. Gebruiksvoorbeelden: `TASK-FIRSTTOCLAIM()` Taak is zichtbaar voor alle gebruikers `TASK-FIRSTTOCLAIM('mygroup')` is zichtbaar voor gebruikers in de gebruikersgroep met de naam ‘mygroup’ `TASK-FIRSTTOCLAIM({{myfield}})` is zichtbaar voor gebruikers in gebruikersgroepnaam/ID die overeenkomt met de antwoordwaarde van het veld met de naam ‘myfield’.

WISKUNDE

+ (Resultaat = 5) OPMERKING: Zet altijd een spatie aan beide zijden van de ‘`DIV`‘
MOD Modulo	Modulo-operator. `{{value}} = 10` Dynamische waarde: `{{value}} MOD 3` (Resultaat = 1) MOD is als deling maar geeft alleen de rest terug. OPMERKING: Zet altijd een spatie aan beide zijden van de ‘`MOD`‘
RANDOM(length) Willekeurig getal	Genereert een willekeurig getal of string. Kan met 0 of 1 parameter worden aangeroepen. RANDOM() geeft een decimaal getal tussen 0 en 1,0. RANDOM(length) geeft een willekeurig geheel getal met de gegeven lengte.
ROUND(val, places) Afronden	Rondt het gegeven getal af tot het opgegeven aantal decimalen.
POW(val, power) Macht	Trunceert de gegeven getalwaarde naar een geheel getal. Rondt het getal effectief af naar nul decimalen.
TRUNC(val) Trunceren	Trunceert de gegeven getalwaarde naar een geheel getal. Rondt het getal effectief af naar nul decimalen.
MAX(val1, val2) Maximum	Geeft het grootste van twee getallen terug.
MIN(val1, val2) Minimum	Geeft het kleinste van twee getallen terug.
CEILING(val) Plafond	Geeft de kleinste geheeltallige waarde die groter dan of gelijk aan het opgegeven getal is.
FLOOR(val) Vloer	Geeft het grootste geheel getal terug dat kleiner dan of gelijk aan het opgegeven getal is
ABS(val) Absoluut	Geeft de absolute (positieve) waarde van een getal terug. `ABS(-5)` geeft 5 terug `ABS(-5.6)` geeft 5.6 terug

TEKST

STRING-LENGTH(val) Lengte	Geeft het aantal karakters in de gegeven waarde terug.
SUBSTR(val, startIndex, lengthOptional) Substring	Haalt een substring uit de gegeven waarde. Substrings beginnen op de nul-geïndexeerde startpositie en lopen tot het einde van de val, tenzij een optionele tekenlenge is opgegeven. bijv. als mijnveld de waarde ‘ABCDEF’ heeft, dan: `SUBSTR({{mijnveld}}, 2)` geeft CDEF `SUBSTR({{mijnveld}}, 2, 1)` geeft C
CONCAT(val1, val2, val3) Samenvoegen	Voegt de gegeven waarden achter elkaar samen.
JOIN(‘seperator’ , {{dataname}})	Voegt de gegeven waarden achter elkaar samen, gescheiden door de gegeven scheidingsteken. Voorbeelden JOIN(‘-‘ , {{veld1}}, {{veld2}}, {{veld3}}, enz) JOIN(‘\|’, {{herhaaldveld}})
SUBSTITUTE(val, old_text, new_text) Vervangen	Vervangt new_text voor old_text in de gegeven waarde. bijv. als mijnveld de waarde ‘ABC\|DEF’ heeft, dan: `SUBSTITUTE({{mijnveld}}, '\|', '\n')` vervangt \| door een nieuwe regel
LOWER(val) Kleine letters	Converteert alle karakters in de opgegeven waarde naar kleine letters. bijv. `LOWER({{mijnveld}})`
UPPER(val) Hoofdletters	Converteert alle karakters in de opgegeven val naar hoofdletters. bijv. `UPPER({{mijnveld}})`
STARTSWITH(val, startswith) Begint met	Splitst tekstinvoer in een lijst met waarden op basis van het opgegeven scheidingsteken. Deze resulterende lijst kan worden gebruikt binnen statistische functies zoals SUM() of COUNT(). Als een optionele op nul gebaseerde index is opgegeven, geeft deze de enkele waarde op de gegeven index of LEEG terug als de index niet in de lijst staat. Als een optionele op nul gebaseerde index is opgegeven, geeft deze de enkele waarde op de gegeven index of LEEG terug als de index niet in de lijst staat. bijv. `SPLIT({{nfcveld}}, ',', 2)` geeft het 3e element in de kommagescheiden lijst terug. bijv. `SPLIT('AAA\|BBB\|CCC', '\|', 0)` is AAA. bijv. `SPLIT('AAA,BBB,CCC', ',')` is een lijst met AAA, BBB en CCC als elementen. bijv. `MAX(SPLIT('1-2-5-4-3', '-'))` is 5. bijv. `SPLIT('AAA,BBB,CCC', ',' , 99)` is LEEG omdat er niet 100 elementen in de invoerlijst zijn.
CONTAINS(val, contains) Bevat tekst	Geeft waar of onwaar terug, afhankelijk van of de gegeven tekst ergens in de gegeven tekstwaarde voorkomt. Matching is niet hoofdlettergevoelig. bijv. als mijnveld de waarde ‘ABCDEF’ heeft, dan: `CONTAINS({{mijnveld}}, 'CDE')` resultaat is waar
INDEXOF(input, value, optionalStartIndex, optionalCount) Index/Positie van tekst	Haalt de op nul gebaseerde positie voor de eerste voorvallen van de gegeven waarde in de invoertekst. Geeft -1 terug als de zoekwaarde niet wordt gevonden. De optionele startindex zal de zoekopdracht op de gegeven op nul gebaseerde index beginnen. Optionele count specificeert hoeveel karakters er in de zoekopdracht worden opgenomen vanaf de startindex. bijv. `INDEXOF('AAA\|BBB\|CCC', 'A')` geeft 0 terug bijv. `INDEXOF('AAA\|BBB\|CCC', 'BD')` is -1 bijv. `INDEXOF('AAA\|BBB\|CCC', 'B', 5)` is 5 bijv. `INDEXOF('AAA\|BBB\|CCC', '\|', 4, 3)` is 7
SPLIT(input, delimiter, optionalIndex) String splitsen	Splitst tekstinvoer in een lijst met waarden op basis van het opgegeven scheidingsteken. Deze resulterende lijst kan worden gebruikt binnen statistische functies zoals SUM() of COUNT(). Als een optionele op nul gebaseerde index is opgegeven, geeft deze de enkele waarde op de gegeven index of LEEG terug als de index niet in de lijst staat. Als een optionele op nul gebaseerde index is opgegeven, geeft deze de enkele waarde op de gegeven index of LEEG terug als de index niet in de lijst staat. bijv. `SPLIT({{nfcveld}}, ',', 2)` geeft het 3e element in de kommagescheiden lijst terug. bijv. `SPLIT('AAA\|BBB\|CCC', '\|', 0)` is AAA. bijv. `SPLIT('AAA,BBB,CCC', ',')` is een lijst met AAA, BBB en CCC als elementen. bijv. `MAX(SPLIT('1-2-5-4-3', '-'))` is 5. bijv. `SPLIT('AAA,BBB,CCC', ',' , 99)` is LEEG omdat er niet 100 elementen in de invoerlijst zijn.
RANDOMSTR(length) Willekeurige string	Genereert een willekeurige reeks karakters van de gegeven lengte.
GUID() GUID	Genereert een nieuwe Globally Unique Identifier https://en.wikipedia.org/wiki/Globally_unique_identifier
“\n” Karakter nieuwe regel	Hoewel dit niet echt een function() is, kun je het teken “\n” in elke string of tekstgedeelte gebruiken om ons platform te vertellen dat het tekst op een nieuwe regel moet weergeven. Bijv. als mijnveld de waarde ‘ABC\|DEF’ heeft, dan: `SUBSTITUTE({{mijnveld}}, '\|', '\n')` vervangt \| door een nieuwe regel. Bij het opslaan van deze tekst in een gegevensbron, zorg ervoor dat het gegevenstype van de kolom is ingesteld op “Meerregelig tekst”.

DATUM/TIJD

DATEADD(startdate, numberunits, unit) Toevoegen aan datum	Geeft een nieuwe datum/tijd terug die het opgegeven aantal eenheden toevoegt aan de opgegeven startdatumwaarde. bijv. `DATEADD({{mijnveld}}, 6, 'MM')` Eenheid specifiers zijn: YY – hele jaren MM – hele maanden DD – hele dagen HH – hele uren MI – hele minuten SS – hele seconden
DATEDIFF(startdate, enddate, unit) Verschil tussen data	Berekent het totale aantal minuten, uren, dagen, maanden of jaren tussen twee data/tijden. bijv. `DATEDIFF({{mijnveld}}, now(), 'HH')` Eenheid specifiers zijn: YY – hele jaren MM – hele maanden DD – hele dagen HH – hele uren MI – hele minuten SS – hele seconden Als je weekenddagen wilt uitsluiten van de berekening, geef je de optionele waar/onwaar parameter op als volgt om weekends uit te sluiten: bijv. `DATEDIFF('2017-04-19', '2017-04-27', 'DD', true())` Waarbij de bovenstaande functie 6 dagenion van de opgegeven datumwaarde. b.v. `MONTH({{mydatefield}})`
DAY(dateval) Dag	Retourneert het daggedeelte van de opgegeven datumwaarde. b.v. `DAY({{mydatefield}})`
HOUR(dateval) Uur	Retourneert het uurgedeelte van de opgegeven datumwaarde. b.v. `HOUR({{mydatefield}})`
MINUTE(dateval) Minuut	Retourneert het minuutgedeelte van de opgegeven datumwaarde. b.v. `MINUTE({{mydatefield}})`
SECOND(dateval) Seconde	Retourneert het secondegedeelte van de opgegeven datumwaarde. b.v. `SECOND({{mydatefield}})`
DAYWEEK(dateval) Dag van de Week	Retourneert het nummering van de weekdag voor de opgegeven datumwaarde. Waarden variëren van 0 tot en met 6 voor zondag tot en met zaterdag. `DAYWEEK({{mydatefield}})`
DAYYEAR(dateval) Dag van het Jaar	Retourneert het nummering van de dag van het jaar voor de opgegeven datumwaarde. Geretourneerde waarden liggen tussen 1 en 366. b.v. `DAYYEAR({{mydatefield}})`
WEEKYEAR(dateval) Week van het Jaar	Retourneert het nummering van de week van het jaar voor de opgegeven datumwaarde. Geretourneerde waarden liggen tussen 1 en 52. b.v. `WEEKYEAR({{mydatefield}})`
IMGDATE(imagefield) Aanmaakdatum/-tijd van Afbeelding	Retourneert de originele aanmaakdatum en -tijd van het bestand in het gegeven afbeeldingsveld, zoals te vinden in de EXIF-metagegevens van het bestand. Als deze metagegevens niet beschikbaar zijn, worden de datum en tijd van vastlegging geretourneerd naar het afbeeldingsveld. De geretourneerde datum/tijd bevinden zich in de lokale tijdzone van het apparaat.

LOGICA

= Gelijk aan	Retourneert waar als beide operanden gelijk zijn.
< Kleiner dan	Retourneert waar als de eerste operand kleiner is dan de tweede.
> Groter dan	Retourneert waar als de eerste operand groter is dan de tweede.
OR	Retourneert waar als een van de operanden waar is.
AND	Retourneert waar als beide operanden waar zijn.
NOT(val)	Retourneert waar als de gegeven waarde onwaar is en onwaar als de gegeven waarde waar is.
TRUE()	Retourneert waar.
FALSE()	Retourneert onwaar.
IF(condition, trueval, falseval) Voorwaardelijk (if/else)	Laat je een van twee waarden retourneren op basis van of de gegeven voorwaarde waar of onwaar is. Nuttig voor het schakelen van de dynamische waarde van een veld op basis van eerdere antwoorden. b.v. `IF({{score}} > 50, 'JE SLAAGT', 'JE FAALT')`
ISBLANK(val) Is Leeg	Retourneert waar/onwaar op basis van of de gegeven waarde leeg is. Een eenvoudige manier om te controleren of een veld geen antwoord heeft
NOTBLANK(val) NIET Leeg	Retourneert waar/onwaar op basis van of de gegeven waarde niet leeg is. Een eenvoudige manier om te controleren of een veld antwoorden heeft.
COALESCE(val1, val2) Eerste Niet-lege Waarde (coalesce)	Gebruik deze functie wanneer je een niet-lege waarde gegarandeerd wilt retourneren. Dit is nuttig wanneer je scoringsberekeningen uitvoert – verpak elk antwoord in een `COALESCE({{answer}}, 0)` om ervoor te zorgen dat je nul krijgt als de gebruiker geen antwoord heeft gegeven.
REGEX(input, pattern) Reguliere Expressie Match	Retourneert waar/onwaar op basis van of de reguliere expressie een overeenkomst in de invoerstring vindt. Reguliere expressies zijn een krachtig en geavanceerd onderdeel. Lees meer over reguliere expressies. .NET Reguliere Expressies – .NET \| Microsoft Learn Taal voor Reguliere Expressies – Snelletje – .NET \| Microsoft Learn Opties voor reguliere expressie – .NET \| Microsoft Learn
REPLACE(input, pattern, replacement) Vervanging Reguliere Expressie	Vervangt de tekst die overeenkomt met de gegeven reguliere expressie door de tekst die is opgegeven in de vervangingsstring. Houd er rekening mee dat het patroon van de reguliere expressie statische tekst kan zijn of van een ander veld kan worden doorgegeven. b.v. `REPLACE({{input}}, 'ab*c', '_')` b.v. `REPLACE({{input}}, {{regex}}, '_')` Voorbeelden Reguliere Expressies (Regex)

GEGEVENSCONVERSIE

FORMAT-DATE(val, format) Datum/Tijd Formatteren naar Tekst	Converteer een datum/tijd naar een geformatteerde tekenreekswaarde. Functie `FORMAT-DATE(now(), 'MM/dd/yy H:mm:ss')` Uitvoer 06/10/11 15:24:16 Typische formaatspecificaties: yy – 2-cijferig jaar yyyy – 4-cijferig jaar MM – 2-cijferige maand MMM – 3-karakterige verkorte maand dd – 2-cijferige dag HH – uur in 24-uurs klok mm – 2-cijferige minuut (00-59) ss – 2-cijferige seconde (00-59)
FORMAT-NUM(val, format, optionalCulture) Getal Formatteren naar Tekst	Converteer een getal naar een geformatteerde tekenreekswaarde. Standaard wordt US-opmaak toegepast; de optionele cultureparameter laat je de doelcultuur voor opmaak opgeven. b.v. `FORMAT-NUM({{numfield}}, '00.00')` voert 4.9675 uit als: 04.97 b.v. `FORMAT-NUM({{numfield}}, '00.00', 'fr-FR')` voert 4.9675 uit als: 04,97 Typische formaatspecificaties zijn: 0 – Vervangt door cijfer of nul als geen # – Vervangt door cijfer of niets als geen . – Stelt de positie van het decimaalteken in , – Stelt de groeperingsoperatorpositie in Lees meer over formaatspecificaties
FORMAT-GEO(val, format) Locatie Formatteren naar Tekst	Converteer een geolocatie naar een geformatteerde tekenreekswaarde. Opmaakopties: ‘DMS’ – Graden, minuten en seconden, b.v. 41°24’12’N 2°10’26.5’E ‘DDS’ – Decimale graden, door spaties gescheiden. B.v. 41.40338 2.17403 ‘DDC‘ – Decimale graden, door komma’s gescheiden. B.v. 41.40338,2.17403 ‘DIR’ – Richtingsgraden, b.v. 0°N Voorbeelden `FORMAT-GEO({{mygpsfield}}, 'DDS')` `FORMAT-GEO('41.40338 2.17403', 'DMS')`
DATE(val, ‘optionalFormat’) Naar Datum	Converteer de gegeven waarde naar een datumwaarde, optment=”2303″/>Naar Boolean	Converteert de gegeven waarde naar een Boolean waarde.
CBOX(val, matchTo) Naar CheckBox (Aangevinkt of Doorgehaald)	Retourneert een Unicode-selectievakje dat is aangevinkt of doorgehaald, afhankelijk van of val gelijk is aan matchTo. bijv. `CBOX({{myfield}}, 'Yes')` levert ☑ of ☒ op
CBOXB(val, matchTo) Naar CheckBox (Aangevinkt of Leeg)	Retourneert een Unicode-selectievakje dat is aangevinkt of leeg, afhankelijk van of val gelijk is aan matchTo. bijv. `CBOXB({{myfield}}, 'Yes')` levert ☑ of ☐ op
FILEURL(fieldname) Naar Bestands-URL	Genereert de web-URL naar het gegeven bestandsveld (bijv. Media- of Bijlageveldtypen). Handig bij toewijzing aan een Data Source afbeeldingskolom of voor het verstrekken van directe downloadlinks in Connector-uitvoer.

GEGEVENSBRONNEN

DSCOUNT(dsId, ‘optionalFilterFormula’) Rijen Tellen	Telt rijen in de gegeven Data Source, optioneel gefilterd op formule. Verwijs naar de Data Source via de External Id (van de Data Source -> Settings pagina). bijv. `DSCOUNT('STAFF')` Voeg een filterformule toe met {{this[column]}} om naar kolommen te verwijzen. bijv. `DSCOUNT('STAFF', '{{this[2]}} = "BOB"')` telt rijen waarbij 3e kolom = BOB Je kunt deze functie ook gebruiken op een dynamische formulegegevensbron die op je formulier is geïnstantieerd in een gegevensveld. In tegenstelling tot standaard gegevensbronnen die een externe ID gebruiken, moet een dynamische formulegegevensbron worden gebruikt met de `{{dataname}}` notatie. bijv. `DSCOUNT({{ds_dataname}}, '{{this[2]}} = "BOB"')`
DSSUM(dsId, columnIndex, ‘optionalFilterFormula’) Waarden in Kolom Optellen	Telt kolomwaarden in de gegeven Data Source op, optioneel gefilterd op formule. Verwijs naar de Data Source via de External Id (van de Data Source -> Settings pagina). Verwijs naar de kolom via de nulgebaseerde index. bijv. `DSSUM('STAFF', 2)` telt de waarden van de 3e kolom op Voeg een filterformule toe met {{this[column]}} om naar kolommen te verwijzen. bijv. `DSSUM('STAFF', 2, '{{this[5]}} = "BOB"')` telt 3e kolom op waarbij 6e kolom = BOB Je kunt deze functie ook gebruiken op een dynamische formulegegevensbron die op je formulier is geïnstantieerd in een gegevensveld. In tegenstelling tot standaard gegevensbronnen die een externe ID gebruiken, moet een dynamische formulegegevensbron worden gebruikt met de `{{dataname}}` notatie. bijv. `DSSUM({{ds_dataname}}, 2, '{{this[5]}} = "BOB"')`
DSAVG(dsId, columnIndex, ‘optionalFilterFormula’) Gemiddelde Waarde in Kolom	Gemiddelde van kolomwaarden in de gegeven Data Source, optioneel gefilterd op formule. Verwijs naar de Data Source via de External Id (van de Data Source -> Settings pagina). Verwijs naar de kolom via de nulgebaseerde index. bijv. `DSVAG('STAFF', 2)` gemiddelde van de 3e kolom waarden Voeg een filterformule toe met {{this[column]}} om naar kolommen te verwijzen. bijv. `DSVAG('STAFF', 2, '{{this[5]}} = "BOB"')` gemiddelde van 3e kolom waarbij 6e kolom = BOB Je kunt deze functie ook gebruiken op een dynamische formulegegevensbron die op je formulier is geïnstantieerd in een gegevensveld. In tegenstelling tot standaard gegevensbronnen die een externe ID gebruiken, moet een dynamische formulegegevensbron worden gebruikt met de `{{dataname}}` notatie. bijv. `DSAVG({{ds_dataname}}, 2, '{{this[5]}} = "BOB"')`
DSMAX(dsId, columnIndex, ‘optionalFilterFormula’) Maximale Waarde in Kolom	Haalt de maximale kolomwaarde op in de gegeven Data Source, optioneel gefilterd op formule. Verwijs naar de Data Source via de External Id (van de Data Source -> Settings pagina). Verwijs naar de kolom via de nulgebaseerde index. bijv. `DSMAX('STAFF', 2)` haalt de maximale waarde van de 3e kolom op Voeg een filterformule toe met {{this[column]}} om naar kolommen te verwijzen. bijv. `DSMAX('STAFF', 2, '{{this[5]}} = "BOB"')` maximum van 3e kolom waarbij 6e kolom = BOB Je kunt deze functie ook gebruiken op een dynamische formulegegevensbron die op je formulier is geïnstantieerd in een gegevensveld. In tegenstelling tot standaard gegevensbronnen die een externe ID gebruiken, moet een dynamische formulegegevensbron worden gebruikt met de `{{dataname}}` notatie. bijv. `DSMAX({{ds_dataname}}, 2, '{{this[5]}} = "BOB"')`
DSMIN(dsId, columnIndex, ‘optionalFilterFormula’) Minimale Waarde in Kolom	Haalt de minimale kolomwaarde op in de gegeven Data Source, optioneel gefilterd op formule. Verwijs naar de Data Source via de External Id (van de Data Source -> Settings pagina). Verwijs naar de kolom via de nulgebaseerde index. bijv. `DSMIN('STAFF', 2)` haalt de maximale waarde van de 3e kolom op Voeg een filterformule toe met {{this[column]}} om naar kolommen te verwijzen. bijv. `DSMIN('STAFF', 2, '{{this[5]}} = "BOB"')` minimum van 3e kolom waarbij 6e kolom = BOB Je kunt deze functie ook gebruiken op een dynamische formulegegevensbron die op je formulier is geïnstantieerd in een gegevensveld. In tegenstelling tot standaard gegevensbronnen die een externe ID gebruiken, moet een dynamische formulegegevensbron worden gebruikt met de `{{dataname}}` notatie. bijv. `DSMIN({{ds_dataname}}, 2, '{{this[5]}} = "BOB"')`
DSFIRST(dsId, columnIndex, ‘optionalFilterFormula’) Eerste Waarde in Kolom	Haalt de eerste kolomwaarde op in de gegeven Data Source, optioneel gefilterd op formule. Verwijs naar de Data Source via de External Id (van de Data Source -> Settings pagina). Verwijs naar de kolom via de nulgebaseerde index. bijv. `DSFIRST('STAFF', 2)` haalt de eerste waarde van de 3e kolom op Voeg een filterformule toe met {{this[column]}} om naar kolommen te verwijzen. bijv. `DSFIRST('STAFF', 2, '{{this[5]}} = "BOB"')` dit retourneert de waarde van de 3e kolom van de eerste rij waarbij 6e kolom = BOB Je kunt deze functie ook gebruiken op een dynamische formulegegevensbron die op je formulier is geïnstantieerd in een gegevensveld. In tegenstelling tot standaard gegevensbronnen die een externe ID gebruiken, moet een dynamische formulegegevensbron worden gebruikt met de `{{dataname}}` notatie. bijv. `DSFIRST({{ds_dataname}}, 2, '{{this[5]}} = "BOB"')`
DSLAST(dsId, columnIndex, ‘optionalFilterFormula’) Laatste Waarde in Kolom	Haalt de laatste kolomwaarde op in de gegeven Data Source, optioneel gefilterd op formule. Verwijs naar de Data Source via de External Id (van de Data Source -> Settings pagina). Verwijs naar de kolom via de nulgebaseerde index. bijv. `DSLAST('STAFF', 2)` haalt de laatste waarde van de 3e kolom op Voeg een filterformule toe met {{this[column]}} om naar kolommen te verwijzen. bijv. `DSLAST('STAFF', 2, '{{this[5]}} = "BOB"')` dit retourneert de waarde van de 3e kolom van de laatste rij waarbij 6e kolom = BOB Je kunt deze functie ook gebruiken op een dynamische formulegegevensbron die op je formulier is geïnstantieerd in een gegevensveld. In tegenstelling tot standaard gegevensbronnen die een externe ID gebruiken, moet een dynamische formulegegevensbron worden gebruikt met de `{{dataname}}` notatie. bijv. `DSLAST({{ds_dataname}}, 2, '{{this[5]}} = "BOB"')`

LIJSTEN/SETS VAN WAARDEN

LIST(pattern, ‘optionalFilterFormula’) Lijst met Waarden	Verzamelt antwoorden uit velden met gegevensnamen die overeenkomen met het gegeven reguliere expressieparoon. Lijstresultaten worden meestal gebruikt met functies zoals SUM()/COUNT() om resultaten te berekenen op velden die een gemeenschappelijke naamgeving volgen – bijv. enquêtevelden zoals q1, q2, q3, enz. De tweede optionele parameter past een filterformule toe op de verzamelde antwoorden, waarbij alleen die worden behouden die aan de voorwaarde voldoen. Gebruik {{this}} om naar de antwoordwaarde in de formule te verwijzen. bijv. `SUM(LIST('q[0-9]+'))` telt antwoorden voor velden die heten q1, q2, enz. op bijv. `COUNT(LIST('q[0-9]+', '{{this}} = 5'))` telt q1, q2 enz. velden waar antwoorden gelijk zijn aan 5
TOLIST(value, ‘optionaldelimiter’, ‘optionalFilterFormula’) Converteren naar Lijst	Converteert de gegeven waarde naar een Lijst. De waarde moet een tekstreeks zijn met gescheiden lijstelementen – bijv. 34\|76\|9. De tweede optionele parameter is het scheidingsteken tussen elementen. Het standaardt
IN(value, list) In List of Values	Retourneert true als de gegeven waarde in de gegeven List wordt gevonden. bijv. `IN('ABC', LIST('q[0-9]+'))` bijv. `IN('ABC', PRIOR('repeatfield'))`
NOTIN(value, list) NOT In List of Values	Retourneert true als de gegeven waarde NIET in de gegeven List wordt gevonden. bijv. `NOTIN('ABC', TOLIST({{listfield}}))` bijv. `NOTIN('ABC', PRIOR('repeatfield'))`
COUNT(list) Count List Values	Telt de waarden in de gegeven List. De parameter moet een geldige List-functie zijn, zoals LIST() of PRIOR() bijv. `COUNT(LIST('q[0-9]+'))`
SUM(list) Sum List Values	Telt de waarden in de gegeven numerieke List op. De parameter moet een geldige List-functie zijn zoals LIST() of PRIOR() bijv. `SUM(LIST('q[0-9]+'))` bijv. `SUM(TOLIST('1\|2\|3\|4\|5'))` bijv. `SUM(TOLIST({{listfield}}))`
AVERAGE(list) Average List Value	Berekent het gemiddelde van de waarden in de gegeven numerieke List. De parameter moet een geldige List-functie zijn, zoals LIST() of PRIOR() bijv. `AVERAGE(LIST('q[0-9]+'))`
MEDIAN(list)	Haalt de mediaanwaarde uit de gegeven numerieke List. De parameter moet een geldige List-functie zijn zoals LIST() of PRIOR() bijv. `MEDIAN(LIST('q[0-9]+'))` bijv. `MEDIAN(TOLIST('1\|2\|3\|4\|5'))` bijv. `MEDIAN(TOLIST({{listfield}}))`
MIN(list) Minimum List Value	Haalt de minimumwaarde uit de gegeven numerieke List. De parameter moet een geldige List-functie zijn zoals LIST() of PRIOR() bijv. `MIN(LIST('q[0-9]+'))`
MAX(list) Maximum List Value	Haalt de maximumwaarde uit de gegeven numerieke List. De parameter moet een geldige List-functie zijn zoals LIST() of PRIOR() bijv. `MAX(LIST('q[0-9]+'))`
FIRST(list) First List Value	Haalt de eerste waarde uit de gegeven List. De parameter moet een geldige List-functie zijn zoals LIST() of PRIOR() bijv. `FIRST(LIST('q[0-9]+'))`
LAST(list) Last List Value	Haalt de laatste waarde uit de gegeven List. De parameter moet een geldige List-functie zijn zoals LIST() of PRIOR() bijv. `LAST(LIST('q[0-9]+'))`

HERHALINGEN/TABELLEN

POSITION({{repeat}}) Repeat/Row Position	Het pagina-/rijnummer van de huidige herhalingspagina of tabelrij. Handig voor het genereren van incrementele nummers voor secties/clausules (bijv. 1.1, 1.2, 1.3) Parameter is de gegevensnaam van de herhaalbare pagina of tabel. bijv. `POSITION({{repeatpage}})`
PRIOR(‘dataname’, occurrences) Prior Repeat Value(s)	Haalt de vorige herhaling-/rijwaarde(n) van het genoemde veld binnen een Pagina/Tabel op, beginnend vanuit de huidige herhalingscontext. Mag alleen worden gebruikt binnen een herhaalbare Pagina of Tabel. De optionele tweede parameter geeft aan hoeveel vorige antwoorden moeten worden opgehaald. Vorige herhalingswaarden worden geretourneerd als een List tenzij de tweede parameter 1 is; in dat geval wordt de waarde van het laatste vorige antwoord geretourneerd. Handig voor het uitvoeren van statistische functies op herhalingswaarden tot nu toe (bijv. SUM, COUNT) en, als de tweede parameter 1 is, voor het overbrengen van de vorige herhaling-/rijwaarde naar de huidige nieuwe instantie. bijv. `PRIOR('myfield')` List van alle vorige antwoorden bijv. `PRIOR('myfield', 1)` alleen de laatst vorige waarde
COUNT({{repeat}}) Count Repeats/Rows	Telt de herhalingen/rijen van een Pagina/Tabel. Handig voor het tellen van vastgestelde rijen/herhalingen – bijv. een orderregelaantal bijv. `COUNT({{repeatPage}})`
SUM({{numfield}}) Sum Repeats/Rows	Telt een Getal-veld op over alle herhalingen/rijen van een Pagina/Tabel. Handig voor het totaliseren van vastgestelde waarden – bijv. een ordertotaal bijv. `SUM({{numberfield}})`
AVERAGE({{numfield}}) Average Repeat/Rows	Berekent het gemiddelde van een Getal-veld over alle herhalingen/rijen van een Pagina/Tabel. Handig voor het samenvoegen van vastgestelde waarden – bijv. een gemiddelde hoeveelheid bijv. `AVERAGE({{numberfield}})`
MEDIAN({{numfield}}) Median Repeat Value	Mediaanwaarde van een Getal-veld over alle herhalingen/rijen van een Pagina/Tabel. bijv. `MEDIAN({{mynumberfield}})`
MAX({{numfield}}) Maximum Repeat Value	Maximumwaarde van een Getal-veld over alle herhalingen/rijen van een Pagina/Tabel. bijv. `MAX({{mynumberfield}})`
MIN({{numfield}}) Minimum Repeat Value	Minimumwaarde van een Getal-veld over alle herhalingen/rijen van een Pagina/Tabel. bijv. `MIN({{mynumberfield}})`
FIRST({{repeatfield}}) First Repeat Value	Waarde van het eerste voorkomen/rij van een herhaalbaar Pagina- of Tabelveld. bijv. `FIRST({{myrepeatfield}})`
LAST({{repeatfield}}) Last Repeat Value	Waarde van het laatste voorkomen/rij van een herhaalbaar Pagina- of Tabelveld. bijv. `LAST({{myrepeatfield}})`

KEUZES

SELECTED({{choicesfield}}, ‘val’) Choice Is Selected	Retourneert true als de gegeven waarde is geselecteerd in het gegeven keuzeveld, anders false.
COUNT-SELECTED({{choicesfield}}) Count Selected Choices	Retourneert het aantal geselecteerde keuzes in het gegeven keuzeveld.

GEGEVENSUITWISSELING

HTTPSTATUS({{restField}})

Retourneert de HTTP-statuscode die is ontvangen toen het gegeven REST-veld voor het laatst een REST-verzoek uitvoerde.

bijv., Als het REST-veld met de naam ‘myRestField’ een verzoek succesvol uitvoert, dan zou HTTPSTATUS({{myRestField}}) een waarde van ‘200’ moeten retourneren.

Meer informatie over HTTP-statuscodes

JSONVAL({{myjson}}, ‘resp.token’)
Value From JSON

Retourneert de waarde uit de gegeven JSON voor de gegeven JSONPath-query.
Gebruik de optionele waar/onwaar-validatieparameter om een fout op te werpen als de query mislukt.

Opmerking: Het JSONPath ‘$.’ voorvoegsel is niet vereist.

bijv. JSONVAL({{myjson}}, ‘resp.token’)

Meer informatie over JSONPath
Test je JSONPath hier

JSONLIST({{myjson}}, ‘resp.products.id’)
List of Values From JSON Retourneert een List van waarden uit de gegeven JSON voor de gegeven JSONPath-query.
Gebruik de optionele waar/onwaar-validatieparameter om een fout op te werpen als de query mislukt.

Opmerking: Het JSONPath ‘$.’ voorvoegsel is niet vereist.

bijv. JSONLIST({{myjson}}, ‘resp.product.id’)

Meer informatie over JSONPath
Test je JSONPath hier

XMLVAL({{myxmlfield}}, ‘resp/token’)
Value From XML

Retourneert de waarde uit de gegeven XML voor de gegeven XPath-query.
Gebruik de optionele waar/onwaar-validatieparameter om een fout op te werpen als de query mislukt.

Opmerking: Het openings-XPath ‘/’ is

LOCATIE

LAT(locationval) Breedtegraad	Geeft de breedtegraad in decimale graden van de gegeven locatiewaarde.
LON(locationval) Lengtegraad	Geeft de lengtegraad in decimale graden van de gegeven locatiewaarde.
HEADING(locationval) Koersrichting	Geeft de koersrichting ten opzichte van het ware noorden in decimale graden van de gegeven locatiewaarde.
ALTITUDE(locationval) Hoogte	Geeft de hoogte boven/onder zeeniveau in meters van de gegeven locatiewaarde.
ACCURACY(locationval) Nauwkeurigheid	Geeft de nauwkeurigheid in meters van de gegeven locatiewaarde.
STREETNUM(locationval) Straatnummer	Geeft het straatnummer voor de gegeven locatiewaarde. Komt overeen met ‘sub_thoroughfare’ in OASIS-specificatie.
STREET(locationval) Straatnaam	Geeft de straatnaam voor de gegeven locatiewaarde. Komt overeen met ’thoroughfare’ in OASIS-specificatie.
CITY(locationval) Plaats / Woonplaats	Geeft de plaatsnaam/woonplaatsnaam voor de gegeven locatiewaarde. Komt overeen met ‘locality’ in OASIS-specificatie.
COUNTY(locationval) Graafschap / District	Geeft het graafschap/district voor de gegeven locatiewaarde. Komt overeen met ‘admin_area’ in OASIS-specificatie.
STATE(locationval) Staat / Provincie	Geeft de staat/provincie voor de gegeven locatiewaarde. Komt overeen met ‘admin_area’ in OASIS-specificatie.
POSTCODE(locationval) Postcode / Zipcode	Geeft de postcode/zipcode van de gegeven locatiewaarde. Komt overeen met ‘postal_code’ in OASIS-specificatie.
COUNTRY(locationval) Landcode	Geeft de ISO-landcode van de gegeven locatiewaarde. Komt overeen met ‘country’ in OASIS-specificatie.
MIBETWEEN(startPoint, endPoint) Mijlen Tussen	Berekent de mijlen tussen twee geo-punten met behulp van great-circle-wiskunde. Geo-punten zijn strings in ‘lat lon’-formaat, antwoorden van locatievelden zijn ook geo-punten. bijv. `MIBETWEEN('-8.45234 27.7623423', {{myGpsField}})`
KMBETWEEN(startPoint, endPoint) Kilometers Tussen	Berekent de kilometers tussen twee geo-punten met behulp van great-circle-wiskunde. Geo-punten zijn strings in ‘lat lon’-formaat. Antwoorden van locatievelden zijn ook geo-punten. bijv. `KMBETWEEN('-8.45234 27.7623423', {{myGpsField}})`
INPOLYGON(point, polygonPoints) Is In Polygoon (geofence)	Geeft een waar/onwaar antwoord op de vraag of het gegeven geo-punt zich binnen de gegeven polygoon bevindt. Polygoonwaarden moeten een pipe-gescheiden string van geo-punten zijn. bijv. `INPOLYGON({{myGpsVal}}, '-8.6782523 27.2918257\|-8.6672229 28.7094422\|-7.6447228 29.3849982')`

PROCESSTAPPEN

STEP-CURRENT() Huidsige Stapnaam	Geeft de naam van de huidsige stap in het proces. Als nog geen stap heeft plaatsgevonden, retourneert deze functie een lege waarde.
STEP-ISCURRENT(‘dataname’) Is Huidsige Stap	Geeft waar terug als het benoemde processtapveld de huidsige stap in het proces is. Als nog geen stap heeft plaatsgevonden, retourneert deze functie waar voor ELKE processtapnaam.
STEP-COMPLETED() Laatst Voltooide Stap	Geeft de naam van de meest recent voltooide stap in het proces. Als nog geen stap is voltooid (bijvoorbeeld een nieuw formulierinvoer in uitvoering in de app), retourneert deze functie een lege waarde. Deze functie is ideaal voor gebruik in Connectors omdat deze altijd een waarde retourneert (omdat een stap wordt voltooid zodra het invoergegevens is geüpload).
STEP-RESULT(‘dataname’)	Geeft het resultaat van het benoemde processtapveld terug, indien ingesteld
STEP-EMAIL(‘dataname’) Stap Gebruikers-E-mailadres	Geeft het e-mailadres van de gebruiker die het resultaat (indien aanwezig) van het benoemde processtapveld heeft bepaald
STEP-FIRST(‘dataname’) Stap Gebruiker Voornaam	Geeft de voornaam van de gebruiker die het resultaat (indien aanwezig) van het benoemde processtapveld heeft bepaald
STEP-LAST(‘dataname’) Stap Gebruiker Achternaam	Geeft de achternaam van de gebruiker die het resultaat (indien aanwezig) van het benoemde processtapveld heeft bepaald

GEAVANCEERDE WISKUNDE

PI() Pi	Geeft het getal 3.14159265358979, de wiskundige constante Pi, nauwkeurig tot 15 cijfers.
DEGREES(angle) Graden	Zet radialen om in graden
RADIANS(angle) Radialen	Zet graden om in radialen
SQRT(val) Vierkantswortel	Geeft een getal terug dat, wanneer vermenigvuldigd met zichzelf, de gegeven waarde oplevert.
LOG(val, base) Logaritme (log)	Geeft de exponent terug waartoe het gegeven grondtal moet worden verheven om de gegeven waarde op te leveren.
SIN(val) Sinus	Geeft een getal terug dat, wanneer vermenigvuldigd met zichzelf, de gegeven waarde oplevert.
COS(val) Cosinus	Geeft de cosinus van de gegeven radiale hoekwaarde. Als jouw waarde in graden is, vermenigvuldig deze met PI()/180 of gebruik de RADIANS-functie om deze om te zetten naar radialen.
TAN(val) Tangens	Geeft de tangens van de gegeven radiale hoekwaarde. Als jouw waarde in graden is, vermenigvuldig deze met PI()/180 of gebruik de RADIANS-functie om deze om te zetten naar radialen.
ASIN(val)	Geeft de arcsinus, of inverse sinus, van een getal. De teruggegeven hoek wordt in radialen gegeven in het bereik -pi/2 tot pi/2.
ACOS(val) Arccosinus	Geeft de arccosinus, of inverse cosinus, van een getal. De teruggegeven hoek wordt in radialen gegeven, variërend van 0 (nul) tot π.
ATAN(val) Arctangens	Geeft de arctangens, of inverse tangens, van een getal. De teruggegeven hoek wordt in radialen gegeven in het bereik -π/2 tot π/2.
SINH(val) Hyperbolische Sinus	Geeft de hyperbolische sinus van de gegeven radiale hoekwaarde. Als jouw waarde in graden is, vermenigvuldig deze met PI()/180 of gebruik de RADIANS-functie om deze om te zetten naar radialen.
COSH(val) Hyperbolische Cosinus	Geeft de hyperbolische cosinus van de gegeven radiale hoekwaarde. Als jouw waarde in graden is, vermenigvuldig deze met PI()/180 of gebruik de RADIANS-functie om deze om te zetten naar radialen.
TANH(val) Hyperbolische Tangens	Geeft de hyperbolische tangens van de gegeven radiale hoekwaarde. Als jouw waarde in graden is, vermenigvuldig deze met PI()/180 of gebruik de RADIANS-functie om deze om te zetten naar radialen.

Antwoord niet gevonden?

Staat jouw vraag er niet bij? Neem dan direct contact met ons op.

Contact opnemen