Zapisy protokołu wymiany danych

Importy i eksporty danych z BIS mogą być rejestrowane. Aplikacja Zapisy protokołu wymiany danych pokazuje szczegóły importów i eksportów, które zostały przeprowadzone z aktywnym rejestrowaniem. Można przeglądać zarówno importy i eksporty już zakończone, jak i te, które nadal trwają.

Grupa docelowa

• Programiści
• Konsultanci techniczni

Definicja terminów

• Jednostka biznesowa — opis czynnika biznesowego, takiego jak pozycja, obejmującego wiele obiektów biznesowych. Praca z dużą liczbą obiektów biznesowych może być pracochłonna, dlatego zostały one podsumowane według określonych kryteriów. Dominujący, nadrzędny obiekt biznesowy ze zbioru obiektów biznesowych należących do grupy jest określany jako jednostka biznesowa. Jednostka biznesowa jest zatem czynnikiem biznesowym, który ułatwia korzystanie z obiektów biznesowych i reprezentuje je w sposób zorientowany na użytkownika. Element może być jednostką biznesową. W rzeczywistości składa się z wielu obiektów biznesowych, w tym jednego dla danych podstawowych, jednego dla danych sprzedaży oraz jednego dla danych zakupowych specyficznych dla dostawcy.
• Zapis protokołu wymiany danych — zapis protokołu wymiany danych wynika z importu lub eksportu z aktywowanym rejestrowaniem. Zawiera on proces importu lub eksportu (pierwsze uruchomienie). W przypadku nieprawidłowych importów może dodatkowo zawierać procesy korekty.
• Proces wymiany danych — proces wymiany danych obejmuje import pliku, eksport pliku, import pliku błędu w celu korekty lub użycie programu korygującego
• Filtr — model danych BIS dla jednostki biznesowej może być bardzo obszerny. Filtr stanowi fragment modelu danych BIS dla jednostki biznesowej. Określa, które obiekty, atrybuty i relacje jednostki biznesowej mają być brane pod uwagę podczas uruchamiania procesu importu i/lub eksportu.
• Plik błędu — dane pliku źródłowego zidentyfikowane jako nieprawidłowe są zapisywane w pliku błędów podczas importu danych w BIS. W zależności od rodzaju błędu, plik błędu może zostać poprawiony ręcznie i ponownie zaimportowany lub wczytany i przetworzony krok po kroku w programie korygującym.
• Program korygujący — program korygujący to aplikacja dialogowa, która służy do interaktywnej edycji prostych plików błędów w systemie. Dla jednej jednostki biznesowej może istnieć jeden lub więcej programów korygujących. Program korygujący jest aplikacją odnoszącą się do określonej jednostki biznesowej (takiej jak aplikacja Partnerzy dla jednostki biznesowej com.cisag.app.general.obj.Partner), która jest otwierana w trybie specjalnym. W tym trybie instancje jednostki biznesowej z pliku błędu mogą być otwierane indywidualnie, przetwarzane interaktywnie i zapisywane.
• Plik źródłowy — plik źródłowy to plik, który jest odczytywany podczas importowania danych do BIS. Plik źródłowy zawsze zawiera tylko dane dla jednej kategorii jednostek biznesowych. W przypadku niektórych typów plików dane do zaimportowania mogą być rozproszone w kilku plikach źródłowych. W takim przypadku jeden z tych plików źródłowych jest głównym plikiem źródłowym, a pozostałe są połączonymi plikami źródłowymi. Podczas procesu importu główny plik źródłowy i połączone pliki źródłowe są łączone w celu utworzenia nowego pliku, który jest używany do wykonania rzeczywistego importu. Wszelkie dane z pliku źródłowego, których nie można pomyślnie zaimportować, są zapisywane w pliku błędów wraz z powiązanymi komunikatami o błędach.
• Sesja — sesja to obszar pamięci zarezerwowany podczas logowania użytkownika, czyli podczas uruchamiania usługi systemowej. Obiekty tworzone w ramach sesji są przechowywane oddzielnie od obiektów w innych sesjach. Umożliwia to pracę wielu użytkowników. Wątek jest rezerwowany, jeśli fragment logiki programu będzie wykonywany w ramach sesji. Sesja jest przypisywana do wątku jako obszar roboczy na czas wykonywania.

Opis aplikacji

Aplikacja Zapisy protokołu wymiany danych pokazuje szczegóły importów i eksportów, które zostały uruchomione z aktywnym rejestrowaniem. Dla każdego z tych importów i eksportów wygenerowano wpis do protokołu. Ta aplikacja może wyświetlać listę zaimportowanych i/lub wyeksportowanych obiektów, jak również wszelkie dostarczone komunikaty. Ponadto aplikacja oferuje opcje korygowania błędów importu. W ten sposób procesy importu, które poszły źle, mogą zostać powtórzone. Alternatywnie, możliwe jest otwarcie dedykowanego programu korygującego.

Nagłówek

Nagłówek zawiera ogólne informacje o wpisie protokołu wymiany danych.

• Data utworzenia — data wygenerowania wpisu protokołu
• Ogólny status — status wpisu protokołu wymiany danych wskazuje postęp importu, eksportu i ewentualnych korekt.
  Możliwe wartości to:
  • W opracowaniu — operacja jest obecnie przetwarzana
  • W opracowaniu (korekta) — operacja korekty jest w trakcie przetwarzania
  • W opracowaniu (program korygujący) — operacja jest obecnie przetwarzana w aplikacji korekty dla wpisu protokołu wymiany danych
  • Skutecznie — wszystkie obiekty zostały wyeksportowane, zaimportowane i/lub skorygowane
  • Błędnie — wystąpiły błędy. Różne błędy można rozróżnić na podstawie statusu ostatniego uruchomienia.
  • Zamknięte ręcznie — oznaczenie wpisów protokołu wymiany danych, które nie będą już przetwarzane
• Jednostka biznesowa — nazwa techniczna jednostki biznesowej
• Kierunek — kierunek wymiany danych, który został zarejestrowany. Możliwe wartości to:
  • Eksport
  • Import
• Filtr — filtr użyty podczas wymiany danych
• Plik źródłowy — URI oryginalnego pliku (plik źródłowy dla importu, plik docelowy dla eksportu).
  Uwaga

  Możliwe, że plik oznaczony przez URI już nie istnieje lub ma inną zawartość.

• Typ sesji — typ sesji, w której wykonano pierwsze uruchomienie.
  Możliwe wartości to:
  • Inicjalizacja
  • System
  • Dostęp do Workflow
  • Przetwarzanie w tle
  • Toolshell
  • Zdalny dostęp
  • Dostęp dialogowy
  • Dostęp ODBC
  • Dostęp do serwera ODBC
  • Dostęp do Knowledge Store
  • Dostęp do zasobów
  • Dostęp CORBA
  • Dostęp DSOAP
• Liczba obiektów (1 operacja) — suma obiektów w pierwszym uruchomieniu
• Obiekty pomyślnie wyeksportowane — liczba obiektów, które zostały pomyślnie zaimportowane i/lub wyeksportowane dla wpisu dziennika wymiany danych. Jeśli dokonano już korekty nieprawidłowego importu, uwzględniane są wszystkie obiekty pomyślnie zaimportowane w procesie korekty.

Obszar robocyze

W obszarze roboczym wyświetlane są informacje o ostatnim uruchomieniu wykonanym dla wpisu protokołu wymiany danych. Jeśli proces jest oznaczony jako pierwsze uruchomienie, jest to sam eksport lub import i nie przeprowadzono żadnych korekt w przypadku importu. W przeciwnym razie jest to ostatnia korekta dla wyświetlanego wpisu dziennika wymiany danych.

Sekcja Ostatnia operacja

• [Wyświetl komunikaty] — przycisk wyświetla komunikaty procesu, które nie są przypisane do żadnego obiektu. Powiadomienia są wyświetlane w zakładce Wiadomości.
• [Informacje o ochronie danych] — przycisk otwiera okno Informacje o ochronie danych. Pełny opis pól zawartych w tym oknie można znaleźć w akapicie Przycisk informacji o ochronie danych.

Pola w sekcji Ostatnia operacja:

• Typ — określa typ procesu.
  Możliwe wartości to
  • Operacja źródłowa
  • Import korekt
  • Korekta w aplikacji
• Status — wynik procesu.
  Możliwe wartości to:
  • W opracowaniu
  • Zakończone pomyślnie
  • Zakończone z błędami
  • Przerwane przez aplikację
  • Przerwane przez użytkownika
  • Przerwane przez system
• Czas zakończenia — czas zakończenia procesu
• Liczba obiektów — całkowita liczba obiektów w ostatnim uruchomieniu
• Instancje pomyślne — pole wskazuje liczbę obiektów, które zostały pomyślnie zaimportowane i/lub wyeksportowane i nie wymagają korekty
• Błędne obiekty — pole wskazuje liczbę obiektów, które nie zostały pomyślnie zaimportowane i/lub wyeksportowane
• Błędne obiekty (korekta tylko przez import) — pole wskazuje liczbę nieprawidłowych obiektów z procesu importu lub korekty, które mogą zostać skorygowane jedynie za pomocą importu korekty, a nie aplikacji korygującej. Ta informacja nie dotyczy eksportu.

Sekcja Instancje ostatniej operacji

Lista Instancje ostatniej operacji pokazuje obiekty, które zostały wyeksportowane lub zaimportowane.

Lista zawiera pasek narzędzi z następującymi przyciskami:

• [Sortuj] — określa sortowanie zaimportowanych i/lub wyeksportowanych wystąpień jednostki biznesowej
• [Wyświetl komunikaty] — wyświetla tylko błędne obiekty na liście
• [Tylko błędne] — wyświetla komunikaty dla wybranego obiektu w zakładce Komunikaty w oknie nawigacji, o ile komunikaty są dostępne. W przypadku nieprawidłowych importów system wyświetla komunikaty o błędach związane z obiektem.

Lista zawiera następujące kolumny:

• Numer — numer obiektu w pliku źródłowym lub docelowym
• Identyfikator — identyfikator importowanego i/lub eksportowanego obiektu, o ile jest dostępny. Identyfikator może różnić się od tego wyświetlanego w innych aplikacjach.
• Identyfikator w systemie zewnętrznym — identyfikator w systemie zewnętrznym
• Status — status obiektu przy ostatnim procesie.
  Możliwe wartości to:
  • W opracowaniu
  • Skutecznie
  • Błąd
  • Błąd (nie do poprawienia)
  • Wykluczony z korekty

Przycisk [Informacje o ochronie danych]

Klikając przycisk [Informacje o ochronie danych], można wyświetlić wszystkie chronione atrybuty wyeksportowane w ramach procesu. Informacje te mogą posłużyć jako dowód ochrony danych.

Okno Informacje o ochronie danych zawiera następujące pola:

• Odbiorca danych — wskazuje, dla kogo przeznaczone są eksportowane dane, jeśli zostało to określone podczas eksportu danych
• Cel — wskazuje cel, dla którego dane zostały wyeksportowane, jeśli zostało to określone przy eksporcie danych
• OQL Filter Statment — pokazuje instrukcję OQL filtra eksportu

Sekcja Używane chronione pola

• Nazwa atrybutu — zawiera techniczne nazwy atrybutów, które zostały wyeksportowane i są identyfikowane jako chronione na podstawie ich przypisania do kategorii ochrony danych oraz definicji w rolach uprawnień

To, które atrybuty są chronione, jest definiowane w aplikacji Role uprawnień na podstawie kategorii ochrony danych. Aby uzyskać więcej informacji, należy zapoznać się z artykułem Kategorie ochrony danych, Przyporządkowania kategorii ochrony danych oraz Role uprawnień.

Akcje oparte na innych aplikacjach

W aplikacji Zapisy protokołu wymiany danych dostępne są następujące akcje oparte na aplikacjach:

• Akcja [Importuj edytowany plik błędu]
• Akcja [Importuj niezmieniony plik błędu]
• Akcja [Wywołanie programu korygującego]
• Akcja [Pobieranie plików]
• Akcja [Ustaw status na 'Zamknięte ręcznie’]
• Akcja [Zlecenie przetwarzania]
• Ręczny ponowny import pliku błędów

Akcja [Importuj edytowany plik błędu]

Ta akcja uruchamia import określonego pliku błędów i umożliwia zaimportowanie nieprawidłowych obiektów po poprawieniu błędów w pliku błędów.

Po wybraniu tej akcji otwiera się okno dialogowe, w którym można zdefiniować ustawienia ponownego importu. Import zostaje uruchomiony natychmiast lub jako zlecenie przetwarzania. Okno dialogowe jest podzielone na dwie zakładki.

Okno dialogowe zawiera następujące pole:

• Importuj plik błędu — określa plik błędu, z którego dane mają zostać zaimportowane w celu korekty. Należy wprowadzić pełną ścieżkę do pliku, używając schematu file:/// lub kstore://.

Po wybraniu przycisku [Natychmiast] lub [W tle] aplikacja działająca w tle Ponowny import pliku błędów (wymiana danych) uruchamia import korekty.

Akcja [Importuj niezmieniony plik błędu]

a akcja inicjuje import pliku błędu wymienionego w protokole wymiany danych. Dzięki temu mogą zostać zaimportowane obiekty, których wcześniej nie można było pomyślnie zaimportować po skorygowaniu brakujących lub nieprawidłowych danych.

Akcja może zostać wykonana również dla kilku nieprawidłowych wpisów protokołu wymiany danych jednocześnie. Po jej wybraniu otwiera się okno dialogowe, w którym można rozpocząć import korekty.

Akcja [Otwórz aplikację korygującą]

Ta akcja umożliwia skorygowanie nieprawidłowych obiektów, których nie można było do tej pory zaimportować za pomocą programu korygującego. Niektórych błędów nie można skorygować w programach korygujących.

Po wybraniu tej akcji otwiera się okno dialogowe Wywołaj program korygujący, zawierające następujące pole:

• Program korygujący — określa program, który ma być używany do korygowania niepoprawnych danych zapisanych w protokole wymiany danych. To, czy można wybrać jeden czy wiele programów korygujących, zależy od jednostki biznesowej.

Po potwierdzeniu okna dialogowego uruchamiany jest program korygujący. Sposób korzystania z programów korygujących został opisany w artykule Import danych.

Akcja [Pobieranie plików]

Akcja [Pobieranie plików] umożliwia pobranie plików wpisu protokołu dostępnych w odpowiednim dzienniku do Knowledge Store lub lokalnego systemu plików. Pliki importu i błędów są dostępne dla nieprawidłowych importów, pod warunkiem że import nie został przedwcześnie anulowany.

Po zainicjowaniu akcji otwiera się okno dialogowe, w którym można określić lokalizację zapisu pobranych plików.

Okno dialogowe zawiera następujące pole:

• Folder — określa lokalizację, w której będą przechowywane pliki. Należy wprowadzić pełną ścieżkę folderu, używając schematu file:/// lub kstore://.

Pobrany plik źródłowy lub docelowy zachowuje oryginalną nazwę pliku. Pobrany plik błędu otrzymuje rozszerzenie .error.xml i jest zawsze dostarczany w formacie XML. Jeśli folder zawiera już pliki o tej samej nazwie, kolejne pobrane pliki zostają ponumerowane.

Akcja [Ustaw status na 'Zamknięty ręcznie’]

Ta akcja powoduje oznaczenie wybranego wpisu protokołu wymiany danych informacją, że nie są wymagane żadne dalsze działania.

Akcja [Zlecenia przetwarzania]

Akcja ta otwiera aplikację Zlecenia przetwarzania i pokazuje zlecenie przetwarzania, które wykonało ostatni proces importu, eksportu lub korekty wpisu protokołu wymiany danych.

Jeśli proces nie został wykonany w tle, zlecenie przetwarzania nie zostanie otwarte.

Konfiguracja

Aplikacja Zapisy protokołu wymiany danych nie wymaga dodatkowych ustawień w aplikacji Konfiguracja.

Jednostki biznesowe

Jednostka biznesowa Wpis protokołu wymiany danych:
com.cisag.sys.tools.bi.obj.ProcessProtocolEntry — wykorzystywana jest przez aplikację Zapisy protokołu wymiany danych między innymi w celu:

• Przyporządkowywania uprawnień
• Konfigurowania definicji działań
• Importu i eksportu danych

Uprawnienia

Uprawnienia mogą zostać przypisane za pomocą ról uprawnień jak również poprzez przyporządkowanie organizacji. Szczegółowe informacje można znaleźć w artykule Uprawnienia.

Uprawnienia specjalne

Dla aplikacji Zapisy protokołu wymiany danych nie ma dostępnych uprawnień specjalnych.

Przyporządkowania organizacji

Dla aplikacji Zapisy protokołu wymiany danych nie są wymagane przyporządkowania organizacji.

Funkcje specjalne

Dla aplikacji Zapisy protokołu wymiany danych nie są dostępne funkcje specjalne.

Uprawnienia dla partnerów biznesowych

Aplikacja Zapisy protokołu wymiany danych nie jest udostępniana partnerom biznesowym.

Import korekty z edytowanym plikiem błędów

Warunek wstępny

Wpis dziennika został otwarty w aplikacji Zapis protokołu wymiany danych, prezentując nieprawidłowy import. Błąd musi zostać skorygowany poprzez zmianę pliku błędu.

Instrukcja

1. Wybierz akcję [Pobieranie plików].
   • Otwarte zostanie okno dialogowe Pobieranie plików.
2. Należy określić folder w Knowledge Store, w którym mają zostać zapisane pliki i potwierdzić dane w oknie dialogowym.
   • Pliki zostaną zapisane we wskazanym katalogu. Pobrany plik błędu ma rozszerzenie .error.xml.
3. Należy poprawić błędy w pliku błędów i zapisać go w miejscu (Knowledge Store lub, odpowiednio, w systemie plików), w którym system ERP może uzyskać dostęp do pliku.
4. Następnie należy wybrać opcję [Ręczny ponowny import pliku błędów] na standardowym pasku narzędzi.
5. Określić poprawiony plik błędu w polu Plik błędów importu.
6. Następnie wprowadzić żądane wartości w polach zakładki Ustawienia tła. Aby uzyskać więcej informacji na temat tych pól, należy zapoznać się z Instrukcją obsługi.
7. Ostatnim krokiem jest wybranie opcji [W tle].
   • System utworzy zlecenie przetwarzania, które zostanie przetworzone zgodnie z ustawieniami tła. Po zakończeniu zlecenia przetwarzania przez system możesz wyświetlić wynik w protokole wymiany danych. W tym celu konieczne może być ponowne odświeżenie ekranu w aplikacji poprzez kliknięcie przycisku [Aktualizuj] na standardowym pasku narzędzi.