Import danych jest niezwykle przydatnym narzędziem, które pozwala zaoszczędzić czas i umożliwia łatwe wprowadzenie oraz aktualizację informacji. Import pozwala na szybkie wprowadzenie dużej ilości rekordów jednocześnie minimalizując ryzyko popełnienia błędów (takich jak:literówki, pominięcie informacji). Wykorzystuje się go głównie do obsługi kartotek dostępnych w programie takich jak: asortyment, kontrahenci, usługi czy akta pracowników. Najczęściej używaną metodą jest import z pliku Excel. W rezultacie przygotowanego rozwiązania klient może z poziomu programu wyeksportować szablon w formacie xlsx., który po uzupełnieniu ponownie importuje do systemu.
Formularz dopisania i edycji Importu
Formularz służy do tworzenia nowych definicji importu oraz edycji już istniejących rekordów. Składa się on z następujących zakładek:
- BASIC
- PARAMETERS
- COLUMNS
BASIC
Zakładka pozwala określić podstawowe cechy komponentu, natomiast składa się ona następujących pól konfiguracyjnych:
- NAME – nazwa konfiguracyjna elementu, po której będzie można wyszukiwać go w innych komponentach;
- DESCRIPRION – krótka charakterystyka opisowa importu i jego wykorzystania;
- FORMAT FILE – format importu (xlsx., CSV);
- SHEET – wskazuje arkusz z danymi do zaimportowania; jeśli użytkownik nie wskaże arkusza, system zaimportuje dane z pierwszego dostępnego arkusza;
- CONNECTION – sposób połączenia do bazy danych (podstawowy to SoftwareStudioConnectionString);
- ACTIVE – (check-box) – oznaczenie czy dokument ma być aktywny, tzn. czy będzie widoczny w innych komponentach,;
- SYSTEM – (check-box) – czy komponent ma być systemowy, tzn. czy jest elementem konfiguracji systemu;
- EXCEL TEMPLATE – (check-box) – aktywacja umożliwia użytkownikowi generowanie szablonu Excel do importowania danych z interfejsu użytkownika;
- ALLOW TO REVERT IMPORT – (check-box) – aktywacja pozwala na przywrócenie importu po załadowaniu pliku (aby aktywować import musi zawierać kolumnę IMPORTED_FILE_REFNO);
- INTERACTIVE IMPORT – (check-box) – aktywacja powoduje wyświetlenie po zaimportowaniu danych tabel z podsumowaniem oraz listą zaimportowanych rekordów;
- SKIP HIDDEN COLUMNS – (check-box) – pomija podczas importu kolumny z pliku Excel, które zostały oznaczone jako ukryte;
- SHOW FILE CONFIRMATION – (check-box) – powoduje wyświetlenie okna z potwierdzeniem po wczytaniu pliku, przed rozpoczęciem importu;
- USE CUSTOM DATA TABLE POSITION – (check-box) – umożliwia ręczne wskazanie położenia danych w arkuszu (np. od którego wiersza i kolumny ma rozpocząć się odczyt danych);
- IS TABLE POSITION REQUIRED – (check-box) – wymusza wskazanie pozycji danych; brak podania uniemożliwia wykonanie importu;
- CHECK TABLE HEADER BEFORE IMPORT – (check-box) – weryfikuje poprawność nagłówków tabeli w pliku przed rozpoczęciem importu;
PARAMETERS
Zakładka pozwala określić szczegółowe cechy oraz parametry komponentu,
Składa się z następujących pól konfiguracyjnych:
- HAS HEADER RECORD – (check-box) – aktywacja oznaczenia wskazuje, że import zawiera wiersz nagłówkowy;
- FIRST ROW – wskazanie numeru wiersza, od którego mają zostać zaimportowane dane;
- FIRST COLUMN – użytkownik wskazuje kolumnę, od której system rozpoczyna import danych; jeżeli nie wskaże żadnej kolumny, system uwzględnia wszystkie kolumny z arkusza;
- IGNORE EXCIST OBJECTS – (check-box) – system ignoruje wiersze, które nie występują w bazie danych, jeżeli użytkownik aktywuje tę opcję;
- EXECUTE CODE SQL AFTER IMORT – (check-box) – aktywacja powoduje wykonanie wskazanego kodu SQL po poprawnym imporcie danych;
- CODE SQL – kod SQL, wykonywany po poprawnym imporcie danych
- USE VALIDATION SCRIPT – (check-box) – aktywacja oznacza użycie w imporcie customowego skryptu walidującego (zapis z okna CUSTOM VALIDATION SCRIPT);
- CHECK SCRIPT – przycisk pozwalający zweryfikować poprawność customowego skryptu walidującego;
- CUSTOM VALIDATION SCRIPT – okno z zapisem walidacji custom;
- IMPORT MODE – tryb importu – dostępny jest import przy użyciu procedury składowanej lub bezpośrednio do wskazanej tabeli;
- STORED PROCEDURE / TABLE – wskazanie procedury / tabeli wykorzystywanej do importu danych;
COLUMNS
Zakładka pozwala określić na konfigurację poszczególnych kolumn w imporcie. W ramce po lewej stronie zakładki dostępny jest spis kolumn. Listę generuje się automatycznie za pomocą przycisku „GENERATE COLUMNS”, natomiast dodawanie pojedynczych kolumn możliwe jest przy użyciu symbolu „+”.
Po wskazaniu kolumny w prawej części formularza możliwa jest jego konfiguracja. Pola konfiguracyjne mogą różnić się w zależności od wybranego rodzaju źródła danych;
- NAME – nazwa kolumny;
- ACTIVE – (check-box) – użytkownik wskazuje, czy kolumna ma być aktywna; system pomija kolumny nieaktywne podczas importu;
- DESCRIPRION – krótka charakterystyka opisowa kolumny oraz jej wykorzystania;
- REQUIRED – (check-box) – użytkownik wskazuje, czy pole jest wymagane; system odrzuci import, jeśli pole oznaczone jako wymagane nie zostanie poprawnie wypełnione;
- SOURCE TYPE – rodzaj źródła danych;
- SOURCE SPECIAL – specjalne typy źródeł danych;
Import interaktywny
Instrukcja do interaktywnego importu
Po wybraniu importu, którzy korzysta z opcji interaktywnej konfiguracji wyświetla się okno do uzupełnienia wartości:
- FORMAT – format w jakim musi być wgrywany plik;
- ARKUSZ – Dane są odczytywane z arkusza Excel; podczas gdy użytkownik nie wpisze nazwy arkusza, program automatycznie wybierze pierwszy arkusz;
- PIERWSZY WIERSZ – Wiersz, od którego zaczyna się tabela;
- PIERWSZA KOLUMNA – Kolumna, od której zaczyna się tabela;
- DANE DO WPROWADZENIA – Sekcja do uzupełnienia danych do importu (zależne od konfiguracji);
- PRZYCISK Wygeneruj excel – po kliknięciu program tworzy szablon do uzupełnienia. Po wybraniu pliku program odczytuje jego zawartość. Następnie analizuje każdą kolumnę pod kątem wypełnienia wartościami;
- KOLUMNY Z ARKUSZA – Kolumny odczytane z tabeli (aktualnie zaznaczona kolumna: 'DESIGNATION’);
Dane kolumny z arkusza:
- AKTYWNE – użytkownik wybiera, czy dana kolumna z arkusza ma zasilić kolumnę w tabeli w bazie;
- DŁUGOŚĆ NAJDŁUŻSZEJ WARTOŚCI – Liczba znaków najdłuższego wyrazu (NSR157 – 6 znaków);
- NAJDŁUŻSZA WARTOŚĆ – Najdłuższa wartość wykryta dla zaznaczonej kolumny (NSR157);
- WSZYSTKO UZUPEŁNIONE – Flaga, wskazuje, czy wszystkie komórki w kolumnie zawierają wartości (nie są puste ani nie składają się tylko ze spacji);
- LICZBY CAŁKOWITE – Flaga, wskazuje, czy wszystkie niepuste komórki w kolumnie zawierają liczby całkowite;
- SAME LICZBY – Flaga, wskazuje, czy wszystkie niepuste komórki w kolumnie zawierają liczby;
Konfiguracja kolumny z importu:
- KOLUMNA SQL – kolumna w tabeli, którą zasila zaznaczona kolumna z arkusza (np. kolumna 'DESIGNATION’ z arkusza zasila kolumnę 'DESIGNATION’ w tabeli);
- TYP KOLUMNY SQL – typ danych obsługiwanych przez kolumnę w tabeli;
- WARTOŚĆI PUSTE – określa, czy kolumna w tabeli pozwala na puste wartości (czyli gdy komórka nie jest uzupełniona);
- UŻYWA SKRYPTU – Import do danej kolumny SQL jest poprzedzony skryptem (konfigurowalny z poziomu konfiguratora). Dane wyjściowe dla danej kolumny z arkusza mogą być inne niż dane wejściowe. Wtedy system pomija walidacje z poziomu formularza;
- OPIS – Opis dla danej kolumny SQL (konfigurowalny z poziomu konfiguratora);
- Po kliknięciu importuj następuje pokazanie okna dotyczącego zapisania nowej konfiguracji importu;
- NAZWA – Nowa nazwa dla nowej konfiguracji importu
- OPIS– Opis dla nowej konfiguracji importu
- PRZYCISK Importuj – Zaimportowanie danych z excela bez zapisywania nowej konfiguracji importu.
- PRZYCISK Zapisz i importuj – Zaimportowanie danych z excela wraz z zapisaniem nowej konfiguracji importu.
- Po zaimportowaniu danych zostanie wyświetlony grid z finalnymi wierszami, które zostały wgrane do tabeli.
Szczegóły konfiguracji podpięcia definicji dostępne w instrukcji Components.