xslt

Utilisez la stratégie xslt pour appliquer une transformation XSL au contenu de la définition d'API.

Prise en charge des passerelles

Tableau 1. Tableau des passerelles prenant en charge cette stratégie, ainsi que la version de stratégie correspondante
Passerelle	Version de la stratégie
DataPower® Gateway (v5 compatible)	1.0.0
DataPower API Gateway	2.0.0 2.1.0 (DataPower API Gateway version 10.0.4.0 ou ultérieure)

Cette rubrique décrit comment configurer la stratégie dans votre source OpenAPI . Pour plus de détails sur la configuration de la stratégie dans l'interface utilisateur de l'assemblage, voir XSLT.

A propos de

La stratégie xslt possède la structure suivante :

- xslt:
   version: version
   title: Title
   description: Description
   input: Input_True_False
   source: Transform

Remarque: Si vous utilisez DataPower API Gateway, l'entrée de la règle xslt doit être des données analysées. Une façon de produire des données analysées consiste à utiliser une stratégie parse avant une stratégie xslt dans votre flux d'assemblage, qui fournit un contrôle explicite de l'action d'analyse.

Propriétés

Le tableau suivant décrit les propriétés de la stratégie :

Tableau 2. xslt Propriétés de politique
Propriété	Obligatoire	Descriptif	Type de données
version	Oui	Numéro de version de la stratégie	chaîne
title	Oui	Titre de la stratégie.	chaîne
description	Non	Description de la stratégie.	chaîne
input	Non	Indique si ce document d'entrée XSLT utilise le contenu contextuel ou s'il n'y a pas d'entrée. La valeur par défaut est `false`.	booléen
serialize-output	Non	Si la propriété est définie sur `true`, l'arborescence de sortie générée par la stratégie XSLT est sérialisée. Le contenu de `message.body` est mis à jour avec les données binaires sérialisées plutôt que l'arborescence XML. La valeur par défaut est `false`.	booléen
source	Oui	Source de transformation XSLT à exécuter.	chaîne
xslt-version	Non	Version du processeur XSLT. La valeur par défaut est XSLT10.	chaîne
strict	Non	Indique si la vérification stricte des erreurs XSLT doit être activée. Les opérations non strictes tentent de récupérer après certaines erreurs, telles que l'utilisation de variables non déclarées, l'appel de modèles non déclarés, etc. Par défaut, la vérification stricte des erreurs XSLT est activée.	booléen
profile	Non	Indique si le profilage de feuille de style doit être activé. Cette option ne doit pas être utilisée dans les environnements de production. Par défaut, le profilage de feuille de style est désactivé.	booléen
debug	Non	Indique si la feuille de style, le script XQuery et le script JSONiq doivent être exécutés en mode débogage. Lorsqu'une feuille de style, un script XQuery ou un script JSONiq est exécuté en mode débogage, une page Web personnalisée est générée au lieu d'afficher sa sortie standard. La page Web détaille exactement ce qu'il s'est produit lors de l'exécution, y compris les valeurs des variables et la provenance des parties spécifiques de la sortie. Cette option ne doit pas être utilisée dans les environnements de production. Par défaut, le mode débogage est désactivé.	booléen
stream	Non	Indique si la feuille de style doit être exécutée en mode diffusion en flux. La transformation du document commence avant que la saisie ne soit entièrement analysée. Toutes les feuilles de style ne peuvent pas être diffusées en continu. Si la feuille de style ne peut pas être diffusée en continu, une erreur est générée et l'entrée n'est pas traitée. Par défaut, le mode de diffusion en continu est désactivé.	booléen
try-stream	Non	Indique s'il faut tenter d'exécuter la feuille de style en mode diffusion en flux. La transformation du document commence avant que la saisie ne soit entièrement analysée. Toutes les feuilles de style ne peuvent pas être diffusées en continu. Si la feuille de style ne peut pas être diffusée en continu, un avertissement est généré lors de la compilation et la feuille de style est lue dans la totalité de l'entrée en mode normal au moment de l'exécution. Par défaut, la tentative d'exécution de la feuille de style en mode diffusion en continu est désactivée.	booléen
minimum-escaping	Non	Indique si la sortie générée à partir de la feuille de style doit être mise en échappement lors du traitement. L'échappement minimal est particulièrement utile lorsque vous manipulez des jeux de caractères non anglais. Par défaut, l'échappement minimal est désactivé.	booléen
stack-size	Non	Nombre maximal d'octets que la pile est autorisée à utiliser lors de l'exécution d'une feuille de style ou d'un autre contenu compilé. Ce paramètre permet de bloquer la récursivité infinie. La valeur minimale est 10 kilooctets, ou 10 240 octets. La valeur maximale est 100 mégaoctets ou 104 857 600 octets. La valeur par défaut est 1 mégaoctet ou 1 048 576 octets.	entier
wsi-validation	Non	Comportement de validation à appliquer aux fichiers WSDL dont la conformité à la section 5 du profil de base WS-I est vérifiée (version 1.0, avril 2004). Le paramètre par défaut est Warn. Ignorer Désactive la vérification de conformité. Avertissement Consigne les avertissements pour les violations. Échec Force la conformité. Echoue si le fichier contient une violation.	chaîne
wsdl-validate-body	Non	Comportement de validation pour `soap:Body`. Le paramètre par défaut est Strict. Stricte Valide cette partie du message par rapport à la définition WSDL. Permet uniquement les messages qui contiennent cette partie et qui correspondent à la définition WSDL. Souple Valide cette partie du message par rapport à la définition WSDL. Si le message contient cette partie et que la définition WSDL ne définit pas cette partie, autoriser le message. Si le message contient cette partie et que la définition WSDL définit cette partie, autoriser le message uniquement lorsqu'il y a une correspondance. Sauter Désactive la validation de cette partie du message.	chaîne
wsdl-validate-headers	Non	Comportement de validation pour `soap:Header`. Le paramètre par défaut est Lax. Stricte Valide cette partie du message par rapport à la définition WSDL. Permet uniquement les messages qui contiennent cette partie et qui correspondent à la définition WSDL. Souple Valide cette partie du message par rapport à la définition WSDL. Si le message contient cette partie et que la définition WSDL ne définit pas cette partie, autoriser le message. Si le message contient cette partie et que la définition WSDL définit cette partie, autoriser le message uniquement lorsqu'il y a une correspondance. Sauter Désactive la validation de cette partie du message.	chaîne
wsdl-validate-faults	Non	Indique le comportement de validation des détails de l'erreur. Le paramètre par défaut est Strict. Stricte Valide cette partie du message par rapport à la définition WSDL. Permet uniquement les messages qui contiennent cette partie et qui correspondent à la définition WSDL. Souple Valide cette partie du message par rapport à la définition WSDL. Si le message contient cette partie et que la définition WSDL ne définit pas cette partie, autoriser le message. Si le message contient cette partie et que la définition WSDL définit cette partie, autoriser le message uniquement lorsqu'il y a une correspondance. Sauter Désactive la validation de cette partie du message.	chaîne
wsdl-wrapped-faults	Non	Indique s'il faut exiger la compatibilité avec les encapsuleurs de style RPC. Par défaut, les encapsuleurs de style RPC ne sont pas obligatoires.	booléen
allow-soap-enc-array	Non	Indique s'il faut autoriser le schéma à accepter la plupart des utilisations d'éléments avec`xsi:type='SOAP-ENC:Array'` cohérent avec SOAP 1.1 Section 5, même lorsque ces attributs violent la spécification de schéma XML. Normalement, l'attribut `xsi:type` doit nommer un type égal ou dérivé du type réel de l'élément. Pour les schémas compilés avec cette option, `xsi:type` est accepté spécifiquement pour le type complexe SOAP 1.1 Encoding'Array'si le type d'élément est dérivé de `SOAP-ENC:Array`. Il s'agit de l'inverse du cas autorisé normal. Par défaut, les éléments avec `xsi:type='SOAP-ENC:Array'` ne sont pas acceptés.	booléen
validate-soap-enc-array	Non	Indique si une validation de schéma supplémentaire doit être effectuée conformément aux règles de codage de la section 5 de SOAP 1.1 . Lorsque cette option est activée, les membres des tableaux SOAP sont validés, les attributs tels que @id et @href sont autorisés même s'ils ne sont pas autorisés par le schéma, et les valeurs @href sont vérifiées pour s'assurer qu'elles possèdent un élément @id correspondant. Par défaut, la validation supplémentaire n'est pas effectuée.	booléen
wildcards-ignore-xsi-type	Non	Indique si les éléments `xs:any` du schéma valident uniquement les éléments enfant par nom. La spécification de schéma XML requiert que, si un caractère générique correspond à un élément mais que cet élément n'a pas de déclaration d'élément, l'élément soit validé en fonction d'un attribut `xsi:type` . Cette option ignore ces attributs `xsi:type` . Elle doit être utilisée pour les cas tels que la validation de l'enveloppe SOAP où une étape de validation supplémentaire valide le contenu correspondant au caractère générique, éventuellement à l'aide des règles de codage SOAP 1.1. Par défaut, les attributs `xsi:type` ne sont pas ignorés.	booléen
wsdl-strict-soap-version	Non	Indique si la liaison SOAP doit être strictement suivie dans le WSDL. Si cette option est activée, seuls les messages liés à SOAP 1.2 apparaissent dans les enveloppes SOAP 1.2 et seuls les messages liés à SOAP 1.1 apparaissent dans les enveloppes SOAP 1.1. Par défaut, la liaison SOAP stricte est désactivée.	booléen
xacml-debug	Non	Indique si les stratégies XACML doivent être compilées avec des informations de débogage. Notez que les messages de débogage XACML sont également contrôlés par l'événement du journal dans la catégorie XACML. Utilisez le niveau de journalisation 'debug' pour afficher les messages de débogage XACML complets. Par défaut, les stratégies XACML ne sont pas compilées avec les informations de débogage.	booléen
allow-xop-include	Non	Indique si le schéma ou le document WSDL accepte les messages dans lesquels le contenu binaire codé en base64 a été optimisé conformément aux spécifications MTOM/XOP. L'optimisation binaire XOP remplace les données binaires base64-encoded par un élément de référence `xop:Include` qui fait référence aux données binaires non codées situées dans une pièce jointe. Par défaut, les messages optimisés MTOM/XOP sont désactivés. Lorsque cette option est désactivée, ces messages optimisés sont rejetés par la validation de la forme optimisée. Le rejet se produit car le schéma spécifie un type simple qui accepte les données base64-encoded , telles que `xs:base64Binary` ou `xs:string`, mais le message contient un élément `xop:Include` à la place. Lorsqu'il est activé, un élément `xop:Include` peut éventuellement apparaître à la place du contenu pour tout type simple de schéma XML qui valide les données binaires base64-encoded . L'élément `xop:Include` lui-même sera validé en fonction du schéma intégré dans `store:///schemas/xop.xsd`.	booléen

Vous pouvez également appliquer une stratégie xslt à l'aide de l'éditeur d'assemblage API Designer pour ajouter une stratégie intégrée à l'API. Pour plus d'informations, voir XSLT dans la section relative aux stratégies intégrées.

Pour des exemples de définitions OpenAPI des stratégies xslt , voir Exemples de stratégie XSLT dans la section des stratégies intégrées.