DataPower API Gateway solo

Configurazione della politica da XML a JSON per DataPower API Gateway

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

  1. Nel riquadro di navigazione, fare clic su Icona di sviluppo nel quadro di navigazione "Sviluppo ", quindi selezionare la scheda "API".
    Viene aperta la pagina Sviluppa .
  2. Fare clic sul titolo dell'API che si desidera utilizzare o creare una nuova API.
  3. Selezionare la scheda Gateway , quindi fare clic su Politiche nel riquadro di navigazione.
    Per ulteriori informazioni sull'utilizzo dell'editor di assembly per un'API, consultare la sezione "L'editor di assembly".
  4. Trova la politica XML a JSON nella tavolozza e trascina la politica nell'area.
  5. 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
  6. Specificare una versione per la policy facendo clic sull'icona "Source " e compilando la versionIcona origine OpenAPI 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.
  7. 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.