プロジェクト依存関係一括更新コマンド ラインのユーザー インターフェイスでは、複数のオートメーション プロジェクトに属する project.json ファイルを一括更新できます。依存関係の追加や削除、パッケージ バージョンやランタイム ルールの変更、パブリッシュ前のプロセスまたはライブラリの署名を行うことができます。
プロジェクト依存関係一括更新ツールを使用することにより、更新するそれぞれのパッケージ バージョンのライセンス条件に黙示的に同意したことになります。
注:
Studio Enterprise Edition 用の [プロジェクト依存関係一括更新] コマンド ラインのユーザー インターフェイスは、Studio v2018.4.4 以降で利用可能です。
UiPath.Studio.CommandLine.exe は、インストール フォルダーにあります。
- マシン単位のインストールの場合、既定のパスは
C:\Program Files\UiPath\Studio\です。 - ユーザー単位のインストールの場合、既定のパスは
%localappdata%\Programs\UiPath\Studioです。
各コマンド固有の引数を確認するには、--help を使用します。--version を使用して、UiPath.Studio.CommandLine.exe のバージョンを確認します。
1 つのコマンド ラインから複数のコマンドを組み合わせて使用できます。さらに、同一のコマンド ラインで、特定の引数を繰り返す必要はありません。たとえば、svn login と svn checkout を使用する際には r, --repository になります。
重要
プロジェクト依存関係一括更新 コマンドラインのユーザー インターフェイスを TFS で使用する際には、事前に更新しようとするプロジェクトが現在のユーザーの TFS から切断されていることを確認してください。
プロジェクト依存関係一括更新ツールを使ってプロジェクトを変更する場合は、あらかじめ Studio でプロジェクトを保存して閉じておくことを推奨します。
ローカル ファイル更新のコマンド
list- 特定のディレクトリ配下のproject.jsonファイルへのパスを検出して表示します。ローカルのネットワーク ドライブのプロジェクトもリストに表示されます。listコマンドでは次の引数を使用します。
| Argument | Description |
|---|---|
-d, --directory | The directory that stores the files that you want to list. Use -u, --user and -p, --pass arguments for password-protected remote directories. |
注:
--directory引数をlistコマンドで使用すると、作業ディレクトリからのすべてのproject.jsonファイルへのパスが表示されます。
manage- 特定のプロジェクトを管理します。複数の依存関係およびルールを追加/削除するには、これらを空白で区切る必要があります。manageコマンドでは次の引数をします。
| Argument | Description |
|---|---|
-a, --add-ref | Adds or updates the dependency and runtime rule to the project.json file.”dependencyname|version|runtimerule” = adds or updates the dependency version and runtime rule.”dependencyname|prereleaseversion|runtimerule” = adds the dependency’s prereleased version and the specified runtime rule. |
r, --rem-ref | Removes the specified dependencies from the project.json file."dependencyname" - the dependency to be removed from the project, regardless of its version."dependencyname|version" - removes the dependency with this specific version, regardless if it’s a prerelease version. |
-p, --project-path | The path to the project.json file. |
注:
ランタイム ルールの構文は、最も低い適用可能なバージョンで
lowest、ストリクト バージョンでstrictです。これらのパラメーターを指定しない場合、既定で最も低い適用可能なバージョンが適用されます。
たとえば、次のコマンド manage --project-path "C:\Users\username\Documents\UiPath\BlankProcess\project.json" --add-ref "UiPath.Excel.Activities|2.6.2|lowest" は、パッケージ バージョンを 2.6.2 に、ランタイム ルールを最も低い適用可能なバージョンに変更します。
publish- 依存関係への変更とともに、プロジェクトをパブリッシュします。publishコマンドでは次の引数をします。
| Argument | Description |
|---|---|
-p, --project-path | The path to the project.json to publish. The argument is mandatory. |
-g, --target | Where 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.OrchestratorFolderHierarchy - If a first-level folder with a separate package feed or one if its subfolders is selected from the folders menu in the Studio status bar, the feed for that folder hierarchy. Not available for publishing libraries or templates. |
-f, --feed | The 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-key | The API key for publishing the project. This argument can be used for a custom target. |
-i, --icon | Path to the custom icon to use for the package. |
-n, --notes | Release notes that contain changes brought to the project. |
-v, --new-version | The new version for the project. |
-t, --timeout | Specifies the timeout value for publishing projects. The default timeout is 30 seconds. This setting only applies for the package transfer to Orchestrator duration. |
--cer-path | The local path to the certificate for package signing. |
--cer-password | The password for the certificate. |
--timestamper-url | The URL to the timestamper. |
--incl-all-feeds | Not required. |
注:
現在、プロジェクトの署名では、証明書の拡張子として
.pfxおよび.p12が認められています。詳細については、「パッケージの署名」ページをご覧ください。
上記から例に基づいて構築される次のコマンドは、UiPath.Excel.Activities パッケージをバージョン 2.6.2 に更新し、最も低い適用可能なバージョンにランタイム ルールを変更し、リリース ノートと新バージョンを追加し、カスタムの場所にプロジェクトをパブリッシュします。
manage --project-path "C:\Users\username\Documents\UiPath\BlankProcess\project.json" --add-ref "UiPath.Excel.Activities|2.6.2|lowest" publish --target Custom --feed "C:\Users\username\Desktop\myfeed" --notes "Changes were made to the Excel package" --new-version "1.0.2" です。
Workflow Analyzer のコマンド
コマンドライン パラメーターを使用して、一連のルールに対してファイルまたはプロジェクトを分析できます。
analyze- プロジェクト全体を分析します。project.jsonファイルへのパスが必要です。analyze-file- 単一のファイルを分析します。.xamlファイルへのパスが必要です。
| Argument | Description |
|---|---|
-p, --project-path | For analyzing one file, provide the path to the .xaml. For analyzing the entire project, specify the path to the project.json file. |
-c, --config-path | Path to the RuleConfig.json file. Specify this path only if the rule configuration file is not placed in the default location (%LocalAppData%\UiPath\Rules). |
コマンドライン パラメーターを使用してファイル/プロジェクトのルールを分析および設定する方法の詳細については、「ワークフロー アナライザー」ページをご覧ください。
Git 固有のコマンド
git clone= リポジトリを新しいディレクトリに複製します。
注:
UiPath.Studio.CommandLine.exe git cloneを実行する前に、リポジトリの資格情報が Windows 資格情報マネージャーに保存されていることを確認してください。そうでない場合、認証エラーが発生します。
git clone コマンドでは次の引数を使用します。
| Argument | Description |
|---|---|
r, --repository | The repository address/URL that stores the projects that you would like to modify. The argument is mandatory. |
-d, --directory | The working directory. If not specified, the current environment directory is used. |
git commit= 変更内容をリポジトリに記録します。git commitコマンドでは次の引数を使用します。
| Argument | Description |
|---|---|
-m, --message | Write a commit message to detail the changes brought to the projects. The commit message is mandatory. |
-p, --push | Upload changes to the remote repository. |
-d, --directory | The working directory. If not specified, the current environment directory is used. |
-f, --files | The paths to the files that you want to edit. The paths should be relative to the working directory and separated by semicolons. |
SVN 固有のコマンド
svn login= 特定の SVN リポジトリにログインするために資格情報を使用します。svn loginコマンドでは次の引数をします。
| Argument | Description |
|---|---|
r, --repository | The repository address/URL that stores the projects that you would like to modify. The argument is mandatory. |
-p, --password | The password required for authentication to the SVN repository. |
-s, --password-stdin | Reads the authentication password from STDIN (standard input). You are prompted to input the password to the desired repository. |
u, --user | The username required for authentication. |
svn checkout= SVN リポジトリからプロジェクトをチェックアウトします。svn checkoutコマンドでは次の引数をします。
| Argument | Description |
|---|---|
-d, --directory | The destination checkout folder for the files. The argument is mandatory. |
-r, --repository | The address of the repository that stores the files you want to checkout. The argument is mandatory. |
svn edit= 1つ以上のプロジェクトをロック解除して変更可能な状態にします。svn editコマンドでは次の引数をします。
| Argument | Description |
|---|---|
-f, --files | The paths to the files that you want to edit. The paths should be relative to the working directory and separated by semicolons. The argument is mandatory. |
-d, --directory | The working directory which contains the files that you want to edit. If a working directory isn’t specified, the current environment directory is used. |
svn checkin= オートメーション プロジェクトへの変更をチェックインします。svn checkinコマンドでは次の引数をします。
| Argument | Description |
|---|---|
-m, --message | Write a commit message to detail the changes brought to the projects. The commit message is mandatory. |
-d, --directory | The working directory where the projects are being checked in. If a working directory isn’t specified, the current environment directory is used. |
-f, --files | The paths to the files that you edited. The paths should be relative to the working directory and separated by semicolons. |
TFS 固有のコマンド
tfs login= 特定の TFS リポジトリにログインするために資格情報を使用します。tfs loginコマンドでは次の引数をします。
| Argument | Description |
|---|---|
-t, --type | The login method for the TFS repository:ntlm = authentication through NT LAN Manager on a local TFS repository.token = authentication using a personal access tokens enabled on the TFS repository.basic = basic authentication on a secure TFS repository. |
-p, --password | The password required for authentication to the SVN repository. |
-s, --password-stdin | Reads the authentication password from STDIN (standard input). You are prompted to input the password to the desired repository. |
u, --user | The username required for authentication. |
-c, --collection | Refers to the collection URI. The argument is mandatory. |
tfs checkout= TFS リポジトリからプロジェクトをチェックアウトします。tfs checkoutコマンドでは次の引数をします。
| Argument | Description |
|---|---|
-c, --collection | Specify the collection URI. |
-d, --directory | The destination checkout folder for the files. The argument is mandatory. |
-r, --remotedir | The path to the project directory, relative to the collection root. It starts with $/ and is preceded by the collection URI. |
tfs edit- 1つ以上のプロジェクトをロック解除して変更可能な状態にします。tfs editコマンドでは次の引数をします。
| Argument | Description |
|---|---|
-f, --files | The paths to the files that you want to edit. The paths should be relative to the working directory and separated by semicolons. |
-d, --directory | The working directory which contains the files that you want to edit. If a working directory isn’t specified, the current environment directory is used. |
tfs checkin- オートメーション プロジェクトへの変更をチェックインします。tfs checkinコマンドでは次の引数をします。
| Argument | Description |
|---|---|
-m, --message | Write a commit message to detail the changes brought to the projects. The commit message is mandatory. |
-d, --directory | The working directory where the projects are being checked in. If a working directory isn’t specified, the current environment directory is used. |
-f, --files | The paths to the files that you edited. The paths should be relative to the working directory and separated by semicolons. |
古いオートメーション プロジェクトを更新する
コマンドライン ユーザー インターフェイスを使用して、v2018.3 より前のバージョンの Studio で作成したオートメーション プロジェクトに依存関係をインストールする際には、次のことに注意してください。
- このプロジェクトがパブリッシュされておらず、したがって依存関係がインストールされていない場合、移行プロセスにより既定のパッケージがインストールされます。詳細については、「依存関係の管理」ページをご覧ください。
- v2018.3より前のバージョンの Studio で作成されたプロジェクトでは、
UiPath.Core.ActivitiesパッケージがUiPath.System.ActivitiesおよびUiPath.UIAutomation.Activitiesに移行されます。
約 1 か月前に更新