Konfigurering av XML-transformeringsjobber

Du kan opprette en XML-transformeringsjobb for å transformere en XML-fil til ønsket utdataformat. Du kan også tilordne verdier i Capture-metadatafelt fra XML-filen. Dette kan du gjøre ved å konfigurere de støttede kombinasjonene av XSLT-behandlerdefinisjoner og bruke en egendefinert XSLT-fil. I tillegg kan du tilordne et XPath-uttrykk til Capture-metadatafelt. Den konverterte XML-filen kan deretter brukes av tredjeparts applikasjoner for å tilpasses de andre partenes forretningsbehov.

Merknad:

Du kan ikke opprette XML-transformeringsjobber i Oracle Content Management Starter Edition. Hvis du vil bruke denne funksjonen, må du oppgradere til Oracle Content Management Premium Edition. Hvis du vil ha flere opplysninger, kan du se Starter kontra Premium Edition.

  1. Velg prosedyre i ruten Prosedyrer til venstre.

    Konfigurasjonssidene for den valgte prosedyren blir vist til høyre.

  2. Åpne fanen Behandler.

  3. I tabellen XML-transformeringsjobber klikker du på Legg til XML-transformeringsjobb, eller du kan klikke på Rediger XML-transformeringsjobb hvis du vil redigere en eksisterende jobb.

    Du kan også kopiere en XML-transformeringsjobb ved å velge den, klikke på Kopier transformeringsjobb og angi et nytt navn når du blir bedt om det. Ved å kopiere en jobb kan du raskt duplisere og endre den.

  4. På siden Dokumentvalg:

    1. Gjør følgende i delen Dokumentvalg:

      • Angi et navn og en beskrivelse for jobben.

      • Hvis du vil kjøre XML-transformeringsjobben for bestemte dokumentprofiler, velger du én eller flere dokumentprofiler i feltet Begrens til dokumentprofiler, eller velger Alle hvis du vil behandle dokumenter for alle definerte dokumentprofiler.

    2. Velg et egnet alternativ fra rullegardinlisten Mål for transformeringsutdata:
      • Dokument: Erstatter det opprinnelige dokumentet med transformeringsresultatet. Du kan også endre dokumentprofilen hvis du ønsker det.
      • Dokument, behold kopi: Beholder den opprinnelige kopien. Du kan også velge en dokumentprofil hvis du velger dette alternativet. Men du må velge en vedleggstype fra rullegardinlisten Behold vedleggstype.
      • Vedlegg: Lagrer resultatet av transformeringen som et vedlegg. Du må velge en vedleggstype fra rullegardinlisten Ny vedleggstype.
      • Registreringsfelt: Lagrer resultatet av transformeringen i et registreringsfelt. Du må velge Tekstfelt fra rullegardinlisten Registreringsfelt.
    3. I delen Vedleggsvalg:
      1. Merk av for Behandle vedlegg hvis det er aktuelt for valgene du har gjort i de forrige trinnene.
      2. Begrens valget til de nødvendige vedleggstypene ved å merke av for de tilgjengelige vedleggstypene. Du kan også velge alle.
      3. Velg målet for transformeringsutdataene:
        • Vedlegg: Du har mulighet til å endre vedleggstypen.
        • Vedlegg, behold en kopi: Du har mulighet til å velge vedleggstypen. Men du må velge en vedleggstype fra rullegardinlisten Behold vedleggstype.
        • Registreringsfelt: Du må velge Tekstfelt eller XML-felt.
  5. På siden Transformasjon - Transformeringsdefinisjon:
    1. Hvis det ikke allerede er merket av for Utfør XML-transformering, merker du av for dette slik at det blir mulig å redigere feltverdiene på denne siden. Hvis du fjerner merkingen for dette valget, blir det ikke mulig å redigere, og de siste verdiene som ble lagret, beholdes i dette feltet. Du kan fjerne merkingen for dette valget når XML-transformering ikke er nødvendig.
    2. I delen Transformeringsmotor:
      • Velg kompatibel XSLT-versjon, Prosessor og Prosessorversjon. Velg systemstandarder, eller velg blant de tilgjengelige XSLT-versjonene som er kompatible med Xalan- og Saxon-HE-prosessorene og deres versjoner.
      • Angi en Utdatafiltype, for eksempel XML, HTML, JSON eller tekst.

        Merknad:

        Hvis utdatafiltypen ikke er XML, er siden Felttilordning deaktivert.
    3. Når du vil utføre en transformering, laster du eller skriver inn XSLT-et i delen XML-stilark.
    4. Parametre du inkluderer i XSLT-et, må være definert i tabellen Parametre. Slik gjør du dette:
      1. I tabellen Parametre klikker du på Legg til parametre.
      2. I dialogboksen Legg til XSLT-parametre legger du til parameternavnet og tilordner det en verdi. Du kan legge til en tekstverdi eller samle en metadataverdi for parametrene.
      3. Gjenta trinn i og ii når du skal angi de nødvendige parametrene.

        Merknad:

        Hvis du ikke tilordner noen verdier til parametrene som er definert i XSLT, eller hvis du tilordner verdier til de parametrene som ikke finnes i XSLT, vil du ikke kunne lagre XML-transformeringsjobben, og du blir varslet om dette når du prøver å lagre transformeringsjobben.
    5. I delen Transformeringstesting laster du og tester det transformerte XML-dokumentet for å bekrefte at det er riktig generert, og deretter klikker du på Neste. Du kan også forhåndsvise innholdet i denne delen ved å klikke på Forhåndsvisning øverst til høyre i denne delen.
  6. På siden Felttilordning definerer du navigeringen til bestemte elementer eller attributter, slik at brukerne kan trekke ut verdiene fra XML-dokumentet:
    1. Merk av for Utfør felttilordning for XPath slik at det blir mulig å redigere tabellen Felttilordning for XPath. Hvis du fjerner avmerkingen for dette valget, vil du ikke kunne redigere tabellen. Men de siste verdiene som ble lagret, blir beholdt.
    2. Merk av for Avbryt bunke ved analysefeil hvis analyseformatet du skal velge i neste trinn, må overholdes.
    3. Øverst til høyre i tabellen Felttilordning for XPath klikker du på Rediger felttilordning for XPath
    4. I dialogboksen Rediger felttilordning for XPath:
      1. I feltet XPath-uttrykk angir du XPath-uttrykket for det valgte metadatafeltet og velger analyseformatet.

        XPath-uttrykket evalueres i utdataene for transformeringen hvis det er utført en. Hvis det ikke er utført noen transformering, evalueres XPath-uttrykket i dokumentet eller vedlegget.

      2. Velg analyseformatet fra rullegardinlisten Analyseformat for dato. Hvis registreringsfeltet er et tall, ser du rullegardinlisten Analyseformat for tall i stedet. Om nødvendig kan du velge et tilpasset analyseformat fra rullegardinlisten.
      3. Klikk på OK.

        Verdien som er lagt til i kolonnen XPath-uttrykk i tabellen Felttilordning for XPath, analyseres til en dato i det formatet du har valgt.

    5. Klikk på OK.
  7. På siden Etterbehandling angir du hva som skal skje når en XML-transformeringsjobb er fullført, basert på følgende:
    • Situasjoner der det ikke finnes noen systemfeil, er tilfeller der alle kriteriene på den forrige siden er oppfylt. En vellykket transformering kan flyte til lagring.
    • Systemfeil er alle tilfeller der transformeringen mislykkes, ingen poster blir funnet, for mange poster blir funnet, osv. Hvis transformeringen mislykkes, blir bunken sendt tilbake til Content Capture Client for å bli reparert.
    Se Konfigurere etterbehandling og overvåking av en XML-transformeringsjobb

  8. Se over innstillingene på siden Sammendrag, og klikk på Send når du vil lagre jobben.

  9. Konfigurer hvordan bunker skal flyte til XML-transformeringsjobber. Se Konfigurere bunkeflyt til en XML-transformeringsjobb.

  10. Test XML-transformeringsjobben du opprettet.

Konfigurere etterbehandling og overvåking av en XML-transformeringsjobb

Bruk etterbehandlingsvalg for en XML-transformeringsjobb til å angi hva som skal skje når behandlingen er fullført.

Slik konfigurerer du etterbehandling og overvåking av en XML-transformeringsjobb:
  1. Velg prosedyre i ruten Prosedyrer til venstre.
    Konfigurasjonssidene for den valgte prosedyren blir vist til høyre.
  2. Åpne fanen Behandler.
  3. I tabellen XML-transformeringsjobber kan du legge til eller redigere en XML-transformeringsjobb.
  4. Klikk på siden Etterbehandling slik at behandlingsvalgene for vellykket behandling (ingen systemfeil) og mislykket behandling (én eller flere systemfeil) vises. De neste trinnene gjelder for begge delene: Når det ikke finnes noen systemfeil og Når det finnes systemfeil.
  5. I feltene Bunkebehandler og Bunkebehandlerjobb angir du hvilket behandlingstrinn som eventuelt skal utføres når XML-transformeringsjobben er fullført. Du kan velge Ingen, Lagringsbehandler, Gjenkjenningsbehandler, Konverteringer til TIFF, Konverteringer til PDF, Aktivaoppslagsbehandler eller XML-transformeringsbehandler.
  6. I feltet for e-postadresse kan du angi en adresse som det skal sendes en e-post til etter at behandlingen er fullført, enten den er vellykket eller mislykket. Mens du konfigurerer og tester en XML-transformeringsjobb, kan du definere deg selv som mottaker av e-postvarslinger hvis det oppstår systemfeil, og deretter sende automatisk varsel til en administrator om behandlingsfeil.
  7. I de gjenværende feltene angir du hvordan du vil endre behandlede bunker.

    • Gi bunker nytt navn ved å legge til et prefiks. Du kan for eksempel gi mislykkede bunker nytt navn slik at de får prefikset ERR for oppfølging.

    • Endre status eller prioritet for bunker. Du kan for eksempel endre statusen for bunker med systemfeil og deretter opprette en klientprofil med bunkefiltrering satt til denne statusen, slik at kvalifiserte brukere kan redigere og fullføre bunker der det oppstod feil, manuelt.

  8. Klikk på Send slik at du lagrer jobben.

Konfigurere bunkeflyt til en XML-transformeringsjobb

Når du skal kjøre en XML-transformeringsjobb, må du konfigurere bunker for flyt til jobben for behandling. Dette gjør du ved å definere XML-transformeringsjobben som et etterbehandlingstrinn i en klientprofil.

Du kan konfigurere bunkeflyter fra følgende:

Deaktivere eller slette en XML-transformeringsjobb

Når du sletter en XML-transformeringsjobb, blir den ikke lenger tilgjengelig for bunker som den er angitt som et etterbehandlingstrinn for. Hvis en jobb som er angitt for etterbehandling, ikke er tilgjengelig, oppstår det en feil for bunken. Du ønsker kanskje å endre en jobb til frakoblet en stund før du sletter den, slik at du kan løse uventede problemer med slettingen av den. Tilkoblede XML-transformeringsjobber kjører når de har blitt valgt i en klientprofil eller på siden Etterbehandling for en behandlerjobb. Du kan stoppe en jobb midlertidig (frakoble den) eller endre en deaktivert jobb slik at den kjører igjen.

Slik deaktiverer eller sletter du en XML-transformeringsjobb:
  1. Velg prosedyre i ruten Prosedyrer til venstre.
    Konfigurasjonssidene for den valgte prosedyren vises til høyre.
  2. Åpne fanen Behandler.
  3. Hvis du vil deaktivere en jobb, velger du den i tabellen XML-transformeringsjobber og klikker på Deaktiver eller aktiver en XML-transformeringsjobb.

    Du kan også deaktivere eller aktivere en XML-transformeringsjobb ved å merke av for eller fjerne merket for feltet Tilkoblet på siden Dokumentvalg.

  4. Velg den deaktiverte jobben i tabellen XML-transformeringsjobber, og klikk på Slett en XML-transformeringsjobb.
  5. Klikk på Ja når du blir spurt, for å bekrefte at du vil slette denne jobben.