Effettuare le operazioni riportate di seguito per configurare la politica da XML a JSON per DataPower® API Gateway nell'interfaccia utente dell'assembly.
Informazioni su questa attività
Nota: questo argomento descrive l'implementazione della politica
da XML a JSON in
DataPower API Gateway. Se si utilizza, consultare
DataPower Gateway (v5 compatible) la sezione "Configurazione della politica 'Set Variable' per l' DataPower Gateway " (compatibile con v5 ). Per ulteriori informazioni sui diversi tipi di gateway, vedi
Tipi di gateway diAPI Connect.
In questa sezione viene descritto come configurare il criterio nell'interfaccia utente di Assembly; per ulteriori dettagli su come configurare il criterio nel codice sorgente di OpenAPI, consultare xml-to-json.
Procedura
- Nel riquadro di navigazione, fare clic su
"Sviluppo ", quindi selezionare la scheda "API".Viene aperta la pagina Sviluppa .
- Fare clic sul titolo dell'API che si desidera utilizzare o creare una nuova API.
- Selezionare la scheda Gateway , quindi fare clic su Politiche nel riquadro di navigazione.
- Trova la politica XML a JSON nella tavolozza e trascina la politica nell'area.
- Specificare le seguenti proprietà.
Tabella 1. Proprietà delle politiche da XML a JSON
| Etichetta proprietà |
Obbligatorio |
Descrizione |
Tipo di dati |
| Titolo |
Vero |
Il titolo della politica. Il valore predefinito è xml-to-json. |
stringa |
| Descrizione |
N |
Una descrizione della politica. |
stringa |
| Immissione |
N |
Il messaggio di input da convertire. Specificare il nome di una variabile nel contesto API. variableName.body, il payload del messaggio, rappresenta l'input XML da convertire. Il valore predefinito della variabile è message e message.body è l'immissione predefinita. |
stringa |
| Output |
N |
Il messaggio di output per memorizzare il risultato della conversione. Specificare il nome di una variabile nel contesto API. variableName.body rappresenta il risultato della conversione da formato XML a formato JSON. Quando il messaggio di input è il messaggio predefinito, l'output predefinito è message.body. In caso contrario, quando il messaggio di input è la variabile my-message-variable, ad esempio, l'output predefinito è my-message-variable.body.La variabile non può essere di sola lettura nel contesto API. |
stringa |
| Tipo di conversione |
N |
Il tipo di conversione che determina il formato di destinazione dell'emissione. Sono disponibili le seguenti opzioni:
- badgerFish: la convenzione BadgerFish viene usata per determinare il formato di conversione dell'output.
- apicv5: la convenzione apicv5 viene utilizzata per stabilire il formato di conversione di destinazione dell'output.
|
stringa |
- Specificare una versione per la policy facendo clic sull'icona "Source " e compilando la
version
sezione del file YAML della policy. Ad esempio:execute:
- xml-to-json:
version: 2.0.0
title: xml-to-json
...
È possibile specificare una versione per la politica compatibile con il gateway che si sta utilizzando. Quando l'API viene pubblicata, se la versione è incompatibile con il gateway, viene generato un errore di convalida che specifica le versioni disponibili.
- Fare clic su Salva.
Esempio
Ad esempio, il seguente oggetto XML semplice
<a>hello</a>
diventa
{ "a": { "$" : "hello" } }
Il seguente oggetto XML con un attributo
<a type="world">hello</a>
diventa
{ "a": { "$" : "hello", "@type" : "world" } }
Per ulteriori esempi, consultare xml-to-json.