Política XSLTransform

Esta página se aplica a Apigee y Apigee Hybrid.

Consulta la documentación de Apigee Edge.

Qué

La política XSLTransform aplica transformaciones de lenguaje de hoja de estilo extensible (XSLT) personalizadas a mensajes XML, lo que te permite transformar estos mensajes de XML a otro formato, como HTML o texto sin formato. Esta política se suele usar para integrar aplicaciones que admiten XML, pero que requieren formatos basados en XML diferentes para los mismos datos.

Esta política es una política extensible y su uso puede tener implicaciones en cuanto a costes o utilización, en función de tu licencia de Apigee. Para obtener información sobre los tipos de políticas y las implicaciones de uso, consulta Tipos de políticas.

Entradas

La política XSL acepta las siguientes entradas:

• Obligatorio. Nombre de una hoja de estilo XSLT que contiene un conjunto de reglas de transformación almacenadas en el proxy de API en /resources/xsl.
• Obligatorio: el XML que se va a transformar (normalmente, un mensaje de solicitud o de respuesta).
• (Opcional) Nombre de una variable que almacena el resultado.
• (Opcional) Parámetros que coincidan con los parámetros de la hoja de estilo XSL.

Procesador de análisis

Apigee se basa en el procesador Saxon XSLT y admite XSLT 1.0 y 2.0.

Elementos XSL no admitidos

La política XSL no admite los siguientes elementos XSL:

• <xsl:include>
• <xsl:import>

Ejemplos

En los siguientes ejemplos se muestra un flujo de transformación XSL:

<XSL name="TransformXML">
  <ResourceURL>xsl://my_transform.xsl</ResourceURL>
  <Source>request</Source>
</XSL>

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
  <xsl:output method="text"/>
  <xsl:variable name="newline">
    <xsl:text></xsl:text>
  </xsl:variable>
  <xsl:template match="/">
  <xsl:text>&lt;Life&gt;</xsl:text>
    <xsl:value-of select="$newline"/>
    <xsl:text>Here are the odd-numbered items from the list:</xsl:text>
    <xsl:value-of select="$newline"/>
    <xsl:for-each select="list/listitem">
      <xsl:if test="(position() mod 2) = 1">
        <xsl:number format="1. "/>
        <xsl:value-of select="."/>
        <xsl:value-of select="$newline"/>
      </xsl:if>
    </xsl:for-each>
  <xsl:text>&lt;/Life&gt;</xsl:text>
</xsl:template>
</xsl:stylesheet>

<?xml version="1.0"?>
<list>
  <title>A few of my favorite albums</title>
  <listitem>A Love Supreme</listitem>
  <listitem>Beat Crazy</listitem>
  <listitem>Here Come the Warm Jets</listitem>
  <listitem>Kind of Blue</listitem>
  <listitem>London Calling</listitem>
  <listitem>Remain in Light</listitem>
  <listitem>The Joshua Tree</listitem>
  <listitem>The Indestructible Beat of Soweto</listitem>
</list>

<Life>
Here are the odd-numbered items from the list:
1. A Love Supreme
3. Here Come the Warm Jets
5. London Calling
7. The Joshua Tree
</Life>

Elemento <XSL>

Define una política de XSLTransform.

El elemento <XSL> tiene los siguientes atributos:

Referencia de elemento secundario

En esta sección se describen los elementos secundarios de <XSL>.

<OutputVariable>

Variable que almacena el resultado de la transformación. Deberías configurar este elemento como variable personalizada y, a continuación, usar esa variable.

El valor de <OutputVariable> no puede ser de tipo message, es decir, no puede ser message, request ni response.

Para sustituir el contenido del mensaje por el resultado de la transformación, elimina este elemento. Por ejemplo, si vas a transformar un mensaje a HTML, no incluyas este elemento.

<Parameters>

Añade compatibilidad con el elemento <xsl:param> en tus hojas de estilo. Define cada parámetro como un elemento secundario <Parameter> de este elemento.

El elemento <Parameters> tiene los siguientes atributos:

<Parameter>

Define un parámetro en el elemento <Parameters>.

El elemento <Parameter> tiene los siguientes atributos:

<xsl:param name="uid" select="''"/>

<Parameter name="uid" ref="authn.uid"/>

<Parameter name="answer" value="42"/>

El parámetro obtiene su valor del atributo ref o con un value explícito.

Para ver un ejemplo y obtener más información, consulta ¿Cómo se deben usar los parámetros opcionales de la política de transformación XSL?.

<ResourceURL>

El archivo XSL que usa Apigee para transformar el mensaje. El valor de este elemento es el nombre de la hoja de estilo XSL almacenada en el proxy de API en /resources/xsl.

Por ejemplo:

<ResourceURL>xsl://SubscriberNumbers-Request.xsl</ResourceURL>

Para obtener más información, consulta el artículo sobre archivos de recursos.

<Source>

Especifica el mensaje que se va a transformar. Normalmente, este valor se asigna a request o response, en función de si el mensaje que se va a transformar es entrante o saliente.

El archivo XSL que define la transformación se define mediante <ResourceURL>.

• Si falta la fuente, se trata como un mensaje simple. Por ejemplo: <Source>message</Source>
• Si no se puede resolver la variable de origen o se resuelve en un tipo que no es de mensaje, se produce un error en el paso de transformación.

Referencia de errores

Errores de tiempo de ejecución

Estos errores pueden producirse cuando se ejecuta la política.

Errores de implementación

Estos errores pueden producirse al implementar un proxy que contenga esta política.

Temas relacionados