Eksport uproszczony

Za pomocą usługi Business Integration Service (BIS) można eksportować dane z baz danych i importować je do innych baz. Wyeksportowane dane są zapisywane w Knowledge Store jako pliki i odczytywane stamtąd podczas importu. Dostępne typy plików to XML, CSV i XLS. Zalecane jest korzystanie z XML, ponieważ dane o dowolnej złożoności można zapisać w jednym pliku, schemat pliku można określić i sprawdzić, a zmiany w modelu danych można łatwo zintegrować.

Aplikacja Eksport uproszczony umożliwia indywidualny eksport danych. Eksport danych zawsze odnosi się do obiektu deweloperskiego typu Aplikacja. W przypadku tej aplikacji typ Uproszczona wymiana danych i szczególne zastosowanie Eksport muszą być zdefiniowane w aplikacji Obiekty deweloperskie.

Liczbę instancji obiektów biznesowych do wyeksportowania można zdefiniować za pomocą wyszukiwania.

Należy pamiętać, że pliki dla uproszczonego eksportu i pliki dla pełnego eksportu są różne. Można użyć tylko plików dla wybranego procesu importu.

Definicje terminów

• Rozszerzalny język znaczników (XML) — XML może być używany do zapisywania ustrukturyzowanych danych w pliku tekstowym. Język opisu umożliwia definiowanie, przesyłanie, sprawdzanie i interpretowanie danych między aplikacjami i jest szczególnie odpowiedni do wymiany danych strukturalnych. Dokumenty XML oddzielają treść, strukturę i informacje do wizualizacji. XML jest koordynowany i zdefiniowany jako standard przez W3C.
• Rozszerzalne transformacje języka arkuszy stylów (XSLT) — XSLT to język programowania służący do przekształcania dokumentów XML. XSLT opiera się na logicznej strukturze drzewa dokumentu XML i służy do definiowania reguł transformacji. Opisuje on konwersję dokumentu XML na inny dokument.
• Tekst oddzielony separatorami (CSV) — CSV to typ pliku, w którym wartości poszczególnych kolumn są oddzielone separatorem. Wiersze są oddzielone podziałami wierszy. Separator ten musi być znany w celu zaimportowania pliku. Typowymi separatorami są na przykład pojedynczy przecinek i średnik. Dane zapisane w tym formacie mogą być używane i edytowane w wielu aplikacjach. Ze względu na prostą, niehierarchiczną strukturę CSV, ten typ pliku nie nadaje się do mapowania złożonych struktur danych.
• Unicode — Comarch ERP Enterprise korzysta z Unicode. Oznacza to, że wszystkie znaki używane na całym świecie mogą być używane i drukowane na formularzach. Zanim Unicode stał się dostępny, wiele różnych systemów kodowania było wymaganych do reprezentacji znaków. Żaden z tych systemów kodowania nigdy nie zawierał wystarczającej liczby znaków. W samej Unii Europejskiej do reprezentowania różnych języków państw członkowskich potrzebnych było kilka systemów kodowania. Dzięki zastosowaniu Unicode, Comarch ERP Enterprise może być używany bezpośrednio w wielu systemach. Różne kraje i języki nie stanowią problemu. Specjalne i złożone adaptacje nie są konieczne, ponieważ tekst może być wymieniany na całym świecie za pomocą Unicode bez utraty informacji, ponieważ Unicode nadaje każdemu znakowi własny numer – niezależny od platformy, niezależny od programu, niezależny od języka.
• Tekst Unicode oddzielony tabulatorem — ten typ pliku jest podobny do CSV, ale znak tabulacji jest używany jako separator, a Unicode jako kodowanie znaków. Pliki w tym formacie mogą być używane między innymi przez program Microsoft Excel. Aby zapisać ten typ pliku w programie Excel, należy określić typ pliku o tej samej nazwie w programie Excel.
• Konsorcjum World Wide Web (W3C) — Konsorcjum World Wide Web zostało założone, aby otworzyć wszystkie możliwości sieci. W tym celu opracowywane są znormalizowane technologie (specyfikacje, wytyczne, oprogramowanie i narzędzia), aby promować postęp sieci i zapewnić jej interoperacyjność.
• Schemat XML (XSD) — schemat XML (definicja schematu XML, XSD) to formalna specyfikacja reguł dokumentu XML, która wskazuje, które elementy są dozwolone w dokumencie i w jakich kombinacjach.

Opis aplikacji

Aplikacja Eksport uproszczony służy do eksportowania danych w prosty sposób. Aby to zrobić, należy najpierw zapytać o dane, zredukować wynik zapytania do określonych instancji obiektów biznesowych, a następnie je wyeksportować.

Do eksportu wymagana jest aplikacja typu Uproszczona wymiana danych ze szczególnym zastosowaniem Eksport. Aplikacja ta odwołuje się do klasy kontrolera Java, w której zdefiniowana jest zewnętrzna struktura obiektu. Definiuje ona obiekt biznesowy, który ma zostać wyeksportowany oraz wybór atrybutów, które mają zostać wyeksportowane.

Aplikacja Eksport uproszczony składa się z nagłówka i obszaru roboczego.

Nagłówek

W nagłówku aplikacji należy wybrać aplikację typu Uproszczona wymiana danych ze szczególnym zastosowaniem Eksport.

Nagłówek aplikacji składa się z następujących pól:

• Uproszczony eksport danych — w tym polu należy wprowadzić nazwę obiektu deweloperskiego aplikacji, która ma zostać wykorzystana do eksportu obiektów zewnętrznych. Uproszczona wymiana danych ze szczególnym zastosowaniem Eksport muszą być zdefiniowane dla tej aplikacji.
• Oznaczenie — w tym polu wyświetlana jest nazwa obiektu zewnętrznego, który został zdefiniowany w wybranej aplikacji do uproszczonej wymiany danych (importu/eksportu)
• Jednostka biznesowa — to pole wyświetla w pełni kwalifikowaną nazwę jednostki biznesowej, do której odwołuje się obiekt zewnętrzny
• Baza danych — baza danych, z której eksportowana jest jednostka biznesowa
• Ustawienie języka — atrybuty wielojęzyczne mogą być eksportowane tylko w jednym języku w ramach uproszczonego eksportu danych. Dlatego w tym polu zawsze wyświetlana jest wartość Jeden język.

• Format czasu — to pole pokazuje, w jaki sposób atrybuty czasu są serializowane. Więcej informacji na ten temat można znaleźć w artykule Wprowadzenie: Wymiana danych. Wyświetlane mogą być następujące wpisy:
  • Forma kompaktowa
  • Forma znormalizowana

Obszar roboczy

W obszarze roboczym definiowane jest, które instancje obiektów biznesowych mają zostać wyeksportowane.

Zakładka Ograniczenie

Na tej zakładce można określić zakres danych do wyeksportowania na poziomie instancji. Aby to zrobić, należy wprowadzić charakterystykę zapytania dla wyszukiwania lub użyć instrukcji OQL, która określa klucze podstawowe odpowiednich instancji obiektów biznesowych.

Jeśli użytkownik korzysta z wyszukiwania, może wyświetlić instancje jednostek biznesowych przed wykonaniem akcji eksportu. Ta opcja nie jest dostępna podczas określania zakresu za pomocą instrukcji OQL.

Można także określić sortowanie eksportowanych danych. W przypadku wyszukiwania odbywa się to za pomocą przycisku [Sortuj] pod polami zapytania. W przypadku korzystania z instrukcji OQL można określić kolejność sortowania w instrukcji OQL za pomocą dodatku order by.

W aplikacji Eksport uproszczony można również dostosować wyszukiwania oferowane do wyboru za pomocą akcji dostosowania wyszukiwania, na przykład w celu określenia dodatkowych parametrów zapytania. Należy pamiętać, że dostosowanie musi być przeprowadzone na poziomie (System, Użytkownik i system, Baza danych, …), który jest również aktywny, gdy proces eksportu jest przeprowadzany później. Dotyczy to w szczególności sytuacji, gdy proces eksportu jest wykonywany przez zadanie przetwarzania w ramach innego użytkownika.

Jeśli użytkownik otworzy aplikację typu Uproszczona wymiana danych, istniejące informacje na zakładce Ograniczenie zostaną usunięte. Dotyczy to również sytuacji, gdy ponownie wybrany zostanie przycisk [Aktualizuj].

Pola w szczegółach:

• Wyszukiwanie — wyszukiwanie, za pomocą którego charakterystyki zapytania można odpytywać żądane instancje. Dostępne wyszukiwania zależą od jednostki biznesowej. Jeśli wybrana zostanie pozycja Z instrukcją OQL, można wykonać zapytanie za pomocą instrukcji OQL. Wynik instrukcji OQL musi zawierać wszystkie atrybuty klucza głównego jednostki biznesowej. W większości przypadków jest to identyfikator GUID.
• Nazwa techniczna — w tym polu wyświetlana jest nazwa obiektu wyszukiwania wybranego w polu Wyszukiwanie. Jeśli wybrano wartość Z instrukcją OQL, pole to pozostaje puste.

Pozostała część obszaru roboczego zależy od wyboru w polu Wyszukiwanie. Należy zwrócić uwagę na następujące różnice:

• Wyszukiwanie — jeśli wybrano wyszukiwanie, wyszukiwanie z powiązanymi polami zapytania i tabelą wyników zapytania jest oferowane w obszarze roboczym. Dla wyszukiwania dostępne są zwykłe przyciski. Wyszukiwanie jest wykonywane z wprowadzoną charakterystyką zapytania przed procesem eksportu. W razie potrzeby należy użyć przycisku startu wyszukiwania, aby wyświetlić wynik zapytania z wyprzedzeniem.
• Z instrukcją OQL — jeśli wybrano tą pozycję, pojawi się pole, w którym możliwe będzie wprowadzenie instrukcji

Działania związane z aplikacją

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

• [Utwórz schemat XML]
• [Eksportuj dane]

Tworzenie schematu XML

Akcja [Utwórz schemat XML] rozpoczyna tworzenie pliku schematu XML dla aktualnie otwartego filtra. Uwzględniane są zmiany w filtrze i wybór atrybutów, które nie zostały jeszcze zapisane. Wybór przycisku [Utwórz schemat XML] otwiera okno dialogowe Utwórz schemat XML, w którym można określić plik i wprowadzić dalsze ustawienia.

Opis okna dialogowego można znaleźć w artykule Eksport danych.

Eksportowanie danych

Akcja [Eksportuj dane] uruchamia proces eksportu dla otwartego filtra. Wybór przycisku [Eksportuj dane] powoduje wyświetlenie okna dialogowego Eksport danych, w którym można wprowadzić ustawienia dla pliku docelowego.

Szczegółowy opis pól okna dialogowego Eksport danych:

• Plik docelowy — w tym polu należy wprowadzić nazwę pliku, do którego mają zostać wyeksportowane dane. Istniejący plik docelowy zostanie nadpisany. To, czy dodatkowo utworzone pliki zostaną nadpisane, np. dla zawartości atrybutów BLOB, zależy od odpowiedniego kontrolera. Jeśli nie zostanie znaleziona instancja obiektu do wyeksportowania, plik nie zostanie utworzony. Należy wprowadzić pełną ścieżkę dostępu do pliku według schematu file:/// lub kstore://. Jeśli plik ma rozszerzenie .gz, jest rozpoznawany jako plik skompresowany GZIP i jest automatycznie kompresowany podczas tworzenia. Skompresowany plik GZIP jest sugerowany w standardowym obszarze roboczym bazy danych OLTP, do której jest zalogowany użytkownik. Ścieżka zawiera nazwę bieżącego użytkownika i nazwę jednostki biznesowej. Nazwa pliku docelowego może zawierać zmienne. Po utworzeniu pliku zmienne są zastępowane odpowiednimi wartościami. Zmienne i ich znaczenie są wymienione poniżej:
  • {user} — nazwa użytkownika
  • {timestamp} — data i godzina z milisekundami (rrrrMMdd_HHmmss_SSS)
  • {datetime} — data i godzina (rrrrMMdd_HHmmss)
  • {date} — data (rrrrMMdd)
  • {time} — czas (HHmmss)
  • {week} — tydzień kalendarzowy (ww)
  • {year} — rok (rrrr)
  • {month} — miesiąc (MM)
  • {day} — dzień (dd)
• Typ pliku — w tym polu należy określić typ pliku docelowego. Należy wybrać jeden z następujących wpisów:
  • XML (*.xml)
  • Tekst oddzielony separatorem (*.csv)
  • Tekst Unicode oddzielony tabulatorem (*.xls)
  • JSON (*.json)
• Kodowanie — tego pola należy użyć, aby określić kodowanie znaków pliku docelowego dla typu pliku Tekst oddzielony separatorem (*.csv). Dostępne kodowania zależą od wersji Java bieżącego serwera aplikacji ERP. W przypadku innych typów plików kodowanie jest stałe i wyświetlane. Jeśli eksport jest wykonywany w tle, należy upewnić się, że serwer aplikacji ERP, na którym działa kolejka przetwarzania, obsługuje określone kodowanie.
• Znak rozdziału — w tym polu dla typu pliku Tekst oddzielony separatorem (*.csv) należy określić separator w pliku docelowym, który ma być używany do oddzielania pól. Po prawej stronie tego pola znajduje się kolejne pole, w którym wyświetlany jest wybrany separator. Wartości (pozostałe) można użyć, aby wprowadzić inny separator. Odpowiednie pole jest gotowe do wprowadzenia po wybraniu tego wpisu. Należy wybrać spośród następujących wpisów:
  • Przecinek
  • Spacja
  • Średnik
  • Tabulator
  • (pozostałe)
• Znak rozpoznawczy tekstu — separator tekstu, który może być użyty do identyfikacji tekstu w pliku docelowym, jest predefiniowany lub może być wprowadzony w zależności od wybranego typu pliku. Jeśli wybrano typ pliku Tekst oddzielony separatorem (*.csv), można wprowadzić identyfikator tekstu w tym polu. Teksty obramowane separatorem tekstu mogą zawierać sam separator.
• Etykieta pola — w przypadku pliku, który ma zostać wyeksportowany, w zależności od typu pliku można określić, czy dla pól ma zostać wyeksportowane oznaczenie handlowe czy techniczne. Należy wybrać jeden z następujących wpisów dla typów plików Tekst oddzielony separatorem (*.csv) lub Tekst Unicode oddzielony tabulatorem (*.xls):
  • Opis techniczny
  • Opis handlowy
• Poziom protokołowania — w tym polu należy określić, czy proces eksportu ma być rejestrowany. Należy wybrać pomiędzy następującymi pozycjami:
  • Bez protokołowania
  • Aktywowano protokołowanie
• Odbiorca danych — w tym polu można wprowadzić odbiorców danych, które mają zostać wyeksportowane. Umożliwia to śledzenie danych w kontekście ochrony danych (wdrożenie RODO).
• Cel — w tym polu można wprowadzić cel eksportu danych. Umożliwia to śledzenie danych w kontekście ochrony danych (wdrożenie RODO).
• Utwórz plik opisowy — tego parametru należy użyć, aby określić, czy ma zostać wygenerowany plik z tabelarycznym przeglądem atrybutów aktywowanych dla filtra. Dla każdego atrybutu generowane są następujące informacje: typ danych, etykieta pola, komentarz. Plik ten może zostać udostępniony na przykład audytorowi podatkowemu.  Nazwa pliku jest przypisywana zgodnie z tym wzorcem Exportfile-name_Filter.csv.

Konfiguracja

Dla aplikacji Eksport uproszczony nie ma konieczności definiowania dodatkowych ustawień w aplikacji Konfiguracja. 

Jednostki biznesowe

Dla aplikacji Eksport uproszczony nie jest istotna żadna jednostka biznesowa.

Uprawnienia

Uprawnienia można przypisywać zarówno przy użyciu ról uprawnień, jak i poprzez przypisanie organizacji. Koncepcję uprawnień można znaleźć w artykule Uprawnienia.

Specjalne uprawnienia

Dla aplikacji Eksport uproszczony nie wymaga specjalnych uprawnień.

Przypisania organizacyjne

Dla aplikacji Eksport uproszczony nie wymaga przypisań organizacyjnych.

Funkcje specjalne

W przypadku aplikacji Eksport uproszczony należy uwzględnić następujące funkcje specjalne:

• Ustawienia uprawnień wynikają z przywołanej aplikacji typu Uproszczona wymiana danych ze specjalnym zastosowaniem Eksport
• Uprawnienia do zapisu plików w Knowledge Store są wymagane do wykonania eksportu danych

Uprawnienia dla partnerów biznesowych

Aplikacja Eksport uproszczony nie jest udostępniana partnerom biznesowym.

Eksportowanie danych

Wymagania wstępne

Musi istnieć aplikacja typu Uproszczona wymiana danych ze specjalnym zastosowaniem Eksport. Należy zwrócić również uwagę na niezbędne uprawnienia do zapisu w Knowledge Store.

Instrukcje

Aby wyeksportować dane należy:

1. Otworzyć aplikację Eksport uproszczony.
2. Wprowadzić w pełni kwalifikowaną nazwę żądanej aplikacji do eksportu w polu Uproszczony eksport danych. Pozostałe pola zostaną automatycznie wypełnione danymi z wybranej aplikacji.
3. Wybrać wyszukiwanie, które ma zostać wykorzystane na zakładce Ograniczenie w polu Wyszukiwanie lub alternatywnie wybrać pozycję Z instrukcją OQL. W zależności od dokonanego wyboru wyświetlona zostanie wybrana kwerenda z jej polami zapytania i tabelą wyników lub pole wprowadzania instrukcji OQL.
4. Wprowadzić charakterystykę zapytania lub instrukcję OQL.
5. Jeśli wybrano kwerendę, można wcześniej wyświetlić wynik kwerendy, naciskając przycisk uruchamiania kwerendy. Tabela wyników zawiera instancje odpowiadające charakterystyce zapytania.
6. Wybrać przycisk [Eksportuj dane] na standardowym pasku narzędzi. Otworzy się okno dialogowe, w którym można dokonać ustawień eksportu.
7. Wybrać przycisk [W tle] w oknie dialogowym. Dane zostaną wyeksportowane z systemu.