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-children="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-children	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

• Trasformazione

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