Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Polish
Panel
titlePodstawowe informacje

Dostępna od wersji: 1.0.95

Panel
titleOpis

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.

Panel
titleParametry konfiguracyjne
  • toJsonObject()
Nazwa parametruOd wersjiOpisTyp parametruWartość domyślnaRodzaj polaUwagi i ograniczenia
Klucz1.0.95Nazwa klucza zapisywana w cudzysłowiu w wynikowym JSON'ieTablica wartości tekstowych Pole edytowalne 
Wartość1.0.95Okreś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.95Typ przechowywanej wartościTablica wartości tekstowych Nieedytowalna lista rozwijalna
Wartość wyświetlanaWartość przekazywana
Wartość tekstowaSTRING
Wartość całkowitaINTEGER
Wartość zmiennoprzecinkowaFLOAT
Wartość logicznaBOOLEAN
ObjektOBJECT
TablicaARRAY

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

Zaleca się dla typu obiektowego użycie funkcji toJsonObject() w polu Wartość, a dla typu tablicowego funkcji toJsonArray() lub toJsonArrayIterator().


  • toJsonArray()
Nazwa parametruOd wersjiOpisTyp parametruWartość domyślnaRodzaj polaUwagi i ograniczenia
Wartość1.0.95Okreś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.95Typ przechowywanych wartościTekst Nieedytowalna lista rozwijalna
Wartość wyświetlanaWartość przekazywana
Wartość tekstowaSTRING
Wartość całkowitaINTEGER
Wartość zmiennoprzecinkowaFLOAT
Wartość logicznaBOOLEAN
ObjektOBJECT
TablicaARRAY

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

Zaleca się dla typu obiektowego użycie funkcji toJsonObject() w polu Wartość, a dla typu tablicowego funkcji toJsonArray() lub toJsonArrayIterator().


  • toJsonArrayIterator()
Nazwa parametruOd wersjiOpisTyp parametruWartość domyślnaRodzaj polaUwagi i ograniczenia
Funkcja*1.0.95Wynik 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.95Wartość określająca długość tabeli. Definiuje ile razy zostanie wykonana iteracja.Całkowity Pole edytowalne

 

Licznik*1.0.95Zmienna 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.95Typ przechowywanych wartościTekst Nieedytowalna lista rozwijalna
Wartość wyświetlanaWartość przekazywana
Wartość tekstowaSTRING
Wartość całkowitaINTEGER
Wartość zmiennoprzecinkowaFLOAT
Wartość logicznaBOOLEAN
ObjektOBJECT
TablicaARRAY

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

Zaleca się dla typu obiektowego użycie funkcji toJsonObject() w polu Funkcja, a dla typu tablicowego funkcji toJsonArray() lub toJsonArrayIterator().

 

Parametr*- pole wymagane

Warning

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.

Panel
titlePrzykładowa konfiguracja
  • toJsonObject()



    nazwa:

    wydatki:


  • toJsonArray()




  • toJsonArrayIterator()



    Funkcja:

    nazwa firmy:

    NIP:

    KRS:


Panel
titlePrzykład zastosowania
  • toJsonObject() i toJsonArray()

Konfiguracja parametrów funkcji:


nazwa:


wydatki:



Wynik:

Code Block
languagejs
{
       "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:

wartość:

 

wartość:

 

wartość:

 

wartość:

Wynik:

 

Code Block
languagejs
[
	{
		"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
			}
		]
	}
]
Panel
titleChange log

 1.0.95

  • Dodanie funkcji

 

 

Hide If
special@anonymous

Zadania związane z komponentem

Aktualne

<link do JIRA>

Archiwalne

 

English
Panel
titleBasic information

Available from version: 1.0.95

Panel
titleDescription

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.

Panel
titleConfiguration parameters
  • toJsonObject()
Name of the parameterFrom versionDescriptionParameter typeDefault valueField typeNotes and restrictions
Key1.0.95Name of the key written in quotation marks in the resulting JSONTable text values Editable field 
Value1.0.95Specifies 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.95Type 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).

It is recommended to use toJsonObject() function in the Value field for an object type, and toJsonArray() or toJsonArrayIterator() for an array type.

 

  • toJsonArray()
Name of the parameterFrom versionDescriptionParameter typeDefault valueField typeNotes and restrictions
Value1.0.95Specifies 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.95type 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).

It is recommended to use toJsonObject() function in the Value field for an object type, and toJsonArray() or toJsonArrayIterator() for an array type.


  • toJsonArrayIterator()
Name of the parameterFrom versionDescriptionParameter typeDefault valueField typeNotes and restrictions
Function*1.0.95Function 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.95Value that specifies the length of the table. Defines how many times the iteration will be performed.Integer Editable field 
Counter*1.0.95Variable 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.95Type 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).

It is recommended to use toJsonObject() function in the Function field for an object type, and toJsonArray() or toJsonArrayIterator() for an array type.

Parameter*- required field

Warning

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.

Panel
titleSample configuration
  • toJsonObject()


    name:

    expenses:

 

  • toJsonArray()


  • toJsonArrayIterator()



    Function:


    company name:


    national court register:


    tax exempt number:
Panel
titleExample of use
  •  toJsonObject() and toJsonArray()

Function parameters configuration:

name:

expenses:

Result:

Code Block
languagejs
{
       "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:

Image Added

Function parameters configuration:

Image Added

Function:

Image Added

date:

Image Added

amount:

Image Added

symbol:

Image Added

value:

Image Added

features:

Image Added

TAX:

Image Added

Image Added

MPK:

Image Added

Image Added

Projects:

Image Added

Image Added

Project task:

Image Added

Image Added

Result:

Image Added

Code Block
languagejs
[
    {
        "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
            }
        ]
    }
]
Panel
titleChange log

 1.0.X

  • Adding component