クイックスタート ガイド

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

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

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

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

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

シナリオ

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

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

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

1. Testing.Activities 23.10 をインストールします。このシナリオでは、Testing サービスの RandomNumber のコード化されたオートメーション API を使用する必要があるからです。
2. [新規] を選択してコード化されたワークフローを作成し、[ファイル] グループから [コード化されたワークフロー] を選択します。

コード化されたオートメーションは、名前空間、ヘルパー クラス、およびエントリ ポイント メソッドで構成されます。基本クラス CodedWorkflow は、コード化されたワークフローとテスト ケースの両方に使用され、必要なインターフェイスやサービスにアクセスできるようにします。エントリ ポイント メソッド (Execute()) は、これらのオートメーションを実行するうえで極めて重要であり、入力および出力引数を使用してカスタマイズできます。

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

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

1. コード化されたワークフロー内 (ただし、Execute() メソッドの外部) で、IsEven という名前のカスタム メソッドを作成します。

このメソッドは、入力された decimal 変数が偶数かどうかを表す boolean 値を返します。

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

private bool IsEven(decimal number)
        {
           // Check if a decimal number is even
        return (number % 2 == 0);
        }

ヒント:

カスタム メソッドを別の コード ソース ファイル内に作成したくない場合は、コード化されたワークフローまたはコード化されたテスト ケース内で作成できますが、 Execute() メソッドの外部で作成できます。

2. 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}");

注:

Write coded automations using UiPath services, custom C# classes, and .NET libraries from nuget.org. In coded automations, services function like activity packages in low-code automations. Key services include System.Activities, UiAutomation.Activities, and Testing.Activities.

3. Create an If statement that adds the numbers if both are even, or subtracts them if at least one is odd. Print both results to the console using 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}");
        }

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

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

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

   

ワークフロー アナライザーについては、「 ワークフロー アナライザーについて 」をご覧ください。2. [ デバッグ] リボンで、[ ファイルをデバッグ ] を選択してコード化されたワークフロー ファイルをデバッグし、実行時の不整合の有無を確認します。

3. [デバッグ] リボンまたは [デザイン] リボンで、[ファイルをデバッグ]、[ファイルを実行] の順に選択して、作成したコード化されたワークフロー ファイルを実行します。
4. [デザイン] リボンで [パブリッシュ] を選択します。 [プロセスをパブリッシュ] ダイアログが表示されます。
5. [ パブリッシュのオプション] タブで、プロジェクトをパブリッシュする場所を選択します。利用可能なオプションは、パブリッシュするプロジェクトの種類によって異なります。

プロセスの場合:

• [Orchestrator テナント プロセス フィード]、[Orchestrator 個人用ワークスペース フィード]
• Assistant (Robot の既定) - Robot と Assistant の既定のパッケージの場所です (C:\ProgramData\UiPath\Packages)。ここにパブリッシュされたプロジェクトは自動的に Assistant に表示されます。Studio が Orchestrator に接続されている場合、このオプションは使用できません。 これらのオプションを使用できるのは、Studio が Orchestrator に接続されている場合です。
• カスタム - カスタム NuGet フィードの URL またはローカル フォルダー。任意で API キーを追加できます。

6. [パブリッシュ] を選択します。 .nupkg ファイルが作成され、Orchestrator とカスタム NuGet フィードにアップロードされるか、ローカル ディレクトリに保存されます。

サンプル プロジェクト

この手順に従ってチュートリアルを自分で試してみるには、サンプル プロジェクト「First Coded Workflow (初めてのコード化されたワークフロー)」をダウンロードします。

次のステップ

コード化されたオートメーションについて詳しくは、以下のページをご覧ください。

• Studio IDE
• 入力引数と出力引数を使用する
• ベスト プラクティス
• コード化されたオートメーションを使用する
• チュートリアル