通知を受け取る

UiPath Studio

UiPath Studio ガイド

ライブラリについて

ライブラリとは、複数の再利用可能なコンポーネントを含むパッケージをいいます。ライブラリは .nupkg ファイルとして保存され、パッケージ マネージャーを使用してワークフローに対する依存関係としてインストールすることができます。

基本ライブラリの作成」ページで説明したように、たとえば、Excel スプレッドシートからデータを収集し、他の Excel スプレッドシートに追加し、ライブラリを作成することができます。次に、ライブラリをパッケージ化し、他のプロセスでアクティビティとして使用できます。

再利用可能なコンポーネントアクティビティの管理

再利用可能なコンポーネントアクティビティとは、.nupkg ファイルとしてまとめてパッケージ化される 1 つ以上のワークフローを指します。

ライブラリの作成

  1. Studio のバックステージ ビュー > [スタート] > [ライブラリ] に移動します。[新しい空のライブラリ] ウィンドウが開きます。
  2. ライブラリの名前を入力し、場所を指定します。既定の場所は C:\Users\<current_user>\Documents\UiPath です。説明を追加して [作成] を選択します。新しいライブラリが作成され、ローカル マシンに保存されます。
    メモ: ライブラリ名は 128 文字までで、説明は 500 文字までです。
  3. [プロジェクト] パネルに、プロジェクト フォルダー、依存関係、実際のワークフローを含む NewActivity.xaml がツリーで表示されます。
    ライブラリ内の各ワークフロー ファイルを、ライブラリが依存関係としてインストールされているプロジェクトのアクティビティとして使用できます。特定のファイルを非公開にする場合は、右クリックして [パブリッシュから除外] を選択します。この場合、ファイルはライブラリ パッケージには含められますが、[アクティビティ] パネルで再利用可能なコンポーネントとしては利用できません。

📘

注:

既定では、新しいライブラリで使用可能な依存関係は、[最も低い適用可能なバージョン] のランタイム ルールが適用される新しい空のプロジェクト、すなわち、UiPath.Excel.ActivitiesUiPath.Mail.ActivitiesUiPath.System.ActivitiesUiPath.UIAutomation.Activities と同じです。

アクティビティにツールチップとヘルプ リンクを追加するには、[プロジェクト] パネルでワークフロー ファイルを右クリックして、[プロパティ] を選択します。ライブラリがインストールされているプロジェクトの [アクティビティ] および [デザイナー] パネルで、アクティビティにカーソルを合わせると、ツールチップが表示されます。[デザイナー] パネルでアクティビティを選択して F1 を押すと、ヘルプ リンクが開きます。

Arguments you define in the library become activity properties in the projects where the library is installed as a dependency. Arguments that are marked as required are available in the body of the activity in the Designer panel. Annotations you add to an argument in the library are displayed as a tooltip for the property in the resulting activity's Properties panel. For more information about arguments, see Arguments Panel.

📘

注:

  • ライブラリの場合には、"" ではなく、変数に NULL 値を割り当てるために Nothing を使用することが推奨されます。これは、パッケージ化されたライブラリをプロジェクトへの依存関係として使用する場合の矛盾を回避するためです。
  • System.Activities.ActivityBuilder オブジェクトの ImplementationVersion プロパティはサポートされていません。このプロパティの値を設定すると、引数が保存されません。[デザイナー] パネルの空白領域を選択すると、このオブジェクトが [プロパティ] パネルに表示されます。

ライブラリ設定を調整する

ライブラリ プロジェクトの設定を行うには、[プロジェクト] パネルで [設定] settings_iconsettings_icon をクリックして、[プロジェクト設定] ウィンドウを開きます。

[全般] タブで、以下のオプションを利用できます。

  • 名前 - プロジェクトの名前を編集します。
  • 説明 - プロジェクトの説明を編集します。
  • Project Icon - optionally, define a custom icon for the project. You can browse to and select a file, or enter a path or public URL to an ico, jpeg, jpg, or png file up to 1MB in size.
    After the project is published, the icon is displayed next to the package in the Manage Packages window in Studio..
  • Include Sources - set to Yes to package all .xaml sources within the generated assembly file, including workflows that were previously made private. If needed, you can then decompile the assembly file and extract the workflows, which can be helpful at debug time.
  • アクティビティの数式をコンパイル - [はい] に設定すると、ライブラリとともにアクティビティの数式がすべてコンパイルされ、パッケージ化されます。その結果、実行時間が短縮されます。
  • モダン デザイン エクスペリエンス - [はい] に設定すると、UI Automation の操作のモダン エクスペリエンス (向上した新しいアクティビティ、レコーダー、ウィザード、オブジェクト リポジトリなど) が有効になります

ライブラリのパブリッシュ

ライブラリのパブリッシュはプロセスのパブリッシュと似ています。詳細については、「オートメーション プロジェクトのパブリッシュについて」を参照してください。

ライブラリをパブリッシュする際の制限事項

ライブラリをパブリッシュするときは、以下の制限事項を考慮してください。

  • NuGet の制約によるもの:
    • Windows 環境パス変数を使用して、ユーザーが制限したサブフォルダーを含む場所にライブラリをパブリッシュすることはできません。
    • パブリッシュされたライブラリのリリース ノートは、Orchestrator でのみ表示されます。
  • 名前に特殊文字を使用している .xaml ファイルが含まれているライブラリは、正常にパブリッシュできない場合があります。
  • [分離] オプションが選択された [ワークフロー ファイルを呼び出し] アクティビティを含むライブラリは、パブリッシュできません。[出力] パネルにエラー メッセージが表示されます。
  • [ワークフロー ファイルを呼び出し] アクティビティを使用する際には、呼び出されたファイルがライブラリ プロジェクトと同じフォルダーにあることを確認してください。
  • [対話型ワークフローを起動] アクティビティはライブラリではサポートされません。
  • ライブラリ内で [ワークフロー ファイルを呼び出し] を使用して、そのライブラリ自体を参照する機能はサポートされていません。

再利用可能なコンポーネントをオートメーション プロジェクトに追加する

  1. 新しいプロジェクトを開くか、作成します。
  2. [すべてのパッケージ] カテゴリで、ライブラリを保存するフィードを選択し、パッケージをインストールします。
  3. [OK] を選択します。パッケージがプロジェクト定義に追加されます。
  4. [アクティビティ] パネルのカスタム カテゴリに、このアクティビティが表示されます。

📘

注:

  • ライブラリには前方互換性があります。つまり、v2018.3 およびそれ以降の Studio で作成したプロジェクトでのみ使用できます。ライブラリは、v2018.3 より前のバージョンの Orchestrator にはパブリッシュできません。
  • 2019.10.1 以前のバージョンの Studio で作成したライブラリおよび 2019.10.1 以降のバージョンの Studio からパブリッシュしたライブラリから、カスタム アクティビティを含むプロジェクトを実行すると、エラーが発生する可能性があります。その場合は、もう一度ライブラリを作成してパブリッシュする必要があります。

ライブラリ プロジェクトで、[ワークフローをインポート] を使用してライブラリを含むワークフローを追加した場合、そのライブラリを参照する依存関係はインポートされません。

同じカスタム ライブラリの 2 つのバージョンを、Studio のプロジェクトにインポートすると、2 番目にインポートしたライブラリにのみ含まれる追加されたカスタム アクティビティは、1 番目にインポートしたライブラリを削除しないかぎり、[アクティビティ] パネルに表示されません。

2 か月前に更新


ライブラリについて


改善の提案は、API リファレンスのページでは制限されています

改善を提案できるのは Markdown の本文コンテンツのみであり、API 仕様に行うことはできません。