Criterio XSLTransform

Stai visualizzando la documentazione di Apigee Edge.
Vai alla sezione Documentazione di Apigee X. Informazioni

Cosa

Il criterio XSL Transform applica Extensible stylesheet language transformation (XSLT) personalizzate a Messaggi XML, che ti permettono di trasformarli da XML a un altro formato, ad esempio XML, HTML o testo. Il criterio viene spesso utilizzato per integrare applicazioni che supportano XML, ma che richiedono formati XML diversi per gli stessi dati.

Esempi

Gli esempi riportati di seguito mostrano tutte le risorse di un flusso di trasformazione XSL.

Criterio XSL ->

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

Semplice criterio XSL. Vai all'esempio successivo per visualizzare il foglio di stile TCF a cui viene fatto riferimento nella 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 l'origine 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 TCF ->

<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 viene fatto 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 nel <Source>request</Source> nel primo campione).

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.

Riferimento elemento

Configura un criterio di trasformazione XSL utilizzando i seguenti elementi.

Nome campo Descrizione
Nome (obbligatorio) Nome del criterio. I caratteri utilizzabili nel nome sono limitati a: A-Z0-9._\-$ %. Tuttavia, l'interfaccia utente di gestione applica restrizioni aggiuntive, ad esempio rimuovendo automaticamente i caratteri non alfanumerici.
Fonte (facoltativa) Contiene il messaggio da cui è necessario estrarre le informazioni. Di solito questo valore impostato su request o response, a seconda che il messaggio da trasformare sia in entrata che in uscita.
  • Se manca l'origine, viene considerato un messaggio semplice. 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.
OutputVariable (facoltativo)

Una variabile che archivia l'output della trasformazione. Il campo OutputVariable non può essere del tipo di messaggio, ovvero non può essere "messaggio", "richiesta" o "risposta". Dovresti imposta questo elemento come variabile personalizzata e poi utilizza questa variabile.

Per sostituire il contenuto del messaggio con l'output della trasformazione, elimina questo . Ad esempio, se trasformi un messaggio in HTML, non includere questo .
ResourceURL (obbligatorio) Il file TCF da utilizzare per la trasformazione del messaggio.
Parametri (facoltativi) ignoraUnresolvedVariables (facoltativo)
Ignora eventuali errori relativi alle variabili non risolte nelle istruzioni dello script TCF.
Valori validi: true/false
Valore predefinito: false
Parametro (facoltativo) name (obbligatorio)

I parametri supportano l'utilizzo del parametro XSL nei fogli di stile, in cui il nome aggiunto nel criterio è riportato il nome del parametro XSL. Ad esempio, se inserisci il nome "uid", il tuo XSL potrebbe avere un aspetto simile a questo: <xsl:param name="uid" select="''"/>).

Il parametro riceve il valore da un riferimento a una variabile di contesto (identificata da l'attributo ref) o con un elemento value esplicito.

Per un esempio e per ulteriori informazioni, visita la pagina http://community.apigee.com/questions/1860/how-should-the-the-optional-parameters-on-the-xsl.html#answer-1864.
ref (facoltativo)

Specifica il riferimento che genera il valore da una variabile. Ad esempio, se un &quot;uid&quot; deve ottenere il suo valore da una variabile denominata "authn.uid", il parametro avrà il seguente aspetto: <Parameter name="uid" ref="authn.uid"/>

Se utilizzi questo attributo, non usare l'attributo value.
value (facoltativo)

Puoi utilizzare questo attributo per strutturare il valore del parametro come hardcoded.

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

Note sull'utilizzo

Il codice TCF è implementato in un file .xsl autonomo, che viene memorizzato nell'API proxy in /resources/xsl. Il criterio XSL fa semplicemente riferimento al file XSL. Consulta File di risorse per saperne di più.

Il criterio XSL richiede due input:

  • Il nome di un foglio di stile Hadoop, che contiene un insieme di regole di trasformazione) archiviato nel Proxy API in /resources/xsl
  • L'origine del codice XML da trasformare (in genere un messaggio di richiesta o di risposta)

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

Apigee Edge si basa sul metodo Saxon TCF di elaborazione e supporta TCF 1.0 e 2.0.

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 XSL Transform 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 XSL Transform policy is empty, then the deployment of the API proxy fails.
XSLInvalidResourceType If the resource type specified in the <ResourceURL> element of the XSL Transform policy is not of type xsl, then the deployment of the API proxy fails.

Argomenti correlati