Convertir une chaîne délimitée en tableau d’objets (aperçu)

ID du modèle : stringtoarray

Convertit une chaîne délimitée en un tableau d’objets JSON, chaque valeur étant affectée à la propriété spécifiée par l’utilisateur dans chaque objet correspondant. Ce modèle est disponible dans Power Apps et Power Automate.

Pour commencer, spécifiez le chemin d’accès à l’objet ou à la collection parent et le sous-chemin de propriété de la chaîne délimitée dans le parent. Ensuite, spécifiez les délimiteurs à analyser et le nom de propriété de chaque objet enfant dans lequel la chaîne sera convertie. Enfin, spécifiez le chemin d’accès dans lequel le tableau sera écrit. Pour remplacer la chaîne existante, le chemin d’accès serait le chemin d’accès parent et le sous-chemin de propriété précédemment spécifiés.

Ce modèle ne prend pas en charge la transformation en un tableau de chaînes ("3:0" → ["3", "0"]). Le choix de convertir en un tableau d’objets à la place a été fait pour optimiser les scénarios que nous voyons généralement dans les connecteurs. Par conséquent, la spécification du nom de la propriété enfant est une exigence.

Exemples

Exemple 1

JSON en entrée :

    {
        "peopleObject":{
            "XYZ":{
                "Age": "3;0"
            },
            "ABC":{
                "Age": "23;45"
            }
        }
    }

Paramètre d’entrée	Valeur
propertyParentPath	@body()
propertySubPath	peopleObject.XYZ.Age
delimiterList	;
childPropertyName	AgeW
newPropertyPath	@body.peopleObject.XYZ.Age

JSON en sortie :

    {
        "peopleObject":{
            "XYZ":{
                "Age":[
                    {
                        "AgeW": "3"
                    },
                    {
                        "AgeW": "0"
                    }
                ]
            },
            "ABC":{
                "Age": "23;45"
            }
        }
    }

Exemples de connecteurs open source

Nous avons un exemple de ce modèle utilisé dans notre référentiel de connecteurs open source.

Connecteur	Scénario
Planner	Convertir les chaînes des ID d’utilisateur (userId) séparées par un point-virgule en un tableau

Paramètres d’entrée

Nom	Touche	Obligatoire	Type	Description
Target object or collection path	x-ms-apimTemplateParameter.propertyParentPath	Vrai	String	Chemin d’accès à l’objet ou à la collection qui contient la propriété.
Property subpath	x-ms-apimTemplateParameter.propertySubPath		String	Sous-chemin de propriété dans l’objet ou la collection.
Delimiter list	x-ms-apimTemplateParameter.delimiterList	Vrai	String	Liste des délimiteurs.
Object child-property name	x-ms-apimTemplateParameter.childPropertyName	Vrai	String	Nom de la propriété dans chaque objet qui doit contenir la valeur de l’élément de tableau.
Path of the new property	x-ms-apimTemplateParameter.newPropertyPath	Vrai	String	Chemin de la nouvelle propriété.
Run policy on	x-ms-apimTemplate-policySection	Vrai	Enum	Spécifie quand exécuter cette stratégie - Demande : le modèle de stratégie s’exécutera avant l’envoi de la demande à l’API back-end. - Réponse : la stratégie s'exécutera après réception de la réponse de l'API back-end.
Operations	x-ms-apimTemplate-operationName		Tableau	Liste des actions et déclencheurs auxquels la politique s'appliquera. Si aucune opération n'est sélectionnée, cette stratégie s'appliquera à toutes les opérations.