統合パック ウィザード
重要
このバージョンの Orchestrator はサポート終了に達しました。 Orchestrator 2019 にアップグレードすることをお勧めします。
統合パック ウィザード (IP ウィザード) を使用すると、既存の統合アセンブリから新しい統合パックを作成 できます。 統合アセンブリ は、Command-Line アクティビティ ウィザード (CLIActivityWizard) または Orchestrator SDK を使用して作成できます。 IP ウィザード (IPWizard) は、アセンブリ、依存ファイル、および必要なメタデータを .OIP 、Orchestrator Deployment Manager を介して展開できるファイルにパッケージ化します。
完全なブランド化とカスタム アイコンを使用してプロフェッショナルな見た目の統合パックを作成したり、コマンド ライン アクティビティをパッケージ化するだけで、IP ウィザードを使用して簡単に展開できます。
統合パックを作成するタイミングの決定
Toolkit の .NET Integration Pack アクティビティでアクティビティを個別に使用するのが適切か、または統合パックですべてのアクティビティを作成して展開する方が適切かどうかを決定することが重要です。
アクティビティが少ない場合、または開発フェーズでアクティビティに多くの変更を作成する場合は、Toolkit .NET Integration Pack アクティビティでアセンブリを使用して Runbook でこれらのアクティビティを実行するだけです。 統合パックのパッケージ化、登録、デプロイ、アンインストール、アップグレードでは、開発プロセスで大きなオーバーヘッドが発生します。
テストするアクティビティのグループがある場合、または開発サイクルでさらに進み、インストールまたはアップグレードのエンドツーエンド プロセス全体をテストする場合は、Integration Pack を作成することをお勧めします。 Integration Pack は、より使いやすいエクスペリエンスと完全なインストール エクスペリエンスを提供します。 統合パックを使用すると、organization全体または外部のお客様に複数の Runbook サーバーまたは Runbook デザイナーにアクティビティを展開することもできます。
新しい統合パックの作成
統合パック ウィザードを使用すると、既存の Orchestrator 互換アセンブリと依存ファイルから統合パックを作成できます。 Orchestrator 互換アセンブリをまだ作成していない場合は、 コマンド ライン アクティビティ ウィザードを参照してください。
注意
Integration Toolkit には、カスタム統合パックを作成するために IP ウィザードによって使用される Windows インストーラー XML (WiX) ツールセットのバイナリは含まれていません。 IP ウィザードを使用する前に、 WiX ツールセット の最新バージョン (v3.11) をインストールしてください。
新しい統合パックを作成するには
統合パック ウィザードを起動します。 [Orchestrator Integration Pack ウィザードの開始] >を選択します。 ウェルカム ページが表示されます。
更新する既存の統合パックがある場合は、[ 統合パックのインポート] を選択します。 詳細については、「 既存の統合パックの更新」を参照してください。 新しい統合パックを作成するには、[ 次へ] を選択します。
重要
既存の IP をアップグレードする場合は、[ 統合パックのインポート] を選択する必要があります。 [次へ] を選択すると、以前のアセンブリを再利用して同じ製品とファイル名を使用した場合でも、作成する IP には、すべてのアクティビティに対して新しい一意の製品 ID と新しい一意の ID が設定されます。
[ 製品の詳細 ] ページで、必要に応じて情報を入力または変更して、Integration Pack に関する情報をカスタマイズします。 次の表では、フィールドとその説明について説明します。
フィールド名 説明 製品名 Deployment Manager に表示される IP の名前 カテゴリ名 Runbook Designer の [アクティビティ] ウィンドウに IP のカテゴリ タイトルとして表示されるテキスト [会社] 会社名。 この情報は、[パブリッシャー] の [プログラムの追加と削除] に表示されます EULA ファイル 拡張子が付いた RTF 形式の .EULAテキスト ファイル。 EULA は、Deployment Manager を使用して登録中にユーザーに表示され、登録前に同意する必要があります。リソース ファイル カテゴリアイコンとアクティビティアイコンを提供するために使用されるアイコンやその他のリソースを含むアセンブリ。 既定では、標準の Toolkit リソース ファイルが使用されます (Microsoft.SystemCenter.Orchestrator.Integration.Toolkit.Wizard.Images.dll) バージョン Deployment Manager に表示され、IP がアップグレードであるかどうかを判断するために使用される統合パックのバージョン番号。 アップグレードを有効にする 既存の統合パックをインポートした場合、このチェック ボックスは既定でオンになり、この統合パックで既存のインストール済みバージョンをアップグレードできます。 このチェック ボックスをオフにすると、IP の新しい製品 ID とアクティビティ ID が作成されます (既存のバージョンはアップグレードされません)。 複数のバージョンの IP のサイド バイ サイド インストールを有効にする場合は、このチェック ボックスをオフにします。 説明 統合パックの詳細な説明 カテゴリ アイコン 既定のカテゴリ アイコンが表示されます。 別のアイコンを選択する場合は、[ 変更 ] ボタンを選択し、新しいアイコンを選択し、[ OK] を選択します。 製品情報の入力が完了したら、[ 次へ] を選択します。 [アクティビティ] ページが表示されます。 [アクティビティ] ページでは、Command-Line アクティビティ ウィザードを使用して定義した、または Orchestrator SDK を使用して作成したアクティビティを含むアセンブリを参照します。
IP に新しいアクティビティを追加するには、[追加] を選択 します。
アセンブリ ファイルを開いて追加するには、[ライブラリ] の右側にある省略記号 (...) ボタンを選択します。 目的のアセンブリ ファイルを参照して選択し、[ 開く] を選択します。 ファイル名とパスが [ライブラリ] フィールドに表示されます。
アセンブリからアクティビティを選択するには、[ クラス ] ドロップダウン矢印を選択し、一覧から適切なアクティビティ名を選択します。 アクティビティで定義されている名前と説明は、[ 表示名] フィールドと [ 説明 ] フィールドに表示されます。
必要に応じて、アクティビティの表示名と説明を変更します。
アクティビティの既定のアクティビティ アイコンが表示されます。 別のアイコンが必要な場合は、[ 変更] を選択し、ブラウザーから別のアイコンを選択して、[ OK] を選択します。
[ OK] を選択 してアクティビティ定義を保存します。 アクティビティの名前と説明が [アクティビティ] リストに表示されるようになりました。
必要に応じて、リストにアクティビティを追加し続けます。 アクティビティの追加が完了したら、[ 次へ] を選択します。 [依存関係と含まれるファイル] ページが表示されます。
このページでは、Integration Pack でパッケージ化する追加のファイルの一覧を定義できます。 これらのファイルは、アクティビティ、スクリプト、ドキュメント、またはアクティビティと共に Runbook サーバーと Runbook デザイナーに展開するその他のファイルに必要な追加のアセンブリである可能性があります。 [ 追加] を選択し、必要なファイルを選択し、[ OK] を 選択して一覧にファイルを追加します。
一覧へのファイルの追加が完了したら、[ 次へ] を選択します。 [Orchestrator Integration Pack ファイル] ページが表示されます。
表示されたテキストボックスに、作成する統合パックのパスとファイル名を入力します。 既に存在するファイル名を入力すると、上書きされます。 指定したパスに書き込むのに十分なアクセス権があることを確認してください。または、プロセスが失敗します。 パスが指定されていない場合、OIP ファイルは Documents フォルダー (
C:\users\<your username>\Documents) に作成されます。 [ 次へ] を選択して IP の構築を開始します。重要
ファイル名の文字は、オペレーティング システムにインストールされている言語に対して有効である必要があります。
重要
一般的ではない統合パックの名前を指定して、別の統合パックの名前と一致しないようにします。 Orchestrator は、同じ名前の 2 つの統合パックをインストールできません。
IP が正常に構築されると、ウィザードの最後のページに新しい OIP ファイルのパスとファイル名が表示されます。 [完了] を選択してウィザードを終了します。 エラーが発生した場合は、[ 戻る ] を選択してビルド プロセスを再試行できます。
統合パックのデプロイの詳細については、統合パックを 追加する方法に関する記事を参照してください。
既存の統合パックの更新
Orchestrator 統合パック ウィザードを使用すると、既存の統合パックをインポートして、変更を加え、新しいバージョンとして再パッケージ化することができます。 [アップグレードを有効にする] チェックボックスをチェックしていることを確認します。そうしないと、以前にインストールしたバージョンを置き換えたりアップグレードしたりするのではなく、新しい IP が作成されます。
IP アップグレードに関する役立つヒント
基になるアセンブリの更新
統合パックを作成すると、IP に関するメタデータがパッケージに格納され、後続のアップグレード時にウィザードで読み取ることができます。 アクティビティやそれらのアクティビティの基になるアセンブリなどの特定の項目を更新する場合は、IP を再構築する必要があります。 ただし、アクティビティ設定を変更して新しいアセンブリ ファイルを選択すると、[アクティビティ情報] ページのフィールドがリセットされ、情報を再度入力する必要があります。
アセンブリのみを変更しながら、IP 構成設定を保持できます。 新しいアセンブリを、前のアセンブリと同じパスとファイル名に保存します ([アクティビティ情報] ダイアログの [ライブラリ] フィールドに表示されます)。
QIK Integration Pack の移行
Opalis QIK ウィザードを使用して統合パックを作成した場合は、Orchestrator でインポートして使用する前に、Orchestrator と互換性のあるものに変換する必要があります。
IP を変換する前に、次の手順を完了する必要があります。
IP のアクティビティが QIK CLI ウィザードを使用して作成された場合は、「 QIK CLI アクティビティの移行」 で説明されている手順に従って Orchestrator と互換性を持たなければなりません。 アクティビティを含むアセンブリの個別のコピーがない場合は、最初に Opalis 6.3 サーバーに IP をインストールし、次のディレクトリ
C:\Program Files (x86)\Common Files\Opalis Software\Opalis Integration Server\Extensions\Support\Quick Integration Kit 3でアセンブリを見つける必要があります。IP のアクティビティが Opalis API を使用して C# でカスタム開発された場合は、「 QIK API カスタム アクティビティの移行 」で説明されている手順に従って Orchestrator との互換性を保つ必要があります。
注意
Opalis API for Java を使用する Java ベースのアクティビティは、Integration Toolkit または Orchestrator ではサポートされなくなりました。
IP に依存ファイルまたはその他のインクルード ファイルが含まれている場合は、それらのファイルを使用して新しい IP に再パッケージ化する必要があります。 これらのファイルの個別のコピーがない場合は、最初に Opalis 6.3 サーバーに IP をインストールしてから、次のディレクトリ
C:\Program Files (x86)\Common Files\Opalis Software\Opalis Integration Server\Extensions\Support\Binにあるファイルを見つける必要があります。アクティビティ アイコンとカテゴリ アイコンに使用されるカスタム リソース ファイルが IP に含まれている場合は、そのファイルを新しい IP で使用できる必要があります。 このファイルの別のコピーがない場合は、最初に Opalis 6.3 サーバーに IP をインストールし、次のディレクトリ
C:\Program Files (x86)\Common Files\Opalis Software\Opalis Integration Server\Extensionsでファイルを見つける必要があります。IP でカテゴリまたはアクティビティ アイコンに QIK によって提供される標準アイコンを使用していて、Orchestrator で提供される新しいアイコンを使用する代わりにこれらのアイコンを引き続き使用する場合は、ファイルを取得
Opalis.QIK.Wizard.Images.dllし、カスタム リソース ファイルと同様に使用する必要があります。 このファイルの別のコピーがない場合は、最初に Opalis 6.3 サーバーに IP をインストールし、次のディレクトリC:\Program Files (x86)\Common Files\Opalis Software\Opalis Integration Server\Extensionsでファイルを見つける必要があります。
注意
最も簡単な変換プロセスを行うには、IP ウィザードを開始する前に、IP が最初にパッケージ化された場所にこれらのファイルをすべて配置する必要があります。 IP ウィザードは、これらのファイルを元のパスで参照します。 すべてのファイルで新しいパスを選択できますが、アクティビティを含むアセンブリの新しいパスを選択すると、アクティビティの詳細の一部がリセットされ、情報を再入力する必要があります。 ファイルの元のパスを使用することで、既存の情報を再入力しなくても再利用できます。
Opalis 互換統合パックを変換するには
統合パック ウィザードを開始する
[ 統合パックのインポート] を選択します。
既存の OIP ファイルを選択し、[ 開く] を選択します。
IP が Orchestrator と互換性がないことを示す警告メッセージが表示されます。 [OK] を選択します。
必要に応じて製品の詳細を変更し、変更を反映します。 IP のバージョン番号が自動的にインクリメントされ、[アップグレード] チェックボックスがオンになります。 [次へ] を選択します。
[アクティビティ] ページで、各アクティビティを確認し、情報が正しく完了していることを確認します。 アクティビティのアセンブリが移行されていないか、IP の作成時と同じ場所にない場合は、[ クラス ] フィールドは空になります。 情報を再入力しないようにするには、ウィザードを開始する前にアセンブリを置き換える必要があります。
アクティビティの編集が完了したら、[ 次へ] を選択します。
依存ファイルがまだ示されているのと同じ場所にあることを確認するか、それらを削除して新しい依存ファイルを追加します。 [次へ] を選択します。
新しい IP ファイルのパスとファイル名を入力します。 前の IP のコピーを確実に保持できるように、前の IP と同じ名前を使用しないでください。 [ 次へ] を選択して IP をビルドします。
Orchestrator と互換性があり、Orchestrator Deployment Manager を使用して登録およびデプロイできる IP が作成されました。
統合パック – 既知の問題
ファイル名の長さの制限
統合パックにアセンブリを含めると、インストーラーによって自動的にレジストリに追加されます。 レジストリ キー名の長さの制限により、アセンブリの結合パスとファイル名は 234 文字を超えることはできません。 IP 内のアセンブリが配置される既定のパスを指定すると、含まれるアセンブリ ファイルの最大ファイル名の長さは 80 文字を超えることはできません。 ファイル名が 80 文字を超えるアセンブリがインストールに含まれている場合、インストールは失敗します。
Orchestrator のリソース
System Center Orchestrator 用に提供されるこのオンライン リファレンスに加えて、Runbook の構築、Integration Toolkit の使用、ベスト プラクティスに関する追加情報を提供できる多くのリソースがあります。
関連項目
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示