Partager via


Étape 1 : Utiliser l’adaptateur Oracle E-Business pour créer et publier un service WCF

Étape 1 sur 4

Durée d’exécution : 15 minutes

Objectif : Vous pouvez utiliser l'Assistant de développement de service de l'adaptateur WCF LOB pour générer un service WCF à partir des artefacts d'Oracle E-Business Suite, lesquels peuvent être hébergés dans un environnement tel que les Services d'information Internet (IIS) ou le Service d'activation des processus Windows (WAS). Cette rubrique montre comment utiliser l’Assistant pour générer un fichier de service WCF.

Conditions préalables

Avant d’exécuter l’Assistant, installez les éléments suivants :

  • Kit de développement logiciel (SDK) d’adaptateur pour la ligne d’affaires Microsoft Windows Communication Foundation (WCF) avec l’option Complet ou l’option Personnalisée (et en choisissant Outils dans cette option). Cela installe un modèle de Visual Studio pour l'assistant de développement de services d'adaptateurs.

  • Adaptateur Microsoft BizTalk pour Oracle E-Business Suite à partir du pack d’adaptateurs BizTalk.

    Pour plus d’informations sur ces prérequis, 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.

Remarque

Vous devez également exécuter le script create_apps_artifacts.sql fourni avec l’exemple Microsoft Office SharePoint Server pour créer la table d’interface MS_SAMPLE_EMPLOYEE dans l’application bibliothèque d’objets d’application . Cette table d’interface est utilisée dans ce didacticiel.

Créer un service WCF pour l’opération sur Oracle E-Business Artifact

Cette section décrit les étapes de création d’un service WCF pour l’opération Select sur la Table de l'interface MS_SAMPLE EMPLOYEE.

Pour créer un service WCF pour l'opération Select sur la table d’interface MS_SAMPLE EMPLOYEE

  1. Démarrez Visual Studio, puis créez un projet.

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

    Sinon, dans le volet Types de projets , développez Visual C#, puis sélectionnez Web. Dans le volet Modèles , sélectionnez Service d’adaptateur WCF.

    Boîte de dialogue Nouveau projet

    Remarque

    Si vous avez installé Visual Studio 2013 avec le composant Développement web, le modèle Service d'Adaptateur WCF est également disponible à partir de l'option Nouveau site Web (Fichier>Nouveau>Site Web).

    Toutefois, l’adaptateur Oracle E-Business prend uniquement en charge les sites Web créés sur le système de fichiers. Par conséquent, lors de la création d’un site Web dans la boîte de dialogue Nouveau site web, vous devez sélectionner Système de fichiers dans la liste Des emplacements.

  3. Spécifiez un nom et un emplacement pour la solution, puis sélectionnez OK. L'Assistant de développement du service d'adaptateur WCF se lance.

  4. Sur la page Bienvenue, sélectionnez Suivant.

  5. Dans la page Choisir des opérations, spécifiez une chaîne de connexion pour vous connecter à Oracle E-Business Suite. Pour ce faire :

    1. Dans la liste Sélectionner une liaison , sélectionnez oracleEBSBinding, puis configurez.

    2. Dans la boîte de dialogue Configurer l’adaptateur , sélectionnez l’onglet Propriétés de liaison .

      1. Sous la catégorie Général , pour la propriété de liaison ClientCredentialType , sélectionnez EBusiness.

      2. Sous la catégorie OracleEBS , spécifiez les valeurs appropriées pour les propriétés de liaison OracleUserName, OraclePassword et OracleEBSResponsibilityName . Dans ce cas, vous devez fournir des informations d’identification de base de données pour les propriétés de liaison OracleUserName et OraclePassword .

      3. Sous la catégorie Métadonnées , pour la propriété de liaison EnableSafeTyping , sélectionnez True. Si vous récupérez des valeurs pour la colonne de date, nous vous recommandons de définir la propriété de liaison EnableSafeTyping sur True lors de la génération des métadonnées.

    3. Sélectionnez l’onglet Propriétés de l’URI , puis spécifiez les valeurs des paramètres de connexion. Pour plus d’informations sur l’URI de connexion de l’adaptateur Oracle E-Business, consultez Créer l’URI de connexion Oracle E-Business Suite.

    4. Sélectionnez l’onglet Sécurité , puis, dans la liste des types d’informations d’identification du client , sélectionnez Nom d’utilisateur. Spécifiez un nom d’utilisateur et un mot de passe Oracle E-Business Suite valides pour vous connecter à Oracle E-Business Suite.

    5. Sélectionnez OK pour fermer la boîte de dialogue Configurer l’adaptateur, puis sélectionnez Se connecter. Une fois que Visual Studio a correctement établi une connexion avec Oracle E-Business Suite, l’état de la connexion s’affiche comme Connecté. Vous pouvez également voir les métadonnées Oracle E-Business Suite affichées dans la page Choisir des opérations.

  6. Dans la page Choisir des opérations, dans la liste Sélectionner un type de contrat , sélectionnez Client (opérations sortantes).

  7. Dans la zone Sélectionner une catégorie , accédez à la table d’interface MS_SAMPLE_EMPLOYEE dans l’application bibliothèque d’objets d’application. Pour plus d’informations sur la navigation vers un artefact dans l’adaptateur, consultez Parcourir, rechercher et récupérer des métadonnées pour les opérations Oracle E-Business.

  8. Dans la zone Catégories et opérations disponibles , sélectionnez l’opération Sélectionner , puis sélectionnez Ajouter. L’opération Select est ajoutée à la zone Catégories et opérations Ajoutées .

    Ajout de l'opération de sélection

    Remarque

    Vous pouvez ajouter plusieurs opérations pour chaque artefact. Vous pouvez également ajouter des opérations pour différents éléments Oracle E-Business Suite. Par exemple, vous pouvez ajouter une opération pour une table d’interface et une autre pour un programme simultané. En outre, vous pouvez rechercher des opérations spécifiques en spécifiant des caractères génériques dans les expressions de recherche. Pour plus d’informations sur les caractères spéciaux pris en charge et les niveaux de nœud auxquels vous pouvez rechercher les opérations, consultez Rechercher des opérations Oracle E-Business Suite.

  9. Dans la page Choisir des opérations, sélectionnez Suivant.

  10. Dans la page Configurer les comportements de service et de point de terminaison, spécifiez des valeurs pour configurer le comportement du service et du point de terminaison.

    1. Dans la zone Configuration du comportement du service , spécifiez les valeurs des propriétés suivantes :

      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. Pour ce tutoriel, tapez customServiceBehavior.
      UtiliserCertificatDeService 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.

      Remarque

      Ce didacticiel n’utilise pas de certificats de service. Vous n’avez donc pas besoin de fournir des valeurs pour les propriétés FindValue, StoreLocation, StoreName et X509FindType. Pour plus d’informations sur les certificats et les propriétés associées, consultez les propriétés X509ClientCertificateCredentialsElement.

    2. Dans la zone Configuration du comportement du point de terminaison , spécifiez les valeurs des propriétés suivantes :

      Pour la propriété Spécifier la valeur
      Type d’authentification Pour que Microsoft Office SharePoint Server consomme le service WCF, définissez la valeur sur HTTPUserNamePassword. Cela permet aux clients de spécifier le nom d’utilisateur et le mot de passe dans le cadre de l’en-tête HTTP.
      Nom Spécifiez un nom pour la configuration du comportement du point de terminaison. Pour ce tutoriel, tapez customEndpointBehavior.
      Entête du nom d'utilisateur Nom de l’en-tête du 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.

      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.
      En-tête du mot de passe 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.

      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.

      Important

      Microsoft vous recommande d’utiliser l’option d’authentification la plus sécurisée et disponible. La méthode d’authentification décrite dans cette procédure nécessite un niveau de confiance très élevé et présente des risques qui ne sont pas présents dans d’autres méthodes d’authentification. Utilisez cette méthode d’authentification uniquement lorsque d’autres méthodes ne sont pas viables.

      La figure suivante montre la page Configurer les comportements du service et du point de terminaison avec les valeurs spécifiées.

      Page Configurer les comportements de service et de point de terminaison

  11. Dans la page Configurer les comportements du service et du point de terminaison, sélectionnez Suivant.

  12. Sur la page Configurer la liaison et l’adresse du point de terminaison de service, le Sélectionner un contrat à configurer affiche l’artefact (MS_SAMPLE_EMPLOYEE) que vous avez déjà configuré. Les opérations sous le contrat sélectionné affichent l’opération Select que vous avez sélectionnée pour l’artefact sur la page Choisir les opérations.

  13. Dans la zone Configurer l’adresse et la liaison pour le contrat, spécifiez les valeurs des propriétés suivantes. Quand vous êtes prêt, sélectionnez Appliquer.

    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é sur System.ServiceModel.Configuration.BasicHttpBindingElement.

    Sélectionnez le bouton d'ellipse (...) 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 comme Transport.

    Pour plus d’informations sur les autres liaisons exposées, consultez « BasicHttpBindingElement Members » à l’adresse https://go.microsoft.com/fwlink/?LinkId=103773.
    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.

    Remarque

    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 de configuration de la liaison et de l'adresse du point de terminaison de service avec les valeurs spécifiées.

    Configurer la liaison et l’adresse de point de terminaison de service

  14. Dans la page Configurer la liaison et l’adresse du point de terminaison de service, sélectionnez Suivant. La page Résumé liste une arborescence de l'artefact Oracle E-Business Suite et l'opération sélectionnée pour cet artefact.

  15. Passez en revue le résumé, puis sélectionnez Terminer.

  16. L’Assistant crée un service WCF et ajoute les fichiers suivants au projet Visual Studio :

    1. Fichier .svc. Il s’agit du fichier de service WCF. L’Assistant génère un fichier pour chaque contrat.

    2. fichier Web.config.

    3. Code de service (fichier .cs)

Modifier le fichier .cs

Lorsque vous créez un service à partir d’un artefact Oracle E-Business Suite à l’aide de l’adaptateur Oracle E-Business et que vous souhaitez l’utiliser dans le composant WebPart "Liste de données métiers" de Microsoft Office SharePoint Server, vous devez fournir la clause de filtre complète commençant par la clause WHERE. Par exemple, si vous souhaitez rechercher un employé dont le nom est « John », vous devez fournir la clause de filtre suivante dans le composant Web Part liste de données métiers :

where NAME like ‘JOHN’

Toutefois, si vous souhaitez que l’utilisateur fournisse uniquement le nom comme entrée pour la clause de filtre sans réellement mentionner la clause de filtre entière, vous pouvez ajouter un code dans le fichier .cs qui modifie la clause de filtre provenant du composant WebPart Liste de données métiers dans Microsoft Office SharePoint Server pour le transmettre à Oracle E-Business au format de clause WHERE.

Par exemple, dans le cas de ce didacticiel, si vous souhaitez que l’utilisateur entre un nom d’employé dans le composant WebPart Liste de données métiers dans Microsoft Office SharePoint Server et récupérez l’enregistrement de cet employé, vous pouvez ajouter le code suivant dans le fichier .cs :

SelectResponse InterfaceTables_FND_APPS_MS_SAMPLE_EMPLOYEE.Select(SelectRequest request)
{
     request.FILTER = "where NAME like '" + request.FILTER + "'"; // The code to avoid the users from specifying the WHERE clause in the filter from Business Data List Web Part.
     return base.Channel.Select(request);
}

Publier le service WCF

Assurez-vous que SSL est activé pour IIS. Pour obtenir des instructions sur l’activation de SSL pour IIS, consultez https://go.microsoft.com/fwlink/?LinkId=197170.

Pour publier le service WCF :

  1. Dans l’Explorateur de solutions, ouvrez le menu contextuel du projet, puis sélectionnez Publier.

  2. Dans la boîte de dialogue Publier le web , spécifiez une URL pour le service WCF. Par exemple:

    https://<COMPUTER_NAME>:<PORT_NUMBER>/MS_SAMPLE_EMPLOYEE/
    

    Remarque

    Vous devez publier le service WCF dans un emplacement compatible SSL. En d’autres termes, la valeur de la zone Emplacement cible doit commencer par « https:// ». Étant donné que les informations d’identification de l’utilisateur sont transmises dans l’en-tête HTTP, l’Assistant a automatiquement configuré le comportement de liaison de l’adaptateur pour utiliser « Transport » comme mode de sécurité, ce qui implique le chiffrement SSL. Vous pouvez bien sûr revenir en arrière et modifier le fichier web.config pour modifier la valeur du <paramètre de mode> de sécurité, mais l’utilisation de SSL est toujours une meilleure option lorsque vous avez des informations sensibles transportées en texte clair dans l’en-tête HTTP.

  3. Dans la zone Copier , sélectionnez Tous les fichiers projet.

  4. Cliquez sur Publier.

  5. Vérifiez que le service WCF est publié avec succès.

    1. Démarrez la console de gestion Microsoft IIS. Ouvrez le menu Démarrer, recherchez et ouvrez Outils d’administration, puis sélectionnez Le Gestionnaire des services Internet (IIS).

    2. Accédez au nœud où vous avez publié le service. Pour le service MS_SAMPLE_EMPLOYEE, accédez à Internet Information Services><>>Sites Web>Site Web par défaut>MS_SAMPLE_EMPLOYEE.

    3. Dans le volet droit, ouvrez le menu contextuel du fichier InterfaceTables_FND_APPS_MS_SAMPLE_EMPLOYEE.svc , puis sélectionnez Parcourir.

    4. 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 MS_SAMPLE_EMPLOYEE est la suivante :

      svcutil.exe https://<COMPUTER_NAME>:<PORT_NUMBER>/MS_SAMPLE_EMPLOYEE/InterfaceTables_FND_APPS_MS_SAMPLE_EMPLOYEE.svc?wsdl
      
      

Étape suivante

Pour créer un fichier de définition d’application pour l’artefact Oracle E-Business Suite, utilisez l’éditeur de définition du catalogue de données métiers. Pour obtenir des instructions, consultez l’étape 2 : Créer un fichier de définition d’application pour les artefacts Oracle E-Business Suite. 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

Tutoriel : Présenter des données d’Oracle E-Business Suite sur un site SharePoint