オートメーションの依存関係を復元する

前提条件:

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

依存関係を復元するには、次の手順を実行します。

1. uipcli packageを使用して、package タスクを実行します。利用可能なサブタスクのリストが表示されます。

2. 必要なパラメーターを指定し、restore サブタスクを実行します。

   次の表で、必要なパラメーターについて説明します。

   パラメーター	説明
   --restoreFolder	必須。 復元先のフォルダパス。
   --nugetConfigFilePath	オプション。フィードを含む NuGet.Config ファイルへのパスです。指定したファイルの <clear /> タグは無視され、ソースのみが考慮されます。
   -u、--libraryOrchestratorUsername	任意です。Orchestrator のライブラリからの依存関係がある場合にのみ便利です。 認証に使用する Orchestrator のユーザー名。 パスワードと一緒に使用する必要があります。
   -p、--libraryOrchestratorPassword	任意です。Orchestrator のライブラリからの依存関係がある場合にのみ便利です。 認証に使用する Orchestrator のパスワードです。 ユーザー名と一緒に使用する必要があります。
   -t、--libraryOrchestratorAuthToken	任意です。Orchestrator のライブラリからの依存関係がある場合にのみ便利です。 認証に使用される Orchestrator 更新トークンです。 組織名およびクライアント ID と一緒に使用する必要があります。
   -a、--libraryOrchestratorAccountName	任意です。Orchestrator のライブラリからの依存関係がある場合にのみ便利です。 Orchestrator の組織名。 更新トークンおよびクライアント ID と一緒に使用する必要があります。
   -A、--libraryOrchestratorAccountForApp	任意です。Orchestrator のライブラリからの依存関係がある場合にのみ便利です。 Orchestrator の組織名。 外部アプリケーションの ID、シークレット、スコープと共に使用する必要があります。
   -I、--libraryOrchestratorApplicationId	任意です。Orchestrator のライブラリからの依存関係がある場合にのみ便利です。 外部アプリケーション ID です。 外部アプリケーションの組織名、シークレット、スコープと共に使用する必要があります。
   -S、--libraryOrchestratorApplicationSecret	任意です。Orchestrator のライブラリからの依存関係がある場合にのみ便利です。 外部アプリケーションのシークレットです。 外部アプリケーションの組織名、ID、およびスコープと共に使用する必要があります。
   --libraryOrchestratorApplicationScope	任意です。Orchestrator のライブラリからの依存関係がある場合にのみ便利です。 スペースで区切られたアプリケーション スコープのリストです。 外部アプリケーションで、組織名、ID、シークレットと一緒に使用する必要があります。
   --libraryOrchestratorUrl	任意です。Orchestrator のライブラリからの依存関係がある場合にのみ便利です。 Orchestrator の URL です。

注:

--libraryOrchestratorApplicationScope パラメーターを指定せずに外部アプリケーション認証を使用すると、CLI は以下の既定の Orchestrator スコープを自動的に適用します。

OR.Assets OR.BackgroundTasks OR.Execution OR.Folders OR.Robots.Read OR.Machines.Read OR.Jobs OR.TestSets OR.TestSetExecutions OR.Monitoring OR.Settings.Read

| --libraryOrchestratorTenant | Optional, useful only when you have dependencies from a library in Orchestrator. The Orchestrator tenant. | | --libraryIdentityUrl(Required for PaaS or MSI deployments) | URL of your identity server. | | --traceLevel | Specifies what types of log messages to output one of the following values: None, Critical, Error, Warning, Information, Verbose. Default value: Information. | | -l, --language | Language for the translated logs. | | --disableBuiltInNugetFeeds | Disable built in nuget feeds. | | Project(s) Path (pos. 0) | Required. The path to a project.json file, or to a folder that contains project.json files. | | --ca-cert | One or more trusted root CA certificate files (PEM, DER, or PKCS#7) used when validating the Orchestrator and Identity Server TLS certificates. Repeat the flag or comma-separate multiple paths. See Trusting custom certificates for details. | | --pinnedpubkey | Pin the server leaf certificate's public key. Format: sha256//<base64>. Checked in addition to standard certificate validation. See Trusting custom certificates for details. |

ヒント:

For Orchestrator instances signed by a private Certificate Authority (such as UiPath Automation Suite), this command also accepts --ca-cert and --pinnedpubkey parameters. See Trusting custom certificates for scenarios and examples.

使用状況:

uipcli package restore <project_path> --restoreFolder <restore_directory> --nugetConfigFilePath <nuget_config_path> [--libraryOrchestratorUrl <orchestrator_url> --libraryOrchestratorTenant <orchestrator_tenant>] [--u <orchestrator_user> --p <orchestrator_pass>] [--t <auth_token> --a <account_name>] [-A <organization_name> -I <application_id> -S <application_secret> --libraryOrchestratorApplicationScope <application_scope>] [--libraryIdentityUrl <identity_url>] [--libraryOrchestratorFolder <folder_name>] [-l <language>] [--disableBuiltInNugetFeeds] [--traceLevel <None|Critical|Error|Warning|Information|Verbose>]

最小限のコマンドの例:

• uipcli package restore "C:\userprofile\AutomationProject" --traceLevel Information --restoreFolder ""C:\userprofile\DependencyPackages" --nugetConfigFilePath "C:\userprofile\Package\NuGet.Config"
• uipcli package restore "C:\userprofile\AutomationProject" --traceLevel Information --restoreFolder "C:\userprofile\DependencyPackages" --libraryOrchestratorUrl "https://orch-23-10-paas.cloudapp.azure.com/" --libraryOrchestratorTenant "TenantName" -u "orchestratorUsername" -p "********" --orchestratorFolder "FolderName"
• uipcli package restore "C:\userprofile\AutomationProject" --traceLevel Information --restoreFolder "C:\userprofile\DependencyPackages" --libraryOrchestratorUrl "https://orch-23-10-paas.cloudapp.azure.com/" --libraryOrchestratorTenant "TenantName" -A "organizationName" -I "76000552-3e4f-4590-9317-cdb420001f1d" -S '********' --libraryOrchestratorApplicationScope "OR.Folders OR.BackgroundTasks OR.TestSets OR.TestSetExecutions OR.TestSetSchedules OR.Settings.Read OR.Robots.Read OR.Machines.Read OR.Execution OR.Assets OR.Users.Read OR.Jobs OR.Monitoring" --libraryOrchestratorFolder "FolderName" --libraryIdentityUrl "https://orch-23-10-paas.cloudapp.azure.com/identity"
• uipcli package restore "C:\userprofile\AutomationProject" --traceLevel Information --restoreFolder "C:\userprofile\DependencyPackages" --libraryOrchestratorUrl "https://automation-suite.base.url.com/" --libraryOrchestratorTenant "TenantName" -A "organizationName" -I "3f6239b9-e0e8-465e-a429-d9ffd1d9e57a" -S '********' --libraryOrchestratorApplicationScope "OR.Folders OR.BackgroundTasks OR.TestSets OR.TestSetExecutions OR.TestSetSchedules OR.Settings.Read OR.Robots.Read OR.Machines.Read OR.Execution OR.Assets OR.Users.Read OR.Jobs OR.Monitoring" --libraryOrchestratorFolder "FolderName"
• uipcli package restore "C:\userprofile\AutomationProject" --traceLevel Information --restoreFolder "C:\userprofile\DependencyPackages" --libraryOrchestratorUrl "https://cloud.uipath.com/" --libraryOrchestratorTenant "TenantName" -A "organizationName" -I "becc663c-8f1e-409a-a75f-c00330d80bc8" -S '********' --libraryOrchestratorApplicationScope "OR.Folders OR.BackgroundTasks OR.TestSets OR.TestSetExecutions OR.TestSetSchedules OR.Settings.Read OR.Robots.Read OR.Machines.Read OR.Execution OR.Assets OR.Users.Read OR.Jobs OR.Monitoring" --libraryOrchestratorFolder "FolderName"