Obsługa > Importy / eksporty > Bufor importu/eksportu 

Jeżeli uruchomiono proces importu danych, dane, które mają zostać zintegrowane, są odczytywane wg logicznych grup wierszy różnego typu (przykładowo nagłówek, skojarzone pozycje szczegółowe, pozycje szczegółowe o wyższym poziomie szczegółowości itd.). Każda logiczna grupa wierszy tworzy rekord.

Strukturę rekordu definiuje się w szablonie import/eksport (poprzez tabelę flag). Jeżeli w tej tabeli nie został zdefiniowany żaden wiersz, to każdy wiersz stanowi odrębny rekord.

Po rozpoczęciu importu każdy rekord jest sprawdzany pod kątem formatu danych, ale także pod względem spełniania ogólnych reguł spójności (reguły biznesowe). Jeżeli na tym etapie wykryte zostaną błędy, rekord nie zostanie zintegrowany (jednak kolejne rekordy mogą być zintegrowane).

Bufor importu/eksportu służy do przechowywania szczegółów dotyczących odrzuconych danych dla danego importowanego pliku: w danym wsadzie każdy odrzucony rekord jest monitorowany w postaci od 1 do N wierszy, a każdy wiersz zawiera opis struktury pozycji oraz wartości pola odczytane w pliku. Jeżeli w danym polu wykryto błędy, zostaną one wyróżnione w obecnym stylu.

Wówczas użytkownik może:

  • zmienić błędne wartości;
  • w razie potrzeby dodać wiersze;
  • ponownie pozyskać dane ze zbioru wsadów do pliku celem ponownego ich zaimportowania po dokonaniu korekty;
  • dodać rekordy do danego wsadu.

Istnieje również możliwość bezpośredniego zaimportowania pliku do bufora importu/eksportu bez podejmowania próby importu w trybie rzeczywistym. W takim przypadku przeprowadzona zostanie jedynie kontrola spójności formatu danych, a wszystkie grupy zostaną umieszczone w buforze.

Warunek

SEEREFERTTO Odniesienie do dokumentacji Implementacja

Zarządzanie ekranem

Buforem zarządza się z poziomu obiektu podzielonego na dwie zakładki. Lewe listy, poza standardowymi podziałami (lewa lista przedstawiająca pozycje wg przetwarzania oraz ostatnio używane), dają możliwość wyświetlenia:

  • numerów ze szczegółami pozycji, uporządkowanych hierarchicznie (Bufor importu/eksportu wg wsadu danych)
  • wg numeru wsadu / numeru wiersza / pola wiersza, gdzie wykryto błąd (Bufor importu/eksportu wg błędu).

Nagłówek

Prezentacja

Nagłówek określa wsad danych i bieżący wiersz we wsadzie.

Zamknij

 

Pola

Na tej karcie występują następujące pola :

Blok numer 1

  • Numer partii (pole NUMLOT)

Numer paczki, który jest przypisywany z licznika numeru sekwencji, określa stałą grupę danych, która importowana jest do przestrzeni magazynowej.

Określa szablon importu / eksportu, który został użyty podczas wypełniania przestrzeni magazynowania.

Kod tego szablonu może być używany podczas numerowania paczek, jeśli licznik numerów kolejnych zawiera segment typu „Uzupełnienie”.

  • Liczba linii (pole NBRLIG)

Służy do wyświetlania liczby pozycji bieżącej paczki.

  • Plik (pole FILEXT)

To pole definiuje ścieżkę domyślnego pliku danych proponowaną podczas uruchamiania importu lub eksportu. Ten plik danych jest używany w trybie automatycznym w momencie uruchomienia łańcucha importu lub eksportu. Ta ścieżka pliku może być względna. W takim przypadku oczekiwany katalog bazy danych to katalog bazy danych dla instalacji oprogramowania.

Ścieżka może zawierać znak #. W takim przypadku dojdzie do zarządzania numerem sekwencyjnym:

  • W trybie importu: Wyszukane zostaną wszystkie pliki, w których szablon odpowiada ścieżce, gdzie # odpowiada pięciu cyfrom. Pliki są importowane w porządku rosnącym cyfr.
  • W trybie eksportu: Tworzony jest plik integrujący sformatowaną wartość licznika numeru sekwencji [C]EXPORT dla pięciu cyfr. Jest to powiązane z zaznaczeniem pola Zarządzanie numerami sekwencji podczas uruchamiania funkcji eksportu.

Na przykład, jeśli numer sekwencji importu równa się 156, /u/tmp/fil# umożliwia wygenerowanie pliku /u/tmp/fil156.

Blok numer 2

  • pole LIGFIR

Te przyciski radiowe umożliwiają nawigację po pozycjach bieżącej paczki, kolejno poprzez powracanie do pierwszej pozycji, poprzedniej pozycji, a następnie przełączanie do kolejnej pozycji i do ostatniej pozycji.

  • pole LIGPRE

 

  • pole LIGNEX

 

  • pole LIGLST

 

  • Nr linii (pole NUMLIG)

 

  • Flaga (pole LEVCOD)

Określa kod użytkownika powiązany z przetwarzaną pozycją. Na przykład, jeśli szablon importu obsługuje pozycje nagłówka oznaczone znakiem „H”, szczegółowe pozycje oznaczone znakiem „L” i pomocnicze pozycje szczegółowe oznaczone znakiem „S” użyty zostanie jeden z tych 3 znaków.

  • Zapisywanie (pole ENR)

Określa aktualny numer pozycji oraz liczbę pozycji dla paczki.

Zamknij

 

Karta Wiersze

Prezentacja

Ta zakładka służy do wyświetlania pól szablonu, które muszą zostać zintegrowane z bieżącym typem wiersza (oznaczonym flagą). Jednocześnie wyświetlane są wartości znajdujące się w importowanym pliku (formatowane w określony sposób, jeżeli w polu wykryto błąd).

Zamknij

 

Pola

Na tej karcie występują następujące pola :

Tabela

  • pole NBLIG

 

Wyświetlane pole określające tabelę, w której dane mają być integrowane podczas importu (tabela ta jest także wyszukiwana dla szablonu importu / eksportu).

  • Pole (pole FLDNAM)

Wyświetlane pole, które określa pole, w którym mają być integrowane dane podczas importu (pole to jest również wyszukiwane dla szablonu import / eksport).

  • Opis (pole FLDINTIT)

Opis powiązany z poprzednim kodem.

Wyświetlane pole, które określa typ danych powiązanych z polem, które ma być integrowane. Na podstawie tego typu mogą być wykonywane niektóre kontrole spójności. Jeżeli wprowadzona jest wartość w tym polu, można uaktywnić okno wyboru, które całkowicie uzależnione jest typu.

  • Wartość (pole FLDVAL)

Określa wartość pola, które ma być integrowane.

Domyślnie występuje wartość, która została wyszukana podczas importu i jest podświetlona przy użyciu określonego stylu, jeśli jest to uznawane za błędne. Przy użyciu tej funkcji można również dokonać modyfikacji.

Należy zauważyć, że podczas wprowadzania:

  • możliwy jest dostęp do funkcji wyboru (za pomocą kliknięcia prawym przyciskiem myszy) w powiązanych tabelach lub na liście menu lokalnych (w takim przypadku numer wyboru przesyłany jest zwrotnie),
  • istniejące tabele nie są wykonywane w powiązanej tabeli lub w menu lokalnym (uznaje się, że przedmiotowa tabela może być aktualizowana przy użyciu wstępnego importu): kontrola będzie wykonywana tylko w przypadku, gdy faktycznie dokonana zostanie aktualizacja).

Błędne pole jest ponownie wyświetlane w domyślnym stylu, ilekroć wprowadzanie zgodne z ograniczeniami formatu pola zostanie ukończone dla danej pozycji. Omawiana pozycja zostanie usunięta z listy błędów (nadal znajduje się ona w tabeli błędów, ale flaga wskazuje, że została ona skorygowana).

Zamknij

 

Karta Plik tekstowy (clob)

Prezentacja

Jeżeli w szablonie zdefiniowano pole typu clob (długi ciąg znaków), zakładka służy do wyświetlania jego wartości oraz zmieniania jej w razie potrzeby poprzez kliknięcie odpowiedniego przycisku.

Zamknij

 

Pola

Na tej karcie występują następujące pola :

Blok numer 1

  • Plik tekstowy (clob) (pole CLBINTIT)

Określa kod obiektu Clob.

  • Modyfikacja (pole CLBEXE)

Przycisk ten służy do przełączania się w tryb modyfikacji w przypadku tekstu (typu Clob), przedstawionego poniżej.

Blok numer 2

  • pole WA

 

  • pole FLDCLB

Pole typu Clob, ponieważ było ono zintegrowane w przestrzeni magazynowania import / eksport. Może być ono modyfikowane przy użyciu przycisku, który znajduje się w górnej części zakładki.

Zamknij

 

Raporty

Z funkcją domyślnie powiązane są następujące raporty :

 PRTSCR : Drukowanie ekranu

Można to zmienić w ustawieniach.

Przyciski określone

Służy do dodawania wiersza do grupy poprzez przesunięcie wszystkich kolejnych wierszy w rekordzie o 1. W dodanym wierszu domyślnie pojawiają się wartości znajdujące się w poprzednim wierszu, jednak istnieje możliwość ich zmiany. W przypadku anulowania operacji dodany wiersz zostaje usunięty, a przesuniętym wierszom nadane zostają nowe numery, żeby mogły one powrócić do położenia początkowego.

W oknie otwartym przez ten przycisk występują następujące pola :

Plik

  • Miejsce przeznacz. (pole TYPEXP)

 

  • Plik danych (pole NOMEXP)

Służy do określenia ścieżki pliku danych do którego uruchomiono eksport. W wypadku względnej ścieżki pliku zakłada się; że podstawową kartoteką będzie podstawowe oprogramowanie instalacyjne.

Istnieje możliwość zastąpienia meta-znaku # w nazwie eksportowanego pliku. W takim wypadku znak zostanie zastąpiony bieżącym numerem sekwencji eksportu, ponad 5 cyfr (poprzedzonych zerem, jeżeli wystąpi taka potrzeba), pod warunkiem uruchomienia eksportu chronologicznego.

Zamknij

Służy do ponownego wyeksportowania bieżącego wsadu danych do pliku o wskazanej nazwie.

W oknie otwartym przez ten przycisk występują następujące pola :

Blok numer 1

Określa szablon stosowany do importu, tzn. zarówno rodzaj danych do integracji, jak odpowiedni format prezentacji.

Uwaga, nie wszystkie szablony mogą być stosowane do importu (pole wyboru określa, który szablon może lub nie może być użyty).

Miejsce składowania

  • Miejsce przeznacz. (pole TYPEXP)

 

  • Plik danych (pole NOMIMP)

Służy do określenia ścieżki plik danych z której uruchomiony zostanie import. W wypadku względnej ścieżki do pliku zakłada się, że podstawowy katalog jest podstawowym oprogramowaniem instalacyjnym.

Istnieje możliwość umieszczenia meta-znaku # w nazwie pliku do importu. W takim wypadku import wszystkich plików odpowiadających nazwie pliku z liczbami, a zamiast #4 zostanie zrealizowany w sposób sekwencyjny, w wzrastającym porządku importu liczb. Umożliwia to automatyczny import plików, utworzonych przez funkcję eksportu chronologicznego przez importowanie danych w celu ich ekstrakcji.

Zamknij

Służy do importowania zawartości pliku do bufora. W przeciwieństwie do standardowej operacji importu, w przypadku której w schowku przechowywane są tylko te rekordy, w jakich wykryto błędy, ta funkcja pozwala zaimportować do bufora wszystkie rekordy z pliku. Tworzy nowy wsad danych.

Pasek menu

Usuwanie / Bieżąca partia

Służy do usuwania z bufora całego bieżącego wsadu danych. Do użytkownika wysyłane jest żądanie potwierdzenia operacji.

Usuwanie / Bieżący rekord

Służy do usuwania całego rekordu odpowiadającego bieżącemu wierszowi bufora poprzez ponowne ponumerowanie kolejnych wierszy rekordu, żeby w numeracji wierszy nie było luk.

Usuwanie / Bieżący wiersz

Służy do usuwania bieżącego wiersza rekordu w buforze poprzez ponowne ponumerowanie jego wierszy. Jeżeli pierwszy wiersz rekordu zostanie usunięty, usuwany jest cały rekord.

Przykład operacji wykonywanych na wierszach

Aby w pełni zrozumieć sposób wstawiania i dodawania wierszy przyjmijmy, że mamy dany prosty szablon, złożony z nagłówka (H) i kilku wierszy (L).

Rozważmy plik o następującej strukturze:

  • Rekord 1 = nagłówek, po którym następują dwa wiersze
  • Rekord 2 = nagłówek, po którym następują trzy wiersze
  • Rekord 3 = nagłówek, po którym następują trzy wiersze

Jeżeli wszystkie dane zostaną zaimportowane do bufora, to wynik operacji jest następujący (pierwszy wiersz w każdym rekordzie jest wytłuszczony):

Wiersz nr

Typ / nr wiersza

1

H 1

2

L 11

3

L12

4

H 2

5

L 21

6

L 22

7

L 23

8

H 3

9

L 31

10

L 32

11

L 33

Po przejściu do wiersza 5, jeżeli bieżący wiersz zostanie usunięty, sytuacja przedstawia się następująco (-- oznacza nieistniejące wiersze):

Wiersz nr

Typ / nr wiersza

1

H 1

2

L 11

3

L12

4

H 2

5

L 22

6

L 23

--

--

8

H 3

9

L 31

10

L 32

11

L 33

Wiersze 6 i 7 zostały skompresowane, żeby nie tworzyć luk w rekordzie, a numeracja kolejnych wierszy nie została zmieniona.

Po przejściu do wiersza 1, 2 lub 3 (pierwszy rekord), jeżeli bieżący rekord został usunięty, albo po przejściu do wiersza 1, jeżeli bieżący wiersz został usunięty, sytuacja jest następująca:

Wiersz nr

Typ / nr wiersza

 --

 --

 --

 --

 --

 --

4

H 2

5

L 22

6

L 23

 --

 

8

H 3

9

L 31

10

L 32

11

L 33

Wreszcie, po przejściu do wiersza 5, jeżeli dodano wiersz o nazwie NN, wynik jest następujący:

Wiersz nr

Typ / nr wiersza

-- 

 --

-- 

 --

--

 --

4

H 2

5

L 22

6

L NN

7

L 23

8

H 3

9

L 31

10

L 32

11

L 33

Jeżeli po wierszu NN dodano by kolejny wiersz o nazwie MM, przesunięcie wierszy rozprzestrzeniło by się do następnego rekordu w następujący sposób:

Wiersz nr

Typ / nr wiersza

-- 

 --

--

 --

-- 

 --

4

H 2

5

L 22

6

L NN

7

L MM

8

L 23

9

H 3

10

L 31

11

L 32

12

L 33

Komunikaty o błędzie

Jedynymi komunikatami o błędach są komunikaty ogólne.

Użyte tabele

SEEREFERTTO Odniesienie do dokumentacji Implementacja