Import artykułu

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, użytkownik może również używać nowo utworzonych filtrów. Aby użyć nowo utworzonego filtra nie trzeba go zapisywać, jednak istnieje możliwość zapisania filtra, tak 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, więc można je stosować zarówno w eksporcie, jak i imporcie. Należy jednak 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 np. 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, charakteryzujący się rozszerzalnym językiem znaczników, który pozwala na zapisywanie danych w pliku tekstowym. Język opisu umożliwia definiowanie, przesyłanie, sprawdzanie i interpretację danych między aplikacjami, a także 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 są 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 tym 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. Pierwszym krokiem jest uruchomienie aplikacji Import danych.
2. Następnie należy wybrać 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.  Przycisk [Importuj dane], znajdujący się na standardowym pasku przycisków, otworzy 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, należy wybrać 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. Pierwszym krokiem jest weryfikacja, czy plik importu, który ma zostać wygenerowany, zawiera co najmniej numer artykułu (pozycję identyfikacyjną).
2. Następnie należy upewnić 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. Należy wykonać 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. Pierwszym krokiem jest weryfikacja, 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. Następnie należy upewnić 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. Należy wykonać 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. Pierwszym krokiem jest weryfikacja, 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. Następnie należy upewnić 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. Użytkownik powinien sprawdzić, czy organizacja podrzędna jest uprawniona do przechowywania danych dla widoku, który ma zostać zaimportowany.
4. Należy wykonać 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. Pierwszym krokiem jest wygenerowanie 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 należy wprowadzić organizację, po której ma dziedziczyć.

3. Użytkownik powinien sprawdzić, czy 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. Należy wykonać 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. Przykładowo, 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

Pierwszym krokiem jest wygenerowanie filtra, zawierającego dane identyfikacyjne artykułu, kluczowy atrybut widoku oraz pola, które mają zostać zmienione. Następnie należy wyeksportować odpowiednie artykuły, np. w formacie CSV. W utworzonym pliku użytkownik ustawia żądaną wartość w odpowiednim polu. Następnie należy ponownie zaimportować plik, korzystając z wygenerowanego filtra. Poniższy przykład prezentuje sposób aktywacji kontroli dostępności artykułu sprzedaży:

Usuwanie artykułów lub widoków

Proces importu może również zostać użyty, aby oznaczyć istniejące artykuły lub widoki do usunięcia. W ten sam sposób można również usunąć znacznik usuwania. Import jest wówczas jednoznaczny z wybraniem przycisków [Wstaw znacznik usuwania] lub [Usuń znacznik usuwania] w aplikacji Artykuły.

Aby wstawić znacznik usuwania, odpowiedni obiekt biznesowy należy zaimportować w trybie Usuń. Aby usunąć istniejący znacznik usuwania, należy również zaimportować odpowiedni obiekt biznesowy w trybie Usuń. Tryb ten można aktywować wyłącznie w formacie XML.

Import za pomocą plików CSV

Ze względu na wydajność systemu, wskazane jest zaimportowanie jak największego zbioru danych w pierwszej operacji importu, np. wiele widoków artykułów i organizacji. Poszczególne pliki powinny zawierać:

• plik główny: wszystkie informacje dotyczące wymaganych danych podstawowych. Plik określa, który artykuł będzie zaimportowany.
• dane krajowe

• dane rachunkowe

• dane sprzedaży

W tym pliku ważne jest, aby pierwsza pozycja, w której zmienia się numer artykułu, zawsze zawierała dane dla organizacji aktywnego klienta OLTP. Następnie można wprowadzić dane dla organizacji podrzędnych.

• analogicznie jak w przypadku danych sprzedaży można tworzyć pliki zawierające pozostałe dostępne do dziedziczenia widoki. Ważne jest przy tym, aby kolejność artykułów w poszczególnych plikach odpowiadała kolejności artykułów w pliku podstawowym. W plikach dodatkowych można pominąć poszczególne numery artykułów, np. jeśli dany artykuł ma nie mieć widoku.

Odniesienia plików

Warunki wstępne

• dostępny jest filtr dla obiektu biznesowego cisag.app.general.obj.Item, zawierający atrybuty, które mają zostać zaimportowane
• dostępny jest główny plik zawierający dane podstawowe
• dostępny jest przynajmniej jeden plik z danymi dodatkowymi
• każda wartość atrybutu referencyjnego Item musi być również zawarta w głównym pliku

Instrukcja importu danych z odniesieniami plików

1. Pierwszym krokiem jest uruchomienie aplikacji Import danych.
2. Następnie należy wybrać filtr, lub jeden z filtrów, dla obiektu biznesowego cisag.app.general.obj.Item.
   Filtr dla importu danych artykułu zostanie wyświetlony.
3. Wybrane atrybuty filtra zostaną wyświetlone automatycznie, można wskazać dodatkowe atrybuty do importu.
4. Przycisk [Importuj dane], znajdujący się na standardowym pasku narzędzi, otworzy 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. Przycisk [Rejestruj powiązania] otworzy okno dialogowe.
7. Użytkownik może utworzyć nowe odwołanie, określając ścieżkę obiektu, plik dodatkowy pełniący rolę pliku źródłowego, plik błędów oraz atrybut odwołujący (Numer atrybutu dla importu artykułu).
   Ścieżka obiektu opisuje nazwę relacji do obiektu biznesowego, który ma zostać zaimportowany. Jako plik źródłowy wybierany jest jeden z plików dodatkowych. Należy się upewnić, że powiązanie z plikiem dodatkowym odpowiada informacji o ścieżce obiektu. Na przykład, jeśli jako ścieżka obiektu zostanie wybrana wartość SalesItems, wówczas podany plik dodatkowy również powinien zawierać dane dla artykułu sprzedaży.
8. Należy powtarzać kroki 7 i 8, aż zostaną utworzone odwołania do wszystkich dodatkowych plików.
9. Należy wybrać przycisk [Zastosuj].
10. Aby rozpocząć operację importu, należy wybrać przycisk [W tle].

Przykłady

Struktura pliku danych podstawowych i dodatkowych plików jest opisana poniżej. Aby sprawdzić, które atrybuty są polami wymaganymi i muszą być określone w możliwym zakresie, patrz: Przegląd: Pola identyfikacyjne i wymagane.

Plik danych podstawowych

Plik danych podstawowych dla wariantu artykułu

Import wariantów artykułów jest możliwy tylko wtedy, gdy istnieje już powiązany z nimi artykuł referencyjny. Aby zaimportować nowy wariant artykułu, wystarczy wykorzystać poniższy plik.

W ramach tego przykładu zostanie utworzony nowy wariant artykułu o numerze REF1VAR1, bazujący na artykule referencyjnym REF1. W środowisku wielofirmowym całkowita struktura organizacyjna artykułu referencyjnego zostanie również przeniesiona na wariant artykułu.

Plik danych krajowych

Artykuł 4711 otrzymuje standardowy rekord oraz dodatkowo dane krajowe dla Niemiec i Szwajcarii. Artykuł 4712 otrzymuje wyłącznie standardowy rekord. Artykuł 4713 otrzymuje standardowy rekord oraz dodatkowo dane krajowe dla Austrii.

Plik danych rachunkowych

W ramach tego przykładu, artykuł 4711 otrzymuje dane rachunkowe dla organizacji rachunkowych Firma 1 i Firma 2. Artykuł 4712 otrzymuje dane rachunkowe dla organizacji Firma 2.

Plik dla dziedziczonych widoków

W ramach tego przykładu zostanie określony dziedziczony widok Sprzedaż. Procedura wygląda analogicznie w przypadku widoków: Zakup, Logistyka magazynowa, Planowanie i Produkcja.

W ramach tego przykładu, artykuł 4711 otrzymuje dane sprzedaży dla Organizacji 1 i Organizacji 2. Artykuł 4712 otrzymuje oddzielne dane sprzedaży dla aktywnego klienta OLTP oraz Organizacji 1. Artykuł 4713 otrzymuje dane sprzedaży wyłącznie na poziomie aktywnego klienta OLTP.

Przegląd: Pola identyfikacyjne i wymagane

Pola wymagane oraz kluczowe atrybuty K poszczególnych obiektów biznesowych są wymienione poniżej. Pola identyfikacyjne i wymagane są edytowalne i mogą zostać rozszerzone poprzez adaptacje.

Poniższe informacje można również otrzymać po otworzeniu aplikacji Artykuły, przejściu do odpowiedniego widoku i zatwierdzeniu go przyciskiem [Weryfikuj]. Wszystkie pola oznaczone czerwonym symbolem w narożniku są polami wymaganymi.

Dane podstawowe

Jeśli typ artykułu atrybut Type oraz typ materiału atrybut materiał Type  nie są określone, zakłada się, że jest to standardowy artykuł magazynowy.

Dane krajowe

Określenie danych krajowych jest możliwe tylko wtedy, gdy w aplikacji Konfiguracja → Specyficzne funkcje krajowe zaznaczono parametr Intrastat.

Dane rachunkowe

Określenie organizacji jest wymagane tylko w środowiskach wielofirmowych. Jeśli organizacja nie jest określona w środowisku jednofirmowym, jest ona ustawiana jako organizacja aktywnego klienta OLTP.

Poniższe atrybuty danych rachunkowych nie są polami wymaganymi. Ich określenie jest jednak zalecane, ponieważ współdecydują one o statusie blokady dla aplikacji Zakup, Logistyka magazynowa i Sprzedaż.

Dane artykułu zakupu

Określenie organizacji jest wymagane tylko w środowiskach wielofirmowych. Jeśli organizacja nie jest określona w środowisku jednofirmowym, jest ona ustawiana jako organizacja aktywnego klienta OLTP.

Jeśli nie określono atrybutów uom[0] i pricingUom, są one definiowane przy pomocy jednostki podstawowej artykułu.

Dane artykułu magazynowego

Określenie organizacji jest wymagane tylko w środowiskach wielofirmowych. Jeśli organizacja nie jest określona w środowisku jednofirmowym, jest ona ustawiana jako organizacja aktywnego klienta OLTP.

Jeśli klasyfikacja ABC nie została określona, wprowadzana jest wartość A.

Dane planowania

Określenie organizacji jest wymagane tylko w środowiskach wielofirmowych. Jeśli organizacja nie jest określona w środowisku jednofirmowym, jest ona ustawiana jako organizacja aktywnego klienta OLTP.

W zależności od ustawienia atrybutu makeOrBuy, obowiązuje jedna z poniższych tabel. Import plików musi wówczas zawierać te atrybuty.

Do nieokreślonych atrybutów przypisywane są odpowiednie wartości domyślne. Jeśli plik wejściowy ma nie zawierać żadnych danych produkcyjnych, wartość dla pola useProductionData musi być ustawiona jako false. Pole to ma domyślnie przypisaną wartość true.

Dane artykułu sprzedaży

Określenie organizacji jest wymagane tylko w środowiskach wielofirmowych. Jeśli organizacja nie jest określona w środowisku jednofirmowym, jest ona ustawiana jako organizacja aktywnego klienta OLTP.

Jeśli nie określono atrybutów uoms[0] i pricingUom, są one definiowane przy pomocy jednostki podstawowej artykułu.

Dane artykułu produkcyjnego

Określenie organizacji jest wymagane tylko w środowiskach wielofirmowych. Jeśli organizacja nie jest określona w środowisku jednofirmowym, jest ona ustawiana jako organizacja aktywnego klienta OLTP.

Alternatywne metody produkcji są dopuszczalne zgodnie z ustawieniami w aplikacji Konfiguracja:

Alternatywne metody produkcji nie są dopuszczalne zgodnie z ustawieniami w aplikacji Konfiguracja: