ライブラリについて

A library is a project which contains one or more workflows that can be reused as activities in other projects. Libraries are saved as NUPKG files when published and can be installed as dependencies from the Package Manager.

For example, you could create a library that collects data from an Excel spreadsheet and appends it to another, as explained in the Creating a Basic Library page. Next, the library can be packaged and used in other processes as an activity.

ライブラリを作成する

1. Studio の Backstage ビュー > [スタート] > [ライブラリ] に移動します。[新しい空のライブラリ] ウィンドウが開きます。
2. ライブラリの名前を入力し、場所を指定します。既定の場所は C:\Users\<current_user>\Documents\UiPath です。説明を追加して [作成] を選択します。新しいライブラリが作成され、ローカル マシンに保存されます。

注:

ライブラリ名は最大 128 文字、説明は最大 500 文字です。

1. [プロジェクト] パネルに、プロジェクト フォルダー、依存関係、実際のワークフローを含むNewActivity.xamlがツリーで表示されます。

   ライブラリ内の各ワークフロー ファイルを、ライブラリが依存関係としてインストールされているプロジェクトのアクティビティとして使用できます。特定のファイルを非公開にする場合は、右クリックして [パブリッシュから除外] を選択します。この場合、ファイルはライブラリ パッケージには含められますが、[アクティビティ] パネルで再利用可能なコンポーネントとしては利用できません。

   注:

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

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

Arguments you define in the library become activity properties in the projects where the library is installed as a dependency. 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 プロパティはサポートされていません。このプロパティの値を設定すると、引数が保存されません。[デザイナー] パネルの空白領域を選択すると、このオブジェクトが [プロパティ] パネルに表示されます。

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

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

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

• 名前 - プロジェクトの名前を編集します。
• 説明 - プロジェクトの説明を編集します。
• ソースを含める - [はい] に設定すると、これまで非公開になっていたワークフローを含むすべての .xaml ソースが、生成されるアセンブリ ファイル内にパッケージ化されます。必要に応じて、その後アセンブリ ファイルを逆コンパイルして、デバッグ時に役立つ可能性のあるワークフローを抽出できます。
• アクティビティの数式をコンパイル - [はい] に設定すると、ライブラリとともにアクティビティの数式がすべてコンパイルされ、パッケージ化されます。その結果、実行時間が短縮されます。
• すぐに実行可能にする - [はい] に設定すると、実行時の JIT コンパイルを高速化するために、生成されるアセンブリを最適化します。
• Modern Design Experience - set to Yes to enable a modern experience of working with UI Automation, including new and improved activities, recorders, and wizards, as well as the Object Repository.

ライブラリをパブリッシュする

Publishing libraries is similar to publishing processes. For more information, see About Publishing Automation Projects.

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

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

• NuGet の制約によるもの:
  • Windows 環境パス変数を使用して、ユーザーが制限したサブフォルダーを含む場所にライブラリをパブリッシュすることはできません。
  • パブリッシュされたライブラリのリリース ノートは、Orchestrator でのみ表示されます。
• 名前に特殊文字を使用している .xaml ファイルが含まれているライブラリは、正常にパブリッシュできない場合があります。
• Libraries containing Invoke Workflow File activities with the Isolated option selected cannot be published. An error message is displayed in the Output panel.
• [ワークフロー ファイルを呼び出し] アクティビティを使用する際には、呼び出されるファイルがライブラリ プロジェクトと同じフォルダーにあることを確認してください。
• [ 対話型ワークフローを起動 ] アクティビティはライブラリではサポートされません。
• ライブラリ内で [ワークフロー ファイルを呼び出し ] を使用して、そのライブラリ自体を参照する機能はサポートされていません。

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

1. 新しいプロジェクトを開くか、作成します。

2. [すべてのパッケージ] カテゴリで、ライブラリを保存するフィードを選択し、パッケージをインストールします。

3. [OK] を選択します。パッケージがプロジェクト定義に追加されます。

4. [アクティビティ] パネルのカスタム カテゴリに、このアクティビティが表示されます。

   注:

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

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

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