JSON bestand: dataset

Met deze actie kunt u een dataset ophalen o.b.v. de inhoud van een JSON-bestand. De resulterende dataset zal in een geheugenveld worden gezet, waarna deze in volgende acties van de taak gebruikt kan worden.

Beschrijving parameters

Omschrijving (optioneel)

Uitleg voor deze parameter vind u hier.

JSON bestand (verplicht)

Het JSON-bestand dat u wilt inlezen en welke moet worden omgezet naar de dataset.

Query (optioneel)

In de definitie van JSON kunt u lezen dat een JSON-bestand kan worden vergeleken met een database. U kunt hier dus een SQL query invoeren om de inhoud van het JSON-bestand ook op die manier te benaderen.


Bij het opvragen van de gegevens uit het JSON-bestand heeft u de keuze uit 2 keuzes:

  • Op maat gedefinieerd
    U kunt zelf in het JSON-bestand zien/bepalen welke tabellen er in voorkomen en welke relatie deze met elkaar hebben. Op basis van die informatie kunt u dan de query samenstellen. U kunt echter ook dit werk aan de actie overlaten door op de knop Haal standaard query te klikken, Er zal dan voor u een query worden aangemaakt welke alle beschikbare gegevens uit het JSON-bestand ophaalt. Indien gewenst kunt u deze query daarna bewerken, zoals bijvoorbeeld het uitbreiden met een filter (WHERE-opdracht).
  • Genereer o.b.v. inhoud JSON
    In veel gevallen zal een JSON-bestand alleen de velden bevatten, indien er ook daadwerkelijk gegevens in deze velden staan. M.a.w. indien bepaalde gegevens niet aanwezig zijn, zullen de betreffende velden niet opgenomen worden in het JSON-bestand. Dit betekent dat bij het opvragen van de gegevens rekening moet worden gehouden met velden die soms wel en soms niet aanwezig zijn. De op maat gedefinieerde query zal in deze gevallen niet toepasbaar zijn.

    Indien slechts bij benadering bekend is wat de inhoud van het JSON-bestand zal zijn, of als het JSON-bestand niet altijd alle op te vragen gegevens bevat, kan de inhoud van de JSON ook automatisch door BPM Server worden gegenereerd.
    Dit betekent dat elke keer, als de actie wordt uitgevoerd, de query wordt bepaald door BPM Server en het resultaat alleen de velden bevat die daadwerkelijk in het JSON-bestand aanwezig is.

Test Query

Met deze knop kunt u de ingevoerde query testen. Nadat de query (correct) is uitgevoerd, zal het resultaat ervan worden getoond in het venster Test SQL query.



NB: Om performance redenen worden alleen de eerste 150 records getoond. In dit voorbeeld ziet u dat dit ook zo wordt aangegeven (Alleen de eerste 150 regels worden getoond).


NB: Indien u in de query BPM Server velden heeft opgenomen, zal eerst het venster Invoer veld waarden worden getoond waarin u de, voor deze testquery te gebruiken, testwaarden kunt invoeren.

Plaats resultaat in dit geheugenveld

Dit is het geheugenveld van het type dataset, waarin u het resultaat wilt laten zetten.

Actie bij fout

Uitleg voor deze parameter vind u hier.

Let op

Indien in de query een where-clausule wordt gebruikt, dan is de waarde die gevonden wordt case insensitive.


Voorbeeld

WHERE name = 'JaNsSeN'


geeft hetzelfde resultaat als


WHERE name = 'janssen'