パッケージを管理する

Orchestrator でさまざまな種類のパッケージ バージョンを表示、ダウンロード、管理します。

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

1. [ パッケージ] で、パッケージの種類に応じた目的のタブを選択します。グリッドで、パッケージの [ その他のアクション ] を選択し、[ バージョンを表示] を選択します。[ パッケージ バージョン ] ウィンドウが表示されます。
2. ダウンロードする対応するパッケージ バージョンの [ その他のアクション ] > [ パッケージをダウンロード ] を選択します。パッケージが、ブラウザーで設定されている既定の場所に .nupkg 形式でダウンロードされます。ここから、別の Orchestrator インスタンスにアップロードできます。
   注:

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

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

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

注:

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

1. [ パッケージ] で、パッケージの種類に応じて目的のタブを選択し、 アップロード ボタンを選択します。[ パッケージを追加 ] ウィンドウが表示されます。

2. [ 参照 ] を選択して、Orchestrator にアップロードするパッケージ ( .nupkg 拡張機能を含む) を選択します。

3. アップロードされる以前のバージョンのパッケージを使用しているプロセスをすべて表示するには、[アップグレードできるプロセスを確認する] を選択します。

4. [ アップロード] を選択します。パッケージは Orchestrator によって自動的に判別されます。アップロードしたパッケージが [テナント> パッケージ] 下の対応するグリッドに表示されます。[ アップグレードできるプロセスを確認する ] オプションを選択した場合は、新しいパッケージ バージョンへのアップグレードが可能なプロセスのリストを示す [ 複数のプロセスをアップグレード ] ウィンドウが表示されます。

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

   

5. チェックボックスを使用してアップグレードするプロセスを選択し、[ アップグレード] を選択します。選択したプロセスが新しいパッケージ バージョンに更新され、ウィンドウが閉じます。パッケージ バージョンのみが更新されます。プロセスのパラメーターやエントリ ポイントをカスタマイズする場合は、プロセスを編集します。

パッケージを削除する

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

1. [ パッケージ] で、パッケージに応じた目的のタブを選択します リストからパッケージを選択します。パッケージの [ その他のアクション ] メニューから [ バージョンを表示] を選択します。[ パッケージ バージョン ] ウィンドウが表示されます。

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

   

2. 1 つ以上のバージョンを選択し、[ 削除] を選択します。または、削除するパッケージ バージョンの [ その他のアクション ] > [ 削除 ] を選択します。選択したパッケージ バージョンが削除されます。

3. 選択したプロセスの非アクティブなバージョンをすべて削除するには、[ すべての非アクティブを削除 ] を選択します。パッケージ バージョンがプロセスの一部である (アクティブである) 場合、そのパッケージ バージョンは 削除されません。すべてのバージョンが非アクティブの場合は、すべて削除されます。

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

1. [ パッケージ] で、パッケージの種類に応じた目的のタブを選択します。リストで、パッケージの [ その他のアクション ] を選択し、[ バージョンを表示] を選択します。[ パッケージ バージョン ] ウィンドウが表示されます。
2. [バージョン] タブでは、選択したパッケージのすべてのパッケージ バージョンを確認できます。
3. 目的のバージョンで、[その他のアクション] > [リリース ノートを表示] を選択します。[リリース ノート] ウィンドウが表示されます。該当するバージョンについて Studio で追加されたノートを確認できます。

さらに、Studio で追加されたノートや、各パッケージ バージョンで使用されている Windows アプリケーションがアルファベット順に表示されます。 識別できないアプリケーションがパッケージで使用されている場合、「不明なアプリ」というエントリが表示され、識別できないアプリの数がサフィックスとして括弧内に示されます。

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

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

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

図 3. パッケージの詳細

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

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

1. [ パッケージ] で、パッケージの種類に応じた目的のタブを選択します。パッケージ リストで、パッケージの [ その他のアクション ] を選択し、[ バージョンを表示] を選択します。[ パッケージ バージョン ] ウィンドウが表示されます。

2. [ 変更ログ ] タブを選択します。ライブラリのすべてのパッケージ バージョンを確認でき、各パッケージについて、バージョン間の変更点に関連する情報が記載されたリリース ノートを確認できます。

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

   

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

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

1. [ パッケージ] で、パッケージの種類に応じた目的のタブを選択します。パッケージの [ その他のアクション ] を選択し、[ バージョンを表示] を選択します。[ パッケージ バージョン ] ウィンドウが表示されます。
2. 目的のパッケージのバージョンの [ その他のアクション ] > [ 引数を表示 ] を選択します。選択したパッケージ バージョンの入力パラメーターと出力パラメーターが表示されます。プロセスを管理する ジョブを管理する トリガーを管理する 編集可能なのは、プロセス、ジョブ、トリガーのレベルのみです。

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

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

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

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

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

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

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

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

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

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

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

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

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

1. [ パッケージ] で、パッケージの種類に応じて目的のタブを選択し、パッケージの横の [ パッケージを確認 ] を選択します。[ パッケージを確認] ウィンドウが表示されます。選択したパッケージのすべてのバージョンにアクセスできます。ただし、[ パッケージを確認] オプションは、[ オートメーション ] グリッドと [テスト オートメーション] グリッドでのみ利用可能です。

2. パッケージ バージョンのリストの上にある[比較] ボタンを選択して、比較モードに切り替えます。各パッケージ バージョンの前にチェック ボックスが表示されます。

3. 比較するパッケージ バージョンのチェック ボックスを選択します。一度に 2 つのパッケージ バージョンだけを比較することができます。

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

4. パッケージ バージョンのリストの下にある 比較ボタンを選択します 。このボタンは、2 つのチェックボックスをオンにするとアクティブになります。[ 比較 ] ウィンドウが表示されます。選択した最新バージョンのワークフロー ファイルを含む結果のリスト、およびプロジェクト作成者および説明が表示されます。Studio でメインに設定されたワークフロー ファイルは、それがわかるようにここでマークされます。また、[ 依存関係] セクションにはプロジェクトの依存関係が表示されます。

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

5. ウィンドウの右上隅にあるいずれかのオプションを選んで、表示する差異を絞り込むことができます。

   • [すべて] - 比較するパッケージ バージョンまたはワークフロー ファイル間の差異をすべて表示します。これは既定で選択されるオプションであり、すべての差異の概要が表示されます。

   • [追加済み] - パッケージ バージョンに追加されたファイル、フォルダー、依存関係、または [比較中] ウィンドウに表示されているワークフロー ファイルに追加されたコンテナー、矢印、アクティビティが緑色に強調表示され、それぞれの正確な数も表示されます。

   • [変更済み] - パッケージ バージョン内で変更されたファイル、フォルダー、依存関係、または [比較中] ウィンドウに表示されているワークフロー ファイル内で変更されたコンテナー、矢印、アクティビティ、プロパティまたはプロパティの値が黄色に強調表示され、それぞれの正確な数も表示されます。

   • [削除済み] - パッケージ バージョンから削除されたファイル、フォルダー、依存関係、または [比較中] ウィンドウに表示されているワークフロー ファイルから削除されたコンテナー、矢印、アクティビティが赤色に強調表示され、それぞれの正確な数も表示されます。

     図 5. 比較ウィンドウ

6. 結果のリストのワークフロー ファイルの横にある [ を比較] ボタンを選択します。2 つのワークフローが、最も古いバージョンのファイルを左にして、並べて表示されます。各ワークフローは、別々にスクロールできます。2 つのバージョンのパッケージ間で、コンテナー、矢印、アクティビティの各レベルでファイルに加えられたすべての変更が、以下のように色分けして強調表示されます。

   • 追加されたコンテンツは緑

   • 編集されたコンテンツは黄

   • 削除されたコンテンツは赤

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

     

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

7. (コンテナのみ)コンテナー アクティビティをダブル選択します。[ 比較 ] ウィンドウには、両方のパッケージ バージョン内のアクティビティのみがフォーカスされて表示されます。アクティビティがワークフロー ファイルの 1 つにのみ存在する場合は、対応するワークフローの側面に表示されます。階層リンクの軌跡をクリックして、コンテナーからワークフローに戻ります。

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

   

8. アクティビティを選択して、そのプロパティの変更を表示します。前述のように、2 つのパッケージ バージョン間でアクティビティに加えられたすべての変更が強調表示され、色分けされます。

パッケージを確認する

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

注:

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

1. [ パッケージ] で、パッケージの種類に応じて目的のタブを選択し、パッケージの横の [ パッケージを確認 ] を選択します。[ パッケージを確認] ウィンドウが表示されます。選択したパッケージのすべてのバージョンにアクセスできます。ただし、[ パッケージを確認] オプションは、[ オートメーション ] グリッドと [テスト オートメーション] グリッドでのみ利用可能です。

2. 詳細を表示するバージョンを選択します。プロジェクトで利用可能なすべての .xaml ファイルが、プロジェクト作成者、説明、および Orchestrator にアップロードされた日付とともに表示されます。Studio でメインに設定された .xaml ファイルは、それがわかるようにここでマークされます。また、[依存関係] セクションにはプロジェクトの依存関係が表示されます。

3. .xaml ファイルを選択します。ワークフローが表示されます。

4. 選択したファイルで使用できるすべての変数、引数、またはインポートを表示するには、[変数]、[引数]、または [インポート] ボタンを選択します。Studio で使用できるパネルに似た、対応するパネルが表示されます。

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

   

5. スコープをダブル選択すると、ワークフローのフォーカスされたビューが表示されます。

   図 9. ワークフロー

   

6. ワークフロー セクションをよく表示するには、[ すべて展開 ] を選択します。

7. アクティビティを選択して、そのプロパティを表示します。プロパティの値をコピーすることもできます。

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