Informatyzacja Przedsiębiorstw Microsoft Dynamics NAV 2016 Development Environment XML_PORT Izabela Szczęch Informatyzacja Przedsiębiorstw Strona 1
Plan zajęć 1 Utworzenie XMLportu do eksportu danych w formacie XML... 3 2 Utworzenie XMLportu do importu danych w formacie XML... 5 3 Utworzenie XMLportu do eksportu danych tekstowych... 6 3.1 Format pliku Fixed... 6 3.2 Format pliku Variable... 11 4 Utworzenie XMLportu do importu danych tekstowych... 13 4.1 Format pliku Variable... 13 Izabela Szczęch Informatyzacja Przedsiębiorstw Strona 2
1 Utworzenie XMLportu do eksportu danych w formacie XML Do ćwiczenia zostanie wykorzystana tabela 15 G/L Account, która posiada wiele pól typu FlowField. Pola FlowField muszą zostać obliczone przed ich wyeksportowaniem. Ćwiczenie krok po kroku: 1. Uruchom Object Designer, przejdź do XMLport i kliknij New. 2. Otwórz okno własności i uzupełnij: a. Direction: Export b. Format: XML c. UseRequestPage: No 3. Zamknij okno własności. 4. W pierwszej pustej linii na liście węzłów wpisz: Izabela Szczęch Informatyzacja Przedsiębiorstw Strona 3
5. Przejdź do następnej linii i wpisz tabelę źródłową oraz zrób wcięcie: 6. Przejdź do następnej linii i wpisz jakie pola mają zostać wyeksportowane z tabeli 15 G/L Account, zrób wcięcie: 7. Przejdź do własności elementu GL_Account i ustaw: a. SourceTableView: SORTING(No.) b. CalcFields: Balance at Date,Net Change 8. Zamknij okno własności. 9. Skompiluj i zapisz XMLport z numerem 50000 i nazwą G/L Account Export XML. Izabela Szczęch Informatyzacja Przedsiębiorstw Strona 4
10. Uruchom utworzony XMLport. 11. Zapisz utworzony przez system plik.xml z wyeksportowanymi danymi, a następnie obejrzyj go (np.: w Internet Explorer): 2 Utworzenie XMLportu do importu danych w formacie XML Analogicznie do poprzedniego zadania, przygotuj XMLport (np. o numerze 50001 i nazwie Vehicle Import XML ) do importu następujących danych do tabeli 50000 Vehicle (przykładowy plik Vehicle Import.xml z danymi do importu jest na stronie przedmiotu): Izabela Szczęch Informatyzacja Przedsiębiorstw Strona 5
3 Utworzenie XMLportu do eksportu danych tekstowych Istnieją cztery typy XMLportów dla danych tekstowych: eksport/import i dla każdego z nich typ pliku fixed lub variable. Ćwiczenie pokazuje jak utworzyć XMLport do eksportu dla obu typów pliku. Do ćwiczenia zostanie wykorzystana tabela 15 G/L Account, która posiada wiele pól typu FlowField. Pola FlowField muszą zostać obliczone przed ich wyeksportowaniem. 3.1 Format pliku Fixed Format fixed charakteryzuje się tym, że długości pól są stałe i należy je zdefiniować. Ćwiczenie krok po kroku: 1. Uruchom Object Designer i przejdź do XMLportów. 2. Kliknij przycisk New i utwórz nowy XMLport z pierwszym węzłem o nazwie np. "Root". 3. We właściwościach XMLportu ustaw właściwość: a. "Direction" na "Export" (aby dostępny był tylko eksport, a nie wybór między importem i eksportem), b. "TextEncoding" na "UTF-8" (do wyboru także kodowanie UTF-16, WINDOWS oraz MS-DOS), c. "Format " na "Fixed Text". 4. Zamknij okno właściwości XMLport'u. Izabela Szczęch Informatyzacja Przedsiębiorstw Strona 6
5. Dodaj do struktury XMLport'u kolejne węzły (powiązanie z tabelą 15 G/L Account oraz jej odpowiednimi polami). Ustaw odpowiednie wcięcia węzłów. 6. We właściwościach każdego węzła powiązanego z polem tabelki ustaw właściwość "Width". Przykład dla węzła "No.": Proponowane wartości właściwości "Width" dla poszczególnych węzłów: "No."-20, "Name" - 35, "BalanceAtDate" - 20, "NetChange" - 20. Izabela Szczęch Informatyzacja Przedsiębiorstw Strona 7
7. Uruchom właściwości węzła GLAccount i ustaw własność CalcFields na Balance at Date,Net Change. To są pola typu FlowField i muszą zostać obliczone przed ich wyeksportowaniem. 8. Zamknij okno właściwości. 9. Skompiluj i zapisz XMLport pod numerem 50002 i nazwą G/L Account Export Fixed. 10. Uruchom XMLport G/L Account Export Fixed (50002). Izabela Szczęch Informatyzacja Przedsiębiorstw Strona 8
11. Pojawi się okno "RequestPage", w którym można ustawiać opcje sortowania, filtrowania etc. 12. Klikamy "OK" i otwieramy bądź zapisujemy plik z wyeksportowanymi danymi. Izabela Szczęch Informatyzacja Przedsiębiorstw Strona 9
Uwaga: Jeśli właściwość XMLportu "Direction" byłaby ustawiona na "Both", wówczas poprzez "RequestPage" można by też wybrać czy wykonujemy import czy eksport danych, jak pokazano na rysunku poniżej: Jeśli możliwy jest tylko eksport (lub tylko import), a opcje sortowania i filtrowania nie są potrzebne, wówczas możemy nie wyświetlać okna "RequestPage". W tym celu należy ustawić właściwość XMLport'u "UseRequestPage" na "No". Izabela Szczęch Informatyzacja Przedsiębiorstw Strona 10
3.2 Format pliku Variable Format variable charakteryzuje się tym, że pola są oddzielane separatorem. Ćwiczenie krok po kroku: 1. Otwórz w trybie projektowania XMLport G/L Account Export Fixed (50002). 2. Kliknij Plik Save As, zapisz XMLport jako 50003 G/L Account Export Variable. 3. Otwórz okno własności XMLportu i ustaw: a. Format: Variable Text b. FieldSeparator: ; Ustawienie właściwości Format na Variable Text powoduje, że system ignoruje właściwości Width dla poszczególnych węzłów. Właściwość FieldDelimiter pozwala ująć każde eksportowane pole w znaczniki. Domyślnie w cudzysłów. 4. Zamknij okno własności. 5. Skompiluj i zamknij XMLport. 6. Uruchom XMLport i zapisz wyeksportowany plik jako GLAccount_Data_Variable.txt. Izabela Szczęch Informatyzacja Przedsiębiorstw Strona 11
7. Otwórz plik w notatniku: 8. Zmień nazwę pliku na GLAccount_Data_Variable.csv i uruchom go w Excelu. Izabela Szczęch Informatyzacja Przedsiębiorstw Strona 12
4 Utworzenie XMLportu do importu danych tekstowych Ćwiczenie pokazuje jak utworzyć XMLport do importu dla plików w formacie variable. Import dla plików fixed wygląda analogicznie, ale jest bardzo rzadko wykorzystywany, bo każde pole musi mieć stałą, określoną długość w pliku, z którego następuje import. W ćwiczeniu zostanie wykorzystana tabela 50000 Vehicle utworzona podczas ćwiczeń z tabelami. 4.1 Format pliku Variable Ćwiczenie krok po kroku: 1. Przygotuj następujące dane do importu w Excelu. Następnie klikamy Plik Zapisz jako i wybieramy opcję CSV (MS-DOS). 2. Uruchom Object Designer i utwórz nowy XMLport o nazwie Vehicle Import Variable (50004). XMLport ma być połączony z tabelą Vehicle (50000) i zawierać następujące węzły (należy pamiętać o odpowiednich wcięciach): Izabela Szczęch Informatyzacja Przedsiębiorstw Strona 13
3. Otwórz właściwości XMLportu i ustaw poniższe właściwości, zaczynając od właściwości Format Variable Text: 4. Zamknij okno własności. 5. Skompiluj i zapisz XMLport. 6. Uruchom XMLport i zaimportuj przygotowany plik. 7. Uruchom tabelę i sprawdź zaimportowane dane: Izabela Szczęch Informatyzacja Przedsiębiorstw Strona 14