Bindane funkcije

Funkcije koje se mogu pozivati u dinamičkim izrazima

Ovdje su napomene za djelatnike 4D i distributere 4D Wand sustava. Napomene su vezane za interna setiranja u 4D Wandu i nisu predviđena da se korisnici sustava njima služe.

•Grad()

•Adresa()

•Telefon()

•Napomena()

•Partner()

•Komercijalista()

•Objekt()

•Vozilo()

•StabloDokumenata()

•StabloStavki()

•RobaUsluga() i Opis()

•UcitajStablo(), UcitajStablo2() i UcitajStablo3()

•Slika()

•DodajURTF()

•UcitajBarCode()

•NapomenaOpis()

•CijenaNaljepnice()

•NajnizaMPCijena()

•IznosEurKn()

•KreirajIspisiQR()

•UcitajStanje()

•DodatnaNapomena()

Grad(Oblast,Tip)

Opis:
Vraća poštanski broj, grad, državu itd. po poslanom parametru.
Funkcija prlja REG:Record.

Parametri:
Oblast - Šifra grada za koji se trebaju učitati podaci (PAR:Oblast)
Tip -
0 - "Poštanski broj Grad, Država"
1 - "Poštanski broj Grad"
2 - "Grad"
3 - "Država"
4 - "Poštanski broj"
19 - "Međunarodna šifra države" (ovo je ujedno i oznaka valute)
20 - "Međunarodna oznaka države" (HR, A, BIH,...)

Primjer:
Grad(PAR:Oblast,0) će vratiti "10000 Zagreb, Hrvatska"
Grad(PAR:Oblast,1) će vratiti "10000 Zagreb"
Grad(PAR:Oblast,2) će vratiti "Zagreb"
Grad(PAR:Oblast,3) će vratiti "Hrvatska"
Grad(PAR:Oblast,4) će vratiti "10000"
Grad(PAR:Oblast,19) će vratiti "191" ako je upisano na formi države
Grad(PAR:Oblast,20) će vratiti "HR" ako je upisano na formi države

Adresa(Baza,Tip)

Opis:
Vraća formatiranu adresu i grad poslane baze.
Funkcija prlja REG:Record.

Parametri:
Baza - 'PAR','PA1','IME'
Tip - Ista konstanta kao za funkciju Grad()
 

Telefon(Baza)

Opis:
Vraća formatirani broj telefona poslane baze.
Ukoliko je grad u Hrvatskoj, vraća se pozivni broj grada u zagradama npr. "(021)" i broj telefona i/ili faxa.
Ukoliko je grad u Hrvatskoj, a broj telefona počinje s "09", vraća se taj broj telefona, tako da brojevi mobitela na komitentima budu ispravno prikazani.
Ukoliko grad nije u Hrvatskoj, vraća se pozivni broj države i grada u zagradama npr. "(+387 33)" i broj telefona i/ili faxa.
Da li je grad u Hrvatskoj se određuje po komitentu s organizacijske jedinice. Provjerava se je li na OJ zakačen komitent iz države s gradom koji pripada Hrvatskoj (šifra grada počinje s "01").
Funkcija prlja REG:Record.

Parametri:
Baza - 'PAR','PA1','TEL'
 

Primjer:
Za telefon "5236 381" komitenta iz Rijeke vraća "(051) 5236 381"
Za telefon "5236 381" komitenta iz Zagreba vraća "(01) 5236 381"
Za telefon "098 5236 381" komitenta iz Zagreba vraća "098 5236 381"
Za telefon "5236 381" komitenta iz Sarajeva vraća "(+387 33) 5236 381"
 

Napomena()

Ako se u napomeni nalazi izraz u dvostukim uglastim zagradama (npr [[FORMAT(DOK:DatumDosp,@d17)]]) isti će biti parsiran prilikom exporta.

Partner(Partner, Izraz)

Opis:
Učitava partnera po šifri.
Funkcija vraća rezultat poslanog izraza. Učitani partner ostaje učitan u registru PA1.

Parametri:
Partner - ID partnera kojeg treba učitati
Izraz - Dinamički izraz koji se evaluira i vraća

Primjer:
Partner(ROB:Proizvodjac,'PAR:Naziv')
vraća naziv proizvođača učitane robe. Partner ostaje učitan u PA1.

Komercijalista(Komercijalist, Izraz)

Opis:
Učitava komercijalista po šifri.
Funkcija vraća rezultat poslanog izraza. Učitani komercijalist ostaje učitan u registru KOM.

Parametri:
Komercijalist - ID komercijalista kojeg treba učitati
Izraz - Dinamički izraz koji se evaluira i vraća

Primjer:
Komercijalista(DOK:Komercijalist,'KOM:Naziv')
vraća naziv komercijalista sa učitanog dokumenta. Komercijalist ostaje učitan u KOM.

Objekt (Objekt, Izraz)

Opis:
Učitava Objekt po ID-u.
Funkcija vraća rezultat poslanog izraza. Učitani objekt ostaje učitan u registru OBJ.

Parametri:
Objekt - ID objekta kojeg treba učitati
Izraz - Dinamički izraz koji se evaluira i vraća

Primjer:
Objekt(DOK:Objekt,'OBJ:Naziv')
vraća naziv učitanog objekta. Objekt ostaje učitan u OBJ.

Vozilo (Vozilo, Izraz)

Opis:
Učitava Vozilo po ID-u.
Funkcija vraća rezultat poslanog izraza. Učitano vozilo ostaje učitano u registru VOZ.

Parametri:
Vozilo - ID vozila koje treba učitati
Izraz - Dinamički izraz koji se evaluira i vraća

Primjer:
Vozilo(DOK:Vozilo,'VOZ:Sifra')
vraća šifru učitanog vozila. Vozilo ostaje učitano u VOZ.

StabloDokumenata (Dokument, IzrazFilter, IzrazRezultat, ModusRada)

Opis:
Učitava kompletno stablo za poslani dokument. Za svaki dokument u stablu učitava i vezanog partnera.
Funkcija vraća rezultat poslanog izraza. Dokumenti u stablu se učitavaju u DO1. Vezani komitenti se učitavaju u PA1

Parametri:
Dokumet - ID dokumenta za koji učitavamo stablo
Izraz filter - Dinamički izraz pomoću kojeg se filtriraju interesantni dokumenti iz stabla. (npr. 'DO1:RadniStatus >= 1' - obrađuje samo odobrene dokumente)
* VAŽNO! Dokumenti i vezani partneri se učitavaju u prvu alias bazu. Filteri trebaju koristiti DO1 i PA1 prefikse.
Izraz rezultat - Dinamički izraz koji se evaluira i vraća kao rezultat funkcije
ModusRada - Ovaj parametar određuje način na koji će rezultati biti prezentirani. Parametar podržava slijedeće simbole: "," (zarez), "+" (plus) i "" (prazno).
* Zarez vraća delimitiranu listu za svaki dokument koji zadovoljava filter
* Plus vraća sumu svih izraza za sve dokumente koji zadovoljavaju filter
* Prazan string u polju ModusRada zaustavlja pretragu stabla na prvom dokumenu koji zadovoljava uvijet filtera i vraća evaluate izraza rezultata

Primjer:
StabloDokumenata(DOK:Dokument,'DO1:RadniStatus >= 1','DO1:Klasa[1:3]&'':''&DO1:Broj',',')
Primjer vraća listu svih dokumenata koji se nalaze u stablu učitanog dokumenta, pod uvjetom da su dokumenti odobreni (DO1:RadniStatus >= 1). Rezultat primjera: "PON:1, IZP:1, OTP:3, IFA:3, NAR:1"

StabloStavki (Stavka, IzrazFilter, IzrazRezultat, ModusRada)

Opis:
Učitava kompletno stablo za poslanu stavku. Za svaku stavku u stablu učitava: vezani dokument, vezanog partnera, i vezanu robu.
Funkcija vraća rezultat poslanog izraza. Stavke u stablu se učitavaju u slog ST1. Ostali vezani slogovi se također učitavaju u prvi alias (DO1,PA1,RO1)

Parametri:
Stavka - ID stavke za koju učitavamo stablo
Izraz filter - Dinamički izraz pomoću kojeg se filtriraju interesantne stavke iz stabla. (npr. 'DO1:RadniStatus >= 1' - obrađuje samo stavke odobrenih dokumenata)
* VAŽNO! Dokumenti, stavke, robe i vezani partneri se učitavaju u prvu alias bazu. Filteri trebaju koristiti ST1, RO1, DO1 i PA1 prefikse.
Izraz rezultat - Dinamički izraz koji se evaluira i vraća kao rezultat funkcije
ModusRada - Ovaj parametar određuje način na koji će rezultati biti prezentirani. Parametar podržava slijedeće simbole: "," (zarez), "+" (plus) i "" (prazno).
* Zarez vraća delimitiranu listu za svaki dokument koji zadovoljava filter
* Plus vraća sumu svih izraza za sve dokumente koji zadovoljavaju filter
* Prazan string u polju ModusRada zaustavlja pretragu stabla na prvom dokumenu koji zadovoljava uvijet filtera i vraća evaluate izraza rezultata

Primjer:
StabloStavki(STA:Stavka,'DO1:RadniStatus >= 1','DO1:Klasa[1:3]&'':''&DO1:Broj&''>''&ST1:RedniBroj',',')
Primjer vraća listu svih stavki koji se nalaze u vezane stablu učitane stavke, pod uvjetom da su dokumenti odobreni (DO1:RadniStatus >= 1). Rezultat primjera: "PON:1>1, IZP:1>1, IFA:3>1, NAR:1>1, PRI:2>1"

RobaUsluga (Vrijednost) i Opis (Prefiks,Vrijednost,Sufiks)

Funkcija Opis se koristi za lakši ispis raznih opisa i napomena. Ima tri parametra (Prefiks,Vrijednost,Sufiks). Vrijednost je ista kao i kod RobaUsluga, Prefiks se ugrađuje ispred opisa (sa razmakom), a Sufiks se ugrađuje iza opisa. I prefiks i sufiks se ugrađuju samo ako opis nije prazan. Na primjer, za ispis napomene stavke se napiše Opis('\line\fs14\b0',2,''). Ovo konkretno znači da će se učitati opis stavke, identično kao i RobaUsluga(2), i ispred opisa dodati '\line\fs14\b0' i razmak ' '. Cijeli izraz je zatvoren u vitičaste zagrade npr: {\line\fs14\b0 Opis nekog artikla}. Postavke koje su bile prije vitičastih zagrada će biti vraćene (za to i služe vitičaste zagrade), tako da će \fs14 i \b0 biti poništeni.

UcitajStablo (Klasa)

Opis:
Iz stabla dokumenta, koje se učitava prije svakog ispisa jednog dokumenta, učitava se prvi dokument sa klasom koja je poslana kao parametar:
Funkcija vraća broj dokumenta, a dokument učitava u DO1.

Parametri:
Klasa - Klasa dokumenta koju treba pronaći i učitati iz stabla

Primjer:
UcitajStablo('ULN') & ' ' & FORMAT(DO1:Datum,@d17)
će za dokument koji se ispisuje prikazati broj i datum ulazne narudžbe (ukoliko se ista nalazi u stablu)

Dodane su dvije nove funkcije:
UcitajStablo2 i UcitajStablo3 koje dokument učitavaju u DO2 i DO3 respektivno. Predlažemo da se koristi funkcija UcitajStablo2 i radi sa DO2:Broj i sl., čime se ne kvari sadržaj sloga u DO1, u koji je po defaultu učitan roditelj dokumenta koji se ispisuje. To znači da se DO1:Broj, DO1:Datum i sl. mogu bez ikakvog učitavanja koristiti za ispis podataka o roditeljskom dokumentu.

Slika (PutanjaDoSlike)

Opis:
Funkcija učitava sliku i generira potreban RTF kod za prikaz slike u izvještaju

Parametri:
PutanjaDoSlike - Putanja do slike koju želimo uključiti u izvještaj. Koristi se slash (/) za razdvajanje direktorija, npr. X:/SlikeDir/Slika.bmp

Dodaj u RTF

Opis:
Funkcija izraz iz RTF:Formula1 u prvome redu detalja (RPT,X,1,0) snima u RTF datoteku

Parametri:
Izraz koji se snima. Npr, na GLK:30 se u crveno boje stavke koje su izvan valute izrazom: DodajURTF(CHOOSE(DNE:DatumDosp<Q:Datum2,'\cf6',''))

UcitajBarCode (ID Robe,ID Partnera,Polje,Delimiter)

Opis:
Učitavaju se dodatne šifre za poslanu robu i poslanog komitenta. Ukoliko je poslan komitent vraćaju se dodatne šifre vezane na tog komitenta, a u suprotnom one koje nisu definirane za komitenta.
Funkcija vraća rezultat u ovisnosti o poslanom broju u parametru Polje:
1 - Šifra/Barcode dodatne šifre
2 - Naziv/Dodatni opis dodatne šifre
3 - Kolicina dodatne šifre
4 - Naziv1 dodatne šifre

Parametri:
ID Robe - ID robe za koiju se treba učitati barcode
ID Partnera - ID komitenta za kojeg se želi učitati barcode, ukoliko se pošalje 0 vraćaju se dodatne šifre koje nemaju odabranog komitenta.
Polje - Polje koje se treba vratiti funkcijom brojčana oznaka od 1 do 4
1 - Šifra/Barcode dodatne šifre
2 - Naziv/Dodatni opis dodatne šifre
3 - Kolicina dodatne šifre
4 - Naziv1 dodatne šifre
Delimiter - Ukoliko se želi učitati samo jedan barcode ne upisuje se parametar delimitera, a ukoliko se želi ispisati sve dodatne šifre potrebno je poslati delimiter koji se želi korisiti (npr. ';', '\par', '\line',itd)

Primjer:
UcitajBarCode (STA:Roba,0,1)
Primjer vraća prvu dodatnu šifru na koju naleti, a koja nema upisanog komitenta.

UcitajBarCode (STA:Roba,DOK:Partner,1)
Primjer vraća prvu dodatnu šifru na koju naleti, a koja ima upisanog komitenta.

UcitajBarCode (STA:Roba,0,1,';')
Primjer vraća listu dodatnih šifri odvojenih ';', a koje nemaju upisanog komitenta.

UcitajBarCode (STA:Roba,DOK:Partner,1,';')
Primjer vraća listu dodatnih šifri odvojenih ';', a koje imaju upisanog komitenta.

NapomenaOpis (Alias,RedakBroj)

Opis:
Funkcija vraća napomenu/opis sa zaglavlja dokumenta prema redoslijedu unosa na formi dokumenta.

Parametri:
Alias - Iz kojeg recorda se uzima tip dokumnta za koji se vraća redak napomene/opisa. Moguće vrijednosti su: 'DOK','PDD','DO1','DO2','DO3','T:DOK','PRO','FID'
RedakBroj - Redni broj napomene opisa sa zaglavlja dokumenta koji želite dohvatiti npr. NapomenaOpis('DOK',2)

CijenaNaljepnice(Iznos)

Funkcija vraća lijevo poravnatu cijenu naljepnice sa valutom. Zamišljena je da se npr. umjesto
 CLIP(LEFT(FORMAT(STA:MPIznos/STA:Kolicina3,@n-9.`2)))&' '&OJ:Novac
 koristi
 CijenaNaljepnice(STA:MPIznos/STA:Kolicina3) (izraz ispisuje cijenu u kunama do 01.01.2023, nakon 01.01.2023. cijena se automatski prikazuje u EUR)

CijenaNaljepnice(STA:MPIznos/STA:Kolicina3,1) (izraz ispisuje cijenu u EUR preračunatu po tečaju konverzije do 01.01.2023, nakon 01.01.2023. cijena se automatski konvertira i prikazuje u kn)

Parametri:
Iznos - Izraz koji treba formatirati

Znači korisnik želi u jednom redu da ima npr. MP cijenu iz primke u kunama i eurima bi išlo sljedeće:

'Cijena:' & CijenaNaljepnice(STA:ProdCijena) & '\tab ' & CijenaNaljepnice(STA:ProdCijena,1)

I do 01.01.2023. godine ispisivati će se                      Cijena: 100,00 Kn              13,27€

a od 01.01.2023. godine                                            Cijena: 13.27€                100,00€

NajnizaMPCijena()

Opis:
Funkcija vraća najnižu maloprodajnu cijenu u zadnjih trideset dana.
Poziva se isključivo na ispisu naljepnica s nivelacija.
Učitavaju se i provjeravaju svi pozitivni ulazni dokumenti. Datum se uzima od datuma nivelacije. Nivelacije MORA biti odobrena.

IznosEurKn(formula, text ispred formule, text tečaja, zanemari klasu, postavi font)

formula – iznos, formula, funkcija koju želimo konvertirati u ovisnosti o parametrima i godini u €/kn
text ispred formule – ako se ispred formule ispisuje text upisuje se isti u ovaj parametar, ako je parametar prazan ne ispisuje se ništa
text tečaja – ako se upiše tekst ispisat će se tekst i fiksni tečaj konverzije kuna u eure, ako je parametar prazan ne ispisuje se niti tekst niti tečaj
samo formatiraj bez konverzije – iznos će se formatirati, ali se neće konvertirati u drugu valutu
zanemari klasu – parametri dvojnog ispisa ne provjeravaju da li je dozvoljen dvojni ispis za klasu dokumenta
postavi font – postavlja se font druge valute

Primjer:

IznosEurKn('1.000,00') – rezultat je 132,72 €
IznosEurKn('1.000,00','Iznos') - rezultat je  Iznos: 132,72 €
IznosEurKn('1.000,00','Iznos','Fiksni tečaj') - rezultat je Iznos: 132,72 € Fiksni tečaj: 7.534500
IznosEurKn('1.000,00',,,1) - rezultat je 1.000,00 kn
IznosEurKn('1.000,00','Iznos',,1) - rezultat je Iznos: 1.000,00 kn
IznosEurKn('1.000,00','Iznos','Fiksni tečaj',1) - rezultat je Iznos: 1.000,00 kn Fiksni tečaj: 7.534500
DOK:IznosFakture je 1.750,00, a funkcija je napisana
IznosEurKn(DOK:IznosFakture,'Iznos','Fiksni tečaj') - rezultat je  Iznos: 232,26 € Fiksni tečaj: 7.534500

KreirajIspisiQR(text naslov, text sadrzaj, širina, visina)

Opis:
Funkcija kreira QR kod s poslanim sadržajem, isti ugrađuje i ispisuje na iszvještaju.
Može se pozivati isključivo s izvještaja.
 

naslov – tekst koji se ispisuje iznad QR koda
sadrzaj – izraz (polje) koji se pretvara u QR kod (npr: ROB:www)
širina – širina koda u milimetrima
visina – visina koda u milimetrima
 

Primjer:

KreirajIspisiQR('Detaljnije:',ROB:www,20,20)
 KreirajIspisiQR('','https://www.4d.hr',20,20)
 

UcitajStanje(Šifra skladišta, ID Robe, Izraz)

Opis:
Funkcija učitava stanje robe na skladištu po zadanom izrazu.
Može se pozivati isključivo za exporte.
 

Šifra skladišta – šifra skladišta za koje se učitava stanje, npr. STA:OrgJed ili '0000107'
ID Robe – ID robe za koju se učitava stanje, npr. STA:Roba ili '768'
Izraz – izraz koji funkcija izračuna i vrati gotov rezultat
 

Primjer:

UcitajStanje(STA:OrgJed,STA:Roba,'SSK:Kolicina1-SSK:Kolicina2')
 

DodatnaNapomena(ID robe, ID jezika atributa, ID vrste dodatne napomene)

Opis:
Funkcija učitava dodatnu napomenu po zadanom izrazu.
 

ID robe – ID robe za koju se učitava stanje, npr. STA:Roba ili '768'
ID jezika atributa – ID jezika atributa definiran u 4D Wandu
 ID vrste dodatne napomene – ID vrste dodatne napomene definirane u 4D Wandu
 

Primjer:

DodatnaNapomena(STA:Roba,3,2)