{"id":9294,"date":"2024-08-30T17:07:19","date_gmt":"2024-08-30T15:07:19","guid":{"rendered":"https:\/\/pomoc.comarch.pl\/cee\/640\/?post_type=ht_kb&p=9294"},"modified":"2024-08-30T17:07:19","modified_gmt":"2024-08-30T15:07:19","slug":"import-zlecen-dystrybucyjnych","status":"publish","type":"ht_kb","link":"https:\/\/pomoc.comarch.pl\/cee\/640\/index.php\/documentation\/import-zlecen-dystrybucyjnych\/","title":{"rendered":"Import zlece\u0144 dystrybucyjnych"},"content":{"rendered":"

Niniejsza dokumentacja opisuje procedur\u0119 korzystania z aplikacji Import danych<\/em> w odniesieniu do zlece\u0144 dystrybucyjnych. Procedury te zawieraj\u0105 og\u00f3lne instrukcje i specjalne cechy, kt\u00f3re nale\u017cy wzi\u0105\u0107 pod uwag\u0119. Informuj\u0105 r\u00f3wnie\u017c o mo\u017cliwych warunkach wst\u0119pnych i skutkach.<\/p>\n

Opis aplikacji Import danych<\/em>, kt\u00f3ry zawiera r\u00f3wnie\u017c opisy p\u00f3l i przycisk\u00f3w, mo\u017cna znale\u017a\u0107 w dokumentacji Import danych<\/em>.<\/p>\n

Informacje og\u00f3lne<\/h3>\n

Import zlecenia dystrybucji jest zasadniczo oparty na bie\u017c\u0105cym modelu danych, kt\u00f3ry jest przechowywany w bazie danych repozytorium. W przypadku eksportu danych dost\u0119pnych jest wi\u0119cej atrybut\u00f3w ni\u017c w przypadku importu danych. Dlatego sensowne jest zdefiniowanie oddzielnych filtr\u00f3w dla eksportu i importu.<\/p>\n

Relacje 1:1 s\u0105 zazwyczaj oparte na technicznym atrybucie GUID w modelu danych. W zale\u017cno\u015bci od przypadku u\u017cycia, do importu mo\u017cna u\u017cy\u0107 technicznego atrybutu GUID lub klucza funkcjonalnego z obiektu docelowego (zwykle kodu lub numeru). W przypadku niekt\u00f3rych obiekt\u00f3w biznesowych wymagana jest organizacja do konwersji klucza funkcjonalnego na klucz techniczny. Odpowiednia organizacja nie jest zwykle bezpo\u015brednio w \u017ar\u00f3dle importu, ale jest okre\u015blana za po\u015brednictwem kontekstu dokumentu. Wi\u0119cej informacji na ten temat mo\u017cna znale\u017a\u0107 w rozdziale Przegl\u0105d: Atrybuty<\/a>.<\/em><\/p>\n

Obiekty biznesowe kodu skr\u00f3tu s\u0105 przywo\u0142ywane zar\u00f3wno w nag\u0142\u00f3wku, jak i w pozycji zlecenia dystrybucji. S\u0105 to technicznie powi\u0105zane grupy atrybut\u00f3w, kt\u00f3re s\u0105 zawsze takie same dla wielu zlece\u0144 i kt\u00f3rych ponowne u\u017cycie oszcz\u0119dza troch\u0119 miejsca w bazie danych i pami\u0119ci g\u0142\u00f3wnej. Korzystaj\u0105c ze specjalnej konwersji, obiekty biznesowe z kodem skr\u00f3tu s\u0105 wy\u015bwietlane jako cz\u0119\u015bci do eksportu lub importu.<\/p>\n

Niekt\u00f3re dane zlecenia dystrybucji, takie jak ustawienia drukowania dokument\u00f3w, lokalne warto\u015bci walut, ilo\u015bci zadysponowane, konfiguracja artyku\u0142\u00f3w i ich elementy konfiguracji, a tak\u017ce wewn\u0119trzne atrybuty pomocnicze nie mog\u0105 by\u0107 importowane.<\/p>\n

Je\u015bli nie ma pewno\u015bci, kt\u00f3ry format jest odpowiedni dla pliku importu, nale\u017cy wykona\u0107 nast\u0119puj\u0105ce czynno\u015bci: Wprowadzi\u0107 przyk\u0142adowy dokument za po\u015brednictwem aplikacji Zlecenia dystrybucji<\/em> i wyeksportowa\u0107 go przy u\u017cyciu filtra dla importu w \u017c\u0105danym formacie z \u017c\u0105danymi atrybutami. Wynikowy plik przyk\u0142adowy mo\u017ce zosta\u0107 u\u017cyty jako szablon dla generowanych plik\u00f3w importu.<\/p>\n

Podczas importowania obowi\u0105zuj\u0105 te same zasady, co podczas edycji za po\u015brednictwem aplikacji. Na przyk\u0142ad artyku\u0142 w zapisanym elemencie nie mo\u017ce by\u0107 p\u00f3\u017aniej zmieniany. Warto\u015bci atrybut\u00f3w s\u0105 ignorowane, je\u015bli nie mo\u017cna ich przyj\u0105\u0107 w bie\u017c\u0105cym kontek\u015bcie. Ta sama logika jest stosowana przy okre\u015blaniu warto\u015bci domy\u015blnej, wi\u0119c import i aplikacja zachowuj\u0105 si\u0119 identycznie. To samo dotyczy kontroli.<\/p>\n

Wskaz\u00f3wka<\/div>
Istniej\u0105ce zlecenia dystrybucji mo\u017cna rozszerzy\u0107, importuj\u0105c dodatkowe dane. Istniej\u0105ce dane s\u0105 zast\u0119powane danymi importu, je\u015bli to mo\u017cliwe.<\/div><\/section>\n

Instrukcja: Import zlece\u0144 dystrybucji<\/h3>\n
    \n
  1. Aby zaimportowa\u0107 zlecenie dystrybucji nale\u017cy utworzy\u0107 aplikacj\u0119 Import danych<\/em>.<\/li>\n
  2. Wy\u015bwietli\u0107 filtr dla obiektu biznesowego: com.cisag.app.multiorg.obj.DistributionOrder
    \n\u2192Filtr do importowania zlece\u0144 dystrybucji zostanie otwarty.
    \n<\/em><\/li>\n
  3. W razie potrzeby nale\u017cy powieli\u0107 lub utworzy\u0107 nowy filtr dla tego obiektu biznesowego<\/li>\n
  4. W razie potrzeby mo\u017cna zmieni\u0107 ju\u017c wybrane atrybuty filtra.<\/li>\n
  5. Po wprowadzeniu zmian nale\u017cy wybra\u0107 przycisk [Import<\/strong>\u00a0danych<\/strong>] na standardowym pasku przycisk\u00f3w.
    \n\u2192<\/em>Otworzy si\u0119 okno dialogowe Import danych<\/em>.<\/span><\/li>\n<\/ol>\n
      \n
    1. W oknie dialogowym Import danych<\/em><\/span> mo\u017cna wprowadzi\u0107 ustawienia dla importowanego pliku. Opis p\u00f3l mo\u017cna znale\u017a\u0107 w dokumentacji Import danych<\/em><\/span>.<\/li>\n
    2. Nacisn\u0105\u0107 przycisk [W tle]<\/strong>.
      \n\u2192<\/em>Import zostanie wykonany.<\/span><\/li>\n<\/ol>\n

      Tworzenie nowych zlece\u0144 dystrybucji<\/h3>\n

      Minimalne wymagane atrybuty dla obiektu podstawowego:<\/p>\n\n\n\n\n
      Opis atrybutu<\/strong><\/td>\nAtrybut<\/strong><\/td>\n<\/tr>\n
      Rodzaj zlecenia dystrybucji <\/em><\/td>\nType<\/em><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

      Opcjonalnie mo\u017cna r\u00f3wnie\u017c przenie\u015b\u0107 numer za pomoc\u0105 importu. W takim przypadku numer okre\u015blony za pomoc\u0105 schematu numeracji zgodnie z rodzajem jest ignorowany. Ponadto nale\u017cy zastosowa\u0107 odpowiednie konwencje, aby upewni\u0107 si\u0119, \u017ce numer przypisany za pomoc\u0105 importu nie pasuje do numeru, kt\u00f3ry zosta\u0142 ju\u017c przypisany lub ma zosta\u0107 przypisany automatycznie w przysz\u0142o\u015bci.<\/p>\n

      Minimalne wymagane atrybuty dla obiektu Item<\/em>:<\/p>\n\n\n\n\n\n\n
      Opis atrybutu<\/strong><\/td>\nAtrybut<\/strong><\/td>\n<\/tr>\n
      Artyku\u0142 <\/em><\/td>\nItem<\/i><\/span><\/td>\n<\/tr>\n
      Ca\u0142kowita ilo\u015b\u0107<\/em><\/td>\ntotalQuantity<\/i><\/span><\/td>\n<\/tr>\n
      Pochodzenie ceny<\/em><\/p>\n

      (je\u015bli r\u00f3\u017cni si\u0119 od warto\u015bci domy\u015blnej zgodnie z rodzajem i je\u015bli pochodzenie ceny ma warto\u015b\u0107 R\u0119cznie<\/em>, cena brutto w walucie zgodnie z nag\u0142\u00f3wkiem, je\u015bli dotyczy)<\/td>\n

      		priceOriginType i grossPrice<\/i><\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

      Opcjonalnie mo\u017cna r\u00f3wnie\u017c wprowadzi\u0107 numer dla nowej pozycji.<\/p>\n

      Odpowiedni minimalny XML z atrybutami funkcjonalnymi i dwoma pozycjami ma na przyk\u0142ad nast\u0119puj\u0105c\u0105 zawarto\u015b\u0107:<\/p>\n

      <?xml version=\"1.0\" encoding=\"UTF-8\"?><\/code><\/p>\n

      <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\"><\/code><\/p>\n

      <DistributionOrder xmlns=\"com.cisag.app.multiorg.obj.DistributionOrder\"><\/code><\/p>\n

      <Type>100<\/Type><\/code><\/p>\n

      <Details><\/code><\/p>\n

      <Item>4711<\/Item><\/code><\/p>\n

      <totalQuantity><\/code><\/p>\n

      <amount>10<\/amount><\/code><\/p>\n

      <Uom>St.<\/Uom><\/code><\/p>\n

      <\/totalQuantity><\/code><\/p>\n

      <priceOriginType>MANUAL<\/priceOriginType><\/code><\/p>\n

      <grossPrice><\/code><\/p>\n

      <amount>11<\/amount><\/code><\/p>\n

      <Currency>EUR<\/Currency><\/code><\/p>\n

      <\/grossPrice><\/code><\/p>\n

      <\/details><\/code><\/p>\n

      <details><\/code><\/p>\n

      <Item>4712<\/Item><\/code><\/p>\n

      <totalQuantity><\/code><\/p>\n

      <amount>20<\/amount><\/code><\/p>\n

      <Uom>St.<\/Uom><\/code><\/p>\n

      <\/totalQuantity><\/code><\/p>\n

      <priceOriginType>MANUAL<\/priceOriginType><\/code><\/p>\n

      <grossPrice><\/code><\/p>\n

      <amount>12<\/amount><\/code><\/p>\n

      <Currency>EUR<\/Currency><\/code><\/p>\n

      <\/grossPrice><\/code><\/p>\n

      <\/Details><\/code><\/p>\n

      <\/DistributionOrder><\/code><\/p>\n

      <\/semiramis><\/code><\/p>\n

      W tym przyk\u0142adzie pozosta\u0142e atrybuty s\u0105 dodawane za pomoc\u0105 warto\u015bci domy\u015blnych zgodnie z danymi podstawowymi itp.<\/p>\n

      Mo\u017cna r\u00f3wnie\u017c zaimportowa\u0107 dodatkowe warto\u015bci i u\u017cy\u0107 atrybut\u00f3w technicznych zamiast atrybut\u00f3w funkcjonalnych. List\u0119 atrybut\u00f3w mo\u017cna znale\u017a\u0107 w tym rozdziale: Przegl\u0105d: Atrybuty<\/em><\/a>.<\/p>\n

      Wskaz\u00f3wka<\/div>
      Waluta r\u00f3\u017cni\u0105ca si\u0119 od warto\u015bci nag\u0142\u00f3wka dla ceny brutto jest ignorowana.<\/div><\/section>\n

      Funkcje specjalne podczas przetwarzania zam\u00f3wienia<\/h3>\n

      Aby znale\u017a\u0107 zlecenie dystrybucji przechowywane w bazie danych, wymagana jest jego identyfikacja techniczna (DistributionOrder:guid<\/em>) lub funkcjonalna (Type<\/em> [order type<\/em>] i nubmer<\/em>).<\/p>\n

      Dla pozycji mo\u017cna u\u017cy\u0107 wszystkich opcji importu – w szczeg\u00f3lno\u015bci usuwania. Identyfikacja techniczna (DistributionOrderDetail:guid<\/em>) lub funkcjonalna (number<\/em>) jest r\u00f3wnie\u017c wymagana do znalezienia zapisanej pozycji.<\/p>\n

      Zmiany za pomoc\u0105 importu s\u0105 mo\u017cliwe tylko wtedy, gdy \u017cadna weryfikacja tego nie uniemo\u017cliwia.<\/p>\n

      Automatyczne zwolnienie po imporcie<\/h3>\n

      Je\u015bli import zosta\u0142 przeprowadzony pomy\u015blnie, przetworzone zlecenie dystrybucyjne mo\u017ce zosta\u0107 zwolnione automatycznie po imporcie. Opcja ta jest szczeg\u00f3lnie przydatna w po\u0142\u0105czeniu ze statusem otwarcia W trakcie opracowania<\/em> (ustawienie w rodzaju zlecenia dystrybucji). Zapobiega to wykorzystaniu w kolejnych dokumentach zlecenia dystrybucyjnego, kt\u00f3re nie zosta\u0142o jeszcze w pe\u0142ni zaimportowane. Podczas zwolnienia zlecenie dystrybucji ma status Nieprawid\u0142owe<\/em>, wi\u0119c nie mo\u017cna go u\u017cy\u0107 r\u00f3wnie\u017c w tym kroku.<\/p>\n

      W przypadku tej funkcji nale\u017cy ustawi\u0107 atrybut bazy wirtualnej autoRelease<\/em> na warto\u015b\u0107 true<\/em> dla odpowiedniej instancji.<\/p>\n

      Je\u015bli ta funkcja jest aktywna i nie ma innych b\u0142\u0119d\u00f3w, w dzienniku komunikat\u00f3w wy\u015bwietlany jest dodatkowy komunikat informacyjny informuj\u0105cy, \u017ce zlecenie dystrybucji zosta\u0142o zwolnione automatycznie. Je\u015bli nie by\u0142o to mo\u017cliwe, pojawi si\u0119 ostrze\u017cenie.<\/p>\n

      Wskaz\u00f3wki dotycz\u0105ce importowania starszych danych<\/h3>\n

      Istniej\u0105 nast\u0119puj\u0105ce wskaz\u00f3wki dotycz\u0105ce importowania starszych danych:<\/p>\n