ライブラリについて

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 です。説明を追加し、プロジェクトの対応 OS と言語を選択して、[作成] を選択します。新しいライブラリが作成され、ローカル マシンに保存されます。

   注:

   • ライブラリ名は最大 128 文字、説明は最大 500 文字です。
   • lib をライブラリ名として使用しないでください。ライブラリがインストールされているプロジェクトでコンパイル エラーが発生するためです。

3. [プロジェクト] パネルに、プロジェクト フォルダー、依存関係、実際のワークフローを含む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. 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 プロパティはサポートされていません。このプロパティの値を設定すると、引数が保存されません。[デザイナー] パネルの空白領域を選択すると、このオブジェクトが [プロパティ] パネルに表示されます。

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

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

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

• 名前 - プロジェクトの名前を編集します。

• 説明 - プロジェクトの説明を編集します。

• Automation Hub URL - URL of an Automation Hub idea linked to the project. For more information, see Linking a Project to an Idea in Automation Hub.

• プロジェクトのアイコン - 必要に応じて、プロジェクトのカスタム アイコンを定義します。ファイルを参照して選択するか、最大 1MB の ico、jpeg、jpg、または png ファイルへのパスまたはパブリック URL を入力します。

  After the project is published, the icon is displayed next to the package in the Manage Packages window in Studio.

• ソースを含める - これまで非公開になっていたワークフローを含むすべての .xaml ソースをライブラリ パッケージに含めるには、[はい] に設定します。Windows - レガシ ライブラリの場合、ファイルは生成されるアセンブリ ファイル内、および lib\net45 フォルダーの .nupkg ファイル内に保存されます。Windows およびクロスプラットフォームのライブラリの場合、ファイルは content フォルダーの .nupkg ファイル内に保存されます。

• アクティビティの数式をコンパイル - [はい] に設定すると、ライブラリ内でアクティビティの数式がすべてコンパイルされ、パッケージ化されます。これにより、実行時間が短縮されます。Windows - レガシ ライブラリでのみ使用できます。

• すぐに実行可能にする - [はい] に設定すると、実行時の JIT コンパイルを高速化するために、生成されるアセンブリを最適化します。Windows - レガシ ライブラリでのみ使用できます。

• 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 ファイルが含まれているライブラリは、正常にパブリッシュできない場合があります。
• ライブラリに同じ名前の .xaml ファイルと引数が含まれる場合、そのライブラリをパブリッシュすることはできません。
• [ワークフロー ファイルを呼び出し] アクティビティが含まれ、[分離] オプションが選択されている場合、Windows - レガシ対応のライブラリ プロジェクトをパブリッシュすることはできません。パブリッシュしようとすると、[ 出力 ] パネルにエラー メッセージが表示されます。この制限は、Windows またはクロスプラットフォーム対応のライブラリには適用されません。
• [ワークフロー ファイルを呼び出し] アクティビティを使用する際には、呼び出されるファイルがライブラリ プロジェクトと同じフォルダーにあることを確認してください。
• [ 対話型ワークフローを起動 ] アクティビティはライブラリではサポートされません。
• ライブラリ内で [ワークフロー ファイルを呼び出し ] を使用して、そのライブラリ自体を参照する機能はサポートされていません。
• If a library contains an activity that accepts a file path as input, when the component is used in a project, paths that include environment variables are interpreted as paths relative to the library folder. As a workaround, use either the Environment.GetEnvironmentVariable method or a Get Environment Folder activity to retrieve the folder path, and then use the output to construct an absolute path to pass to the reusable component.

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

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

プロジェクトへのライブラリのインストールに関する考慮事項

• Libraries can only be installed in projects that have the same compatibility.

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

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

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

• ライブラリのカスタム アクティビティを使用する場合、引数に定義された既定値は、アクティビティをワークフローに追加するときに、アクティビティの [プロパティ] パネルに自動的に入力されます。ワークフローのプロパティ フィールドの値をクリアすると、対応する既定値が実行時に使用されません。この場合、空の値が明示的に渡されます。

  これに対し、[ワークフローを呼び出し] アクティビティを使用する場合、[引数をインポート] パネルで入力を空白のままにすると、呼び出されたワークフローで定義された既定値が実行時に使用されます。