通知を受け取る

UiPath Studio

UiPath Studio ガイド

オートメーション プロジェクトのパブリッシュについて

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

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

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

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

プロジェクトをローカルにパブリッシュするには、ローカル マシン上のパスを指定する必要があります。このパスは、プロセスパッケージがパブリッシュされた場所とは別の場所へのパスです。ここから、後でロボットにパッケージを手動で送信してロボットで実行することができます。既定では、ローカルなパブリッシュの場所は %ProgramData%\\UiPath\\Packages です。

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 の [デザイン] タブのリボンで [パブリッシュ] を選択します。なお、project.json ファイルが読み取り専用の場所にあると、オートメーション プロジェクトをパブリッシュできません。

1165

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

  1. Studio で、新しいプロジェクトを作成します。
  2. [デザイン] リボン タブの [パブリッシュ] をクリックします。[パブリッシュ] ウィンドウが表示されます。コンテキストに応じてウィンドウのタイトル バーが変化することを確認してください。
    • [プロセスをパブリッシュ] - プロセスをパブリッシュする場合
    • [ライブラリをパブリッシュ] - ライブラリ プロジェクトをパブリッシュする場合
    • [UI ライブラリをパブリッシュ] - UI ライブラリ プロジェクトをパブリッシュする場合
    • [テスト ケースをパブリッシュ] - テスト ケースをパブリッシュする場合
    • [テンプレートをパブリッシュ] - テンプレートをパブリッシュする場合
  3. [パッケージのプロパティ] タブで以下の操作を実行します。
    • パッケージの名前を入力します。ドロップダウン リストには、最近パブリッシュしたパッケージの名前が最大 5 つ表示されます。
    • [バージョン] セクションでプロジェクトの [現在のバージョン] を確認し、必要に応じて [新しいバージョン] に入力します。バージョンを alpha としてマークするには [プレリリース] チェック ボックスをオンにします。これにより、プロジェクトのバージョン スキーマが自動的にセマンティックに変更されます。ファイルの新しいバージョンをローカルにパブリッシュする場合、指定する場所に同じバージョン番号のファイルが含まれていないことを確認してください。プロジェクトのバージョン管理の詳細については、「オートメーション プロジェクトについて」をご覧ください。
    • [リリース ノート] テキスト ボックスには、バージョンなどの関連情報の詳細を入力します。パブリッシュしたプロジェクトのリリース ノートは、Orchestrator の [パッケージ] セクションに表示されます。[リリース ノート] フィールドには、最大 10,000 文字まで入力できます。
819
  1. [次へ] をクリックします。
    テンプレートをパブリッシュしている場合は、次の手順 (手順 5) で [テンプレート情報] タブが開きます。それ以外の場合には、手順 6 に進みます。
  2. (テンプレートの場合のみ) [テンプレート情報] タブで以下の情報を入力し、[次へ] をクリックします。
    • 名前 - テンプレートの名前です。
    • 説明 - [テンプレート] タブのテンプレートの説明です。
    • 既定のプロジェクト名 - このテンプレートを使用する新しいプロジェクトを作成する際の既定のプロジェクト名です。
    • 既定のプロジェクトの説明 - このテンプレートを使用する新しいプロジェクトを作成する際の既定のプロジェクトの説明です。
    • アイコンの URL - パブリック URL として指定する、任意のテンプレートのアイコンです。アイコンは、この特定のテンプレートの [テンプレート] タブに表示されます。
821
  1. [パブリッシュのオプション] タブで、プロジェクトをパブリッシュする場所を選択します。利用可能なオプションは、パブリッシュするプロジェクトの種類によって異なります。

    • プロセス の場合 (StudioX プロジェクトを含む):
      • Assistant (Robot の既定) - Robot と Assistant の既定のパッケージの場所です (C:\ProgramData\UiPath\Packages)。ここにパブリッシュされたプロジェクトは自動的に Assistant に表示されます。Studio が Orchestrator に接続されている場合、このオプションは使用できません。
      • カスタム - カスタム NuGet フィードの URL またはローカル フォルダー。任意で API キーを追加できます。
      • Orchestrator テナント プロセス フィードOrchestrator 個人用ワークスペース フィード、および別のパッケージ フィードを持つテナント フォルダー - Studio が Orchestrator に接続している場合に利用できます。Orchestrator 個人用ワークスペース フィードを使用できるのは、接続先の Orchestrator で個人用ワークスペース機能が有効化されているときのみであることに注意してください。
    • テスト ケースの場合:
      • Orchestrator 個人用ワークスペース フィードを除いて、プロセスの場合と同じオプションを利用可能です。
    • ライブラリおよび UI ライブラリの場合:
      • カスタム - カスタム NuGet フィードの URL またはローカル フォルダー。任意で API キーを追加できます。
      • Orchestrator テナント ライブラリ フィードまたは Orchestrator 共有ライブラリ フィード - Studio が Orchestrator に接続している場合に利用できます。利用可能なオプションは、Orchestrator でテナント ライブラリ フィードが有効化されているかどうかによって異なります。
    • テンプレートの場合:
      • ローカル - テンプレートをローカルにパブリッシュする場所。既定では C:\Users\User\Documents\UiPath\.templates です。
      • カスタム - カスタム NuGet フィードの URL またはローカル フォルダー。任意で API キーを追加できます。
      • Orchestrator テナント ライブラリ フィードまたは Orchestrator 共有ライブラリ フィード - Studio が Orchestrator に接続している場合に利用できます。利用可能なオプションは、Orchestrator でテナント ライブラリ フィードが有効化されているかどうかによって異なります。

    ライブラリをパブリッシュしている場合は、[ライブラリ設定][パブリッシュのオプション] タブで追加の設定を利用できます。

    • アクティビティ ルート カテゴリ - [アクティビティ] パネルの、再利用可能なコンポーネントのリストが表示されるカテゴリの名前を入力します。
    • ソースを含む - このオプションを選択すると、これまで非公開になっていたワークフローを含むすべての .xaml ソースが、生成されるアセンブリ ファイル内にパッケージ化されます。必要に応じて、その後アセンブリ ファイルを逆コンパイルして、デバッグ時に役立つ可能性のあるワークフローを抽出できます。
    • アクティビティの数式をコンパイル - このオプションを選択すると、アクティビティの数式がすべてライブラリとともにコンパイルされ、パッケージ化されます。その結果、実行時間が短縮されます。
    • すぐに実行可能にする - このオプションを選択すると、実行時の JIT コンパイルを高速化するために、生成されるアセンブリを最適化します。
      :information-source: 注: ライブラリのパブリッシュが成功しない場合に考えられる原因については、「ライブラリをパブリッシュする際の制限事項」をご覧ください。
814
  1. [次へ] をクリックして [証明書の署名] タブに進むか、[パブリッシュ] に進んでプロジェクトをパブリッシュします。
  2. (任意) [証明書の署名] タブで、[証明書] ボックスの横にあるローカルの証明書のパスを追加します。さらに、必要に応じて、[証明書のパスワード] とオプションの証明書の [タイムスタンプ局] を追加します。詳しくは「パッケージの署名」をご覧ください。
814

📘

注:

現在、プロジェクトの署名では、証明書の拡張子として .pfx および .p12 が認められています。

  1. [パブリッシュ] をクリックします。プロジェクト フォルダー全体が .nupkg ファイルにアーカイブされ、Orchestrator、カスタム NuGet フィードにアップロードされるか、ローカル ディレクトリに保存されます。
  2. プロジェクトが正常にパブリッシュされると、[情報] ダイアログ ボックスが表示され、NuGetServerUrl パラメーター (UiPath.settings ファイル内) に設定された NuGet の場所にプロジェクトがコピーされます。

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

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

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

🚧

重要:

プロジェクトをパブリッシュして作成したパッケージ ファイルは、解凍しないでください。変更を加える場合は、Studio で元の .xaml ファイルを開き、これを変更したうえで、再度プロジェクトをパブリッシュします。

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

UiPath.Studio.CommandLine.exe publish コマンドを使用してプロジェクトをパブリッシュできます。

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

  • Windows インストーラー (.msi) でインストールされた Studio の既定のパスは C:\Program Files\UiPath\Studio\ です。
  • Community Edition のインストーラー (.exe) を使用してインストールされた Studio の既定のパスは %LocalAppData%\UiPath\[Studio_version]\ です。

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

ArgumentDescription
-p, --project-pathThe path to the project.json to publish. The argument is mandatory.
-g, --targetWhere to publish the project:
Custom - Custom URL or local folder. Define the location using the -f, --feed argument.
Robot - Default publish location for the Robot, if not connected to Orchestrator. Not available for publishing libraries or templates.
OrchestratorTenant - Orchestrator Tenant Processes Feed (for processes and test cases) or Orchestrator Libraries Feed (for libraries and templates).
OrchestratorPersonalFolder - Orchestrator Personal Workspace Feed. Not available for publishing libraries, templates, or test cases.
-f, --feedThe custom URL for publishing the project. This can also be a custom local directory, similar to the path in the Publish options tab in Studio.
-a, --api-keyThe API key for publishing the project. This argument can be used for a custom target.
-n, --notesRelease notes that contain changes brought to the project.
-v, --new-versionThe new version for the project. If not provided, the version is automatically incremented.
-t, --timeoutSpecifies the timeout value for publishing projects. The default timeout is 30 seconds. This setting only applies for the package transfer to Orchestrator duration.
--cer-pathThe local path to the certificate for package signing.
--cer-passwordThe password for the certificate.
--timestamper-urlThe URL to the timestamper.
--helpView the arguments available for each command.
--versionCheck the version of UiPath.Studio.CommandLine.exe.

例:

  • 次のコマンドは、Sample というプロセスを Orchestrator テナント プロセス フィードにパブリッシュします。
    UiPath.Studio.CommandLine.exe publish --project-path "C:\Users\username\Documents\UiPath\Sample\project.json" publish --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.

1 年前に更新

オートメーション プロジェクトのパブリッシュについて


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

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