ロボットの変数とタイプ

ロボット ワークフローでは、ベーシック エンジン ロボット からの入力を使用し、何らかの設定を追加した同一の変数タイプを使用できます。

ロボットで使用される変数は、さまざまな方法で作成できます。作業を中断して変数セクションにスクロールせずに、コンテキスト メニューから新しい変数を作成できます。ロボット ワークフローの実行状態をリセットせずに、既存の変数を編集可能できます。入力変数は、ベーシック エンジン ロボットで編集します。一部の出力値は、ロボットで作成した変数に関連付けることができます。

  • ロボット内で変数を作成するには、ロボットの [属性] ペインの [変数] ボックスを使用します。属性の名前を挿入し、そのタイプをボックス内のドロップダウン リストから選択します。詳細については、「ロボットの編集 」を参照してください。

  • ロボット ワークフローの実行状態に関係なく、いつでも新しいタイプの変数を作成できます。作成するには、[ファイル] > [新しいタイプ] の順に移動します。そうすることで、新しいタイプと変数が使用できるようになります。

  • ロボット ワークフローの実行状態をリセットせずに、既存の変数を編集できます。編集するには、アクション ステップを右クリックし、[割り当てと変換] > [割り当て] の順にクリックします。

  • 変数の値を出力に表示するには、そのタイプを [属性] ペインの [リターン タイプ] ボックスで設定します。

  • シンプルと複雑な変数の両方とその属性をロボット ワークフローの入力として使用できます。ベーシック エンジン ロボットで入力変数のすべての設定を行ってから、ロボットの [属性] ペインの [入力値] ボックスに追加します。詳細については、「ロボット入力とリターン タイプ」を参照してください。

  • ベーシック エンジン ロボットの複雑な変数は、いずれもロボット ワークフローでのレコード変数の作成に使用できます。

  • ローカル変数を作成できますが、グループ ステップのみで使用できます。ステップでローカル変数を使用する場合、ステップをそのローカル変数のあるグループに含めます。変数タイプについて、詳しくは変数の設定を参照してください。
  • ロボットのパスワード タイプ変数の値は、ベーシック エンジン ロボットで作成されたパスワード タイプ変数との間で転送できます。ロボット ワークフローのパスワード タイプ変数の値を手動で割り当てることはできません。

簡単な変数とタイプ

ロボットの各種の簡単な変数は、ベーシック エンジン ロボットで使用される変数とは異なります。ベーシック エンジン ロボットについては、「タイプ属性」を参照してください。

ロボットは、以下を含むデフォルト値が設定されている限られた数の変数タイプを操作できます。

  • バイナリ:空
  • ブール値: false
  • 整数:0
  • 数値:0.0
  • パスワード:空
  • テキスト:""

複雑な変数とタイプ

現在はロボットでシンプル タイプの変数とレコード タイプの変数を処理できます。

レコード タイプはコンプレックス タイプと同じですが、コンプレックス タイプはベーシック エンジン ロボットからロボットにそのまま渡されることがないのに対して、レコード タイプは基本的にベーシック エンジン ロボットで使用されるコンプレックス タイプから派生するという違いがあります。ロボットとベーシック エンジン ロボットでタイプ名が同じなので、変数をエラーなしで簡単に操作できます。

複雑な変数とその属性をロボット ワークフローの入力として使用できます。詳細については、「ロボット入力とリターン タイプ」を参照してください。

レコード変数

レコード変数は、ロボットが使用するレコード タイプ (複雑な変数) に基づいています。

たとえば、「クレデンシャル」レコード タイプは、[ユーザー名] および [パスワード] の 2 つのフィールドで構成されます。ユーザーが「クレデンシャル」タイプの変数 (たとえば、「userCred」) を作成する場合は、[ユーザー名] が「Joe」、[パスワード] は「Password」となるようにフィールドを定義できます。この情報は [状態] ビューに表示されます。次に、別の値 (たとえば、「Tom」) を [割り当て] ステップの userCred.username に割り当てることにより、変数の値を変更できます。これにより、[ユーザー名] フィールドが「Tom」に変更され、[パスワード] フィールドは変更されません。

  • 同じレコード タイプのレコード変数を互いに割り当てることができます。

  • レコード タイプには、Date、Time、および DateTime タイプのフィールドを含めることができます。Date タイプのコンプレックス タイプを作成する場合は、派生するレコード タイプの対応するフィールドに Date、Time、または DateTime (デフォルト) のいずれかを指定できます。

  • レコード変数の属性を同じタイプの値や同じタイプの別の属性または簡単な変数に割り当てることができます。

    レコーダー ビューの変数を使用するすべてのショートカット メニューからレコード タイプ変数のフィールドを選択できます。

    たとえば、テキストを入力はその値を複雑な変数のフィールドから取得でき、選択した変数のタイプがテキストではない場合、値をテキストに変換するために、変換関数が挿入されます。テキストに変換できないタイプの変数とフィールドは、リストに表示されません。

    抽出ステップの場合、複雑な変数のフィールドに抽出することもできますが、フィールドのタイプは、テキストや (画像の) バイナリなどの抽出されたデータのタイプに一致する必要があります。正しいタイプの変数のみがメニューに表示されます。

    ベーシック エンジン ロボットで設定されたカスタムのデフォルト値は、テスト値として扱われます。この値がデフォルト値としてロボットに転送されることはありません。ロボットで変数のデフォルト値を設定するには、アクション ステップを右クリックし、[割り当てと変換] > [割り当て] の順にクリックします。

Date、Time、および DateTime レコード フィールド タイプ

レコード タイプには、Date、Time、および DateTime タイプのフィールドを含めることができます。これらのタイプはベーシック エンジン ロボットの Date タイプに対応し、日付と時刻を処理するためにロボットでのみ使用されるよう設計されています。

タイプ 説明
Date Date は、時刻やタイム ゾーンを参照せずに日付を表すタイプです。Date タイプの変数のデフォルト値は、1601-01-01 です。
Time Time は、日付とタイム ゾーンを参照せずに時刻を表すタイプです。Time タイプの変数のデフォルト値は、00:00:00 です。
DateTime DateTime は、ISO-8601 カレンダー システムのタイム ゾーンで日付と時刻を表すタイプであり、基本的には Date および Time の値とタイム ゾーンで構成されます。DateTime 変数のデフォルト値は、その Date および Time コンポーネントのデフォルトのタイプと、ロボットが実行される場所に対応したデフォルトのタイム ゾーンで構成されています。

Date、Time、または DateTime のレコード フィールド タイプを含むタイプを定義するには、Date タイプの属性でコンプレックス タイプを作成し、その属性のレコード フィールド タイプを定義する必要があります。Date の属性は必要な数だけ追加できます。以下の手順では、それぞれ異なるレコード フィールド タイプを持つ 3 つの Date の属性でコンプレックス タイプを作成する方法を示します。

  1. タイプを作成した後は、Date タイプの属性を追加します。属性の設定で、[レコード タイプのフィールド タイプ] が [デフォルト] に設定されていることを確認します。デフォルトに該当するのは DateTime タイプです。

  2. Date タイプの別の属性を追加し、[レコード タイプのフィールド タイプ] を [使用] に設定してから、[タイプ] を [Date] に設定します。

  3. Date タイプの属性をもう 1 つ追加し、[レコード タイプのフィールド タイプ] を [使用] に設定してから、[タイプ] を [Time] に設定します。

設定後のタイプには、それぞれ異なるレコード フィールド タイプを持つ Date タイプの 3 つの属性が含まれています。

ロボット エディターでは、Date、Time、および DateTime の値を含む設定後のレコード タイプが状態ペインに反映されます

注意

  • Date、Time、および DateTime タイプは、ロボットの変数として使用できます。これらのタイプは、ロボット専用に設計されています。Date タイプと Time タイプには、それぞれ日付と時刻が含まれます。DateTime には、日付と時刻の両方、およびタイム ゾーンが含まれます。

  • Date タイプと Time タイプは、ロボットの入力変数としては使用できません。

  • DateTime は、ロボットの入力変数としても出力変数としても使用できます。ベーシック エンジン ロボットの Date タイプの変数は、ロボットの DateTime 入力変数に入力として渡すことができ、DateTime 値は、ベーシック エンジン ロボットのシンプル タイプの Date 変数に出力として返すことができます。シンプル タイプの Date と同様に、DateTime タイプには日付と時刻が含まれます。