パッケージを管理する

Orchestrator の [パッケージ] ページからオートメーション パッケージのバージョンをダウンロードして管理します。

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

1. In the Packages page, Select View Versions. The Package Versions window is displayed.

図 1. パッケージのダウンロード

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 です。

この値は、 こちらで説明しているように IIS で変更できます。

注:

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

1. On the Packages page, Select the Upload button . The Add Package window is displayed.
2. Select Browse and select the packages (with the .nupkg extension) you want to upload to Orchestrator.
3. アップロードされる以前のバージョンのパッケージを使用しているプロセスをすべて表示するには、[アップグレードできるプロセスを確認する] を選択します。

図 2. パッケージの追加

4. Select Upload. The package is uploaded to Orchestrator, and it is displayed on the Packages page. If you selected the I would like to see which processes can be upgraded option, the Upgrade multiple processes is displayed, showing a list of the processes that can be upgraded to a newer package version.

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

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. In the Packages page, Select View Versions. The Package Versions window is displayed.

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

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. In the Libraries page, Select View Versions. The Package Versions window is displayed.
2. [バージョン] タブにライブラリのパッケージ バージョンがすべて表示されます。
3. For the desired version, Select More Actions > Show Release Notes. The Release Notes window is displayed, enabling you to see the note added in Studio for the respective version.

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

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.If no applications can be retrieved, a No app(s) could be retrieved for this package message is displayed.

This is most likely due to one of the following reasons:

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

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

図 6. パッケージの詳細

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

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

1. In the Packages page, Select View Versions. The Package Versions window is displayed.
2. [ 変更ログ ] タブを選択します。ライブラリのすべてのパッケージ バージョンが表示され、対応するリリース ノートには、バージョン間の変更点に関連する情報が含まれています。

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

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

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

1. In the Packages page, 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. Managing ProcessesManaging JobsManaging triggersPlease note that you cannot edit the values of the parameters at this level, only at process, jobs, and triggers ones.

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

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

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

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

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

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

パッケージを確認する

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

注:

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

1. In the Packages page, Select Explore Package next to a package. The Explore Package window is displayed, in which you have access to all the versions of the selected package.
2. 詳細を表示するバージョンを選択します。プロジェクトで利用可能なすべての .xaml ファイルが、プロジェクト作成者、説明、および Orchestrator にアップロードされた日付とともに表示されます。Studio でメインに設定された .xaml ファイルは、それがわかるようにここでマークされます。また、[依存関係] セクションにはプロジェクトの依存関係が表示されます。
3. .xaml ファイルを選択します。ワークフローが表示されます。
4. To view all the variables, arguments, or imports available in the selected file, Select the Variables,Arguments, or Imports button. The corresponding panel is displayed, similar to that available in 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. アクティビティを選択して、そのプロパティを表示します。プロパティの値をコピーすることもできます。

図 10. パッケージを確認する

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

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

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

ここでは、最初にパッケージ バージョン レベルでの差異の表示方法、次にワークフロー ファイル レベルでの差異の表示方法を説明します。

ステップ バイ ステップの手順は以下のとおりです。

1. In the Packages page, Select Explore Package next to a package. The Explore Package window is displayed, giving you access to all the versions of the selected package.
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. ウィンドウの右上隅にあるいずれかのオプションを選んで、表示する差異を絞り込むことができます。
   • [すべて] - 比較するパッケージ バージョンまたはワークフロー ファイル間の差異をすべて表示します。これは既定で選択されるオプションであり、すべての差異の概要が表示されます。
   • [追加済み] - パッケージ バージョンに追加されたファイル、フォルダー、依存関係、または [比較中] ウィンドウに表示されているワークフロー ファイルに追加されたコンテナー、矢印、アクティビティが緑色に強調表示され、それぞれの正確な数も表示されます。
   • [変更済み] - パッケージ バージョン内で変更されたファイル、フォルダー、依存関係、または [比較中] ウィンドウに表示されているワークフロー ファイル内で変更されたコンテナー、矢印、アクティビティ、プロパティまたはプロパティの値が黄色に強調表示され、それぞれの正確な数も表示されます。
   • [削除済み] - パッケージ バージョンから削除されたファイル、フォルダー、依存関係、または [比較中] ウィンドウに表示されているワークフロー ファイルから削除されたコンテナー、矢印、アクティビティが赤色に強調表示され、それぞれの正確な数も表示されます。

図 11. パッケージの比較

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:
   • 追加されたコンテンツは緑
   • 編集されたコンテンツは黄
   • 削除されたコンテンツは赤

図 12. パッケージの比較

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

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.

図 13. ワークフローの比較

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.