Configuración de los trabajos de transformación XML

Puede crear un trabajo de transformación XML para transformar un archivo XML en la salida que desee, así como asignar valores de campos de metadatos de Capture del XML. Puede hacer esto configurando las combinaciones soportadas de definiciones de procesadores XSLT y suministrando el archivo XSLT personalizado. Además, se puede asignar una expresión XPath a los campos de metadatos de Capture. A continuación, las aplicaciones de terceros pueden usar el archivo XML convertido para ajustarse a las necesidades específicas de las otras partes.

Nota:

No puede crear trabajos de transformación XML en Oracle Content Management Starter Edition. Para utilizar esta función, debe cambiar de versión a Oracle Content Management Premium Edition. Para obtener más información, consulte Starter Edition frente a Premium Edition.

  1. En el panel de procedimientos de la izquierda, seleccione el procedimiento.

    Las páginas de configuración del procedimiento seleccionado aparecen a la derecha.

  2. Abra el separador Procesamiento.

  3. En la tabla Trabajos de transformación XML, haga clic en Agregar trabajo de transformación XML, o para editar un trabajo existente, haga clic en Editar el trabajo de transformación XML.

    También puede copiar un trabajo de transformación XML seleccionándolo, haciendo clic en Copiar trabajo de transformación e introduciendo un nuevo nombre cuando se le solicite. Al copiar un trabajo puede duplicarlo rápidamente y modificarlo.

  4. En la página Selección de documentos:

    1. En la sección Selección de documentos, realice estas acciones:

      • Introduzca un nombre y una descripción para el trabajo.

      • Para procesar el trabajo de transformación XML para perfiles de documentos específicos, seleccione uno o varios perfiles de documentos en el campo Restringir a perfiles de documento:, o bien seleccione Todos para procesar los documentos para todos los perfiles de documentos definidos.

    2. En la lista desplegable Destino de salida de transformación, seleccione una opción adecuada:
      • Documento: sustituye al documento original con los resultados de la transformación. También puede cambiar el perfil de documento si lo desea.
      • Documento, Conservar copia: conserva la copia original. También puede seleccionar un perfil de documento si selecciona esta opción. Sin embargo, debe seleccionar un tipo de anexo en la lista desplegable Conservar como tipo de anexo.
      • Anexo: almacena los resultados de la transformación como un anexo. Debe seleccionar un tipo de anexo en la lista desplegable Nuevo tipo de anexo.
      • Campo de captura: almacena los resultados de la transformación en un campo de Capture. Debe seleccionar Campo de texto en la lista desplegable Campo de captura.
    3. En la sección Selección de anexos:
      1. Seleccione la casilla de control Procesar anexos si se aplica a las opciones que haya realizado en los pasos anteriores.
      2. Para restringir a los tipos de anexos necesarios, seleccione las casillas de control de los tipos de anexos disponibles. También puede seleccionar todos ellos.
      3. Seleccione el destino de salida de transformación:
        • Anexo: puede cambiar el tipo de anexo.
        • Anexo, Conservar una copia: puede seleccionar el tipo de anexo. Sin embargo, debe seleccionar un tipo de anexo en la lista desplegable Conservar como tipo de anexo.
        • Campo de captura: debe seleccionar Campo de texto o Campo XML.
  5. En la página Transformación: Definición de transformación:
    1. Si la casilla de control Realizar transformación XML aún no está seleccionada, selecciónela para activar la edición de los valores de campos en esta página. Al anular la selección de esta casilla de control, se desactiva la edición, pero se conservan los últimos valores guardados en los campos. Puede anular la selección de esta casilla de control cuando no se necesite la transformación XML.
    2. En la sección Motor de transformación:
      • Seleccione las opciones Versión XSLT, Procesador y Versión del procesador compatibles. Seleccione los valores por defecto del sistema o una de las versiones XSLT disponibles compatibles con los procesadores Xalan y Saxon-HE y sus versiones.
      • Especifique una extensión del archivo de salida como XML, HTML, JSON o texto.

        Nota:

        Si la extensión del archivo de salida no es XML, la página Asignación de campo estará desactivada.
    3. Para realizar una transformación, cargue o escriba en el XSLT en la sección Hoja de estilo XML.
    4. Los parámetros que haya incluido en el XSLT se deben definir en la tabla Parámetros. Para ello:
      1. En la tabla Parámetros, haga clic en Agregar parámetros.
      2. En el cuadro de diálogo Agregar parámetros XSLT, agregue el nombre del parámetro y asígnele un valor. Puede agregar un valor de texto o ensamblar un valor de metadatos para los parámetros.
      3. Repita los pasos i e ii para definir los parámetros necesarios.

        Nota:

        Si no asigna valores a parámetros definidos en XSLT, o bien si asigna valores a esos parámetros que no existen en el XSLT, no podrá guardar el trabajo de transformación XML ni recibir una notificación de este cuando intente guardar el trabajo de transformación.
    5. En la sección Pruebas de transformación, cargue el XML transformado y realice un prueba para confirmar que se ha generado correctamente y, a continuación, haga clic en Siguiente. También puede obtener una vista previa del contenido en esta sección. Para ello, haga clic en Vista previa en la parte superior derecha de esta sección.
  6. En la página Asignación de campo, defina la navegación a elementos o atributos específicos para que los usuarios puedan extraer sus valores del documento XML:
    1. Seleccione la casilla de control Realizar asignación de campo XPath para activar la edición de la tabla Asignación de campo XPath. Si anula la selección de esta casilla de control, no podrá editar la tabla. No obstante, se conservan los últimos valores guardados.
    2. Seleccione la casilla de control Abortar el lote con errores de análisis si se debe respectar de forma estricta el formato de análisis que vaya a seleccionar en el paso siguiente.
    3. En la parte superior derecha de la tabla Asignación de campos XPath, haga clic en Editar asignación de campo de XPath
    4. En el cuadro de diálogo Editar asignación de campo de XPath:
      1. En el campo Expresión XPath, especifique la expresión XPath del campo de datos de metadatos seleccionado y seleccione el formato de análisis.

        La expresión XPath se evalúa en la salida de la transformación si hay una. Si no se realiza una transformación, se evalúa la expresión XPath en el documento o anexo.

      2. En la lista desplegable Formato de análisis de fecha, seleccione el formato de análisis. Si el campo Captura es un número, verá una lista desplegable Formato de análisis de números en su lugar. Si es necesario, se puede seleccionar un formato de análisis personalizado en la lista desplegable.
      3. Haga clic en Aceptar.

        El valor que se agrega a la columna Expresión XPath de la tabla Asignación de campo XPath se analiza en una fecha con el formato seleccionado.

    5. Haga clic en Aceptar.
  7. En la página Procesamiento posterior, especifique lo que sucede una vez que finalice el trabajo de transformación XML.
    • Si no se produce ningún error del sistema es porque se han cumplido todos los criterios de la página anterior. Una transformación correcta puede pasar al paso de confirmación.
    • Los errores del sistema se producen cuando la transformación falla: no se ha encontrado ningún registro, se han encontrado demasiados registros, etc. Para transformaciones con fallos, el lote se devuelve al cliente de Content Capture para su reparación.
    Consulte Configuración del procesamiento posterior y supervisión de un trabajo de transformación XML

  8. Revise la configuración en la página Resumen y haga clic en Enviar para guardar el trabajo.

  9. Configure cómo los lotes pasan a los trabajos de transformación XML. Consulte Configuración de un flujo de lotes en un trabajo de transformación XML.

  10. Pruebe el trabajo de transformación XML que haya creado.

Configuración del procesamiento posterior y supervisión de un trabajo de transformación XML

Utilice las opciones de procesamiento posterior de un trabajo de transformación XML para especificar qué ocurre después de completarse el proceso.

Para configurar el procesamiento posterior y la supervisión de un trabajo de transformación XML:
  1. En el panel de procedimientos de la izquierda, seleccione el procedimiento.
    Las páginas de configuración del procedimiento seleccionado aparecen a la derecha.
  2. Abra el separador Procesador.
  3. En la tabla Trabajos de transformación XML, agregue o edite un trabajo de transformación XML.
  4. Haga clic en la página Procesamiento posterior para mostrar las opciones de procesamiento para el procesamiento correcto (ningún error del sistema) y el procesamiento incorrecto (uno o más errores del sistema). El siguiente paso se aplica a ambas secciones: Si no hay ningún error del sistema y Si hay errores del sistema.
  5. En los campos Procesador de lotes y Trabajo de procesador de lotes, especifique qué paso de procesamiento, si lo hay, se produce después de completarse el trabajo de transformación XML. Puede seleccionar Ninguno, Procesador de confirmación, Procesador de reconocimiento, Conversiones a TIFF, Conversión a PDF, Procesador de consulta de activos o Procesador de transformación XML.
  6. En el campo de dirección de correo electrónico, puede introducir una dirección a la que enviar un correo electrónico una vez que el procesamiento termina de forma correcta o falla. Durante la configuración y la prueba de un trabajo de transformación XML, puede configurarse a sí mismo para recibir notificaciones de correo electrónico si se producen errores del sistema y, a continuación, alertar automáticamente a un administrador de los errores de procesamiento.
  7. En los campos restantes, especifique cómo se deben cambiar los lotes procesados.

    • Renombre lotes mediante la adición de un prefijo. Por ejemplo, renombre los lotes incorrectos con el prefijo ERR para realizar un seguimiento.

    • Cambie el estado o la prioridad del lote. Por ejemplo, puede cambiar el estado de los lotes con errores del sistema y crear a continuación un perfil de cliente con el filtrado de lotes definido en este estado para permitir que los usuarios cualificados editen y completen manualmente los lotes con errores.

  8. Haga clic en Enviar para guardar el trabajo.

Configuración de un flujo de lotes en un trabajo de transformación XML

Para ejecutar un trabajo de transformación XML, debe configurar que los lotes fluyan hacia el trabajo para su procesamiento. Esto se realiza definiendo el trabajo de transformación XML como un paso de procesamiento posterior en un perfil de cliente.

Puede configurar flujos de lotes desde:

Desactivación o supresión de un trabajo de transformación XML

Cuando se suprime un trabajo de transformación XML, este ya no permanece disponible para los lotes para los que está definido como paso de procesamiento posterior. Si no está disponible un trabajo especificado para el procesamiento posterior, se producirá un error en el lote. Puede que desee cambiar un trabajo a fuera de línea durante determinado tiempo, permitiéndole resolver problemas inesperados con su supresión. Los trabajos de transformación XML en línea se ejecutan cuando se seleccionan en un perfil de cliente o en la página Procesamiento posterior de un trabajo de procesador. Puede parar temporalmente un trabajo (ponerlo fuera de línea) o cambiar un trabajo desactivado para que se vuelva a ejecutar.

Para desactivar o suprimir un trabajo de transformación XML:
  1. En el panel de procedimientos de la izquierda, seleccione el procedimiento.
    Las páginas de configuración del procedimiento seleccionado aparecen a la derecha.
  2. Abra el separador Procesamiento.
  3. Para desactivar un trabajo, selecciónelo en la tabla Trabajos de transformación XML y haga clic en Desactivar o activar un trabajo de transformación XML.

    También puede desactivar o activar un trabajo de transformación XML seleccionando o anulando la selección del campo En línea en la página Selección de documentos.

  4. Seleccione el trabajo desactivado en la tabla Trabajos de transformación XML y haga clic en Suprimir un trabajo de transformación XML.
  5. Cuando se le solicite, haga clic en Sí para confirmar que desea suprimir este trabajo.