Solo pasarela de API de DataPower

Configuración de la política XSLT para DataPower API Gateway

Siga estos pasos para configurar la política XSLT para DataPower® API Gateway en la interfaz de usuario de ensamblaje.

Acerca de esta tarea

Nota: Este tema describe la implementación de la política XSLT en DataPower API Gateway. Si está utilizando DataPower Gateway (v5 compatible), consulte Configuración de la política XSLT para DataPower Gateway (compatible conv5 ). Para obtener más información sobre los distintos tipos de pasarela, consulte Tipos de pasarela deAPI Connect.

Para obtener información sobre cómo configurar la política en el origen de OpenAPI , consulte xslt.

Procedimiento

  1. En el panel de navegación, pulse Icono de desarrollo en el panel de navegación Desarrollary, a continuación, seleccione la pestaña API.
    Se abre la página Desarrollar .
  2. Pulse el título de la API con la que desea trabajar o cree una API nueva.
  3. Seleccione la pestaña Pasarela y, a continuación, pulse Políticas en el panel de navegación.
    Para obtener más información sobre cómo trabajar con el editor de ensamblaje para una API, consulte El editor de ensamblaje.
  4. Busque la política XSLT en la paleta y arrastre la política al lienzo.
  5. Especifique las propiedades siguientes.
    Tabla 1. Propiedades de política de XSLT
    Etiqueta de propiedad Obligatorio Descripción Tipo de datos
    Título El título de la política.

    El valor predeterminado es xslt.

    serie
    Descripción Nee Una descripción de la política. serie
    Entrada Nee Indica si este documento de entrada XSLT utiliza la carga útil actual de contexto o si no hay ninguna entrada.

    El recuadro de selección está sin marcar de forma predeterminada, lo que indica que no hay ninguna entrada.

    booleano
    Serializar salida Nee Si selecciona esta opción, el árbol de salida generado por la política XSLT se serializa. El contenido de message.body se actualiza con los datos binarios serializados en lugar del árbol XML.

    El recuadro de selección está sin marcar de forma predeterminada, lo que indica que la salida no se serializa.

    booleano
    Origen El origen de la transformación XSLT que se va a ejecutar. serie
    Versión de XSLT Nee La versión del procesador XSLT. El valor predeterminado es XSLT10. serie
    Estricto Nee Indica si se debe habilitar la comprobación de errores XSLT estricta. Las operaciones no estrictas intentan recuperarse de ciertos errores, como uso de variables no declaradas, llamadas a plantillas no declaradas, etc. De forma predeterminada, la comprobación de errores XSLT estricta está habilitada. booleano
    Regla de perfil Nee Indica si se debe habilitar la creación de perfiles de hoja de estilo. Esta opción no debe utilizarse en entornos de producción. De forma predeterminada, el perfilado de hojas de estilo está inhabilitado. booleano
    Regla de depuración Nee Indica si se debe ejecutar la hoja de estilo, el script XQuery y el script JSONiq en modalidad de depuración. Cuando una hoja de estilo, un script XQuery o un script JSONiq se ejecuta en modalidad de depuración, genera una página web personalizada en lugar de mostrar su salida normal. La página web muestra detalles exactos sobre lo que ha ocurrido durante la ejecución, incluidos los valores de las variables y de dónde proceden determinadas partes de la salida. Esta opción no debe utilizarse en entornos de producción. De forma predeterminada, la modalidad de depuración está inhabilitada. booleano
    Regla de transmisión Nee Si la hoja de estilo debe ejecutarse en modalidad continua. La transformación del documento comienza antes de que se haya analizado completamente la entrada. No todas las hojas de estilo se pueden transmitir. Si la hoja de estilo no se puede transmitir, se genera un error y no se procesa la entrada. De forma predeterminada, la modalidad de transmisión está inhabilitada. booleano
    Regla de intento de transmisión Nee Indica si se debe intentar ejecutar la hoja de estilo en modalidad continua. La transformación del documento comienza antes de que se haya analizado completamente la entrada. No todas las hojas de estilo se pueden transmitir. Si la hoja de estilo no se puede transmitir, se genera un aviso durante la compilación y la hoja de estilo se lee en toda la entrada como es habitual en tiempo de ejecución. De forma predeterminada, el intento de ejecutar la hoja de estilo en modalidad de transmisión está inhabilitado. booleano
    Regla de escape de salida mínimo Nee Indica si se debe escapar la salida producida de la hoja de estilo durante el proceso. El escape mínimo resulta especialmente útil cuando se manejan juegos de caracteres distintos del inglés. De forma predeterminada, el escape mínimo está inhabilitado. booleano
    Tamaño máximo de pila Nee El número máximo de bytes que la pila puede utilizar al ejecutar una hoja de estilo u otro contenido compilado. Este valor se utiliza para bloquear la recurrencia infinita. El valor mínimo es 10 kilobytes o 10.240 bytes. El valor máximo es 100 megabytes o 104.857.600 bytes. El valor predeterminado es 1 megabyte o 1.048.576 bytes. entero
    Validación de perfil básico de WS-I Nee El comportamiento de validación que se aplica a los archivos WSDL que se comprueban para la conformidad con la sección 5 de WS-I Basic Profile (versión 1.0, abril de 2004). El valor predeterminado es Avisar.
    Ignorar
    Inhabilita la comprobación de conformidad.
    Avisos
    Anota los avisos de violaciones.
    Error
    Impone conformidad. Falla si el archivo contiene alguna violación.
    serie
    Validar cuerpo del mensaje Nee El comportamiento de validación para soap:Body. El valor predeterminado es Estricto.
    Estricto
    Valida esta parte del mensaje respecto de la definición WSDL. Solo permite mensajes que contengan esta parte y que coincidan con la definición WSDL.
    Laxo
    Valida esta parte del mensaje respecto de la definición WSDL. Si el mensaje contiene esta parte y la definición WSDL no define esta parte, se permite el mensaje. Si el mensaje contiene esta parte y la definición WSDL define esta parte, solo se permite el mensaje cuando hay una coincidencia.
    Omitir
    Inhabilita la validación de esta parte del mensaje.
    serie
    Validar cabeceras de mensaje Nee

    El comportamiento de validación para soap:Header. El valor predeterminado es Lax.

    Estricto
    Valida esta parte del mensaje respecto de la definición WSDL. Solo permite mensajes que contengan esta parte y que coincidan con la definición WSDL.
    Laxo
    Valida esta parte del mensaje respecto de la definición WSDL. Si el mensaje contiene esta parte y la definición WSDL no define esta parte, se permite el mensaje. Si el mensaje contiene esta parte y la definición WSDL define esta parte, solo se permite el mensaje cuando hay una coincidencia.
    Omitir
    Inhabilita la validación de esta parte del mensaje.
    serie
    Validar detalles de error de mensaje Nee Especifica el comportamiento de validación para el detalle de error. El valor predeterminado es Estricto.
    Estricto
    Valida esta parte del mensaje respecto de la definición WSDL. Solo permite mensajes que contengan esta parte y que coincidan con la definición WSDL.
    Laxo
    Valida esta parte del mensaje respecto de la definición WSDL. Si el mensaje contiene esta parte y la definición WSDL no define esta parte, se permite el mensaje. Si el mensaje contiene esta parte y la definición WSDL define esta parte, solo se permite el mensaje cuando hay una coincidencia.
    Omitir
    Inhabilita la validación de esta parte del mensaje.
    serie
    Requerir encapsuladores en los detalles de error especificados por tipo Nee Indica si se requiere compatibilidad con derivadores de estilo RPC. De forma predeterminada, no se requieren encapsuladores estilo RPC. booleano
    Regla para permitir específicamente xsi:type='SOAP-ENC:Array' Nee Indica si se debe permitir que el esquema acepte la mayoría de los usos de elementos con xsi:type='SOAP-ENC:Array' coherente con SOAP 1.1 Sección 5, incluso cuando estos atributos violan la especificación de esquema XML. Normalmente, el atributo xsi:type debe nombrar un tipo igual o derivado del tipo real del elemento. Para esquemas compilados con esta opción, xsi:type se acepta específicamente para el tipo complejo SOAP 1.1 Encoding 'Array' si el tipo de elemento se deriva de SOAP-ENC:Array. Lo contrario es el caso normal permitido. De forma predeterminada, los elementos con xsi:type='SOAP-ENC:Array' no se aceptan. booleano
    Validar regla de codificación SOAP 1.1 Nee Indica si se debe realizar una validación de esquema adicional siguiendo las reglas de codificación en SOAP 1.1 Sección 5. Cuando está habilitado, los miembros de matrices SOAP se validan, se permiten atributos como @id y @href aunque el esquema no los permita, y se comprueban los valores @href para garantizar que tengan un elemento @id correspondiente. De forma predeterminada, no se realiza la validación adicional. booleano
    Regla xsi:type para ignorar caracteres comodín Nee Indica si los elementos xs:any del esquema validan sólo los elementos hijo por nombre. La especificación de esquema XML requiere que, si un comodín coincide con un elemento pero dicho elemento no tiene una declaración de elemento, el elemento se valide en su lugar según un atributo xsi:type . Esta opción ignora estos atributos xsi:type . Debe utilizarse en casos como la validación de sobres SOAP donde un paso de validación adicional validará el contenido que coincida con el carácter comodín, posiblemente utilizando las reglas de codificación SOAP 1.1. De forma predeterminada, los atributos xsi:type no se ignoran. booleano
    Versión de sobre de SOAP estricto Nee Indica si se debe seguir estrictamente el enlace SOAP en el WSDL. Cuando esta opción está habilitada, solo los mensajes enlazados a SOAP 1.2 aparecen en sobres SOAP 1.2 y solo los mensajes enlazados a SOAP 1.1 aparecen en sobres SOAP 1.1. De forma predeterminada, el enlace SOAP estricto está inhabilitado. booleano
    Política XACML de depuración Nee Indica si se deben compilar las políticas XACML con información de depuración. Tenga en cuenta que los mensajes de depuración XACML también están controlados por el suceso de registro en la categoría XACML. Utilice el nivel de registro de depuración para ver los mensajes de depuración XACML completos. De forma predeterminada, las políticas XACML no se compilan con información de depuración. booleano
    Aceptar mensajes optimizados de MTOM/XOP Nee Especifica si el documento de esquema o WSDL acepta mensajes en los que el contenido binario codificado en base64 se ha optimizado según las especificaciones MTOM/XOP. La optimización binaria XOP sustituye los datos binarios base64-encoded por un elemento de referencia xop:Include que hace referencia a los datos binarios no codificados ubicados en un archivo adjunto. De forma predeterminada, los mensajes optimizados de MTOM/XOP están inhabilitados.
    • Cuando está inhabilitada, la validación del formato optimizado rechaza estos mensajes optimizados. El rechazo se produce porque el esquema especifica un tipo simple que acepta datos base64-encoded , como xs:base64Binary o xs:string, pero el mensaje contiene un elemento xop:Include en su lugar.
    • Cuando está habilitado, un elemento xop:Include puede aparecer opcionalmente en lugar de contenido para cualquier tipo simple de esquema XML que valide datos binarios base64-encoded . El propio elemento xop:Include se validará de acuerdo con el esquema incorporado en store:///schemas/xop.xsd.
    booleano
  6. Especifique una versión para la política pulsando el icono Origen Icono OpenAPI Sourcey completando la sección version del YAML de política. Por ejemplo:
    execute:
      - xslt:
          version: 2.1.0
          title: xslt
      ...
    Debe especificar una versión para la política que sea compatible con la pasarela que está utilizando. Cuando se publica la API, si la versión es incompatible con la pasarela, se genera un error de validación que especifica las versiones disponibles.
  7. Pulse Guardar.