Datasets

INHOUDSOPGAVE

• Wat is een dataset?
• Wanneer gebruik je datasets
• Het tabblad Dataset openen
• Indeling van het tabblad Dataset
• Inkomende gegevens
• Filter
• Resultaat
• Voorbeelden
• Overwegingen

Wat is een dataset?

Voeg lokale JSON-gegevens toe aan een sjabloon en maak het resultaat beschikbaar in de informatieboom.

Een dataset is een lokale JSON-gegevensstructuur die je rechtstreeks aan een sjabloon toevoegt in de editor. Nadat deze is toegevoegd, kan het datasetresultaat in het sjabloon worden gebruikt, bijvoorbeeld om formuliervelden vooraf in te vullen bij het configureren van bouwblokken in de informatieboom.

Een dataset bestaat uit drie onderdelen:

• Inkomende gegevens: De onbewerkte JSON die je definieert of in de editor plakt.
• Filter: Een optionele transformatie die wordt toegepast op de inkomende gegevens.
• Resultaat: De uitvoer van het filter, of de inkomende gegevens als er geen filter is geconfigureerd.

Datasets worden lokaal in het sjabloon opgeslagen. Ze worden niet gedeeld tussen sjablonen en worden niet opgeslagen in een centrale gegevensopslag.

Wanneer gebruik je datasets

Gebruik datasets wanneer je gegevens hebt die bekend zijn tijdens het bouwen van het sjabloon en je deze beschikbaar wilt maken in de informatieboom zonder verbinding te maken met een externe gegevensbron.

Veelvoorkomende gebruiksscenario's zijn:

• Een vaste lijst met opties bieden voor een selectie-vak veld, zoals afdelingen of productcategorieën.
• Inkomende gegevens filteren of herstructureren voordat ze beschikbaar worden gemaakt voor de informatieboom.
• Datumnotaties normaliseren zodat ze consistent zijn binnen het sjabloon.
• Waarden uit afzonderlijke velden combineren tot één uitvoertekenreeks.

Het tabblad Dataset openen

De knop Dataset is beschikbaar in de rechterbovenhoek van de werkbalk van de editor. Klik op de knop om het tabblad Dataset te openen.

Knop Datasets

Vanuit het tabblad Dataset kun je een dataset aan het document toevoegen en de inkomende gegevens en het filter configureren.

Indeling van het tabblad Dataset

Het tabblad Dataset gebruikt een indeling met drie kolommen:

Overzicht van het tabblad dataset

Inkomende gegevens

De kolom Inkomende gegevens bevat een JSON-editor. Voer geldige JSON in of plak deze in deze editor om de gegevens te definiëren waarmee de dataset werkt.

De JSON moet geldig zijn. Als de editor ongeldige JSON bevat, kan het filter niet worden uitgevoerd en wordt het resultatenvenster niet bijgewerkt.

Filter

De kolom Filter is optioneel. Gebruik deze om een transformatie te configureren die wordt toegepast op de inkomende gegevens voordat deze beschikbaar worden gemaakt in het document.

Klik na het configureren van een filter op Run om het uit te voeren. De uitvoer verschijnt in de kolom Resultaat.

Als er geen filter is geconfigureerd, zijn de resultaten de inkomende gegevens zoals ze zijn.

Resultaat

De kolom Resultaat toont de uiteindelijke datasetuitvoer nadat het filter is toegepast. Deze weergave is alleen-lezen.

Voorbeelden

Een optie vooraf selecteren in een bouwblok voor selecteren

Gebruik een dataset om een inkomende waarde om te zetten naar de structuur die wordt verwacht door een bouwblok Select. Een bouwblok Select vereist een object met een eigenschap option die verwijst naar de naam van het element dat moet worden geselecteerd, en een object data dat de waarden bevat die in dat element moeten worden ingevoegd.

In dit voorbeeld bepaalt de afdeling van de ontvanger welke kantoorlocatie in het sjabloon wordt geselecteerd.

Inkomende gegevens toewijzen aan een bouwblok Select

{
  "recipient": {
    "name": "Jane Doe",
    "department": "Legal",
    "office": "Copenhagen Office",
    "location": "Wilders Plads 15A, Copenhagen"
  }
}

{
  offices: {
    option: recipient.office,
    data: {
      Name: recipient.office,
      Location: recipient.location
    }
  }
}

{
  "offices": {
    "option": "Copenhagen Office",
    "data": {
      "Name": "Copenhagen Office",
      "Location": "Wilders Plads 15A, Copenhagen"
    }
  }
}

De waarde van option moet overeenkomen met de naam van een element dat is geconfigureerd in het bouwblok Select. Als de kantoornaam uit het externe systeem niet exact overeenkomt, gebruik dan replace of if in het filter om de waarde te normaliseren voordat je deze doorgeeft.

Een lijst filteren naar een relevante subset

Wanneer de inkomende gegevens meer items bevatten dan nodig zijn in het sjabloon, gebruik je een filtervoorwaarde om alleen de relevante items terug te geven.

{
  "products": [
    { "name": "Widget A", "active": true },
    { "name": "Widget B", "active": false },
    { "name": "Widget C", "active": true }
  ]
}

products[?active == `true`]

[
  { "name": "Widget A", "active": true },
  { "name": "Widget C", "active": true }
]

Alleen actieve producten worden doorgegeven aan de informatieboom.

Een datumnotatie normaliseren

Gebruik to_datetime en format om een onbewerkte datumtekenreeks om te zetten naar een bruikbare notatie voordat deze in het sjabloon wordt gebruikt.

{
  "contractDate": "2025-02-19T00:00:00Z"
}

{
  contractDate: format(
    to_datetime(contractDate, 'dd-MM-yyyy', 'en-US'),
    'MMMM d, yyyy',
    'en-US'
  )
}

{
  "contractDate": "February 19, 2025"
}

De genormaliseerde datumtekenreeks is beschikbaar in de informatieboom onder contractDate.

Twee velden samenvoegen tot één waarde

Gebruik join om twee tekenreeksvelden uit de inkomende gegevens te combineren tot één waarde, zoals een volledige naam die is samengesteld uit een voornaam en achternaam.

{
  "firstName": "Jane",
  "lastName": "Doe"
}

{
  fullName: join(' ', [firstName, lastName])
}

{
  "fullName": "Jane Doe"
}

De gecombineerde waarde is beschikbaar in de informatieboom onder fullName.

Overwegingen

• Ongeldige JSON: De JSON-editor verhindert niet dat de editor blijft functioneren, maar een filter kan niet worden uitgevoerd zolang de inkomende gegevens ongeldige JSON bevatten.
• Grote datasets: Zeer grote datasets kunnen de prestaties van de editor beïnvloeden. Beperk de inkomende gegevens tot wat nodig is voor het document.
• Filterexpressies: Filterlogica wordt lokaal geëvalueerd. Houd rekening met variaties in de inkomende gegevens waardoor het filter mogelijk mislukt.

Binnenkort beschikbaar: Een AI-assistent voor datasets helpt bij het schrijven en valideren van filters rechtstreeks in de editor.