Partager via

Utilisation de l’outil Utilitaire de métadonnées ServiceModel avec l’adaptateur BizTalk pour Siebel eBusiness Applications

  • Article

Vous pouvez utiliser l’outil ServiceModel Metadata Utility Tool (svcutil.exe) pour générer une classe de client WCF pour les opérations exposées par l’adaptateur Microsoft BizTalk pour Siebel eBusiness Applications. Après avoir exécuté svcutil.exe pour générer une classe de client WCF, vous pouvez inclure le fichier généré dans votre code et créer des instances de la classe cliente WCF pour effectuer des opérations sur le système Siebel.

L’utilisation de svcutil.exe vous oblige à fournir un URI de connexion qui contient des informations d’identification. Étant donné que, par défaut, l’adaptateur Siebel désactive les informations d’identification dans l’URI de connexion, vous devez configurer svcutil.exe pour utiliser une liaison autre que celle par défaut pour l’adaptateur Siebel. Vous pouvez également configurer d’autres propriétés de liaison dans la liaison autre que celle par défaut.

Les sections suivantes vous montrent comment configurer svcutil.exe et comment utiliser svcutil.exe pour générer du code client WCF avec l’adaptateur Siebel.

Configurer svcutil.exe pour une liaison autre que la liaison par défaut

Pour configurer svcutil.exe utiliser une liaison autre que celle par défaut, vous devez créer une copie locale de svcutil.exe, puis créer ou modifier une copie locale du fichier de configuration svcutil.exe.config.

  1. Créez un dossier et copiez svcutil.exe dans le nouveau dossier. Vous pouvez généralement trouver svcutil.exe à l’emplacement d’installation du SDK Windows, en particulier C :\Program Files\Microsoft SDKs\Windows\v6.0\Bin.

  2. Créez un fichier nommé svcutil.exe.config dans le nouveau dossier.

  3. Ajoutez une liaison et un point de terminaison client au fichier svcutil.exe.config. Vous devez exécuter svcutil.exe à partir du nouveau dossier pour vous assurer que la configuration correcte est utilisée.

    Important

    L’attribut name du point de terminaison client doit spécifier le schéma utilisé dans l’URI de connexion. Cette valeur respecte la casse.

    <configuration>
  <system.serviceModel>
    <client>
      <!-- the name should match the required scheme of the Metadata Exchange endpoint
      and the contract should be "IMetadataExchange" -->
      <endpoint name="siebel"
        binding="siebelBinding"
        bindingConfiguration="SiebelBinding"
        contract="IMetadataExchange" />
    </client>
    <bindings>
      <siebelBinding>
        <binding name="SiebelBinding" acceptCredentialsInUri="true" />
      </siebelBinding>
    </bindings>

  </system.serviceModel>

</configuration>

Notes

Vous pouvez définir l’une des propriétés de liaison de l’adaptateur Siebel dans la configuration de liaison.

Pour plus d’informations sur la configuration d’une liaison autre que celle par défaut pour svcutil.exe, consultez la rubrique « Point de terminaison de métadonnées sécurisés personnalisés » dans la documentation WCF à l’adresse https://go.microsoft.com/fwlink/?LinkId=96077.

Création d’une classe cliente WCF avec svcutil.exe

Pour utiliser svcutil.exe afin de générer le code client WCF pour l’adaptateur Siebel, vous devez fournir un URI de connexion qui spécifie un point de terminaison IMetadataExchange (mex) et l’opération ou les opérations pour lesquelles vous souhaitez svcutil.exe générer du code. Vous devez également spécifier les informations d’identification de connexion pour le système Siebel dans l’URI de connexion.

Notes

Avant de pouvoir utiliser svcutil.exe avec l’adaptateur Siebel, vous devez le configurer pour utiliser une liaison autre que celle par défaut . Pour plus d’informations sur la procédure à suivre, consultez Configuration de svcutil.exe pour l’adaptateur Siebel.

Vous spécifiez un point de terminaison mex et des opérations cibles dans l’URI de connexion de l’adaptateur Siebel de la manière suivante :

  • Vous devez inclure le paramètre « wsdl » dans le query_string. S’il s’agit du premier paramètre du query_string, il est spécifié juste après le point d’interrogation ( ?). S’il ne s’agit pas du premier paramètre, il doit être précédé d’une esperluette (&).

  • Vous devez suivre le paramètre « wsdl » par un ou plusieurs paramètres « op ». Chaque paramètre « op » est précédé d’une esperluette (&) et spécifie l’ID de nœud d’une opération cible.

    Les deux exemples suivants montrent comment cibler diverses opérations à l’aide de svcutil.exe.

    Cet exemple crée une classe de client WCF pour une opération d’insertion sur l’objet métier ACCOUNT\ACCOUNT.

    .\svcutil « siebel ://Username=YourUserName ; Password=YourPassword@Siebel_server :1234 ? SiebelEnterpriseServer=ent_server&SiebelObjectManager=obj_mgr&Language=enu&wsdl&op=http://Microsoft.LobServices.Siebel/2007/03/BusinessObjects/Account/Account/Insert" ;

    Cet exemple crée une classe de client WCF pour une opération d’insertion et une opération de suppression sur l’objet métier ACCOUNT\ACCOUNT.

    .\svcutil " siebel ://Username=YourUserName ; Password=YourPassword@Siebel_server :1234 ? SiebelEnterpriseServer=ent_server&SiebelObjectManager=obj_mgr&Language=enu&wsdl&op=http://Microsoft.LobServices.Siebel/2007/03/BusinessObjects/Account/Account/Insert& ; op=http://Microsoft.LobServices.Siebel/2007/03/BusinessObjects/Account/Account/Delete" ;

Important

Vous devez placer l’URI de connexion entre guillemets sur la ligne de commande. Sinon, svcutil.exe tente de récupérer des métadonnées pour les opérations que l’adaptateur Siebel ne prend pas en charge. Les résultats d’une telle tentative ne sont pas définis.

Par défaut, svcutil.exe place le code généré dans le fichier output.cs ; Toutefois, vous pouvez modifier le nom du fichier de sortie et de nombreuses autres options que svcutil.exe utilise en définissant des commutateurs de ligne de commande.

Svcutil.exe ne permet pas de rechercher des opérations (par exemple, à l’aide de caractères génériques). Vous devez spécifier explicitement des ID de nœud pour les opérations spécifiques que vous souhaitez cibler. Vous ne pouvez pas spécifier d’ID de nœud qui font référence uniquement à des catégories. Pour plus d’informations sur les ID de nœud exposés par l’adaptateur Siebel, consultez Métadonnées ID de nœud.

Le plug-in Visual Studio Add Adapter Service Reference fournit des fonctionnalités avancées de navigation et de recherche qui peuvent considérablement simplifier la génération d’une classe de client WCF. Pour plus d’informations sur le plug-in Ajouter une référence de service d’adaptateur, consultez Générer un client WCF ou un contrat de service WCF pour les artefacts de solution Siebel.