Eksport i import szablonów dokumentów końcowych

W systemie szablony dokumentów mogą być przenoszone do innego systemu Comarch ERP Enterprise. Dokument ten zawiera instrukcje eksportu i importu szablonów dokumentów z wykorzystaniem usługi Business Integration Service (BIS) czyli aplikacji Eksport danych oraz Import danych.

Eksport

W zakładce Filtry możliwy jest wybór jednego lub więcej szablonów dokumentów, które mają zostać wyeksportowane. Szczegółowy opis dostępnych filtrów znajduje się w rozdziale Obszar roboczy – zakładka Filtr.

Z uwagi na to, że większość atrybutów jest polami obowiązkowymi, preferowany jest plik eksportu w formacie XML.

Eksport danych

1. Pierwszym krokiem jest uruchomienie aplikacji Eksport danych.
2. W polu Filtr należy wybrać jednostkę biznesową cisag.app.general.obj.DocumentOutputOptions.
   W oknie aplikacji widoczny jest filtr dla eksportu danych.
3. Wybrane atrybuty filtra są już zaznaczone. Możliwa jest edycja filtrów na zakładce Filtr.
4. Możliwe jest ustawienie ograniczeń dla eksportu danych w zakładce Ograniczenie. Szczegółowy opis zakładki znajduje się w rozdziale Obszar roboczy – zakładka Ograniczenia.
5. Przycisk [Eksport danych], znajdujący się na standardowym pasku narzędzi, otwiera okno dialogowe Eksport danych.
6. Możliwe jest wprowadzenie ustawień dla pliku eksportu. Szczegółowy opis pól znajduje się w dokumentacji aplikacji Eksport danych.
7. Użytkownik uruchamia eksport danych za pomocą przycisku [W tle].

Import

W celu przeprowadzenia importu danych należy posiadać plik wyeksportowany wcześniej z innego środowiska Comarch ERP Enterprise. W przypadku importu szablonu zawierającego szablon zamienny lub dodatkowy, najpierw należy importować te szablony.

Import danych

1. Pierwszym krokiem jest uruchomienie aplikacji Import danych.
2. W polu Filtr należy wybrać jednostkę biznesową cisag.app.general.obj.DocumentOutputOptions.
   W oknie aplikacji widoczny jest filtr dla importu danych.
3. Wybrane atrybuty filtra są już zaznaczone. Możliwa jest edycja filtrów w zakładce Filtry.
4. Przycisk [Importuj dane], znajdujący się w standardowym pasku narzędzi, otworzy okno dialogowe Import danych.
5. Możliwe jest wprowadzenie ustawień dla pliku importu. Szczegółowy opis pól znajduje się w dokumentacji aplikacji Import danych.
6. Użytkownik uruchamia import danych za pomocą przycisku [W tle].

Obszar roboczy – zakładka Ograniczenie

Zakładka Ograniczenie umożliwia zawężenie eksportu szablonów dokumentów. Składa się z następujących pól oraz przycisków:

• Wyszukiwanie – umożliwia wybór trybu zawężenia eksportu danych:
  • Eksport Szablony dokumentów końcowych – umożliwia ograniczenie eksportu danych z użyciem interfejsu systemu.
  • Z poleceniem OQL – umożliwia ograniczenie eksportu danych z użyciem obiektowego języka zapytań.
• Nazwa techniczna (pole domyślne) – pokazuje jednostkę biznesową eksportowanych danych
• [Nowy filtr] – umożliwia zdefiniowanie nowego ograniczenia eksportu
• [Zapisz filtr] – umożliwia zapisanie nowego ograniczenia eksportu, do wyboru są poniższe funkcjonalności:
  • [Zapisz wzorzec filtra] – zapisuje nowe ograniczenie eksportu.
  • [Zmień nazwę wzorca filtra] – umożliwia zmianę nazwy zapisanego wzorca eksportu.
  • [Dopasuj filtr] – umożliwia edycje atrybutów wyszukiwania w aplikacji Dopasuj wyszukiwanie.
  • [Zapisz widok] – umożliwia zapisanie zdefiniowanego widoku.
  • [Przywróć widok] – umożliwia przywrócenie domyślnego widoku.
• Wybór wzoru filtra – umożliwia wybór zdefiniowanego ograniczenia eksportu.
• Szablon dokumentu końcowego – umożliwia wybór szablonów dokumentu końcowego, które zostaną wyeksportowane.
• Oznaczenie – umożliwia odfiltrowanie danych w tabeli po oznaczeniu.
• Tryb wydania – umożliwia odfiltrowanie danych w tabeli po trybie wydania.
• Medium wydania – umożliwia odfiltrowanie danych w tabeli po zdefiniowanym sposobie publikacji dokumentu.

Poniżej znajduje się tabela, w której dodawane są wybrane pozycje szablonów dokumentów końcowych, które zostaną wyeksportowane przez aplikację.

Obszar roboczy – zakładka Filtry

Poniżej znajduje się opis pól obowiązkowych oraz głównych atrybutów dla poszczególnych obiektów biznesowych.

Model danych BIS dla szablonów dokumentów składa się z obiektu głównego DocumentOutputOptions oraz powiązań Additions, Replacements i FilterDefinition.  Powiązanie FilterDefinition jest powiązaniem obcym. Additions i Replacements są zależnościami (Dependents). Obiekt główny DocumentOutputOptions modelu danych BIS zawiera następujące atrybuty:

Zależność Additions modelu danych BIS opisuje szablon dodatkowy i zawiera następujące atrybuty:

Zależność Replacements modelu danych BIS opisuje szablon zastępczy i zawiera następujące atrybuty:

Odniesienie obce FilterDefinition opisuje filtr, który jest wykorzystywany podczas eksportu. Zawiera następujące atrybuty: