Import kontraktów sprzedaży

Niniejsza dokumentacja opisuje instrukcję korzystania z aplikacji Import danych w odniesieniu do kontaktów sprzedaży. Instrukcje te zawierają ogólne kroki instrukcji i specjalne funkcje, które należy wziąć pod uwagę. Zostaniesz również poinformowany 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 kontraktów sprzedaży 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 podstawie, jak i w pozycji kontraktu sprzedaży. Są to technicznie powiązane grupy atrybutów, które są zawsze takie same dla wielu dokumentów i których ponowne użycie pozwala zaoszczędzić miejsce 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 kontraktu sprzedaży, takie jak wartości waluty lokalnej, status i 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 Kontrakty sprzedaży 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 kontraktów sprzedaży

1. Należy otworzyć aplikację Import danych.
2. Wyświetlić filtr dla obiektu biznesowego: com.cisag.app.sales.obj.SalesContract

→Zostanie otwarty filtr do importu kontraktu sprzedaży.

3. W razie potrzeby można powielić lub utworzyć nowy filtr dla tego obiektu biznesowego.
4. W razie potrzeby można zmienić już wybrane atrybuty filtra.
5. Nacisnąć 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 kontraktów sprzedaży

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.

W razie potrzeby można również określić listę dozwolonych organizacji w kluczu OrganizationAssignments:

Organizacja wywołujące kontrakt sprzedaży: OrganisationalUnit

W razie potrzeby w kluczach OrdererAssignments, DeliveryCustomerAssignments i InvoiceCustomerAssignments można również określić listę klientów dozwolonych dla danego partnera:

Klient kontraktu sprzedaży: Partner

Minimalne wymagane atrybuty na obiekt pozycji:

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

Odpowiedni minimalny XML dla kontraktów typu Ilość/termin 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.sales.obj.SalesContract" xsi:schemaLocation="com.cisag.app.sales.obj.SalesContract SalesContract.xsd" created="2005-12-28T07:36:29.729Z" locale="en-US-XMLSchemaCompliant" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

<SalesContract xmlns="com.cisag.app.sales.obj.SalesContract">

<invoicingPartyData>

<partner>00000</partner>

</invoicingPartyData>

<Type>100</Type>

<customerData>

<CustomerPartner>10020</CustomerPartner>

</customerData>

<Details>

<Item>4711</Item>

<totalQuantity>

<amount>10</amount>

<Uom>St.</Uom>

</totalQuantity>

<expiryDate>2006-12-30T23:00:01.000Z</expiryDate>

</Details>

<Details>

<Item>4712</Item>

<totalQuantity>

<amount>20</amount>

<Uom>St.</Uom>

</totalQuantity>

<expiryDate>2006-12-30T23:00:01.000Z</expiryDate>

</Details>

</SalesContract>

</semiramis>

Analogiczny przykład dla kontraktów typu Wartość/termin, który zawiera również ceny i szczegóły dotyczące niedostarczenia i przekroczenia dostawy, ma następującą treść:

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

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

<SalesContract xmlns="com.cisag.app.sales.obj.SalesContract">

<invoicingPartyData>

<partner>00000</partner>

</invoicingPartyData>

<Type>200</Type>

<customerData>

<CustomerPartner>10020</CustomerPartner>

</customerData>

<Details>

<Item>4711</Item>

<values>

<grossValue>

<amount>10000.000000</amount>

<Currency>EUR</Currency>

<grossValue>

</values>

<grossPrice>

<amount>10.000000</amount>

<Currency>EUR</Currency>

</grossPrice>

<expiryDate>2006-12-30T23:00:01.000Z</expiryDate>

<underDeliveryLimit>1.0000</underDeliveryLimit>

<overDeliveryLimit>2.0000</overDeliveryLimit>

</Details>

<Szczegóły>

<Item>4712</Item>

<values>

<grossValue>

<amount>20000.000000</amount>

<Currency>EUR</Currency>

<grossValue>

</values>

<grossPrice>

<amount>20.000000</amount>

<Currency>EUR</Currency>

</grossPrice>

<expiryDate>2006-12-30T23:00:01.000Z</expiryDate>

<underDeliveryLimit>3.0000</underDeliveryLimit>

<overDeliveryLimit>4.0000</overDeliveryLimit>

</Details>

</SalesContract>

</semiramis>

W przypadku typów Stała ilość i Stała wartość wartość expiryDate jest ignorowana.

Pozostałe wymagane atrybuty są dodawane w tych przykładach przy użyciu wartości domyślnych zgodnie z danymi podstawowymi.

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 rozdziale Przegląd: Atrybuty.

Funkcje specjalne podczas edycji kontraktu

Podczas edycji istniejącego kontraktu należy zwrócić uwagę na następujące kwestie: Podczas importowania kontraktów sprzedaży w systemach wielostanowiskowych i systemach jednostanowiskowych z aktywowanymi uprawnieniami do treści wymagana jest organizacja sprzedaży. Podczas edycji istniejącego kontraktu organizacja sprzedaży jest zawsze pobierana z dokumentu przechowywanego w bazie danych. Każda inna organizacja sprzedaży w źródle importu jest w tym przypadku ignorowana.

Aby znaleźć kontrakt sprzedaży przechowywany w bazie danych, wymagana jest jego identyfikacja techniczna (SalesContract:guid) lub identyfikacja funkcjonalna (Type [lub type] i number).

W przypadku organizacji wywołujących i klientów wywołujących można użyć wszystkich opcji importu – w szczególności usuwania. Również w tym przypadku do znalezienia zapisanego partnera wymagana jest tylko identyfikacja techniczna (identyfikacja partnera).

W przypadku pozycji można użyć wszystkich opcji importu, w szczególności usuwania. Również w tym przypadku do znalezienia zapisanej pozycji wymagana jest identyfikacja techniczna (Sales¬ContractDetail:guid) lub identyfikacja funkcjonalna (number).

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

Automatyczne zwolnienie po imporcie

Jeśli import został przeprowadzony pomyślnie, edytowany kontrakt sprzedaży może zostać zwolniony automatycznie po zaimportowaniu. Opcja ta jest szczególnie przydatna w połączeniu ze statusem otwarcia W trakcie realizacji . Zapobiega to wykorzystaniu w kolejnych dokumentach kontraktu sprzedaży, która nie została jeszcze w pełni zaimportowana. Podczas wydania kontrakt sprzedaży ma status Nieprawidłowy, więc nie można go użyć również w tym kroku.

Aby uzyskać tę funkcjonalność, należy ustawić wirtualny atrybut bazowy autoRelease na wartość true dla odpowiedniej instancji.

Jeśli ta właściwość jest aktywna i nie ma innych błędów, w dzienniku komunikatów wyświetlany jest dodatkowy komunikat informacyjny informujący, że kontrakt sprzedaży został automatycznie zwolniony. Jeśli nie było to możliwe, wyświetlane jest ostrzeżenie.

Wskazówki dotyczące transferu starszych danych

Jeśli import ma zostać użyty do przeniesienia starszych danych, pomocne są poniższe wskazówki:

Należy upewnić się, że wszystkie dane podstawowe zostały poprawnie przeniesione. Pozwoli to uniknąć niepotrzebnego przetwarzania błędów dla umów.

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ą podlegać zmianom i można je rozszerzyć poprzez konfigurację.

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.

• Organizacja sprzedaży (zawsze zgodnie z podstawą)
• Firma (zawsze zgodnie z podstawą)

Atrybuty identyfikacyjne (atrybuty kluczowe) są również oznaczone literą (K).

Dane podstawowe

Kontrakt sprzedaży (SalesContract)

Organizacje wywołujące (SalesContractOrganisationAssignment)

Wywoływanie klientów (SalesContractCustomerAssignment)

Ta tabela istnieje trzy razy, ze znaczeniami Zamawiający (OrdererAssignments), Odbiorca dostawy (DeliveryCustomerAssignments) i Odbiorca faktury (InvoiceCustomerAssignments).

Dane klienta (customerData, 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ęść eksportu/importu. To samo dotyczy danych adresowych.

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

• customerData Zamawiający
• deliveryCustomerData Odbiorca dostawy
• invoiceCustomerData Odbiorca faktury

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

Dane dostawy (deliveryData)

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

Dane faktury (invoicingData)

Niektóre dane faktury są przechowywane w bazie danych jako obiekt biznesowy z kodem skrótu i są reprezentowane jako część do 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.

Teksty (TextAssignments)

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.sales.obj.SalesContract" xsi:schemaLocation="com.cisag.app.sales.obj.SalesContract SalesContract.xsd" created="2005-12-28T07:36:29.729Z" locale="en-US-XMLSchemaCompliant" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

<SalesContract xmlns="com.cisag.app.sales.obj.SalesContract">

<invoicingPartyData>

<partner>00000</partner>

</invoicingPartyData>

<Type>100</Type>

<customerData>

<CustomerPartner>10020</CustomerPartner>

</customerData>

<TextAssignments>

<code>TXT1</code>

<sequence>10</sequence>

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

<type>HEADER</type>

</TextAssignments>

<TextAssignments>

<code></code>

<sequence>20</sequence>

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

<type>FOOTER</type>

<text>

<language>pl</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>

</SalesContract>

</semiramis>

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

Dane pozycji: Pozycje kontraktu sprzedaży (SalesContractDetail)