Import artykułów

Aplikacja Import danych umożliwia import określonych danych (np. artykułu, kraju, elementów tekstowych) z innego systemu Comarch ERP Enterprise za pomocą usługi Business Integration Service (BIS).

Aplikacja Import danych składa się z nagłówka aplikacji, pozwalającego wskazać filtr importu (pole Filtr), oraz obszaru roboczego, prezentującego przynależące do filtra atrybuty dostępne do importu.

Oprócz filtrów zapisanych w bazie danych można również używać nowo utworzonych filtrów. Aby użyć nowo utworzonego filtra nie trzeba go zapisywać. Istnieje możliwość zapisania filtra, by był dostępny do użycia w późniejszym czasie.

Zapisane filtry są dostępne zarówno w aplikacji Eksport danych, jak i Import danych, można je więc stosować zarówno w eksporcie, jak i imporcie. Należy pamiętać, że model danych niektórych jednostek gospodarczych różni się w przypadku importu i eksportu. Z tego powodu wskazane jest stosowanie różnych filtrów dla importu i eksportu.

W artykule Import artykułów znajdują się instrukcje pozwalające na obsługę aplikacji Import danych
w odniesieniu do artykułów, takie jak kolejność, w jakiej należy zaimportować artykuły. Dokumentacja dodatkowo informuje o możliwych wymaganiach i skutkach importu.

Szczegółowe informacje dotyczące opisu pól i przycisków aplikacji Import danych, znajdują się w artykule Import danych.

Wymiana danych między systemami Comarch ERP jest szczegółowo opisana w artykułach Import danych oraz Eksport danych. Niniejszy dokument opisuje import danych ze poprzednich systemów z wykorzystaniem aplikacji Import danych.

Użytkownik może wykorzystać następujący format importu:

• XML – format pliku, który charakteryzuje rozszerzalny język znaczników, umożliwia zapisywanie danych w pliku tekstowym. Język opisu umożliwia definiowanie, przesyłanie, sprawdzanie i interpretację danych między aplikacjami i pozwala na wymianę danych strukturalnych. Treść, struktura i informacja są oddzielone do prezentacji w dokumentach XML. XML jest koordynowany i definiowany jako standard przez W3C.
• CSV – format pliku, który zawiera tekst z separatorami, wartości rozdzielone przecinkami. To typ pliku, w którym wartości poszczególnych kolumn są wydzielone separatorami, a wiersze oddzielnymi liniami. Separator musi być znany, aby można było zaimportować plik. Zazwyczaj używanymi separatorami są: przecinek i średnik. Dane zapisane w tym formacie mogą być wykorzystywane i przetwarzane w wielu aplikacjach.

• XLS – format pliku, który jest rozdzielony znakami tabulacji. Typ pliku jest podobny do CSV, z tą różnicą, że separatorem jest tabulator, a wykorzystywanym standardem kodowania znaków jest Unicode. Pliki w formacie mogą być używane m.in. w programie Microsoft Excel.

Import w formacie XML umożliwia zaimportowanie wszystkich żądanych danych w ramach jednej operacji importu.

W przypadku importu w formacie CSV wymagana jest inna procedura. Ograniczenie techniczne polega na tym, że równoległe relacje 1:n pomiędzy obiektami biznesowymi nie mogą być reprezentowane w jednym pliku importu. Oznacza to na przykład, że nie jest możliwy import danych dotyczących logistyki magazynowej oraz danych sprzedaży
z jednego pliku.

Istnieje jednak możliwość importu danych dotyczących logistyki magazynowej oraz powiązanych z nimi danych magazynowych. Między artykułem i jego danymi logistyki magazynowej, a także między danymi logistyki magazynowej a danymi magazynowymi występuje relacja 1:n. Są one jednak budowane na sobie wzajemnie, więc mogą być zaimportowane z jednego pliku.

Instrukcje

Poniżej znajdują się informacje dotyczące wymagań, jakie należy spełnić, aby zaimportować dane artykułów oraz jak wygląda praca z aplikacją Import danych:

• Import danych
• Atrybuty wymagane podczas importu ze starych systemów
• Kolejność
• Import nowego artykułu
• Import nowego widoku artykułu
• Import widoku artykułu dla organizacji podrzędnej
• Import struktury dziedziczonej

Import danych

Aby zaimportować dane artykułu:

1. Otwórz aplikację Import danych.
2. Wybierz filtr lub jeden z filtrów dla obiektu biznesowego com.cisag.app.general.obj.Item

Filtr wraz z atrybutami zostanie wyświetlony w obszarze roboczym.

3. Wybrane atrybuty filtra zostaną wyświetlone automatycznie. Można dodatkowo zaznaczyć te, które mają być zaimportowane.

4. Wybierz przycisk [Importuj dane] na standardowym pasku przycisków.

Zostanie otwarte okno dialogowe Import danych.

5. W oknie tym można skonfigurować ustawienia pliku importu. Szczegółowe informacje dotyczące pól w oknie Import danych znajdują się w artykule Import danych.

6. Aby rozpocząć operację importu, wybierz przycisk [W tle].

Atrybuty wymagane podczas importu z poprzednich systemów

W przypadku importu z poprzednich systemów, dla obiektu: Artykuł, wymagane jest określenie:

• atrybutów identyfikacyjnych (kluczy biznesowych)
• pól obowiązkowych

Obiekt biznesowy Artykuł nie może być przyporządkowany bez atrybutów identyfikacyjnych. Wymagane pola i atrybuty identyfikacyjne poszczególnych obiektów biznesowych są wymienione w rozdziale Przegląd: Pola identyfikacyjne i wymagane.

Dodatkowo istnieją relacje z innymi obiektami biznesowymi, które nie są bezpośrednio powiązane z obiektem biznesowym Artykuł  (relacje tworzone poprzez zewnętrzne klucze, które w filtrze są oznaczone kursywą). Aby zastosować te relacje, należy w filtrze wybrać atrybuty identyfikacyjne tych obiektów biznesowych.

Jeżeli podstawowy klucz obiektu biznesowego składa się wyłącznie lub częściowo z kluczy zewnętrznych, obiekt biznesowy, do którego odnosi się klucz zewnętrzny, musi zostać rozwiązany w pliku importu za pomocą jego atrybutów identyfikacyjnych.

Kolejność

Aby zaimportować dane, które są od siebie zależne, należy postępować zgodnie z określoną kolejnością.

Standardowa kolejność

1. Dane podstawowe
2. Dane krajowe / dane Intrastat (jeśli te dane są istotne, zgodnie z ustawieniami
   w aplikacji Konfiguracja)
3. Dane finansowe
4. Dane zakupu i sprzedaży
5. Dane logistyki magazynowej
6. Dane planowania i produkcji

Dane artykułów dla dostawcy, klienta, klasyfikacji klientów i planowania klientów mogą być zaimportowane przy użyciu oddzielnych filtrów importu.

Kolejność i dodatkowe warunki dla środowisk wielofirmowych

Aby zaimportować rolę Zakup, Sprzedaż, Logistyka magazynowa, Planowanie lub Produkcja, należy zaimportować odpowiednie dane aktywnego klienta OLTP przed wszystkimi innymi organizacjami.

W przypadku importu należy zachować następującą kolejność dla każdej organizacji: dane logistyki magazynowej przed danymi planowania i produkcji.

Następnie import danych może być wykonany natychmiastowo lub jako zlecenie przetwarzania w tle. W tym drugim przypadku procesy są inicjowane przez system. System określa też czas, w którym te procesy się rozpoczynają. Użytkownik nie ma wpływu na czas rozpoczęcia.

Import nowego artykułu

Warunki wstępne

• system docelowy nie zawiera jeszcze żadnych artykułów z odpowiadającym kluczem
• dostępny jest filtr dla obiektu biznesowego cisag.app.general.obj.Item zawierający atrybuty, które mają zostać zaimportowane

Instrukcja

1. Zweryfikuj, czy plik importu, który ma zostać wygenerowany, zawiera co najmniej numer artykułu (pozycję identyfikacyjną).
2. Upewnij się, że w miarę możliwości uzupełniono wszystkie wymagane pola (patrz rozdział Przegląd: Pola identyfikacyjne i wymagane) dotyczące danych podstawowych.
3. Wykonaj kroki opisane w rozdziale Import danych.

Import nowego widoku artykułu (na poziomie aktywnego klienta OLTP)

Warunki wstępne

• w systemie docelowym znajduje się już element z odpowiednim kluczem. Oznacza to, że dane podstawowe zostały już zaimportowane.
• dostępny jest filtr dla obiektu biznesowego cisag.app.general.obj.Item zawierający atrybuty, które mają zostać zaimportowane
• został wygenerowany plik importu, który zawiera numer artykułu jako atrybut
• dane widoku, które mają zostać zaimportowane, odnoszą się do organizacji aktywnego klienta OLTP

Instrukcja

1. Zweryfikuj, czy plik importu, który ma zostać wygenerowany, zawiera co najmniej numer artykułu (pozycję identyfikacyjną) oraz klucz widoku, który ma zostać zaimportowany.
2. Upewnij się, że w miarę możliwości uzupełniono wszystkie wymagane pola (patrz rozdział Przegląd: Pola identyfikacyjne i wymagane) dotyczące widoku, który ma zostać zaimportowany.
3. Wykonaj kroki opisane w rozdziale Import danych.

Import widoku artykułu dla organizacji podrzędnej

Warunki wstępne

• system stanowi środowisko wielofirmowe
• w systemie docelowym znajduje się już element z odpowiednim kluczem. Oznacza to, że dane podstawowe zostały już zaimportowane.
• przed rozpoczęciem importu muszą już istnieć dane dla danego widoku na poziomie aktywnego klienta OLTP
• dostępny jest filtr dla obiektu biznesowego cisag.app.general.obj.Item, zawierający wszystkie czytelne atrybuty.

Instrukcja

1. Zweryfikuj, czy plik importu, który ma zostać wygenerowany, zawiera co najmniej numer artykułu (pozycję identyfikacyjną) oraz klucz widoku, który ma zostać zaimportowany.
2. Upewnij się, że w miarę możliwości uzupełniono wszystkie wymagane pola (patrz rozdział Przegląd: Pola identyfikacyjne i wymagane) dotyczące widoku, który ma zostać zaimportowany.
3. Upewnij się, że organizacja podrzędna jest uprawniona do przechowywania danych dla widoku, który ma zostać zaimportowany.
4. Wykonaj kroki opisane w rozdziale Import danych.

Import struktury dziedziczonej

Warunki wstępne

• system stanowi środowisko wielofirmowe lub występują uprawnienia do treści. Oznacza to, że występuje więcej niż jedna organizacja.
• organizacja, która ma odziedziczyć dane, musi mieć uprawnienia do danego widoku
• organizacja musi być organizacją podrzędną, czyli nie może być aktywnym klientem OLTP
• w systemie docelowym znajduje się już artykuł z odpowiednim kluczem. Oznacza to, że dane podstawowe zostały już zaimportowane.
• na poziomie organizacji muszą już istnieć dane dla odpowiedniego widoku – organizacja docelowa odziedziczy dane z tego właśnie miejsca
• dostępny jest filtr dla obiektu biznesowego cisag.app.general.obj.Item, zawierający wszystkie czytelne atrybuty

Instrukcja

1. Wygeneruj plik importu, który zawiera co najmniej numer artykułu (pozycję identyfikacyjną) oraz atrybuty identyfikacyjne zaimportowanego obiektu
2. Dziedziczona struktura widoków jest zdefiniowana w ramach obiektu biznesowego OrganizationalUnitItem. Każdy widok posiadający dziedziczoną strukturę posiada atrybut referencyjny w tym obiekcie biznesowym:

W atrybucie dla odpowiedniego widoku wprowadź organizację, po której ma dziedziczyć.

3. Upewnij się, że organizacja podrzędna posiada następujące uprawnienia:

• uprawnienie do przechowywania widoku, który ma zostać zaimportowany
• uprawnienie do widoku, który ma zostać zaimportowany (np. tylko organizacja sprzedaży może dziedziczyć widok Sprzedaż).

4. Wykonaj kroki opisane w rozdziale Import danych.

Funkcje specjalne dla artykułów referencyjnych

Artykuł referencyjny jest wykorzystywany jako szablon dla wariantów artykułów. Zmiana istniejących danych lub określonych nowych danych w aplikacji Artykuły powoduje analogiczną zmianę w danych wariantów. Import artykułów referencyjnych odbywa się w taki sam sposób. Więcej informacji dotyczących typu materiału można znaleźć w dokumentacji Instrukcja: Artykuły.

Funkcje specjalne dla wariantów artykułów

Wariant artykułu zawsze odnosi się do artykułu referencyjnego. Jeśli konieczny jest import wariantu artykułu, powiązany z nim artykuł referencyjny musi już istnieć w bazie danych. W przypadku wariantów artykułów możliwy jest wyłącznie import tych danych, które można wprowadzić ręcznie w aplikacji Artykuły. Użytkownik nie może tworzyć nowych widoków wariantów artykułów ani zmieniać lub tworzyć struktury dziedziczonej. Ponadto nie ma możliwości zmiany niektórych atrybutów poprzez import. Wszystkie te dane są kontrolowane poprzez powiązany artykuł referencyjny. Jeśli plik importu zawiera takie dane, są one ignorowane podczas importu. Użytkownik może natomiast zaimportować nowy wariant artykułu: instrukcja znajduje się w rozdziale Plik danych podstawowych dla wariantów artykułów.

Wprowadzanie zmian poprzez import danych

Funkcja importu może również zostać użyta, aby wprowadzić zmiany w istniejących artykułach. Na przykład, jeśli użytkownik chce aktywować kontrolę dostępności dla wszystkich artykułów sprzedaży, można to zrobić również poprzez import danych.

Instrukcja

Wygeneruj filtr zawierający dane identyfikacyjne artykułu, kluczowy atrybut widoku oraz pola, które mają zostać zmienione. Następnie wyeksportuj odpowiednie artykuły, np. w formacie CSV. W utworzonym pliku ustaw żądaną wartość w odpowiednim polu. Następnie ponownie zaimportuj plik, korzystając z wygenerowanego filtra. Poniższy przykład prezentuje sposób aktywacji kontroli dostępności artykułu sprzedaży:

Przykład

Konfiguracja kontroli dostępności