Exécuter des opérations sur des composants métier avec des champs de liste de choix à l’aide de BizTalk Server et de l’adaptateur Siebel

Un type de champ de liste de choix Siebel constitue une collection de valeurs possibles à partir de laquelle le client peut spécifier une certaine valeur à transmettre au système Siebel. En d’autres termes, un champ de liste de sélection contient une liste de valeurs acceptées pour un champ. Pour plus d’informations sur les listes de sélection et leurs types, reportez-vous à la documentation de Siebel. Pour plus d’informations sur la façon dont l’adaptateur Siebel prend en charge les opérations sur les composants métier avec des champs de liste de sélection, consultez Opérations sur les composants métier dans Siebel.

Lorsque vous générez des métadonnées pour un composant métier contenant un champ de liste de sélection limitée statique (type de liste de sélection), les valeurs acceptées pour la liste de sélection sont également publiées dans le cadre des métadonnées. Si vous insérez une valeur dans un champ de liste de sélection, vous devez spécifier une valeur qui est publiée dans les métadonnées.

Comment effectuer des opérations sur des composants métier avec des champs de liste de choix ?

L’exécution d’une opération sur un système Siebel à l’aide de l’adaptateur Siebel avec BizTalk Server implique des tâches procédurales décrites dans Blocs de construction pour créer des applications BizTalk avec l’adaptateur Siebel.

Pour effectuer une opération sur un composant métier avec un champ de liste de sélection, ces tâches sont les suivantes :

1. Créez un projet BizTalk et générez un schéma pour effectuer une opération sur un composant métier contenant des champs de liste de choix.

2. Créez des messages dans le projet BizTalk pour envoyer et recevoir des messages à partir du système Siebel.

3. Créez une orchestration pour appeler une opération dans le système Siebel.

4. Générez et déployez le projet BizTalk.

5. Configurez l’application BizTalk en créant des ports d’envoi et de réception physiques.

6. Démarrez l’application BizTalk.

   Cette rubrique fournit des instructions pour effectuer ces tâches.

Exemple basé sur cette rubrique

Un exemple, SiebelPicklist, basé sur cette rubrique, est également fourni avec le pack d’adaptateurs BizTalk. Pour plus d’informations, consultez Exemples pour l’adaptateur Siebel.

Génération du schéma

Dans cette rubrique, pour montrer comment appeler des opérations sur des composants métier avec des champs de liste de sélection, nous allons générer le schéma pour l’opération d’insertion pour le composant métier Compte . Le composant métier Compte a une liste de choix statique, Type d’enquête.

Pour plus d’informations sur la génération d’un schéma, consultez Récupération de métadonnées pour les opérations Siebel dans Visual Studio .

Lorsque vous générez les métadonnées pour l’opération Insert pour le composant métier Account , vous obtenez un fichier .xsd distinct contenant les champs de la liste de sélection et leurs valeurs possibles. Notez que .xsd contient uniquement les valeurs des listes de sélection statiques, y compris le type d’enquête.

Définition des messages et des types de messages

Le schéma que vous avez généré précédemment décrit les « types » requis pour les messages dans l’orchestration. Un message est généralement une variable, dont le type est défini par le schéma correspondant. Vous devez lier le schéma que vous avez généré à la première étape aux messages de la vue Orchestration du projet BizTalk.

Pour cette rubrique, vous devez créer deux messages : l’un pour envoyer une demande au système Siebel et l’autre pour recevoir une réponse.

Effectuez les étapes suivantes pour créer des messages et les lier au schéma :

Pour créer des messages et créer un lien vers le schéma

1. Ouvrez la vue d’orchestration du projet BizTalk, s’il n’est pas déjà ouvert. Cliquez sur Affichage, pointez sur Autres fenêtres, puis cliquez sur Vue d’orchestration.

2. Dans la vue Orchestration, cliquez avec le bouton droit sur Messages, puis cliquez sur Nouveau message.

3. Cliquez avec le bouton droit sur le nouveau message de création, puis sélectionnez Fenêtre Propriétés.

4. Dans le volet Propriétés de Message_1, procédez comme suit :

   Propriété	Pour
   Identificateur	Demande de type.
   Type de message	Dans la liste déroulante, développez Schémas, puis sélectionnez SiebelPicklist.SiebelBindingSchema.Insert, où SiebelPicklist est le nom de votre projet BizTalk. SiebelBindingSchema est le schéma généré pour appeler l’opération d’insertion sur le composant métier Account .

5. Répétez l’étape précédente pour créer un message. Dans le volet Propriétés du nouveau message, procédez comme suit :

   Propriété	Pour
   Identificateur	Réponse de type.
   Type de message	Dans la liste déroulante, développez Schémas, puis sélectionnez SiebelPicklist.SiebelBindingSchema.InsertResponse.

Configuration de l’orchestration

Vous devez créer une orchestration BizTalk pour utiliser BizTalk Server pour effectuer une opération d’insertion sur un composant métier Siebel avec des champs de liste de sélection. Dans cette orchestration, vous supprimez un message de demande à un emplacement de réception défini. L’adaptateur Siebel consomme ce message et le transmet au système Siebel. La réponse du système Siebel est enregistrée à un autre emplacement. Une orchestration classique pour l’exécution d’opérations sur les composants métier Siebel contient :

• Envoyer et recevoir des formes pour envoyer des messages à Siebel et recevoir des réponses.

• Port de réception unidirectionnel pour recevoir les messages de demande à envoyer à Siebel.

• Port d’envoi bidirectionnel pour envoyer des messages de demande à Siebel et recevoir des réponses.

• Port d’envoi unidirectionnel pour envoyer les réponses de Siebel à un dossier.

  Un exemple d’orchestration pour l’opération Insert sur un composant métier Account ressemble à ce qui suit :

  

Ajout de formes de message

Veillez à spécifier les propriétés suivantes pour chacune des formes de message. Les noms répertoriés dans la colonne Forme sont les noms des formes de message, comme indiqué dans l’orchestration ci-dessus.

Ajout de ports

Veillez à spécifier les propriétés suivantes pour chacun des ports logiques. Les noms répertoriés dans la colonne Port sont les noms des ports affichés dans l’orchestration.

Spécifier des messages pour les formes d’action et se connecter aux ports

Le tableau suivant spécifie les propriétés et leurs valeurs à définir pour spécifier les messages des formes d’action et les lier aux ports. Les noms répertoriés dans la colonne Forme sont les noms des formes de message, comme indiqué dans l’orchestration ci-dessus.

Une fois que vous avez spécifié ces propriétés, les formes et les ports de message sont connectés et votre orchestration est terminée.

Vous devez maintenant générer la solution BizTalk et la déployer sur un BizTalk Server. Pour plus d’informations, consultez Création d’orchestrations et déploiement d’assemblys BizTalk à partir de Visual Studio dans une application BizTalk.

Configuration de l’application BizTalk

Une fois que vous avez déployé le projet BizTalk, l’orchestration que vous avez créée précédemment est répertoriée sous le volet Orchestrations dans la console Administration BizTalk Server. Vous devez utiliser la console Administration BizTalk Server pour configurer l’application. Pour plus d’informations sur la configuration d’une application, consultez Comment créer une application.

La configuration d’une application implique :

• Sélection d’un hôte pour l’application.

• Mappage des ports que vous avez créés dans votre orchestration aux ports physiques dans la console Administration BizTalk Server. Pour cette orchestration, vous devez :

  • Définissez un emplacement sur le disque dur et un port de fichier correspondant où vous allez supprimer un message de demande. L’orchestration BizTalk consomme le message de requête et l’envoie au système Siebel.

  • Définissez un emplacement sur le disque dur et un port de fichier correspondant où l’orchestration BizTalk supprime le message de réponse contenant la réponse du système Siebel.

  • Définissez un WCF-Custom physique ou WCF-Siebel envoyer un port pour envoyer des messages au système Siebel. Vous devez également spécifier l’action dans le port d’envoi. Pour plus d’informations sur la création de ports, consultez Configurer manuellement une liaison de port physique à l’adaptateur Siebel.

    Notes

    La génération du schéma à l’aide du complément de projet BizTalk du service Consume Adapter crée également un fichier de liaison contenant des informations sur les ports et les actions à définir pour ces ports. Vous pouvez importer ce fichier de liaison à partir de la console d’administration BizTalk pour créer des ports d’envoi (pour les appels sortants). Pour plus d’informations, consultez Configurer une liaison de port physique à l’aide d’un fichier de liaison de port à siebel.

Démarrage de l’application

Vous devez démarrer l’application BizTalk pour effectuer une opération d’insertion sur le composant métier Compte dans Siebel. Pour obtenir des instructions sur le démarrage d’une application BizTalk, consultez Démarrer une application BizTalk ou Démarrer une orchestration.

À ce stade, assurez-vous que :

• Le port de réception FILE pour recevoir les messages de demande pour l’orchestration est en cours d’exécution.

• Le port d’envoi FILE pour recevoir les messages de réponse de l’orchestration est en cours d’exécution.

• Le port WCF-Custom ou WCF-Siebel envoyer des messages au système Siebel est en cours d’exécution

• L’orchestration BizTalk pour l’opération est en cours d’exécution

Exécution de l’opération

Vous devez supprimer le message de demande à l’emplacement de réception FILE. Le schéma du message de demande doit être conforme au schéma que vous avez généré précédemment dans cette rubrique. Pour plus d’informations sur le schéma des messages pour les messages de requête, consultez Schémas de message pour les opérations de composant d’entreprise.

Pour insérer une valeur dans le champ de liste de sélection, examinez le schéma généré pour déterminer la liste des valeurs acceptables pour la liste de sélection. Assurez-vous que le message de demande a un élément pour insérer une valeur dans le champ de liste de sélection. Par exemple, le message de demande doit contenir l’élément suivant pour insérer une valeur dans la liste de choix Type d’enquête .

<Survey_x0020_Type>1</Survey_x0020_Type>

Ici, « 1 » est une valeur acceptable pour la liste de choix type d’enquête.

Voici un exemple de message de demande qui contient un paramètre de liste de sélection :

<Insert xmlns="http://Microsoft.LobServices.Siebel/2007/03/BusinessObjects/Account/Account/Operation">  
  <ArrayOfAccountInsertRecord>  
    <AccountInsertRecord xmlns="http://Microsoft.LobServices.Siebel/2007/03/BusinessObjects">  
      <Currency_x0020_Code>usd</Currency_x0020_Code>  
      <Current_x0020_Volume>9</Current_x0020_Volume>  
      <Customer_x0020_Account_x0020_Group>Sold-To Party</Customer_x0020_Account_x0020_Group>  
      <Location>Location_1</Location>  
      <Main_x0020_Phone_x0020_Number>4256543212</Main_x0020_Phone_x0020_Number>  
      <Name>Name_Surname</Name>  
      <Party_x0020_Name>test_party</Party_x0020_Name>  
      <Primary_x0020_Address_x0020_Id>1212 street</Primary_x0020_Address_x0020_Id>  
      <Survey_x0020_Type>1</Survey_x0020_Type>  
    </AccountInsertRecord>  
  </ArrayOfAccountInsertRecord>  
</Insert>  

L’orchestration consomme le message de requête et le transmet au système Siebel. La réponse du système Siebel est enregistrée à l’autre emplacement FILE défini dans le cadre de l’orchestration.

Exceptions possibles

Pour plus d’informations sur les exceptions que vous pouvez rencontrer lors de l’exécution d’une opération sur un composant d’entreprise avec des champs de liste de sélection à l’aide de BizTalk Server, consultez Exceptions et gestion des erreurs avec l’adaptateur Siebel.

Bonnes pratiques

Une fois que vous avez déployé et configuré le projet BizTalk, vous pouvez exporter les paramètres de configuration vers un fichier XML appelé fichier de liaisons. Une fois que vous avez généré un fichier de liaisons, vous pouvez importer les paramètres de configuration à partir du fichier afin de ne pas avoir à créer les ports d’envoi, les ports de réception, etc. pour la même orchestration. Pour plus d’informations sur les fichiers de liaison, consultez Réutiliser les liaisons d’adaptateur dans l’adaptateur Siebel.

Voir aussi

Développer des applications BizTalk à l’aide de l’adaptateur Siebel