1. Opis ogólny
Plik tekstowy
2. Parametry (opcje) pliku
Ogranicznik
Separator
Format daty
3. Zapisywanie pliku CSV
3.1 Zapisywanie kart KIM do CSV
3.2 Plik CSV: Przeglądanie, Drukowanie
Wywołaj arkusz
Pokaż plik
Drukuj plik
4. Wydruk wg wzorca --> plik CSV
5. Alert --> plik CSV
6. RaportyXML --> plik CSV
7. Tabelaryczne --> plik CSV
8. Tematy powiązane
1. Opis ogólny
Format CSV (Comma Separated Values) jest popularnym formatem tekstowego
zapisu danych. CSV można utworzyć i odczytać np. w Excelu
Pliki w formacie CSV stosowane są powszechnie do wymiany danych między
systemami ERP. Większość systemów ERP ma możliwość pobierania i wysyłania
danych w formatach CSV.
Patrz też:
Formaty plików wymiany
Plik tekstowy
Plik danych w formacie CSV jest plikiem tekstowym (ASCII), który zawiera
wiersze (rekordy) wypełnione ciągami znaków, rozdzielonych separatorami,
zwykle przecinkami (,). Stosowane są też średniki (;)
------------------------------------------
indeks, nr lot, ilosc, cena
------------ ---------------- ---------
------------------------------------------
"123-213-444";"201x/02/23-00123";300;34,80 <-- rekord
"123-213-555";"201x/02/23-00124";12;12,00 <-- rekord
------------------------------------------
Plik CSV może zawierać tylko dane (rekordy) (en: CSV without header line),
jak w przykładzie wyżej lub dane (rekordy) oraz nazwy kolumn (pól)
w pierwszym wierszu pliku (en: CSV with header line)
------------------------------------------
indeks, nr lot, ilosc, cena
------------- ---------------- -----------
------------------------------------------
"INDEX"; "LOTNR"; "ILOSC";"CENA" <-- header line (nazwy kolumn)
"123-213-444";"201x/02/23-00123";300;34,80 <-- rekord
"123-213-555";"201x/02/23-00124";12;12,00 <-- rekord
------------------------------------------
2. Parametry (opcje) pliku
Parametry (opcje) określają format i sposób zapisu danych
-- Opcje CSV --------------------------------------
Ogranicznik pól tekstowych "
Znacznik pól tekstowych
Separator pól ;
Kropka dziesiętna ,
Format daty RRRR-MM-DD
Standard kodowania liter UTF UTF-8
Dodać nazwy kolumn ? T
Wyrównać kolumny ? N
---------------------------------------------------
Ogranicznik pól tekstowych
Zwykle podwójny apostrof ["]
Znacznik pól tekstowych
Zwykle spacja
Dla Arkuszy Google można wybrać apostrof [']. Wtedy pola tekstowe
zostaną wstawione jako tekst. Nie będą interpretowane jako liczby lub daty.
Np. symbol odbiorcy:
[ ] 100001 -> w Arkuszu Google będzie liczbą
['] '100001 -> w Arkuszu Google pozostanie tekstem
Separator pól
Zwykle średnik [;]
Kropka dziesiętna
Znak oddzielający części ułamkowe liczby, zwykle przecinek [,]
Format daty
Np. RRRR-MM-DD
Standard kodowania polskich liter
Np. WIN Windows EE (CP1250)
Dodać nazwy kolumn ?
[T] Wpisać nazwy kolumn (pól) w pierwszym wierszu pliku
Wyrównać kolumny ?
[T] Wyrównać szerokość kolumn we wszystkich wierszach (rekordach)
3. Zapisywanie pliku CSV
3.1 Zapisywanie kart KIM do CSV
Zapisywanie (wysyłanie, export) plików CSV to tworzenie plików o strukturze
CSV z zawartoscią pobraną z bazy danych programu Trawersa. Np. z zawartością
kartoteki indeksów KIM lub zestawienia: Sprzedaż w różnych układach.
Karty KIM do pliku CSV (przykład)
MG > Kartoteka indeksów KIM > Przeglądanie [MG_KKI40]
(także: MG > Pomocnicze > Wysyłanie kart KIM do pliku CSV [MG_PDO40])
Zakładka: KIM Tabelarycznie (+ do CSV)
(opcja) można wybrać określony zestaw kart KIM: filtr Query
Funkcja: do CSV
(opcja) Eksport do CSV / XLS
Po zaakceptowaniu: CSV powstanie plik w formacie CSV z podanymi
opcjami (ogranicznik pól tekstowych, format daty, nazwy kolumn, itp.
Patrz wyżej opis opcji (parametrów), które określają format
i sposób zapisu danych
3.2 Plik CSV: Przeglądanie, Drukowanie
Utworzone pliki CSV można drukować oraz przeglądać jako pliki tekstowe lub
jako arkusze kalkulacyjne, np. w OpenOffice, Excel.
o-- Plik CSV ------------o
| 1 Wywołaj arkusz | np. Excel
| 2 Pokaż plik |
| 3 Drukuj plik |
| 4 Zapisz plik |
| 5 Pokaż tabelarycznie |
o------------------------o
[1] Wywołaj arkusz
Program zapisuje plik CSV, następnie otwiera go, tak jak plik załącznika.
Dokumenty powiązane (załączniki)
* W Windows: Zleca otwarcie pliku systemowi operacyjnemu.
Jaki program (aplikacja) będzie użyty, to zależy od ustawień parametrów w Windows.
Zwykle Windows wywoła program: Excel. Excel automatycznie otworzy ten plik do edycji.
* W Linux: Wywołuje polecenie zapisane w zmiennej systemowej BROWSER,
a gdy puste, to wywołuje program: firefox
Zwykle Linux wywoła program: OpenOffice
NOTE: Wywoływane na serwerze aplikacje mogą mieć możliwość bezpośredniego
dostępu do bazy danych. Dlatego można zablokować możliwość wywołania aplikacji.
Patrz parametr: 0322 Przeglądaj pliki na serwerze
Param ogólne 01xx 02xx 03xx 08xx
Zapisuje plik CSV w katalogu /TrInOut. Mozna zmienić nazwę pliku na inną.
Jeśli ten katalog jest udostępniony, to w Excel-u można wybrać ten plik.
[5] Pokaż tabelarycznie
Pokazuje plik w układzie tabeli. Zawartość tabeli można zapisać do pliku CSV.
Plik można wydrukować, wysłać e-mailem lub przekazać do arkusza kalkulacyjnego.
Zestawienia tabelarycznie
4. Wdruk wg wzorca --> plik CSV
Plik CSV można utworzyć poprzez odpowiednio zbudowany wzorzec wydruku.
* pola należy rozdzielić znakiem separatora pól, np. [;]
* pola znakowe należy objąć znakiem ogranicznika pól, np. ["]
* pola daty można sformatować funkcją ţFormatDaty{}, aby uzyskać np. postać RRRR-MM-DD
Do pliku CSV można zapisać wszystkie dane, które edytor wzorców pozwala
można umieścić na wzorcach dokumentów i kartotek.
Np. pola faktur sprzedaży, faktur zakupu, dokumentów magazynowych, produkcyjnych,
zestawień należności, kartotek kontrahentów, itp.
Patrz szczegóły:
CSV. Tworzenie z wydruku wg wzorca
5. Alert --> plik CSV
W funkcji Alert można wysyłać e-maile, drukować dokumenty i zestawienia (raporty).
Można także zapisywać pliki CSV
Tworzenie pliku CSV dla banku faktora z zestawieniem faktur sprzedaży
opisano w tym dokumencie:
Alerty i raportowanie
6. RaportyXML --> plik CSV
* Definiowanie raportu
Utworzenie nowego raport wybierając odpowiednie źródła danych (system i zbiory).
* Konfiguracja pól
Wybranie pól ze słownika bazy danych.
* Formatowanie danych:
Dostosowanie kolejności pól, format dat, liczby itp., aby dane były odpowiednio
sformatowane w pliku CSV.
* Wybór formatu eksportu:
Tu: format CSV
* Generowanie i eksportowanie raportu:
Wywołanie funkcji: Raport, aby wygenerować dane.
Następnie funkcja: Eksport do pliku CSV.
System wygeneruje plik CSV zawierający dane zgodnie z definicją raportu.
System zapisze wygenerowany plik CSV w podanej lokalizacji.
Patrz opis:
RaportyXML Generator w PM
7. Tabelarycznie --> plik CSV
Zestawienia tabelaryczne, to szczególnie wygodna metoda przeglądania
danych zgromadzonych w bazie programu Trawers.
W układzie tabeli można przeglądać, drukować i wysyłać do innych programów
dane zapisane w zbiorach dokumentów (transakcje), dane z kartotek i zbiorów
roboczych tworzonych w locie dla potrzeb specjalistycznych zestawień.
Zawartość tabeli można zapisać w pliku CSV i wysłać do arkusza, np. Excela.
Patrz szczegóły:
Zestawienia tabelarycznie