Konfigurowanie zleceń transformacji XML

Można utworzyć zlecenie transformacji XML mające na celu transformację pliku XML do odpowiedniego formatu wyjściowego oraz przypisanie pól metadanych Capture z pliku XML. Można to zrobić, konfigurując obsługiwane kombinacje definicji procesora XSLT i dostarczając własny plik XSLT. Dodatkowo można odwzorować wyrażenie XPath na pola metadanych Capture. Uzyskany po konwersji plik może być używany przez aplikacje innych podmiotów, zgodnie z ich wymaganiami biznesowymi.

Uwaga:

Nie można tworzyć zleceń transformacji XML w usłudze Oracle Content Management w edycji Starter. Aby można było używać tej funkcji, należy uaktualnić usługę Oracle Content Management do edycji Premium. Więcej informacji jest dostępnych w podręczniku Edycja Starter a edycja Premium.

  1. Z okienka "Procedury" (po lewej stronie) wybrać procedurę.

    Po prawej stronie zostaną wyświetlone strony konfiguracyjne wybranej procedury.

  2. Otworzyć kartę Przetwarzanie.
  3. W tabeli Zlecenia transformacji XML kliknąć na ikonie Dodaj zlecenie transformacji XML albo Edytuj zlecenie transformacji XML (aby edytować już istniejące zlecenie).

    Zlecenie transformacji XML można także skopiować; należy je wybrać, kliknąć na ikonie Kopiuj zlecenie transformacji, po czym — gdy wyświetli się monit — wprowadzić nową nazwę. Skopiowanie zlecenia pozwala na szybkie zduplikowanie zlecenia, a następnie jego modyfikację.

  4. Na stronie Wybór dokumentu:

    1. W sekcji Wybór dokumentu:
      • Podać nazwę i opis zlecenia.

      • Aby przetworzyć zlecenie transformacji XML dla określonych profili dokumentów, wybrać jeden lub większą liczbę profili dokumentów, wyszczególnionych w polu Ogranicz do profili dokumentów. Aby przetworzyć dokumenty dla wszystkich zdefiniowanych profili dokumentów, wybrać opcję Wszystkie.

    2. Z rozwijanej listy Miejsce docelowe wyniku transformacji wybrać odpowiednią opcję:
      • Dokument: Pierwotny dokument zostanie zastąpiony wynikami transformacji. Jeśli trzeba, można także zmienić profil dokumentu.
      • Dokument, zachowaj kopię: Zostanie zachowana kopia dokumentu pierwotnego. Jeśli ta opcja zostanie wybrana, można także wybrać profil dokumentu. Trzeba jednak z rozwijanej listy Zachowaj typ załącznika wybrać typ załącznika.
      • Załącznik: Wyniki transformacji zostaną zachowane jako załącznik. Z rozwijanej listy Nowy typ załącznika trzeba wybrać typ załącznika.
      • Pole Capture: Wyniki transformacji zostaną zachowane w polu Capture. Trzeba z rozwijanej listy Pole Capture wybrać Pole tekstowe.
    3. W sekcji Wybór załączników:
      1. Zaznaczyć pole wyboru Przetwórz załączniki, jeśli ma zostać zastosowany wybór dokonany na poprzednich etapach.
      2. Ograniczyć wybór do wymaganych typów załączników, zaznaczając pola wyboru dostępnych typów załączników. Można także wybrać wszystkie.
      3. Wybrać miejsce docelowe wyniku transformacji:
        • Załącznik: Jest dostępna opcja zmiany typu załącznika.
        • Załącznik, zachowaj kopię: Jest dostępna opcja wyboru typu załącznika. Trzeba jednak z rozwijanej listy Zachowaj typ załącznika wybrać typ załącznika.
        • Pole Capture: Trzeba wybrać Pole tekstowe lub Pole XML.
  5. Na stronie Transformacja - Definicja transformacji:
    1. Zaznaczyć pole wyboru Wykonaj transformację XML (jeśli nie jest już zaznaczone), aby umożliwić edytowanie wartości pól na tej stronie. Czyszcząc to pole wyboru, uniemożliwia się edytowanie, przy czym w polach pozostają ostatnio zapisane wartości. To pole wyboru można wyczyścić, gdy transformacja XML nie jest wymagana.
    2. W sekcji Motor transformacji:
      • Wybrać zgodne opcje Wersja XSLT, Procesor i Wersja procesora. Można wybrać systemowe ustawienia domyślne albo dokonać wyboru z dostępnych wersji XSLT zgodnych z procesorami Xalan i Saxon-HE oraz ich wersjami.
      • Określić Rozszerzenie pliku wyjściowego, takie jak XML, HTML, JSON lub text.

        Uwaga:

        Jeśli rozszerzenie pliku wyjściowego będzie inne niż XML, strona "Odwzorowanie pola" zostanie wyłączona.
    3. Aby wykonać transformację, wysłać lub określić XSLT w sekcji Arkusz stylów XML.
    4. Zawierane w XSLT parametry powinny być zdefiniowane w tabeli "Parametry". W tym celu należy:
      1. W tabeli Parametry kliknąć na ikonie Dodaj parametry.
      2. W oknie dialogowym Dodawanie parametrów XSLT dodać nazwę parametru i przypisać wartość. Dla parametru można dodać wartość tekstową albo zestawić wartość metadanych.
      3. Zdefiniować wymagane parametry, powtarzając punkty i oraz ii.

        Uwaga:

        Jeśli do parametrów, które istnieją w XSLT, nie zostaną przypisane wartości albo zostaną przypisane wartości do parametrów nieistniejących w XSLT, to nie będzie można zapisać swojego zlecenia transformacji (przy próbie zapisania pojawi się informujący o tym komunikat).
    5. Korzystając z sekcji Testowanie transformacji, wysłać i przetestować przekształcony XML (aby potwierdzić, że został poprawnie wygenerowany), po czym nacisnąć przycisk Dalej. Można także wyświetlić podgląd zawartości w tej sekcji, naciskając przycisk Podgląd znajdujący się w górnym prawym rogu sekcji.
  6. Na stronie Odwzorowanie pola zdefiniować nawigację do określonych elementów lub atrybutów, tak aby użytkownicy mogli wyodrębniać wartości z dokumentu XML:
    1. Zaznaczyć pole wyboru Wykonaj odwzorowanie pól XPath, aby umożliwić edytowanie tabeli "Odwzorowanie pól XPath". Jeśli to pole wyboru zostanie wyczyszczone, to nie będzie można tej tabeli edytować. Zostaną jednak zachowane wartości ostatnio zapisane.
    2. Zaznaczyć pole wyboru Przerwij przetwarzanie partii przy błędach analizy składniowej, jeśli format rozbioru (wybierany w następnym punkcie) musi być ściśle przestrzegany.
    3. Kliknąć na ikonie Edytuj odwzorowanie pola XPath znajdującej się w górnym prawym rogu tabeli Odwzorowanie pól XPath.
    4. W oknie dialogowym Edycja odwzorowania pola XPath:
      1. W polu Wyrażenie XPath określić wyrażenie XPath dla wybranego pola danych dla metadanych oraz wybrać format rozbioru.

        Wyrażenie XPath jest przetwarzane dla wyników transformacji, jeśli taka istnieje. Jeśli transformacja nie jest wykonywana, wyrażenie XPath jest przetwarzane dla dokumentu lub załącznika.

      2. Z rozwijanej listy Format rozbioru daty wybrać odpowiedni format. Jeśli pole Capture jest typu liczbowego, pojawi się lista Format rozbioru liczby. Jeśli trzeba, można z rozwijanej listy wybrać niestandardowy format rozbioru.
      3. Nacisnąć przycisk OK.

        Wartość, która zostanie dodana kolumny Wyrażenie XPath tabeli Odwzorowanie pól XPath, jest rozkładana na datę w wybranym formacie.

    5. Nacisnąć przycisk OK.
  7. Na stronie Przetwarzanie końcowe określić, co ma się dziać po ukończeniu zlecenia transformacji XML:
    • Brak błędów systemu oznacza, że zostały spełnione wszystkie kryteria z poprzedniej strony. Po pomyślnej transformacji partia może zostać przekazana do zatwierdzenia.
    • Błędy systemu sygnalizują, że transformacja zakończyła się niepowodzeniem: nie znaleziono żadnych rekordów, znaleziono zbyt wiele rekordów itp. W takiej sytuacji partia wraca do klienta Content Capture w celu jej naprawy.
    Zob. Konfigurowanie przetwarzania końcowego i monitorowania zlecenia transformacji XML
  8. Na stronie Podsumowanie sprawdzić ustawienia, po czym — aby zapisać zlecenie — nacisnąć przycisk Prześlij.

  9. Skonfigurować sposób przepływu partii do zleceń transformacji XML. Zob. Konfigurowanie przepływu partii do zlecenia transformacji XML.

  10. Przetestować utworzone zlecenie transformacji XML.

Konfigurowanie przetwarzania końcowego i monitorowania zlecenia transformacji XML

Za pomocą opcji przetwarzania końcowego zlecenia transformacji XML można określić, co się będzie działo po ukończeniu przetwarzania.

Aby skonfigurować przetwarzanie końcowe i monitorowanie zlecenia transformacji XML, należy:
  1. Z okienka "Procedury" (po lewej stronie) wybrać procedurę.
    Po prawej stronie zostaną wyświetlone strony konfiguracyjne wybranej procedury.
  2. Otworzyć kartę Procesor.
  3. W tabeli Zlecenia transformacji XML dodać lub edytować zlecenie transformacji XML.
  4. Aby wyświetlić opcje dla pomyślnego przetwarzania (brak błędów systemu) i niepomyślnego przetwarzania (jeden lub większa liczba błędów systemu), przejść do strony Przetwarzanie końcowe. Następne etapy dotyczą obu sekcji: Jeśli nie występuje błąd systemu i Jeśli występuje błąd systemu.
  5. W polach Procesor partii i Zlecenie dla procesora partii określić, które etapy przetwarzania (jeśli w ogóle) mają występować po ukończeniu zlecenia transformacji XML. Można wybrać jedną z następujących opcji: Brak, Procesor zatwierdzania, procesor rozpoznawania, Konwersje do TIFF, Konwersje do PDF, Procesor wyszukiwania zasobów lub Procesor transformacji XML.
  6. W polu adresu e-mailowego podać opcjonalnie adres, na który mają być wysyłane — po pomyślnym lub nieudanym ukończeniu przetwarzania — e-maile. W trakcie konfigurowania i testowania zlecenia transformacji XML można ustawić bieżącego użytkownika jako odbiorcę powiadomień e-mailowych dotyczących błędów systemu, a później automatycznie alarmować administratora o błędach przetwarzania.
  7. W pozostałych polach określić, w jaki sposób mają być zmieniane przetworzone partie.
    • Zmiana nazwy partii poprzez dodanie prefiksu. Na przykład zmiana nazwy nieudanych partii, polegająca na dodaniu prefiksu ERR.

    • Zmiana statusu lub priorytetu partii. Na przykład można zmienić status partii z błędami zgłoszonymi przez system, a następnie utworzyć profil klienta z filtrami partii, ustawionymi dla tego statusu, tak aby umożliwić wykwalifikowanym użytkownikom ręczne edytowanie i uzupełnianie partii, w których wystąpiły błędy.

  8. Aby zapisać zlecenie, nacisnąć przycisk Prześlij.

Konfigurowanie przepływu partii do zlecenia transformacji XML

W celu uruchomienia zlecenia transformacji XML trzeba skonfigurować przepływ partii do zlecenia przetwarzania. Można to zrobić poprzez ustawienie w profilu klienta zlecenia transformacji XML jako etapu przetwarzania końcowego.

Przepływy partii można skonfigurować za pomocą:

Dezaktywowanie lub usuwanie zlecenia transformacji XML

Usunięte zlecenie transformacji XML staje się niedostępne dla partii, dla których zostało ono ustawione jako etap przetwarzania końcowego. Jeśli określone dla przetwarzania końcowego zlecenie nie będzie dostępne, wystąpi błąd partii. Przed usunięciem zlecenia warto je ustawić offline, aby móc rozwiązać nieoczekiwane problemy wynikające z jego usunięcia. Zlecenia transformacji XML, ustawione online, są uruchamiane, jeśli zostały wybrane w profilu klienta lub na stronie "Przetwarzanie końcowe" zlecenia dla procesora. Można tymczasowo wstrzymać zlecenie (przełączając je do trybu offline) lub włączyć uruchamianie zdezaktywowanego zlecenia.

Aby zdezaktywować lub usunąć zlecenie transformacji XML, należy:
  1. Z okienka "Procedury" (po lewej stronie) wybrać procedurę.
    Po prawej stronie zostaną wyświetlone strony konfiguracyjne wybranej procedury.
  2. Otworzyć kartę Przetwarzanie.
  3. Aby dezaktywować zlecenie, wybrać je w tabeli Zlecenia transformacji XML, po czym kliknąć na ikonie Dezaktywuj lub usuń zlecenie transformacji XML.

    Zlecenie transformacji XML można także dezaktywować lub aktywować, czyszcząc na stronie "Wybór dokumentu" pole wyboru Online lub zaznaczając to pole.

  4. W tabeli Zlecenia transformacji XML wybrać dezaktywowane zlecenie, po czym kliknąć na ikonie Usuń zlecenie transformacji XML.
  5. Aby potwierdzić chęć usunięcia tego zlecenia, nacisnąć — gdy pojawi się monit — przycisk Tak.