Convert XML to JSON (Converti da XML a JSON)
SI APPLICA A: Tutti i livelli di Gestione API
Il criterio xml-to-json converte il corpo della richiesta o della risposta da XML a JSON. Il criterio può essere applicato per modernizzare le API basate su servizi Web back-end solo di tipo XML.
Nota
Impostare gli elementi e gli elementi figlio del criterio nell'ordine specificato nell'istruzione del criterio. Altre informazioni su come impostare o modificare i criteri di API Management.
Istruzione del criterio
<xml-to-json kind="javascript-friendly | direct" apply="always | content-type-xml" consider-accept-header="true | false" always-array-child-elements="true | false"/>
Attributi
| Attributo | Descrizione | Richiesto | Valore predefinito |
|---|---|---|---|
| kind | Questo attributo deve essere impostato su uno dei valori seguenti. - javascript-friendly: il JSON convertito ha un formato intuitivo per gli sviluppatori JavaScript.- direct: il JSON convertito riflette la struttura del documento XML originario.Le espressioni di criteri sono consentite. |
Sì | N/D |
| apply | Questo attributo deve essere impostato su uno dei valori seguenti. - always - converti sempre.- content-type-xml: applica la conversione solo se l'intestazione Content-Type della risposta indica la presenza di XML.Le espressioni di criteri sono consentite. |
Sì | N/D |
| consider-accept-header | Questo attributo deve essere impostato su uno dei valori seguenti. - true: applica la conversione se JSON è richiesto nell'intestazione Accept della richiesta.- false: applica sempre la conversione.Le espressioni di criteri sono consentite. |
No | true |
| always-array-child-elements | Questo attributo deve essere impostato su uno dei valori seguenti. - true - Convertire sempre gli elementi figlio in una matrice JSON.- false - Converte solo più elementi figlio in una matrice JSON. Convertire un singolo elemento figlio in un oggetto JSON.Le espressioni di criteri sono consentite. |
No | false |
Utilizzo
- Sezioni del criterio: inbound, outbound, on-error
- Ambiti del criterio: globale, area di lavoro, prodotto, API, operazione
- Gateway: classico, v2, consumo, self-hosted, area di lavoro
Esempio
<policies>
<inbound>
<base />
</inbound>
<outbound>
<base />
<xml-to-json kind="direct" apply="always" consider-accept-header="false" />
</outbound>
</policies>
Criteri correlati
Contenuto correlato
Per ulteriori informazioni sull'utilizzo dei criteri, vedere:
- Esercitazione: trasformare e proteggere l'API
- Informazioni di riferimento sui criteri per un elenco completo delle istruzioni dei criteri e delle relative impostazioni
- Espressioni di criteri
- Impostare o modificare criteri
- Riutilizzare le configurazioni dei criteri
- Repository dei frammenti di criteri
- Creare criteri usando Microsoft Copilot in Azure