Variabele velden toevoegen

Variabelen velden zijn zelf gekozen vraag ID's die kunnen opgehaald worden uit:

De boomstructuur of dataset in XperiDo geeft alle mogelijke velden weer. Je kan kiezen voor:

  • een zaak- of contactmomentformulier;
  • een taakformulier.

Variabele velden uit een zaak- of contactmomentformulier ophalen

  • Klik de mogelijke variabele vraag ID's open onder zaak- of contactmomentformulier
  • Voeg het noodzakelijke veld toe, de meest voorkomende zijn:
    • tekst = stringValue
    • weergave = displayValue
    • datum = dateValue
    • numeriek = integerValue
  • Klik op de tab mapping
  • Open de settings via het eerste icoontje of met een dubbele klik op de aan te passen mapping
  • Kies onder de tab general voor mapping type 'Expression'
  • Klik op het bewerken icoontje
  • De expressie wordt altijd op dezelfde manier opgebouwd en verwijst naar het zaakformulier, de variabele velden, het variabele veld dat je zelf definieert en het soort waarde dat je wenst op te halen. In onderstaande expressie dien je dus enkel nog de juiste vraag ID toe te voegen.

    ${/genericobject/form/formDataFlexes/formDataFlex[fieldDefinitionId='vraag_id']/stringValue}

    Indien het om een ander soort waarde gaat dient het laatste deeltje vervangen te worden. Dit kan eenvoudig door een veld te selecteren en het laatste gedeelte te kopiëren en plakken in bovenstaand script.

    • stringValue = tekst
    • integerValue = numeriek
    • dateValue = datum
    • displayValue = weergave

Datumveld ophalen

  • Klik de mogelijke variabele vraag ID's open onder zaak- of contactmomentformulier
  • Voeg het veld datum of dateValue toe
  • Klik op de tab mapping
  • Open de settings via het eerste icoontje of met een dubbele klik op de aan te passen mapping
  • Kies onder de tab general voor mapping type 'Expression'
  • Klik op het bewerken icoontje
  • Voeg de volgende expressie toe en vul de vraag ID aan
${/genericobject/form/formDataFlexes/formDataFlex[fieldDefinitionId='vraag_id']/dateValue}
  • Kies voor het tabje ‘Format’
  • Kies voor ‘Date’
  • Kies het gewenste formaat (vb. EEEE d MMMM yyyy) of definieer zelf het gewenste formaat.

Numeriek veld ophalen

  • Klik de mogelijke variabele vraag ID's open onder zaak- of contactmomentformulier
  • Voeg het veld numeriek of integer value toeof date value toe
  • Klik op de tab mapping
  • Open de settings via het eerste icoontje of met een dubbele klik op de aan te passen mapping
  • Kies onder de tab general voor mapping type 'Expression'
  • Klik op het bewerken icoontje
  • Voeg de volgende expressie toe en vul de vraag ID aan
${/genericobject/form/formDataFlexes/formDataFlex[fieldDefinitionId='vraag_id']/integerValue}

Meervoudige waardes ophalen

In checkboxes en multiselects kunnen er meerdere waardes opgeslagen worden in de database. Om alle waardes op te halen dient er dan ook hier gewerkt te worden met een loop.

  • Klik de mogelijke variabele vraag ID's open onder zaak- of contactmomentformulier
  • Selecteer in je dataset het item waarover je een loop wilt maken. Dit item moet wederkerig zijn.
  • Klik bovenaan op het icoontje 'Loop'
  • Kies voor ‘use an XPath Expression’
  • De expressie wordt altijd op dezelfde manier opgebouwd en verwijst naar het zaakformulier, de variabele velden en het variabele veld dat je zelf definieert. In onderstaande expressie dien je dus enkel nog de juiste vraag ID toe te voegen. Het laatste gedeelte van de expressie zorgt ervoor dat je alle waardes, behalve de laatste gaat ophalen.

    /genericobject/form/formDataFlexes/formDataFlex[fieldDefinitionId='vraag_ID'][position() < last()]
  • Plaats je cursor binnen de loop
  • Voeg het veld tekst of string value toe
  • Plaats je cursor achter de string value en voeg je scheidingsteken toe (bv. een komma, spatie of enter)
  • Selecteer in je dataset het item opnieuw waarover je de tweede loop wilt maken. Dit is hetzelfde veld als hierboven
  • Klik bovenaan op het icoontje 'Loop'
  • Kies voor ‘use an XPath Expression’
  • De expressie wordt altijd op dezelfde manier opgebouwd en verwijst naar het zaakformulier, de variabele velden en het variabele veld dat je zelf definieert. In onderstaande expressie dien je dus enkel nog de juiste vraag ID toe te voegen.

    /genericobject/form/formDataFlexes/formDataFlex[fieldDefinitionId='vraag_ID']
  • Selecteer de optie ‘only iterate over last occurence (1)’, hierdoor wordt nu enkel de laatste waarde opgehaald.
  • Plaats je cursor binnen de loop
  • Voeg het veld tekst of string value toe

Variabele velden onder vaste velden uit een zaak- of contactmomentformulier ophalen

  • Bv. het veld haarkleur dat de vraagID ‘person_requester_1_haarkleur’ krijgt is een variabel veld onder de velden van person_requester. 
  • De expressie wordt altijd op dezelfde manier opgebouwd en verwijst naar het zaakformulier, de vaste velden, de variabele velden, het variabele veld dat je zelf definieert en het soort waarde dat je wenst op te halen. In onderstaande expressie dien je dus enkel nog de juiste vraag ID toe te voegen.

    ${/genericobject/form/formDataFixed/requesters/requester/agent/person/formDataFlexes/formDataFlex[fieldDefinitionId='haarkleur']/stringValue}

    Indien het om een ander soort waarde gaat dient het laatste deeltje vervangen te worden. Dit kan eenvoudig door een veld te selecteren en het laatste gedeelte te kopiëren en plakken in bovenstaand script.

    • stringValue = tekst
    • integerValue = numeriek
    • dateValue = datum
    • displayValue = weergave

Variabele velden uit een taakformulier ophalen

De werking is heel gelijkaardig aan het toevoegen van velden uit het zaakformulier. Het enige verschil is dat je hier ook dient te definiëren uit welke taak het veld komt.

  • Klik de mogelijke variabele vraag ID's open onder taakformulier
  • Voeg het noodzakelijke veld toe, de meest voorkomende zijn:
    • tekst = stringValue
    • weergave = displayValue
    • datum = dateValue
    • numeriek = integerValue
  • Klik op de tab mapping
  • Open de settings via het eerste icoontje of met een dubbele klik op de aan te passen mapping
  • Kies onder de tab general voor mapping type 'Expression'
  • Klik op het bewerken icoontje
  • De expressie wordt altijd op dezelfde manier opgebouwd en verwijst naar de taaknaam, de variabele velden, het variabele veld dat je zelf definieert en het soort waarde dat je wenst op te halen. In onderstaande expressie dien je dus enkel nog de juiste taaknaam en vraag ID toe te voegen. De taaknaam is deze zoals gedefinieerd in de workflow activiteit taak, dit is niet de naam van het taakformulier.

    ${/genericobject/taskForms/entries[key='taaknaam']/values/value/formDataFlexes/formDataFlex[fieldDefinitionId='vraag_id']/stringValue}

    Indien het om een ander soort waarde gaat dient het laatste deeltje vervangen te worden. Dit kan eenvoudig door een veld te selecteren en het laatste gedeelte te kopiëren en plakken in bovenstaand script.

    • stringValue = tekst
    • integerValue = numeriek
    • dateValue = datum
    • displayValue = weergave