xlsie

Konzolna aplikacija za uvoz i izvoz podataka između Excel datoteka (.xls / .xlsx) i tekstualnih datoteka.

---

Sadržaj

• Opis
• Zahtjevi
• Korištenje
  • Import (uvoz)
  • Export (izvoz)
• Parametri
• Format datoteka
  • Import – izlazna DAT datoteka
  • Export – ulazna DAT datoteka
• Logiranje
• Primjeri

---

Opis

xlsie je alat koji omogućuje:

• Import – čitanje Excel datoteke i pisanje sadržaja u tekstualnu (DAT) datoteku u CSV formatu odvojenom točka-zarezom (;), kodiranu u windows-1250.
• Export – čitanje ključ-vrijednost parova iz tekstualne (DAT) datoteke i upisivanje vrijednosti u zadane ćelije Excel datoteke, opcionalno koristeći predložak.

---

Zahtjevi

• .NET Framework 4.7.2
• NPOI biblioteka (uključena putem NuGet-a)

---

Korištenje

xlsie.exe mod=<import|export> xls=<putanja_do_xls> dat=<putanja_do_dat> [predlozak=<putanja_do_predloska>]

Import (uvoz)

Čita Excel datoteku i zapisuje sadržaj u DAT datoteku.

xlsie.exe mod=import xls="C:\podaci\tablica.xlsx" dat="C:\podaci\izlaz.dat"

Export (izvoz)

Čita DAT datoteku s ključ-vrijednost parovima i upisuje vrijednosti u odgovarajuće ćelije Excel datoteke.

xlsie.exe mod=export xls="C:\podaci\izlaz.xlsx" dat="C:\podaci\ulaz.dat"

S predloškom:

xlsie.exe mod=export xls="C:\podaci\izlaz.xlsx" dat="C:\podaci\ulaz.dat" predlozak="C:\podaci\predlozak.xlsx"

---

Parametri

Parametar	Obavezan	Opis
mod	Da	Način rada: import ili export
xls	Da	Putanja do Excel datoteke (.xls ili .xlsx)
dat	Da	Putanja do tekstualne DAT datoteke
predlozak	Ne (samo export)	Putanja do Excel predloška koji se kopira kao osnova pri izvozu

---

Format datoteka

Import – izlazna DAT datoteka

Svaki redak odgovara jednom retku iz Excel tablice. Vrijednosti ćelija su obavijene navodnicima i odvojene točka-zarezom:

"Vrijednost1";"Vrijednost2";"Vrijednost3"
"Drugi red";"Podatak";"123"

• Kodiranje: windows-1250
• Navodnici unutar vrijednosti su eskejpirani kao \"

Export – ulazna DAT datoteka

Svaki redak sadrži referencu ćelije i vrijednost odvojenu dvotočkom:

A1: Naslov dokumenta
B2: Josip Horvat
C3: 2024-01-15
D4: =1500.00

• Referenca ćelije – npr. A1, B2, C10 (slovo = stupac, broj = redak)
• Tekstualna vrijednost – upisuje se kao tekst ili datum ako je u formatu koji se može parsirati kao DateTime
• Numerička vrijednost – vrijednosti koje počinju s = tretiraju se kao brojevi (npr. =1500.00)
• Kodiranje: windows-1250

---

Logiranje

Aplikacija automatski zapisuje log datoteku xlsie.log u isti direktorij gdje se nalazi izvršna datoteka (xlsie.exe).

Svaki pokretanje bilježi:

• Datum i vrijeme
• Putanju do izvršne datoteke
• Proslijeđene parametre
• Eventualne greške (brisanje datoteke, parsiranje, itd.)

Primjer zapisa u log datoteci:

[15.01.2024 10:23:45] Executable: C:\alati\xlsie.exe, Parameters: mod=import xls=tablica.xlsx dat=izlaz.dat

---

Primjeri

Uvoz Excel tablice u DAT datoteku

xlsie.exe mod=import xls="tablica.xls" dat="izlaz.dat"

Rezultat – izlaz.dat:

"Ime";"Prezime";"Godina"
"Ana";"Kovač";"1990"
"Marko";"Horvat";"1985"

Izvoz podataka iz DAT datoteke u Excel

xlsie.exe mod=export xls="dokument.xlsx" dat="podaci.dat" predlozak="predlozak.xlsx"

Sadržaj podaci.dat:

A1: Izvještaj za 2024.
B3: =9500.50
C3: 2024-12-31