Questa pagina è stata tradotta dall'API Cloud Translation.

Criterio XSLTransform

Questa pagina si applica ad Apigee e Apigee hybrid.

Visualizza la documentazione di Apigee Edge.

Cosa

Il criterio XSLTransform applica trasformazioni del linguaggio dei fogli di stile Extensible (XSLT) personalizzate ai messaggi XML, consentendoti di trasformarli da XML in un altro formato, ad esempio HTML o testo normale. Il criterio viene spesso utilizzato per integrare applicazioni che supportano XML, ma che richiedono diversi formati basati su XML per gli stessi dati.

Questo criterio è una norma estendibile e il suo utilizzo potrebbe comportare costi o di utilizzo delle applicazioni, a seconda della licenza Apigee. Per informazioni sui tipi di norme e le implicazioni sull'utilizzo, consulta Tipi di criteri.

Nota: questo criterio trasforma il file XML solo se il parametro L'intestazione Content-Type per il messaggio da trasformare è impostata su XML. Ad esempio: text/xml o application/xml.

Input

Il criterio XSL accetta i seguenti input:

(Obbligatorio) Il nome di uno stile XSLT, che contiene un insieme di regole di trasformazione memorizzate nel proxy API in /resources/xsl.
(Obbligatorio) Il codice XML da trasformare (in genere un messaggio di richiesta o risposta).
(Facoltativo) Il nome di una variabile che memorizza l'output.
(Facoltativo) Parametri corrispondenti a quelli nello stile XSL.

Processore di analisi

Apigee si affida a Saxon TCF di elaborazione e supporta TCF 1.0 e 2.0.

Elementi XSL non supportati

Il criterio XSL non supporta i seguenti elementi XSL:

<xsl:include>
<xsl:import>

Esempi

I seguenti esempi mostrano un flusso di trasformazione XSL:

Criterio XSL -->

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

Criterio XSL semplice. Vai all'esempio successivo per vedere lo stile XSLT a cui viene fatto riferimento nel criterio (my_transform.xsl). L'elemento <Source> è importante. Ad esempio, se il codice XML che vuoi trasformare è nella risposta, la trasformazione non si verificano, a meno che non imposti <Source> su response (e il criterio è collegato il flusso di risposta). In questo caso, però, il codice XML da trasformare si trova nella richiesta.

Foglio di stile XSLT -->

<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>

Il foglio di stile my_transform.xsl a cui si fa riferimento nel criterio. Andare alla successiva per vedere un esempio di messaggio XML in arrivo.

Messaggio -->

<?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>

Messaggio di esempio nella richiesta (indicato nell'elemento <Source>request</Source> del criterio nel primo esempio).

Messaggio trasformato

<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>

Il messaggio trasformato dopo il foglio di stile TCF di questi esempi viene applicato al file XML. per creare un nuovo messaggio email.

`<XSL>` elemento

Definisce un criterio XSLTransform.

Valore predefinito	n/a
Obbligatorio?	Obbligatorio
Tipo	Oggetto complesso
Elemento principale	n/a
Elementi secondari	`<OutputVariable>` `<Parameters>` `<ResourceURL>` `<Source>`

Nota: <xsl:include> e <xsl:import> non sono supportati.

L'elemento <XSL> prevede i seguenti attributi:

Attributo	Descrizione	Obbligatorio?	Tipo
`name`	Nome del criterio. I caratteri che puoi utilizzare nel nome sono limitati a: `A-Z0-9._\-$ %`. Tuttavia, l'interfaccia utente di Apigee applica ulteriori limitazioni, come la rimozione automatica dei caratteri non alfanumerici.	Obbligatorio	Stringa

Riferimento all'elemento secondario

Questa sezione descrive gli elementi secondari di <XSL>.

`<OutputVariable>`

Una variabile che memorizza l'output della trasformazione. Devi impostare questo elemento come variabile personalizzata e poi utilizzarla.

Valore predefinito	n/a
Obbligatorio?	Facoltativo
Tipo	Stringa
Elemento principale	`<XSL>`
Elementi secondari	Nessuno

Il valore di <OutputVariable> non può essere un tipo di messaggio, ovvero non può essere message, request o response.

Per sostituire i contenuti del messaggio con l'output della trasformazione, elimina questo elemento. Ad esempio, se stai trasformando un messaggio in HTML, non includere questo elemento.

`<Parameters>`

Aggiunge il supporto per l'elemento <xsl:param> nei fogli di stile. Definisci ciascun parametro come elemento secondario <Parameter> di questo elemento.

Valore predefinito	n/a
Obbligatorio?	Facoltativo
Tipo	Array di elementi `<Parameter>`
Elemento principale	`<XSL>`
Elementi secondari	`<Parameter>`

L'elemento <Parameters> ha i seguenti attributi:

Attributo	Descrizione	Obbligatorio?	Tipo
`ignoreUnresolvedVariables`	Determina se il criterio ignora eventuali errori relativi alle variabili non risolte nello script TCF. istruzioni. Il valore predefinito è `false`, il che significa che, per impostazione predefinita, il criterio restituirà errori se rileva variabili non risolte.	Facoltativo	Booleano

`<Parameter>`

Definisce un parametro nell'elemento <Parameters>.

Valore predefinito	n/a
Obbligatorio?	Facoltativo
Tipo	Oggetto complesso
Elemento principale	`<Parameters>`
Elementi secondari	Nessuno

L'elemento <Parameter> ha i seguenti attributi:

Attributo Obbligatorio? Tipo Descrizione

Attributo	Obbligatorio?	Tipo	Descrizione
`name`	Obbligatorio	Stringa	Il nome del parametro. Apigee abbina il valore impostato qui con il valore attributo `name` su un elemento `<xsl:param>` in foglio di stile. Ad esempio, se inserisci un nome di `uid`, il codice XSL potrebbe avere il seguente aspetto: <xsl:param name="uid" select="''"/>
`ref`	Facoltativo	Stringa	Punta a una variabile di contesto che contiene il valore del parametro. Valori per l'attributo Prima della valutazione di questo criterio, è necessario impostare `ref` variabili di contesto. Ad esempio, se un parametro `uid` deve ottenere il proprio valore da una variabile chiamata `authn.uid`, l'elemento `<Parameter>` sarà simile al seguente: <Parameter name="uid" ref="authn.uid"/> Se utilizzi questo attributo, non usare l'attributo `value`.
`value`	Facoltativo	Stringa	Specifica un valore hardcoded per il parametro. Ad esempio, se un parametro denominato `answer` deve avere il valore 42, ovvero l'elemento `<Parameter>` sarà simile al seguente: <Parameter name="answer" value="42"/> Se utilizzi questo attributo, non usare l'attributo `ref`.

name

Obbligatorio

Stringa

Il nome del parametro. Apigee abbina il valore impostato qui con il valore attributo name su un elemento <xsl:param> in foglio di stile.

Ad esempio, se inserisci un nome di uid, il codice XSL potrebbe avere il seguente aspetto:

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

ref

Facoltativo

Stringa

Punta a una variabile di contesto che contiene il valore del parametro. Valori per l'attributo Prima della valutazione di questo criterio, è necessario impostare ref variabili di contesto.

Ad esempio, se un parametro uid deve ottenere il proprio valore da una variabile chiamata authn.uid, l'elemento <Parameter> sarà simile al seguente:

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

Se utilizzi questo attributo, non usare l'attributo value.

value

Facoltativo

Stringa

Specifica un valore hardcoded per il parametro. Ad esempio, se un parametro denominato answer deve avere il valore 42, ovvero l'elemento <Parameter> sarà simile al seguente:

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

Se utilizzi questo attributo, non usare l'attributo ref.

Il parametro ottiene il valore dall'attributo ref o con un value esplicito.

Per un esempio e per ulteriori informazioni, vedi Come dovrebbero essere usati i parametri facoltativi del criterio XSL Transform?.

`<ResourceURL>`

Il file XSL che Apigee utilizza per trasformare il messaggio. Il valore di questo elemento è nome del foglio di stile XSL memorizzato nel proxy API in /resources/xsl.

Valore predefinito	n/a
Obbligatorio?	Obbligatorio
Tipo	Stringa
Elemento principale	`<XSL>`
Elementi secondari	Nessuno

Ad esempio:

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

Per ulteriori informazioni, consulta i file delle risorse.

`<Source>`

Specifica il messaggio da trasformare. In genere questo valore è impostato su request o response, a seconda che il messaggio da trasformare sia in entrata o in uscita.

Valore predefinito	n/a
Obbligatorio?	Facoltativo
Tipo	Stringa
Elemento principale	`<XSL>`
Elementi secondari	Nessuno

Il file XSL che definisce la trasformazione è definito dall'elemento <ResourceURL>.

Se l'origine non è presente, viene trattata come un semplice messaggio. Ad esempio: <Source>message</Source>
Se la variabile di origine non può essere risolta o si risolve in un tipo non messaggio, la variabile la fase di trasformazione non va a buon fine.

Messaggi di errore

Runtime errors

These errors can occur when the policy executes.

Fault code	HTTP status	Cause	Fix
`steps.xsl.XSLSourceMessageNotAvailable`	`500`	This error occurs if the message or string variable specified in the `<Source>` element of the `XSLTransform` policy is either out of scope (not available in the specific flow where the policy is being executed) or can't be resolved (is not defined).
`steps.xsl.XSLEvaluationFailed`	`500`	This error occurs if the input XML payload is unavailable/malformed or the XSLTransform policy fails/is unable to transform the input XML file based on the transformation rules provided in the XSL file. There could be many different causes for the XSLTransform policy to fail. The reason for failure in the error message will provide more information on the cause.

Deployment errors

These errors can occur when you deploy a proxy containing this policy.

Error name	Cause	Fix
`XSLEmptyResourceUrl`	If the `<ResourceURL>` element in the `XSLTransform` policy is empty, then the deployment of the API proxy fails.
`XSLInvalidResourceType`	If the resource type specified in the `<ResourceURL>` element of the `XSLTransform` policy is not of type `xsl`, then the deployment of the API proxy fails.

Criterio XSLTransform

Cosa

Input

Processore di analisi

Elementi XSL non supportati

Esempi

Criterio XSL -->

Foglio di stile XSLT -->

Messaggio -->

Messaggio trasformato

<XSL> elemento

Riferimento all'elemento secondario

<OutputVariable>

<Parameters>

<Parameter>

<ResourceURL>

<Source>

Messaggi di errore

Runtime errors

Deployment errors

Argomenti correlati

`<XSL>` elemento

`<OutputVariable>`

`<Parameters>`

`<Parameter>`

`<ResourceURL>`

`<Source>`