引数を管理する

引数は、プロジェクト間でデータの受け渡しをする場合に使用するものです。データを動的に格納して渡すので、広い意味では変数に似ています。変数はアクティビティ間でデータを渡しますが、引数はオートメーション間でデータを渡します。これにより、特定のプロジェクトを何度でも再利用することが可能になります。

Studio supports a large number of argument types, which coincide with the types of variables. Therefore, you can create Generic Value, String, Boolean, Object, Array, or DataTable arguments and you can also browse for .Net types, just as you do in the case of variables.

Additionally, arguments have specific directions (In, Out, In/Out, Property) that tell the application where the information stored in them is supposed to go.

重要:

• 同じ名前の変数と引数がある場合、実行時には常に既定で変数が使用されます。
• 分離されていない [ ワークフロー ファイルを呼び出し] アクティビティに複雑な入力引数 (たとえば、 System.Data.DataTable 型) を渡すと、参照が渡されたかのように機能します。つまり、呼び出されるワークフロー内のオブジェクトに変更を加えると、メイン ワークフロー内のオブジェクトが変更されます。既定の引数の型 (たとえば、 Boolean など) は常に値として渡されます。

Please take into consideration that if you create an In/Out argument with an In value when used in the Invoke Workflow activity, and then change the value to Out, you may notice that an error is thrown when executing the project. This is because the Invoke Workflow activity did not return the values by reference. Use a Global Handler in your project to get access to the exact values the arguments had inside the invoked workflow.

最後に、これらの引数は Orchestrator でも公開されているため、社内の他のツールと連携できます。これは、作成したプロセスが、Orchestrator API またはインターフェイスを介して入力パラメーターを受け取ること、および上記のすべてのツールに出力を返すことを意味します。詳しくは、こちらをご覧ください。

引数を作成する

Argument names should be in upper CamelCase with a prefix stating the argument direction, such as in_DefaultTimeout, in_FileName, out_TextResult, io_RetryNumber. You can check out our Workflow Design Naming Conventions recommendations for more details.

データ マネージャーから

1. データ マネージャーを開き、[新規] > [新しい引数] を選択します。
2. 新しい項目が既定の名前 argument で [引数] の下に追加されます。
3. 作成した引数を設定します。
   • 引数名をクリックして名前を編集します。
   • 左側にある矢印を使用して引数を展開し、[方向]、[データ型]、[必須] かどうか、および任意で [既定値] を設定します。

データ マネージャーから、[引数] ノードを右クリックして [引数を一括作成] を選択して、複数の引数を一括で作成することもできます。新しいウィンドウが表示され、複数の引数を追加および設定できます。

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

1. [アクティビティ] パネルで、アクティビティをデザイナー パネルにドラッグします。フィールドを右クリックし、コンテキスト メニューから [入力引数を作成] または [出力引数を作成] を選択します。または、Ctrl+M または Ctrl+Shift+M を押します。[引数を設定] フィールドが表示されます。
2. 名前を入力して Enter キーを押します。引数が作成され、フィールドに表示されます。方向と型は [引数] パネルで確認します。

式から

引数を、アクティビティの入力フィールドまたは式エディターで直接作成する方法もあります。

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

2. 名前を入力して Enter キーを押します。引数が作成されます。型と方向は [引数] パネルで確認します。

   

この方法で作成された引数は、アクティビティに応じて型を自動的に受け取ります。たとえば、[範囲に書き込み] アクティビテイの [Data Table] フィールドで引数を作成した場合、変数の型は DataTableに設定されます。[1 行を書き込み] アクティビテイの [Text] フィールドで引数を作成した場合、変数の型は Stringに設定されます。

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

1. 任意のアクティビティの [プロパティ] パネルで、編集可能なフィールドを右クリックし、コンテキスト メニューから [入力引数を作成] または [出力引数を作成] を選択します。または、Ctrl+M または Ctrl+Shift+M を押します。[引数を設定] フィールドが表示されます。
2. 名前を入力して Enter キーを押します。引数が作成され、フィールドに表示されます。方向と型は [引数] パネルで確認します。

選択したプロパティに応じて引数の型が自動的に生成されます。

[引数] パネルから

1. デザイナー パネルで、[引数] をクリックします。[引数] パネルが表示されます。

2. [引数を作成] 行を作成し、名前を入力します。新しい引数が作成されます。

   注:

   既定では、引数はすべて String 型で、[入力] 方向を持ちます。

引数を削除する

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

データ マネージャーから

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

[引数] パネルから

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

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

   

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

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