Import zleceń dystrybucyjnych

Niniejsza dokumentacja opisuje procedurę korzystania z aplikacji Import danych w odniesieniu do zleceń dystrybucyjnych. Procedury te zawierają ogólne instrukcje i specjalne cechy, które należy wziąć pod uwagę. Informują również o możliwych warunkach wstępnych i skutkach.

Opis aplikacji Import danych, który zawiera również opisy pól i przycisków, można znaleźć w dokumentacji Import danych.

Informacje ogólne

Import zlecenia dystrybucji jest zasadniczo oparty na bieżącym modelu danych, który jest przechowywany w bazie danych repozytorium. W przypadku eksportu danych dostępnych jest więcej atrybutów niż w przypadku importu danych. Dlatego sensowne jest zdefiniowanie oddzielnych filtrów dla eksportu i importu.

Relacje 1:1 są zazwyczaj oparte na technicznym atrybucie GUID w modelu danych. W zależności od przypadku użycia, do importu można użyć technicznego atrybutu GUID lub klucza funkcjonalnego z obiektu docelowego (zwykle kodu lub numeru). W przypadku niektórych obiektów biznesowych wymagana jest organizacja do konwersji klucza funkcjonalnego na klucz techniczny. Odpowiednia organizacja nie jest zwykle bezpośrednio w źródle importu, ale jest określana za pośrednictwem kontekstu dokumentu. Więcej informacji na ten temat można znaleźć w rozdziale Przegląd: Atrybuty.

Obiekty biznesowe kodu skrótu są przywoływane zarówno w nagłówku, jak i w pozycji zlecenia dystrybucji. Są to technicznie powiązane grupy atrybutów, które są zawsze takie same dla wielu zleceń i których ponowne użycie oszczędza trochę miejsca w bazie danych i pamięci głównej. Korzystając ze specjalnej konwersji, obiekty biznesowe z kodem skrótu są wyświetlane jako części do eksportu lub importu.

Niektóre dane zlecenia dystrybucji, takie jak ustawienia drukowania dokumentów, lokalne wartości walut, ilości zadysponowane, konfiguracja artykułów i ich elementy konfiguracji, a także wewnętrzne atrybuty pomocnicze nie mogą być importowane.

Jeśli nie ma pewności, który format jest odpowiedni dla pliku importu, należy wykonać następujące czynności: Wprowadzić przykładowy dokument za pośrednictwem aplikacji Zlecenia dystrybucji i wyeksportować go przy użyciu filtra dla importu w żądanym formacie z żądanymi atrybutami. Wynikowy plik przykładowy może zostać użyty jako szablon dla generowanych plików importu.

Podczas importowania obowiązują te same zasady, co podczas edycji za pośrednictwem aplikacji. Na przykład artykuł w zapisanym elemencie nie może być później zmieniany. Wartości atrybutów są ignorowane, jeśli nie można ich przyjąć w bieżącym kontekście. Ta sama logika jest stosowana przy określaniu wartości domyślnej, więc import i aplikacja zachowują się identycznie. To samo dotyczy kontroli.

Instrukcja: Import zleceń dystrybucji

1. Aby zaimportować zlecenie dystrybucji należy utworzyć aplikację Import danych.
2. Wyświetlić filtr dla obiektu biznesowego: com.cisag.app.multiorg.obj.DistributionOrder
   →Filtr do importowania zleceń dystrybucji zostanie otwarty.
   
3. W razie potrzeby należy powielić lub utworzyć nowy filtr dla tego obiektu biznesowego
4. W razie potrzeby można zmienić już wybrane atrybuty filtra.
5. Po wprowadzeniu zmian należy wybrać przycisk [Import danych] na standardowym pasku przycisków.
   →Otworzy się okno dialogowe Import danych.

6. W oknie dialogowym Import danych można wprowadzić ustawienia dla importowanego pliku. Opis pól można znaleźć w dokumentacji Import danych.
7. Nacisnąć przycisk [W tle].
   →Import zostanie wykonany.

Tworzenie nowych zleceń dystrybucji

Minimalne wymagane atrybuty dla obiektu podstawowego:

Opcjonalnie można również przenieść numer za pomocą importu. W takim przypadku numer określony za pomocą schematu numeracji zgodnie z rodzajem jest ignorowany. Ponadto należy zastosować odpowiednie konwencje, aby upewnić się, że numer przypisany za pomocą importu nie pasuje do numeru, który został już przypisany lub ma zostać przypisany automatycznie w przyszłości.

Minimalne wymagane atrybuty dla obiektu Item:

Opcjonalnie można również wprowadzić numer dla nowej pozycji.

Odpowiedni minimalny XML z atrybutami funkcjonalnymi i dwoma pozycjami ma na przykład następującą zawartość:

<?xml version="1.0" encoding="UTF-8"?>

<semiramis xmlns="com.cisag.app.multiorg.obj.DistributionOrder" xsi:schemaLocation="com.cisag.app.multiorg.obj.DistributionOrder.xsd" created="2005-01-28T16:25:49.378Z" locale="en-US-XMLSchemaCompliant" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

<DistributionOrder xmlns="com.cisag.app.multiorg.obj.DistributionOrder">

<Type>100</Type>

<Details>

<Item>4711</Item>

<totalQuantity>

<amount>10</amount>

<Uom>St.</Uom>

</totalQuantity>

<priceOriginType>MANUAL</priceOriginType>

<grossPrice>

<amount>11</amount>

<Currency>EUR</Currency>

</grossPrice>

</details>

<details>

<Item>4712</Item>

<totalQuantity>

<amount>20</amount>

<Uom>St.</Uom>

</totalQuantity>

<priceOriginType>MANUAL</priceOriginType>

<grossPrice>

<amount>12</amount>

<Currency>EUR</Currency>

</grossPrice>

</Details>

</DistributionOrder>

</semiramis>

W tym przykładzie pozostałe atrybuty są dodawane za pomocą wartości domyślnych zgodnie z danymi podstawowymi itp.

Można również zaimportować dodatkowe wartości i użyć atrybutów technicznych zamiast atrybutów funkcjonalnych. Listę atrybutów można znaleźć w tym rozdziale: Przegląd: Atrybuty.

Funkcje specjalne podczas przetwarzania zamówienia

Aby znaleźć zlecenie dystrybucji przechowywane w bazie danych, wymagana jest jego identyfikacja techniczna (DistributionOrder:guid) lub funkcjonalna (Type [order type] i nubmer).

Dla pozycji można użyć wszystkich opcji importu – w szczególności usuwania. Identyfikacja techniczna (DistributionOrderDetail:guid) lub funkcjonalna (number) jest również wymagana do znalezienia zapisanej pozycji.

Zmiany za pomocą importu są możliwe tylko wtedy, gdy żadna weryfikacja tego nie uniemożliwia.

Automatyczne zwolnienie po imporcie

Jeśli import został przeprowadzony pomyślnie, przetworzone zlecenie dystrybucyjne może zostać zwolnione automatycznie po imporcie. Opcja ta jest szczególnie przydatna w połączeniu ze statusem otwarcia W trakcie opracowania (ustawienie w rodzaju zlecenia dystrybucji). Zapobiega to wykorzystaniu w kolejnych dokumentach zlecenia dystrybucyjnego, które nie zostało jeszcze w pełni zaimportowane. Podczas zwolnienia zlecenie dystrybucji ma status Nieprawidłowe, więc nie można go użyć również w tym kroku.

W przypadku tej funkcji należy ustawić atrybut bazy wirtualnej autoRelease na wartość true dla odpowiedniej instancji.

Jeśli ta funkcja jest aktywna i nie ma innych błędów, w dzienniku komunikatów wyświetlany jest dodatkowy komunikat informacyjny informujący, że zlecenie dystrybucji zostało zwolnione automatycznie. Jeśli nie było to możliwe, pojawi się ostrzeżenie.

Wskazówki dotyczące importowania starszych danych

Istnieją następujące wskazówki dotyczące importowania starszych danych:

• Należy upewnić się, że wszystkie dane podstawowe zostały poprawnie przeniesione. Pozwoli to uniknąć niepotrzebnych błędów w przetwarzaniu zamówień.
• Należy ustawić funkcje w aplikacji Konfiguracja i odpowiednie typy – przynajmniej tymczasowo na czas transferu danych – w taki sposób, aby osiągnąć najwyższą możliwą prędkość importu. Na przykład dezaktywować zapytanie o dostępność, sprawdzanie limitu kredytowego itp. Zapisywanie tymczasowych rekordów dostępności jest automatycznie dezaktywowane podczas importu – nawet jeśli funkcja jest aktywna w aplikacji Konfiguracja.
• Aby uniknąć określania nowych cen i rabatów podczas importu, należy przełączyć odpowiednie pochodzenie na Ręczne i przenieś wartości bezpośrednio z systemu źródłowego.
• Podczas importu nie można wpływać na ilość dostarczoną i zafakturowaną. Dlatego warto sfinalizować i zafakturować wszystkie zamówienia dostawy i prowizje w starym systemie. Jeśli faktury proforma są nadal nieuregulowane, należy je również utworzyć w starszym systemie. Następnie można zaimportować otwarte ilości dostaw dla zamówień, które nie zostały jeszcze zrealizowane, jako całkowitą ilość do nowych pozycji w systemie docelowym. Następnie można zlecić nowemu systemowi wygenerowanie zleceń dostawy, faktur itp.

Przegląd: Atrybuty

Atrybuty poszczególnych obiektów biznesowych, które są dostępne do importu, są wymienione poniżej. Odpowiednia nazwa relacji jest również uwzględniona dla atrybutów klucza obcego. Atrybuty mogą ulec zmianie i mogą zostać rozszerzone poprzez dostosowanie.

W przypadku niektórych obiektów biznesowych wymagana jest organizacja do konwersji kluczy funkcjonalnych na klucze techniczne. Na listach atrybutów jest to oznaczone następującymi uwagami w kolumnie Atrybut.

• Partner dostawy (organizacja logistyczna magazynu źródłowego) (zawsze zgodnie z nagłówkiem)
• Organizacja sprzedaży (zawsze zgodnie z nagłówkiem)
• Firma źródłowa (zawsze zgodnie z nagłówkiem)
• Kraj do firmy źródłowej (zawsze zgodnie z nagłówkiem)
• Odbiorca (docelowa organizacja logistyki magazynowej) (zawsze zgodnie z nagłówkiem)
• Organizacja zaopatrzenia (zawsze zgodnie z nagłówkiem)
• Firma docelowa (zawsze zgodnie z nagłówkiem)
• Kraj firmy docelowej (zawsze zgodnie z nagłówkiem)

Atrybuty identyfikacyjne (atrybuty kluczowe) są oznaczone literą (K).

Dane podstawowe

Zlecenie dystrybucji (DistributionOrder)

Dane klienta (deliveryCustomerData,invoiceCustomerData)

Dane klienta w poniższych zastosowaniach są przechowywane w bazie danych jako obiekt biznesowy z kodem skrótu i są wyświetlane jako część do eksportu/importu. To samo dotyczy danych adresowych.

Następujące nazwy części zostały przypisane analogicznie do nazw atrybutów technicznych:

• deliveryCustomerData Odbiorca dostawy
• invoiceCustomerData Organizacja zakupu

Następujące atrybuty istnieją zatem raz na użycie.

Wyjaśnienie relacji między atrybutami:

Dane Intrastat (intrastatData, receivingIntrastatData)

Dane Intrastat w poniższych zastosowaniach są przechowywane w bazie danych jako obiekt biznesowy z kodem skrótu i są reprezentowane jako część do eksportu/importu.

Następujące nazwy części zostały przypisane analogicznie do nazw atrybutów technicznych:

• intrastatData Kraj firmy źródłowej
• receivingintrastatData Kraj spółki docelowej

Następujące atrybuty istnieją zatem raz na użycie.

Wyjaśnienie relacji atrybutów

Dane dostawy (deliveryData)

Dane dostawy są przechowywane w bazie danych jako obiekt biznesowy z kodem skrótu i są reprezentowane jako część eksportu/importu.

Dane dostawcy (deliverySupplierData, invoiceSupplierData)

Dane dostawcy w poniższych zastosowaniach są przechowywane w bazie danych jako obiekt biznesowy z kodem skrótu i są wyświetlane jako część eksportu/importu. To samo dotyczy danych adresowych.

Następujące nazwy części zostały przypisane analogicznie do nazw atrybutów technicznych:

• deliverySupplierData Partner dostawy
• invoiceSupplierData Organizacja sprzedaży

Następujące atrybuty istnieją zatem raz na użycie.

Wyjaśnienie relacji atrybutów:

Dane faktury (invoicingData)

Niektóre dane faktury są przechowywane w bazie danych jako obiekt biznesowy z kodem skrótu i są wyświetlane jako część eksportu/importu.

Dane dostawy zamówienia (orderDeliveryData)

Dane dostawy zamówienia są przechowywane w bazie danych jako obiekt biznesowy z kodem skrótu i są reprezentowane jako część eksportu/importu.

Ustawienia wyjściowe (outputSettings)

Ustawienia wydruku są przechowywane w bazie danych jako obiekt biznesowy z kodem skrótu i są wyświetlane jako część eksportu/importu.

Wyjaśnienie relacji atrybutów:

Teksty (TextAssignments)

Wyjaśnienie relacji atrybutów:

tekst

Poniższy przykład zawiera dwa podstawowe teksty. Tekst nagłówka odwołuje się do modułu tekstowego „TXT1”, a drugi tekst zawiera wolny tekst stopki dla języków de i en:

<?xml version="1.0" encoding="UTF-8"?>

<semiramis xmlns="com.cisag.app.multiorg.obj.DistributionOrder" xsi:schemaLocationcom.cisag.app.multiorg.obj.DistributionOrder.xsd" created="2005-12-28T07:36:29.729Z" locale="en-US-XMLSchemaCompliant" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

<DistributionOrder xmlns="com.cisag.app.multiorg.obj.DistributionOrder">

<Type>100</Type>

<TextAssignments>

<code>TXT1</code>

<sequence>10</sequence>

<document index="0">DELIVERY_SLIP</document>

<document index="1">CUSTOMER_INVOICE</document>

<document index="2">PROFORMA_INVOICE</document>

<document index="3">SHIPPING_LOAD</document>

<document index="4">DISTRIBUTION_ORDER</document>

<type>HEADER</type>

</TextAssignments>

<TextAssignments>

<code></code>

<sequence>20</sequence>

<document index="0">DELIVERY_SLIP</document>

<document index="1">CUSTOMER_INVOICE</document>

<document index="2">PROFORMA_INVOICE</document>

<document index="3">SHIPPING_LOAD</document>

<document index="4">DISTRIBUTION_ORDER</document>

<type>FOOTER</type>

<text>

<language>en</language>

<text>To jest przykładowy tekst.</text>

<contentType>text/plain</contentType>

</text>

<text>

<language>en</language>

<text>To jest przykładowy tekst.</text>

<contentType>text/plain</contentType>

</text>

</TextAssignments>

</DistributionOrder>

</semiramis>

Można również użyć różnych opcji formatowania tekstów. Jeśli potrzebne są przykłady określonego formatowania, najlepiej jest utworzyć przykładowy dokument z żądanym formatowaniem tekstu i wyeksportować go.