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'ieTekstTablica wartości tekstowych Pole edytowalne 
Wartość1.0.95Określa wartość klucza. Jest oddzielona dwukropkiem od klucza w wynikowym JSON'ieTekstTablica 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ściTekstTablica 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ść tablicyTekstTablica 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.X

  • Dodanie komponentu
Panel
titlePakiet z przykładowym formularzem wykorzystującym akcję

<plik z mapą w zipie>

Hide If
special@anonymous

Zadania związane z komponentem

Aktualne

<link do JIRA>

Archiwalne

 

English
Panel
titleBasic information

Category:

Available from version:

Panel
titleDescription

 

Panel
titleConfiguration parameters
Name of the parameterFrom versionDescriptionParameter typeDefault valueField typeNotes and restrictions

Parameter*- required field

Panel
titleSample configuration

<SCREEN>

Panel
titleExample

 

Panel
titleChange log

 1.0.X

  • Adding component