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