Funcții în șabloane de documente

De la Planfix
Salt la: navigare, căutare

Funcțiile pot fi folosite atunci când formatați automat documente folosind șabloane. Funcțiile simplifică modul în care sunt afișate datele în documentele dvs. De exemplu, puteți folosi formule pentru a afișa automat numere ca text sau pentru a calcula costurile unei comenzi.

Formule

Pentru a adăuga o formulă într-un document, utilizați următoarea sintaxă: %%%FORMULA%%% .

O FORMULĂ este o expresie pentru calcularea valorii unui câmp, la fel ca într-un calculated field.

Exemplu:

%%%TEXT({{DataTag.Service.Quantity}}*{{DataTag.Service.Cost}};".2f")%%%

În exemplul de mai sus, datele din eticheta de date "Service" sunt adăugate în formulă folosind variabilele corespunzătoare. Cele două valori sunt înmulțite, iar rezultatul reprezintă costul total al unui anumit serviciu sau produs. Funcția TEXT() formatează valoarea ca un șir text ușor de citit.

Important

De exemplu:

  • Formulele trebuie scrise într-un singur șir și nu pot fi separate prin apăsarea tastei Enter. Dacă trebuie să introduceți un întrerupător de linie, folosiți secvența "\n".
  • Fără întrerupere de linie
%%%IF({{Datatag.Service calculation.Service}}=""; ""; {{Datatag.Service calculation.Service}} + " - " + {{Datatag.Service calculation.Quantity}} + " " + {{Datatag.Service calculation."Unit"}} + " (" + {{Datatag.Service calculation.Comment}} + ")" )%%%
  • Cu întrerupere de linie
%%%IF({{Datatag.Service calculation.Service}}=""; ""; {{Datatag.Service calculation.Service}} + " - " + {{atatag.Service calculation.Quantity}} + " " + {{{Datatag.Service calculation."Unit"}} + "\n (" + {{Datatag.Service calculation.Comment}} + ")" )%%%
  • Variabilele din formulă nu pot fi formatate (de exemplu, cu aldine sau italice).
  • Dacă doriți ca rezultatul formulei să apară cu aldine, aplicați formatarea la întreaga formulă, inclusiv la semnele procentuale.

Funcții

Toate funcțiile disponibile în formulele șabloanelor de document:

Funcția SUM

SUM() este o funcție care însumează toate valorile obținute în urma evaluării unei formule. Se aplică fiecărui element al unei variabile multiplicatoare.

De exemplu, presupunem că aveți o etichetă de date "Service" și doriți să calculați costul total al tuturor serviciilor dintr-un document. Ați folosi funcția: 

SUM({{DataTag.Service.Cost}})

Pentru a obține costul total al serviciilor prestate, trebuie să înmulțiți costul serviciului cu numărul de ori în care a fost comandat. Iată formula pe care ar trebui să o utilizați în document: 

SUM({{DataTag.Service.Cost}}*{{DataTag.Service.Quantity}}))

Rețineți că funcția SUM() poate conține orice formulă compusă din funcții.

Funcția PLURALFORM

Se utilizează pentru a adăuga un sufix unui cuvânt sau pentru a schimba cuvântul în sine dacă este un substantiv neregulat, în funcție de numărul calculat din șablonul documentului.

Format: 

PLURALFORM(number; "text1"; "text2";)

În funcție de valoarea calculată a number, funcția selectează unul dintre cei doi parametri. Parametrii trebuie specificați într-o ordine strictă, conform algoritmului.

De exemplu, trebuie să flexionați cuvântul "dollar". Urmați algoritmul:

Mai întâi, scrieți cuvântul corespunzător pentru numărul 1:

  • 1 dollar

Aceasta înseamnă că primul parametru din funcție trebuie să fie cuvântul "dollar" în loc de "text1".

Apoi, scrieți cuvântul pentru numărul 2:

  • 2 dollars

Aceasta înseamnă că al doilea parametru din funcție trebuie să fie "dollars" în loc de "text2".

În final, puteți specifica următoarea funcție PLURALFORM() în document:

PLURALFORM(SUM({{Datatag.Service.Cost}}*{{Datatag.Service.Quantity}}); "dollar"; "dollars")

Funcția NUMBERASWORDS

Aceasta este o funcție care returnează un număr în cuvinte. Doar partea întreagă a numărului este transcrisă în litere.

Format: 

NUMBERASWORDS(number; Output; "language")

Unde:

  • number — este un număr sau o formulă
  • Output — definește cum va fi afișat numărul (de la 0 la 6)
  • language — șir care specifică limba de ieșire. Dacă este lăsat gol (""), se folosește limba utilizatorului care generează documentul.

Limbi și metodele lor de Output:

  • Engleză ("en")
    • 0-3 — implicit (număr cardinal)
    • 4-6 — implicit cu majusculă
  • Germană ("de")
    • 0 — implicit (neutru din punct de vedere al genului)
    • 1 — scris la feminin
    • 2 — scris la masculin
    • 3 — scris la neutru
    • 4 — cu majusculă, la feminin
    • 5 — cu majusculă, la masculin
    • 6 — cu majusculă, la neutru
  • Franceză ("fr")
    • 0 — implicit (număr cardinal)
    • 1 — scris la feminin
    • 2 — scris la masculin
    • 4 — cu majusculă, la feminin
    • 5 — cu majusculă, la masculin

De exemplu, pentru a afișa un număr în cuvinte într-un document, utilizați funcția: 

NUMBERASWORDS(SUM({{DataTag.Service.Cost}}*{{DataTag.Service.Quantity}}); 2; "en")

Funcția FRACTIONALPART

Această funcție afișează partea fracțională a unui număr. Puteți specifica numărul de cifre după zecimală pe care doriți să le vedeți.

Format: 

FRACTIONALPART(number; NumberOfDigitsAfterDecimal)

De exemplu, pentru a afișa numărul de cenți pentru costul unui serviciu într-un document, utilizați funcția: 

FRACTIONALPART(SUM({{DataTag.Service.Cost}}*{{DataTag.Service.Quantity}}); 2)

Această funcție afișează douăle cifre după zecimal:

  • 176.03 — funcția returnează 3.
  • 15.15 — funcția returnează 15.
  • 16.156 — funcția rotunjește primele două zecimale la 16.

Mergeți la

Adus de la „http://planfix.com/ro/help/index.php?title=Funcții_în_șabloane_de_documente&oldid=1824”