Read from Array
Read from Array アクションステップは、配列のコンテンツにアクセスするために使用されます。
インデックスを使用して配列の特定の時点で値を返すことも、配列全体をテキストとして返すこともできます。後者の場合は、すべての値がカンマ区切り値としてリストされます。
Read from Array アクションステップでは、さまざまなデータ型として配列からの読み取り値が自動的に提供されます。どのデータ型を使用するかは、ワークフローで後で決定できます。
プロパティ
Get entire array as CSV (配列全体を CSV として取得) (Bool (ブール)、デフォルト: false) アクティブな場合、配列全体が CSV 形式の文字列として返されます (カンマ区切り値)。
Index to read at (読み取る場所のインデックス)*(integer (整数)、> 0、デフォルト: 1) 配列内で配列のコンテンツを読み取る位置。インデックス付けは 1 から始まります。
入力するインデックスが配列内のすべての要素の合計数を超えないようにしてください。
インバウンド変数
Array to read from (読み取り元の配列) (Array (配列)) 読み取り元となる配列。
[Array to read from (読み取り元の配列)] ドロップダウンリストにはこれまでワークフローで作成されたすべての配列が含まれています。これらは、[Workflow Based Variables (ワークフローベースの変数)] の場合もあれば、Read from Excel File アクションステップからの戻り配列の場合もあります。
Index to read at (読み取る場所のインデックス)*(integer (整数)、> 0、デフォルト: 1) 配列内で配列のコンテンツを読み取る位置。インデックス付けは 1 から始まります。
アウトバウンド変数
Read from Array アクションステップにより、自動的に 4 つの異なる戻り値が提供されます。それぞれの戻り値は可能なデータ型のいずれかを表します。 データの使用目的に応じて、異なるデータ型を受け入れます。たとえば Keystroke では、データ型 AsString を使用するか、Loop の反復頻度を管理するために使用する数値に影響する場合は、データ型 AsInt を使用します。
-
Read from Array.AsString (Array.AsString から読み取る) (string (文字列)) 値をテキストとして返します。
-
Read from Array.AsInt (Array.AsInt から読み取る) (int (整数)) 値を整数として返します。
-
Read from Array.AsDouble (Array.AsDouble から読み取る) (double (倍精度浮動小数点)) 値を浮動小数点数として返します。
-
Read from Array.AsBool (Array.AsBool から読み取る) (bool (ブール)) 値をブール値として返します。
配列から読み取られる値のコンテンツに目的のデータ型と互換性があることを確認してください。
たとえば、「abc」などの文字列を有意義な整数値に変換することはできません。
Read from Array アクションステップからの戻り値を別のアクションステップで使用する場合、この時点で有意義に使用できるデータ型に関して事前に選択が行われます。
次の表に、データ型の変換の結果の概要を示します。
| 変換元/変換先 | String (文字列) | Int (整数) | Double (倍精度浮動小数点数) | Bool (ブール) |
|---|---|---|---|---|
String (文字列) |
変更なし |
0 |
0 |
文字列 True および true と 0 より大きいすべての正の数値は True。その他はすべて False。 |
Int (整数) |
変更なし |
変更なし |
変更なし |
Int ⇐0 の場合は false。Int >= 0 の場合は true。 |
Double (倍精度浮動小数点数) |
変更なし |
小数位は切り捨てられます。 |
変更なし |
Double ⇐0 の場合は false。Double >= 0 の場合は true。 |
Bool (ブール) |
変更なし |
0 |
0 |
変更なし |
各行はアウトバウンドデータ型を参照し、各列は列ヘッダーのデータ型に変換した結果を参照しています。
ウィザード
[Array to read from (読み取り元の配列)] ドロップダウンリストにはこれまでワークフローで作成されたすべての配列が含まれています。これらは、[Workflow Based Variables (ワークフローベースの変数)] の場合もあれば、Read from Excel File アクションステップからの戻り配列の場合もあります。
[Get entire array as comma separated values (配列全体をカンマ区切り値として取得)] チェックボックスをオンにすると、配列全体が文字列として返されます。各値は当然、カンマで区切られます。この場合、テキスト項目 [Index to read at (読み取る場所のインデックス)] とそのコンテンツは非アクティブ化されます。
[Index to read at (読み取り場所のインデックス)] は、配列のコンテンツを読み取る配列内の位置を示します。最初の要素のインデックスは 1 です。 1. インデックスは変数にマップすることもできます。[Pin (固定)] シンボルをクリックして、リストから適切な変数を選択するだけです。その後、変数を手動で設定するには、[Pin (固定)] シンボルを再びクリックして [None (なし)] を選択します。続いて、入力項目に値を手動で入力できます。その上のチェックボックスをオンにすると、入力項目とそのコンテンツは無効化されます。