Lista: Zapisy protokołu wymiany danych

Import i eksport danych z BIS może być rejestrowany. Aplikacja Lista: Zapisy protokołu wymiany danych oferuje przegląd importów i eksportów wykonanych z aktywnym rejestrowaniem. Można przeglądać zarówno importy lub eksporty już zakończone, jak i te, które nadal trwają.

Grupa docelowa

• Programiści
• Konsultanci techniczni

Definicje pojęć

• 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.
• Plik docelowy — plik utworzony podczas eksportu danych w BIS

Opis aplikacji

Aplikacja Lista: Zapisy protokołu wymiany danych oferuje przegląd importów i eksportów wykonanych z aktywnym rejestrowaniem. Dla każdego z tych importów i eksportów generowany jest wpis protokołu. Są różne możliwości zawężenia listy wpisów protokołu, np. poprzez filtrowanie tekstów komunikatów dotyczących nieprawidłowych importów. Jako konfigurowalna aplikacja typu lista, aplikacja może być również dostosowana do potrzeb użytkowników.

Jeśli import jest nieprawidłowy, można zainicjować jego korektę. Procesy korekty są wyświetlane w tym samym wpisie protokołu wymiany danych. Określone kolumny listy zawsze odnoszą się do ostatniego wykonanego procesu. Jeśli nie wprowadzono poprawek, procesem tym jest import. W przeciwnym razie jest to ostatni proces korekty.

Dalsze szczegóły dotyczące zapisów protokołu wymiany danych, które nie są wyświetlane w tej aplikacji, są dostępne w aplikacji Zapisy protokołu wymiany danych.

Nagłówek i obszar roboczy

Nagłówek zawiera pola zapytań. Najważniejsze pola zapytań są zwykle dostępne od początku, jednak liczba pól zapytań i ich rozmieszczenie mogą się różnić.

Nagłówek jest taki sam dla wszystkich widoków obszaru roboczego. Można określić, które pola zapytań mają być wyświetlane.

Obszar roboczy aplikacji Lista: Zapisy protokołu wymiany danych pokazuje listę wyników zawierającą wszystkie wpisy protokołu wymiany danych, o które zapytano. Można więc zdecydować, które informacje mają być wyświetlane dla zapisu protokołu.

Widoki obszaru roboczego

Można utworzyć wiele widoków, aby wyświetlić wpis protokołu na różne sposoby i z różnymi informacjami. Dostępne są następujące widoki:

• Przegląd — pokazuje najważniejsze właściwości wpisu protokołu w wierszu
• Liczba instancji — oprócz przeglądu ten widok pokazuje, ile obiektów zostało przetworzonych dla zapisu protokołu wymiany danych i/lub w ostatnim uruchomieniu
• Pełny przegląd — pokazuje szczegółowe informacje na temat wpisu protokołu i jego ostatniego procesu. Takie informacje obejmują między innymi zastosowane filtry, użytkownika i URI oryginalnego pliku.
• Okresy ważności — wskazuje czas rozpoczęcia i zakończenia ostatniego uruchomienia zapisu protokołu, a także czas jego trwania

Przyciski w obszarze roboczym

Dodatkowo, pasek narzędzi nad listą w obszarze roboczym udostępnia następujące przyciski do przeglądania szczegółów wpisu protokołu lub otwierania zleceń przetwarzania:

• Zlecenie przetwarzania — otwiera aplikację Zlecenia przetwarzania i pokazuje zlecenie przetwarzania, które wykonało ostatni proces importu, eksportu lub korekty zapisu protokołu wymiany danych. Jeśli proces nie został wykonany w tle, zlecenie przetwarzania nie zostanie otwarte.
• Zapis protokołu wymiany danych — otwiera aplikację Zapisy protokołu wymiany danych i wyświetla szczegóły zapisu protokołu. Szczegóły obejmują ostatnie uruchomienie wpisu protokołu, w tym wszystkie przetworzone obiekty i utworzone komunikaty.

Pola zapytań i kolumny listy

Wszystkie niezbędne pola zapytań i/lub kolumny listy są określone poniżej.

Jeśli kolumny listy i/lub pola zapytań wyświetlają informacje z procesu wymiany danych, informacje te zawsze odnoszą się do ostatniego uruchomienia protokołu wymiany danych.

• Kierunek — kierunek wymiany danych. Możliwe wartości to:
  • Import
  • Eksport
• Oznaczenie jednostki biznesowej — to pole nie może być używane jako pole zapytania
• Jednostka biznesowa — nazwa techniczna jednostki biznesowej, np. com.cisag.app.genral.obj.Item
• Data utworzenia — czas wygenerowania zapisu protokołu
• Data i godzina ostatniej zmiany — data i godzina ostatniej zmiany wpisu protokołu
• Typ sesji — kategoria sesji, w której wykonano pierwsze uruchomienie. Typ sesji jest definiowany podczas generowania sesji i nie można go później zmienić. Na podstawie kategorii sesji, sesje mogą być przypisane do różnych kanałów dostępu w systemie ERP.
  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
• Ogólny status — status wpisu protokołu. Ogólny status wpisu protokołu wymiany danych wskazuje postęp importu, eksportu i poprawek (jeśli istnieją).
  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
• Wszystkie obiekty (pierwsze uruchomienie) — całkowita liczba instancji przetworzonych w pierwszym uruchomieniu.
• Obiekty pomyślnie zaimportowane/wyeksportowane — liczba obiektów, które zostały pomyślnie zaimportowane i/lub wyeksportowane dla zapisu protokołu wymiany danych. Jeśli dokonano już korekt dla niepoprawnych importów, uwzględniane są wszystkie obiekty pomyślnie zaimportowane w procesie korekty.
• Liczba obiektów — całkowita liczba obiektów przetworzonych podczas wymiany danych
• Błędne obiekty — liczba obiektów, które nie zostały pomyślnie zaimportowane i/lub wyeksportowane podczas procesu wymiany danych, niezależnie od możliwości korekty
• Błędne obiekty (korekta tylko przez import) — liczba nieprawidłowych obiektów z procesu importu lub korekty, które można skorygować tylko za pomocą importu korekty, a nie za pomocą aplikacji korygującej. Ta informacja nie dotyczy eksportu.
• Rodzaj (ostatnia operacja) — kategoria ostatniej operacji dla zapisu protokołu wymiany danych. Możliwe wartości to:
  • Operacja źródłowa
  • Import korekt
  • Korekta w aplikacji
• Status — status ostatniego uruchomienia dla wpisu protokołu wymiany danych.
  Możliwe wartości to
  • W opracowaniu
  • Zakończone pomyślnie
  • Zakończone z błędami
  • Przerwane przez aplikację — proces został przerwany z powodu błędu w aplikacji
  • Przerwane przez użytkownika — proces został przerwany na żądanie użytkownika
  • Przerwane przez system — proces został przerwany z powodu awarii systemu
• Nazwa filtra — nazwa filtra używanego do importu lub eksportu. To pole może być używane tylko w obszarze wyświetlania.
• Filtr — identyfikacja filtra używanego do importu lub eksportu
• Odpowiedzialny użytkownik — nazwa użytkownika, który rozpoczął wymianę danych
• Teksty komunikatów o błędach importu — w razie potrzeby można użyć tego pola, aby wprowadzić krótki lub długi tekst komunikatu w języku wyświetlania w celu wybrania wpisów protokołu wymiany danych, w których krótki lub długi tekst komunikatu pojawia się w ostatniej operacji. Parametry komunikatów zostały już zastąpione i mogą być również używane. System wyszukuje komunikaty związane z obiektami. To pole może być użyte tylko w nagłówku.
• Plik źródłowy — URI oryginalnego pliku (plik źródłowy dla importu, plik docelowy dla eksportu). Jest puste, jeśli nazwa pliku jest nieznana (do wywołania przez CORBA lub usługi sieciowe).
  
  Uwaga

  Możliwe, że plik oznaczony przez URI już nie istnieje lub ma inną zawartość.
  
  
• Godzina rozpoczęcia — czas rozpoczęcia procesu wymiany danych
• Czas zakończenia — czas zakończenia procesu wymiany danych
• Czas trwania przebiegu — czas wykonania procesu wymiany danych
• Korekty — liczba korekt rozpoczętych do tej pory dla wpisu protokołu wymiany danych

Działania związane z aplikacją

Następujące akcje związane z aplikacją są dostępne za pomocą przycisku akcji na standardowym pasku narzędzi aplikacji Zapisy protokołu wymiany danych.

• • Akcja [Ręczny ponowny import pliku błędów]
  • Akcja [Importuj niezmieniony plik błędu]
  • Akcja [Wywołanie programu korygującego]
  • Akcja [Zamknij wpis protokołu]
  • Akcja [Porównanie protokołu]

Akcja [Ręczny ponowny import pliku błędów]

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

Po wybraniu tej akcji otworzy się okno dialogowe, w którym można zdefiniować ustawienia ponownego importu, który zostanie uruchomiony natychmiast lub jako zlecenie przetwarzania. Okno dialogowe jest podzielone na dwie zakładki.
Okno dialogowe zawiera następujące pola specyficzne dla aplikacji:

Objaśnienie pola

• Plik błędów importu — 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://.

Akcja [Importuj niezmieniony plik błędu]

Ta 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 [Wywołanie programu korygującego]

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 [Zamknij wpis protokołu]

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

Akcja [Porównanie protokołu]

Ta akcja umożliwia odświeżenie stanu wpisów protokołu, dla których dostępne są anulowane zlecenia przetwarzania lub anulowane zostały programy korygujące. Należy użyć tej akcji, gdy wpisy protokołu mają łączny status W opracowaniu, W opracowaniu (korekta) lub W opracowaniu (program korygujący), ale odpowiadające im procesy zostały w rzeczywistości anulowane.

Konfiguracja

Aplikacja Lista: 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ę Lista: 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 Lista: Zapisy protokołu wymiany danych nie ma dostępnych uprawnień specjalnych.

Przyporządkowania organizacji

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

Funkcje specjalne

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

Uprawnienia dla partnerów biznesowych

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

Instrukcje

Poniżej znajdują się informacje na temat pracy z aplikacją Lista: Zapisy protokołu wymiany danych.

• Import korekty z edytowanym plikiem błędu
• Korekta w programie korygującym
• Otworzenie zapisu protokołu wymiany danych

Import korekty z edytowanym plikiem błędu

Warunek wstępny

Błędy w pliku zostały poprawione i teraz mają zostać zaimportowane obiekty, które do tej pory nie mogły zostać poprawnie zaimportowane.

Instrukcje

1. Należy otworzyć aplikację Zapisy protokołu wymiany danych.
2. Wprowadzić odpowiednie kryteria wyszukiwania w polach wyszukiwania.
3. Kliknąć przycisk [Aktualizuj] na standardowym pasku przycisków.

Aplikacja wyświetli wpisy wymiany danych odpowiadające kryteriom wyszukiwania w panelu roboczym.

4. Wybrać z listy wpis wymiany danych, dla którego ma zostać ponownie zaimportować plik er-ror.
5. Wybrać opcję [Ręczny ponowny import pliku błędów] na standardowym pasku narzędzi.
6. Wprowadzić pełną ścieżkę do pliku, używając schematu „file:///” lub „kstore://” w polu Plik błędów importu.
7. Wprowadzić żądane wartości w polach zakładki Ustawienia. Aby uzyskać więcej informacji na temat tych pól, należy zapoznać się z Instrukcją obsługi.
8. Wybrać opcję [W tle].

System utworzy zadanie w tle, które będzie przetwarzane zgodnie z ustawieniami w tle.

Korekta w aplikacji korygującej

Instrukcje

1. Otworzyć aplikację Lista: Zapisy protokołu wymiany danych.
2. Wprowadzić odpowiednie kryteria wyszukiwania w polach wyszukiwania.
3. Kliknąć przycisk [Aktualizuj] na standardowym pasku przycisków.

Aplikacja wyświetli wpisy wymiany danych odpowiadające kryteriom wyszukiwania w panelu roboczym.

4. Wybrać z listy wpis wymiany danych, dla którego ma zostać otworzona aplikację korekty.
5. Wybrać [Wywołanie programu korygującego] na standardowym pasku przycisków.
6. Jeśli dostępnych jest kilka aplikacji korygujących, należy wybrać żądaną aplikację korygującą w polu Program korygujący i potwierdzić, klikając przycisk [OK].

Otworzy się wybrana aplikacja korekty.

Otworzenie zapisu protokołu wymiany danych

W aplikacji Zapisy protokołu wymiany danych użytkownicy mogą przeglądać szczegóły dotyczące poszczególnych wpisów dziennika. Szczegóły te obejmują proces przeprowadzony ostatnio dla wpisu dziennika, a także instancje w nim przetwarzane. Jeśli podczas importowania tych instancji wystąpiły błędy, użytkownicy mogą również wyświetlić odpowiednie komunikaty o błędach.

Instrukcje

1. Otworzyć aplikację Lista: Zapisy protokołu wymiany danych.
2. Wprowadzić kryteria wyszukiwania w polach wyszukiwania.
3. Kliknąć przycisk [Aktualizuj].

System wyświetli wpisy dziennika wymiany danych w okienku roboczym.

4. Wybrać jeden z wierszy i kliknij przycisk  na pasku narzędzi listy.

System przełączy się do aplikacji Zapisy protokołu wymiany danych i wyświetli informacje o wybranym wpisie dziennika wymiany danych w okienku identyfikacji i okienku roboczym.