Importy danych

Niniejszy dokument opisuje, w jaki sposób można wywołać aplikację Import danych z zadania przepływu pracy w przypadku udanego lub błędnego importu danych. W tej aplikacji można wyświetlić informacje o imporcie danych i otworzyć aplikację korygującą w przypadku nieprawidłowego importu danych.

Grupa docelowa

• Programiści
• Konsultanci techniczni

Definicje pojęć

• 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.
• Aplikacja korygująca – aplikacja korekty jest aplikacją dialogową używaną do interaktywnej edycji prostych plików błędów w Comarch ERP Enterprise. Dla jednostki biznesowej może istnieć jedna lub więcej aplikacji korygujących. Aplikacja korygująca jest aplikacją należącą do odpowiedniej jednostki biznesowej (np. aplikacja Partner 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, edytowane 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.

Wymagania wstępne

Można korzystać z aplikacji tylko wtedy, gdy zostanie wysłane powiadomienie o błędach importu za pośrednictwem przepływu pracy. Wymagana do tego definicja działania została opisana w dokumencie Wprowadzenie: Wymiana danych.

Opis aplikacji

Aplikacja Import danych służy do wyświetlania informacji o udanym lub błędnym imporcie danych. Informacje te są przekazywane do aktywności lub zadania przepływu pracy po zakończeniu procesu importu na podstawie zdarzenia com.cisag.pgm.bi.ImportRunCompleted przy użyciu definicji aktywności. Definicja aktywności cis.bis.ImportCompleted może służyć jako szablon dla własnych definicji aktywności. Tworzy ona działania lub zadania przepływu pracy, które są powiązane z aplikacją Import danych.

Jeśli otrzymano zadanie przepływu pracy dla procesu importu, można otworzyć aplikację Import danych za pomocą akcji [Otwórz] na zadaniu przepływu pracy w nagłówku (zakładka Wyszukaj zadania). Aplikacja prezentuj, który import danych jest zaangażowany i jaki jest wynik importu. W przypadku błędów importu można otworzyć aplikację korygującą określoną dla importu danych z aplikacji Import danych, w której można poprawić nieprawidłowe dane.

Należy pamiętać, że aplikację można otworzyć tylko z poziomu zadania przepływu pracy.

Aplikacja nie posiada nagłówka i składa się wyłącznie z obszaru roboczego.

Obszar roboczy

Obszar roboczy zawiera informacje o procesie i wyniku importu danych. Z wyjątkiem pola Popraw aplikację, wszystkie pola są nieaktywne. Opis pól:

• Jednostka biznesowa – jednostka biznesowa, dla którego zaimportowano dane.
• Plik źródłowy – plik, z którego odczytano dane do importu danych.
• Plik błędu – plik, w którym zapisano niepoprawne, niemożliwe do zaimportowania rekordy danych.

Jeśli nazwa pliku źródłowego jest wyświetlana jako plik błędu, błędy były tak poważne, że nie można było utworzyć pliku błędu.

• Start – czas rozpoczęcia procesu importowania.
• Koniec – czas zakończenia importu
• Liczba zaimportowanych obiektów – liczba obiektów, które zostały pomyślnie zaimportowane i nie wymagają korekty.
• Liczba obiektów, których nie można poprawić – liczba obiektów, które mają tak poważne błędy, że nie można ich poprawić w aplikacji korygującej. Jeśli w tym polu wyświetlana jest liczba większa niż 0, plik musi zostać skorygowany ręcznie, a otwarcie aplikacji korygującej jest nieaktywne.
• Liczba obiektów, które można skorygować – liczba obiektów, które można skorygować w aplikacji korygującej.
• Aplikacja korygująca – należy wybrać aplikację, która ma zostać otwarta po wykonaniu akcji [Wywołaj program korygujący] związanej z aplikacją w celu interaktywnego zaimportowania pliku błędu i skorygowania danych. Aplikacje dostępne do wyboru w tym miejscu zależą od zaimportowanej jednostki biznesowej.

Konfiguracja

Aplikacja Import danych nie wymaga dodatkowych ustawień w aplikacji Konfiguracja.

Uprawnienia

Comarch ERP Enterprise działa w oparciu o wielopoziomową koncepcję uprawnień. Zdolności i uprawnienia mogą być przypisywane na różnych poziomach, na przykład:

• Na poziomach obszarów systemu można przypisać uprawnienie umożliwiające otwarcie danej aplikacji
• Na poziomach jednostek biznesowych można przypisać uprawnienie umożliwiające wygenerowanie raportu. Uprawnienia związane z jednostkami mają zastosowanie do wszystkich aplikacji.

Dla niektórych aplikacji opracowano specjalne możliwości, które odnoszą się do określonych działań i funkcji. Uprawnienia mogą być również przypisane do tych możliwości. Na przykład, uprawnienie może być przypisane do specjalnej możliwości drukowania zamówienia.

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

Żadna jednostka biznesowa nie jest istotna dla definicji uprawnień w dla aplikacji Import danych.

Uprawnienia do odczytu i zapisu pliku błędu są wymagane dla aplikacji, jeśli plik błędu znajduje się w Knowledge Store.

Instrukcja: Korygowanie błędów importu za pomocą aplikacji Import danych

Wymagania wstępne

W obszarze nawigacji, na karcie Wyszukiwanie zadań, widoczne jest zadanie workflow dotyczące błędnego importu.

1. Należy dwukrotnie kliknąć zadanie w obszarze nawigacji. Aplikacja Import danych zostaje otwarta i wyświetla informacje o procesie importu. Jeżeli w tym procesie powstały obiekty możliwe do korekty i nie powstały obiekty niepodlegające korekcie, błędy można poprawić w aplikacji korekty.

-> Wybrać akcję [Otwórz plik błędów w aplikacji korygującej]. Pierwszy błędny obiekt zostaje otwarty w aplikacji korekty.

Należy skorygować błędne dane. Obsługa aplikacji korekty została opisana w dokumentacji Import danych.

Po skorygowaniu wszystkich błędów we wszystkich obiektach pliku błędów i gdy plik błędów nie jest już potrzebny, wrócić do aplikacji Import danych i usunąć plik błędów akcją [Usuń plik błędów].

2. Wybrać akcję [Otwórz plik błędu w aplikacji korygującej].

->Pierwszy błędny obiekt zostanie otwarty w aplikacji korygującej.

3. Należy poprawić nieprawidłowe dane. Działanie aplikacji korygujących opisano w dokumentacji Import danych.
4. Po poprawieniu wszystkich błędów we wszystkich obiektach w pliku błędu i gdy plik błędu nie jest już potrzebny, należy przełączyć się z powrotem do aplikacji Import danych i usunąć plik błędu za pomocą akcji [Usuń plik błędu].

Akcje związane z aplikacją

W aplikacji Import danych dostępne są następujące akcje związane z aplikacją:

Otwórz plik błędu w innym oknie

Można użyć tej akcji, aby otworzyć plik błędu w innym oknie lub zewnętrznej aplikacji. Wybór aplikacji zależy od tego, która aplikacja na komputerze klienckim jest powiązana z rozszerzeniem pliku „.xml”. Zazwyczaj jest to przeglądarka. Umożliwia to na przykład wyświetlenie komunikatów o błędach zapisanych w pliku błędów, co jest szczególnie pomocne w przypadku, gdy plik źródłowy zawiera błędy składniowe, ponieważ ten typ błędu uniemożliwia otwarcie aplikacji korygującej.

Otwórz plik błędu w aplikacji korygującej

Można użyć tej akcji, aby otworzyć plik błędu w aplikacji korygującej, jeśli plik błędu zawiera tylko rekordy danych, które można poprawić.

Usuń plik błędu

Można użyć tej akcji, aby usunąć plik błędu po odpowiednim potwierdzeniu.