xslt
Utilice la política xslt para aplicar una transformación XSLT a la carga útil de la definición de API.
Soporte de pasarela
| Pasarela | Versión de política |
|---|---|
| DataPower® Gateway (v5 compatible) | 1.0.0 |
| DataPower API Gateway | 2.0.0 2.1.0 (DataPower API Gateway Versión 10.0.4.0 o posterior) |
En este tema se describe cómo configurar la política en el origen de OpenAPI ; para obtener detalles sobre cómo configurar la política en la interfaz de usuario de ensamblaje, consulte XSLT.
Acerca de
La política xslt tiene la estructura siguiente:
- xslt:
version: version
title: Title
description: Description
input: Input_True_False
source: TransformNota: Si utiliza DataPower API Gateway, la entrada de la política xslt deben ser datos analizados. Una forma de generar datos analizados es utilizar una política
parse antes que una política xslt en el flujo de ensamblaje, que proporciona un control explícito de la acción de análisis.Propiedades
La tabla siguiente describe las propiedades de política.| Propiedad | Obligatorio | Descripción | Tipo de datos |
|---|---|---|---|
| version | Sí | El número de versión de la política | serie |
| title | Sí | El título de la política. | serie |
| description | Nee | Una descripción de la política. | serie |
| input | Nee | Indica si este documento de entrada XSLT utiliza la carga útil actual de contexto o si no hay ninguna entrada. El valor predeterminado es |
booleano |
 serialize-output |
Nee | Si se establece en true, 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 valor predeterminado es |
booleano |
| source | Sí | El origen de la transformación XSLT que se va a ejecutar. | serie |
| xslt-version |
Nee | La versión del procesador XSLT. El valor predeterminado es XSLT10. | serie |
| strict |
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 |
| profile |
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 |
| debug |
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 |
| stream |
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 |
| try-stream |
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 |
| minimum-escaping |
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 |
| stack-size |
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 |
| wsi-validation |
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.
|
serie |
| wsdl-validate-body |
Nee | El comportamiento de validación para soap:Body. El valor predeterminado es Estricto.
|
serie |
| wsdl-validate-headers |
Nee | El comportamiento de validación para
|
serie |
| wsdl-validate-faults |
Nee | Especifica el comportamiento de validación para el detalle de error. El valor predeterminado es Estricto.
|
serie |
| wsdl-wrapped-faults |
Nee | Indica si se requiere compatibilidad con derivadores de estilo RPC. De forma predeterminada, no se requieren encapsuladores estilo RPC. | booleano |
| allow-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 |
| validate-soap-enc-array |
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 |
| wildcards-ignore-xsi-type |
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 |
| wsdl-strict-soap-version |
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 |
| xacml-debug |
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 |
| allow-xop-include |
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.
|
booleano |
También puede aplicar una política xslt utilizando el editor de ensamblaje API Designer para añadir una política incorporada a la API. Para obtener más información, consulte XSLT en la sección de políticas incorporadas.
Para obtener ejemplos de las definiciones de OpenAPI de políticas xslt , consulte Ejemplos de políticas XSLT en la sección de políticas incorporadas.