Eksport danych z użyciem szablonów xslt

Dzięki funkcjonalności obsługi szablonów XSLT możliwe jest eksportowanie danych ze spraw praktycznie do dowolnej postaci XML, text, html, a nawet MS Excel czy MS Word

 

Co to jest XSLT?

 

XSLT (ang. eXtensible Stylesheet Language Transformations) – oparty na XML język przekształceń dokumentów XML.

 

Ponieważ AMODIT dostarcza dane dotyczące sprawy w postaci XML, to używając pliku przekształceń XSLT możemy uzyskać np: inną postać pliku XML np taką jaką wymaga Comarch Optima (zobacz opis tutaj), albo przekształcić generowany przez ABBYY FlexiCapture plik XML do postaci wymaganej przez AMODIT (zobacz opis tutaj).

 

Aby przystąpić do tego zadania musimy wiedzieć kilka rzeczy:

  1. Jaka jest struktura XML, w której AMODIT zwraca dane?
  2. Jak przygotować plik XSLT uwzględniający dane z XML zwracanego przez AMODIT?
  3. Gdzie i jak załączyć szablon XSLT?
  4. Jak przygotować eksport wielu spraw do jednego pliku wynikowego?

Struktura pliku XML, którą zwraca AMODIT

W jakich sytuacjach będziemy mieli do czynienia z danymi sprawy w postaci XML:

  • gdy użyjemy funkcji GetXML() w ramach reguł
  • gdy będzie dostępny szablon typu xslt i użytkownik kliknie go, aby pobrać plik. Wtedy do przekształcenia danych zostanie przekazany XML z danymi ze sprawy
  • gdy wywołamy metodę GetCase() poprzez WebService

Poniżej przykładowy formularz sprawy a pod nim odpowiadająca mu struktura danych w postaci XML


   
    Proces ABC (52015)
    1
    2019-07-18 20:22:59
    1
    2019-07-18 20:25:16
    1
    0001-01-01 00:00:00
    0
    565
    944
    True
    False
    52015
    
    
    Read
    Wartość w polu 1
    2 000,00
    2019-07-18
    
        
            Toruń
            100,00
            przykładowy tekst
        
    
   

Metoda GetCase(caseId) dostępna poprzez WebService zwraca tę samą treść ale bez nadrzędnego tagu

 

Przykład pliku XSLT dający w wyniku plik tekstowy






    
    Nazwa pola 1;Nazwa pola 2;

    
    


    
        
                ;
        ;

        
        

     



Gdzie załączyć szablon xslt

Plik z treścią jak wyżej nazwany np szablon.xslt należy załączyć tak jak każdy inny szablon w zakładce 'SZABLONY’ definicji procesu.

Jeżeli chcemy aby szablon był dostępny z poziomu sprawy, to należy wskazać na którym etapie procesu ma być dostępny.

Można podać przyjazną nazwę, którą zobaczy użytkownik.

Jeżeli planujemy, że nie dopuszczamy eksportu z poziomu pojedynczej sprawy, a jedynie eksport masowy, to nie wskazujemy żadnego etapu dla szablonu i postępujemy wg poniższych wskazówek.

Eksport wielu spraw

Mając załączony plik xslt jako szablon, możemy go użyć do przygotowania masowego eksportu danych z wielu spraw. Do tego celu wykorzystamy „Wyszukiwanie zaawansowane”.

W Wyszukiwaniu zaawansowanym:

  • wskazujemy nasz proces,
  • budujemy zestawienie.
    • Wybrane do wyświetlenia kolumny nie mają wpływu na eksport danych, gdyż bierze on pod uwagę te dane, które autor przewidział w treści pliku xslt.
    • użyjmy filtrów aby wyświetlały się określone sprawy np z konkretnego etapu
  • zapisujemy definicję wyszukiwania pod dowolną nazwą np „Faktury do eksportu”
  • w opcjach wybieramy „Ustawienia eksportu”
    • wskazujemy plik xslt
    • w zależności co plik xslt będzie produkował wybieramy odpowiednie rozszerzenie pliku np csv
    • można też wskazać regułę ręczną, która ma się wykonać dla każdej wyeksportowanej sprawy
  • jeszcze raz zapisujemy

Od teraz użytkownik korzystający z tego zestawienia, w opcji „Pobierz” będzie miał dodatkową pozycję z eksportem wg szablonu xslt. Wyświetli się nazwa podana przy załączaniu szablonu do definicji procesu.

Jeżeli z tych samych danych chcemy mieć wiele różnych eksportów w oparciu o różne pliki xslt, to należy dla każdego przypadku użycia xslt do eksportu przygotować nowe wyszukiwanie zaawansowane.