Konfigurera XML-transformeringsjobb

Du kan skapa ett XML-transformeringsjobb för att transformera en XML-fil till önskade utdata samt tilldela värden för Capture-metadatafält från XML:en. Det här kan du göra genom att konfigurera de kombinationer av XSLT-processordefinitioner som stöds och tillhandahålla den anpassade XSLT-filen. Dessutom kan XPath-uttryck mappas till Capture-metadatafält. Den konverterade XML-filen kan sedan användas av tredjepartsapplikationer för att uppfylla de övriga parternas affärsbehov.

Obs!:

Du kan inte skapa XML-transformeringsjobb i Oracle Content Management Starter Edition. För att använda den här funktionen behöver du uppgradera till Oracle Content Management Premium Edition. Mer information finns i Starter kontra Premium Edition.

  1. Välj proceduren i procedurrutan till vänster.

    Konfigurationssidorna för den valda proceduren visas till höger.

  2. Öppna fliken Bearbetning.

  3. I tabellen XML-transformeringsjobb klickar du på Lägg till XML-transformeringsjobb, eller, om du ska redigera ett befintligt jobb, på Redigera XML-transformeringsjobb.

    Du kan även kopiera ett XML-transformeringsjobb genom att välja det, klicka på Kopiera transformeringsjobb och ange ett nytt namn när du uppmanas att göra det. Genom att kopiera ett jobb kan du snabbt duplicera och ändra det.

  4. På sidan Val av dokument:

    1. I sektionen Val av dokument gör du följande:

      • Ange ett namn och en beskrivning av jobbet.

      • Om XML-transformeringsjobbet ska bearbetas för specifika dokumentprofiler väljer du en eller flera dokumentprofiler i listan i fältet Begränsa till dokumentprofiler, eller Alla om dokument ska bearbetas för alla definierade dokumentprofiler.

    2. Välj lämpligt alternativ i listrutan Destination för transformeringsutdata:
      • Dokument: Ersätter det ursprungliga dokumentet med transformeringsresultaten. Du kan även ändra dokumentprofilen om så önskas.
      • Dokument, bevara kopia: Bevarar den ursprungliga kopian. Du kan även välja en dokumentprofil om du har valt detta alternativ. Du måste emellertid välja en bilagetyp i listrutan Bevara bilagetyp.
      • Bilaga: Lagrar resultaten av transformeringen som en bilaga. Du måste välja en bilagetyp i listrutan Ny bilagetyp.
      • Capture-fält: Lagrar resultaten av transformeringen i ett Capture-fält. Du måste välja Textfält i listrutan Capture-fält.
    3. I sektionen Val av bilaga:
      1. Markera kryssrutan Bearbeta bilagor om detta är tillämpligt på de val du gjorde i föregående steg.
      2. Begränsa till de bilagetyper som krävs genom att markera kryssrutorna för de tillgängliga bilagetyperna. Du kan även markera alla.
      3. Välj destination för transformeringens utdata:
        • Bilaga: Du har möjlighet att ändra bilagetypen.
        • Bilaga, bevara en kopia: Du har möjlighet att välja bilagetypen. Men du måste välja en bilagetyp i listrutan Bevara bilagetyp.
        • Capture-fält: Du måste välja Textfält eller XML-fält.
  5. På sidan Transformering – Transformeringsdefinition:
    1. Markera kryssrutan Utför XML-transformering, om den inte redan är markerad, för att aktivera redigering av fältvärdena på den här sidan. Om den här kryssrutan avmarkeras avaktiveras redigering och de senast sparade värdena behålls i fälten. Du kan avmarkera den här kryssrutan om XML-transformering inte krävs.
    2. I sektionen Transformeringsmotor:
      • Välj kompatibla värden för XSLT-version, Processor och Processorversion. Välj antingen systemstandardinställningarna eller bland de tillgängliga XSLT-versioner som är kompatibla med Xalan- och Saxon-HE-processorer och deras versioner.
      • Ange ett Filtillägg för utdata, t.ex. XML, HTML, JSON, text.

        Obs!:

        Om filtillägget för utdata inte är lika med XML avaktiveras sidan Fältmappning.
    3. Du utför en transformering genom att ladda upp eller skriva in XSLT i sektionen XML-formatmall.
    4. Parametrar som du inkluderade i XSLT ska definieras i tabellen Parametrar. Gör så här:
      1. I tabellen Parametrar klickar du på Lägg till parametrar.
      2. I dialogrutan Lägg till XSLT-parametrar lägger du till parameternamnet och tilldelar ett värde. Du kan lägga till ett textvärde eller sätta samman ett metadatavärde för parametrarna.
      3. Upprepa stegen i och ii för att definiera de parametrar som krävs.

        Obs!:

        Om du inte tilldelar värden till parametrar som definieras i XSLT eller om du tilldelar värden till de parametrar som inte finns i XSLT så kan du inte spara XML-transformeringsjobbet, och då visas ett meddelande om detta när du försöker spara transformeringsjobbet.
    5. Gå till sektionen Transformeringstest och ladda upp och testa den transformerade XML:en för att bekräfta att den har genererats korrekt. Klicka sedan på Nästa. Du kan även förhandsgranska innehållet i den här sektionen genom att klicka på Förhandsgranska längst upp till höger i sektionen.
  6. På sidan Fältmappning definierar du navigeringen till specifika element eller attribut, så att användare kan hämta sina värden från XML-dokumentet:
    1. Markera kryssrutan Utför XPath-fältmappning för att aktivera redigering av tabellen över XPath-fältmappning. Om du avmarkerar den här kryssrutan kan du inte redigera tabellen. De senast sparade värdena behålls dock.
    2. Markera kryssrutan Underkänn batch vid parsningsfel om det parsningsformat du ska välja i nästa steg måste följas strikt.
    3. Klicka på Redigera XPath-fältmappning längst upp till höger i tabellen XPath-fältmappning
    4. I dialogrutan Redigera XPath-fältmappning:
      1. I fältet XPath-uttryck anger du XPath-uttrycket för det valda metadatafältet och väljer parsningsformat.

        XPath-uttrycket utvärderas på utdata från transformeringen, i förekommande fall. Om ingen transformering utförs utvärderas XPath-uttrycket på dokumentet eller i bilagan.

      2. Välj parsningsformat i listrutan Parsningsformat för datum. Om Capture-fältet är ett tal visas i stället listrutan Parsningsformat för tal. Vid behov kan ett anpassat parsningsformat väljas i listrutan.
      3. Klicka på OK.

        Det värde som läggs till i kolumnen XPath-uttryck i tabellen XPath-fältmappning parsas till ett datum i det format du har valt.

    5. Klicka på OK.
  7. På sidan Efterbearbetning anger du baserat på följande vad som ska hända när ett XML-transformeringsjobb har slutförts:
    • Situationer med inga systemfel är fall där alla kriterier på den föregående sidan har uppfyllts. En utförd transformering kan flöda till bekräftelse.
    • Systemfel är fall där transformeringen inte kan utföras: inga poster hittades, för många poster hittades och så vidare. För transformeringar som inte kan utföras går batchen tillbaka till Content Capture-klienten för reparation.
    Se Konfigurera efterbearbetning och övervakning för ett XML-transformeringsjobb

  8. Granska inställningarna på sidan Översikt och klicka på Skicka för att spara jobbet.

  9. Konfigurera hur batchar flödar till XML-transformeringsjobb. Se Konfigurera batchflöde till ett XML-transformeringsjobb.

  10. Testa XML-transformeringsjobbet du har skapat.

Konfigurera efterbearbetning och övervakning för ett XML-transformeringsjobb

Använd efterbearbetningsalternativ för ett XML-transformeringsjobb för att ange vad som ska hända när bearbetningen har slutförts.

Så här konfigurerar du efterbearbetning och övervakning för ett XML-transformeringsjobb:
  1. Välj proceduren i procedurrutan till vänster.
    Konfigurationssidorna för den valda proceduren visas till höger.
  2. Öppna fliken Processor.
  3. Gå till tabellen XML-transformeringsjobb och lägg till eller redigera ett XML-transformeringsjobb.
  4. Klicka på sidan Efterbearbetning för att visa bearbetningsalternativen för utförd bearbetning (inga systemfel) och ej utförd bearbetning (ett eller flera systemfel). De steg som följer är tillämpliga på båda sektionerna: När det inte finns något systemfel och När det finns systemfel.
  5. I fälten Batchprocessor och Batchprocessorjobb anger du vilket bearbetningssteg, om något, som ska utföras när XML-transformeringsjobbet har slutförts. Du kan välja mellan Ingen, Bekräftelseprocessor, Igenkänningsprocessor, Konvertering till TIFF, Konverteringar till PDF, Tillgångsuppslagningsprocessor och XML-transformeringsprocessor.
  6. I fältet för e-postadress kan du valfritt ange en adress dit ett e-postmeddelande ska skickas när bearbetningen har utförts eller inte har kunnat utföras. Medan du konfigurerar och testar ett XML-transformeringsjobb kan du ange dig själv som mottagare av e-postmeddelanden vid systemfel, och senare automatiskt avisera en administratör om bearbetningsfel.
  7. I de återstående fälten anger du hur bearbetade batchar ska ändras.

    • Ändra namn på batchar genom att lägga till ett prefix. Du kan till exempel ändra namn på batchar som inte har kunnat utföras med prefixet ERR för uppföljning.

    • Ändra batchstatus eller prioritet. Du kan till exempel ändra status för batchar med systemfel och sedan skapa en klientprofil med denna status angiven för batchfiltrering, så att kvalificerade användare manuellt kan redigera och slutföra batchar som påträffat fel.

  8. Klicka på Skicka för att spara jobbet.

Konfigurera batchflöde till ett XML-transformeringsjobb

För att kunna köra ett XML-transformeringsjobb måste du konfigurera batchflöde till jobbet för bearbetning. Det gör du genom att ange XML-transformeringsjobbet som ett efterbearbetningssteg i en klientprofil.

Du kan konfigurera batchflöden från följande:

Avaktivera eller ta bort ett XML-transformeringsjobb

När du tar bort ett XML-transformeringsjobb blir det inte längre tillgängligt för batchar för vilka det har angetts som ett efterbearbetningssteg. Om ett jobb som angetts för efterbearbetning inte är tillgängligt blir resultatet ett fel för batchen. Det kan vara en bra idé att ändra ett jobb till offline under en tid innan det tas bort, så att du kan åtgärda oväntade problem med borttagningen av det. XML-transformeringsjobb online körs när de väljs i en klientprofil eller på sidan Efterbearbetning i ett processorjobb. Du kan tillfälligt stoppa ett jobb (ta det offline) eller ändra ett inaktivt jobb så att det körs igen.

Så här gör du om du vill avaktivera eller ta bort ett XML-transformeringsjobb:
  1. Välj proceduren i procedurrutan till vänster.
    Konfigurationssidorna för den valda proceduren visas till höger.
  2. Öppna fliken Bearbetning.
  3. Om du vill avaktivera ett jobb väljer du det i tabellen XML-transformeringsjobb och klickar på Avaktivera eller aktivera ett XML-transformeringsjobb.

    Du kan även avaktivera eller aktivera ett XML-transformeringsjobb genom att markera eller avmarkera fältet Online på sidan Val av dokument.

  4. Välj det avaktiverade jobbet i tabellen XML-transformeringsjobb och klicka på Ta bort ett XML-transformeringsjobb.
  5. När du uppmanas klickar du på Ja för att bekräfta att du vill ta bort jobbet.