パッケージを管理する

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

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. (コンテナーの場合のみ) コンテナー アクティビティをダブルクリックします。[比較中] ウィンドウに、両バージョンのパッケージに存在するアクティビティだけが表示され、それらのアクティビティについて重点的に確認することができます。ワークフロー ファイルのいずれか一方だけに存在するアクティビティは、そのワークフローの側に表示されます。コンテナーからワークフローに戻るには、階層リンクをクリックします。

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

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