Import krajów

Aplikacja Import danych pozwala na wykonanie importu wybranych danych w formie np. pliku .xml, z systemowego repozytorium wiedzy za pomocą usługi Business Integration Service (BIS). Dane takie mogą być eksportowane z systemu do pliku za pomocą aplikacji Eksport danych, a następnie, po wprowadzeniu zmian, zaimportowane do tego samego lub innego (np. nowszego) systemu.

W niniejszym artykule opisane zostały procedury korzystania z aplikacji Import danych w kontekście danych krajów.

Szczegółowe informacje dotyczące importu danych, w tym opisy pól, przycisków i wskazówki znajdują się w dokumentacji Import danych.

Informacje podstawowe

W systemie Comarch ERP Enterprise kraje stanowią część adresu i należą do danych podstawowych. Umożliwiają między innymi zapisywanie numerów Intrastat właściwych dla danego kraju lub kodów adresowych.

System umożliwia zdefiniowanie dla kraju waluty, języka, numeru kierunkowego, regionów, jak również formaty adresu i danych podatkowych.

W systemie Comarch ERP Enterprise wyróżnia się dwa typy wymiany danych:

• wymiana danych między istniejącymi systemami Comarch ERP Enterprise
• import danych z poprzedniej wersji systemu do jego nowej wersji

W artykule znajdują się informacje dotyczące importu z poprzedniej wersji systemu. Szczegółowy opis wymiany danych między systemami Comarch ERP Enterprise znajduje się w artykułach Import danych oraz Eksport danych.

Warunki, które muszą zostać spełnione przy imporcie danych kraju, oraz sposoby postępowania podczas pracy z aplikacją Import danych zostaną omówione w następujących rozdziałach:

• Import danych
• Atrybuty niezbędne do importu
• Import nowych krajów
• Import regionów do istniejących krajów

Import danych kraju

Warunki wstępne:

• dostępny jest filtr dla obiektu biznesowego: com.cisag.app.general.obj.Country, zawierający filtry, które mają zostać zaimportowane

• należy posiadać plik wyeksportowany wcześniej z innego środowiska Comarch ERP Enterprise

Aby zaimportować dane kraju, należy:

1. Otworzyć aplikację Import danych.
2. W nagłówku aplikacji, w polu Filtr, za pomocą przycisku [Pomoc uzupełniania wartości] wybrać filtr COUNTRY (jednostka biznesowa com.cisag.app.general.obj.Country)
3. W obszarze roboczym zaznaczone są domyślne atrybuty do importu, opisane w kolejnych rozdziałach. Na tym etapie można zaznaczyć dodatkowe atrybuty.
4. Wybrać przycisk [Import danych] na standardowym pasku przycisków. Zostanie otwarta aplikacja w tle Import danych.
5. W aplikacji Import danych należy:

   

   • w polu Plik źródłowy wskazać plik, który ma zostać zaimportowany, z systemowego repozytorium wiedzy wybrać typ pliku. Do wyboru są rozszerzenia:
     • XML (*.xml)
     • Tekst rozdzielony separatorem (*.xls)
     • Tekst Unicode oddzielony tabulatorem (*.xls)
     • JSON (*.json)
   • wybrać kolejkę przetwarzania danych na zakładce Ustawienia przetwarzania
   • dostosować ustawienia przetwarzania według uznania: np. zdefiniować postępowanie systemu w przypadku błędu lub zmienić serwer aplikacji

6. Nacisnąć przycisk [W tle]

Atrybuty niezbędne do importu

Aby zaimportować plik z poprzedniej wersji systemu dla każdej jednostki biznesowej należy określić co najmniej poniższe atrybuty:

• atrybuty identyfikacyjne (klucz biznesowy)

• pola obowiązkowe

Nie jest możliwe przypisanie obiektu biznesowego Kraj  bez atrybutów identyfikacyjnych.

Dla obiektu biznesowego com.cisag.app.general.obj.Country istnieją powiązania z innymi obiektami biznesowymi, które do niego bezpośrednio nie należą (powiązania za pomocą kluczy obcych, oznaczone kursywą). Aby mogły zostać zaimportowane, muszą być wybrane przez użytkownika. Dane, do których odwołują się klucze obce, nie mogą być importowane razem z krajem – ten musi już istnieć w systemie.

Jeśli klucz główny obiektu biznesowego składa się w całości lub częściowo z kluczy obcych, to obiekt biznesowy, do którego się odnoszą, musi zostać uwzględniony w pliku importu.

Import nowych krajów

Aby import zakończył się poprawnie, wszystkie atrybuty identyfikacyjne i obowiązkowe danych podstawowych muszą zostać uwzględnione w pliku importu. Dane regionów mogą być uwzględnione w tym samym lub oddzielnym pliku.

Przykład importu danych nowego kraju:

Import regionów do istniejących krajów

Aby import regionów zakończył się poprawnie, konieczny jest wcześniejszy import danych kraju, do którego należy region. W pliku importu musi zostać określony atrybut identyfikacji isoCode.

Przykład pliku importu do aktualizacji danych regionu:

Atrybuty identyfikacyjne i pola obowiązkowe

Dla obiektu biznesowego com.cisag.app.general.obj.Country niezbędne są następujące atrybuty identyfikacyjne i obowiązkowe:

Dane podstawowe

Dane regionu