変数を管理する

Studio では、複数の種類のデータを格納するために変数を使用します。また、変数の値は変更できるため、たとえば、ループの本体を何回実行するかなどを制御できます。

注:

• Variables need to be created with different names, even if used in different scopes. If two variables share the same name but are in different scopes, the variable in the inner scope takes precedence. You can check out our Workflow Design Naming Conventions recommendations.
• 変数名は、文字またはアンダースコア _ で始める必要があります。
• 特定のキーワード (「Replace」など) を使用して変数に名前を付けると、予期しないエラーが発生する可能性があります。

Studio 側から見ると、変数の名前は一意の ID であり、変数の表示方法と使用方法を定義します。変数の名前が変更または削除された場合、Studio は読み込まれるアクティビティに基づいて .xaml ファイルを解釈することができません。文字列はすべて引用符で囲む必要があります。

重要: 同じ名前の変数と引数がある場合、実行時には常に既定で変数が使用されます。

変数は複数の方法で管理できます。最適なエクスペリエンスと柔軟性のメリットを得るには、データ マネージャーの使用をお勧めします。

変数の型

変数内に格納されるデータは値と呼ばれ、さまざまな型を取ることができます。変数を作成する際に、次のオプションが利用できます。

• Boolean - この型は true または false の 2 つの値のみを取ります。これらの変数を使用すると意思決定が行えるため、ワークフローを適切に制御することができます。
• Int32 - 数値情報を格納できます。数式や比較を実行したり、重要なデータを渡したりするために使用します。
• String - テキスト情報を格納できます。この変数の型は、従業員名、ユーザー名、その他の文字列などのテキストベースの情報を格納するために使用できます。
• Object - さまざまな型のデータを格納できます。この変数の型は、格納するデータの型に柔軟性が必要な場合に使用できます。Object 型の変数で使用するデータ型が、その変数を使用するアクティビティに対応していることを確認してください。
• System.Data.DataTable - この型は多くの情報を格納でき、データベースまたは行と列を持つ簡易なスプレッドシートとして機能します。データベース間で特定のデータを移行する場合や、Web サイトから情報を抽出してローカルのスプレッドシートに格納する場合などに役立ちます。
• Array of [T] - 同じ型の値を複数格納できます。

• 型を参照 - タスクに関連がありそうな型をさらに検索できます。

  注: プロジェクトで使用されている言語で定義した型の変数を静的として使用すると、Windows プロジェクトおよびクロスプラットフォーム プロジェクトではコンパイル エラーが発生します。

変数スコープ

スコープ プロパティでは変数に対し、その変数を使用可能な、明確に定義されたコンテキストを指定します。スコープは、グローバル (プロジェクト全体で利用可能)、現在のワークフロー ファイル、またはワークフロー ファイル内の任意のコンテナー アクティビティに設定できます。

データ マネージャーからはグローバル変数のみ作成できます。

注:

• グローバル変数はシリアル化できないため、長期実行の永続性アクティビティには対応していません。
• グローバル変数はライブラリ プロジェクトではサポートされていません。
• In C# projects, using a global variable or a global constant in activities requires following the format: GlobalVariablesNamespace.GlobalVariables.YOUR_GLOBAL_VARIABLE_NAME. In VB projects, you can reference the global variable or global constant by its name directly.

変数を作成する

データ マネージャーから

1. データ マネージャーを開き、[新規] > [新しい変数] を選択します。
2. 変数の名前、データ型、スコープ、既定値を設定します。

アクティビティの本体から

1. [アクティビティ] パネルから、アクティビティをデザイナー パネルにドラッグします。フィールドを右クリックしてコンテキスト メニューから [変数を作成] を選択するか、Ctrl + K キーを押すか、フィールドの右側にあるプラス記号 をクリックすると表示されるメニューから [変数を作成] を選択します。[変数を設定] フィールドが表示されます。
2. 名前を入力して Enter キーを押します。変数が作成され、フィールドに表示されます。変数のスコープと型をデータ マネージャーで確認します。

式から

アクティビティの入力フィールド、または式エディターを使用して、変数を式から直接作成することもできます。

1. 式の一部を選択して、Ctrl + K を押します。[変数を設定] フィールドが表示されます。

2. 名前を入力して Enter キーを押します。変数が作成されます。変数のスコープと型をデータ マネージャーで確認します。

   
   

   

   
   

上記 2 種類の方法で作成された変数は、アクティビティに応じて自動的に型を受け取ります。たとえば、[範囲に書き込み] アクティビティの [データ テーブル] フィールドで変数を作成した場合、この変数の型は DataTable に設定されます。[1 行を書き込み] アクティビティの [テキスト] フィールドで変数を作成した場合、この変数の型は String に設定されます。

このような変数のスコープは、その変数が含まれる最小のコンテナーです。変数の型は、選択したプロパティに応じて自動的に生成されます。

[プロパティ] パネルから

1. 任意のアクティビティの [プロパティ] パネルで、フィールドを右クリックしてコンテキスト メニューから [変数を作成] を選択するか、Ctrl + K キーを押すか、フィールドの右側にあるプラス記号 をクリックすると表示されるメニューから [変数を作成] を選択します。[変数を設定] フィールドが表示されます。
2. 名前を入力して Enter キーを押します。変数が作成され、フィールドに表示されます。変数のスコープと型をデータ マネージャーで確認します。

この方法で作成された変数のスコープは、その変数が含まれる最小のコンテナーです。変数の型は、選択したプロパティに応じて自動的に生成されます。

[変数] パネルから

1. デザイナー パネルで、[変数] をクリックします。[変数] パネルが表示されます。
2. [変数を作成] 行をクリックし、名前を入力します。新しい変数が作成されます。

このようにして作成された変数の既定の型は String です。

アクティビティの出力から自動生成される変数 (Windows プロジェクトとクロスプラットフォーム プロジェクトの場合のみ)

デザイン設定の [アクティビティの出力を自動生成] が有効化されている場合、出力を生成するアクティビティの各 [出力] フィールドに変数が自動的に入力されます。その後、生成された変数を他のアクティビティで使用するには、アクティビティの入力フィールドの右側にあるプラス記号 メニューを選択し、次に [変数を使用] を選択します。

出力変数を手動で作成する場合は、[出力] フィールド内で作成できます。これにより、生成された変数は、作成した変数に置き換えられます。変数を手動で作成した後に [値をクリア] オプションを選択すると、生成された既定の変数が復元されます。

生成された変数は、[変数] パネルとデータ マネージャー (変数が別のアクティビティで使用されている場合) で使用できます。他の変数と同様に、生成された変数の名前、データ型、スコープ、既定値を変更できます。

生成された変数のスコープは、ワークフロー内でのアクティビティの場所に基づきます (たとえば、アクティビティがメイン シーケンス内にある場合や、[繰り返し (コレクションの各要素)] アクティビティ内にある場合は、スコープが異なります)。生成された変数のスコープは、アクティビティをコピー、切り取り、または貼り付けると更新されます。アクティビティの名前を変更しても、生成された変数には影響しません。ただし、アクティビティを削除した場合は、以下のようになります。

• 変数が使用されていない場合、変数の値がクリアされます。
• 変数が使用されている場合、変数は削除され、その変数を入力として使用していたアクティビティに警告が表示されます。

変数を削除する

変数は、データ マネージャーまたは変数パネルから削除できます。

データ マネージャーから

1. データ マネージャーを開き、[変数] ノードを展開します。
2. 変数を右クリックして、[変数を削除] を選択します。または、変数を選択して Delete キーを押します。

[変数] パネルから

1. [変数] パネルを開きます。

2. 変数を右クリックして、[削除] を選択します。または、変数を選択して Delete キーを押します。

   
   

   

   
   

未使用の変数をすべて削除する

現在のファイルで定義されているが、どこにも使用されていない変数をすべて削除するには、Studio のリボンで [未使用を削除] > [変数] を選択し、確認を求められたら [はい] を選択します。この操作は、注釈に記載されている未使用の変数も削除します。

注: パッケージの削除やアップグレードにより、変数や引数が未定義になる可能性がある場合には、その場所に不明な型が追加されます。これにより、このファイルを Studio で開いて編集することができます。

.Net 変数型を参照して探す方法

既定で [変数の型] リストに表示されていない変数の型を検索するには、次の操作を行います。

1. データ マネージャーで、変数の [データ型] ドロップダウンから [型を参照] を選択します。このメニューは、[変数] パネルの [変数の型] ドロップダウンからアクセスすることもできます。[.NET 型を参照して選択] ウィンドウが表示されます。
2. [型の名前] フィールドに、検索する変数のキーワードを入力します (例:「excel」など)。結果セクションが更新され、入力したキーワードが含まれているすべての .Net 変数型が表示されます。

3. 変数を 1 つ選択して [OK] をクリックします。選択した型を持つ新しい変数が作成され、[変数] パネルに表示されます。

   
   

   

   
   
   注: [参照して .Net の種類を選択] ウィンドウから 1 度選択して使用した種類の変数は、その後 [変数] パネルの [変数の型] ドロップダウン リストに表示されるようになります。

Studio または Robot 独自のアセンブリの一部である変数および引数の型は非表示です。このようなアセンブリの型を参照するワークフローは、実行時に影響を受けません。非 .Net Framework アセンブリの型を使用するには、[パッケージを管理] ウィンドウを使用して、その型を依存関係としてプロジェクトに追加します。

注: 浮動小数点数リテラル (例: 10.5) を float 型の変数または引数 (System.Single) に割り当てると、ワークフローの実行時にコンパイル エラーが発生します。値を正常に割り当てるには、次のいずれかを実行します。

• サフィックス f または F を使用する (1.5f または 1.5F)
• キャスト演算子を使用する (C# の場合は (float)1.5、VB の場合は CSng(1.5))