テンプレート ID: stringtoarray
区切られた文字列を JSON オブジェクトの配列に変換し、各値は、対応する各オブジェクト内のユーザー指定のプロパティに割り当てられます。 このテンプレートは Power Apps と Power Automate で利用可能です。
まず、親オブジェクトまたはコレクションへのパスと、親内の区切り文字列のプロパティ サブパスを指定します。 次に、解析する区切り文字と、文字列が変換される各子オブジェクトのプロパティ名を指定します。 最後に、配列が書き込まれるパスを指定します。 既存の文字列を上書きするには、パスは以前に指定された親パスとプロパティ サブパスになります。
このテンプレートは、文字列の配列への変換をサポートしていません ("3:0"
→ ["3", "0"]
)。 オブジェクトの配列に変換するという代わりの選択は、コネクタで通常見られるシナリオに合わせて最適化するためにあります。 そのため、子プロパティ名の指定は必須です。
使用例
例 1
入力 JSON:
{
"peopleObject":{
"XYZ":{
"Age": "3;0"
},
"ABC":{
"Age": "23;45"
}
}
}
入力パラメーター | 値 |
propertyParentPath | @body() |
propertySubPath | peopleObject.XYZ.Age |
delimiterList | ; |
childPropertyName | AgeW |
newPropertyPath | @body.peopleObject.XYZ.Age |
出力 JSON:
{
"peopleObject":{
"XYZ":{
"Age":[
{
"AgeW": "3"
},
{
"AgeW": "0"
}
]
},
"ABC":{
"Age": "23;45"
}
}
}
オープンソース コネクタの例
このテンプレートの 1 つのインスタンスがオープン ソース コネクタ リポジトリで使用されます。
コネクタ | シナリオ | |
Planner | セミコロンで区切られた userId の文字列を配列に変換する |
パラメーターの入力
名前 | キー | 必要 | 型 | 内容 |
---|---|---|---|---|
Target object or collection path |
x-ms-apimTemplateParameter.propertyParentPath | 真 | 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 | 配列 | ポリシーが適用されるアクションとトリガーのリスト。 操作が選択されていない場合、このポリシーはすべての操作に適用されます。 |