Przejdź do zawartości

DocToPdf - wbudowane funkcje

Z Primesoft Wiki

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

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:

  • auspost : AusPost 4 State Customer Code
  • azteccode : Aztec Code
  • azteccodecompact : Compact Aztec Code
  • aztecrune : Aztec Runes
  • bc412 : BC412

channelcode : Channel Code codablockf : Codablock F code11 : Code 11 code128 : Code 128 code16k : Code 16K code2of5 : Code 25 code32 : Italian Pharmacode code39 : Code 39 code39ext : Code 39 Extended code49 : Code 49 code93 : Code 93 code93ext : Code 93 Extended codeone : Code One coop2of5 : COOP 2 of 5 daft : Custom 4 state symbology databarexpanded : GS1 DataBar Expanded databarexpandedcomposite : GS1 DataBar Expanded Composite databarexpandedstacked : GS1 DataBar Expanded Stacked databarexpandedstackedcomposite : GS1 DataBar Expanded Stacked Composite databarlimited : GS1 DataBar Limited databarlimitedcomposite : GS1 DataBar Limited Composite databaromni : GS1 DataBar Omnidirectional databaromnicomposite : GS1 DataBar Omnidirectional Composite databarstacked : GS1 DataBar Stacked databarstackedcomposite : GS1 DataBar Stacked Composite databarstackedomni : GS1 DataBar Stacked Omnidirectional databarstackedomnicomposite : GS1 DataBar Stacked Omnidirectional Composite databartruncated : GS1 DataBar Truncated databartruncatedcomposite : GS1 DataBar Truncated Composite datalogic2of5 : Datalogic 2 of 5 datamatrix : Data Matrix datamatrixrectangular : Data Matrix Rectangular dotcode : DotCode ean13 : EAN-13 ean13composite : EAN-13 Composite ean14 : GS1-14 ean2 : EAN-2 (2 digit addon) ean5 : EAN-5 (5 digit addon) ean8 : EAN-8 ean8composite : EAN-8 Composite flattermarken : Flattermarken gs1-128 : GS1-128 gs1-128composite : GS1-128 Composite gs1-cc : GS1 Composite 2D Component gs1datamatrix : GS1 Data Matrix gs1datamatrixrectangular : GS1 Data Matrix Rectangular gs1northamericancoupon : GS1 North American Coupon gs1qrcode : GS1 QR Code hanxin : Han Xin Code hibcazteccode : HIBC Aztec Code hibccodablockf : HIBC Codablock F hibccode128 : HIBC Code 128 hibccode39 : HIBC Code 39 hibcdatamatrix : HIBC Data Matrix hibcdatamatrixrectangular : HIBC Data Matrix Rectangular hibcmicropdf417 : HIBC MicroPDF417 hibcpdf417 : HIBC PDF417 hibcqrcode : HIBC QR Code iata2of5 : IATA 2 of 5 identcode : Deutsche Post Identcode industrial2of5 : Industrial 2 of 5 interleaved2of5 : Interleaved 2 of 5 (ITF) isbn : ISBN ismn : ISMN issn : ISSN itf14 : ITF-14 japanpost : Japan Post 4 State Customer Code kix : Royal Dutch TPG Post KIX leitcode : Deutsche Post Leitcode matrix2of5 : Matrix 2 of 5 maxicode : MaxiCode micropdf417 : MicroPDF417 microqrcode : Micro QR Code msi : MSI Modified Plessey onecode : USPS Intelligent Mail pdf417 : PDF417 pdf417compact : Compact PDF417 pharmacode : Pharmaceutical Binary Code pharmacode2 : Two-track Pharmacode planet : USPS PLANET plessey : Plessey UK posicode : PosiCode postnet : USPS POSTNET pzn : Pharmazentralnummer (PZN) qrcode : QR Code rationalizedCodabar : Codabar raw : Custom 1D symbology royalmail : Royal Mail 4 State Customer Code sscc18 : SSCC-18 symbol : Miscellaneous symbols telepen : Telepen telepennumeric : Telepen Numeric ultracode : Ultracode upca : UPC-A upcacomposite : UPC-A Composite upce : UPC-E upcecomposite : UPC-E Composite

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


Nazwa funkcji Treść komórki
Opis funkcji Treść komórki
Format funkcji Treść komórki
Przykład wywołania Treść komórki