クイックスタートガイド

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

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

コード化されたオートメーションは、ドラッグアンドドロップアクティビティの代わりにコードを使用して作成されたオートメーションです。コード化されたオートメーションを開発するときには、UiPath サービス (アクティビティパッケージと同一)、API (アクティビティに類似)、外部の .NET NuGet パッケージ、およびカスタム C# クラスを UiPath Studio で使用できます。これにより、外部システム、データベース、API、その他のサービスとの統合が容易になります。コード化されたオートメーションには、以下の 3 種類があります。

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

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

シナリオ

このチュートリアルでは、RandomNumber API を使用して、指定した範囲内のランダムな 10 進数を生成します。次に、IsEven という名前のカスタムメソッドを使用して、生成された数値が偶数かどうかを確認し、その条件に基づいて加算または減算を実行します。

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

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

Testing.Activities 23.10 をインストールします。このシナリオでは、Testing サービスの RandomNumber API を使用する必要があるからです。
[新規] を選択してコード化されたワークフローを作成し、[ファイル] グループから [コード化されたワークフロー] を選択します。
コード化されたオートメーションは、名前空間、ヘルパークラス、およびエントリポイントメソッドで構成されます。基本クラス 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() メソッドの外部) で作成できます。
Execute メソッド内では、RandomNumber API を使用して、ランダムな値を持つ 2 つの decimal 変数を作成し、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}");
```
注: UiPath サービスを通じて利用可能な API、その他のカスタム C# クラス、または nuget.org フィードから利用可能な .NET クラスライブラリを使用して、コードを記述するのと同様に、コード化されたオートメーションを記述します。コード化されたオートメーションでは、サービスはローコードのオートメーションで使用されるアクティビティパッケージに相当します。これらのサービス (たとえば、System.Activities、UiAutomation.Activities、Testing.Activities) には、コード化されたオートメーションの構築に使用できる API が付属しています。

両方の数値が偶数の場合はオートメーションがそれらを合計するという条件で、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 フィードにアップロードされるか、ローカルディレクトリに保存されます。