概要
Power Automate Desktop(以下PAD) の変数についての記事5回目「リスト型」です。PADのベース言語Robinのドキュメントを参考に試したものをまとめました。「変数の設定」アクションを中心に簡略化した例を挙げながら整理してみようと思います。コードはPADにコピペで試せます。
目次
注意
- すでに使いこなしているかた向けの記事ではありません。
- Robin言語はあくまでベースであるためPADと異なる部分があります。
- この記事の内容はすべて試していますが公式の見解とは異なる可能性がありますのでご注意ください。
- Power Automateクラウドフローの入出力変数については触れていません。
- 2021年2月の記事です。
- あくまでも個人のまとめです。
- 誤りがありましたらコメントでご指摘いただけると幸いです。
- Robinの公式サイトは2021年4月30日に終了しました。
リスト型変数について
リスト型変数は複数の値が1方向の集合になった「リスト」を持ちます。リストは配列とも呼ばれます。値が同じ型で構成されているリストの場合、リストの型は値のタイプと同じになります。タイプの違う値でリストが構成されるときは一般の値リストとなります。
- リスト型は0ベースのインデックス番号を持っています。
- プロパティにリスト項目のカウントもっています。
リストを作成する
リストを新規に作成するにはいくつかの方法があります。
- 「変数の設定」アクションからリストを作成
角括弧[]のなかにカンマ区切りで値を書き、%で囲います。
項目がテキストの場合は'シングルクォーテションで囲います。
リストに変数を使用する場合はシングルクォーテションを使いません。
- 変数アクション「新しいリストの作成」→「項目をリストに追加」からリストを作成
組み合わせてリストに項目を追加し作成します。
- 「データテーブ列をリストに取得」アクションでリストを作成
列名（例だとname）またはインデックス番号（例だと1）指定で一度にリストが作成できます。
-
「乱数の生成」アクション
リストの値を指定する
インデックス番号で値を指定
リストのスライス
リストをスライスして新たなリストを作成できます。
[start:stop]でインデックスを指定します。
値の間の線で考えるとわかりやすいかもしれません。
リストに項目を追加する
変数の設定で項目を追加（後方）
数値
テキスト値
「項目をリストに追加」アクションでも同じように値を追加できます。
変数の設定で項目を追加（前方）
変数の設定で項目を追加 リストのネスト（入れ子）
ネストされたリストのスライス
####「リストの統合」アクション
2つのリストを1つにマージします。変数の設定アクションからではできません。
リストに項目をインサート
スライスとリスト統合アクションを使ってリストの任意の場所に項目を追加します。
リストに追加アクションは最後尾にしか追加できないため、挿入するためにはいくつか手順を踏みます。
-
追加したい値と場所（インデックス）のペアを用意します。
-
値と場所をそれぞれ変数に代入しておきます。最初から変数に値を書いても可能です。
-
値を挿入したい位置でリストをスライスして、そこに値を追加します。
%List1[:InsertPosition] + Insertvalue%
-
スライスしたリストの後方部分を統合すれば完了です。
-
わかりやすくするために順を追って書きましたが、つまりはリストの統合アクションだけでも値の挿入が可能です。
リストから項目を削除
「リストから項目を削除アクション」を使用します。変数の設定アクションからではできません。
インデックス番号か値を指定できます。
###「リストの内容を減らす」アクションについて
2つのリストの差分をつくれるはずなのですが、2021年2月時点ではWinautomationと異なる挙動をするため注意が必要です。
1番目のリストに重複が含まれている場合、このアクションで差分リストをつくると重複項目が一意化されます。
例 [1,2,3,4,5,5]と[1,2,3]でこのアクションを使用した場合、期待する値は[4,5,5]ですが返される値は[4,5]となります。Winautomationでは同様のアクションを使用した場合[4,5,5]が返されます。
2021-08-14追記
久しぶりに再確認したところ期待した動作になっていました。
次の例では空白やスペースのみをリストから取り除いています。
SET A TO [1, ' ', 1, 2, 2, 3, 4, 5, '', ' ', 0]
SET B TO ['', ' ']
Variables.SubtractLists FirstList: A SecondList: B OutputList=> ListDifference
リスト項目の検索
検索する値がリスト内の項目に含まれているかをTrue、Falseで返します。
検索する値がリスト内の項目に含まれていないかをTrue、Falseで返します。
リスト項目の置換
リスト内項目の置換は2021年2月時点では公式ドキュメントやRobin言語のドキュメントでも触れられていない内容ですのでご注意ください。
変数の設定アクションから変数名にリスト名とインデックスを記述することでリスト項目の置換が可能です。ただし設定したアクションをもう一度開いて保存し直すと通常の変数名に戻るので注意が必要です。
変数名に記述するインデックスを変数にしても可能
SampleListを作成し2をAに置換えてみます。
ループ内の変数の設定アクション 置換はこのように書いています。
今回のコード
SET List1 TO [1, 2, 3, 4, 5]
SET List2 TO ['a', 'b', 'c', 'd']
SET Var1 TO 5
SET List3 TO [1, 2, Var1, 4, 5]
SET ListCount TO List1.Count
Variables.CreateNewList List=> List4
LOOP LoopIndex FROM 1 TO 5 STEP 1
Variables.AddItemToList Item: LoopIndex * 2 List: List4 NewList=> List4
END
Variables.GenerateRandomNumber.ListOfRandomNumbers MinimumValue: 0 MaximumValue: 100 NumbersCount: 10 AllowDuplicates: False RandomNumbers=> RandomNumbers
SET ListVar TO List1[3]
SET ListSlice TO List1[1:3]
SET ListAddNum TO List1 + 1 + 2
SET ListAddText TO List1 + 'a' + 'b'
SET ListAddF TO '前方追加' + List1
SET NestedList TO List1 + List2
SET NestedSlice TO NestedList[5][1:3]
Variables.MergeLists FirstList: list1 SecondList: List4 OutputList=> OutputList
# Start'Insert to list'
SET Insert TO [999, 2]
SET Insertvalue TO Insert[0]
SET InsertPosition TO Insert[1]
SET sublist TO List1[:InsertPosition] + Insertvalue
Variables.MergeLists FirstList: sublist SecondList: List1[InsertPosition:] OutputList=> List
Variables.MergeLists FirstList: List1[:3] + 777777 SecondList: List1[3:] OutputList=> OutputList2
# End 'Insert to list '
Variables.RemoveItemFromList.RemoveItemFromListByValue Item: 2 ItemMatchAllOccurrences: True List: OutputList NewList=> OutputList
Variables.SubtractLists FirstList: OutputList SecondList: [1, 3, 10] OutputList=> ListDifference
SET SearchList1 TO 8 IN List1
SET SearchList2 TO 0 NOT IN List1
SET List1[1] TO 999
SET SampleList TO [1, 2, 3, 1, 5, 6, 4, 3, 1, 2, 6, 9, 5, 6, 2, 1, 2, 3, 8, 4, 2, 5]
SET SearchNum TO 2
SET ReplaceValue TO $'''A'''
LOOP LoopIndex2 FROM 0 TO SampleList.Count - 1 STEP 1
IF SampleList[LoopIndex2] = SearchNum THEN
SET SampleList[LoopIndex2] TO ReplaceValue
END
END
今回のまとめ
%[]%と記述することでリストを変数の設定から作成可能です。
リスト型のインデックスは0ベースです。
リスト型の応用範囲はとても広く強力なので、PADで可能なことをしっかり理解したほうがよいとあらためて認識しました。
リスト内項目の置換が可能とわかったのは収穫でした。
また変数名のインデックスに変数を使用して動的にリストを変更できます。