Niniejsza dokumentacja opisuje procedurę obsługi aplikacji Import danych w odniesieniu do zapytań ofertowych sprzedaży. Instrukcje te zawierają ogólne kroki instrukcji i specjalne funkcje, które należy wziąć pod uwagę. Informuje także o 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 zapytań ofertowych 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 biznesowego na klucz techniczny. Odpowiednia organizacja zwykle nie znajduje się 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 bazie, jak i w pozycji zapytania ofertowego 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. Za pomocą specjalnej konwersji obiekty biznesowe z kodem skrótu są prezentowane jako części do eksportu lub importu.
Niektóre dane zapytań ofertowych sprzedaży, takie jak 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 Zapytania ofertowe sprzedaży i wyeksportować go z filtrem 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 zapytań ofertowych sprzedaży
Aby zaimportować zapytania ofertowe sprzedaży, należy:
- Otworzyć aplikację Import danych.
- Wyświetlić filtr dla obiektu biznesowego: com.cisag.app.sales.obj.RequestForProposal
→Filtr do importowania zapytań ofertowych jest otwarty. 3.
- w razie potrzeby powielić lub utworzyć nowy filtr dla tego obiektu biznesowego.
- W razie potrzeby zmień już wybrane atrybuty filtra.
- Nacisnąć przycisk [Import danych] na standardowym pasku przycisków.
→Otworzy się okno dialogowe Import danych.
- W oknie dialogowym Import danych można wprowadzić ustawienia dla importowanego pliku. Opis pól można znaleźć w dokumentacji Import danych.
- Nacisnąć przycisk [W tle].
→Import zostanie wykonany.
Tworzenie nowych zapytań ofertowych sprzedaży
Minimalne wymagane atrybuty dla obiektu podstawowego:
Nazwa atrybutu | Atrybut |
Organizacja sprzedaży (w systemach jednofirmowych i wyłączonymi uprawnieniami do treści jest to automatycznie organizacja główna) | invoicingPartyData.Partner |
Rodzaj zapytania ofertowego sprzedaży | Type |
Składający zapytanie | customerData.CustomerPartner |
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 artykuł:
Nazwa atrybutu | Atrybut |
Artykuł | Item |
Całkowita ilość | totalQuantity |
Opcjonalnie można również dołączyć numer do nowego artykułu.
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.sales.obj.RequestForProposal" xsi:schemaLocation="com.cisag.app.sales.obj.RequestForProposal RequestForProposal.xsd" created=" 2006-11-13T13:30:43.618Z" locale="en-US-XMLSchemaCompliant" xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance nlsMode="MULTI_LANGUAGE" dateTimeMode="COMPACT"> <RequestForProposal xmlns="com.cisag.app.sales.obj. RequestForProposal"> <invoicingPartyData> <Partner>00000</Partner> </invoicingPartyData> <customerData> <CustomerPartner>10020</CustomerPartner> </customerData> <Type>100</Type> <Details> <Item>4711</Item> <totalQuantity> <amount>10</amount> <Uom>St.</Uom> </totalQuantity> </Details> <Details> <Item>4712</Item> <totalQuantity> <amount>20</amount> <Uom>St.</Uom> </totalQuantity> </Details> </ RequestForProposal> </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 rozdziale Przegląd: Atrybuty.
Funkcje specjalne podczas przetwarzania zapytania ofertowego sprzedaży
Podczas przetwarzania istniejącego zapytania sprzedaży należy zwrócić uwagę na następujące kwestie: Podczas importowania zapytań w systemach wielofirmowych i systemach jednofirmowych z aktywowanymi uprawnieniami do treści wymagana jest organizacja sprzedaży. Podczas edycji istniejącego zapytania ofertowego sprzedaży 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źć zapytanie sprzedaży przechowywane w bazie danych, wymagana jest jego identyfikacja techniczna (RequestForProposal:guid) lub funkcjonalna (Type [lub typ] i numer).
Jeśli zapytanie ofertowe sprzedaży przechowywane w bazie danych ma już pozycje, należy pamiętać, że żadne podstawowe atrybuty nie są przenoszone.
Wszystkie opcje importu mogą być używane dla pozycji, w szczególności usuwanie. Aby znaleźć zapisaną pozycję, wymagana jest identyfikacja techniczna (RequestForProposalDetail: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, przetworzone zapytanie ofertowe sprzedaży może zostać zwolnione automatycznie po zaimportowaniu. Opcja ta jest szczególnie przydatna w połączeniu ze statusem otwarcia W opracowaniu” (patrz rodzaj zapytania). Zapobiega to wykorzystaniu zapytania ofertowego sprzedaży, które nie zostało jeszcze w pełni zaimportowane, w kolejnych dokumentach. Podczas wydania zapytanie sprzedaży 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 zapytanie o sprzedaż zostało automatycznie zwolnione. Jeśli nie było to możliwe, pojawi się ostrzeżenie.
Wskazówki dotyczące importu starych danych
Przed importem należy upewnić się, że wszystkie dane podstawowe zostały poprawnie przeniesione. Pozwoli to uniknąć niepotrzebnego przetwarzania błędów dla zapytań ofertowych sprzedaży.
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 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 nagłówkiem)
- Firma (zawsze zgodnie z nagłówkiem)
Atrybuty identyfikacyjne (atrybuty kluczowe) są oznaczone literą (K).
Dane podstawowe
Zapytanie ofertowe sprzedaży (RequestForProposal)
Identyfikacja zapytania o sprzedaż składa się z rodzaju zapytania i numeru ze schematu numeracji przechowywanych dla danego rodzaju.
Atrybut | Relacja | Wyjaśnienie |
autoRelease | Zwolnienie automatyczne (atrybut wirtualny)
Więcej informacji w rozdziale Automatyczne zwolnienie po imporcie |
|
classification1 (Vertriebsorganisation) |
Classification1 | Klasyfikacja 1
|
classification2 (Vertriebsorganisation) |
Classification2 | Klasyfikacja 2
|
classification3 (Vertriebsorganisation) |
Classification3 | Klasyfikacja 3
|
classification4 (Vertriebsorganisation) |
Classification4 | Klasyfikacja 4
|
classification5 (Vertriebsorganisation) |
Classification5 | Klasyfikacja 5
|
customerData | Więcej informacji w rozdziale Dane klienta (customerData, deliveryCustomerData, invoiceCustomerData) |
|
date | Data utworzenia | |
deliveryCustomerData | Więcej informacji w rozdziale Dane klienta (customerData, deliveryCustomerData, invoiceCustomerData) |
|
deliveryData | Więcej informacji w rozdziale Dane dostawy (deliveryData) | |
deliveryPartnerData.careOf | deliveryPartnerData.CareOfPartner | Dostawca: Osoba kontaktowa |
deliveryPartnerData.careOfName | Dostawca: Nazwa osoby kontaktowej | |
detailPurchasingDataOrigin | Pochodzenie danych zakupu dla pozycji | |
guid (K) | Identyfikacja techniczna zmiany/ Usuwanie danych, które zostały już zapisane – jeśli są znane | |
invoiceCustomerData | Więcej informacji w rozdziale Dane klienta (customerData, deliveryCustomerData, invoiceCustomerData) |
|
invoicingData
|
PaymentMethod PaymentTerms |
Szczegóły płatności
|
invoicingPartyData | Więcej informacji w rozdziale Dane organizacji sprzedaży (invoicingPartyData) | |
number (K) | Numer (identyfikator firmy), Opcjonalny w przypadku nowego utworzenia – w przeciwnym razie określany automatycznie.
Obowiązkowy, jeśli guid nie został określony podczas zmiany/usuwania. |
|
proposalDeadLine.value | Data oferty | |
purchasingOrganization | PurchasingOrganization | Organizacja zakupu |
purchasingReference | Integracja z zaopatrzeniem | |
requestDate.value | Preferowana data | |
responsible | ResponsiblePartner | Odpowiedzialny pracownik |
salesRepresentative | Przedstawiciel handlowy | |
status | Status ogólny (tylko Zwolniony i Zablokowany) | |
storageArea.warehouse | Magazyn
|
|
storageAreaDefault | Domyślna wartość magazynu | |
supplier | Dostawca | |
TextAssignments | Załączniki/Teksty
Więcej informacji w rozdziale Załączniki/Teksty (TextAssignments). |
|
type (K) | Type | Typ (identyfikacja techniczna): Obowiązkowe, jeżeli przy wprowadzaniu zmian/usuwaniu nie podano identyfikatora Guid. |
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ęść do eksportu/importu. To samo dotyczy danych adresowych.
Następujące nazwy części zostały przypisane analogicznie do nazw atrybutów technicznych:
- customerData Składający zapytanie
- deliveryCustomerData Odbiorca dostawy
- invoiceCustomerData Odbiorca faktury
Następujące atrybuty są zatem używane raz.
Wyjaśnienie relacji atrybutów
Atrybut | Relacja | Wyjaśnienie |
addressData.city | Adres – miasto | |
addressData.country | addressData.Country | Adres – kraj |
addressData.district | Adres – rejon | |
addressData.poBox | Adres – skrytka pocztowa | |
addressData.poBoxCity | Adres – miasto skrytki pocztowej | |
addressData.poBoxPostalCode | Adres – kod pocztowy skrytki pocztowej | |
addressData.postalCode | Adres – kod pocztowy | |
addressData.region | addressData.Region | Adres – region |
addressData.street | Adres – ulica | |
customer | CustomerPartner | Klient |
name | Nazwa klienta | |
careOf | CareOfPartner | Osoba kontaktowa |
careOfName | Nazwa osoby kontaktowej |
Dane dostawy (deliveryData)
Dane dostawy są przechowywane w bazie danych jako obiekt biznesowy z kodem skrótu i są reprezentowane jako część do eksportu/importu.
Wyjaśnienie relacji atrybutów
Atrybut | Relacja | Wyjaśnienie |
deliveryTerms | DeliveryTerms | Warunki dostawy |
deliveryTermsLocation | Warunki dostawy z informacją o lokalizacji | |
shippingTerms | ShippingTerms | Warunki wysyłki |
Dane organizacji sprzedaży (invoicingPartyData)
Niektóre dane organizacji sprzedaży są przechowywane w bazie danych jako obiekt biznesowy z kodem skrótu i są reprezentowane jako część do eksportu/importu.
Atrybut | Relacja | Wyjaśnienie |
partner | Partner | Partner Wskazówka W przypadku istniejących dokumentów szybkiej rejestracji sprzedaży tego atrybutu nie można zmienić poprzez import. Dane w pliku importu są ignorowane podczas importu. |
careOf | CareOfPartner | Osoba kontaktowa |
careOfName | Nazwa osoby kontaktowej
|
Teksty (TextAssignments)
Atrybut | Relacja | Wyjaśnienie |
text | Teksty zgodnie z językiem
(Używane tylko wtedy, gdy nie określono modułu tekstowego) |
|
type | Rodzaj tekstu |
Tekst
Atrybut | Relacja | Wyjaśnienie |
contentType | Rodzaj zawartości | |
language | Język | |
text | Tekst |
Moduł tekstowy „TXT1”, oraz drugi tekst zawierają wolny tekst stopki dla języków niemieckiego i angielskiego:
<?xml version="1.0" encoding="UTF-8"?><semiramis xmlns="com.cisag.app.sales.obj.RequestForProposal" xsi:schemaLocation="com.cisag.app.sales.obj.RequestForProposal RequestForProposal.xsd" created="2010-06-28T14:34:55. 142Z" locale="en-US-XMLSchemaCompliant" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" nlsMode="SINGLE_LANGUAGE" dateTimeMode="COMPACT"> <RequestForProposal xmlns="com.cisag.app.sales.obj.RequestForProposal"> <customerData> <CustomerPartner> <numer>10010</numer> </CustomerPartner> </customerData> <invoicingPartyData> <Partner> <numer>90000</numer> </Partner> </invoicingPartyData> <Type> <code>100</code> </Type> <TextAssignments> <code>TXT1</code> <sequence>10</sequence> <document index="0">CUSTOMER_PROPOSAL</document> <document index="1">ORDER_CONFIRMATION</document> <document index="2">PICKING_SLIP</document> <document index="3">DELIVERY_SLIP</document> <document index="4">CUSTOMER_INVOICE</document> <document index="5">PROFORMA_INVOICE</document> <document index="6">SHIPPING_LOAD</document> <document index="7">PRODUCTION_ORDER</document> <type>HEADER</type> </TextAssignments> <TextAssignments> <code/> <sequence>20</sequence> <document index="0">CUSTOMER_PROPOSAL</document> <document index="1">ORDER_CONFIRMATION</document> <document index="2">PICKING_SLIP</document> <document index="3">DELIVERY_SLIP</document> <document index="4">CUSTOMER_INVOICE</document> <document index="5">PROFORMA_INVOICE</document> <document index="6">SHIPPING_LOAD</document> <document index="7">PRODUCTION_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> </RequestForProposal> </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.
Pozycje zapytania ofertowego sprzedaży (RequestForProposalDetail)
Atrybut | Relacja | Wyjaśnienie |
customerItemNumber | Numer artykułu klienta
Więcej informacji można znaleźć w artykule: Import pozycji dokumentu przy pomocy numeru EAN. |
|
deliveryPartnerData.careOf | deliveryPartnerData.CareOfPartner | Dostawca: Osoba kontaktowa |
deliveryPartnerData.careOfName | Dostawca: Nazwa osoby kontaktowej | |
ean | European Article Number – Europejski Kod Towarowy
Dodatkowe informacje znajdują się w artykule Import pozycji dokumentu przy pomocy numeru EAN. |
|
guid (K) | Identyfikator techniczny (Pozycja) pozwalający usunąć istniejące dane, jeśli te są znane. | |
header (K) | Identyfikator techniczny (nagłówek) | |
item | Item | Artykuł |
number (K) | Numer (identyfikacja funkcjonalna), opcjonalny w przypadku nowego utworzenia – w przeciwnym razie jest określany automatycznie. Obowiązkowe, jeśli guid nie został określony podczas zmiany/usuwania. |
|
preferredDate.value | Preferowana data | |
pseudoItemDescription | Opis pseudoartykułu
|
|
purchasingDataOrigin | Pochodzenie danych zakupu | |
purchasingOrganization | PurchasingOrganization | Organizacja zakupu |
purchasingReference | Integracja z zaopatrzeniem | |
reference | Odniesienie | |
supplier | SupplierPartner | Dostawca |
status | Status ogólny (tylko Zwolniony lub Zablokowane) | |
storageArea.warehouse | Magazyn (code) | |
storageAreaDefault | Wartość domyślna magazynu | |
TextAssignments | Załączniki/Teksty
Więcej informacji w rozdziale Załączniki/Teksty (TextAssignments) |
|
totalQuantity
|
Uom | Całkowita ilość w jednostce |
uomObligation | Obowiązywanie jednostek
|
|
uomObligationOrigin | Wskazówka Pochodzenie obowiązywania jednostek można zaimportować tylko jeśli funkcja Zarządzanie zapasami w jednostkach logistycznych jest aktywna. |