ライブラリとは、複数の再利用可能なコンポーネントを含むパッケージをいいます。ライブラリは .nupkg ファイルとして保存され、パッケージ マネージャーを使用してワークフローに対する依存関係としてインストールすることができます。
「基本ライブラリを作成する」に記載されているように、たとえば、Excel スプレッドシートからデータを収集して他のシートに追加するライブラリを作成できます。さらに、このライブラリをパッケージ化して他のプロセスでアクティビティとして使用できます。
再利用可能なコンポーネント アクティビティを管理する
再利用可能なコンポーネントアクティビティとは、.nupkg ファイルとしてまとめてパッケージ化される 1 つ以上のワークフローを指します。
ライブラリを作成する
- Studio のバックステージ ビュー > [スタート] > [ライブラリ] に移動します。[新しい空のライブラリ] ウィンドウが開きます。
- ライブラリの名前を入力し、場所を指定します。既定の場所は
C:\Users\<current_user>\Documents\UiPathです。説明を追加して [作成] を選択します。新しいライブラリが作成され、ローカル マシンに保存されます。
注: ライブラリ名は 128 文字までで、説明は 500 文字までです。 - [プロジェクト] パネルに、プロジェクト フォルダー、依存関係、実際のワークフローを含む
NewActivity.xamlがツリーで表示されます。
注:
既定では、新しいライブラリで使用可能な依存関係は、[最も低い適用可能なバージョン] のランタイム ルールが適用される新しい空のプロジェクト、すなわち、
UiPath.Excel.Activities、UiPath.Mail.Activities、UiPath.System.Activities、UiPath.UIAutomation.Activitiesと同じです。
[プロパティ] ウィンドウを開き、ライブラリへのツールチップ/ヘルプのリンクを追加します。
新しいアクティビティを追加した後に、[アクティビティ] パネルでヒントが表示されます。選択したアクティビティで F1 キーを押すと、ヘルプ リンクが開きます。
テンプレートを使用して新しいライブラリを作成する際、そのテンプレートに Main.xaml ファイルが含まれていない限り、デザイナーパネルは自動的に .xaml ファイルを開きません。
ライブラリの使用された引数に注釈を追加して、後でアクティビティの [プロパティ] パネルにツールチップとして表示します。引数に注釈を追加する方法についての詳細は、「引数パネル」をご覧ください。
注:
ライブラリの場合には、
""ではなく、変数に NULL 値を割り当てるためにNothingを使用することが推奨されます。これは、パッケージ化されたライブラリをプロジェクトへの依存関係として使用する場合の矛盾を回避するためです。
ライブラリ設定の調整
ライブラリ プロジェクトごとに、一連の設定を個別に作成できます。これらの設定は [プロジェクト設定] ウィンドウで行えます。[プロジェクト設定] ウィンドウを開くには、[プロジェクト] パネルの 
をクリックします。
[プロジェクト設定] ウィンドウでは、ライブラリの名前と説明を変更できます。[ソースを含む] トグルを [はい] に設定して、生成したアセンブリ ファイル内のすべての.xaml ソース (以前非公開にしていたワークフローを含む) をパッケージ化します。
ライブラリをパブリッシュする
- [デザイン] リボン タブで、[パブリッシュ] を選択します。[ライブラリをパブリッシュ] ウィンドウが表示されます。
- [パブリッシュする場所] カテゴリで、ライブラリを Orchestrator、カスタム NuGet フィード、またはローカル マシンにパブリッシュするように設定します。API キーを使用して、カスタム NuGet フィードを認証できます。
ライブラリが Orchestrator にパブリッシュされると、[設定] ページの設定に従って、ホスト フィードまたはテナント フィードに格納されます。ライブラリ フィードについて詳しくは、こちらをご覧ください。
注:
NuGet の制限により、Windows 環境パス変数を使用して、ユーザーが制限したサブフォルダーを含む場所にライブラリをパブリッシュすることはできません。
- [リリース ノート] カテゴリに、バージョンの詳細とその他の関連情報を入力します。パブリッシュ済みプロジェクトのリリース ノートは、Orchestrator の [パッケージ] セクションに表示されます。[リリース ノート] フィールドには、10,000 文字まで入力できます。
- プロジェクトに新しいバージョンを追加し、必要に応じて [プレリリース] ボックスのチェックをオンにして、バージョンを
alphaとしてマークします。これにより、プロジェクトのバージョン スキーマが自動的にセマンティックに変更されます。ファイルの新しいバージョンをローカルにパブリッシュする場合、指定する場所に同じバージョン番号のファイルが含まれていないことを確認してください。プロジェクトのバージョン管理について詳しくは「オートメーション プロジェクトについて」をご覧ください。
注:
NuGet v3 の制約により、パブリッシュされたライブラリのリリース ノートは、Orchestrator でのみ表示されます。
- [ライブラリ設定] カテゴリで、[アクティビティ ルート カテゴリ] に名前を設定するか、既定のライブラリ名をそのまま使用します。[アクティビティ] パネルで、再利用可能なコンポーネントの新しいカテゴリが作成されます。以前に設定したルート カテゴリはドロップダウン リストに記憶されます。
- [ソースを含む] の横にあるチェック ボックスをオンにして、以前非公開にしていたワークフローを含め、すべての
.xamlソースをこの生成したアセンブリ ファイルにパッケージ化します。これは、ワークフローをデバッグする際に役立ちます。 - [証明書署名] セクションで、[証明書] ボックスの横にローカル証明書のパスを追加します。さらに、必要に応じて、[証明書のパスワード] と [オプションの証明書のタイムスタンパー] を追加します。詳細については、「パッケージの署名」ページをご覧ください。
注:
現在、プロジェクトの署名では、証明書の拡張子として
.pfxおよび.p12のみが認められています。
- [パブリッシュ] を選択します。プロジェクト フォルダー全体が
.nupkgファイルにアーカイブされ、Orchestrator、カスタム NuGet フィードにアップロードされるか、ローカル ディレクトリに保存されます。 - プロジェクトが正常にパブリッシュされると、[情報] ダイアログが表示されます。これには、次が含まれます。
- パッケージが Orchestrator またはローカルにパブリッシュされる名前。
- パブリッシュされたパッケージのバージョン番号
- プロジェクトがパブリッシュされた場所 (プロジェクトがローカルにパブリッシュされた場合)
- [クリップボードにコピー] オプション
ライブラリをパブリッシュする際の制限事項
次の制限事項によって、ライブラリ プロジェクトのパブリッシュが阻まれます。
- 名前に特殊文字を使用している
.xamlファイルが含まれているライブラリは、正常にパブリッシュできない場合があります。 - [分離] オプションが選択された [ワークフロー ファイルを呼び出し] アクティビティを含むライブラリは、パブリッシュできません。[出力] パネルにエラー メッセージが表示されます。
- [ワークフロー ファイルを呼び出し] アクティビティを使用する際には、呼び出されるファイルがライブラリ プロジェクトと同じフォルダーにあることを確認してください。
- [対話型ワークフローを起動] アクティビティはライブラリではサポートされません。
- ライブラリ内で [ワークフロー ファイルを呼び出し] を使用して、そのライブラリ自体を参照する機能はサポートされていません。
再利用可能なコンポーネントをオートメーション プロジェクトに追加する
- 新しいプロジェクトを開くか、作成します。
- [すべてのパッケージ] カテゴリで、ライブラリを保存するフィードを選択し、パッケージをインストールします。
- [OK] を選択します。パッケージがプロジェクト定義に追加されます。
- [アクティビティ] パネルのカスタム カテゴリに、このアクティビティが表示されます。
注:
ライブラリには前方互換性があります。つまり、v2018.3 およびそれ以降の Studio で作成したプロジェクトでのみ使用できます。ライブラリは、v2018.3 より前のバージョンの Orchestrator にはパブリッシュできません。
ライブラリ プロジェクトで、[ワークフローをインポート] を使用してライブラリを含むワークフローを追加した場合、そのライブラリで参照される依存関係はインポートされません。
同じカスタム ライブラリの 2 つのバージョンを、Studio のプロジェクトにインポートすると、2 番目にインポートしたライブラリにのみ含まれる追加されたカスタム アクティビティは、1 番目にインポートしたライブラリを削除しないかぎり、[アクティビティ] パネルに表示されません。
2 年前に更新