Integration Pack Wizard

Artikel
11/06/2024

Der Integrationspaket-Assistent (IP-Assistent) ermöglicht es Ihnen, ein neues Integrationspaket aus einer vorhandenen Integrationsassembly zu erstellen. Integrationsversammlungen können mithilfe des Befehlszeilen-Aktivitätsassistenten (CLIActivityWizard) oder mithilfe des Orchestrator SDK erstellt werden. Der IP-Assistent (IPWizard) packt die Assemblys, abhängigen Dateien und erforderlichen Metadaten in eine .OIP-Datei, die über den Orchestrator-Bereitstellungs-Manager bereitgestellt werden kann. Sie können professionell aussehende Integrationspakete mit vollständigem Branding und benutzerdefinierten Symbolen erstellen oder einfach Befehlszeilenaktivitäten so zusammenstellen, dass sie mit dem IP-Assistenten einfacher bereitgestellt werden können.

Entscheiden, wann ein Integrationspaket erstellt werden soll

Es ist wichtig zu entscheiden, ob es sinnvoll ist, die Aktivitäten einzeln mit den Aktivitäten des .NET-Integrationspakets des Toolkits zu verwenden, oder ob es besser ist, alle Aktivitäten in einem Integrationspaket zu erstellen und bereitzustellen.

Wenn Sie nur wenige Aktivitäten haben oder sich in der Entwicklungsphase befinden und viele Änderungen an einer Aktivität vornehmen, sollten Sie einfach die Assemblys mit den .NET-Integrationspaket-Toolkit-Aktivitäten verwenden, um diese Aktivitäten in Runbooks auszuführen. Das Verpacken, Registrieren, Bereitstellen, Deinstallieren und Aktualisieren von Integrationspaketen verursacht im Entwicklungsprozess hohen Mehraufwand.

Wenn Sie eine Gruppe von Aktivitäten testen möchten oder sich bereits in einer späteren Phase des Entwicklungszyklus befinden und den gesamten End-to-End-Prozess der Installation oder des Upgrades testen möchten, ist die Erstellung eines Integrationspakets der bessere Ansatz. Das Integrationspaket bietet eine benutzerfreundlichere Erfahrung und eine vollständige Installationserfahrung. Integrationspakete ermöglichen auch die Bereitstellung der Aktivitäten für mehrere Runbook-Server oder Runbook-Designer in der gesamten Organisation oder für externe Kundinnen und Kunden.

Erstellen eines neuen Integrationspakets

Mit dem Integrationspaket-Assistenten können Sie Integrationspakete aus den vorhandenen Orchestrator-kompatiblen Assemblys und abhängigen Dateien erstellen. Wenn Sie noch keine Orchestrator-kompatible Assembly erstellt haben, finden Sie weitere Informationen im Befehlszeilen-Aktivitätsassistenten.

Hinweis

Das Integration Toolkit enthält nicht mehr die Binärdateien für das Windows Installer XML (WiX)-Toolset, das vom IP-Assistenten zum Erstellen von benutzerdefinierten Integrationspaketen verwendet wird. Installieren Sie die neueste Version (v3.11) des WiX-Toolsets, bevor Sie den IP-Assistenten verwenden.

Führen Sie die folgenden Schritte aus, um ein neues Integrationspaket zu erstellen:

Starten Sie den Integrationspaket-Assistenten. Wählen Sie Start > Orchestrator-Integrationspaket-Assistent Die Willkommensseite wird angezeigt.
Wenn Sie über ein vorhandenes Integrationspaket verfügen, das Sie aktualisieren möchten, wählen Sie Integrationspaket importieren aus. Weitere Informationen finden Sie unter Aktualisieren eines vorhandenen Integrationspakets. Wählen Sie Weiter, um ein neues Integrationspaket zu erstellen.

Wichtig

Wenn Sie eine vorhandene IP aktualisieren möchten, müssen Sie Integrationspaket importieren auswählen. Wenn Sie auf Weiter klicken, erhält die von Ihnen erstellte IP eine neue eindeutige Produkt-ID und neue eindeutige IDs für alle Aktivitäten, selbst wenn Sie eine frühere Assembly wiederverwenden und dieselben Produkt- und Dateinamen verwenden.

Geben Sie auf der Seite Produktdetails die erforderlichen Informationen ein oder ändern Sie sie, um die Informationen zu Ihrem Integrationspaket anzupassen. In der folgenden Tabelle werden die Felder und ihre Beschreibungen beschrieben:

Feldname	Beschreibung
Produktname	Der Name der IP, die im Bereitstellungs-Manager angezeigt wird.
Kategoriename	Der Text, der als Kategorietitel für die IP im Bereich „Aktivitäten“ von Runbook Designer angezeigt wird.
Firma	Name Ihres Unternehmens. Diese Informationen werden in „Programme hinzufügen/entfernen“ unter „Herausgeber“ angezeigt.
EULA-Datei	Eine RTF-formatierte Textdatei mit einer `.EULA`-Erweiterung. Die EULA wird den Benutzenden bei der Registrierung mit dem Bereitstellungs-Manager angezeigt und muss vor der Registrierung akzeptiert werden.
Ressourcendatei	Eine Assembly mit Symbolen und anderen Ressourcen, die zur Bereitstellung der Kategorie- und Aktivitätssymbole verwendet werden. Standardmäßig wird die Standard-Toolkit-Ressourcendatei verwendet (Microsoft.SystemCenter.Orchestrator.Integration.Toolkit.Wizard.Images.dll)
Version	Die Versionsnummer des Integrationspakets, das im Bereitstellungs-Manager angezeigt wird und anhand derer festgestellt wird, ob es sich beim IP um ein Upgrade handelt.
Upgrade aktivieren	Wenn Sie ein vorhandenes Integrationspaket importiert haben, ist dieses Kontrollkästchen standardmäßig aktiviert, sodass dieses Integrationspaket eine vorhandene installierte Version aktualisieren kann. Wenn Sie dieses Kontrollkästchen deaktivieren, werden neue Produkt- und Aktivitäts-IDs für das IP erstellt (es wird keine vorhandene Version aktualisiert). Wenn Sie die parallele Installation mehrerer Versionen Ihres IP ermöglichen möchten, deaktivieren Sie dieses Kontrollkästchen.
Beschreibung	Eine detaillierte Beschreibung Ihres Integrationspakets
Kategoriesymbol	Das Standardkategoriesymbol wird angezeigt. Wenn Sie ein anderes Symbol auswählen möchten, wählen Sie die Schaltfläche Ändern, dann ein neues Symbol und dann OK aus.

Wenn Sie mit der Eingabe von Produktinformationen fertig sind, wählen Sie Weiter aus. Die Seite „Aktivitäten“ wird angezeigt. Auf der Seite „Aktivitäten“ verweisen Sie auf die Assemblys, die die Aktivitäten enthalten, die Sie mithilfe des Befehlszeilenaktivitäts-Assistenten definiert oder mit dem Orchestrator SDK erstellt haben.
Um dem IP eine neue Aktivität hinzuzufügen, wählen Sie Hinzufügen aus.
Um die Assemblydatei zu öffnen und hinzuzufügen, wählen Sie die Auslassungspunkte (...) rechts neben Bibliothek aus. Navigieren Sie zur gewünschten Assemblydatei, wählen Sie sie aus und wählen Sie Öffnen aus. Der Dateiname und der Pfad werden im Feld „Bibliothek“ angezeigt.
Um eine Aktivität in der Assembly auszuwählen, wählen Sie den Dropdownpfeil Klasse und dann den entsprechenden Aktivitätsnamen aus der Liste aus. Der Name und die Beschreibung, die in der Aktivität definiert sind, werden in den Feldern Anzeigename und Beschreibung angezeigt.
Ändern Sie bei Bedarf den Anzeigenamen und die Beschreibung der Aktivität.
Das Standardaktivitätssymbol wird für die Aktivität angezeigt. Wenn ein anderes Symbol gewünscht wird, wählen Sie Ändern, dann ein anderes Symbol aus dem Browser und dann OK aus.
Wählen Sie OK aus, um die Aktivitätsdefinition zu speichern. Der Aktivitätsname und die Beschreibung werden jetzt in der Liste „Aktivitäten“ angezeigt.
Fügen Sie nach Bedarf weitere Aktivitäten zur Liste hinzu. Wenn Sie alle gewünschten Aktivitäten hinzugefügt haben, wählen Sie Weiter aus. Die Seite „Abhängigkeiten und eingeschlossene Dateien“ wird angezeigt.
Auf dieser Seite können Sie eine Liste mit zusätzlichen Dateien definieren, die mit Ihrem Integrationspaket verpackt werden sollen. Diese Dateien können zusätzliche Assemblys sein, die von Ihren Aktivitäten, Skripts, Dokumentationen benötigt werden, oder anderen Dateien, die Sie zusammen mit Ihren Aktivitäten in Runbook-Servern und Runbook-Designern bereitstellen möchten. Wählen Sie Hinzufügen, die benötigten Dateien und dann OK aus, um der Liste Dateien hinzuzufügen.
Wenn Sie alle Dateien zur Liste hinzugefügt haben, wählen Sie Weiter aus. Die Seite „Orchestrator-Integrationspaketdatei“ wird angezeigt.
Geben Sie im Textfeld den Pfad und den Dateinamen des zu erstellenden Integrationspakets ein. Wenn einen Dateinamen eingeben, der bereits vorhanden ist, wird er überschrieben. Stellen Sie sicher, dass Sie über ausreichende Zugriffsrechte verfügen, um in den angegebenen Pfad zu schreiben. Andernfalls schlägt der Prozess fehl. Wenn kein Pfad angegeben ist, wird die OIP-Datei im Ordner „Dokumente“ (C:\users\<your username>\Documents) erstellt. Wählen Sie Weiter aus, um mit dem Erstellen des IP zu beginnen.

Wichtig

Die Zeichen im Dateinamen müssen für die Sprache gültig sein, die auf Ihrem Betriebssystem installiert ist.

Wichtig

Geben Sie einen Namen für das Integrationspaket an, der nicht häufig verwendet wird, um sicherzustellen, dass er nicht dem Namen eines anderen Integrationspakets gleicht. Orchestrator kann nicht zwei Integrationspakete mit demselben Namen installieren.
Wenn das IP erfolgreich erstellt wurde, zeigt die letzte Seite des Assistenten den Pfad und den Dateinamen der neuen OIP-Datei an. Wählen Sie „Fertig stellen“ aus, um den Assistenten zu verlassen. Wenn ein Fehler auftritt, können Sie Zurück auswählen und den Buildvorgang wiederholen.

Informationen zum Bereitstellen Ihres Integrationspakets finden Sie im Artikel Hinzufügen eines Integrationspakets.

Aktualisieren eines vorhandenen Integrationspakets

Mit dem Orchestrator-Integrationspaket-Assistenten können Sie ein vorhandenes Integrationspaket importieren, sodass Sie Änderungen vornehmen und sie als neue Version erneut packen können. Stellen Sie sicher, dass Sie das Kontrollkästchen Upgrade aktivieren aktiviert haben. Andernfalls wird ein neues IP erstellt, statt die vorherige installierte Version zu ersetzen oder zu aktualisieren.

Hilfreiche Tipps zum IP-Upgrade

Aktualisieren zugrunde liegenden Assemblys

Wenn Sie ein Integrationspaket erstellen, werden Metadaten zum IP im Paket gespeichert, sodass sie bei nachfolgenden Upgrades vom Assistenten gelesen werden können. Wenn Sie bestimmte Elemente wie etwa Aktivitäten oder die zugrunde liegenden Assemblys für diese Aktivitäten aktualisieren, müssen Sie die IP neu erstellen. Wenn Sie jedoch die Aktivitätseinstellungen ändern und eine neue Assemblydatei auswählen, werden die Felder auf der Seite „Aktivitätsinformationen“ zurückgesetzt, sodass Sie die Informationen erneut eingeben müssen.

Sie können die IP-Konfigurationseinstellungen beibehalten, während Sie nur die Assembly ändern. Speichern Sie die neue Assembly mit dem selben Pfad und Dateinamen wie die vorherige Assembly (die im Feld „Bibliothek“ des Dialogfelds „Aktivitätsinformationen“ angezeigt wird).

QIK Integration Pack-Migration

Wenn Sie ein Integrationspaket mit dem Opalis QIK-Assistenten erstellt haben, müssen Sie es konvertieren, damit es mit Orchestrator kompatibel ist, bevor es von Orchestrator importiert und verwendet werden kann.

Vor dem Konvertieren eines IP (Integrationspaket) müssen die folgenden Schritte ausgeführt werden:

Wenn die Aktivitäten in Ihrem IP mit dem QIK CLI Wizard erstellt wurden, müssen Sie die in QIK CLI Activity Migration beschriebenen Schritte ausführen, um sie mit Orchestrator kompatibel zu machen. Wenn Sie keine separate Kopie der Assembly mit den Aktivitäten haben, müssen Sie zuerst das IP auf einem Opalis 6.3-Server installieren und dann die Assembly im folgenden Verzeichnis suchen: C:\Program Files (x86)\Common Files\Opalis Software\Opalis Integration Server\Extensions\Support\Quick Integration Kit 3.
Wenn die Aktivitäten in Ihrem IP mithilfe der Opalis-API in C# entwickelt wurden, müssen Sie die in Migrating QIK API Custom Activities beschriebenen Schritte befolgen, um sie mit Orchestrator kompatibel zu machen.

Hinweis

Java-basierte Aktivitäten, die die Opalis-API für Java verwenden, werden nicht mehr vom Integration Toolkit oder von Orchestrator unterstützt.
Wenn Ihr IP abhängige oder andere enthaltene Dateien enthält, müssen diese Dateien verfügbar sein, um sie in das neue IP umzuverpacken. Wenn Sie nicht über eine separate Kopie dieser Dateien verfügen, müssen Sie das IP zuerst auf einem Opalis 6.3-Server installieren und dann die Dateien im folgenden Verzeichnis suchen: C:\Program Files (x86)\Common Files\Opalis Software\Opalis Integration Server\Extensions\Support\Bin
Wenn Ihr IP eine benutzerdefinierte Ressourcendatei enthält, die für Aktivitäts- und Kategoriesymbole verwendet wird, muss diese Datei für das neue IP verfügbar sein. Wenn Sie nicht über eine separate Kopie dieser Datei verfügen, müssen Sie das IP zuerst auf einem Opalis 6.3-Server installieren und dann die Datei im folgenden Verzeichnis suchen: C:\Program Files (x86)\Common Files\Opalis Software\Opalis Integration Server\Extensions.
Wenn Ihr IP die von QIK bereitgestellten Standardsymbole für die Kategorie- oder Aktivitätssymbole verwendet hat und Sie diese Symbole weiterhin anstelle der neuen Symbole in Orchestrator verwenden möchten, müssen Sie die Datei Opalis.QIK.Wizard.Images.dll abrufen und wie eine benutzerdefinierte Ressourcendatei verwenden. Wenn Sie nicht über eine separate Kopie dieser Datei verfügen, müssen Sie das IP zuerst auf einem Opalis 6.3-Server installieren und dann die Datei im folgenden Verzeichnis suchen: C:\Program Files (x86)\Common Files\Opalis Software\Opalis Integration Server\Extensions.

Hinweis

Für einen möglichst einfachen Konvertierungsprozess sollten Sie alle diese Dateien an den Speicherorten ablegen, an denen sie sich befanden, als das IP ursprünglich verpackt wurde, bevor Sie den IP-Assistenten starten. Der IP-Assistent verweist auf diese Dateien anhand ihrer ursprünglichen Pfade. Die Auswahl eines neuen Pfads ist für alle Dateien möglich, aber die Auswahl eines neuen Pfads für Assemblys, die Aktivitäten enthalten, führt dazu, dass einige Details der Aktivität zurückgesetzt werden und Sie die Informationen erneut eingeben müssen. Durch die Verwendung der ursprünglichen Pfade für die Dateien werden die vorhandenen Informationen einfach wiederverwendet, ohne sie erneut eingeben zu müssen.

Konvertieren eines Opalis-kompatiblen Integrationspakets

Starten Sie den Integrationspaket-Assistenten.
Wählen Sie Integrationspaket importieren aus.
Wählen Sie die vorhandene OIP-Datei aus und wählen Sie Öffnen.
Es wird eine Warnmeldung angezeigt, die angibt, dass das IP nicht mit Orchestrator kompatibel ist. Wählen Sie OK aus.
Ändern Sie die Produktdetails nach Bedarf, um alle Änderungen widerzuspiegeln. Die Versionsnummer des IP wird automatisch erhöht und das Kontrollkästchen „Upgrade“ wird aktiviert. Wählen Sie Weiter aus.
Gehen Sie auf der Seite „Aktivitäten“ jede Aktivität durch und stellen Sie sicher, dass die Informationen korrekt ausgefüllt sind. Wenn die Assembly für die Aktivität nicht migriert wurde oder sich nicht am selben Ort befindet wie zum Zeitpunkt der Erstellung des IP, ist das Feld Klasse leer. Um zu vermeiden, dass Sie Informationen erneut eingeben müssen, sollten Sie die Assembly ersetzen, bevor Sie den Assistenten starten.
Wenn Sie mit der Bearbeitung der Aktivitäten fertig sind, wählen Sie Weiter aus.
Stellen Sie sicher, dass sich die abhängigen Dateien noch am gleichen Speicherort wie angegeben befinden, oder entfernen Sie sie und fügen Sie neue abhängige Dateien hinzu. Wählen Sie Weiter aus.
Geben Sie einen Pfad und Dateinamen für die neue IP-Datei ein. Verwenden Sie nicht denselben Namen wie beim vorherigen IP, damit Sie sicherstellen können, dass Sie eine Kopie des vorherigen IP behalten. Wählen Sie Weiter, um das IP zu erstellen.

Sie haben jetzt ein IP, das mit Orchestrator kompatibel ist und mit Orchestrator-Bereitstellung-Manager registriert und bereitgestellt werden kann.

Integrationspakete – Bekannte Probleme

Einschränkung der Dateinamenlänge

Wenn Sie Assemblys in Ihr Integrationspaket aufnehmen, werden diese automatisch vom Installationsprogramm zur Registrierung hinzugefügt. Aufgrund der Beschränkung der Länge von Registrierungsschlüsseln darf der kombinierte Pfad- und Dateiname einer Assembly 234 Zeichen nicht überschreiten. Aufgrund des Standardpfads, in dem Assemblys innerhalb eines IP abgelegt werden, darf die maximale Dateinamenlänge einer enthaltenen Assembly-Datei 80 Zeichen nicht überschreiten. Wenn eine Assembly mit einem Dateinamen, der mehr als 80 Zeichen enthält, in der Installation enthalten ist, schlägt die Installation fehl.

Orchestrator-Ressourcen

Zusätzlich zu dieser Online-Referenz für System Center Orchestrator gibt es viele Ressourcen, die zusätzliche Informationen zur Erstellung von Runbooks, zur Verwendung des Integration Toolkits und zu Best Practices bieten.

Freigeben über