パッケージを管理する

Orchestrator でオートメーション パッケージとそのバージョンを表示、ダウンロード、管理します。

パッケージ バージョンをダウンロードする

1. Under Packages, select the desired tab depending on your package type. In the grid, select More Actions for a package, then Select View Versions. The Package Versions window is displayed.
2. Select More Actions > Download package for the corresponding package version you want to download. The package is downloaded to the default location configured in your browser, in the .nupkg format. From here, you can upload it to another Orchestrator instance.
   注:

   ローカル フィードを使用し、パッケージに対する [表示] 権限を持っている場合のみ、[ダウンロード] ボタンが有効化されます。

パッケージを Orchestrator に手動でアップロードする

既定では、パッケージ サイズの上限は 300MB です。

注:

タグ付きのパッケージを手動でアップロードするには、タグの作成権限が必要です。タグ の作成 権限がない場合、パッケージはタグなしでアップロードされます。

1. [ パッケージ] で、パッケージの種類に応じて目的のタブを選択し、 アップロード ボタンを選択します。[ パッケージを追加 ] ウィンドウが表示されます。
2. Select Browse and select the packages (with the .nupkg extension) you want to upload to Orchestrator.
3. アップロードされる以前のバージョンのパッケージを使用しているプロセスをすべて表示するには、[アップグレードできるプロセスを確認する] を選択します。
4. Select Upload. Orchestrator automatically determines the package Enter and displays the uploaded package in the corresponding grid under Tenant > Packages. If you selected the I would like to see which processes can be upgraded option, the Upgrade multiple processes window is displayed, showing a list of the processes that can be upgraded to a newer package version.

図 1. 複数のプロセスのアップグレード

5. Use the checkboxes to select which processes to upgrade and Select Upgrade. The selected processes are updated to the new package version, and the window closes. Only the package version is updated. If you want to customize the process parameters or entry points, edit the process.

パッケージを削除する

Orchestrator からパッケージを削除できるのは、対象のパッケージのすべてのバージョンが削除されている場合のみです。パッケージ バージョンは、[非アクティブ] の場合 (つまり、プロセスにデプロイされていない場合) に削除できます。

1. Under Packages, select the desired tab depending on your package Enter and locate your package in the list. From the More Actions menu for the package, select View Versions. The Package Versions window is displayed.

図 2. パッケージ バージョン

2. Select one or more versions and Select Remove. Alternatively, Select More actions > Delete for the package version you want to delete. The selected package versions are removed.
3. Select Remove All Inactive to delete all inactive versions of the selected process. If a package version is part of a process (it is active), it is NOT going to be deleted. If all the versions are inactive, they are all deleted.

1 つのパッケージ バージョンのリリース ノートを表示する

1. Under Packages, select the desired tab depending on your package type. In the list, select More Actions for a package, then Select View Versions. The Package Versions window is displayed.
2. [バージョン] タブでは、選択したパッケージのすべてのパッケージ バージョンを確認できます。
3. 目的のバージョンで、[その他のアクション] > [リリース ノートを表示] を選択します。[リリース ノート] ウィンドウが表示されます。該当するバージョンについて Studio で追加されたノートを確認できます。

In addition to that, you can see the note added in Studio, as well as the Windows applications used by the respective package version, displayed in alphabetical order. If the package uses applications that cannot be identified, an Unknown apps entry is displayed, suffixed by the number of unidentified apps, in parentheses.

アプリケーションを取得できない場合は、「このパッケージのアプリを取得できませんでした」というメッセージが表示されます。これは、ほとんどの場合、次のいずれかの理由によるものです。

• お使いの Studio が 2023.2 より前のバージョンである。
• お使いの Studio のバージョンは 2023.2 だが、ガバナンス ルールが適用されておりこの情報のログ記録が防止されている。
• パッケージが外部フィードからアップロードされている。この情報は内部フィードのパッケージでのみ提供できます。
• パッケージでアプリケーションがまったく使用されていない。

これらの詳細は、基になるパッケージの [プロセス] ウィンドウにも表示されます。

図 3. パッケージの詳細

[リリース ノート] ウィンドウからパッケージ バージョンを手動でダウンロードすることもできます。このプロセスは、[バージョン] タブからのダウンロードに類似しています。

すべてのパッケージ バージョンのリリース ノートを表示する

1. Under Packages, select the desired tab depending on your package type. In the package list, select More Actions for a package, then Select View Versions. The Package Versions window is displayed.
2. [ 変更ログ ] タブを選択します。ライブラリのすべてのパッケージ バージョンを確認でき、各パッケージについて、バージョン間の変更点に関連する情報が記載されたリリース ノートを確認できます。

図 4. パッケージ バージョンの変更ログ

[変更ログ] タブからパッケージ バージョンを手動でダウンロードすることもできます。このプロセスは、[バージョン] タブからのダウンロードに類似しています。

パッケージの引数を確認する

1. Under Packages, select the desired tab depending on your package type. Select More Actions for a package, then Select View Versions. The Package Versions window is displayed.
2. Select More Actions > Show Arguments for the desired package version. The input and output parameters of the selected package version are displayed.

このレベルでは、パラメーター値を編集できません。編集可能なのは、プロセス、ジョブ、トリガーのレベルのみです。

パッケージ プロセスを表示する

パッケージに関連付けられているプロセスを確認するには、以下の場所で [プロセスを表示] をクリックします。

• テナント レベルの目的のパッケージのコンテキスト メニュー - そのパッケージのすべてのバージョンに関連付けられたプロセスが表示されます。
• テナント レベルのパッケージ バージョンのコンテキスト メニュー - 選択した特定のパッケージ バージョンに関連付けられたプロセスが表示されます。

上記のどちらのオプションも、選択すると [パッケージのプロセス] ウィンドウが表示され、そのプロセスが含まれるフォルダーが一覧表示されます。

表示されるのは、ユーザーが表示アクセス権を持つフォルダーのみです。表示されていないフォルダーにもこのプロセスが含まれている可能性があります。編集オプションは、編集アクセス権も持っているフォルダーでのみ利用可能になります。

パッケージにタグを追加する

Studio で設計時に、タグをパッケージに適用することができます。タグをパッケージに追加する方法について詳しくは、『Studio ガイド』の「オートメーション プロジェクトのパブリッシュについて」をご覧ください。

Orchestrator からパッケージのタグを変更することはできません。タグは、各パッケージ バージョンに固有です。Orchestrator の [パッケージ] ページで、アクティブか非アクティブかに関係なく、最新のパッケージ バージョンに固有のタグを確認できます。

パッケージからタグを削除する

Studio で設計時に、パッケージからタグを削除することができます。タグをパッケージから削除する方法について詳しくは、『Studio ガイド』の「オートメーション プロジェクトのパブリッシュについて」をご覧ください。

Orchestrator からパッケージのタグを変更することはできません。タグは、各パッケージ バージョンに固有です。Orchestrator の [パッケージ] ページで、アクティブか非アクティブかに関係なく、最新のパッケージ バージョンに固有のタグを確認できます。

パッケージとワークフローを比較する

選択した 2 つのパッケージ バージョン間の差異を確認できます。追加、編集、削除された .xaml ファイルや、フォルダーまたは依存関係リストの変更個所を知ることができます。ワークフロー .xaml ファイルの 2 つのバージョンを選択し、それらを並べて表示して比較することもできます。この機能により、Orchestrator の管理者は Studio にアクセスすることなく、パッケージやワークフローの変更内容を確認できます。

1. [ パッケージ] で、パッケージの種類に応じて目的のタブを選択し、パッケージの横の [ パッケージを確認 ] を選択します。[ パッケージを確認] ウィンドウが表示されます。選択したパッケージのすべてのバージョンにアクセスできます。ただし、[ パッケージを確認] オプションは、[ オートメーション ] グリッドと [テスト オートメーション] グリッドでのみ利用可能です。
2. Select the Compare button above the list of package versions to toggle the compare mode. A checkbox appears in front of each package version.
3. 比較するパッケージ バージョンのチェック ボックスを選択します。一度に 2 つのパッケージ バージョンだけを比較することができます。

2 つのパッケージ バージョンに対応している、同じ .xaml ファイルを比較することもできます。そのためには、一度に一つずつパッケージを展開してからワークフロー ファイルを選択します。

4. Select the Compare button below the list of package versions. This button is activated after you select two checkboxes. The Comparing window is displayed, containing a list of results with the newest selected version's workflow files, along with the project author, and description. The workflow file set as Main in Studio is marked accordingly, and the project dependencies are displayed under the Dependencies section.

前のステップで比較するワークフロー ファイルを選択した場合、2 つのワークフローが、より新しいバージョンのファイルを左側にして、並べて表示されます。

5. ウィンドウの右上隅にあるいずれかのオプションを選んで、表示する差異を絞り込むことができます。
   • [すべて] - 比較するパッケージ バージョンまたはワークフロー ファイル間の差異をすべて表示します。これは既定で選択されるオプションであり、すべての差異の概要が表示されます。
   • [追加済み] - パッケージ バージョンに追加されたファイル、フォルダー、依存関係、または [比較中] ウィンドウに表示されているワークフロー ファイルに追加されたコンテナー、矢印、アクティビティが緑色に強調表示され、それぞれの正確な数も表示されます。
   • [変更済み] - パッケージ バージョン内で変更されたファイル、フォルダー、依存関係、または [比較中] ウィンドウに表示されているワークフロー ファイル内で変更されたコンテナー、矢印、アクティビティ、プロパティまたはプロパティの値が黄色に強調表示され、それぞれの正確な数も表示されます。
   • [削除済み] - パッケージ バージョンから削除されたファイル、フォルダー、依存関係、または [比較中] ウィンドウに表示されているワークフロー ファイルから削除されたコンテナー、矢印、アクティビティが赤色に強調表示され、それぞれの正確な数も表示されます。

図 5. 比較ウィンドウ

6. Select the Compare button next to a workflow file from the list of results. The two workflows are displayed side by side, the earliest file version on the left, and with an individual scroll for each workflow. All the changes that happened in the file between the two package versions at the container, connector, or activities level are highlighted and color-coded as follows:
   • 追加されたコンテンツは緑
   • 編集されたコンテンツは黄
   • 削除されたコンテンツは赤

図 6. フローチャートの比較

アクティビティや矢印の位置など、ワークフロー レベルでの変更が軽微なものに限られる場合は、ロジックは変更なしと通知されます。

7. (For containers only) Double-Select a container activity. The Comparing window displays only the activity within both package versions, for a focused view. If the activity exists in only one of the workflow files, then it is displayed in the corresponding workflow's side. Navigate back from the container to the workflow by clicking the breadcrumb trail.

図 7. フローチャートの比較

8. Select any activity to view the changes to its properties. All the changes that happened in the activity between the two package versions are highlighted and color-coded, as mentioned before.

パッケージを確認する

パッケージ バージョンに含まれる任意の .xaml ファイルのグラフィカル表現を、Studio の [デザイナー] パネルと同様の方法で表示および探索できます。この機能により、開発者と Orchestrator の管理者間のよりスムーズな連携が可能になります。

注:

• この機能を使用して、コンパイルされたパッケージを確認することはできません。
• ([パブリッシュのオプション] > [コンパイル設定] セクションで [ソースを含める] オプションを選択すると、アップロード済みの Studio パッケージを、すべての .xaml ソースとともにパッケージ エクスプローラーで完全に表示できます。これは Windows プロジェクトおよびクロスプラットフォーム プロジェクトに適用されます。詳しくは、『Studio ガイド』の「オートメーション プロジェクトについて」をご覧ください。

1. [ パッケージ] で、パッケージの種類に応じて目的のタブを選択し、パッケージの横の [ パッケージを確認 ] を選択します。[ パッケージを確認] ウィンドウが表示されます。選択したパッケージのすべてのバージョンにアクセスできます。ただし、[ パッケージを確認] オプションは、[ オートメーション ] グリッドと [テスト オートメーション] グリッドでのみ利用可能です。
2. 詳細を表示するバージョンを選択します。プロジェクトで利用可能なすべての .xaml ファイルが、プロジェクト作成者、説明、および Orchestrator にアップロードされた日付とともに表示されます。Studio でメインに設定された .xaml ファイルは、それがわかるようにここでマークされます。また、[依存関係] セクションにはプロジェクトの依存関係が表示されます。
3. .xaml ファイルを選択します。ワークフローが表示されます。
4. 選択したファイルで使用できるすべての変数、引数、またはインポートを表示するには、[変数]、[引数]、または [インポート] ボタンを選択します。Studio で使用できるパネルに似た、対応するパネルが表示されます。

図 8. 選択したファイルで使用できるすべての変数、引数、またはインポートの表示

5. Double-Select any scope to see a focused view of the workflow.

図 9. ワークフロー

6. Select Expand All to get a better view of a workflow section.
7. アクティビティを選択して、そのプロパティを表示します。プロパティの値をコピーすることもできます。

詳細は、「フィールドの説明」ページの前述の各フィールド、ボタン、およびパネルで参照できます。