Dostępna od wersji: 1.0.101

Zestaw funkcji toJson umożliwia wygenerowanie ciągu tekstowego w postaci JSON'a na podstawie wprowadzonych wartości lub zmiennych formularza w parametrach funkcji. Mając do dyspozycji te funkcje jesteśmy w stanie utworzyć dowolnego JSON'a o nieograniczonej liczbie zagnieżdżeń w ciągu tekstowym. W celu stworzenia ciągu znaków JSON'a jako obiektu wykorzystuje się funkcję toJsonObject(). Jeśli chcemy utworzyć ciąg znaków JSON'a w formie tablicy należy użyć funkcji toJsonArray(). Ostatnią funkcją, która dopełnia możliwości generowania JSON'a, jest toJsonArrayIterator(), która umożliwia stworzenie JSON'a w formie tablicy obiektów. Najważniejszą cechą tej funkcji jest możliwość zmapowania wierszy tabeli dynamicznej na tablicę obiektów JSON'a. Przy tej czynności konieczne jest skorzystanie z funkcji item() w parametrach konfiguracyjnych funkcji.

  • toJsonObject()
Nazwa parametruOd wersjiOpisTyp parametruWartość domyślnaRodzaj polaUwagi i ograniczenia
Klucz1.0.101Nazwa klucza zapisywana w cudzysłowiu w wynikowym JSON'ieTablica wartości tekstowych Pole edytowalne 
Wartość1.0.101Określa wartość klucza. Jest oddzielona dwukropkiem od klucza w wynikowym JSON'ieTablica wartości tekstowych Pole edytowalneJeśli dla danej wartości został określony w parametrze Typ wartość tekstowa, to będzie ona opatrzona cudzysłowem. Dla typu całkowitego, zmiennoprzecinkowego i logicznego nie pojawi się cudzysłów. Dla typu obiektowego wartość będzie opatrzona klamrami {}, a tablicowego nawiasami kwadratowymi [].
Typ1.0.101Typ przechowywanej wartościTablica wartości tekstowych Nieedytowalna lista rozwijalna
Wartość wyświetlanaWartość przekazywana
Wartość tekstowaSTRING
Wartość całkowitaINTEGER
Wartość zmiennoprzecinkowaFLOAT
Wartość logicznaBOOLEAN
ObiektOBJECT
TablicaARRAY

Dla wartości o typie zmiennoprzecinkowym należy używać kropki jako separatora dziesiętnego (standard angielski).

Typ o wartości Obiekt zezwala na użycie w polu Wartość tylko funkcji toJsonObject(), a z kolei typ o wartości Tablica tylko funkcji toJsonArray() lub toJsonArrayIterator().


  • toJsonArray()
Nazwa parametruOd wersjiOpisTyp parametruWartość domyślnaRodzaj polaUwagi i ograniczenia
Wartość1.0.101Określa pojedynczą wartość tablicyTablica wartości tekstowych Pole edytowalneJeśli dla wartości został określony w parametrze Typ wartość tekstowa, to będą one opatrzone cudzysłowami. Dla typu całkowitego, zmiennoprzecinkowego i logicznego nie pojawi się cudzysłów. Dla typu obiektowego wartości będą opatrzone klamrami {}, a tablicowego nawiasami kwadratowymi [].
Typ*1.0.101Typ przechowywanych wartościTekst Nieedytowalna lista rozwijalna
Wartość wyświetlanaWartość przekazywana
Wartość tekstowaSTRING
Wartość całkowitaINTEGER
Wartość zmiennoprzecinkowaFLOAT
Wartość logicznaBOOLEAN
ObiektOBJECT
TablicaARRAY

Dla wartości o typie zmiennoprzecinkowym należy używać kropki jako separatora dziesiętnego (standard angielski).

Typ o wartości Obiekt zezwala na użycie w polu Wartość tylko funkcji toJsonObject(), a z kolei typ o wartości Tablica tylko funkcji toJsonArray() lub toJsonArrayIterator().


  • toJsonArrayIterator()
Nazwa parametruOd wersjiOpisTyp parametruWartość domyślnaRodzaj polaUwagi i ograniczenia
Funkcja*1.0.101Wynik funkcji stanowi pojedynczą wartość tablicy. Funkcja wykona się tyle razy, ile wynosić będzie długość tablicy, czyli jaką wartość wprowadzono do parametru Długość tabeli.Funkcja Pole edytowalne 
Długość tabeli*1.0.101Wartość określająca długość tabeli. Definiuje ile razy zostanie wykonana iteracja.Całkowity Pole edytowalne

 

Licznik*1.0.101Zmienna na formularzu przechowująca wartość bieżącej iteracjiZmienna Pole edytowalnePo zakończeniu pętli, w której wykonywana była iteracja, licznik zostaje wyzerowany.
Typ*1.0.101Typ przechowywanych wartościTekst Nieedytowalna lista rozwijalna
Wartość wyświetlanaWartość przekazywana
Wartość tekstowaSTRING
Wartość całkowitaINTEGER
Wartość zmiennoprzecinkowaFLOAT
Wartość logicznaBOOLEAN
ObiektOBJECT
TablicaARRAY

Dla wartości o typie zmiennoprzecinkowym należy używać kropki jako separatora dziesiętnego (standard angielski).

Typ o wartości Obiekt zezwala na użycie w polu Funkcja tylko funkcji toJsonObject(), a z kolei typ o wartości Tablica tylko funkcji toJsonArray() lub toJsonArrayIterator().

 

Parametr*- pole wymagane

Warto wziąć pod uwagę, że za pomocą funkcji toJsonArray() również można zbudować JSON'a składającego się z tablicy obiektów, lecz nie można w tej tablicy odzwierciedlić zawartości tabeli dynamicznej z formularza. Funkcja toJsonArrayIterator() na to pozwala, ponieważ zapewnia iteracje po elementach tabeli dynamicznej.

  • toJsonObject()



    nazwa:

    wydatki:


  • toJsonArray()



  • toJsonArrayIterator()



    Funkcja:

    nazwa firmy:

    NIP:

    KRS:


  • toJsonObject() i toJsonArray()

Konfiguracja parametrów funkcji:


nazwa:


wydatki:



Wynik:

{
       "identyfikator": "adampastewski",
       "indeks": 11279,
       "oprocentowanie": 2.5,
       "podlegaVAT": true,
       "nazwa": {
             "imię": "Adam",
             "nazwisko": "Pastewski"
       },
      "wydatki": [
             122.6,
             130.1,
             58.7
      ]
}

 

 

  • toJsonArrayIterator()

Wygenerowanie listy obiektów na podstawie poniższych danych:


Konfiguracja parametrów funkcji:

data:

kwota:

symbol:

 

wartość:

zestawy:

TAX:

MPK:

 

wartość:

 

wartość:

Wynik:

 

[
	{
		"data":"2020-12-15",
		"stawkaVAT":"23%",
		"podlegaVAT":true,
		"symbol":"1001",
		"kwota":{
			"symbol":"PLN",
			"wartość":4867.5
		},
		"zestawy":[
			{
				"nazwa":"TAX",
				"wartość":83
			},
			{
				"nazwa":"MPK",
				"wartość":143
			},
			{
				"nazwa":"Projekty",
				"wartość":117
			},
			{
				"nazwa":"Zadanie projektowe",
				"wartość":2201
			}
		]
	},
	{
		"data":"2020-12-17",
		"stawkaVAT":"23%",
		"podlegaVAT":true,
		"symbol":"1001",
		"kwota":{
			"symbol":"USD",
			"wartość":1351.4
		},
		"zestawy":[
			{
				"nazwa":"TAX",
				"wartość":92
			},
			{	
				"nazwa":"MPK",
				"wartość":145
			},
			{
				"nazwa":"Projekty",
				"wartość":152
			},
			{
				"nazwa":"Zadanie projektowe",
				"wartość":89
			}
		]
	}
]

 1.0.101

  • Dodanie funkcji

 

 

Zadania związane z komponentem

Aktualne

<link do JIRA>

Archiwalne

 

Available from version: 1.0.101

The toJson function set allows to generate a JSON text string based on the entered values or form variables in the function parameters. With these functions at our disposal, we are able to create any JSON with an unlimited number of nests in a text string. To create a JSON string as an object, the toJsonObject() function is used. If we want to create a JSON string in the form of an array, use the toJsonArray() function. The last function that complements the JSON generation capabilities is toJsonArrayIterator(), which allows to create JSON as an array of objects. The most important feature of this function is the ability to map dynamic table (variable set) rows to an array of objects. For this, it is necessary to use the item () function in the function configuration parameters.

  • toJsonObject()
Name of the parameterFrom versionDescriptionParameter typeDefault valueField typeNotes and restrictions
Key1.0.101Name of the key written in quotation marks in the resulting JSONTable text values Editable field 
Value1.0.101Specifies the key value. It is separated by a colon from the key in the resulting JSONTable text values Editable fieldIf a text value has been specified for a given value in the Type parameter, it will be enclosed with quotation marks. There will be no quotation marks for integer, floating point, and logical types. For the object type, the value will be provided with {} braces, and for array type with square brackets [].
Type1.0.101Type of the stored valueTable text values Non editable dropdown list
Displayed valuePassed value
String valueSTRING
Integer valueINTEGER
Float valueFLOAT
Boolean valueBOOLEAN
ObjectOBJECT
ArrayARRAY

For floating point values, use a dot as a decimal separator (English standard).

Type with the value Object allow to use only toJsonObject() function in the Value field, and the type with the value Array only allow to use toJsonArray() or toJsonArrayIterator() functions.

 

  • toJsonArray()
Name of the parameterFrom versionDescriptionParameter typeDefault valueField typeNotes and restrictions
Value1.0.101Specifies a single array valueTable text values Editable fieldIf a text value was specified for the values in the Type parameter, they will be enclosed with quotation marks. There will be no quotation marks for integer, floating point, and logical types. For the object type, the values will be enclosed with braces {}, and for array type with square brackets [].
Type*1.0.101type of the stored valuesText Non editable dropdown list
Displayed valuePassed value
String valueSTRING
Integer valueINTEGER
Float valueFLOAT
Boolean valueBOOLEAN
ObjectOBJECT
ArrayARRAY

For floating point values, use a dot as a decimal separator (English standard).

Type with the value Object allow to use only toJsonObject() function in the Value field, and the type with the value Array only allow to use toJsonArray() or toJsonArrayIterator() functions.


  • toJsonArrayIterator()
Name of the parameterFrom versionDescriptionParameter typeDefault valueField typeNotes and restrictions
Function*1.0.101Function result is a single array value. The function will be executed as many times as is the length of the array, that is, the value entered into the parameter Table length.Function Editable field 
Table length*1.0.101Value that specifies the length of the table. Defines how many times the iteration will be performed.Integer Editable field 
Counter*1.0.101Variable on the form that stores the value of the current iteration.Variable Editable fieldAfter the iteration loop completes, the counter is reset to zero.
Type*1.0.101Type of the stored valuesText Non editable dropdown list
Displayed valuePassed value
String valueSTRING
Integer valueINTEGER
Float valueFLOAT
Boolean valueBOOLEAN
ObjectOBJECT
ArrayARRAY

For floating point values, use a dot as a decimal separator (English standard).

Type with the value Object allow to use only toJsonObject() function in the Function field, and the type with the value Array only allow to use toJsonArray() or toJsonArrayIterator() functions.

Parameter*- required field

It is worth considering that using the toJsonArray () function you can also build a JSON consisting of an array of objects, but you cannot reflect the contents of a dynamic table (variable set) from the form in this array. The toJsonArrayIterator () function allows this, because it iterates over the elements of a dynamic table.

  • toJsonObject()


    name:

    expenses:

 

  • toJsonArray()


  • toJsonArrayIterator()



    Function:


    company name:


    national court register:


    tax exempt number:
  •  toJsonObject() and toJsonArray()

Function parameters configuration:

name:

expenses:

Result:

{
       "identifier": "adampastewski",
       "index": 11279,
       "interest": 2.5,
       "appliesToVAT": true,
       "name": {
             "firstname": "Adam",
             "lastname": "Pastewski"
       },
      "expenses": [
             122.6,
             130.1,
             58.7
      ]
}

 

  • toJsonArrayIterator()

 

Generating a list of objects based on the following data:

Function parameters configuration:

Function:

date:

amount:

symbol:

value:

features:

TAX:

MPK:

Projects:

Project task:

Result:

[
    {
        "date": "2020-12-15",
        "VAT rate": "23%",
        "applies to VAT": true,
        "mark": "1001",
        "amount": {
            "symbol": "PLN",
            "value": 4867.5
        },
        "features":[
            {
                "name":"TAX",
                "value":83
            },
            {
                "name":"MPK",
                "value":143
            },
            {
                "name":"Projects",
                "value":117
            },
            {
                "name":"Project task",
                "value":2201
            }
        ]
    },
    {
        "date":"2020-12-17",
        "VAT rate":"23%",
        "appliesToVAT":true,
        "mark":"1001",
        "amount":{
            "symbol":"USD",
            "value":1351.4
        },
        "zestawy":[
            {
                "name":"TAX",
                "value":92
            },
            {  
                "name":"MPK",
                "value":145
            },
            {
                "name":"Projects",
                "value":152
            },
            {
                "name":"Project task",
                "value":89
            }
        ]
    }
]

 1.0.101

  • Adding functions