プロジェクトをパッケージ化する

前提条件:

• プロジェクトを作成します。
• CLI の exe ファイル (Windows の場合) または dll ファイル (Linux の場合) を実行します。
• 必要な Orchestrator API アクセスのアプリケーション スコープを追加します。

1. uipcli package を使用して package タスクを実行します。利用可能なサブタスクのリストが表示されます。
2. 必要なパラメーターを指定し、pack サブタスクを実行します。

   以下のパラメーターのリストをご覧ください。

注:

プロジェクトの検証は、UiPath CLI のパック タスクや分析タスクでは実行されません。

凡例: (*) - 任意です。Orchestrator のライブラリとの依存関係がある場合にのみ有効です。

パラメーター	説明
-o または --output (必須)	プロジェクトのパッケージ化先の Orchestrator フォルダーです。
-v または --version	パッケージのバージョンを設定します。
--autoVersion	パッケージのバージョンを自動生成します。
--outputType	特定の種類に出力を強制します。
--splitOutput	ランタイムライブラリとデザインライブラリへの出力分割を可能にします。
--repositoryUrl	プロジェクトのバージョン管理が行われるリポジトリ URL です。
--repositoryCommit	プロジェクトのビルド元のリポジトリ コミット。
--repositoryBranch	プロジェクトの構築元のリポジトリブランチ。
--repositoryType	VCS システム リポジトリの種類。
--projectUrl	Automation Hub のアイデアの URL
--releaseNotes	リリース ノートを追加する
--libraryOrchestratorUsername (*) (ユーザー名とパスワードによる基本認証を使用する場合は必須)	Orchestrator への認証に使用するユーザー名です。対応するパスワードと組み合わせて使用する必要があります。 パッケージで Orchestrator フィードのライブラリを参照する場合、必須です。
--libraryOrchestratorPassword (*) (ユーザー名とパスワードによる基本認証を使用する場合は必須)	Orchestrator への認証に使用するパスワードです。対応するユーザー名と組み合わせて使用する必要があります。 パッケージで Orchestrator フィードのライブラリを参照する場合、必須です。
--libraryOrchestratorAuthToken (*) (トークンベースの認証を使用する場合は必須)	Orchestrator への認証に使用する OAuth2 更新トークンです。アカウント名およびクライアント ID と組み合わせて使用する必要があります。 パッケージで Orchestrator フィードのライブラリを参照する場合、必須です。
--libraryOrchestratorAccountName (*) (トークンベースの認証を使用する場合は必須)	Orchestrator Cloud RPA のアカウント名です。OAuth2 更新トークンおよびクライアント ID と組み合わせて使用する必要があります。 パッケージで Orchestrator フィードのライブラリを参照する場合、必須です。
--libraryOrchestratorAccountForApp (*)	Orchestrator Cloud RPA のアカウント名 (組織名) です。外部アプリケーションのアプリケーション ID、アプリケーション シークレット、アプリケーション スコープと組み合わせて使用する必要があります。 パッケージで Orchestrator フィードのライブラリを参照する場合、必須です。
--libraryOrchestratorApplicationId (*) (外部アプリケーション認証を使用する場合は必須)	外部アプリケーション ID です。アプリケーション アカウント、アプリケーション シークレット、アプリケーション スコープと組み合わせて使用する必要があります。 パッケージで Orchestrator フィードのライブラリを参照する場合、必須です。
--libraryOrchestratorApplicationSecret (*) (外部アプリケーション認証を使用する場合は必須)	外部アプリケーション シークレットです。アプリケーション アカウント、アプリケーション ID、アプリケーション スコープと組み合わせて使用する必要があります。 パッケージで Orchestrator フィードのライブラリを参照する場合、必須です。
--libraryOrchestratorApplicationScope (*) (外部アプリケーション認証を使用する場合は必須)	アプリケーション スコープを単一のスペースで区切って列挙したリストです。外部アプリケーションのアプリケーション アカウント、アプリケーション ID、アプリケーション シークレットと組み合わせて使用する必要があります。 パッケージで Orchestrator フィードのライブラリを参照する場合、必須です。
--libraryOrchestratorFolder (*)	対象の Orchestrator フォルダーの名前です。 サブフォルダーを入力するには、親フォルダーの名前とサブフォルダーの名前の両方を入力してください。例: AccountingTeam\TeamJohn
--libraryOrchestratorUrl (*)	Orchestrator インスタンスの URL です。
--libraryOrchestratorTenant (*)	マシンを削除する Orchestrator インスタンスのテナントです。
--libraryIdentityUrl (PaaS デプロイの場合のみ必須)	Identity Server の URL です。
-y または --disableTelemetry	テレメトリ データを無効化します。
--traceLevel	イベントのトレースを表示します。
-l または --language	Orchestrator のユーザー インターフェイスで使用する言語です。
--disableBuiltInNugetFeeds	組み込みの NuGet フィードを無効にします。
--help	このコマンドのパラメーターと例を表示します。
--version	バージョン情報を表示します。
Project(s) Path (pos. 0) (必須)	project.json ファイルのパス、または project.json ファイルを含むフォルダーのパスです。

使用状況:

package pack <project_path> -o <destination_folder> [-v <version>] [--autoVersion] [--outputType <Process|Library|Tests|Objects>] [--libraryOrchestratorUrl <orchestrator_url> --libraryOrchestratorTenant <orchestrator_tenant>] [--libraryOrchestratorUsername <orchestrator_user> --libraryOrchestratorPassword <orchestrator_pass>] [--libraryOrchestratorAuthToken <auth_token> --libraryOrchestratorAccountName <account_name>] [--libraryOrchestratorFolder <folder>] [-l <language>]

例:

• package pack "C:\UiPath\Project\project.json" -o "C:\UiPath\Package"

• package pack "C:\UiPath\Project\project.json" -o "C:\UiPath\Package" -v 1.0.6820.22047

• package pack "C:\UiPath\Project\project.json" -o "C:\UiPath\Package" --autoVersion

• package pack "C:\UiPath\Project" -o "C:\UiPath\Package"

• package pack "C:\UiPath\Project\project.json" -o "C:\UiPath\Package" --outputType Tests -l en-US

外部アプリケーションを追加する

外部アプリケーションを登録し、そのアプリケーションが OAuth を使用して UiPath リソースにアクセスできるようにするには、以下の手順を実行します。

1. テナントに管理者としてログインします。
2. [テナント] > [アクセス権を管理] > [ロールを割り当て] に移動して、[アカウントおよびグループを管理] をクリックします。

   テナント レベルが開きます。

3. 左側の [外部アプリケーション] を選択します。

   現在のテナントに登録されている、すべての既存外部アプリケーションのリストが [外部アプリケーション] ページに表示されます。

   
   

   

   
   
4. 表の上で、右側にある [アプリケーションを追加] をクリックします。
5. [アプリケーション名] フィールドに入力します。
6. [アプリケーションの種類] のオプションを選択します。

   [機密アプリケーション] を選択した場合、最後にアプリケーション シークレットが提供されるので、使用しているアプリケーションでそのシークレットを安全に保存できることを確認してください。それが不可能な場合は [非機密アプリケーション] を選択します。

7. [リソース] で [スコープを追加] をクリックします。

   右側に [リソースを編集] パネルが開きます。このパネルでは、アプリケーションにアクセス権を与える必要があるリソースを選択できます。

8. [リソース] ドロップダウン リストから、アプリケーションが使用できる UiPath API を選択します。
   注: スコープは一度に 1 つのリソースに対してのみ追加できます。複数のリソースへのアクセスを許可するには、このプロセスを繰り返して各リソースにスコープを追加します。
9. [ユーザー スコープ] タブで、必要に応じて、付与する論理 API 権限のチェック ボックスを選択します。

   ユーザー スコープに基づく権限付与とは、外部アプリケーションがそれらのリソースにユーザー コンテキスト内でアクセス可能であり、適切な権限を持つユーザーがログインする必要があることを意味します。

10. 機密アプリケーションの場合は、[アプリケーション スコープ] タブに切り替え、必要に応じて、選択したリソースに対するアプリケーション レベルでの権限も付与できます。

    アプリケーション スコープに基づく権限を持つ外部アプリケーションは、ユーザーの操作なしで、選択したスコープのすべてのアプリケーションのデータにアクセスできます。

    非機密アプリケーションは、アプリケーション スコープにアクセスできません。

11. [保存] をクリックします。

    パネルが閉じ、フォームの [リソース] の表に、選択したリソースとスコープが追加されます。

12. 外部アプリケーションが対応している場合、[リダイレクト URL] フィールドに URL を追加すると、認可応答がその URL に送信され、アプリケーションがその URL を使用して UiPath リソースにアクセスできるようになります。
13. [追加] をクリックして登録を作成します。

    確認メッセージが表示されます。機密アプリケーションの場合、確認メッセージには登録済み外部アプリケーションが認可を要求するときに使用できるアプリケーション シークレットが含まれます。アプリケーション シークレットは、その後はもう表示されることがないので、必ず安全な場所に保存しておいてください。