Convertire un oggetto in una matrice (anteprima)

2024-08-17

ID modello: convertobjecttoarray

Converte un oggetto JSON nel corpo della richiesta o della risposta in una matrice. Questo modello è disponibile in Power Apps e Power Automate.

Per iniziare, specifica il percorso dell'oggetto o della raccolta padre e il sottopercorso della proprietà all'interno dell'elemento padre in cui si trova la matrice. Quindi, specifica un nome di proprietà per la chiave di ciascun oggetto figlio e un nuovo nome di proprietà per le proprietà all'interno di ciascun oggetto figlio. Infine, specifica il percorso in cui verrà scritta la nuova proprietà dell'oggetto.

Alcuni aspetti da tenere a mente:

Puoi lasciare vuoto il percorso secondario se il padre è l'array che si desidera trasformare.
Per sovrascrivere la matrice esistente, il percorso è il percorso padre e il percorso secondario della proprietà specificati in precedenza.
Per mantenere la chiave dell'oggetto specificato come una proprietà all'interno del nuovo oggetto, imposta l'opzione "Mantieni chiave" su "true" (che è l'impostazione predefinita se lasciata vuota). Altrimenti, imposta l'opzione su "falso".

Esempi

Diamo un'occhiata ad alcuni esempi che utilizzano i seguenti parametri.

Esempio 1

JSON di input:

    {
        "peopleObject":{
            "XYZ":{
                "Age": "30"
            },
            "ABC":{
                "Age": "23"
            }
        }
    }

Parametro di input	Valore
propertyParentPath	@body()
propertySubPath	peopleObject
newPropertyPath	@body().peopleArray
keyName	Name
valueName	Details

JSON di output:

    {
        "peopleObject":{
            "XYZ":{
                "Age": "30"
            },
            "ABC":{
                "Age": "23"
            }
        },
        "peopleArray":[
            {
               "Name": "XYZ",
               "Details":{
                   "Age": "30"
               }
            },
            {
               "Name": "ABC",
               "Details":{
                   "Age": "23"
               }
            },
        ]
    }

Esempio 2

JSON di input

    {
        "sets":[
            {
                "people":{
                    "XYZ":{
                        "Age": "30"
                    },
                    "ABC":{
                        "Age": "23"
                    }
                }
            },
            {
                "people":{
                    "PQR":{
                        "Age": "32"
                    },
                    "MNO":{
                        "Age": "26"
                    }
                }
            },
        ]
    }

Parametro di input	Valore
propertyParentPath	@body().sets
propertySubPath	persone
newPropertyPath	@item().people
keyName	Name
valueName	Details

JSON di output:

    {
        "sets":[
            {
                "people":[
                    {
                        "Name": "XYZ",
                        "Details":{
                            "Age": "30"
                        }
                    },
                    {
                        "Name": "ABC",
                        "Details":{
                            "Age": "23"
                        }
                    },
                ]
            },
            {
                "people":[
                    {
                        "Name": "PQR",
                        "Details":{
                            "Age": "32"
                        }
                    },
                    {
                        "Name": "MNO",
                        "Details":{
                            "Age": "26"
                        }
                    },
                ]
            }
        ]
    }

Notare che poiché il genitore sets è una raccolta, la trasformazione viene applicata a ciascun percorso secondario people.

Esempio da connettori open source

Abbiamo un'istanza di questo modello in uso nel nostro repository dei connettori open source.

Connettore	Scenario
Planner	Trasforma un oggetto di riferimenti in una matrice di riferimenti nella risposta per l'azione Ottieni dettagli attività.

Parametri di input

Nome	Chiave	Richiesto	Digita	Descrizione
`Target object or collection path`	x-ms-apimTemplateParameter.propertyParentPath	Vero	Stringa	Percorso dell'oggetto o della raccolta.
`Property subpath`	x-ms-apimTemplateParameter.propertySubPath		Stringa	Sottopercorso della proprietà all'interno dell'oggetto o della raccolta.
`Path of the new property`	x-ms-apimTemplateParameter.newPropertyPath	Vero	Stringa	Percorso della nuova proprietà.
`Property name for the key`	x-ms-apimTemplateParameter.keyName		Stringa	Nome della proprietà per la chiave.
`Property name for the value`	x-ms-apimTemplateParameter.valueName		Stringa	Nome della proprietà per il valore.
`Run policy on`	x-ms-apimTemplate-policySection	Vero	Enum	Specifica quando eseguire questo criterio - Richiesta: il modello di criterio verrà eseguito prima che la richiesta venga inviata all'API back-end. - Risposta: il criterio verrà eseguito dopo aver ricevuto la risposta dall'API back-end.
`Operations`	x-ms-apimTemplate-operationName		Matrice	Elenco di azioni e trigger a cui verrà applicato il criterio. Se non viene selezionata alcuna operazione, questo criterio verrà applicato a tutte le operazioni.

Condividi tramite