CSV Pliki. Przykłady. Zastosowania

1. Opis ogólny 2. Które pliki można wymieniać w formacie CSV ? W BM, KB, KG, MG, NA, ZO, ... 3. Definicja plików CSV (mapowanie) 4. Przykłady zastosowań plików CSV 4.1 Pobieranie kart odbiorców 4.2 Przesunięcie [MM] całego zapasu z magazynu AA --> BB 4.3 Rozchód [RO] całego zapasu z magazynu AA 4.4 Automatyczne budowanie dokumentu MM Przesunięcie magazynowe 4.5 Przesunięcie towarów z centrali do oddziałów 4.6 Pobieranie wyciągów z plików CSV 4.7 Masowe zmiany w wielu rekordach 4.8 Inne zastosowania. Pobieranie Ceny dostawców Kart BOM Karty operacji RO Dokumenty magazynowe Zamówienia sprzedaży 4.9 Aktualizacja kart odbiorców i dostawców 5. Tematy powiązane

1. Opis ogólny

Dane programu Trawers można wymieniać z innymi systemami w wielu formatach: CSV, XML (SOA), EDI. Patrz: Formaty plików wymiany 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.

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 "123-213-555";"201x/02/23-00124";12;12,00 ------------------------------------------ W programie Trawers ERP jest narzędzie, które umożliwia przyporządkowanie pól w zbiorach danych do odpowiadających im pól w plikach CSV. Dzięki tej tabeli można importować (pobierać) dane z plików CSV i eksportować (wysyłać) dane do plików CSV. Takim narzędziem, które umożliwia przyporzadkowanie (mapowanie) pól jest Tabela definicji plików CSV (tabela mapowania). Tabela mapowania pozwala na opisanie struktury plików tekstowych (.CSV), pobieranych lub wysyłanych w poszczególnych systemach. Jeden plik CSV zawiera dane dla jednego zbioru (tabeli) w bazie danych. Np. plik: klienci.csv zawiera dane dla zbioru: NA > 002 Kartoteka odbiorców. Patrz szczegóły: CSV Tabela defnicji CSV

2. Które pliki można wymieniać w formacie CSV

Patrz kartoteki, dokumenty i tabele, które można wczytywać z plików CSV i których zawartość można zapisywać do plików CSV. CSV Tabela defnicji CSV Patrz też wymianę w formacie XML (SOA): SOA Funkcje OutBound i InBound

3. Definicja plików CSV (mapowanie)

Tabela mapowania

Tabela mapowania pozwala na opisanie struktury plików tekstowych (.CSV), pobieranych lub wysyłanych w poszczególnych systemach. Tabela jest w: AD > Tabele > Definicje plików CSV [AD_TTX10] W tabeli wskazuje się że, np. pierwszy ciąg, zawiera numer dokumentu, drugi ciąg zawier symbol odbiorcy, trzeci - kwotę należności, itp. Odczytane kwoty program mnoży * przelicznik. Np. 100 groszy * 0.01 = 1 zł. Takie definicje trzeba utworzyć dla wszystkich rodzajów wczytywanych i zapisywanych danych (rodzajów plików CSV). Patrz szczegóły: CSV Tabela defnicji CSV

4. Przykłady zastosowań

4.1 Pobieranie kart odbiorców

1. Utworzyć definicję CSV: AD > Tabele > Definicje CSV dla NA > Kartoteka odbiorców Pola: Kontrahent, Nazwa, Kod, Miasto 2. Utworzyć plik CSV z danymi odbiorców, np. w Excelu 3. Dopisać kartę odbiorcy wzorcowego do kartoteki odbiorców Symbol tej karty podać w parametrach NA 4. NA > Pomocnicze > Pobieranie kart ... [NA_PDO10] Pobrać karty z CSV i zapisać do kartoteki odbiorców Dodatkowo, automatycznie można zapisać: * Osobę do kontaktu. Program dopisuje: Biuro, z działu BI * Adres dodatkowy: Wysłać do Dane tele-adresowe takie same jak w karcie podstawowej. Gdy jest karta odbiorcy a nie ma żadnej osoby do kontaktu, to program dopisuje osobę do kontaktu. Patrz też: Aktualizacja kart odbiorców i dostawców Seryjnie można pobierać dane odbiorców z platformy: Baza GUS. W pliku CSV podać tylko NIP. Program wyszuka dane odbiorcy w bazie GUS. Na ekranie: Pobieranie kart odbiorców [NA_PDO10] oznaczyć: Pobierać z GUS ? [T] Pobieranie z bazy GUS - wersja beta. Oprogramowanie serwera GUS podlega modyfikacji. Nie możemy zapewnić płynnego i bezawaryjnego pobierania danych.

4.2 Przesunięcie [MM] całego zapasu z magazynu AA --> BB

1. Utworzyć plik CSV z indeksem i ilością w magazynie: AA MG > Zapasy > Tabelarycznie > Zapasy w KSOM [MG_ZSW81] Przetworzyć (np. w Excelu) plik aby zawierał tylko pola: Indeks i Ilość Będą to dane o zapasach bieżących w magazynie: AA 2. Utworzyć definicję CSV: AD > Tabele > Definicje CSV dla MG > Dokumenty Pola: Indeks i Ilość 3. Utworzyć dokument MM z AA --> BB wg zapisów w CSV: MG > Dokumenty > Przesunięcia MM > Rejestracja > > Pobieranie z pliku CSV [MG_DMM1C] 4. Zatwierdzić dokument MM Program wyceni dokument przychodu do magazynu BB wg wyceny rozchodu magazynu AA. NOTE: Dodatkowo, można zażądać przeniesienia całego zapasu z magazynu źródłowego do docelowego w MG > Przesunięcia wg zapotrzebowania [MG_DMM1E]. Generowanie dokumentów przesunięć Dokumenty magazynowe

4.3 Rozchód [RO] całego zapasu z magazynu AA

1. Utworzyć plik CSV z indeksem i ilością w magazynie: AA MG > Zapasy > Tabelarycznie > Zapasy w KSOM [MG_ZSW81] Przetworzyć (np. w Excelu) plik aby zawierał tylko pola: Indeks i Ilość Będą to dane o zapasach bieżących w magazynie: AA 2. Utworzyć definicję CSV: AD > Tabele > Definicje CSV System: MG Tabela: 001 Dokumenty magazynowe Pola: Indeks i Ilość (tylko 2 kolumny) 3. Zarejestrować dokument rozchodu [RO] z magazynu: AA wg zapisów w CSV: MG > Dokumenty > Rozchody > Rejestracja > Pobieranie z pliku CSV [MG_DRO1C] 4. Zatwierdzić dokument [RO] Rozchód Program wyceni wartość rozchodu i ustali cenę w dokumencie. Dokumenty magazynowe

4.4 Automatyczne budowanie dokumentu MM Przesunięcie magazynowe

Automatyczne tworzenie dokumentu: MM Przesunięcie z magazynu tranzytowego do magazynu oddziałowego. Funkcja: [MG_DMM1C] Dokument budowany z wykorzystaniem pliku CSV, który powstał na podstawie dokumentu: MM Przesunięcie z magazynu centrali do magazynu tranzytowego. Funkcja: [MG_DMM1V] Patrz opis: Magazyn tranzytowy Tabela magazynów

4.5 Przesunięcie towarów z centrali do oddziałów

Sytuacja: --------- Firma używa MM do przekazywania książek ze swojej siedziby do sklepóww. Nowości, które przychodzą do centrali są dalej przekazywane do księgarń. Centrala przesyła nowości do sklepu (01). Robi to rejestrując MM z magazynu centrali (00) --> do magazynu sklepu (01). Ale te same nowości chce wysłać do magazynów sklepów: 02,03,04, ... Potrzeba: --------- Umożliwić powielenie (skopiowanie) MM do przesyłania do innych magazynów. Rozwiazanie: ------------ Powielić dokument MM za pomocą pliku CSV. * Utworzyć definicje CSV W definicji dać tylko dwa rekordy: Indeks, Ilosc * Zarejestrować wzorcowy dok MM, np. z 00->01 (np. MM0001) * Zapisać do pliku CSV. Rejestracja > Zapis do pliku CSV [MG_DMM1V] * Utworzyć kolejne dokumenty MM w funkcji: [MG_DMM1C] Wybierać pliki CSV wg w/w definicji

4.6 Pobieranie wyciągów z plików CSV

Wyciągi bankowe zawierają informacje o obrotach i stanach środków pieniężnych na rachunkach bankowych. Informacje te banki udostępniają w formie elektronicznej. Zakres informacji przekazywany przez poszczególne banki jest zróżnicowany, dlatego, w programie Trawers przyjęto, że informacje wyciągów pobierane będą z plików tekstowych CSV w formacie definiowanym w tabeli definicji struktur CSV (w tabeli mapowania) Pobieranie wyciągów z plików CSV

4.7 Masowe zmiany w wielu rekordach

Potrzeba -------- Zmienić zawartość niektórych pól w wielu kartach (rekordach). Rozwiązanie * Zapisać zawartość wybranych kart do pliku CSV * Zmienić wybrane pola we arkuszu, np. Excelu * Wczytać zmienione karty z pliku CSV NOTE: W tym przypadku program nie kontroluje, czy pola mają wskaźnik [E]. Takich zmian mogą dokonywać świadomi i doświadczeni administratorzy. Inna metoda, zalecana: Globalne zmiany pól w bazie danych

4.8 Inne zastosowania

* Pobieranie cen dostawców (ofert) z plików CSV Patrz szczegóły: Kartoteka cen dostawców (oferty) * Pobieranie kart BOM z plików CSV Patrz szczegóły: BOM Pobieranie CSV, zapis CSV * Pobieranie kart technologicznych RO z plików CSV Patrz szczegóły: Procesy technologiczne, z CSV, do CSV * Pobieranie danych ze spisu z natury z plików CSV Patrz szczegóły: Inwentaryzacja zapasów magazynowych * Pobieranie adresów (wysyłkowych) z plików CSV Patrz szczegóły: Adresy wysyłkowe odbiorców * Pobieranie dokumentów magazynowych z plików CSV Patrz szczegóły: Dokumenty magazynowe * Pobieranie zamówień sprzedaży z plików CSV Patrz szczegóły: Realizacja zamówień sprzedaży

4.9 Aktualizacja kart odbiorców i dostawców

Kartoteka odbiorców

1. Utworzyć definicję CSV: AD > Tabele > Definicje CSV dla NA > Kartoteka odbiorców Pola: Kontrahent + pola aktualizowane NOTE: Do zmiany można wybrać pola oznaczone w słowniku jako pola edytowalne: [E] (en: Editable) Patrz szczegóły: Globalne zmiany pól w bazie danych

Przykład

Przykład zmiany pól: Telefon 1 E-mail Uwagi 1 Uwagi 2 -- Definicja pliku CSV [AD_TTX20] -------------------------------------- System NA Tabela 002 Kartoteka odbiorców Nr definicji 20 Aktualizacja Nazwa pliku trtres\trinout\??\aktualizuj_odbiorcow.csv Ogranicznik " Znacznik Separator ; Kropka dziesiętna , Nagłówek N Format daty RRRR-MM-DD Kodowanie UTF UTF-8 (Unicode) ------------------------------------------------------------------------ ------------- Pole ---------------- Numer --Typ-- Ułamek --Przelicznik Kontrahent 1 C 6 Telefon 1 2 C 30 E-mail 3 C 65 Uwagi 1 4 C 30 Uwagi 2 5 C 30 ------------------------------------------------------------------------ 2. Utworzyć plik CSV z danymi odbiorców, np. w Excelu Przykład pliku: aktualizuj_odbiorcow.csv ------------------------------------------------------------------------------ "000001";"501502503";"odbiorca-000001@gmail.com";"#Lipiec2024";"ROKUJE NA 35%" "000002";"601602603";"odbiorca-000002@gmail.com";"#Lipiec2024";"ROKUJE NA 10%" "000003";"701702703";"odbiorca-000003@gmail.com";"#Lipiec2024";"NIE ROKUJE" ------------------------------------------------------------------------------ 3. NA > Pomocnicze > Aktualizacja kart odbiorców [NA_PDO16] Pobrać karty z CSV i zapisać do kartoteki odbiorców NOTE: Do aktualizacji kart odbiorców można także stosować funkcję SOA: Karta odbiorcy NA Korekta [CustomerUpdate] SOA Funkcje OutBound i InBound Patrz też: Pobieranie kart odbiorców

Kartoteka dostawców

Procedura taka sama jak w przypadku kartoteki odbiorców: 1. Utworzyć definicję CSV: AD > Tabele > Definicje CSV dla ZO > Kartoteka dostawców 2. Utworzyć plik CSV z danymi dostawców, np. w Excelu 3. NA > Pomocnicze > Aktualizacja kart dostawców [ZO_PDO16] Pobrać karty z CSV i zapisać do kartoteki dostawców NOTE: Do aktualizacji kart dostawców można także stosować funkcję SOA: Karta dostawcy ZO Korekta [VendorUpdate] SOA Funkcje OutBound i InBound Patrz też: Pobieranie kart dostawców

5. Tematy powiązane

CSV Pola plików CSV Zapisywanie plików Wprowadzanie danych początkowych SOA Funkcje OutBound i InBound Słowa kluczowe #Admin-WymianaDanych