Konfigurere XML-transformationsjobs

Du kan oprette et XML-transformationsjob for at transformere en XML-fil til det ønskede output og tildele Capture-metadatafeltværdier fra XML. Det kan du gøre ved at konfigurere de understøttede kombinationer af XSLT-processordefinitioner og angive din tilpassede XSLT-fil. Desuden kan et XPath-udtryk mappes til Capture-metadatafelter. Den konverterede XML-fil kan derefter bruges af tredjepartsapplikationer til at opfylde de andre parters forretningsbehov.

Bemærk:

Du kan ikke oprette XML-transformationsjobs i Oracle Content Management Starter Edition. Hvis du vil bruge denne funktion, skal du opgradere til Oracle Content Management Premium Edition. Se Starter Edition versus Premium Edition for at få flere oplysninger.

  1. Vælg din procedure i procedureruden til venstre.

    Konfigurationssiderne for den valgte procedure vises til højre.

  2. Åbn fanen Behandling.
  3. Klik på Tilføj XML-transformationsjob i tabellen XML-transformationsjobs, eller klik på Rediger XML-transformationsjob for at redigere et eksisterende job.

    Du kan også kopiere et XML-transformationsjob ved at vælge det, klikke på Kopier transformationsjob og derefter indtaste et nyt navn, når du bliver bedt om det. Når du kopierer et job, kan du hurtigt duplikere og modificere det.

  4. På siden Dokumentvalg:

    1. Gør følgende i afsnittet Dokumentvalg:
      • Indtast et navn til og en beskrivelse af jobbet.

      • Hvis du vil behandle XML-transformationsjobbet for bestemte dokumentprofiler, skal du vælge en eller flere dokumentprofiler, der er angivet i feltet Begræns til dokumentprofiler, eller du kan vælge Alle for at behandle dokumenter for alle definerede dokumentprofiler.

    2. Foretag et passende valg på rullelisten Destination for transformationsoutput:
      • Dokument: Erstatter originaldokumentet med transformationsresultaterne. Du kan også ændre dokumentprofilen efter behov.
      • Dokument, Bevar kopi: Bevarer originalkopien. Du kan også vælge en dokumentprofil, hvis du angiver dette valg. Men du skal vælge en vedhæftningstype på rullelisten Bevar vedhæftningstype.
      • Vedhæftning: Lagrer resultaterne af transformationen som en vedhæftning. Du skal vælge en vedhæftningstype på rullelisten Ny vedhæftningstype.
      • Capture-felt: Lagrer resultaterne af transformationen i et Capture-felt. Du skal vælge Tekstfelt på rullelisten Capture-felt.
    3. I sektionen Vedhæftningsvalg:
      1. Marker afkrydsningsfeltet Behandl vedhæftninger, hvis det er relevant i forhold til dine valg i de foregående trin.
      2. Begræns det til de påkrævede vedhæftningstyper ved at markere afkrydsningsfelterne for de tilgængelige vedhæftningstyper. Du kan også markere dem alle.
      3. Vælg destinationen for transformationsoutput:
        • Vedhæftning: Du har mulighed for at ændre vedhæftningstypen.
        • Vedhæftning, Bevar en kopi: Du har mulighed for at vælge vedhæftningstypen. Men du skal vælge en vedhæftningstype på rullelisten Bevar vedhæftningstype.
        • Capture-felt: Du skal vælge Tekstfelt eller XML-felt.
  5. På siden Transformation - Transformationsdefinition:
    1. Hvis afkrydsningsfeltet Udfør XML-transformation ikke allerede er markeret, skal du markere det for at aktivere redigering af feltværdier på denne side. Hvis du fjerner markeringen af dette afkrydsningsfelt, deaktiveres redigering, og de sidst gemte værdier beholdes i felterne. Du kan fjerne markeringen af dette afkrydsningsfelt, når XML-transformation ikke er påkrævet.
    2. I sektionen Transformationsprogram:
      • Vælg kompatibel XSLT-version, Processor og Processorversion. Vælg enten systemstandarder eller en af de tilgængelige XSLT-versioner, der er kompatibel med Xalan- og Saxon-HE-processorer og deres versioner.
      • Angiv en Output-filtype som for eksempel XML, HTML, JSON eller tekst.

        Bemærk:

        Hvis outputfiltypen ikke er lig med XML, deaktiveres siden Feltmapping.
    3. Udfør en transformation ved at uploade eller indtaste XSLT-filen i sektionen XML-typografiark.
    4. Parametre, du har medtaget i din XSLT, bør være defineret i tabellen Parametre. Sådan gør du:
      1. Klik på Tilføj parametre i tabellen Parametre,
      2. Tilføj parameternavnet i dialogboksen Tilføj XSLT-parametre, og tildel det en værdi. Du kan tilføje en tekstværdi eller samle en metadataværdi til parametrene.
      3. Gentag trin i og ii for at definere de påkrævede parametre.

        Bemærk:

        Hvis du ikke tildeler parameterværdier, der er defineret i XSLT, eller hvis du tildeler disse parametre værdier, der ikke findes i XSLT, kan du ikke gemme XML-transformationsjobbet og blive underrettet om dette, når du forsøger at gemme transformationsjobbet.
    5. Upload og test den transformerede XML i sektionen Transformationstest for at få bekræftet, at den er genereret korrekt, og klik derefter på Næste. Du kan også se indholdet som eksempel i denne sektion ved at klikke på Eksempel i højre side af denne sektion.
  6. Brug siden Feltmapping til at definere navigationen til specifikke elementer eller attributter, så brugerne kan trække deres værdier ud af XML-dokumentet:
    1. Marker afkrydsningsfeltet Udfør XPath-feltmapping for at aktivere redigering af tabellen XPath-feltmapping. Hvis du fjerner markeringen i dette afkrydsningsfelt kan du ikke redigere tabellen. Men de sidst gemte værdier bevares dog.
    2. Marker afkrydsningsfeltet Batch fejler ved analysefejl, hvis det analyseformat, du vælger i næste trin, skal overholdes stringent.
    3. Klik på Rediger XPath-feltmapping øverst til højre i tabellen XPath-feltmapping
    4. Gør følgende i dialogboksen Rediger XPath-feltmapping:
      1. Brug feltet XPath-udtryk til at angive XPath-udtrykket for det valgte metadatadatafelt, og vælg analyseformatet.

        XPath-udtrykket evalueres på outputtet af transformationen, hvis det findes. Hvis der ikke udføres transformation, bliver XPath-udtrykket evalueret på dokumentet eller vedhæftningen.

      2. Vælg analyseformatet på rullelisten Datoanalyseformat. Hvis Capture-feltet er et tal, kan du i stedet se rullelisten Talanalyseformat. Om nødvendigt kan et tilpasset analyseformat være valgt på rullelisten.
      3. Klik på OK.

        Den værdi, der tilføjes i kolonnen XPath-udtryk i tabellen XPath-feltmapping, analyseres til en dato i det format, som du har valgt.

    5. Klik på OK.
  7. Angiv, hvad der skal ske, efter at et XML-transformationsjob er fuldført, på siden Efterbehandling.
    • Situationer uden systemfejl er tilfælde, hvor alle kriterierne på forrige side er opfyldt. En vellykket transformation kan fortsætte til bekræftelse.
    • Systemfejl er tilfælde, hvor transformationen fejler: Der blev ikke fundet nogen records, der blev fundet for mange records og så videre. Hvis transformationer fejler, returnerer batchen til Content Capture Client med henblik på reparation.
    Se Konfigurere efterbehandling og overvågning af et XML-transformationsjob
  8. Gennemgå indstillingerne på siden Oversigt, og klik på Afsend for at gemme jobbet.

  9. Konfigurer batchflowet til XML-transformationsjobs. Se Konfigurere batchflow til et XML-transformationsjob.

  10. Test det XML-transformationsjob, som du har oprettet.

Konfigurere efterbehandling og overvågning af et XML-transformationsjob

Brug efterbehandlingsvalg for et XML-transformationsjob til at angive, hvad der sker, når behandlingen er fuldført.

Sådan konfigurerer du efterbehandling og overvågning af et XML-transformationsjob:
  1. Vælg din procedure i procedureruden til venstre.
    Konfigurationssiderne for den valgte procedure vises til højre.
  2. Åbn fanen Processor.
  3. I tabellen XML-transformationsjobs kan du tilføje eller redigere et XML-transformationsjob.
  4. Klik på siden Efterbehandling for at se behandlingsvalgene for en fuldført behandling (ingen systemfejl) og en fejlet behandling (en eller flere systemfejl). De næste trin gælder for begge sektionerne: Når der ikke er en systemfejl og Når der er systemfejl.
  5. Angiv i felterne Batchprocessor og Batchprocessorjob, hvilket behandlingstrin der eventuelt skal følge efter fuldførelsen af XML-transformationsjobbet. Du kan vælge mellem Ingen, Bekræftelsesprocessor, Genkendelsesprocessor, Konvertering til TIFF, Konvertering til PDF, Aktivopslagsprocessor eller XML-transformationsprocessor.
  6. I e-mailadressefeltet kan du eventuelt indtaste en adresse, som en e-mail skal sendes til, når behandlingen fuldføres eller fejler. Når du konfigurerer og tester et XML-transformationsjob, kan du angive dig selv som modtager af e-mailbeskeder i forbindelse med systemfejl og derefter senere automatisk give en administrator besked om behandlingsfejl.
  7. I de resterende felter skal du angive, hvordan behandlede batches skal ændres.
    • Omdøb batches ved at tilføje et præfiks. Du kan for eksempel omdøbe fejlede batches med præfikset ERR, så der kan følges op på dem.

    • Ændr batchstatus eller -prioritet. Du kan for eksempel ændre status for batches med systemfejl og derefter oprette en klientprofil med batchfiltrering angivet til denne status for at gøre det muligt for kvalificerede brugere manuelt at redigere og fuldføre batches, hvor der opstod fejl.

  8. Klik på Afsend for at gemme jobbet.

Konfigurere batchflow til et XML-transformationsjob

For at køre et XML-transformationsjob skal du konfigurere batches, der overføres til jobbet for at blive behandlet. Du gør dette ved at angive XML-transformationsjobbet som et efterbehandlingstrin i en klientprofil.

Du kan konfigurere batchflows ud fra følgende:

Deaktivere eller slette et XML-transformationsjob

Når du sletter et XML-transformationsjob, er det ikke længere tilgængeligt for batches, hvor det er angivet som et efterbehandlingstrin. Hvis et job, der er angivet til efterbehandling, ikke er tilgængeligt, opstår der en fejl for batchen. Du kan ændre et job til offline i en periode, før du sletter det, så du har mulighed for at løse uventede problemer med sletningen af det. Online XML-transformationsjob køres, når de er valgt i en klientprofil eller på siden Efterbehandling for et processorjob. Du kan stoppe et job midlertidigt (bringe det offline) eller ændre et deaktiveret job, så det kører igen.

Sådan deaktiverer eller sletter du et XML-transformationsjob:
  1. Vælg din procedure i procedureruden til venstre.
    Konfigurationssiderne for den valgte procedure vises til højre.
  2. Åbn fanen Behandling.
  3. Du deaktiverer et job ved at vælge det i tabellen XML-transformationsjob og klikke på Deaktivere eller aktivere et XML-transformationsjob.

    Du kan også deaktivere eller aktivere et XML-transformationsjob ved at vælge eller fravælge feltet Online på siden Dokumentvalg.

  4. Vælg det deaktiverede job i tabellen XML-transformationsjobs, og klik på Slette et XML-transformationsjob.
  5. Klik på Ja, når du bliver spurgt, om du vil slette dette job.