オートメーション プロジェクトのパブリッシュとは、プロジェクト フォルダーをロボットに送信して実行できるようアーカイブすることです。

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

オートメーション プロジェクトは Orchestrator、カスタム NuGet フィード、またはローカルにパブリッシュできます。Orchestrator にパブリッシュすると、アーカイブされたプロジェクトが [パッケージ] ページに表示され、ロボットに配布されるプロセスを作成できます。オートメーション プロセスを Orchestrator の個人用ワークスペースにパブリッシュするか、テスト ケースをパブリッシュすると、プロセスが存在しない場合は自動的に作成され、既存のプロセスが最新のパブリッシュ バージョンに自動更新されます。

さらに、オートメーション プロジェクトは、カスタム NuGet フィードにパブリッシュできます。フィードで認証が必要な場合には、API キーを追加するオプションも提供されます。

Publishing projects locally requires you to provide a path on the local machine, different than the location where process packages are published. From here, you can later manually send the packages to the Robots, so they can be executed. The default local publish location is %ProgramData%\UiPath\Packages です。

To publish a project, the project.json and design.json files in the project folder must not be in a read-only location (for example, if the project is under source control, the files must be checked out for editing).

You can publish projects from Studio or from the command line. To update dependencies for multiple projects and publish them all at once, use the Project Dependencies Mass Update Tool.

プロジェクトを Studio からパブリッシュする

プロジェクトをパブリッシュするには、Studio の [デザイン] タブのリボンで [パブリッシュ] を選択します。

オートメーション プロジェクトをパブリッシュするには、次の操作を行います。

1. Studio で、新しいプロジェクトを作成します。
2. [デザイン] リボン タブの [パブリッシュ] をクリックします。[パブリッシュ] ウィンドウが表示されます。コンテキストに応じてウィンドウのタイトル バーが変化することを確認してください。
   • [プロセスをパブリッシュ] - プロセスをパブリッシュする場合
   • [ライブラリをパブリッシュ] - ライブラリ プロジェクトをパブリッシュする場合
   • [UI ライブラリをパブリッシュ] - UI ライブラリ プロジェクトをパブリッシュする場合
   • [テスト ケースをパブリッシュ] - テスト ケースをパブリッシュする場合
   • [テンプレートをパブリッシュ] - テンプレートをパブリッシュする場合
3. [パッケージのプロパティ] タブで以下の操作を実行します。
   • パッケージの名前を入力します。ドロップダウン リストには、最近パブリッシュしたパッケージの名前が最大 5 つ表示されます。
   • In the Version section, review the Current Version of your project, and type a New Version if needed. Check the Is Prerelease box to mark the version as alpha. Please note that this automatically changes the project’s version schema to semantic. When publishing a new version of the file locally, make sure that the custom location does not already include a file with the same proposed version number. For more details about project versioning, check the About Automation Projects page.
   • Optionally, use the Project Icon option to define a custom icon for the project. You can browse to and select a file, or enter a path or public URL to a jpeg jpg, or png file up to 1MB in size.
     プロジェクトがパブリッシュされると、アイコンは次のように表示されます。
     • プロセスの場合、プロセス リストで特定しやすいように、Assistant でプロセス名の横に表示されます。
     • テンプレートの場合、[ホーム] (Studio の Backstage ビュー) > [テンプレート] でテンプレートの横に表示されます。
     • ライブラリの場合、Studio の [パッケージを管理] ウィンドウでパッケージの横に表示されます。
       Orchestrator または埋め込みアイコンがサポートされていないフィードにパブリッシュするライブラリのアイコンとしてローカル ファイルを使用すると、アイコンは [パッケージを管理] に表示されません。この場合は、URL を使用してアイコンを指定します。
   • In the Project tags box, you can add one or more tags to the project, either by creating new ones or by reusing tags already defined in Orchestrator. There are two types of tags: labels and properties (key-value pairs). Tags are included in the published package and they help describe and categorize projects. For example, they can refer to the automated application (an Excel label) or the department (a department:accounting key-value property).
     When you start typing, possible matches are suggested from already defined tags, and you can reuse one by selecting it from the list of matches. For a property match, the key followed by the : (colon) character is displayed first, and the associated values are displayed after you select the key,
     To add a new tag, after you enter the name, click the entry with the plus sign next to the name. Separating strings with the : (colon) character enables you to add properties, while entries that don't contain a : add labels.
     Labels and key-value properties are limited to 256 characters. Tag names can't contain these characters: < > % & \ ? / : です。
     プロジェクト タグは Orchestrator のプロセスに自動的に適用できます。タグの使用について詳しくは、『UiPath Orchestrator ガイド』の「タグを使用してリソースを整理する」をご覧ください。
   • [リリース ノート] テキスト ボックスには、バージョンなどの関連情報の詳細を入力します。パブリッシュしたプロジェクトのリリース ノートは、Orchestrator の [パッケージ] セクションに表示されます。[リリース ノート] フィールドには、最大 10,000 文字まで入力できます。

4. [次へ] をクリックします。
   テンプレートをパブリッシュしている場合は、次の手順 (手順 5) で [テンプレート情報] タブが開きます。それ以外の場合には、手順 6 に進みます。
5. (テンプレートの場合のみ) [テンプレート情報] タブで以下の情報を入力し、[次へ] をクリックします。
   • 名前 - テンプレートの名前です。
   • 説明 - [テンプレート] タブのテンプレートの説明です。
   • 既定のプロジェクト名 - このテンプレートを使用する新しいプロジェクトを作成する際の既定のプロジェクト名です。
     注: 句読点、区切り文字、およびファイル名に使用できない文字の使用を避けてください。これらの文字は、テンプレートを使用するときに既定の名前から削除される場合があります。
   • 既定のプロジェクトの説明 - このテンプレートを使用する新しいプロジェクトを作成する際の既定のプロジェクトの説明です。

6. [パブリッシュのオプション] タブで、プロジェクトをパブリッシュする場所を選択します。利用可能なオプションは、パブリッシュするプロジェクトの種類によって異なります。

   • プロセス の場合 (StudioX プロジェクトを含む):
     • Orchestrator テナント プロセス フィード、Orchestrator 個人用ワークスペース フィード、および別のパッケージ フィードを持つ第 1 レベルのフォルダーまたはそのいずれかのサブフォルダーが Studio のステータス バーのフォルダー メニューから選択されている場合は、そのフォルダー階層のフィード。これらのオプションを使用できるのは、Studio が Orchestrator に接続されている場合です。Orchestrator 個人用ワークスペース フィードを使用できるのは、ユーザーが Orchestrator で個人用ワークスペース機能を有効化した場合のみです。
       Studio で個人用ワークスペースまたは別のパッケージ フィードを持つ階層のフォルダーが選択されている場合、そのフォルダーのフィードが既定のオプションになります。それ以外の場合は、テナント フィードが既定のオプションです。現在のセッションで既にプロジェクトをパブリッシュした場合は、Studio を閉じるか、Studio のステータス バーから Orchestrator フォルダーを変更するまで、最後にパブリッシュに使用した場所が既定で選択されます。
     • Assistant (Robot Defaults) - the default package location for the Robot and Assistant, C:\ProgramData\UiPath\Packages. Projects published here automatically appear in the Assistant. The option is not available if Studio is connected to Orchestrator.
     • カスタム - カスタム NuGet フィードの URL またはローカル フォルダー。任意で API キーを追加できます。
   • テスト ケースの場合:
     • Orchestrator 個人用ワークスペース フィードを除いて、プロセスの場合と同じオプションを利用可能です。
   • ライブラリおよび UI ライブラリの場合:
     • Orchestrator テナント ライブラリ フィードまたは Orchestrator 共有ライブラリ フィード - Studio が Orchestrator に接続している場合に利用できます。利用可能なオプションは、Orchestrator でテナント ライブラリ フィードが有効化されているかどうかによって異なります。
     • カスタム - カスタム NuGet フィードの URL またはローカル フォルダー。任意で API キーを追加できます。
   • テンプレートの場合:
     • Orchestrator テナント ライブラリ フィードまたは Orchestrator 共有ライブラリ フィード - Studio が Orchestrator に接続している場合に利用できます。利用可能なオプションは、Orchestrator でテナント ライブラリ フィードが有効化されているかどうかによって異なります。
     • Local - the location for publishing templates locally, by default: C:\Users\User\Documents\UiPath\.templates です。
     • カスタム - カスタム NuGet フィードの URL またはローカル フォルダー。任意で API キーを追加できます。

   ライブラリ、またはテンプレート以外の Windows またはクロスプラットフォームに対応したプロジェクトをパブリッシュする場合は、[コンパイル設定] の [パブリッシュのオプション] タブで追加の設定を行えます。

   • (ライブラリの場合のみ) アクティビティ ルート カテゴリ - [アクティビティ] パネルの、再利用可能なコンポーネントのリストが表示されるカテゴリの名前を入力します。
   • Include Sources - select this option to package all .xaml sources within the published package, including workflows that were previously made private. For Windows - Legacy libraries, the files are saved in the generated assembly file and in the lib\net45 folder in the .nupkg file. For Windows and cross-platform libraries and processes, the files are saved in the content folder in the .nupkg file.
   • (Windows レガシ ライブラリの場合のみ) アクティビティの数式をコンパイル - このオプションを選択すると、アクティビティの数式がすべてコンパイルされ、パッケージ化されます。その結果、実行時間が短縮されます。

• (For Windows - legacy libraries only) すぐに実行可能にする - このオプションを選択すると、実行時の JIT コンパイルを高速化するために、生成されるアセンブリを最適化します。
  注: ライブラリのパブリッシュが成功しない場合に考えられる原因については、「ライブラリをパブリッシュする際の制限事項」をご覧ください。

7. [次へ] をクリックして [証明書の署名] タブに進むか、[パブリッシュ] に進んでプロジェクトをパブリッシュします。
8. (任意) [証明書の署名] タブで、[証明書] ボックスの横にあるローカルの証明書のパスを追加します。さらに、必要に応じて、[証明書のパスワード] とオプションの証明書の [タイムスタンプ局] を追加します。詳しくは「パッケージの署名」をご覧ください。

📘

注:

Currently .pfx and .p12 certificate extensions are accepted for signing projects.

9. [パブリッシュ] をクリックします。.nupkg ファイルが作成され、Orchestrator とカスタム NuGet フィードにアップロードされるか、ローカル ディレクトリに保存されます。プロジェクトに応じて、パッケージには以下が含まれます。
   • Windows - レガシ対応のテンプレート プロジェクトとプロセスの場合、プロジェクト ソース ファイル。
   • Windows またはクロスプラットフォームに対応したライブラリおよびプロジェクトの場合、コンパイルされた DLL ファイル。
10. If the project is published successfully, the Info dialog box is displayed and the project is copied to the NuGet location set in the NuGetServerUrl parameter, in the UiPath.settings file.

[情報] ダイアログ ボックスには次の情報が表示されます。

• パブリッシュしたパッケージの名前。
• パブリッシュされたパッケージのバージョン番号
• プロジェクトがローカルまたは Robot の既定にパブリッシュされた場合、その場所。パブリッシュした場所が Orchestrator でないかぎり、パスをクリックするとパッケージに移動します。
• パブリッシュされたプロジェクト ファイルの名前を含むリストを展開する詳細オプション。
• [クリップボードにコピー] オプション

パブリッシュ先など、パブリッシュ時に追加された情報はウィンドウ内に保持されるため、続けて同じ種類のプロジェクトをパブリッシュする場合は使用できます。[パブリッシュ] をクリックするたびに、プロジェクトの新しいバージョンが作成されてパッケージ フィードに送信されます。セキュリティ保護されているフィードへのパブリッシュは、ロボット キー、Orchestrator の資格情報、Windows 認証、または API キーのいずれかで認証して実行できます。

🚧

重要:

Published projects must not be unpackaged. To make any changes, please open the initial .xaml file in Studio, perform the changes, and then publish the project again.

プロジェクトをコマンド ラインからパブリッシュする

You can publish projects using the UiPath.Studio.CommandLine.exe publish command.

UiPath.Studio.CommandLine.exe は、インストール フォルダーにあります。

• For per-machine installations, the default path is C:\Program Files\UiPath\Studio\ です。
• For per-user installations, the default path is %localappdata%\Programs\UiPath\Studio\ です。

パブリッシュ コマンドでは次の引数を使用できます。

例:

• The following command publishes the Sample process to the Orchestrator Tenant Processes Feed:
  UiPath.Studio.CommandLine.exe publish --project-path "C:\Users\username\Documents\UiPath\Sample\project.json" --target OrchestratorTenant --notes "Fixed a couple of bugs."
• 次のコマンドは、同プロセスをローカル フォルダーにパブリッシュします。
  UiPath.Studio.CommandLine.exe publish --project-path "C:\Users\username\Documents\UiPath\Sample\project.json" --target Custom --feed "C:\Users\username\Desktop\myfeed" --notes "Fixed a couple of bugs."

For more information about the CommandLine.exe utility, see Mass Update Command Line Parameters.