Runbook

Import plików XML

Zautomatyzowany import i eksport danych za pośrednictwem platformy StudioSystem to jedna z najpotężniejszych funkcji, jakie oferuje.

Kolejną wielką zaletą platformy StudioSystem jest możliwość importowania danych z plików XML. XML (eXtensible Markup Language) umożliwia firmie łatwe organizowanie i przechowywanie danych, ułatwiając udostępnianie i przesyłanie. Importując dane XML, firmy mogą szybko identyfikować i interpretować ważne informacje o klientach oraz podejmować odpowiednie decyzje. Może to zaoszczędzić firmom znaczną ilość czasu i pieniędzy podczas analizowania zachowań klientów.

Ostatecznie platforma StudioSystem oferuje wiele korzyści firmom, które chcą usprawnić swoją działalność i zaoszczędzić czas. Dzięki funkcjom, takim jak automatyczny import i eksport, usprawnione zarządzanie i zaawansowana analityka, StudioSystem jest potężnym rozwiązaniem dla każdej organizacji, która chce poprawić wydajność i rentowność.

Transakcja: /role_sys/import_xml.aspx

Transakcja import XML pozwala na zaimportowanie do bazy danych informacji z pliku XML o ustalonym przez Software Studio szablonie.

Przygotowany szablon jest uniwersalny i pozwala przechowywać dowolne informacje w formie tabelarycznej.

Spis treści

Szablon pliku XML.

Źródło pliku XML.

Z serwera FTP.

Ze ścieżki w katalogu aplikacji WWW…

Procesowanie pliku.

Procesowanie danych.

Ograniczenia.

Aby plik XML mógł zostać zaimportowany poprzez transakcję uniwersalną musi posiadać ustalony schemat.

<?xml version=”1.0″?>

<Workbook id=”0″>

<Table>

<Row id=”0″>

<Cell>KOL1</Cell>

<Cell>KOL2</Cell>

<Cell>KOL3</Cell>

<Cell>KOL4</Cell>

<Cell>KOL5</Cell>

</Row>

<Row id=”1″>

<Cell>VAL11</Cell>

<Cell>VAL21</Cell>

<Cell>VAL31</Cell>

<Cell>VAL41</Cell>

<Cell>VAL51</Cell>

<Row id=”2″>

<Cell>VAL12</Cell>

<Cell>VAL22</Cell>

<Cell>VAL32</Cell>

<Cell>VAL42</Cell>

<Cell>VAL52</Cell>

</Table>

</Workbook>

! Należy zachować powyższą strukturę.

! Element Row o parametrze id=0 jest traktowany jako wiersz nagłówkowy, powinien zawierać nazwy kolumn.

Workbook (zawsze 1 element) Table (Zawsze 1 element) Row (dowolna ilość elementów)

Plik może by importowany:

Z serwera FTP

Aby importować plik należy podać następujące parametry do wywołania transakcji:

  • FTP_UID

UID zapytania z tabeli _code_sql, które w kolumnach: URL, USER, PASS zwróci kolejno adres serwera ftp, login użytkownika, hasło użytkownika.

  • INSERT_UID

UID zapytania z tabeli _code_sql, które zostanie wykonane dla każdego wiersza z pliku XML.

  • SOURCE

Wartość stała: SS-FTP

Pobierany jest pierwszy plik z katalogu /IN na serwerze FTP.

Ze ścieżki w katalogu aplikacji WWW

  • PATH_UID

UID zapytania z tabeli _code_sql, które w kolumnie PATH zwróci adres folderu źródłowego - adres względy (w folderze aplikacji, np. SELECT 'App_FTP\TST\’ AS PATH)

  • INSERT_UID
  • SOURCE

Wartość stała: SS-LOC

  1. Wyszukany zostaje plik z rozszerzeniem .XML we wskazanym w parametrze adresie.
  2. Plik jest pobierany do ścieżki /App_Import/XML/ a w lokalizacji źródłowej jego nazwa zostaje zmieniona - dodane zostaje rozszerzenie .arch - plik nie zostanie więcej razy zaimportowany.
  3. Plik jest odczytywany i jego struktura przekładana na obiekt C#. Jeśli wystąpi błąd - struktura będzie niezgodna - to informacja zostanie zapisana w error logu.

Dane z pliku są przetwarzane na obiekt typu DataTable a następnie każdy wiersz jest przesyłany do bazy danych za pomocą polecenia odczytanego z tabeli _code_sql. Transakcja odczytuje nazwy kolumn z pliku XML i zamienia wartości z zapytania na odczytane z DataTable. Podmieniane są również zmienne:

@_WORKBOOK_ID - parametr ID z elementu Workbook @_REFNO_IMPORT - refno nadane na początku transakcji, wspólne dla wszystkich pozycji oraz zapisów w logu @_USERNAME - login użytkownika wywołującego transakcję @_FILE_NAME - ścieżka do pliku

Np. Zapytanie w _code_sql:

EXEC dbo.insertImport(‘@_ID’, ‘@_REFNO_IMPORT’, ‘@KOL1’, ‘@KOL2’, ‘@KOL3’)

Zaowocuje dla podanego wyżej pliku wywołaniem dla pierwszego wiersza:

EXEC dbo.insertImport('0', '677354627567', 'VAL11', 'VAL21', 'VAL31')

  1. Należy przygotować funkcję wgrywania plików przez WWW jako źródło danych.
  2. Dla źródeł SS-FTP i SS-LOC należy przygotować opcję jednoczesnego importu wszystkich znalezionych plików.
  3. Należy dodać parametryzację opcji usuwania plików ze ścieżki źródłowej.

Dokumentacja techniczna StudioSystem. Pytania wdrożeniowe: kontakt z SoftwareStudio.