Studio ガイド

最終更新日時 2025年6月4日

クイックスタートガイド

このクイックスタートガイドは、コード化されたオートメーションの使用を開始するのに役立ちます。チュートリアルでは、1 から 100 までの乱数を生成し、数値が偶数か奇数かに基づいて加算または減算演算を実行するコード化されたワークフローの作成方法を説明しており、それに従って、コード化されたオートメーションの作成方法を学習できます。

コード化されたオートメーションとは

Coded automations are automations created using code, instead of drag-and-drop activities. When developing coded automations, you can use UiPath services (equal to activity packages), coded automation APIs (similar to activities), external .NET NuGet packages, and your custom C# classes in UiPath Studio. This makes it easy to integrate with external systems, databases, APIs, and other services. Coded automations can be of three types:

コード化されたワークフロー - コードでワークフローを設計するために使用されます。
コード化されたテストケース - テストケースの設計に使用します。
コードソースファイル - 他の種類のコード化されたファイルで後から呼び出すことのできるコードを作成するために使用します。

詳しくは、「はじめに」のコード化されたオートメーションの説明をご覧ください。

シナリオ

In this tutorial we use the RandomNumber coded automation API to generate random decimal numbers within the specified range. We then check if the generated numbers are even, using a custom method named IsEven, and perform addition or subtraction based on that condition.

コード化されたワークフローを作成する

Studio プロジェクト内にコード化されたワークフローを作成し、必要な依存関係をインストールします。

Install Testing.Activities 23.10, because the scenario involves using the RandomNumber coded automation API from the Testing service.
[新規] を選択してコード化されたワークフローを作成し、[ファイル] グループから [コード化されたワークフロー] を選択します。
コード化されたオートメーションは、名前空間、ヘルパークラス、およびエントリポイントメソッドで構成されます。基本クラス CodedWorkflow は、コード化されたワークフローとテストケースの両方に使用され、必要なインターフェイスやサービスにアクセスできるようにします。エントリポイントメソッド (Execute()) は、これらのオートメーションを実行するうえで極めて重要であり、入力および出力引数を使用してカスタマイズできます。

コード化されたワークフローを設計する

Studio IDE でコードを記述します。Studio IDE は、専用のコードエディター、ファイルタブ、階層リンクで構成されており、簡単にナビゲーションできます。

コード化されたワークフロー内 (ただし、Execute() メソッドの外部) で、IsEven という名前のカスタムメソッドを作成します。
このメソッドは、入力された decimal 変数が偶数かどうかを表す boolean 値を返します。
コードの例は以下のとおりです。
```
private bool IsEven(decimal number)
        {
           // Check if a decimal number is even
        return (number % 2 == 0);
        } private bool IsEven(decimal number)
        {
           // Check if a decimal number is even
        return (number % 2 == 0);
        }
```
ヒント: 別のコードソースファイルでカスタムメソッドを作成しない場合は、コード化されたワークフローまたはコード化されたテストケース内 (ただし、Execute() メソッドの外部) で作成できます。
Inside the Execute method use the RandomNumber coded automation API to create two decimal variables with a random value, and print them out in the console using Console.WriteLine.
コードの例は以下のとおりです。
```
// Generate random numbers within a specified range (e.g., 1 to 100)
        decimal num1 = testing.RandomNumber(1, 100);
        decimal num2 = testing.RandomNumber(1, 100);
            
        Console.WriteLine($"Generated numbers: {num1} and {num2}");// Generate random numbers within a specified range (e.g., 1 to 100)
        decimal num1 = testing.RandomNumber(1, 100);
        decimal num2 = testing.RandomNumber(1, 100);
            
        Console.WriteLine($"Generated numbers: {num1} and {num2}");
```
Note: You write coded automations like you would write code, using coded automation APIs available through UiPath services, and other custom C# classes, or .NET class libraries available from the nuget.org feed. In coded automations, services are equivalent to activity packages used in low-code automations. These services, such as System.Activities, UiAutomation.Activities, and Testing.Activities, come with coded automation APIs that you can use for building coded automations.

両方の数値が偶数の場合はオートメーションがそれらを合計するという条件で、If ステートメントを作成します。Else 句では、少なくとも一方が奇数である場合に数値を減算します。いずれの結果も、Console.WriteLine を使用してコンソールに出力されます。

コードの例は以下のとおりです。

if (IsEven(num1) && IsEven(num2))
        {
            // Both numbers are even, so add them together
            decimal sum = num1 + num2;
            Console.WriteLine($"Both numbers are even. Sum: {sum}");
        }
        else
        {
            // At least one number is odd, so subtract them
            decimal difference = num1 - num2;
            Console.WriteLine($"At least one number is odd. Difference: {difference}");
        } if (IsEven(num1) && IsEven(num2))
        {
            // Both numbers are even, so add them together
            decimal sum = num1 + num2;
            Console.WriteLine($"Both numbers are even. Sum: {sum}");
        }
        else
        {
            // At least one number is odd, so subtract them
            decimal difference = num1 - num2;
            Console.WriteLine($"At least one number is odd. Difference: {difference}");
        }

コード化されたワークフロープロセスの管理

コード化されたワークフローを作成および設計したら、ワークフローアナライザーを使用してワークフローを検証、デバッグ、および実行して、Orchestrator にパブリッシュできます。

[デザイン] リボンで、[ファイルを分析]、[ファイルを検証] の順にクリックして、コード化されたワークフローファイルに C# コンパイラエラーがないかどうかを確認します。

ワークフローアナライザーについては、「ワークフローアナライザーについて」をご覧ください。
[デバッグ] リボンで、[ファイルをデバッグ] をクリックしてコード化されたワークフローファイルをデバッグし、実行時の不整合の有無を確認します。
[デバッグ] リボンまたは [デザイン] リボンで、[ファイルをデバッグ]、[ファイルを実行] の順にクリックして、作成したコード化されたワークフローファイルを実行します。
[デザイン] リボンで [パブリッシュ] を選択します。
[プロセスをパブリッシュ] ダイアログが表示されます。
[パブリッシュのオプション] タブで、プロジェクトをパブリッシュする場所を選択します。利用可能なオプションは、パブリッシュするプロジェクトの種類によって異なります。
プロセスの場合:
- [Orchestrator テナントプロセスフィード]、[Orchestrator 個人用ワークスペースフィード]
- Assistant (Robot の既定) - Robot と Assistant の既定のパッケージの場所です (C:\ProgramData\UiPath\Packages)。ここにパブリッシュされたプロジェクトは自動的に Assistant に表示されます。Studio が Orchestrator に接続されている場合、このオプションは使用できません。これらのオプションを使用できるのは、Studio が Orchestrator に接続されている場合です。
- カスタム - カスタム NuGet フィードの URL またはローカルフォルダー。任意で API キーを追加できます。
[パブリッシュ] をクリックします。
.nupkg ファイルが作成され、Orchestrator とカスタム NuGet フィードにアップロードされるか、ローカルディレクトリに保存されます。