Assistant Inscription des packs d’intégration

Article
04/03/2024

Important

Cette version d’Orchestrator a atteint la fin du support. Nous vous recommandons de mettre à niveau vers Orchestrator 2019.

L’Assistant Pack d’intégration (Assistant IP) vous permet de créer un pack d’intégration à partir d’un assembly d’intégration existant. Les assemblys d’intégration peuvent être créés à l’aide de l’Assistant Activité Command-Line (CLIActivityWizard) ou du Kit de développement logiciel (SDK) Orchestrator. L’Assistant IP (IPWizard) empaquette les assemblys, les fichiers dépendants et les métadonnées requises dans un .OIP fichier qui peut être déployé via le Gestionnaire de déploiement Orchestrator. Vous pouvez créer des packs d’intégration d’aspect professionnel avec une personnalisation complète et des icônes personnalisées, ou simplement empaqueter des activités en ligne de commande afin qu’elles puissent être déployées plus facilement à l’aide de l’Assistant IP.

Décider quand créer un pack d’intégration

Il est important de décider s’il est approprié d’utiliser des activités individuellement avec les activités du Pack d’intégration .NET du Kit de ressources, ou s’il est préférable de créer et de déployer toutes les activités dans un pack d’intégration.

Lorsque vous n’avez que peu d’activités ou que vous êtes en phase de développement et que vous créez de nombreuses modifications dans une activité, vous devez simplement utiliser les assemblys avec les activités du Kit de ressources .NET Integration Pack pour exécuter ces activités dans les Runbooks. L’empaquetage, l’inscription, le déploiement, la désinstallation et la mise à niveau des packs d’intégration entraînent une surcharge importante dans le processus de développement.

Si vous avez un groupe d’activités à tester ou si vous êtes plus loin dans le cycle de développement et que vous souhaitez tester l’ensemble du processus d’installation ou de mise à niveau de bout en bout, la création d’un pack d’intégration est la meilleure approche. Le pack d’intégration offre une expérience plus conviviale et une expérience d’installation complète. Les packs d’intégration permettent également le déploiement des activités sur plusieurs serveurs runbook ou concepteurs de runbooks dans le organization ou sur des clients externes.

Création d’un nouveau pack d’intégration

L’Assistant Pack d’intégration vous permet de créer des packs d’intégration à partir des assemblys et des fichiers dépendants compatibles Avec Orchestrator existants. Si vous n’avez pas encore créé d’assembly compatible Avec Orchestrator, consultez l’Assistant Activité de ligne de commande.

Notes

Le Kit de ressources d’intégration n’inclut plus les fichiers binaires de l’ensemble d’outils Windows Installer XML (WiX), qui est utilisé par l’Assistant IP pour créer des packs d’intégration personnalisés. Installez la dernière version (v3.11) de l’ensemble d’outils WiX avant d’utiliser l’Assistant IP.

Pour créer un pack d’intégration

Démarrez l’Assistant Pack d’intégration. Sélectionnez Démarrer > l’Assistant Pack d’intégration Orchestrator. La page d’accueil s’affiche.
Si vous souhaitez mettre à jour un pack d’intégration existant, sélectionnez Importer le pack d’intégration. Pour plus d’informations, consultez Mise à jour d’un pack d’intégration existant. Pour créer un pack d’intégration, sélectionnez Suivant.

Important

Si vous souhaitez mettre à niveau une adresse IP existante, vous devez sélectionner Importer le pack d’intégration. Si vous sélectionnez Suivant, l’adresse IP que vous créez aura un nouvel ID de produit unique et de nouveaux ID uniques pour toutes les activités, même si vous réutilisez un assembly précédent et utilisez le même produit et les mêmes noms de fichier.

Dans la page Détails du produit , entrez ou modifiez les informations nécessaires pour personnaliser les informations relatives à votre pack d’intégration. Le tableau ci-dessous décrit les champs et leurs descriptions :

Nom du champ	Description
Nom du produit	Nom de l’adresse IP qui s’affiche dans le Gestionnaire de déploiement
Nom de la catégorie	Texte qui s’affiche comme titre de catégorie pour l’adresse IP dans le volet Activités de Runbook Designer
Company	Nom de votre société. Ces informations s’affichent dans Ajout/Suppression de programmes sous « Publisher »
Fichier CLUF	Fichier texte au format RTF avec une `.EULA` extension. Le CLUF est affiché à l’utilisateur lors de l’inscription à l’aide du Gestionnaire de déploiement et doit être accepté avant l’inscription.
Fichier de ressources	Assembly contenant des icônes et d’autres ressources utilisées pour fournir les icônes de catégorie et d’activité. Par défaut, le fichier de ressources toolkit standard est utilisé (Microsoft.SystemCenter.Orchestrator.Integration.Toolkit.Wizard.Images.dll)
Version	Numéro de version du pack d’intégration, qui sera affiché dans le Gestionnaire de déploiement et utilisé pour déterminer si l’adresse IP est une mise à niveau.
Activer la mise à niveau	Si vous avez importé un pack d’intégration existant, cette case est cochée par défaut, ce qui permet à ce pack d’intégration de mettre à niveau une version installée existante. Si vous décochez cette case, de nouveaux ID de produit et d’activité seront créés pour l’adresse IP (il ne mettra pas à niveau une version existante). Si vous souhaitez activer l’installation côte à côte de plusieurs versions de votre adresse IP, décochez cette case.
Description	Description détaillée de votre Pack d’intégration
Icône catégorie	L’icône de catégorie par défaut s’affiche. Si vous souhaitez choisir une autre icône, sélectionnez le bouton Modifier , sélectionnez une nouvelle icône, puis sélectionnez OK.

Lorsque vous avez terminé d’entrer les informations sur le produit, sélectionnez Suivant. La page Activités s’affiche. La page Activités vous permet de référencer l’assembly ou les assemblys qui contiennent les activités que vous avez définies à l’aide de l’Assistant Activité Command-Line ou créées à l’aide du Kit de développement logiciel (SDK) Orchestrator.
Pour ajouter une nouvelle activité à l’adresse IP, sélectionnez Ajouter.
Pour ouvrir et ajouter le fichier d’assembly, sélectionnez le bouton de sélection (...) à droite de La bibliothèque. Accédez au fichier d’assembly souhaité, sélectionnez-le, puis sélectionnez Ouvrir. Le nom de fichier et le chemin d’accès sont affichés dans le champ Bibliothèque.
Pour sélectionner une activité dans l’assembly, sélectionnez la flèche déroulante Classe et sélectionnez le nom d’activité approprié dans la liste. Le nom et la description définis dans l’activité sont affichés dans les champs Nom d’affichage et Description .
Si vous le souhaitez, modifiez le nom d’affichage et la description de l’activité.
L’icône d’activité par défaut s’affiche pour l’activité. Si une autre icône est souhaitée, sélectionnez Modifier, sélectionnez une autre icône dans le navigateur, puis sélectionnez OK.
Sélectionnez OK pour enregistrer la définition d’activité. Le nom et la description de l’activité s’affichent désormais dans la liste Activités.
Continuez à ajouter des activités à la liste en fonction des besoins. Lorsque vous avez terminé d’ajouter des activités, sélectionnez Suivant. La page Dépendances et fichiers inclus s’affiche.
Dans cette page, vous pouvez définir une liste de fichiers supplémentaires que vous souhaitez empaquetés avec votre pack d’intégration. Ces fichiers peuvent être des assemblys supplémentaires requis par vos activités, scripts, documentation ou autres fichiers que vous souhaitez déployer sur des serveurs runbook et des concepteurs de runbooks avec vos activités. Sélectionnez Ajouter, sélectionnez le ou les fichiers dont vous avez besoin, puis sélectionnez OK pour ajouter des fichiers à la liste.
Lorsque vous avez terminé d’ajouter des fichiers à la liste, sélectionnez Suivant. La page Fichier du pack d’intégration Orchestrator s’affiche.
Dans la zone de texte fournie, entrez le chemin d’accès et le nom de fichier du pack d’intégration à créer. Si vous entrez un nom de fichier qui existe déjà, il sera remplacé. Vérifiez que vous disposez d’un accès suffisant pour écrire dans le chemin spécifié, sinon le processus échouera. Si aucun chemin d’accès n’est spécifié, le fichier OIP est créé dans le dossier Documents (C:\users\<your username>\Documents). Sélectionnez Suivant pour commencer à générer l’adresse IP.

Important

Les caractères du nom de fichier doivent être valides pour la langue installée sur votre système d’exploitation.

Important

Spécifiez un nom pour le pack d’intégration qui n’est pas courant pour vous assurer qu’il ne correspond pas au nom d’un autre pack d’intégration. Orchestrator ne peut pas installer deux packs d’intégration portant le même nom.
Une fois l’adresse IP générée, la dernière page de l’Assistant affiche le chemin d’accès et le nom du nouveau fichier OIP. Sélectionnez Terminer pour quitter l’Assistant. En cas d’erreur, vous pouvez sélectionner Précédent et réessayer le processus de génération.

Pour plus d’informations sur le déploiement de votre pack d’intégration, consultez l’article Comment ajouter un pack d’intégration.

Mise à jour d’un pack d’intégration existant

L’Assistant Pack d’intégration Orchestrator vous permet d’importer un pack d’intégration existant afin d’apporter des modifications et de le reconditionner en tant que nouvelle version. Veillez à case activée la case à cocher Activer la mise à niveau, sinon une nouvelle adresse IP sera créée au lieu de remplacer ou de mettre à niveau la version installée précédente.

Conseils utiles sur la mise à niveau IP

Mise à jour des assemblys sous-jacents

Lorsque vous créez un pack d’intégration, les métadonnées relatives à l’adresse IP sont stockées dans le package afin qu’il puisse être lu par l’Assistant lors des mises à niveau suivantes. Lorsque vous mettez à jour certains éléments tels que les activités ou les assemblys sous-jacents pour ces activités, vous devez reconstruire l’adresse IP. Toutefois, si vous modifiez les paramètres d’activité et sélectionnez un nouveau fichier d’assembly, il réinitialise les champs de la page Informations d’activité, ce qui vous oblige à entrer à nouveau les informations.

Vous pouvez conserver les paramètres de configuration IP tout en modifiant uniquement l’assembly. Enregistrez votre nouvel assembly dans le même chemin d’accès et le même nom de fichier que l’assembly précédent (qui s’affiche dans le champ Bibliothèque de la boîte de dialogue Informations sur l’activité).

Migration du pack d’intégration QIK

Si vous avez créé un pack d’intégration à l’aide de l’Assistant QIK Opalis, vous devez le convertir pour qu’il soit compatible avec Orchestrator avant de pouvoir l’importer et l’utiliser par Orchestrator.

Avant de convertir une adresse IP, les étapes suivantes doivent être effectuées :

Si les activités de votre adresse IP ont été créées à l’aide de l’Assistant CLI QIK, vous devez suivre les étapes décrites dans Migration d’activité CLI QIK pour les rendre compatibles avec Orchestrator. Si vous ne disposez pas d’une copie distincte de l’assembly contenant les activités, vous devez d’abord installer l’adresse IP sur un serveur Opalis 6.3, puis localiser l’assembly dans le répertoire suivant : C:\Program Files (x86)\Common Files\Opalis Software\Opalis Integration Server\Extensions\Support\Quick Integration Kit 3.
Si les activités de votre adresse IP ont été personnalisées en C# à l’aide de l’API Opalis, vous devez suivre les étapes décrites dans Migration des activités personnalisées de l’API QIK pour les rendre compatibles avec Orchestrator.

Notes

Les activités basées sur Java utilisant l’API Opalis pour Java ne sont plus prises en charge par Integration Toolkit ou par Orchestrator.
Si votre adresse IP contient des fichiers dépendants ou d’autres fichiers inclus, ces fichiers doivent être disponibles pour être reconditionnés dans la nouvelle adresse IP. Si vous ne disposez pas d’une copie distincte de ces fichiers, vous devez d’abord installer l’adresse IP sur un serveur Opalis 6.3, puis localiser les fichiers dans le répertoire suivant : C:\Program Files (x86)\Common Files\Opalis Software\Opalis Integration Server\Extensions\Support\Bin.
Si votre adresse IP contient un fichier de ressources personnalisé utilisé pour les icônes d’activité et de catégorie, ce fichier doit être disponible pour la nouvelle adresse IP. Si vous ne disposez pas d’une copie distincte de ce fichier, vous devez d’abord installer l’adresse IP sur un serveur Opalis 6.3, puis localiser le fichier dans le répertoire suivant : C:\Program Files (x86)\Common Files\Opalis Software\Opalis Integration Server\Extensions.
Si votre adresse IP a utilisé les icônes standard fournies par QIK pour les icônes de catégorie ou d’activité et que vous souhaitez continuer à utiliser ces icônes au lieu d’utiliser les nouvelles icônes fournies dans Orchestrator, vous devez obtenir le Opalis.QIK.Wizard.Images.dll fichier et l’utiliser comme vous le feriez pour un fichier de ressources personnalisé. Si vous ne disposez pas d’une copie distincte de ce fichier, vous devez d’abord installer l’adresse IP sur un serveur Opalis 6.3, puis localiser le fichier dans le répertoire suivant : C:\Program Files (x86)\Common Files\Opalis Software\Opalis Integration Server\Extensions.

Notes

Pour le processus de conversion le plus simple, vous devez placer tous ces fichiers à l’emplacement où ils se trouvaient lorsque l’adresse IP a été empaquetée à l’origine avant de démarrer l’Assistant IP. L’Assistant IP référence ces fichiers par leurs chemins d’origine. La sélection d’un nouveau chemin d’accès est possible pour tous les fichiers, mais la sélection d’un nouveau chemin d’accès pour les assemblys contenant les activités entraîne la réinitialisation de certains détails de l’activité, ce qui vous oblige à entrer à nouveau les informations. En utilisant les chemins d’accès d’origine pour les fichiers, les informations existantes sont simplement réutilisées sans avoir à les entrer à nouveau.

Pour convertir un pack d’intégration compatible Opalis

Démarrer l’Assistant Integration Pack
Sélectionnez importer le pack d’intégration.
Sélectionnez le fichier OIP existant, puis sélectionnez Ouvrir.
Un message d’avertissement s’affiche indiquant que l’adresse IP n’est pas compatible avec Orchestrator. Sélectionnez OK.
Modifiez les détails du produit si nécessaire pour refléter les modifications éventuelles. Le numéro de version de l’adresse IP est automatiquement incrémenté et la case à cocher « Mettre à niveau » est cochée. Sélectionnez Suivant.
Dans la page Activités, parcourez chaque activité et vérifiez que les informations sont correctement remplies. Si l’assembly de l’activité n’a pas été migré ou n’est pas au même emplacement que lors de la création de l’adresse IP, le champ Classe est vide. Pour éviter d’avoir à retaper des informations, vous devez remplacer l’assembly avant de démarrer l’Assistant.
Une fois les activités de modification terminées, sélectionnez Suivant.
Vérifiez que les fichiers dépendants se trouvent toujours au même emplacement qu’indiqué, ou supprimez-les et ajoutez de nouveaux fichiers dépendants. Sélectionnez Suivant.
Entrez un chemin d’accès et un nom de fichier pour le nouveau fichier IP. N’utilisez pas le même nom que l’adresse IP précédente afin de vous assurer que vous conservez une copie de l’adresse IP précédente. Sélectionnez Suivant pour générer l’adresse IP.

Vous disposez désormais d’une adresse IP compatible avec Orchestrator et qui peut être inscrite et déployée à l’aide d’Orchestrator Deployment Manager.

Packs d’intégration – Problèmes connus

Limitation de la longueur du nom de fichier

Lorsque vous incluez des assemblys dans votre pack d’intégration, ils sont automatiquement ajoutés au Registre par le programme d’installation. En raison de la limitation de la longueur du nom de clé de Registre, le chemin d’accès et le nom de fichier combinés d’un assembly ne peuvent pas dépasser 234 caractères. Étant donné le chemin par défaut où sont placés les assemblys au sein d’une adresse IP, la longueur maximale du nom de fichier d’un fichier d’assembly inclus ne peut pas dépasser 80 caractères. Si un assembly avec un nom de fichier supérieur à 80 caractères est inclus dans l’installation, l’installation échoue.

Ressources Orchestrator

En plus de cette référence en ligne fournie pour System Center Orchestrator, de nombreuses ressources peuvent fournir des informations supplémentaires sur la création de runbooks, l’utilisation du Kit de ressources d’intégration et les meilleures pratiques.

Partager via