DocToPdf - wbudowane funkcje: Różnice pomiędzy wersjami

Wersja z 11 mar 2021, 12:37

1. Wstawienie zmiennej

Opis funkcji	Celem funkcji jest bezpośrednie wstawienie wartości zmiennej z danych wejściowych do dokumentu.
Format funkcji	${pole} gdzie pole - nazwa pola z danych wejściowych. W przypadku excela jest to nazwa kolumny.
Przykład wywołania	${adres } → ul. wielka 13/5

2. Zamiana liczby na wartość kwotową (inwords)

Nazwa funkcji

inwords

Opis funkcji

Funkcja zamienia wartość typu float na słowną wartość kwoty z dopisaniem walut.

Język ustalany z poziomu wywołania job w api. (tylko język polski, pozostałe języki wymagają dodania parametru do funkcji w docx)

Format funkcji

${inwords(number, language, currency)}

gdzie

number - liczba zapisana zgodnie z standardem ISO 4217. Parametr może być zmienną pobraną z danych wejściowych, np. ${inwords(brutto)}

language (parametr opcjonalny) - język tłumaczenia, domyślna wartość en (parametr opcjonalny)

currency (parametr opcjonalny) - waluta tłumaczenia, domyślna wartość USD (parametr opcjonalny)

Przykład wywołania

${inwords('21,20')} → dwadzieścia jeden złotych dwadzieścia groszy

${inwords(brutto)} → dwadzieścia jeden złotych dwadzieścia groszy

${inwords('21.20', ' en','USD' )} → twenty dollars twenty cents

${inwords('134,07', ‘pl’, ‘PLN’)} → sto trzydzieści cztery złote siedem groszy

Obsługiwane lokalizacje

Funkcja konwertuje kwotę zapisaną liczbą na zapis słowny. Funkcja wspiera poniższe lokalizacje.

Język	Identyfikator	Liczba	Waluta
Belgian French	fr_BE	+	-
Brazilian Portuguese	pt_BR	+	+
Bulgarian	bg	+	-
Czech	cs	+	-
Danish	dk	+	+
Dutch	nl	+	-
English	en	+	+
Estonian	et	+	-
Georgian	ka	+	+
German	de	+	+
French	fr	+	+
Hungarian	hu	+	+
Indonesian	id	+	-
Italian	it	+	-
Lithuanian	lt	+	+
Latvian	lv	+	-
Malay	ms	+	-
Polish	pl	+	+
Romanian	ro	+	+
Slovak	sk	+	-
Spanish	es	+	+
Russian	ru	+	+
Swedish	sv	+	-
Turkish	tr	+	+
Turkmen	tk	+	+
Ukainian	ua	+	+
Yoruba	yo	+	+

3. Formatowanie liczby (format)

Nazwa funkcji	format
Opis funkcji	Funkcja przekształca liczbę zmiennoprzecinkową na format waluty określonej lokalizacji.
Format funkcji	${format(liczba, lokalizacja)} gdzie: liczba - liczba zmiennoprzecinkowa, która podlega formatowaniu. Może być to zmienna pobrana z danych wejściowych, np. ${format(brutto)} lokalizacja (parametr opcjonalny) - parametr odpowiedzialny za format wyjściowy przekształcenia zmiennej liczbowej na wartość walutową. Parametr ten musi być zgodny z "Powszechnym repozytorium danych lokalizacji" (CLDR - Unicode Common Locale Data Repository) wykorzystywanych przez International Components for Unicode (ICU). Obsługiwane formaty dostępne na http://www.localeplanet.com/icu/ , np. pl, pl_PL, en, en_GB, en_US. Domyślna wartość en_US. Domyślnie formatowanie: do dwóch miejsc po przecinku
Przykład wywołania	${format(3000.000)} → 3,000.00 ${format(brutto,'pl_PL'} → 3 000,00 ${format(100000000,'hi_IN')} → 10,00,00,000.00