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

【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とする必要があります。

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

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

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

---

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

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