Étape 1 : Publier les opérations des composants métier Siebel sous forme de service WCF
Durée d’exécution : 10 minutes
Objectif: Vous pouvez utiliser l’Assistant Développement du service d’adaptateur WCF pour générer un service WCF qui peut être hébergé dans un environnement d’hébergement tel que Internet Information Services (IIS) ou le service WAS (Windows Process Activation Service). Cette rubrique montre comment utiliser l’Assistant pour générer un fichier de service WCF.
Prérequis
Avant d’exécuter l’Assistant, installez les éléments suivants :
Kit de développement logiciel (SDK) d’adaptateur métier Microsoft Windows Communication Foundation (WCF) avec l’option Terminer ou l’option Personnalisée (et en choisissant Outils dans cette option). Cela installe le modèle Visual Studio pour l’Assistant Développement du service d’adaptateur WCF.
Microsoft BizTalk Adapter pour Siebel eBusiness Applications
Client Siebel requis.
Pour plus d’informations sur ces conditions préalables, consultez le guide d’installation du pack d’adaptateurs BizTalk. Le guide d’installation est généralement installé sur le <lecteur> d’installation :\Program Files\Microsoft BizTalk Adapter Pack\Documents.
Publier les composants Siebel Business en tant que service WCF
Démarrez Visual Studio, puis créez un projet.
Dans la boîte de dialogue Nouveau projet , dans le volet Types de projets , sélectionnez Visual C#. Dans le volet Modèles , sélectionnez Service d’adaptateur WCF.
Vous pouvez également, dans le volet Types de projets , développer Visual C#, puis sélectionner Web. Dans le volet Modèles , sélectionnez Service d’adaptateur WCF.
Notes
Si vous avez installé Visual Studio avec le composant Développement web, le modèle service d’adaptateur WCF est également disponible à partir de l’option Nouveau site web .
Spécifiez un nom et un emplacement pour la solution, puis cliquez sur OK. L’Assistant Développement du service d’adaptateur WCF démarre.
Sur la page d'accueil, cliquez sur Suivant.
Dans la page Choisir les opérations, spécifiez une chaîne de connexion à connecter au système Siebel. Pour cela, procédez de la façon suivante :
Dans la liste Sélectionner une liaison , cliquez sur siebelBinding, puis sur Configurer.
Dans la boîte de dialogue Configurer l’adaptateur , cliquez sur l’onglet Sécurité .
Dans la liste Type d’informations d’identification du client , sélectionnez Nom d’utilisateur, puis spécifiez le nom d’utilisateur et le mot de passe pour vous connecter au système Siebel.
Cliquez sur l’onglet Propriétés de l’URI , puis spécifiez des valeurs pour les paramètres de connexion. Pour plus d’informations sur l’URI de connexion de l’adaptateur Siebel, consultez Créer l’URI de connexion système Siebel.
Notes
Si les paramètres de connexion contiennent des caractères réservés (tels que des caractères spéciaux XML), vous devez les spécifier tels quels dans l’onglet Propriétés de l’URI , c’est-à-dire sans utiliser de caractères d’échappement. Toutefois, si vous spécifiez l’URI directement dans le champ Configurer un URI et que les paramètres de connexion contiennent des caractères réservés, vous devez spécifier les paramètres de connexion à l’aide des caractères d’échappement appropriés.
Cliquez sur l’onglet Propriétés de liaison, puis spécifiez les valeurs des propriétés de liaison, le cas échéant, requises pour les opérations que vous souhaitez cibler.
Pour plus d’informations sur les propriétés de liaison, consultez En savoir plus sur l’adaptateur BizTalk pour les propriétés de liaison Siebel.
Cliquez sur OK, puis sur Se connecter. Une fois la connexion établie, le status de connexion est affiché comme Connecté.
Dans la page Choisir les opérations, dans la liste Sélectionner un type de contrat, cliquez sur Client (opérations sortantes).
Dans la zone Sélectionner une catégorie , développez le nœud Siebel Business Objects pour afficher la liste des objets métier dans le référentiel Siebel. Pour cet exemple, procédez comme suit :
Développez l’objet métier Account , puis cliquez sur le composant Account business.
Dans la zone Catégories et opérations disponibles , sélectionnez l’opération Requête , puis cliquez sur Ajouter. L’opération sélectionnée est répertoriée dans la zone Catégories et opérations ajoutées .
Dans la page Choisir les opérations, cliquez sur Suivant.
Dans la page Configurer les comportements des services et des points de terminaison, spécifiez des valeurs pour configurer le comportement du service et du point de terminaison.
Dans la zone Configuration du comportement du service , spécifiez des valeurs pour les éléments suivants :
Pour la propriété Spécifier la valeur EnableMetadataExchange Définissez cette valeur sur True pour créer un point de terminaison d’échange de métadonnées. En définissant cette valeur sur True, vous rendez les métadonnées de service disponibles à l’aide de protocoles standardisés, tels que WS-Metadata Exchange (MEX) et les requêtes HTTP/GET.
La valeur par défaut est False.IncludeExceptionDetailsinFault Définissez cette valeur sur True pour inclure des informations d’exception managées en détail sur les erreurs SOAP retournées au client à des fins de débogage. La valeur par défaut est False. Nom Nom de la configuration du comportement du service. UseServiceCertificate Spécifie si vous souhaitez utiliser le mode de sécurité au niveau du message de WCF. La valeur par défaut est True.
Pour ce didacticiel, vous devez définir cette valeur sur False.FindValue Chaîne qui spécifie la valeur à rechercher dans le magasin de certificats X.509.
Note: Spécifiez une valeur pour cette propriété uniquement si UseServiceCertificate a la valeur True.StoreLocation Valeur qui spécifie l’emplacement du magasin de certificats que le service peut utiliser pour valider le certificat du client.
Note: Spécifiez une valeur pour cette propriété uniquement si UseServiceCertificate a la valeur True.StoreName Nom du magasin de certificats X.509 à ouvrir.
Note: Spécifiez une valeur pour cette propriété uniquement si UseServiceCertificate a la valeur True.X509FindType Le type de recherche X.509 à exécuter.
Note: Spécifiez une valeur pour cette propriété uniquement si UseServiceCertificate a la valeur True.Notes
Pour plus d’informations sur les certificats et les propriétés associées, consultez Propriétés X509ClientCertificateCredentialsElement.
Dans la zone Configuration du comportement du point de terminaison , spécifiez des valeurs pour les éléments suivants :
Pour la propriété Spécifier la valeur Type d’authentification - Définissez cette valeur sur ClientCredentialUserNamePassword pour permettre aux clients de spécifier le nom d’utilisateur et le mot de passe lors de la consommation du service WCF.
- Définissez cette valeur sur HTTPUserNamePassword pour permettre aux clients de spécifier le nom d’utilisateur et le mot de passe dans le cadre de l’en-tête HTTP.
- Définissez cette valeur sur Auto pour permettre aux clients de spécifier les informations d’identification via l’interface ClientCredential . En cas d’échec, les clients peuvent passer des informations d’identification dans le cadre de l’en-tête HTTP.
La valeur par défaut est Auto. Pour que Microsoft Office SharePoint Server utilise le service WCF, vous devez définir ce paramètre sur HTTPUserNamePassword.Nom Spécifiez un nom pour la configuration du comportement du point de terminaison. UsernameHeader Nom de l’en-tête de nom d’utilisateur. Pour cet exemple, spécifiez MyUserHeader. Pour plus d’informations sur les en-têtes HTTP, consultez « Prise en charge des en-têtes HTTP et SOAP personnalisés » sur https://go.microsoft.com/fwlink/?LinkId=106692.
Note: Vous devez spécifier une valeur pour cette propriété si le type d’authentification est défini sur HTTPUserNamePassword. Si Le type d’authentification est défini sur Auto, cette propriété est facultative.PasswordHeader Nom de l’en-tête de mot de passe. Pour cet exemple, spécifiez MyPassHeader. Pour plus d’informations sur les en-têtes HTTP, consultez « Prise en charge des en-têtes HTTP et SOAP personnalisés » sur https://go.microsoft.com/fwlink/?LinkId=106692.
Note: Vous devez spécifier une valeur pour cette propriété si le type d’authentification est défini sur HTTPUserNamePassword. Si Le type d’authentification est défini sur Auto, cette propriété est facultative.La figure suivante montre la page Configurer les comportements de service et de point de terminaison avec les valeurs spécifiées.
Dans la page Configurer les comportements des services et des points de terminaison, cliquez sur Suivant.
Dans la page Configurer la liaison et l’adresse de point de terminaison de service, la zone Sélectionner un contrat à configurer répertorie les contrats pour les composants métier Siebel pour lesquels vous avez sélectionné les opérations dans la page Choisir les opérations. La zone Opérations sous le contrat sélectionné affiche les opérations que vous avez sélectionnées pour chaque artefact dans la page Choisir les opérations.
Dans la zone Configurer l’adresse et la liaison pour le contrat , spécifiez des valeurs pour les éléments suivants :
Pour la propriété Spécifier la valeur Configuration de liaison L’Assistant prend uniquement en charge la liaison HTTP de base. Par conséquent, le champ de configuration de liaison est automatiquement renseigné dans System.ServiceModel.Configuration.BasicHttpBindingElement.
Cliquez sur le bouton de sélection (...) pour modifier les propriétés de la liaison HTTP. Pour utiliser un canal de communication sécurisé, vous devez toujours définir la propriété Mode sur Transport. L’Assistant définit la valeur par défaut de la propriété Mode en tant que Transport.
Pour plus d’informations sur les autres liaisons exposées, consultez BasicHttpBindingElement, classe.Nom du point de terminaison Spécifiez un nom de point de terminaison pour le contrat. Les autres champs de cette page sont automatiquement renseignés en fonction des valeurs que vous avez spécifiées dans les pages précédentes.
Cliquez sur Appliquer. Effectuez cette étape pour tous les contrats affichés sous la zone Sélectionner un contrat à configurer .
Notes
Si vous ne spécifiez aucune valeur sur cette page, les valeurs par défaut sont acceptées pour tous les contrats.
La figure suivante montre la page Configurer la liaison et l’adresse de point de terminaison de service avec les valeurs spécifiées.
Dans la page Configurer la liaison et l’adresse de point de terminaison de service, cliquez sur Suivant. La page Résumé répertorie une arborescence des contrats pour les composants métier Siebel sélectionnés et, en dessous, les opérations sélectionnées pour chaque composant métier.
Passez en revue le résumé, puis cliquez sur Terminer.
L’Assistant crée un service WCF et ajoute les fichiers suivants au projet Visual Studio :
Fichier .svc. Il s’agit du fichier de service WCF. L’Assistant génère un fichier pour chaque contrat.
Web.config fichier.
Code de service (fichier .cs).
Publiez le service WCF.
Vérifiez que SSL est activé pour Internet Information Services (IIS). Consultez Comment configurer SSL.
Cliquez avec le bouton droit sur le projet dans Explorateur de solutions, puis cliquez sur Publier.
Dans la boîte de dialogue Publier le web , spécifiez une URL pour le service WCF. Par exemple :
https://<computer_name>/Siebel_Account/
Dans la zone Copier , cliquez sur Tous les fichiers projet.
Cliquez sur Publier.
Vérifiez que le service WCF a été publié avec succès.
Démarrez la console de gestion Microsoft IIS. Cliquez sur Démarrer, pointez sur Outils d’administration, puis cliquez sur Services Internet Information.
Accédez au nœud dans lequel vous avez publié le service. Pour le service Siebel_Account, accédez à Internet Information Services><Nom de l’ordinateur>>Sites>Web sites Web> pardéfaut Siebel_Account.
Dans le volet droit, cliquez avec le bouton droit sur le fichier BusinessObjects_Account_Account_Operation.svc, puis cliquez sur Parcourir.
La page Web s’affiche avec l’URL de récupération du WSDL. Vous pouvez tester la récupération des métadonnées à l’aide de la commande svcutil. Par exemple, la commande permettant de récupérer les métadonnées pour le service Siebel_Account est :
svcutil.exe https://localhost/Siebel_Account/BusinessObjects_Account_Account_Operation.svc?wsdl
Étapes suivantes
Vous disposez maintenant d’un service WCF pour le composant métier Siebel. Utilisez l’Éditeur de définition business Data Catalog pour créer un fichier de définition d’application pour les opérations de composant métier Siebel. Pour obtenir des instructions , consultez Étape 2 : Créer un fichier de définition d’application pour siebel Business Component Operations . Le fichier de définition d’application identifie l’emplacement où les données métier sont stockées et le format dans lequel elles sont stockées.
Voir aussi
Didacticiel 1 : Présentation de données provenant d’un système Siebel sur un site SharePoint