Przejdź do zawartości

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

Z Primesoft Wiki
Primesoft (dyskusja | edycje)
Nie podano opisu zmian
Primesoft (dyskusja | edycje)
Nie podano opisu zmian
Linia 143: Linia 143:


'''parametr''' - wartość tekstową lub liczbowa. Parametr może być zmienną pobraną z danych wejściowych.
'''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.
'''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).
'''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).
'''wysokość''' - wysokość obrazu, który ma zawierać kod kreskowy. Wysokość podawana jest pikselach (px).


Linia 154: Linia 157:
* aztecrune : Aztec Runes
* aztecrune : Aztec Runes
* bc412 : BC412
* 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
*  
*  
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
| Przykład wywołania || Treść komórki

Wersja z 11 mar 2021, 12:41

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