Questa pagina si applica ad Apigee e Apigee hybrid.
Visualizza la documentazione di
Apigee Edge.
Il criterio XSLTransform applica trasformazioni XSLT (Extensible Stylesheet Language Transformations) personalizzate ai messaggi XML, consentendoti di trasformarli da XML a 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.
Queste norme sono estendibili e il loro utilizzo potrebbe avere implicazioni in termini di costi o utilizzo, a seconda della licenza Apigee. Per informazioni sui tipi di policy e sulle implicazioni di utilizzo, consulta Tipi di policy.
Input
La policy XSL accetta i seguenti input:
- (Obbligatorio) Il nome di un foglio di stile XSLT, che contiene un insieme di
regole di trasformazione archiviate nel proxy API in
/resources/xsl. - (Obbligatorio) L'XML da trasformare (in genere un messaggio di richiesta o risposta).
- (Facoltativo) Il nome di una variabile che memorizza l'output.
- (Facoltativo) Parametri che corrispondono a quelli nel foglio di stile XSL.
Processore di analisi
Apigee si basa sul processore Saxon XSLT e supporta XSLT 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:
Policy XSL -->
<XSL name="TransformXML"> <ResourceURL>xsl://my_transform.xsl</ResourceURL> <Source>request</Source> </XSL>
Policy XSL semplice. Vai all'esempio successivo per visualizzare il foglio di stile XSLT a cui viene fatto riferimento nelle norme (my_transform.xsl). L'elemento <Source> è importante.
Ad esempio, se l'XML che vuoi trasformare si trova nella risposta, la trasformazione non
avverrà a meno che tu non imposti <Source> su response (e la norma sia allegata
al flusso di risposta). Ma in questo caso, l'XML da trasformare si trova nella richiesta.
XSLT stylesheet -->
<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><Life></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></Life></xsl:text> </xsl:template> </xsl:stylesheet>
Il foglio di stile my_transform.xsl a cui viene fatto riferimento nella policy. Vai all'esempio
successivo per vedere un esempio di messaggio XML in entrata.
Message -->
<?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> della norma 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 l'applicazione del foglio di stile XSLT di questi esempi al messaggio XML.
Elemento <XSL>
Definisce una policy XSLTransform.
| Valore predefinito | n/a |
| Obbligatorio? | Obbligatorio |
| Tipo | Oggetto complesso |
| Elemento principale | n/a |
| Elementi secondari |
<OutputVariable><Parameters><ResourceURL><Source> |
L'elemento <XSL> prevede i seguenti attributi:
| Attributo | Descrizione | Obbligatorio? | Tipo |
|---|---|---|---|
name |
Il nome del criterio. I caratteri che puoi utilizzare nel nome sono limitati a:
A-Z0-9._\-$ %. Tuttavia, la UI Apigee impone ulteriori restrizioni,
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 di tipo 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 dell'elemento <xsl:param> nei fogli di stile. Definisci
ogni 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> prevede i seguenti attributi:
| Attributo | Descrizione | Obbligatorio? | Tipo |
|---|---|---|---|
ignoreUnresolvedVariables |
Determina se la policy ignora eventuali errori di variabili non risolti nelle istruzioni dello script XSLT. Il valore predefinito è false, il che significa che, per impostazione predefinita,
il criterio genererà 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> prevede i seguenti attributi:
| Attributo | Obbligatorio? | Tipo | Descrizione |
|---|---|---|---|
name |
Obbligatorio | Stringa |
Il nome del parametro. Apigee confronta il valore che imposti qui con il valore dell'attributo Ad esempio, se inserisci il nome
<xsl:param name="uid" select="''"/> |
ref |
Facoltativo | Stringa |
Punta a una variabile di contesto che contiene il valore del parametro. I valori delle
variabili di contesto Ad esempio, se un
parametro <Parameter name="uid" ref="authn.uid"/> Se utilizzi questo attributo, non utilizzare l'attributo |
value |
Facoltativo | Stringa |
Specifica un valore hardcoded per il parametro. Ad esempio, se un parametro denominato
<Parameter name="answer" value="42"/> Se utilizzi questo attributo, non utilizzare l'attributo |
Il parametro ottiene il suo valore dall'attributo ref o con un value esplicito.
Per un esempio e maggiori informazioni, vedi Come devono essere utilizzati i parametri facoltativi nella policy di trasformazione XSL?.
<ResourceURL>
Il file XSL utilizzato da Apigee per trasformare il messaggio. Il valore di questo elemento è il
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 saperne di più, consulta File di risorse.
<Source>
Specifica il messaggio trasformato. Di solito 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 da <ResourceURL>.
- Se la fonte non è presente, viene trattato come un semplice messaggio. Ad esempio,
<Source>message</Source> - Se la variabile di origine non può essere risolta o viene risolta in un tipo non di messaggio, il passaggio di trasformazione non va a buon fine.
Messaggi di errore
运行时错误
政策执行时可能会发生这些错误。
| 故障代码 | HTTP 状态 | 原因 | 修复 |
|---|---|---|---|
steps.xsl.XSLSourceMessageNotAvailable |
500 |
如果在 XSLTransform 政策的 <Source> 元素中指定的消息或字符串变量超出范围(在执行政策的特定流程中不可用)或无法解决(未定义),则会发生此错误。 |
build |
steps.xsl.XSLEvaluationFailed |
500 |
如果输入 XML 载荷不可用/格式不正确,或者 XSLTransform 政策失败/无法根据 XSL 文件提供的转换规则转换输入 XML 文件,就会出现此错误。很多不同的原因可能会导致 XSLTransform 政策失败。错误消息中的失败原因提供了有关原因的更多信息。 | build |
部署错误
在您部署包含此政策的代理时,可能会发生这些错误。
| 错误名称 | 原因 | 修复 |
|---|---|---|
XSLEmptyResourceUrl |
如果 XSLTransform 政策中的 <ResourceURL> 元素为空,则 API 代理的部署将会失败。 |
build |
XSLInvalidResourceType |
如果在 XSLTransform 政策的 <ResourceURL> 元素中指定的资源类型不是 xsl 类型,则该 API 代理的部署将会失败。 |
build |