変数シリーズ【第６回】入出力変数です。
フロー間で値の受け渡しができる、入力変数・出力変数を学びましょう。

変数シリーズ【第１～５回】の内容を踏まえて紹介しています。未読の方は、ぜひ第１回からご覧ください。

• 変数 第１回 使ってみよう！
• 変数 第２回 データテーブル
• 変数 第３回 プロパティ
• 変数 第４回 リスト
• 変数 第５回 自分で作る変数活用例

入出力変数とは？

入出力変数とは、クラウドフローや他のデスクトップフローと連携するときに、値の受け渡しをする変数のことです。呼び出す側のフローを親、呼び出される側を子と呼んだりします。子フローに入出力変数を作成することで、値の受け渡しができます。

変数ペインの上部にあり、「何なのかな？」と思っていた方もおられるのでは。
ここに表示されるのが入出力変数です。ここで入力変数と出力変数を作成します。

入出力変数を作ってみよう

加算する日数の数値を入れる入力変数 AddDays と、成形した日付を入れる出力変数 FormattedDate を作りましょう。設定内容は、下図を参照してください。
＋マーク > 入力 もしくは 出力 を選択し、各項目の設定を入力します。ひとつ作成した後、＋マークは入出力変数欄の右上に表示されます。

入力変数 AddDays 、出力変数 FormattedDate ができたでしょうか。
よく見ると入力変数はグレーで、出力変数は白く枠線がくっきりしていて、見分けできるようになっています。が、変数名をダブルクリックして設定画面を開けば「入力 / 出力変数を編集する」と上部に書いてありますので覚えなくても大丈夫です。

入出力変数が作成できたので、今回のシナリオに必要なアクションを３つ追加します。ひとつめは、現在の日時を取得 アクションです。
ふたつめは、加算する日時 アクションです。加算に、入力変数 AddDays を選択します。

みっつめは、datetimeをテキストに変換 アクションです。加算する日時でできたResultedDateを元に、カスタム形式 yyyy-MM-dd とします。
そして生成された変数を{x}ボタンを押して、出力変数 FormattedDate に変更します。

作成されるフロー変数がCurrentDateTime と ResultedDate の2つのみでしたら、上手く出力変数に値が入るように設定できました。

※今回は入出力変数をどちらもひとつずつ使っていますが、もちろん片方ずつでも複数個でも使用できます

入出力変数を持つフローを単独で実行してみる

デザイナー画面でのテスト実行では外部から値を受け取らないため、入力変数は既定値を使用して実行します。
AddDaysは既定値 0 としたため、今日日付 + 0日 のyyyy-MM-dd 形式の日付がFormattedDateに入ります。AddDaysを変えてテストするには既定値を変更してください。

コンソール画面から実行した場合は、入力用のポップアップに既定値が表示されるので、値を設定・変更できます。
また、実行後には出力変数もポップアップで表示されるため値を確認することができます。
※表示されるAdd Days と Formatted Date は変数名ではなく、外部名になります。

入出力変数を持つフローを単独で実行するとポップアップが表示されますが、親フローから呼び出す場合は表示されません。
また、単独実行時に表示されるこのポップアップを活用して、メッセージボックスの代わりに、べた書きしたくないパスワードや、都度変わる値を処理に使用できます。

他のデスクトップフローと値を受け渡ししてみる

新たに別のフローを作成し、Desktopフローを実行 アクションを配置し、先ほど作成したフローを選択します。
すると、入力変数に Add Days（外部名として設定した値）が表示されます。入力欄の左側に型がアイコンで、iマークで設定した説明が表示され、どんな値を入力すればよいか分かるようになっていますね。
また、生成された変数には出力変数で設定した変数名＋末尾に2などが付きます（変数名が重複しないように+1されるようです）。そして説明も表示されています。

Add Daysには、変数でもべた書きの固定値でもどちらでも設定可能です。10など、なんらかの数値を設定しましょう。
生成された変数（上図の例ではFormattedDate2）はここでは単なるフロー変数となり、通常通り必要に応じて変数名は変更可能です。出力変数の変数名と同じにする必要はありません。

呼び出し側のフローをデザイナー画面で実行すると、返ってきた値が変数ペインで確認できます。

他のデスクトップフローと連携していても、上記の単独で実行する方法は使えます。

使いどころは？【部品化】

クラウドフローと連携する場合は、デスクトップフローだからできる処理を行うため、棲み分けがわかりやすいですね。
処理結果や、特定の値をやりとりするために入出力変数が活躍します。

ではデスクトップフロー同士の場合は、どういう場合に変数の値を受け渡してまでフローを分けるのでしょうか？

今回作成した例のように、いくつかの値を受け渡すだけで使える部品としてのフローを作る場合が考えられます。
例えば、エラーや処理結果の通知メール。フロー名やエラー内容を渡せば、複数のフローから呼び出せる汎用的な作りにできます。

フローを運用してみて必要を感じたら、別フローに分けて値を渡せることを思い出してください。
同じような処理を行うことも多いですし、使いまわせれば作るのもテスト作業も時短になります。

使用上の注意点

入出力変数をテキストとしてコピーする方法がありません。
画面真ん中のスペースにあるアクション群をコピーしてメモ帳などに貼り付けて保存・共有し、新たなフローに貼り付けても、入出力変数は作成されません。貼り付けた先のフロー側で改めて作成が必要です。
これがフロー変数との違いで、配置したアクションで入出力変数を使用していても、あくまでこれらの変数は独立した存在です。

このため、無償ライセンス内でフローを共有したい場合、入出力変数が大量にあると作成・移行・管理をする上では手間がかかると思われます。
事前によく検討した上でご利用ください。

フロー変数と同名の入出力変数を作成すると、マージするかの確認メッセージが表示されます。続行するとフロー変数は消え、入出力変数にマージすることができます。

入力変数の場合、子フローの始まりの時点で値を受け取ることになります。その後同じ変数名で値をセットすると上書きされますので、それでも本当に大丈夫なのかなど、マージする前に該当変数に関する処理をよく確認した上でマージを行ってください。

入出力変数を活用してフローを共有部品にできると、フロー作りも効率化できます。
どんなフローを作っているかを社内で共有して、使えるものは共通化して使いまわせるといいですね。

変数の基礎はこれで一通りご紹介しました。
ここまで変数シリーズを読んでくださった方は、だいぶ変数について慣れてきたのではないでしょうか。どんどん使って試して使いこなしていきましょう。

変数シリーズ【第５回】自分で作る変数活用例 です。
変数の設定 アクションを使って、自由に変数を作ることができます。このシリーズでもサンプル値を入れたりと既に使ってきましたが、他にどんな活用方法があるか見てみましょう。

変数シリーズ【第１～４回】の内容を踏まえて紹介しています。未読の方は、ぜひ第１回からご覧ください。

• 変数 第１回 使ってみよう！
• 変数 第２回 データテーブル
• 変数 第３回 プロパティ
• 変数 第４回 リスト

値の確認

変数の設定 アクションを使う場面のひとつめは、値の確認です。【第３回】プロパティで、使う前にどんな値が入るか確認しようということで使ってみましたね。
プロパティや、データテーブルのひとつのセルを指す %ExcelData[0][‘氏名’]% など、値と型を変数ペインで確認することができます。
わかっているつもりで記入しても間違うことはよくあります。思っていた結果にならない時は、変数の値と型を疑ってみるのもひとつの方法です。

従業員マスタに住所欄を設けたエクセルから範囲を読み取り ExcelData とし、0行目の住所列の値をプロパティ.Trimmedを使って変数に入れてみましょう。

トリムされているかどうか確認するために、元の値とトリム後の値の長さ.Lengthを使った変数も作成してチェックしてみましょう。
トリム後の長さは、 値： %住所.Length% プロパティは%の内側に！
長さが18→17に変わり文字列の前後にあった不要なスペースが除去されたことが確認できました。

想定した値が変数に設定できたかどうか確認できたら、確認のためだけの変数は無効にするか削除するかしておきましょう。
残しておいても害はないのですが、不要な処理を行わず、変数の一覧に不要な変数がない方がすっきりして見やすいと思います。

ちなみに変数ペインで値を確認するときに、変数の数が多く見たい変数を探すのが大変なときはピン留めを使うと便利です。上図のように注目したい変数を一覧の上部にで固定できます。

べた書きはひとつに

固定値やファイルパスなどべた書きが必要な場面はありますが、同じ内容を複数回書く必要が出てきたら変数に入れてみてください。後々値を変える必要が出たときに、変更が楽になります。

さきほどトリムした住所と元の値の長さを設定したアクションを見てみると、ExcelData[0][‘住所’] ← この部分が同じです。
この同じ部分を変数名：住所 値：%ExcelData[0][‘住所’]% としましょう。そしてこの値が入っていたところを変数に置き換えます。
住所変数はその後.Trimmedを付けた値で上書きしています。このように同じ変数で値を上書きすることで必要以上に変数を持たずに済みます。

同じことをするアクションも同様です。
条件によって書き込む値は変えるけれど書き込むセルは同じ場合、それぞれ書き込むアクションを置くかと思います。

書き込む先の行・列は同じなので書き込むアクションをひとつにすることもできます。書き込む値を変数名：GroupCode 値：条件ごとに設定（’A’か’B’）として作り、書き込むアクションの値に変数をセットすればよいですね。
条件によって違うのはGroupCodeだけというのが見た目にも分かりやすくなったのではないでしょうか。

必ずひとつにすべき、というわけではありません。見たときに分かりやすく変更しやすくなっていると、修正するときや他の人へ引き継ぐときに楽になりますので、考慮してみてください。

設定関連情報を入れる

固定値やファイルパス、フォルダパス、メールアドレスなどの設定に関する情報は、複数個所で使わないとしても変数に入れておくと良いかもしれません。

そして設定情報はフローの冒頭にまとめておく、もしくは設定が多い場合はサブフローにまとめ冒頭で呼び出すのが個人的にはおススメです。
冒頭一カ所にまとまっていることで見つけやすく、管理しやすくなります。他の人にフローを渡し、各個人の設定に変更してもらうときも分かりやすいでしょう。

変化する数値 カウンターを作る

エクセルへ転記するときなど、書き込む先の行や列番号をずらしていくことも変数を使うと可能です。

1. ループに入る前に、変数を作る。変数名：行番号 値： 2 ※この値は書き込みをスタートする行番号にします。
2. ループの中で、Excelワークシートに書き込む アクションなどで、行番号変数を使う。
3. 変数を大きくする アクションを使って、行番号変数の数値を1ずつ大きくする。
4. ループの次の周では行番号が1大きくなり、書き込む先がずれる。

他の使い方として、ある条件に当てはまるときだけカウントアップし件数を数えることもできますね。この場合は初期値0からスタートしましょう。
処理結果のメールに該当データの件数を記載するなどに使えそうです。

%”%（空文字）の活用

変数そのものを作るわけではないのですが、%で囲んで計算できるのと同じように、シングルクォーテーション2つを%で囲んで作る空文字 %”% も覚えておきましょう。
空文字とは何も値が入っていない状態で、長さ0の文字列を表します。

テキストを置換する アクション（データテーブル内で検索または置換する アクションなどでも同様）で文字列の中から不要な文字を除去するときに使います。

文字列内のスペースを削除する場合、検索するテキストに半角スペース%’ ‘%や全角スペース%’　’%を%で囲み入力します。%で囲まないスペースを入力するとエラーになります。
そして置き換え先のテキストに%”%を入力します。これで文字列内に含まれる半角・全角スペースを除去（置換）することができます。

一度変数に入った値は%”%をセットしてクリア（上書き）します。
たとえば、ループ内で条件に合う場合のみ変数に値をセットし、その値をメッセージ表示するとします。1周目で値が入り、2周目で条件に合わない場合値はセットしません。つまり変数の内容は変わらず、1周目でセットした値をメッセージで表示してしまいます。

このままではその行ごとの値が正しく表示されませんので、条件を判定する前にクリアしておくか、条件にElseを追加しクリアするようにしましょう。

空の他に、実は空白というものもあります。エクセルで空欄を単一セルで読み取ると空ですが、空欄を含む範囲で読み取り空欄のセルの値を確認すると<空白>になります。

基本的には同じようなものと思って大丈夫です。If アクションの演算子で『空である』を使えばどちらだとしても判定できます。

値の入っていない行を削除したい場合には注意が必要です。リスト変数から行を削除したいとき、リストから項目を削除 アクションを使います。
空の場合：ループ不要で 値：%”%を指定してすべて削除できます。
空白の場合：リストから空白を削除するには下記の方法で削除してください。空の場合でも有効です。

1. リストをループする。
2. If アクションで『空である』かを判定する。
3. 空と判定されたときのインデックス（行番号）を指定してリスト項目を削除する。

データテーブルの場合は、データテーブルから空の行を削除するという新しいアクションが追加されました！空白の場合でも簡単に削除できます。

条件分岐を整理する

%で囲むと値の比較をすることもできます。
予め値を設定する変数を作ります。変数名：BoxType 値：S
そして比較する変数を作ります。IsTypeS 値：%BoxType = ‘S’% 結果はTrueとなります。

「BoxType変数の値が’S’である」の正誤の結果を返す、という意味になります。結果はブール値型 True / False で返り変数ペインで確認できます。
つまりIfアクションと同じように比較判定することができるのです。

数値型の比較も作ってみましょう。Weight 値：500、IsWeightOver500 値：%Weight > 500%
演算子が >（大なり）の場合は500を含みませんので、結果はFalseということになります。

さきほど紹介した空白かどうかも　Weight変数で調べてみましょう。IsWeightBlank 値：%IsBlank(Weight)%
Weightの値が500のままなら、結果はFalseで返るでしょう。

比較演算子（=, <>, >, >=, <, <=）の他にも、%IsBlank()%や%StartsWith()%などのIfアクションで選択できる演算子が使えます。
その他の使用できる演算子は 公式ページへ

複数の比較を書くこともでき、AND（かつ）、OR（または）、NOT（でない）などを使います。
IsCheckTypeS 値：%BoxType = ‘S’ AND Weight < 500% → どちらもTrueなら結果はTrue
IsCheckType 値：%BoxType = ‘S’ OR BoxType = ‘M’% → どちらかがTrueなら結果はTrue
IsNotCheckType 値：%NOT(BoxType = ‘S’ OR BoxType = ‘M’)% →（）内の結果がTrueなら結果はFalse、例の場合だと’S’か’M’以外ならTrue

変数を使って比較するのは少し複雑になりますので、Ifアクションの代わりに変数の設定アクションを使って一部ずつ正しく結果が出るかテストしてみるのに有効です。

また、次のような長く複雑な条件をIfアクションに設定する場合、パーツごとに分割して変数化しておくと見やすく分かりやすくなります。この方法もおススメです。

実際に自分でフローを作ってみると自分で作る変数の必要性を感じる場面が出てくると思います。今回の活用例を参考にぜひ使ってみてください。

変数を作ってあるけれど、この変数どこで使っていたかな？？というときは、フロー変数の使用状況の検索を使ってチェックできます。

変数シリーズまだ続きます！

変数シリーズ【第４回】リストです。
リストとはデータ型のひとつで、プロパティやアクションで生成される変数としてよく登場します。実際に使ってみましょう。

変数シリーズ【第１～３回】の内容を踏まえて紹介しています。未読の方は、ぜひ第１回からご覧ください。

• 変数 第１回 使ってみよう！
• 変数 第２回 データテーブル
• 変数 第３回 プロパティ

2024年3月のアップデートで「変数の選択」が変わりました

• {x｝マークは項目にカーソルを合わせると表示されます。
• 選択候補の変数に型の表示がなくなり、カーソルを変数名に合わせるとツールチップで表示されます。
• 並べ替えやフィルターも使えるようになりました。

リストを作ってみる

手始めに、変数の設定 アクションを使い、変数名と値を入力して数値とテキスト型のリストを作ってみましょう。
ListNumber 値：%[0, 1, 2, 3, 4, 5]%
ListText 値：%[‘赤’, ‘緑’, ‘黄’]%
値全体は%で囲み、前後は半角の角カッコ（[ と]）、値の間はカンマ区切りにします。数字はそのまま、テキストはシングルクォーテーションで値を囲みます。

フローを実行し変数ペインで変数の値を確認してみましょう。どちらも縦一列のみのリスト、今回の型はリスト数値・リストテキスト値となります。
型名は「リスト数値」のように、「リスト」の後ろに中の値の型がつづく形式になっています。

リストは主にアクションで生成し、数値やテキスト以外にファイルやメールメッセージなどいろいろなものをリストにすることができます。
たとえば、フローの途中で人の判断を挟みたいとき、リスト選択ダイアログから選択させるという使い方もできます。

リスト型の見方・使い方

リストは列は一列のみ、複数行を持つことができる型です。
この複数値の中からひとつだけ値を取り出すには、このように表します。
%変数名[行]%
ListNumberのうち3つ目の値を取得するには、%ListNumber[2]% となります。
一列だけなので列名は不要で、行番号だけを指定します。行番号は0から始まるのを覚えておきましょう。

リストのプロパティは保持している行数 .Countがあるのみ。%ListText[0].Length% のように行を指定すれば変数内の各値の型に従ったプロパティが使用できます。
リストには変数グループの中にさまざまなアクションが用意されており、データテーブルよりも小回りが利くイメージです。

リストから特定の値を取得

リストを使う例でよくあるのは、テキストの分割 アクションを使うような場合でしょうか。読み取った文字列の中から一部だけ取り出したいときなどに使います。
変数の設定アクションで文字列を用意し、スペースで分割されたリストができるようアクションを設定してみましょう。
サンプル住所 値：住所：愛知県 春日井市 弥生町 43902 ※架空の住所です
この形式の住所の中から市区町村名だけ取り出したい場合、毎回1行目になる部分だと分かるので%TextList_住所[1]%と行番号を固定で書けばよいですね。

英語表記の月名取得

今度は英語表記の月名リストを作ってみましょう。
※datetimeをテキストに変換 アクション（第1回で日付をファイル名に使う方法として使用しました）では、英語表記の月名は取得できません。これは日本語設定でPADを使っているためです。

今回は省略形の英語表記にしてみます。変数の設定アクションで下記のように値をセットしリストを作成。
MonthList 値：%[‘-‘, ‘jan’, ‘feb’, ‘mar’, ‘apr’, ‘may’, ‘jun’, ‘jul’, ‘aug’, ‘sep’, ‘oct’, ‘nov’, ‘dec’]%

次に、現在の日時を取得 アクションでCurrentDateTimeを生成します。
CurrentDateTimeのプロパティ.Monthで月の値を数値で取得し、この値をリストの行番号として使う（%MonthList[CurrentDateTime.Month]%）と、3月なら4番目のmarが取れます。月は1~12ですから、0番目に使わない値を入れておくことで月と行番号を揃えて使っています。

新しく変数の設定アクションで、英語表記の月名と日付をつなげた文字列を作ってみます。
MonthDayName 値：%MonthList[CurrentDateTime.Month] + CurrentDateTime.Day%
%%の内側で+を使うと、テキスト値の場合は文字列をつなげます。すると、3/8の場合、mar8という文字列ができます！

エクセルやファイル名などに月の英語表記を入れたい時に使えます。このように少ない個数で、値が変わらないものであれば、作るのも簡単なので使いやすいでしょう。
リストの順番が分かっていればこのようにピンポイントで値を取り出し使うことができます。

データテーブルからリストを作る

固定値のリストをべた書きするよりも、マスタのようなものであれば、やはりエクセルから読み取った方が作成も変更もしやすいでしょう。
エクセルから範囲指定で読み取りExcelDataへ保存、そのうちの1列をリスト化するため、データテーブル列をリストに取得 アクションを使います。事業所列(1列目)を指定しJigyosyoListに保存。

同じフォーマットで別のファイルから同様に読み取ってリスト化JigyosyoList2、リストの統合 アクションを使ってひとつにまとめることもできます。
JigyosyoListとJigyosyoList2を統合し、JigyosyoListに値を入れなおしました。値の数が合わせて6行になります。

ひとつにまとめた後、リストから重複する項目を削除 アクションで一意の値のみにすることができます。重複していた大阪支店が削除され、JigyosyoListは5行に。

このようにリストを加工してからループで使うと処理がスムーズになりますね。

新しいリストの作成

新しいリストの作成 アクションで空のリストを作ることもできます。項目をリストに追加 アクションで任意の値をセットして使います。

項目に追加する値を変数にすることでその時々の値でリストを作成することができます。何の値がどういう順番で入るか分からないため、そのまま書き込んだり、ループに使用して処理することが多いでしょう。

リストを使ってダウンロードファイルの特定

Webブラウザからダウンロードしたファイルがダウンロードフォルダに自動保存される設定のとき、いまダウンロードしたファイルを特定するフローをリストを使って作ってみましょう。

ダウンロードする前にフォルダー内のファイルを取得

事前にファイルのリストを取得しておく。FilesBeforeに保存。

STEP

1

ダウンロードボタンを押した後、再度フォルダー内のファイルを取得

上記同様。変数はFilesAfterとしておく。

STEP

2

リスト内容を減らすアクションで、差分を取得

Step1で取得したファイルのBeforeリストと、Step2で取得したファイルのAfterリストの差分ListDifferenceがいまダウンロードしたファイルということになる。Afterリストにファイルが増えるはずなので、設定の”最初のリスト”にはAfterリストを指定する。

STEP

3

差分が出るまで繰り返し、差分が出たらループを抜ける

ダウンロードに時間がかかることもあるため、Step2～3はループ条件アクションで繰り返す。true = true と設定しておくと、無条件にずっと繰り返すことができるため、差分ファイルが出るまで待機する。ListDifferenceのカウントが0より多ければループを抜けるアクションをセットしておく。

STEP

4

実際にダウンロードするときには、無限ループにならないよう経過時間を計って何分間まで待つか決めておいたり、長めの時間がかかる場合は予めWaitを入れてループ回数を減らすようにしておくとよいでしょう。

リスト型は自分で作るよりも、処理の結果として出会うことの方が多いと思います。リスト型がどういうものかを知って上手く使ってみてください。
変数シリーズ【第5回】では、自分で作る変数活用例を紹介します。

• 変数 第５回 自分で作る変数活用例

変数シリーズ【第３回】プロパティです。
変数には型があり、一部の型にはプロパティという便利な機能があります。プロパティはどんなもので、どんな風に使えるかを知って活用していきましょう。
変数シリーズ【第１回】【第２回】の内容を踏まえて紹介しています。未読の方は、ぜひ第１回からご覧ください。

【Power Automate for desktop】変数 第１回 使ってみよう！

公開日 Power Automate for desktopではじめて変数に出会った人も多いのではないでしょうか。変数と聞くと難しそう、よく分からない…と思われるかもしれませんが、使って…

株式会社KMDS

【Power Automate for desktop】変数 第２回 データテーブル

公開日 変数シリーズ【第２回】データテーブルです。データテーブルとはデータ型のひとつで、表形式のデータをまるごとひとつの変数に保存できます。ひとつの変数の中に複…

株式会社KMDS

プロパティとは？

変数は値そのものの他に、プロパティ情報も持っています。プロパティとは対象の持つ設定・状態・属性などの情報のことです。PADではたとえば、前後にある空白を除去した後のテキスト値、テキスト値の文字数、データの個数・行数などがあります。変数と同じように値として使うことができ、非常に便利なものです。
どんなプロパティがあるかはデータ型によって異なります。（データの型については【第１回】参照）

まず元となる値を用意します。変数の設定 アクションを配置し、変数名と値を入力します。
%サンプル値%  値：あいうえお
この値のプロパティにはどんなものがあるか見てみましょう。

確認用にもうひとつ変数の設定 アクションを配置し、変数を作ります。値の変数の選択 {x} を開くと、さきほど作成した変数 サンプル値 があり、その左側にある > マークをクリックして開きます。

.（ドット）で始まる、.Lengthや.IsEmptyなどがプロパティです。プロパティ値自身にも型があることが解りますね。変数 サンプル値そのものではなく、プロパティ名をクリックしてから選択ボタンを押すと値にセットされます。サンプル値はテキスト型で、テキスト値には上図のようなプロパティがあります。

プロパティは%変数名.プロパティ名%と、%の内側で変数名の後にドットを付けて続けて書きます。変数同様手入力でもOKです。
今回はよく使うデータ型にどんなプロパティがあるか見ていきましょう。

プロパティを使う前にどんな値かしっかり確認しよう！

多くのプロパティは変数ペインでその値を確認できないため、変数に入れたり、ループ内ならメッセージウィンドウを使ったりして、使う前に確認すると確実です。

変数 サンプル値のプロパティを確認する変数を作ったら、実行して変数ペインで値を確認してみましょう。

トリムはテキスト前後にある半角・全角スペース、改行、タブを除外した値を返します。サンプル値の値の前後にこれらを入れてみると上図のように確認できます。
トリムはさらに > マークがあり、トリム後の値に対するプロパティも使えるようになっています。
テキストのトリミング アクションと同じ効果がありますので、プロパティのトリムもぜひご活用ください。

テキストの文字数を返します。半角・全角スペース、改行、タブも含まれます。文字数制限がある値や何桁と決まっている時のチェックに使ったりできますね。

変数の値が空かどうかを返します。返る値はブール値型というもので、True（＝はい・真）かFalse（＝いいえ・偽）のどちらかです。これも値のチェックに使えそうです。

プロパティ名を見ただけではわかりにくいものもあります。
アクションでプロパティを使う時は、こうやって値を事前に確認することを徹底しましょう。

ファイルのプロパティ

プロパティが分かりやすいのがこのファイル型で、変数ペインでプロパティの値まで確認することができます。
フォルダー内のファイルを取得 アクションを配置して、任意のフォルダ内にあるファイルの一覧を取得してみましょう。

変数ペインで値を確認すると、変数 Files はリストファイルという型でした。これはファイル型の値だけを持つリストです。リストは1列で複数行の値が持てる型です。
この0行目の右端に 詳細表示 があるので開くと、このファイルのプロパティが表示されます。エクスプローラーのプロパティと同じ情報が確認できます。
リストの0番目は下図にあるように、%Files[0]% と表します。値がひとつしかなくても何番目か指定する必要がありますので注意してください。
何番目か指定できれば、%Files[0].Name% のようにプロパティを使用することができます。

変数 Filesは複数値を持つ型なので、Filesそのもののプロパティを見ると .Count（値の個数） しかありません。たとえばFor eachを使い、ひとつのファイルをCurrentItemに入れてから、%CurrentItem.Name% とすることでもプロパティを使うことができます。（For eachについては【第２回】参照）
メッセージを表示 アクションを使って、拡張子なしのファイル名を表示してみましょう。

ファイル名（.Name）、拡張子なしのファイル名（.NameWithoutExtension）、フォルダ名（.Directory）、作成日（.CreationTime）、更新日（.LastModified）あたりは、読み取ったファイルの情報として書き込むなどで使う機会があるのではないでしょうか。

日付・時間のプロパティ

日付・時間のDatetime型では、年月日、時分秒、曜日、1年のうち何日目、の各値を個別に取り出すことができます。

プロパティの年月日はそれぞれ数値型であるため、単純に並べてしまうと 202421 などとなってしまい、月・日がきちんと区別できなくなってしまうため注意が必要です。

曜日（.DayOfWeek）はどんな形式で取得できるのか確認してみると、Thursdayと英語表記でした。日本語の曜日を取得したい場合は、プロパティではなくdatetimeをテキストに変換 アクションを使い、形式 ‘dddd’で木曜日、もしくは形式’ddd’で木（省略名）を指定します。

データテーブルのプロパティ

第２回で作成した変数 StaffListData を使って、データテーブルのプロパティを見てみましょう。（使えるデータテーブルがない方は第２回を参照して作ってみてください）

これもまた変数の設定 アクションを使ってそれぞれの値を変数ペインで表示します。

データの行数（.RowsCount）、データの列数（.Columns.Count）、は分かりやすいですね。列数はリストである.Columnsの個数として.Countが使えます。
複数値を持つ変数ではデータ個数や、行列数を取り出せるため、Loop アクションを使うときに役立ちます。
終了には %StaffListData.RowsCount -1% （3-1 = 2）と設定します。-1しているのは、データの行番号が0から始まるためです。LoopIndexは0～2の行番号を指定するために使いますから、LoopIndexの最大値は行数-1とする必要があります。

データの行数値を使ってデータを下からループ処理する方法

Loop アクションを配置し、開始値：%StaffListData.RowsCount -1%、終了：0、増分：-1 とします。上からループするときは開始値を0にします（違うこともあります）が、開始値と終了を逆にするのです。

データを下から処理するのはどんな時に使うかというと、データテーブルの行を削除するときです（エクセルシートの行削除でも同様）。
データの上から処理をした場合（開始値 0 終了 2 増分 1）、0行目を削除すると下にあるデータの行番号が変わります。次のループでLoopIndexは1、行番号1を処理することになり、新0行目である旧1行目が処理されなくなってしまいます。
つまり、下から処理してしまえば、これから処理する上にあるデータがずれることはないため、漏れなく処理できるのです。

.Columnsと.ColumnHeadersRowはどちらも列名を取得する似たようなものなので、違いを比較しておきましょう。

内容は同じですが、リストとDatarowでそれぞれ型が違いますね。.ColumnHeadersRowは横並びですので、そのままエクセルに書き出して列名とし、その下にデータそのものであるStaffListData（の一部など）を書き出すような転記に使用すると便利です。

.IsEmptyはデータ有無を表します。Trueの場合、行数 0 = （列名はあるが）データがないと判定できます。

＜新しく登場したデータ型おさらい＞
ブール値型 True/False、ファイル型、リスト型

プロパティとその使いどころを共に紹介してみましたが、使う場面がイメージできてきたでしょうか？機会があればプロパティの存在を思い出して、ぜひ試してみてください。変数シリーズ【第4回】ではリストを紹介します。

変数シリーズ【第２回】データテーブルです。
データテーブルとはデータ型のひとつで、表形式のデータをまるごとひとつの変数に保存できます。ひとつの変数の中に複数の値がある場合、どうやって値を使えばいいのでしょうか？今回はこのデータテーブルを使ってみましょう。

【Power Automate for desktop】変数 第１回 使ってみよう！

公開日 Power Automate for desktopではじめて変数に出会った人も多いのではないでしょうか。変数と聞くと難しそう、よく分からない…と思われるかもしれませんが、使って…

株式会社KMDS

エクセルから”範囲”を読み取る

まずエクセルでこのような表を用意します。従業員マスタをイメージしてください。※架空の従業員情報です

Excel ワークシートから読み取る アクションを配置し、取得を「セル範囲の値」、先頭～最終の列行は範囲の列・行を入力します。

ここでのポイントは、範囲の最初の行に列名が含まれています をONにしておくことです。
生成された変数は ExcelData となります。この変数名のままだと、何の値が入っているか分かりにくいので今回は StaffListData に変更します。
フローを実行すると、StaffListDataに表がそのまま取り込まれ、DataTable型と確認できます。

DataTable型の見方・使い方

データテーブルは表形式のデータそのままで、列と行を持つことができます。つまり、複数の行列を持てる＝複数の値のまとまりということ。
変数はひとつの値を保持するだけでなく、まとまった複数の値をひとつの変数として持つことができます。

このデータの中からひとつのセル値を指定するには、このように表します。
%変数名[行][列]%
たとえばひとり目の氏名を取得するには、%StaffListData[0][‘氏名’]% または %StaffListData[0][2]% となります。

エクセルから範囲を読み取る際に、「範囲の最初の行に列名が含まれています」をONにしたため分かりやすい列名で列を指定することができます。
一方OFFにした場合は、列名がColumn+連番となります。

列名部分もデータの一部として0行目に表示され、実際のデータが1行目になります。
この場合のひとり目の事業所は、%StaffListData[1][‘Column2’]% または %StaffListData[1][1]% となります。

変数を使って行列の番号を指定するには、別途数値を持つ変数を用意した上で、このように表します。
%RowNo% 値：2 （半角数字）
%StaffListData[RowNo][‘氏名’]%

列名自体を変数に入れることも可能で（%ColumnName% 値：氏名）、%StaffListData[RowNo][ColumnName]% とし、列名にシングルクォーテーションを付けません。
メッセージを表示アクション を利用して（ポップアップが妙に小さいのですが・・・）、いろいろなパターンでセル値を指定して、値を確認してみてください。

データテーブルから値を取りだす方法は少し難しく見えますね。ですが、まとめて値をたくさん読み取るため、ひとつひとつ何度も読み取るよりは効率が良くなります。行番号や列の指定方法に慣れるために、意識して使ってみましょう。

ループアクション Loop と組み合わせて使う

データテーブルは複数値のまとまりなので、1行ずつ同じ処理を行っていくというケースが多いです。ループ=繰り返しと組み合わせて使う方法をみてみましょう。
ループは1周ごとに変数の内容を変えることで別の値に対して同じ処理を行うものです。

では、列名を指定して読み取った StaffListData を使ってループ処理を作ってみましょう。
Loopアクション を配置し、開始値：0 （= 行番号0から）、終了：2 （= 行番号2まで）、増分：1 （= 1ずつ） とします。
Loop とセットでEnd が作成され、Loop から Endを1回実行すると1周で、今回だと0~2までの3周することになります。

生成された変数は LoopIndex でした。LoopIndexには開始値、つまり今回は0がセットされています。そして1周すると、増分1され2周目のLoopIndexは1が入るというように、1周するごとにLoopIndexの値は変化していきます。

つまりこのLoopIndexを使うことで、順番にデータテーブルの行番号を変化させていけるということです。
メッセージを表示アクション を配置し、1周ごとに氏名を表示してみましょう。変数は %StaffListData[LoopIndex][‘氏名’]% と書けばいいですね。
1周ごとに氏名が表示されましたでしょうか？

データテーブル内の値をきちんと把握した上で、LoopIndexの値を上手く使いこなすとLoopはいろいろな使い方ができます！

ループアクション For each と組み合わせて使う

Loopは便利ですが慣れないうちはけっこう難しいものですよね。もう少しシンプルな方法にすることもできます。

では、列名を指定して読み取った StaffListData を使ってもうひとつループ処理を作ってみましょう。
For eachアクション を配置し、反復処理を行う値に StaffListData をセットします。StaffListData の行数分、1行ずつ上から実行する、ことになります。
何を実行するかというと、保存先 CurrentItem へ1行分のデータを保存することです。この変数名も分かりやすくするために今回は CurrentItemStaff に変えておきます。

全然シンプルじゃない。何か複雑じゃない？という気もしますが、落ち着いて、順に見ていきましょう。
メッセージを表示アクション を配置し、1周ごとに CurrentItemStaff を表示してみましょう。

保存先の変数（CurrentItemStaff）には1行分のデータを保存してくれるため、最初の行だけすべての列の値を持っているのですね。
変数ペインで CurrentItemStaff の値を確認してみると、Datarowという複数列を持つ1行分のデータ型ということが分かります。
つまり、1周するごとにDataTable型の StaffListData から、Datarow型の CurrentItemStaff へデータを移し替えているのです。

1行分だけのデータになったら、後は列を指定するだけでひとつのセル値を取りだすことができます。氏名列の指定はこのようにします。
%CurrentItemStaff[‘氏名’]% または %CurrentItemStaff[2]%
データテーブルで列行を指定するときと、基本の書き方は同じです。行を指定しない分シンプルですね！

For eachアクションに繰り返し処理したい値をセットするだけなので、Loopに比べると使い方はシンプルです。保存先の変数名で値を取りだすのがポイントですね。
きちんと列名指定して読み取ったデータテーブルを処理するのに向いています。
なんとなくデータテーブルから値を取りだす方法がイメージできてきたでしょうか？

エクセルのデータがある範囲を調べる

冒頭でエクセルから読み取ったときは範囲をべた書きで指定したのですが、固定値ではなく”データがある分を自動的に”読み取りたいですよね。
テーブル名があれば取得を「名前付きセルの値」にし、テーブル名を指定すると便利です。テーブル名がない表の場合は、Excelワークシートから最初の空の列や行を取得アクション を活用してみましょう。エクセルから読み取るアクションより上にアクションを配置してください。

最初の空の列 FirstFreeColumnと行 FirstFreeRow が数値で取得できます。これは空の行の行番号になるので、この1行前までデータがある、と考えられます。つまり空の行-1すればデータの最終行になるというわけです（変数シリーズ【第1回】変数を計算で使ってみる）。エクセルから読み取るアクションの範囲の最終行を、FirstFreeRow を使って変更してみてください。

これでデータ量の増減があっても設定を変える必要はなく、データがある分だけ範囲に含めることができます！

＜今回のおさらい＞
DataTable型 %ExcelData[行][列]%、Datarow型 %CurrentItem[列]%、データの最終行 %FirstFreeRow -1%

データテーブルの列行の指定方法は難しかったと思います。変数ペインで値を確認しながら、たくさん使って感覚をつかんでいきましょう。
変数シリーズ【第3回】ではプロパティを紹介します。

【Power Automate for desktop】変数 第３回 プロパティ

公開日 変数シリーズ【第３回】プロパティです。変数には型があり、一部の型にはプロパティという便利な機能があります。プロパティはどんなもので、どんな風に使えるかを…

株式会社KMDS

Power Automate for desktopではじめて変数に出会った人も多いのではないでしょうか。変数と聞くと難しそう、よく分からない…と思われるかもしれませんが、使っていくうちに感覚がつかめてきます。
これから何回かに分けて、変数について紹介していきます。まずは【第１回】使ってみよう！

変数とは？

名前を付けた箱のようなものです。数学の x や y で行う、x = 1 というように値を入れて保存しておけるもの。変わる数 という名前からも分かる通り、中の値が変えられるものです。値を保存しておけるので、別の場所でその値を使うことができます。

PADでは % を使って変数を表します。
%Name%のように、%で前後を囲んだものが変数です。この場合Nameが変数名。

どうやって作る？・・・アクションから生成

では命名ルールとか小難しいことはいったん置いておいて、とにかく作ってみましょう。
現在の日時を取得するアクションを配置します。変数については生成された変数に表示されています。

これで変数 CurrentDateTime ができました。画面右側にある変数ペイン（下図オレンジ枠線部分）のフロー変数に追加されます。この時点ではまだ変数に値は入っていません。
変数ペインが開いていない場合は、右端にあるアイコンのうち｛x｝変数をクリックして開いてください。

フローを実行する（）と現在の日時が取得され、変数に値が入ります。このように変数ペインで変数にどんな値が入るか確認することができます。
変数に入った値を確認するこの方法は覚えておきましょう。

どうやって使う？・・・｛ｘ｝から選択

次にメッセージを表示アクションを配置します。ポップアップでメッセージウィンドウを出し、さきほど取得した現在の日時を表示してみます。
変数の選択 {x}から選択すると、%CurrentDateTime%と入ります。変数は手入力することもできます。

フローを実行するとメッセージのポップアップが出て、現在の日時が表示されます。これで別のアクションで変数を使うことができました。

フローは上から順に実行されるため、アクションを並べる順番が大事です。
変数を使うときにちゃんと想定した値が入っているか、メッセージを表示アクションや変数ペインで確認するようにしましょう。
ちなみに、メッセージを表示アクションでも変数が生成されるので、変数ペインに変数が増えています。

生成された変数名を変えてみる

アクションで生成される変数は自動で名前が付きますが、変更することもできます。
今度はExcelの起動アクションを入れてみましょう。ExcelInstanceという変数が生成されます。
複数のエクセルを扱うことも多いですよね。もうひとつエクセルの起動を入れてみると、ExcelInstance2になりました。
同じアクションを追加すると、変数の末尾に数字がつき、それぞれ区別できるよう変数が作られます。

別のエクセルだと分かるとはいえ、どちらがどのエクセルを指しているのか分かりにくいので、変数名を変更しましょう。
アクション作成時に変数名を変えるには、生成された変数の 変数名をクリック > もう一度クリックして編集モードに > 変更したらEnter。
変数名前後の%は自動で付きますので、消してしまっても大丈夫です。

注意！ 変数名に使えない文字を含めて保存すると、変数生成がOFFになる
たとえば、%Template Excel%とスペースを含めて変更してみます。一見変更できたように見えるのですが、再度Excelの起動を開いてみると変数の生成がOFF、変数名はExcelInstanceになっていることが分かります。変数の命名ルールは冒頭「命名ルール」をチェック！

変数ペインから変更すると、既にいくつかのアクションで使用している変数名を一括で変更することができます。
変数名の3点ボタン > 名前の変更
生成したアクションから変えても、他のアクションで使用している変数名は変更されないのでご注意ください。

自分で変数を作ってみる

これまではアクションが生成する変数を見てきました。変数は自分でも作ることができますので、以下の変数を作ってみましょう。
変数の設定アクションを使用し、変数名と値を入力します。
%Amount% 値：1000（半角数字）
%Qty% 値：５（全角数字）

自分で作る変数をどういう時に使うかというと、例えばフォルダーパスやファイルパス、メールアドレスなど2カ所以上で使う値や、消費税やURLなど変更する可能性がある値です。変数に入れておくことで、変数の値だけ変更すればよいためメンテナンスや変更が楽になります。

変数には型がある

変数には型（かた）というものがあり、例えば、文字列型、数値型、日付型などいろいろあります。
今回使用したアクションで作成された変数の型をいくつか見てみましょう。

さきほど自分の変数を作成し、半角数字、全角数字をそれぞれ入れてみました。
フロー実行後、変数ペインでそれぞれの変数・値の部分をダブルクリックで開いて、型を確認してみましょう。
変数名の右側に型が表示されます。

数値として認識されたのは半角数字だけです。全角数字はテキスト値。保存後のアクションを見ても”が付いているとテキスト値として認識されていることが分かります。
セルの指定や計算に使うためには数値である必要がありますので、数値は半角で入力してください。
型は変数の選択{x}でも表示されますので、使うときに確認することもできます。

次に最初に作成したCurrentDateTimeを確認してみましょう。
Datetimeという、日付と時間を持つ型です。

Datetimeは日付の計算をすることができます。たとえば、今日から３日後の日付、1月前の日付、今月末の日付。日付だけでなく年・月・日などをバラバラに使うことも可能です。

Datetimeからテキスト値へ変換できる

よくファイル名に作成日を付けたいことがあります。このCurrentDateTimeの値だと長いしスラッシュも含まれていてこのままだと使えません。
そんなときはdatetimeをテキストに変換アクションで、任意の形式を指定した上でテキストに変換し%FormattedDateTime%を作ります。これでファイル名に含めることができます。

次にExcelの起動で作成されたTemplateExcel（ExcelInstance2から名前を変更しました）を見てみます。
Excelインスタンスだそうです。。名前も値もよく分かりませんが、インスタンスはどのエクセルを操作するのかを判別するものです。

先ほど名前を変更してみましたが、複数のエクセルを起動したとき、どちらのエクセルを操作しているか分からなくならないよう、名前をきちんと付けておくことが重要です。分からなくなったら、変数を生成したExcelの起動アクションを見て、どのエクセルを指しているか確認してください。

型は少し難しいですが、自分がよく使うものから特徴を押さえ慣れていきましょう！

変数を計算で使ってみる

型というものがあるんだなぁと知ってもらったところで、数値の入った変数を使って計算してみましょう。
計算はエクセルと同様、+ – * / で四則演算ができます。
変数の設定アクションで、%Amount%に数量をかけるにはこのように%で囲んだ中に演算を記入します。
%Total% 値：%Amount * 5%

変数同士の計算はこのように記入します。（%Qty%の値は半角数字で書き換えておきます。）
%Total2% 値：%Amount * Qty%
%%の内側でも変数の選択{x}からだと%が付きますが、%%はひと組だけであるところがポイントです。
フローを実行すると、変数にはちゃんと計算した結果が入りました。

値・変数を計算式としておくことで、金額と数量のように、後で金額だけもしくは数量だけ値を変えることも楽になります。
フローを作るときは、値が変わりそうなところを想定して予め変えやすく作っておくのも楽するコツです。

今回は入門編として、変数をとにかく使ってみました。変数のイメージは掴めてきましたか？
案外色々ありましたね。変数【第2回】ではデータテーブルを紹介します。

【Power Automate for desktop】変数 第２回 データテーブル

公開日 変数シリーズ【第２回】データテーブルです。データテーブルとはデータ型のひとつで、表形式のデータをまるごとひとつの変数に保存できます。ひとつの変数の中に複…

株式会社KMDS