Assistant Integration Pack

L’Assistant Integration Pack (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é en ligne de commande (CLIActivityWizard) ou à l’aide du Kit de développement logiciel (SDK) Orchestrator. L’AssistantIPWizard IP () empaque 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 professionnels 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 plus facilement déployées à l’aide de l’Assistant IP.

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

Il est important de décider s’il convient d’utiliser des activités individuellement avec les activités .NET Integration Pack 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 dans la 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 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 que vous suivez 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 Runbook Designer au sein de l’organisation ou à des clients externes.

Créer un pack d’intégration

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

Pour créer un pack d’intégration, procédez comme suit :

1. Démarrez l’Assistant Integration Pack. Sélectionnez l’Assistant Démarrer > Orchestrator Integration Pack. La page d’accueil s’affiche.

2. Si vous avez un pack d’intégration existant que vous souhaitez mettre à jour, 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 a un NOUVEL ID de produit unique et de nouveaux ID uniques pour toutes les activités, même si vous réutilise un assembly précédent et utilisez le même produit et les mêmes noms de fichiers.

3. Dans la page Détails du produit, entrez ou modifiez les informations si nécessaire 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 Deployment Manager
   Nom de la catégorie	Texte qui s’affiche en tant que titre de catégorie pour l’adresse IP dans le volet Activités du Runbook Designer
   Company	Nom de votre entreprise. Ces informations s’affichent dans Ajouter/supprimer des programmes sous « Publisher »
   Fichier CLUF	Fichier texte au format RTF avec une .EULA extension. Le CLUF s’affiche à l’utilisateur lors de l’inscription à l’aide du Gestionnaire de déploiement et requiert l’acceptation 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 du Kit de ressources standard est utilisé (Microsoft.SystemCenter.Orchestrator.Integration.Toolkit.Wizard.Images.dll)
   Version	Numéro de version du pack d’intégration, qui s’affiche dans Deployment Manager 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 à cocher est cochée par défaut, ce pack d’intégration permettant de mettre à niveau une version installée existante. Si vous désactivez cette case à cocher, de nouveaux ID de produit et d’activité sont créés pour l’adresse IP (il ne met 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 et sélectionnez une nouvelle icône, puis sélectionnez OK.

4. Lorsque vous avez terminé d’entrer des 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é de ligne de commande ou créées à l’aide du Kit de développement logiciel (SDK) Orchestrator.

5. Pour ajouter une nouvelle activité à l’adresse IP, sélectionnez Ajouter.

6. 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.

7. 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 complet et Description .

8. Si vous le souhaitez, modifiez le nom complet et la description de l’activité.

9. 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.

10. Sélectionnez OK pour enregistrer la définition d’activité. Le nom et la description de l’activité apparaissent désormais dans la liste Activités.

11. 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.

12. Dans cette page, vous pouvez définir une liste de fichiers supplémentaires que vous souhaitez empaquetage 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 Runbook Servers et Runbook Designer, ainsi que 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.

13. Lorsque vous avez terminé d’ajouter des fichiers à la liste, sélectionnez Suivant. La page Fichier Du pack d’intégration Orchestrator s’affiche.

14. 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é ou que le processus échoue. 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 s’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.

15. Une fois l’adresse IP générée, la page finale de l’Assistant affiche le chemin d’accès et le nom de fichier 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 Guide pratique pour ajouter un pack d’intégration.

Mettre à jour un pack d’intégration existant

L’Assistant Orchestrator Integration Pack vous permet d’importer un pack d’intégration existant afin de pouvoir apporter des modifications et le repackager en tant que nouvelle version. Vérifiez que vous cochez la case 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 de mise à niveau IP utiles

Mettre à jour les 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’elles puissent être lues 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 lors de la modification de l’assembly uniquement. Enregistrez votre nouvel assembly dans le même chemin d’accès et nom de fichier que l’assembly précédent (illustré dans le champ Bibliothèque de la boîte de dialogue Informations sur l’activité).

QIK Integration Pack Migration

Si vous avez créé un pack d’intégration à l’aide de l’Assistant Opalis QIK, vous devez le convertir pour qu’il soit compatible avec Orchestrator avant de pouvoir être importé et utilisé 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 la migration d’activité cli QIK pour les rendre compatibles avec Orchestrator. Si vous n’avez pas de 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é développé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.

  Remarque

  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, ce fichier doit être disponible pour repackager dans la nouvelle adresse IP. Si vous n’avez pas de 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 n’avez pas de 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 n’avez pas de 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

Convertir un pack d’intégration compatible Opalis

1. Démarrer l’Assistant Integration Pack

2. Sélectionnez le pack d’intégration d’importation.

3. Sélectionnez le fichier OIP existant, puis sélectionnez Ouvrir.

4. Vous verrez un message d’avertissement indiquant que l’adresse IP n’est pas compatible avec Orchestrator. Cliquez sur OK.

5. Modifiez les détails du produit si nécessaire pour refléter les modifications. Le numéro de version de l’adresse IP est incrémenté automatiquement et la case à cocher « Mettre à niveau » est cochée. Cliquez sur Suivant.

6. Dans la page Activités, passez par chaque activité et vérifiez que les informations sont correctement terminées. Si l’assembly de l’activité n’a pas été migré ou n’est pas dans le même emplacement que celui où l’adresse IP a été créée, le champ Classe est vide. Pour éviter de devoir retyper des informations, vous devez remplacer l’assembly avant de démarrer l’Assistant.

7. Lorsque vous avez terminé la modification des activités, sélectionnez Suivant.

8. Vérifiez que les fichiers dépendants se trouvent toujours dans le même emplacement que celui indiqué, ou supprimez-les et ajoutez de nouveaux fichiers dépendants. Cliquez sur Suivant.

9. 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 pour 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 maintenant d’une adresse IP compatible avec Orchestrator et pouvant être inscrite et déployée à l’aide du Gestionnaire de déploiement Orchestrator.

Packs d’intégration – Problèmes connus

Limitation de 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 combiné et le nom de fichier d’un assembly ne peuvent pas dépasser 234 caractères. Étant donné le chemin d’accès par défaut où les assemblys d’une adresse IP sont placés, la longueur maximale du nom de fichier d’un fichier d’assembly inclus ne peut pas dépasser 80 caractères. Si un assembly dont le nom de fichier dépasse 80 caractères est inclus dans l’installation, l’installation échoue.

Ressources Orchestrator

Outre cette référence en ligne fournie pour System Center Orchestrator, il existe de nombreuses ressources qui 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.

• Accueil de System Center
• Documentation de System Center
• Blog de l’équipe Orchestrator
• Forums de la communauté Orchestrator|

Voir aussi

• Documentation du Kit de ressources d’intégration
• Kit de développement logiciel (SDK) Orchestrator