Preskoči na glavno vsebino

Podporované typy premenných

Aké sú podporované typy premenných v REST API?

Avtor: Lenka Haringerová

Typy premenných sa používajú pri exporte a importe do XML či JSON a pri filtrovaní.

Strojový názov

Názov

Poznámka

Ukážka

string

Reťazec

Kódovanie je unicode. Možno teda použiť ľubovoľný znak.

šialený koníček
こちらは田中さんです

integer

Celé číslo

Musí byť bez medzier. Ide o znamienkový 4-bajtový integer, avšak rozsah môže byť obmedzený (pozri prehľad položiek danej evidencie).

12

numeric

Desatinné číslo

Musí byť bez medzier, oddeľovačom desatinných miest je bodka. Ide o 8-bajtový double, avšak rozsah môže byť obmedzený (pozri prehľad položiek danej evidencie).

12.5

date

Dátum

Dátum vo formáte YYYY-MM-DD; možno zadať aj časovú zónu (YYYY-MM-DDZZZ), ale tá bude ignorovaná. ZZZ je označenie časovej zóny (Z alebo +HH:MM alebo -HH:MM).

  • Podporované formáty vychádzajú z W3C špecifikácie.

  • Pre filtrovanie je možné použiť iba zápis bez časovej zóny.

  • V importovaných hodnotách možno použiť ${currentYear} namiesto YYYY — ako skutočná hodnota bude použitý aktuálny rok.

1980‑05‑06
2015‑01‑30Z
2008‑09‑01+02:00

datetime

Dátum + čas

Dátum a čas vo formáte YYYY-MM-DD'T'HH:MM:SS.SSS; možno zadať aj časovú zónu (YYYY-MM-DD'T'HH:MM:SS.SSSZZZ), ale tá bude ignorovaná. ZZZ je označenie časovej zóny (Z alebo +HH:MM alebo -HH:MM).

  • Podporované formáty vychádzajú z W3C špecifikácie.

  • Pre filtrovanie je možné použiť iba zápis bez časovej zóny.

  • V importovaných hodnotách možno použiť ${currentYear} namiesto YYYY — ako skutočná hodnota bude použitý aktuálny rok.

1980‑05‑06
1980‑05‑06T12:30:12
2015‑01‑30T22:55:33Z
2008‑09‑01T17:18:14+02:00
2008‑09‑01T17:18:14.075+02:00

logic

Logická hodnota

boolean

true
false

select

Výber jednej z hodnôt

Výber jednej z hodnôt. Je reprezentovaný ako reťazec.

typVztahu.odberDodav

relation

Väzba medzi dátami

Vstupom je záznam z inej evidencie (prehľad typov identifikátorov).

123
code:CZK


Aktuálny rok v hodnotách a vo filtri

Zástupný text ${currentYear} a filtračná funkcia currentYear() sa často zamieňajú. Nejde o to isté a nie sú zameniteľné:

Zápis

Kde sa používa

Ukážka

${currentYear}

V importovaných hodnotách typu date a datetime namiesto časti YYYY

<datVyst>${currentYear}-06-15</datVyst>

currentYear()

Vo filtri, a to nad vlastnosťami, ktoré nesú rok ako číslo (napr. platiDo)

/cenik/(platiDo <= currentYear())

now()

Vo filtri nad vlastnosťami typu date a datetime

/faktura-vydana/(datSplat < now())

⚠️ ${currentYear} vo filtri nefunguje — takýto dotaz skončí chybou 400. Pre dátumové vlastnosti použite vo filtri now(), alebo rok uveďte číselne.


Súvisiace

Ste s tem dobili odgovor na svoje vprašanje?