DocToPdf - wbudowane funkcje: Różnice pomiędzy wersjami
Nie podano opisu zmian |
Nie podano opisu zmian |
||
| Linia 266: | Linia 266: | ||
|} | |} | ||
'''5. Obraz z zewnętrznego źródła (image)''' | |||
{| class="wikitable" | {| class="wikitable" | ||
|- | |- | ||
| Nazwa funkcji || | | Nazwa funkcji || '''image''' | ||
|- | |- | ||
| Opis funkcji || | | Opis funkcji || Funkcja wstawia obraz z podanego źródła (adres url) | ||
|- | |- | ||
| Format funkcji || | | Format funkcji || ${image('''url, szerokość, wysokość, ratio''')} | ||
gdzie: | |||
'''url''' - adres url wstawianego obrazu. Parametr może być zmienną pobraną z danych wejściowych. | |||
'''szerokość''' - szerokość wstawianego obrazu. Szerokość podawana jest miarach: cm, mm, in, pt, pc, px, %, em, ex. | |||
'''wysokość''' - wysokość wstawianego obrazu. Wysokość podawana jest pikselach cm, mm, in, pt, pc, px, %, em, ex. | |||
'''ratio''' - przyjmuje wartości true/false służy do włączenia obsugi proporcji obrazu. Domyślnie parametr ustawiony na false. | |||
Lista obsługiwanych typów obrazów: | |||
* Windows Enhanced Metafile (*.emf) | |||
* Windows Metafile (*.wmf) | |||
* JPEG File Interchange Format(*.jpg; *.jpeg; *.jfif; *.jpe) | |||
* Portable Network Graphics (*.png) | |||
* Windows Bitmap (*.bmp; *.dib; *.rle; *.bmz) | |||
* Graphics Interchange Format (*.gif; *.gfa) | |||
* Compressed Windows Enhanced Metafile (*.emz) | |||
* Compressed Windows Metafile (*.wmz) | |||
* Compressed Macintosh PICT (*.pcz) | |||
* Tag Image File Format (*.tif; *.tiff) | |||
* Computer Graphics Metafile (*.cgm) | |||
* Encapsulated Postscript (*.eps) | |||
* Macintosh PICT (*.pct; *.pict) | |||
* WordPerfect Graphics (*.wpg) | |||
|- | |- | ||
| Przykład wywołania || Treść komórki | | Przykład wywołania || Treść komórki | ||
Wersja z 11 mar 2021, 12:43
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.
|
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 |
4. Kod kreskowy, kod QR (barcode)
| Nazwa funkcji | barcode |
| Opis funkcji | Funkcja wstawia obraz z kodem kreskowym podanym w parametrze. |
| Format funkcji | ${barcode(parametr, typ kodu, szerokość, wysokość)}
gdzie: parametr - wartość tekstową lub liczbowa. Parametr może być zmienną pobraną z danych wejściowych. typ kodu - typ kodu kreskowego. Typ kodu zgodny z jest listą podaną poniżej. szerokość - szerokość obrazu, który ma zawierać kod kreskowy. Szerokość podawana jest pikselach (px). wysokość - wysokość obrazu, który ma zawierać kod kreskowy. Wysokość podawana jest pikselach (px). Lista obsługiwanych typów kodów kreskowych:
|
| Przykład wywołania | ${barcode(wartość kodu kreskowego, typ kodu, szerokość, wysokość)}
${barcode(CodeCode128, 'code128', '80px', '80px')} ${barcode(CodeEan13, 'ean13', '80px', '80px')} ${barcode(CodeInterleaved2of5, 'interleaved2of5', '210px', '210px')} ${barcode(CodeQrcode, 'qrcode', '210px', '210px')} |
5. Obraz z zewnętrznego źródła (image)
| Nazwa funkcji | image |
| Opis funkcji | Funkcja wstawia obraz z podanego źródła (adres url) |
| Format funkcji | ${image(url, szerokość, wysokość, ratio)}
gdzie: url - adres url wstawianego obrazu. Parametr może być zmienną pobraną z danych wejściowych. szerokość - szerokość wstawianego obrazu. Szerokość podawana jest miarach: cm, mm, in, pt, pc, px, %, em, ex. wysokość - wysokość wstawianego obrazu. Wysokość podawana jest pikselach cm, mm, in, pt, pc, px, %, em, ex. ratio - przyjmuje wartości true/false służy do włączenia obsugi proporcji obrazu. Domyślnie parametr ustawiony na false. Lista obsługiwanych typów obrazów:
|
| Przykład wywołania | Treść komórki |
| Nazwa funkcji | Treść komórki |
| Opis funkcji | Treść komórki |
| Format funkcji | Treść komórki |
| Przykład wywołania | Treść komórki |
| Nazwa funkcji | Treść komórki |
| Opis funkcji | Treść komórki |
| Format funkcji | Treść komórki |
| Przykład wywołania | Treść komórki |
| Nazwa funkcji | Treść komórki |
| Opis funkcji | Treść komórki |
| Format funkcji | Treść komórki |
| Przykład wywołania | Treść komórki |
| Nazwa funkcji | Treść komórki |
| Opis funkcji | Treść komórki |
| Format funkcji | Treść komórki |
| Przykład wywołania | Treść komórki |
| Nazwa funkcji | Treść komórki |
| Opis funkcji | Treść komórki |
| Format funkcji | Treść komórki |
| Przykład wywołania | Treść komórki |
| Nazwa funkcji | Treść komórki |
| Opis funkcji | Treść komórki |
| Format funkcji | Treść komórki |
| Przykład wywołania | Treść komórki |
| Nazwa funkcji | Treść komórki |
| Opis funkcji | Treść komórki |
| Format funkcji | Treść komórki |
| Przykład wywołania | Treść komórki |
| Nazwa funkcji | Treść komórki |
| Opis funkcji | Treść komórki |
| Format funkcji | Treść komórki |
| Przykład wywołania | Treść komórki |