通过

将分隔的字符串转换为对象数组（预览）

模板 ID：stringtoarray

将分隔的字符串转换为 JSON 对象数组，其中的每个值都分配给每个相应对象中用户指定的属性。 此模板在 Power Apps 和 Power Automate 中可用。

若要开始，请在父级内指定父对象或集合的路径以及分隔的字符串的属性子路径。 接下来，指定要分析的分隔符以及字符串要转换为的每个子对象的属性名称。 最后，指定数组将写入的路径。 为覆盖现有字符串，路径将是先前指定的父路径和属性子路径。

此模板不支持转换为字符串数组 ("3:0" → ["3", "0"])。 选择转换为对象数组是为了针对我们通常在连接器中看到的场景进行优化。 因此，需要指定子属性名称。

示例

示例 1

输入 JSON：

    {
        "peopleObject":{
            "XYZ":{
                "Age": "3;0"
            },
            "ABC":{
                "Age": "23;45"
            }
        }
    }
输入参数值
propertyParentPath@body()
propertySubPathpeopleObject.XYZ.Age
delimiterList;
childPropertyNameAgeW
newPropertyPath@body.peopleObject.XYZ.Age

输出 JSON：

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

开放源代码的连接器的示例

我们有一个将在开放源代码的连接器存储库中使用的此模板的实例。

连接器方案
Planner将以分号分隔的 userId 字符串转换为数组

输入参数

名称 键 需要 Type 描述
Target object or collection path x-ms-apimTemplateParameter.propertyParentPath TRUE String 包含属性的对象或集合的路径。
Property subpath x-ms-apimTemplateParameter.propertySubPath String 对象或集合中的属性子路径。
Delimiter list x-ms-apimTemplateParameter.delimiterList 真 String 分隔符列表。
Object child-property name x-ms-apimTemplateParameter.childPropertyName 真 String 应包含数组项值的每个对象中的属性的名称。
Path of the new property x-ms-apimTemplateParameter.newPropertyPath 真 String 新属性的路径。
Run policy on x-ms-apimTemplate-policySection 真 枚举 指定运行此策略的时间
- 请求：策略模板将在请求发送到后端 API 之前运行。
- 响应：策略将在收到后端 API 的响应后运行。
Operations x-ms-apimTemplate-operationName 数组 将对其应用策略的操作和触发器的列表。 如果未选择任何操作，该策略将应用于所有操作。