W niniejszym artykule opisano post\u0119powanie z aplikacj\u0105 Import danych<\/i> w odniesieniu do p\u00f3l zdefiniowanych przez u\u017cytkownika.<\/p>\n
Przedstawione zostan\u0105 og\u00f3lne kroki, kt\u00f3re obejmuj\u0105, m.in. kolejno\u015b\u0107 jak\u0105 nale\u017cy przestrzega\u0107 podczas importu metadanych.<\/p>\n
Ponadto, przedstawione zostan\u0105 r\u00f3wnie\u017c informacje na temat atrybut\u00f3w, kt\u00f3re s\u0105 niezb\u0119dne do importu.<\/p>\n
Opis aplikacji\u00a0Import danych<\/em>, obejmuj\u0105cy m.in. opisy p\u00f3l i przycisk\u00f3w, znajduje si\u0119 w artykule\u00a0Import danych<\/a>.<\/em><\/p>\n Rozszerzalny j\u0119zyk znacznik\u00f3w (XML)<\/strong>\u00a0\u2014 plik XML mo\u017ce by\u0107 u\u017cywany do zapisywania ustrukturyzowanych danych w pliku tekstowym. J\u0119zyk pliku umo\u017cliwia definiowanie, przesy\u0142anie, sprawdzanie i interpretowanie danych mi\u0119dzy aplikacjami i jest szczeg\u00f3lnie odpowiedni do wymiany danych strukturalnych. Dokumenty XML oddzielaj\u0105 tre\u015b\u0107, struktur\u0119 i informacje do wizualizacji. XML jest koordynowany i zdefiniowany jako standard przez W3C.<\/p>\n Rodzaj pola<\/strong> – pola zdefiniowane przez u\u017cytkownika cz\u0119sto maj\u0105 wsp\u00f3lne w\u0142a\u015bciwo\u015bci, kt\u00f3re zale\u017c\u0105 od rodzaju pola. Aby nie trzeba by\u0142o okre\u015bla\u0107 w\u0142a\u015bciwo\u015bci osobno dla ka\u017cdego pola u\u017cytkownika, mo\u017cna je pogrupowa\u0107 w rodzaje p\u00f3l. Rodzaje p\u00f3l obejmuj\u0105 wi\u0119c zestaw ustalonych w\u0142a\u015bciwo\u015bci dla p\u00f3l zdefiniowanych przez u\u017cytkownika. Podczas korzystania z rodzaju pola odpowiednie w\u0142a\u015bciwo\u015bci s\u0105 automatycznie przejmowane przez tworzone pole u\u017cytkownika.<\/p>\n Mo\u017cliwe rodzaje p\u00f3l u\u017cytkownika \u2014 a tym samym podstawa dla typ\u00f3w danych \u2014 mog\u0105 obejmowa\u0107: tekst, adres e-mail, URL, dat\u0119, dat\u0119 i godzin\u0119, klasyfikacj\u0119, kwot\u0119, kwot\u0119 w walucie lokalnej, cen\u0119, cen\u0119 w walucie lokalnej, liczb\u0119 dziesi\u0119tn\u0105, ilo\u015b\u0107, pole wyboru oraz Business Entity.<\/p>\n Metadane p\u00f3l zdefiniowanych przez u\u017cytkownika<\/strong> – metadane opisuj\u0105 wszystkie w\u0142a\u015bciwo\u015bci pola zdefiniowanego przez u\u017cytkownika. Obejmuj\u0105 one mi\u0119dzy innymi: typ pola (liczba, ci\u0105g znak\u00f3w, pole wyboru\u2026), nazw\u0119, etykiet\u0119 oraz dopuszczalne zakresy warto\u015bci. Dane u\u017cytkowe p\u00f3l zdefiniowanych przez u\u017cytkownika<\/strong> – dane u\u017cytkowe to wprowadzone warto\u015bci p\u00f3l u\u017cytkownika. To, jakie konkretne warto\u015bci s\u0105 dozwolone, okre\u015blaj\u0105 typ pola oraz ograniczenia zdefiniowane w jego metadanych. Dane u\u017cytkowe zawsze odnosz\u0105 si\u0119 do instancji encji, w kt\u00f3rej pole u\u017cytkownika jest u\u017cywane \u2014 s\u0105 wi\u0119c \u201epowi\u0105zane z instancj\u0105\u201d.<\/p>\n Tekst oddzielony separatorami (CSV)<\/strong>\u00a0\u2014 CSV (comma separated values<\/em>) to format pliku, w kt\u00f3rym warto\u015bci poszczeg\u00f3lnych kolumn s\u0105 oddzielone separatorem. Wiersze s\u0105 oddzielone znakami ko\u0144ca linii. Separator ten musi by\u0107 znany w celu zaimportowania pliku. Typowymi separatorami s\u0105 na przyk\u0142ad pojedynczy przecinek i \u015brednik. Dane zapisane w tym formacie mog\u0105 by\u0107 u\u017cywane i edytowane w wielu aplikacjach. Ze wzgl\u0119du na prost\u0105, niehierarchiczn\u0105 struktur\u0119 CSV, ten format danych nie nadaje si\u0119 do mapowania z\u0142o\u017conych struktur danych.<\/p>\n Tekst Unicode oddzielony tabulatorem (XLS)<\/strong>\u00a0\u2014 Ten format pliku jest podobny do CSV, ale tabulator jest okre\u015blony jako separator, a\u00a0Unicode<\/em>\u00a0jako kodowanie znak\u00f3w. Pliki w tym formacie mog\u0105 by\u0107 u\u017cywane mi\u0119dzy innymi przez program\u00a0Microsoft Excel<\/em>. Aby zapisa\u0107 ten format pliku w programie\u00a0Excel<\/em>, mo\u017ce by\u0107 konieczne okre\u015blenie formatu pliku w programie\u00a0Excel<\/em>.<\/p>\n W systemie ERP rozr\u00f3\u017cnia si\u0119 dwa rodzaje wymiany danych:<\/p>\n Wymiana danych pomi\u0119dzy systemami Comarch ERP Enterprise zosta\u0142a opisana w artyku\u0142ach Import danych<\/a><\/em> oraz Eksport danych<\/a><\/em>. Mo\u017cna korzysta\u0107 z r\u00f3\u017cnych format\u00f3w importu. Dost\u0119pne s\u0105 nast\u0119puj\u0105ce formaty:<\/p>\n Ka\u017cdy format ma specjalne w\u0142a\u015bciwo\u015bci, kt\u00f3re maj\u0105 wp\u0142yw na import danych, a zatem mo\u017cliwe formaty maj\u0105 zalety i wady.<\/p>\n W przypadku importu w formacie XML, wszystkie po\u017c\u0105dane dane mog\u0105 zosta\u0107 zaimportowane w jednej operacji importu.<\/p>\n Je\u017celi import jest wykonywany w formacie CSV, konieczne jest inne podej\u015bcie, poniewa\u017c w jednym pliku importu nie mog\u0105 zosta\u0107 przedstawione r\u00f3wnoleg\u0142e relacje 1:n mi\u0119dzy jednostkami biznesowymi. Mo\u017cliwe jest jednak zastosowanie powi\u0105za\u0144 i w ten spos\u00f3b zaimportowanie wi\u0119kszo\u015bci danych w ramach jednej operacji importu, r\u00f3wnie\u017c z wielu plik\u00f3w. Jest to bardzo istotne dla szybko\u015bci importu.<\/p>\n Je\u017celi nie jest pewne, kt\u00f3ry format pliku importu jest odpowiedni, nale\u017cy post\u0119powa\u0107 w nast\u0119puj\u0105cy spos\u00f3b: za pomoc\u0105 aplikacji Rodzaje p\u00f3l<\/i> zostaje utworzony przyk\u0142adowy rodzaj pola, a nast\u0119pnie jest on eksportowany z filtrem do importu w \u017c\u0105danym formacie z po\u017c\u0105danymi atrybutami. Utworzony w ten spos\u00f3b przyk\u0142adowy plik mo\u017ce zosta\u0107 u\u017cyty jako szablon dla plik\u00f3w importu. Aplikacja Rodzaje <\/i>p\u00f3l<\/i> zosta\u0142a u\u017cyta jedynie przyk\u0142adowo; mo\u017cna r\u00f3wnie\u017c wykorzysta\u0107 inne aplikacje do utworzenia takiego przyk\u0142adowego pliku. Na przyk\u0142ad Zasoby<\/i> w przypadku parametr\u00f3w lub Artyku\u0142y<\/i> dla Innych p\u00f3l<\/i>.<\/p>\n Pola dodatkowe s\u0105 stosowane w nast\u0119puj\u0105cych jednostkach biznesowych (Business Entity):<\/p>\n Inne pola<\/i> w aplikacjach Artyku\u0142y<\/i> i Partnerzy<\/i> oraz w Zarz\u0105dzaniu dokumentami<\/i><\/p>\n<\/li>\n Cechy artyku\u0142\u00f3w<\/p>\n<\/li>\n Parametry w danych podstawowych produkcji, takich jak zasoby, gniazda robocze i plany pracy<\/p>\n<\/li>\n Cechy konfiguracji<\/p>\n<\/li>\n<\/ul>\n Procedura importowania p\u00f3l zdefiniowanych przez u\u017cytkownika w du\u017cym stopniu zale\u017cy od danego przypadku u\u017cycia. Nale\u017cy dokona\u0107 podstawowego rozr\u00f3\u017cnienia, czy pola s\u0105 „niezale\u017cne od instancji”, jak w przypadku Innych p\u00f3l<\/em> w aplikacjach Artyku\u0142y<\/em> i Partnerzy<\/em>, czy „zwi\u0105zane z instancj\u0105”, jak w przypadku parametr\u00f3w w operacji. Obowi\u0105zuj\u0105 nast\u0119puj\u0105ce zasady:<\/p>\n w przypadku p\u00f3l niezale\u017cnych od instancji import danych u\u017cytkowych zawsze odbywa si\u0119 oddzielnie od importu metadanych.<\/p>\n<\/li>\n w przypadku p\u00f3l zale\u017cnych od instancji metadane s\u0105 importowane \u0142\u0105cznie z danymi u\u017cytkowymi.<\/p>\n<\/li>\n je\u017celi w metadanych jawnie referencjonowane s\u0105 typy p\u00f3l, mo\u017cliwe jest ich wcze\u015bniejsze zaimportowanie.<\/p>\n<\/li>\n dla p\u00f3l, w kt\u00f3rych dopuszczona jest \u201elista warto\u015bci\u201d, dane u\u017cytkowe tych p\u00f3l s\u0105 traktowane jako jedna warto\u015b\u0107. Oznacza to, \u017ce podczas eksportu wszystkie warto\u015bci wpisane w polu zostan\u0105 wyeksportowane, a podczas importu wszystkie warto\u015bci obecne w pliku XML zostan\u0105 zapisane.<\/p>\n<\/li>\n Je\u017celi w pliku XML brakuje warto\u015bci, kt\u00f3re by\u0142y wcze\u015bniej obecne w bazie danych, to po imporcie w bazie pozostaj\u0105 wy\u0142\u0105cznie warto\u015bci znajduj\u0105ce si\u0119 w XML. Oznacza to, \u017ce usuni\u0119cia nie s\u0105 wykonywane na podstawie atrybutu mode<\/em> w XML.<\/p>\n<\/li>\n<\/ul>\n Spos\u00f3b post\u0119powania podczas importu p\u00f3l u\u017cytkownika nale\u017cy dobra\u0107 w zale\u017cno\u015bci od konkretnego przypadku. Wyr\u00f3\u017cnia si\u0119 nast\u0119puj\u0105ce warianty:<\/p>\n Inne pola (metadane niezale\u017cne od instancji)<\/p>\n<\/li>\n Parametry (metadane zale\u017cne od instancji)<\/p>\n<\/li>\n Nadpisane parametry (metadane zale\u017cne od instancji)<\/p>\n<\/li>\n Cechy artyku\u0142\u00f3w (metadane niezale\u017cne od instancji)<\/p>\n<\/li>\n<\/ul>\n W kolejnych rozdzia\u0142ach przedstawiono procedury importu i eksportu p\u00f3l u\u017cytkownika wraz z ich specyficznymi uwagami:<\/p>\n Import danych<\/p>\n<\/li>\n Eksport danych<\/p>\n<\/li>\n<\/ul>\n Procedury oraz szczeg\u00f3lne zasady dotycz\u0105ce importu p\u00f3l u\u017cytkownika zosta\u0142y opisane w nast\u0119puj\u0105cych rozdzia\u0142ach:<\/p>\n Rodzaje p\u00f3l<\/em><\/a><\/p>\n<\/li>\n Specyfika importu rodzaj\u00f3w p\u00f3l<\/a><\/em><\/p>\n<\/li>\n Import metadanych Innych p\u00f3l<\/em><\/a><\/p>\n<\/li>\n<\/ul>\n W pliku importu wszystkie atrybuty musz\u0105 by\u0107 zgodne z wymagan\u0105, poprawn\u0105 struktur\u0105 (szczeg\u00f3\u0142y w rozdziale: Przegl\u0105d: Atrybuty<\/a><\/em>).<\/p>\n Instrukcja:<\/p>\n Otworzy\u0107 aplikacj\u0119 Import danych<\/em>.<\/p>\n<\/li>\n Wy\u015bwietli\u0107 filtr lub jeden z dost\u0119pnych filtr\u00f3w dla tego obiektu biznesowego: W razie potrzeby zduplikowa\u0107 istniej\u0105cy filtr lub utworzy\u0107 nowy dla tego obiektu biznesowego.<\/p>\n<\/li>\n Wybrane atrybuty filtra s\u0105 ju\u017c zaznaczone. W razie potrzeby mo\u017cna je dostosowa\u0107.<\/p>\n<\/li>\n Na standardowym pasku nale\u017cy wybra\u0107 przycisk [Importuj dane<\/strong>]. Otwarte zostaje okno dialogowe\u00a0Import danych.<\/em><\/p>\n<\/li>\n W oknie dialogowym mo\u017cliwe jest wprowadzenie dodatkowych ustawie\u0144 pliku importu.\u00a0Import mo\u017cna uruchomi\u0107 przyciskiem [W<\/strong>\u00a0tle<\/strong>] lub [Natychmiast<\/strong>].<\/p>\n<\/li>\n<\/ol>\n <Datatype xmlns=\u201dcom.cisag.app.general.extension.obj.Datatype\u201d><\/p>\n <guid>522C0000-D7C3-101F-A0-86-00001D646484<\/guid><\/p>\n <code>100<\/code><\/p>\n <type>VALUESET<\/type><\/p>\n <label>rozmiar roweru<\/label><\/p>\n <description>rozmiar roweru<\/description><\/p>\n <multiValue>false<\/multiValue><\/p>\n <classification><\/classification><\/p>\n <maxLength>0<\/maxLength><\/p>\n <definedValues>0<\/definedValues><\/p>\n <businessEntity xsi:nil=\u201dtrue\u201d\/><\/p>\n <dateRangeRestricted>false<\/dateRangeRestricted><\/p>\n <dayTypeRestricted>false<\/dayTypeRestricted><\/p>\n <dayOfWeekRestricted>false<\/dayOfWeekRestricted><\/p>\n <currencyRestricted>false<\/currencyRestricted><\/p>\n <numericRangeRestricted>false<\/numericRangeRestricted><\/p>\n <uomTypeRestricted>false<\/uomTypeRestricted><\/p>\n <uomRestricted>false<\/uomRestricted><\/p>\n <organizationHierarchyType><\/organizationHierarchyType><\/p>\n <Restrictions><\/p>\n <ValueSetValues><\/p>\n <description>26\u2033<\/description><\/p>\n <label>rozmiar ramy 26 cali<\/label><\/p>\n <value>1<\/value><\/p>\n <\/ValueSetValues><\/p>\n <ValueSetValues><\/p>\n <description>28\u2033<\/description><\/p>\n <label>rozmiar ramy 28 cali<\/label><\/p>\n <value>2<\/value><\/p>\n <\/ValueSetValues><\/p>\n <ValueSetValues><\/p>\n <description>30\u2033<\/description><\/p>\n <label>rozmiar ramy 30 cali<\/label><\/p>\n <value>3<\/value><\/p>\n <\/ValueSetValues><\/p>\n <ValueSetValues><\/p>\n <description>30\u2033<\/description><\/p>\n <label>rozmiar ramy 30 cali<\/label><\/p>\n <value>3<\/value><\/p>\n <\/ValueSetValues><\/p>\n <NumericValues\/><\/p>\n <\/Restrictions><\/p>\n <\/Datatype><\/p>\n <\/div><\/section>\n Podczas importu\/eksportu typ\u00f3w p\u00f3l nale\u017cy uwzgl\u0119dni\u0107 nast\u0119puj\u0105ce aspekty:<\/p>\n W aplikacji Rodzaje p\u00f3l<\/em> dla typu pola Pole wyboru<\/em> poszczeg\u00f3lne elementy listy mog\u0105 zosta\u0107 oznaczone jako przeznaczone do usuni\u0119cia. Informacja o tym, czy dany element listy posiada znacznik usuni\u0119cia, przechowywana jest w atrybucie updateInfo<\/em>. W rezultacie nale\u017cy rozr\u00f3\u017cni\u0107 dwa przypadki zwi\u0105zane z atrybutem deleteTime<\/em>. Atrybut ten znajduje si\u0119 w nast\u0119puj\u0105cej strukturze: folder Restrictions<\/em>, podfolder ValueSetValues<\/em>, podfolder UpdateInfo<\/em>.<\/p>\n Atrybut deleteTime<\/em> jest wybrany – w\u00a0takim przypadku eksportowane s\u0105 wszystkie elementy listy.<\/p>\n<\/li>\n Atrybut deleteTime<\/em> nie jest wybrany – eksportowane s\u0105 tylko elementy listy bez znacznika usuwania.<\/p>\n<\/li>\n<\/ul>\n Podczas importu informacja o znaczniku usuni\u0119cia \u2014 je\u015bli jest obecna w pliku eksportu \u2014 zostaje normalnie zaimportowana do systemu docelowego. W systemie docelowym rekord oznaczony do usuni\u0119cia jest odpowiednio wizualizowany.<\/p>\nDefinicje<\/h3>\n
\nTo, jakie w\u0142a\u015bciwo\u015bci posiada dane pole, zale\u017cy \u2014 opr\u00f3cz og\u00f3lnych atrybut\u00f3w \u2014 od jego typu.
\nMetadane mog\u0105 zosta\u0107 wprowadzone bezpo\u015brednio podczas tworzenia nowego pola lub mog\u0105 zosta\u0107 przej\u0119te z istniej\u0105cych rodzaj\u00f3w p\u00f3l.<\/p>\nInformacje og\u00f3lne<\/h3>\n
\n
\nNiniejszy artyku\u0142 opisuje import z system\u00f3w \u017ar\u00f3d\u0142owych przy u\u017cyciu aplikacji Import danych<\/a><\/em>.<\/p>\n\n
Cechy szczeg\u00f3lne p\u00f3l dodatkowych<\/h4>\n
\n
\n
Instrukcje<\/h3>\n
\n
\n
Import danych<\/h4>\n
\n
<\/a>Rodzaje p\u00f3l<\/h5>\n
\n
com.cisag.app.general.extension.obj.Datatype<\/em>
Zostanie wy\u015bwietlony filtr dla importu typ\u00f3w p\u00f3l.<\/p>\n<\/li>\n<\/a>Specyfika importu rodzaj\u00f3w p\u00f3l<\/h5>\n
\nW filtrze eksportu udost\u0119pniany jest osobny folder zawieraj\u0105cy atrybuty powi\u0105zane z updateInfo<\/em>. Konkretnym atrybutem przekazuj\u0105cym informacj\u0119 o znaczniku usuni\u0119cia jest deleteTime<\/em>. W atrybucie tym zapisywany jest czas ustawienia znacznika usuni\u0119cia w formie znacznika czasowego.<\/p>\n\n
<\/a>Import metadanych Inne pola<\/em><\/h5>\n