Razmjena podataka s vanjskim sustavima

Upute za import putnih naloga u modul Putni nalozi iz XML datoteke

Datum kreiranja: 18.04.2017.

Datum zadnje izmjene: 29.07.2021. - Dodan prazan primjer importne datoteke za lakše popunjavanje i testiranje

Datoteke i format

DD.MM.GGGG - Datumski podatak formatiran u formatu dan.mjesec.godina gdje su dan i mjesec popunjeni vodećim nulama ako je isti manji od 10, npr.: 03.04.2017

HH:MM:SS - Vremenski podatak formatiran u formatu sat : minuta : sekunda, npr 12:45:30. Vremena se upisuju u 24 satnom formatu s vodećim nulama ispred komponenti manjih od 10 npr.: 06:09:08

NUMERIC(-mm.nn) - Numerički podatak maksimalne duljine mm znamenki (uključujući decimalni separator i predznak), od kojih je nn znamenki odvojeno za decimalna mjesta. Decimalni separator je , (zarez), a separator za tisućice se ne upisuje: npr.: -1234567890,12. Prethodni primjer predstavlja numerički podatak u formatu -14.2: predznak (-), 10 mjesta za cjelobrojni dio, decimalni zarez i 2 mjesta za decimalni dio (ukupno 14 znakova).

STRING(nn) - Tekstualni podataka s maksimalnom duljinom nn znakova u kom ne smije biti znak ; (točka-zarez), znak '<=' u tablicama označava da vrijednost pojedine kolone može biti manja ili jednaka upisanom broju, nipošto veća.

Napomene

XML datoteka treba biti UTF-8 enkodirana.

Brojevi se upisuju bez separatora tisućica s točkom kao pozicijom decimalnog mjesta.

Svi registri (Radnici, Potpisnici naloga, Vrste troška, Svrhe putovanja, Vrste prijevoza, Mjesta troška, Dimenzije 1, Dimenzije 2, Dimenzije 3, Gradovi, Države, Valute, ...) na koje se referenciraju putni nalozi iz import datoteke, moraju unaprijed biti definirani u 4D Wand-u, jer će putni nalozi u suprotnom biti odbijeni.

Registar radnika se prepoznaje po ID-u 4D Wand-a ako je ID poslan, zatim po OIB-u, zatim po Imenu i Prezimenu

Ostali registri (Vrste troška, Svrhe putovanja, Vrste prijevoza, Mjesta troška, Dimenzije 1, Dimenzije 2, Dimenzije 3, Gradovi, Države, Valute, ...) se prepoznaju po Nazivima, što znači da se u import datoteci u navedenim registrima moraju nalaziti nazivi iz 4D Wand-u

U koloni M je navedena obaveza upisa pojedinih podataka:

oO - obavezan upis,

oN - neobavezan upis,

oD - upis ovisan o drugim podacima (npr.: podatke o radniku i potpisniku je moguće poslati kao ID iz 4D Wand-a, OIB radnika/potpisnika ili kao ime i prezime radnika/potpisnika)

U koloni C je naveden kardinalitet xml elemenata.

4D Wand Putni nalozi.xls

Naziv tag-a

M

Format

C

Opis podatka

<?xml version="1.0" encoding="UTF-8"?>

O

 

1

 

<DataPort4DWandPutniNalozi>

O

 

1

 

     <PutniNalozi>

O

 

1

 

          <PutniNalog>

O

 

1-n

 

              <ZaglavljePutnogNaloga>

O

 

1

 

                  <BrojPutnogNaloga>

O

NUMERIC(6)

1

Broj putnog naloga, putni nalog ne smije postojati u 4D Wand-u

                  <DatumNaloga>

O

DD-MM-GGGG

1

Datum putnog naloga

                  <DatumPolaska>

O

DD-MM-GGGG

1

Datum polaska na službeni put

                  <DatumPovratka>

O

DD-MM-GGGG

1

Datum povratka aa službenog puta

                  <DatumObracuna>

O

DD-MM-GGGG

1

Datum obračuna putnog naloga

                  <DatumIsplate>

N

DD-MM-GGGG

0-1

Datum isplate putnog naloga

                  <RadnikIme>

D

STRING(<=30)

0-1

Ime radnika

                  <RadnikPrezime>

D

STRING(<=30)

0-1

Prezime radnika

                  <RadnikOIB>

D

NUMERIC(11)

0-1

OIB radnika

                  <Radnik4DWandID>

D

NUMERIC(6)

0-1

ID radnika u 4D Wand-u

                  <MjestoTroska>

N

STRING(<=80)

0-1

Naziv mjesta troška u 4D Wand-u

                  <Dimenzija1>

N

STRING(<=80)

0-1

Naziv dimenzije 1 u 4D Wand-u

                  <Dimenzija2>

N

STRING(<=80)

0-1

Naziv dimenzije 2 u 4D Wand-u

                  <Dimenzija3>

N

STRING(<=80)

0-1

Naziv dimenzije 3 u 4D Wand-u

                  <GradPolazista>

O

STRING(<=80)

1

Naziv grada polazišta u 4D Wand-u

                  <GradOdredista>

O

STRING(<=80)

1

Naziv grada odredišta u 4D Wand-u

                  <MaksimalnoTrajanjeBrojDana>

O

NUMERIC(3)

1

Maksimalno trajanje puta u danima

                  <SvrhaPutovanja>

O

STRING(<=80)

1

Naziv svrhe putovanja u 4D Wand-u

                  <OpisNaloga>

N

STRING(<=80)

0-1

Opis putnog naloga

                  <VrstaPrijevoza>

O

STRING(<=80)

1

Naziv vrste prijevoza u 4D Wand-u

                  <PocetnaKilometraza>

O

NUMERIC(7)

1

Početna kilometraža

                  <UkupnaKilometraza>

N

NUMERIC(7)

0-1

Ukupno pređena kilometraža na putu

                  <KrajnjaKilometraza>

O

NUMERIC(7)

1

Krajnja kilometraža

                  <MjestoObracuna>

N

STRING(<=80)

0-1

Mjesto obračuna putnog naloga u 4D Wand-u

                  <PotpisnikNalogaIme>

N

STRING(<=30)

0-1

Ime potpisnika

                  <PotpisnikNalogaPrezime>

N

STRING(<=30)

0-1

Prezime potpisnika

                  <PotpisnikNalogaOIB>

N

NUMERIC(11)

0-1

OIB potpisnika

                  <PotpisnikNaloga4DWandID>

N

NUMERIC(6)

0-1

ID potpisnika u 4D Wand-u

                  <NapomenaIzvjestajSPuta>

O

STRING(<=1024)

1

Izvještaj sa službenog puta

              </ZaglavljePutnogNaloga>

O

 

1

 

              <ObracuniDnevnica>

N

 

0-1

 

                  <ObracunDnevnice>

O

 

1-n

 

                          <VrstaTroskaDnevnice>

O

STRING(<=80)

1

Naziv vrste troška dnevnice u 4D Wand-u

                          <Drzava>

O

STRING(<=80)

1

Naziv države za dnevnice u 4D Wand-u

                          <MjestoTroska>

N

STRING(<=80)

0-1

Naziv mjesta troška u 4D Wand-u

                          <Dimenzija1>

N

STRING(<=80)

0-1

Naziv dimenzije 1 u 4D Wand-u

                          <Dimenzija2>

N

STRING(<=80)

0-1

Naziv dimenzije 2 u 4D Wand-u

                          <Dimenzija3>

N

STRING(<=80)

0-1

Naziv dimenzije 3 u 4D Wand-u

                          <DatumPolaska>

O

DD-MM-GGGG

1

Datum polaska

                          <VrijemePolaska>

O

HH:MM:SS

1

Vrijeme polaska

                          <DatumPovratka>

O

DD-MM-GGGG

1

Datum povratka

                          <VrijemePovratka>

O

HH:MM:SS

1

Vrijeme povratka

                          <PrekidPutovanja>

N

NUMERIC(3)

0-1

Trajanje prekida putovanja

                          <BrojDnevnica>

N

NUMERIC(3)

0-1

Broj dnevnica

                          <IznosDnevniceUValuti>

O

NUMERIC(-14.2)

1

Iznos dnevnice u valuti

                          <Tecaj>

O

NUMERIC(14.6)

1

Tečaj valute

                          <DioKojiSeNeIsplacuje>

N

NUMERIC(-14.2)

0-1

Dio koji se ne isplaćuje

                  </ObracunDnevnice>

O

 

1-n

 

                  ...

...

...

...

...

              </ObracuniDnevnica>

N

 

0-1

 

              <Relacije>

N

 

0-1

 

                  <Relacija>

O

 

0-n

 

                          <DatumRelacije>

O

DD-MM-GGGG

1

Datum relacije

                          <VrstaTroska>

O

STRING(<=80)

1

Naziv vrste troška relacije u 4D Wand-u

                          <OdGrada>

O

STRING(<=80)

1

Naziv grada polazišta u 4D Wand-u

                          <DoGrada>

O

STRING(<=80)

1

Naziv grada odredišta u 4D Wand-u

                          <VrstaPrijevoza>

O

STRING(<=80)

1

Naziv vrste prijevoza u 4D Wand-u

                          <MjestoTroska>

N

STRING(<=80)

0-1

Naziv mjesta troška u 4D Wand-u

                          <Dimenzija1>

N

STRING(<=80)

0-1

Naziv dimenzije 1 u 4D Wand-u

                          <Dimenzija2>

N

STRING(<=80)

0-1

Naziv dimenzije 2 u 4D Wand-u

                          <Dimenzija3>

N

STRING(<=80)

0-1

Naziv dimenzije 3 u 4D Wand-u

                        <BrojKilometara>

O

NUMERIC(6)

1

Broj kilometara relacije

                  </Relacija>

O

 

1-n

 

                  ...

...

...

...

...

              </Relacije>

N

 

0-1

 

              <PutniTroskovi>

N

 

0-1

 

                  <PutniTrosak>

O

 

1-n

 

                          <DatumTroska>

O

DD-MM-GGGG

1

Datum troška

                          <VrstaTroska>

O

STRING(<=80)

1

Naziv vrste troška u 4D Wand-u

                          <MjestoTroska>

N

STRING(<=80)

0-1

Naziv mjesta troška u 4D Wand-u

                          <Dimenzija1>

N

STRING(<=80)

0-1

Naziv dimenzije 1 u 4D Wand-u

                          <Dimenzija2>

N

STRING(<=80)

0-1

Naziv dimenzije 2 u 4D Wand-u

                          <Dimenzija3>

N

STRING(<=80)

0-1

Naziv dimenzije 3 u 4D Wand-u

                          <OpisTroska>

N

STRING(<=80)

0-1

Opis troška

                          <ValutaTroska>

O

NUMERIC(03)

1

Međunarodna oznaka valute troška(978,840,)

                          <IznosTroskaUValuti>

O

NUMERIC(-14.2)

1

Iznos troška u valuti

                          <Tecaj>

N

NUMERIC(14.6)

0-1

Tečaj valute troška

                          <Nepriznato>

N

NUMERIC(-14.2)

0-1

Iznos nepriznatog troška

                  </PutniTrosak>

O

 

1-n

 

                  ...

...

...

...

...

              </PutniTroskovi>

N

 

0-1

 

          </PutniNalog>

O

 

1-n

 

     </PutniNalozi>

O

 

1

 

</DataPort4DWandPutniNalozi>

O

 

1

 

Primjer praznjog XML-a za lakše popunjavanje, pripremu i testiranje

<?xml version="1.0" encoding="UTF-8"?>
<DataPort4DWandPutniNalozi>
     <PutniNalozi>
          <PutniNalog>
                 <ZaglavljePutnogNaloga>
                      <BrojPutnogNaloga> </BrojPutnogNaloga>
                      <DatumNaloga> </DatumNaloga>
                      <DatumPolaska> </DatumPolaska>
                      <DatumPovratka> </DatumPovratka>
                      <DatumObracuna> </DatumObracuna>
                      <DatumIsplate> </DatumIsplate>
                      <RadnikIme> </RadnikIme>
                      <RadnikPrezime> </RadnikPrezime>
                      <RadnikOIB> </RadnikOIB>
                      <Radnik4DWandID> </Radnik4DWandID>
                      <MjestoTroska> </MjestoTroska>
                      <Dimenzija1> </Dimenzija1>
                      <Dimenzija2> </Dimenzija2>
                      <Dimenzija3> </Dimenzija3>
                      <GradPolazista> </GradPolazista>
                      <GradOdredista> </GradOdredista>
                      <MaksimalnoTrajanjeBrojDana> </MaksimalnoTrajanjeBrojDana>
                      <SvrhaPutovanja> </SvrhaPutovanja>
                      <OpisNaloga> </OpisNaloga>
                      <VrstaPrijevoza> </VrstaPrijevoza>
                      <PocetnaKilometraza> </PocetnaKilometraza>
                      <UkupnaKilometraza> </UkupnaKilometraza>
                      <KrajnjaKilometraza> </KrajnjaKilometraza>
                      <MjestoObracuna> </MjestoObracuna>
                      <PotpisnikNalogaIme> </PotpisnikNalogaIme>
                      <PotpisnikNalogaPrezime> </PotpisnikNalogaPrezime>
                      <PotpisnikNalogaOIB> </PotpisnikNalogaOIB>
                      <PotpisnikNaloga4DWandID> </PotpisnikNaloga4DWandID>
                      <NapomenaIzvjestajSPuta> </NapomenaIzvjestajSPuta>
                 </ZaglavljePutnogNaloga>
                 <ObracuniDnevnica>
                       <ObracunDnevnice>
                            <VrstaTroskaDnevnice> </VrstaTroskaDnevnice>
                            <Drzava> </Drzava>
                            <MjestoTroska> </MjestoTroska>
                            <Dimenzija1> </Dimenzija1>
                            <Dimenzija2> </Dimenzija2>
                            <Dimenzija3> </Dimenzija3>
                            <DatumPolaska> </DatumPolaska>
                            <VrijemePolaska> </VrijemePolaska>
                            <DatumPovratka> </DatumPovratka>
                            <VrijemePovratka> </VrijemePovratka>
                            <PrekidPutovanja> </PrekidPutovanja>
                            <BrojDnevnica> </BrojDnevnica>
                            <IznosDnevniceUValuti> </IznosDnevniceUValuti>
                            <Tecaj> </Tecaj>
                            <DioKojiSeNeIsplacuje> </DioKojiSeNeIsplacuje>
                       </ObracunDnevnice>
                 </ObracuniDnevnica>
                 <Relacije>
                    <Relacija>
                         <DatumRelacije> </DatumRelacije>
                         <VrstaTroska> </VrstaTroska>
                         <OdGrada> </OdGrada>
                         <DoGrada> </DoGrada>
                         <VrstaPrijevoza> </VrstaPrijevoza>
                         <MjestoTroska> </MjestoTroska>
                         <Dimenzija1> </Dimenzija1>
                         <Dimenzija2> </Dimenzija2>
                         <Dimenzija3> </Dimenzija3>
                         <BrojKilometara> </BrojKilometara>
                    </Relacija>
                 </Relacije>
                 <PutniTroskovi>
                    <PutniTrosak>
                         <DatumTroska> </DatumTroska>
                         <VrstaTroska> </VrstaTroska>
                         <MjestoTroska> </MjestoTroska>
                         <Dimenzija1> </Dimenzija1>
                         <Dimenzija2> </Dimenzija2>
                         <Dimenzija3> </Dimenzija3>
                         <OpisTroska> </OpisTroska>
                         <ValutaTroska> </ValutaTroska>
                         <IznosTroskaUValuti> </IznosTroskaUValuti>
                         <Tecaj> </Tecaj>
                         <Nepriznato> </Nepriznato>
                    </PutniTrosak>
                 </PutniTroskovi>
          </PutniNalog>
     </PutniNalozi>
</DataPort4DWandPutniNalozi>

Opis importa

U modulu putnih naloga, u tabeli putnih naloga iz izbornika Obrada potrebno je odabrati izbornu liniju Import putnih naloga iz XML datoteke.
 

Upozorenje: Korisnik je obavezan provjeriti importirane podatke.


*** Napomena - upute se mogu razlikovati u slikama i tekstu od sadržaja koji se nalazi na vašem računalu, ovisno o inačici 4D Wanda koju trenutno koristite. Posljedica je to stalnog razvoja i nadogradnje 4D Wanda, a koji iz objektivnih razloga dinamikom ne prati i nadogradnja modula Upute. Posebno se to odnosi na zamjenu službene valute RH kuna (kn) u euro (€) i njen prikaz u uputama.