Power Automate/Logic Appsでループが発生するときによく出てくる items('Apply_to_each') について新しい発見があったのでまとめます。
動的コンテンツで挿入するときには「現在のアイテム」として挿入されるものです。関数で書くとこれが items('ループ名') になります。
items()についての詳細はDocsに。
式関数のリァレンス ガイド - Azure Logic Apps | Microsoft Docs
一方で、配列に対するアクションでよく使う item() ですが、式関数ガイドによると
配列に対する繰り返しアクションの内部で使うと、アクションの現在の繰り返しの間に配列の現在の項目を返します。 その項目のプロパティから値を取得することもできます。
とあります。よく使うのはSelect, Filter, Create HTML tableあたりでしょうか。
この2つの関数、似ているようで使いどころが違うようで、かなり混乱のもとなんですよね。今回はその2つの違いを調べてみました。
結論から言うと 全部 item() でいいじゃん！ です。
item() は Apply to each でも使える
まずはこの事実が新たな発見でした。
item() は Apply to each の中でも使えるのです。 その際にはDocsに書いてある通り、ループの現在の項目を表します。
Apply to eachを2重にしてみると、そのスコープがもう少し明らかになる気がします。
Apply to each (親) のなかに Apply to each (子) を入れると、子のループのitem()では子ループの配列を参照しています。
ここで items('Apply_to_each') がなぜループ名を指定するのかが分かります。
子ループの中で親ループの「現在のアイテム」を参照したい場合、item()では参照できないんです。なので、items('Apply_to_each')で親ループの名前を指定して「現在のアイテム」を参照するんです。
単一のループ処理でも、もちろんループ名を指定すれば現在のアイテムを指定できます。
親ループでitem()を「作成」すればいい
これは John Liuに教えてもらいました。 全部item()だけでいけます。
イメージは下図のとおり。 子ループの中で親ループのアイテムを見たいときには、子ループの前に「作成」(Compose)アクションで親ループの「現在のアイテム」を作っておきます。
こうすると、子ループの中ではoutputs('作成')で親ループのアイテムが見えます。
この方法のいいところは、ループの実行結果で今どのループアイテムを参照しているのかが一目瞭然になるということです。
ということで、items('Apply_to_each')はあまり使わなくていいかもしれません。 （覚えることが一つ減った！）
