自分で作成した変数 (ユーザー定義)
- 最終更新日2023/09/11
自分で作成した変数 (ユーザー定義)
ユーザーおよび一部の actions は、一時的に値を保持するためのユーザー定義変数を作成します。値をアクション (ウィンドウのタイトル、ログイン資格情報、またはファイル パス) に入力したり、アクション (ファイルまたは Boolean 戻り値から読み取った値) の出力を受け入れたりするには、このような変数を使用します。
- bot は、最大 3MB だけを出力変数に返すことができます。また、BotOutputVariable のテーブル構造は 30 万セルまでに制限されています。
30 万セル以上挿入した場合、debug 変数が大きすぎてデバッグできない、または BotOutputVariable が大きすぎて処理できないことを示すエラーメッセージが表示されます。
回避策: .txt ファイルなどで、bot 出力をデバイスに保存します。出力を複数の Bot Runners で共有する必要がある場合は、出力を共有ドライブに保存します。
- Bot の入力変数のサイズは 1,900,000 バイトに制限されています。大きなデータセットを保存する場合は、.txt ファイルを使用することをお勧めします。
変数型
変数のデータ型は、変数に格納されている値が持つことができるデータの種類を決定する属性です。データ型には、整数、文字列、文字などの格納の分類があります。ディクショナリ、レコード、リスト、テーブルなどの変数は、複数のデータ型を格納することができます。
ほとんどの変数型には、類似した名前のパッケージがあります。このパッケージには、変数に格納されている値に操作を実行するために使用するアクションが含まれています。たとえば、文字列変数を操作するには String package の actions を使用します。同様に、数値変数を操作する場合には Number package の actions を使用します。ある変数型の値を別の変数型に変換する方法については、「型変換」を参照してくださいbots 間で同一値を再利用できます。bot ごとに新しい変数を作成する必要はありません。「グローバル値」を参照してください。
変数の命名
変数名には、数字 (0 ～ 9)、ラテン文字 (A ～ Z、a ～ z)、特殊文字 (- および _) を含む最大 50 の Unicode 文字を含めることができます。変数名には、中国語、日本語、韓国語などの 2 バイト文字を使用できます。変数でサポートされる Unicode 範囲
iFileEmailAttachment のような名前にします。<type/scope indicator><data type><Variable name> の命名基準として、以下を推奨します。命名規則には多くの選択肢がありますが、組織内でいくつかの標準を採用して一貫して使用する必要があります。<type/scope indicator> は、次のことを示す単一文字です。
- p = ローカル変数 (入力でも出力でもありません)
- i = 入力変数
- o = 出力変数
- io = 入出力変数
- c = 定数
iStrAuditLogPath: 呼び出し元のタスクから受け取った文字列型変数oNumReturnValue: 呼び出し元のタスクに返した数値型変数ioStrStatus: 呼び出し元のタスクから受け取って、呼び出し元のタスクに返した文字列cStrNull: 値を格納しない文字列。たとえば、値が存在するかどうかを確認するための文字列を比較するのに便利です。
範囲の詳細については、「Task Bot package」を参照してください。この標準を使用すると、型ごとに変数を検索できます。たとえば、oStr は出力文字列値を保持するのに使用される変数を返します。
変数型
| 変数型と推奨される名前 | 説明 | 使用例 |
|---|---|---|
| 任意 Any |
Boolean、データ テーブル、日時、ファイル、番号、記録、文字列、またはウィンドウのデータ タイプを格納します。この変数型は、actionで出力されるデータ タイプが不明な場合に使用します。 | [実行] action の使用例 |
| Boolean Bool |
True または False の値を格納します。 | |
| 資格情報 Cred |
文字列値を安全に格納し、値がメッセージ ボックスに表示されたり、ファイルに書き込まれることを防ぎます。値は Credential Vault から選択するか、ユーザーが指定します。 | |
| 日付時刻 Date |
単一の日付と時間の値を含む値を格納します。 | 定義済みのフォーマットを選択するか、カスタム フォーマットを指定して、値をフォーマットできます。 |
| ディクショナリ Dict |
キー/値ペアのフォームでデータを格納します。値は Boolean、数値、または文字列です。 | |
| ファイル File |
ファイル パスを格納します。 | |
| フォーム Form |
インタラクティブ フォーム フィールドに入力された値を格納します。 | |
| リスト List |
Boolean、数値、文字列値のシーケンスを格納します。 | |
| 数字 Num |
数値 (整数および小数) を格納します。-9,223,372,036,854,775,808 ～ 9,223,372,036,854,775,807 の範囲の小数点以下最大 15 桁までの値を保持します。 この変数にはランダムに生成された値を割り当てることができます。 |
値を文字列に変換する際に、小数点以下の桁を削除できます。 |
| レコード Rec |
テーブルから抽出された値の単一行を格納します。値は Boolean、日時、数値、または文字列です。 | スプレッドシートから Web フォームへのデータ入力例 |
| セッション Sess |
Excel basic、Excel advanced または Terminal Emulator packages からのセッション名を保存します。親から action の子 bot にこの変数を渡して、親 bot で開いたファイル内のデータを子 bot が処理できるようにします。 注: 子 bot でこの変数を初期化する場合、[入力として使用] を選択します。
|
bots 間で Excel セッションを共有する例 |
| 文字列 Str |
英数字、特殊文字、空の値を格納します。UTF-8 文字を最大 65,535 文字まで保持できます。文字列変数には、複数のテキスト行を含めることができます。 | 文字列変数の値を空の文字列変数と比較できます。 |
| テーブル Table |
行や列のテーブルに複数の値を格納します。値は Boolean、日時、数値、または文字列です。 | CSV/TXT ファイル、Excel ファイル、または Web フォームから値を抽出して、テーブル変数に割り当てます。 |
| ウィンドウ Win |
ウィンドウ タイトルと URL を格納します。 ウィンドウ型の変数を作成する場合、デフォルト値として [ブラウザ] を選択すると、Google Chrome のタブのみがサポートされ、デフォルト値として [アプリケーション] を選択すると、あらゆるアプリケーション ウィンドウがサポートされます。 |
一部の actions ([キャプチャ] action など) では、指定したウィンドウ タイトルと URL を格納するウィンドウ変数が作成されます。 |
ウィンドウ変数の動作
Recorderを使用して、特定のウィンドウ (たとえば window 1) を自動化し、そのウィンドウで [クリック] actionを実行し、bot を実行すると、bot では、初めてその特定のウィンドウが検索され、識別用のウィンドウ ハンドルがウィンドウに割り当てられ、ウィンドウがキャッシュに保存されます。同じ window 1 で 2 回目の [クリック] actionを実行すると、bot では、window 1 が使用可能であるかどうかが検証されます。window 1 が使用可能な場合、ウィンドウがキャッシュにすでに保存されているため、bot は特定のウィンドウを検索する必要がなくなり、そこから自動的に取得します。これにより、bot のパフォーマンスが向上し、ウィンドウがすでに利用可能な場合は、bot がすべてのインスタンスでウィンドウを検索する必要がないため、時間が節約されます。
別のページを開く同じ window 1 で 3 回目の [クリック] actionを実1行できるようになりました (ウィンドウ タイトルが変更されるようになったため)。たとえば、Yahoo India の Web ページを開き、その Web ページの [News] オプションで [クリック] actionを実行すると、そのactionにより、ウィンドウのタイトルを変更する別のページに移動されます。
したがって、この場合、bot を実行すると、bot はキャッシュに保存されている同じウィンドウを取得し、それでactionを実行します (ウィンドウがまだ同じで、タイトルのみが変更されているため)。このため、この動作によりユーザー エクスペリエンスが向上し、Web ページを自動化する際に、タイトルが変更されるウィンドウごとに複数のウィンドウ変数が作成されないようにすることができます。
変数を削除
- 1 つの変数を削除: [変数] パレットで、変数名の右にある縦の 3 点リーダーをクリックして [変数を削除] をクリックします。
- 未使用の変数を削除: [変数] パレットで、[未使用の変数を削除] をクリックし、削除する変数を選択して [削除] をクリックします。