Configurarea joburilor de transformare XML

Puteţi crea un job de transformare XML pentru a transforma un fişier XML într-un rezultat dorit, precum şi pentru a asigna valorile câmpurilor de metadate pentru captură din XML. Puteţi face acest lucru configurând combinaţiile acceptate pentru definiţiile procesorului XSLT şi furnizând fişierul dvs. XSLT personalizat. În plus, o expresie XPath poate fi mapată la câmpurile de metadate la captare. Fişierul XML căruia i s-a făcut conversia poate fi apoi utilizat de aplicaţii de la terţi, pentru a răspunde necesităţilor de business ale altor părţi.

Notă:

Nu puteţi crea joburi de transformare XML din Oracle Content Management Starter Edition. Pentru a utiliza această caracteristică trebuie să faceţi upgrade la Oracle Content Management Premium Edition. Pentru informaţii suplimentare, consultaţi Starter vs. Premium Edition.

  1. Selectaţi procedura din panoul de proceduri din partea stângă.

    Paginile de configurare pt. procedura selectată apar în partea dreaptă.

  2. Deschideţi fila Procesare.
  3. În tabelul Joburi de transformare XML faceţi clic pe Adăugaţi un job de transformare XML sau pentru a edita un job existent faceţi clic pe Editaţi un job de transformare XML.

    De asemenea, puteţi copia un job de transformare XML selectându-l, făcând clic pe Copiaţi un job de transformare şi introducând un nume nou atunci când vi se solicită. Copierea unui job vă permite să îl duplicaţi şi să îl modificaţi rapid.

  4. Pe pagina Selecţie document:

    1. În secţiunea Selecţie document, efectuaţi următoarele:
      • Introduceţi un nume şi o descriere pentru job.

      • Pentru a procesa jobul de transformare XML la anumite profiluri de document, selectaţi unul sau mai multe profiluri de document listate în câmpul Restricţionare la profilurile de documente sau selectaţi Toate pentru a procesa documente pentru toate profilurile de document care au fost definite.

    2. În lista derulantă Destinaţie rezultat transformare, selectaţi o opţiune adecvată:
      • Document: Înlocuieşte documentul original cu rezultatele transformării. De asemenea, puteţi modifica profilul documentului dacă se doreşte.
      • Document, Păstrare copie: Păstrează copia originală. De asemenea, puteţi alege profilul unui document dacă selectaţi această opţiune. Totuşi, este necesar să selectaţi un tip de ataşament din lista derulantă Păstrare tip de ataşament.
      • Ataşament: Stochează rezultatele transformării ca un ataşament. Este necesar să selectaţi un tip de ataşament din lista derulantă Tip de ataşament nou.
      • Câmp Captură: Stochează rezultatele transformării într-un câmp denumit Captură. Este necesar să selectaţi Câmp de text din lista derulantă Câmp Capture.
    3. În secţiunea Selectare ataşament:
      1. Selectaţi caseta de validare Ataşamente de procese dacă se aplică alegerilor pe care le-aţi făcut în paşii anteriori.
      2. Faceţi restricţionarea la tipurile de ataşări obligatorii, selectând casetele de validare pentru tipurile de ataşări disponibile. De asemenea, le puteţi selecta pe toate.
      3. Selectaţi destinaţia pentru rezultatul transformării:
        • Ataşament: Aveţi opţiunea de a schimba tipul de ataşament.
        • Ataşament, Păstrarea unei copii: Aveţi opţiunea de a selecta tipul de ataşament. Dar este necesar să selectaţi un tip de ataşament din lista derulantă Păstrare tip de ataşament.
        • Câmp Captură: Este necesar să selectaţi Câmp de text sau Câmp XML.
  5. În pagina TransformareDefiniţie transformare:
    1. În cazul în care caseta de validare Efectuare transformare XML nu este deja selectată, selectaţi-o pentru a permite editarea valorilor câmpurilor de pe această pagină. Deselectarea acestei casete de validare dezactivează editarea, păstrându-se ultimele valori salvate în acele câmpuri. Puteţi deselecta această casetă de validare atunci când transformările XML nu sunt necesare.
    2. În secţiunea Motor transformare:
      • Selectaţi valorile compatibile pentru Versiune XSLT, Procesor şi Versiune procesor. Fie alegeţi setările prestabilite ale sistemului, fie alegeţi dintre versiunile XSLT disponibile care sunt compatibile cu procesoarele Xalan şi Saxon-HE şi versiunile acestora.
      • Specificaţi o Extensie fişier rezultat cum ar fi XML, HTML, JSON, text.

        Notă:

        Dacă extensia fişierului rezultat nu este XML, pagina Mapare câmpuri este dezactivată.
    3. Pentru a efectua o transformare, încărcaţi sau tastaţi XSLT în secţiunea Foaie de stil XML.
    4. Parametrii pe care i-aţi inclus în XSLT trebuie să fie definiţi în tabelul Parametri. Pentru a face acest lucru:
      1. În tabelul Parametri, faceţi clic pe Adăugare parametri.
      2. În dialogul Adăugare parametri XSLT, adăugaţi numele parametrului şi asignaţi-i o valoare. Puteţi adăuga o valoare text sau puteţi asambla o valoare din metadate pentru parametrii dvs.
      3. Repetaţi paşii i şi ii pentru a defini parametrii obligatorii.

        Notă:

        Dacă nu asignaţi valori parametrilor care sunt definiţi în XSLT sau dacă asignaţi valori acelor parametri care nu există în XSLT, nu veţi putea să salvaţi jobul de transformare XML şi să fiţi înştiinţaţi despre acest lucru atunci când încercaţi să salvaţi jobul de transformare.
    5. În secţiunea Testare transformare, încărcaţi şi testaţi XML-ul transformat pentru a confirma că el este generat în mod corect şi apoi faceţi clic pe Înainte. De asemenea, puteţi previzualiza conţinutul din această secţiune, făcând clic pe Previzualizare în partea de sus din dreapta a acestei secţiuni.
  6. În pagina Mapare câmpuri, definiţi navigarea către elemente sau atribute specifice, astfel încât utilizatorii să poată extrage valorile acestora din documentul XML:
    1. Selectaţi caseta de validare Mapare câmpuri XPath pentru a permite editarea tabelului Mapare câmpuri XPath. Dacă deselectaţi acestă casetă de validare, nu veţi putea să editaţi tabelul. Totuşi, ultimele valori salvate sunt păstrate.
    2. Selectaţi caseta de validare Eşuare set la erori de interpretare, dacă formatul de interpretare pe care îl veţi selecta la pasul următor trebuie respectat cu stricteţe.
    3. În partea din dreapta sus a tabelului Mapare câmpuri XPath, faceţi clic pe Editare mapare câmpuri XPath
    4. În dialogul Editare mapare câmpuri XPath:
      1. În câmpul Expresie XPath, specificaţi expresia XPath pentru câmpul de metadate selectat şi selectaţi formatul de interpretare.

        Expresia XPath este evaluată pe baza rezultatului transformării, dacă acesta există. Dacă o transformare nu este realizată, expresia XPath este evaluată pe baza documentului sau ataşamentului.

      2. În lista derulantă Format de interpretare dată calendaristică, selectaţi formatul de interpretare. În cazul în care câmpul Captură este un număr, veţi vedea în schimb o listă derulantă Format de interpretare numere. Dacă este necesar, poate fi selectat în lista derulantă un format de interpretare personalizat.
      3. Faceţi clic pe OK.

        Valoarea care este adăugată în coloana Expresie XPath din tabelul Mapare câmp XPath este analizată în funcţie de o dată în formatul pe care l-aţi selectat.

    5. Faceţi clic pe OK.
  7. Pe pagina Postprocesare specificaţi în funcţie de următoarele, ce se întâmplă după ce se finalizează un job de transformare XML:
    • Situaţiile fără nicio eroare de sistem sunt cazurile în care au fost îndeplinite toate criteriile din pagina anterioară. O funcţie de transformare reuşită poate avansa în flux pentru confirmare.
    • Erorile de sistem sunt orice fel de cazuri în care funcţia de transformare eşuează: nu au fost găsite înregistrări, au fost găsite prea multe înregistrări etc. Pentru transformările nereuşite, setul revine la clientul Content Capture pentru reparare.
    Consultaţi Configurarea post-procesării şi a monitorizării unui job de transformare XML
  8. Verificaţi setările din pagina Sumar şi faceţi clic pe Trimitere pt. a salva jobul.

  9. Configuraţi modul în care seturile circulă în flux către joburile de transformare XML. Consultaţi Configurarea unui flux de seturi pentru un job de transformare XML.

  10. Testaţi jobul de transformare XML pe care l-aţi creat.

Configurarea post-procesării şi a monitorizării unui job de transformare XML

Utilizaţi opţiunile de post-procesare ale unui job de transformare XML, pentru a specifica ce se întâmplă după finalizarea procesării.

Pentru a configura post-procesarea şi monitorizarea unui job de transformare XML
  1. Selectaţi procedura din panoul de proceduri din partea stângă.
    Paginile de configurare pt. procedura selectată apar în partea dreaptă.
  2. Deschideţi fila Procesor.
  3. În tabelul Joburi de transformare XML, adăugaţi sau editaţi un job de transformare XML.
  4. Faceţi clic pe pagina Postprocesare, pentru a afişa opţiunile de procesare pentru procesare reuşită (fără erori de sistem) şi procesare nereuşită (una sau mai multe erori de sistem). Paşii următori se aplică pt. ambele secţiuni: Când nu există nicio eroare de sistem şi Când nu există erori de sistem.
  5. În câmpurile Procesor set şi Job procesor set, specificaţi care pas din procesare, dacă există, are loc după finalizarea jobului de transformare XML. Puteţi alege dintre Niciunul, Procesor de confirmare, Procesor de recunoaştere, Conversie în TIFF, Conversii în PDF, Procesor cu funcţie de căutare pt. resurse sau Procesor de transformare XML.
  6. În câmpul pentru adresa de e-mail, introduceţi opţional o adresă la care să se trimită un e-mail după finalizarea procesării, cu succes sau cu erori. În timp ce configuraţi şi testaţi un job de transformare XML, vă puteţi seta să primiţi înştiinţări prin e-mail atunci când apar erori de sistem, apoi să alertaţi ulterior în mod automat un administrator, cu privire la erorile de procesare.
  7. În câmpurile rămase, precizaţi modul de modificare a seturilor procesate.
    • Redenumiţi seturile prin adăugarea unui prefix. De exemplu, redenumiţi seturile care nu au avut succes cu prefixul ERR pt. a le urmări.

    • Modificaţi starea sau prioritatea setului. De exemplu, aţi putea modifica starea seturilor cu erori de sistem, apoi crea un profil de client cu filtrarea de seturi setată la această stare, pt. a le permite utilizatorilor calificaţi să editeze şi să completeze manual seturile care au întâmpinat erori.

  8. Faceţi clic pe Trimitere pt. a salva jobul.

Configurarea unui flux de seturi pentru un job de transformare XML

Pentru a rula un job de transformare XML, este necesar să configuraţi seturile care să intre în flux către jobul respectiv pentru procesare. Faceţi acest lucru, setând jobul de transformare XML ca un pas de post-procesare într-un profil al clientului.

Puteţi configura fluxurile de seturi din următoarele:

Dezactivarea sau ştergerea unui job de transformare XML

Atunci când ştergeţi un job de transformare XML, acesta nu mai rămâne disponibil pentru seturile la care este stabilit ca un pas în post-procesare. În cazul în care un job specificat pentru post-procesare nu este disponibil, va surveni o eroare pentru setul respectiv. Este posibil să doriţi să schimbaţi un job în modul offline pentru o perioadă de timp înainte de a-l şterge, permiţându-vă să rezolvaţi problemele neaşteptate prin ştergerea acestuia. Joburile online de transformare XML rulează atunci când sunt selectate într-un profil de client sau pe pagina Postprocesare a unui job procesor. Puteţi opri temporar un job (puneţi-l în mod offline) sau puteţi modifica un job dezactivat pentru a-l rula din nou.

Pentru a dezactiva sau şterge un job de transformare XML
  1. Selectaţi procedura din panoul de proceduri din partea stângă.
    Paginile de configurare pt. procedura selectată sunt afişate în partea dreaptă.
  2. Deschideţi fila Procesare.
  3. Pentru a dezactiva un job, selectaţi-l în tabelul Joburi de transformare XML şi faceţi clic pe Dezactivaţi sau activaţi un job de transformare XML.

    De asemenea, puteţi dezactiva sau activa un job de transformare XML, selectând sau deselectând câmpul Online de pe pagina Selecţie document.

  4. Selectaţi jobul dezactivat în tabelul Joburi de transformare XML şi faceţi clic pe Ştergeţi un job de transformare XML.
  5. Când vi se solicită, faceţi clic pe Da pentru a confirma că doriţi să ştergeţi acest job.