Partager via

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

  • Article

Étape 1 sur 4

Durée d’exécution : 15 minutes

Objectif: Vous pouvez utiliser l’Assistant Développement du service d’adaptateur métier WCF pour générer un service WCF à partir des artefacts Oracle E-Business Suite qui peuvent être hébergés dans un environnement d’hébergement tel que Internet Information Services (IIS) ou le service d’activation de processus Windows (WAS). 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.

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

    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.

Notes

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

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 Sélectionner sur la table d’interface employee MS_SAMPLE.

Pour créer un service WCF pour l’opération sélectionner sur la table d’interface employee MS_SAMPLE

  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.

    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.

    Boîte de dialogue Nouveau projet

    Notes

    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 cliquer sur Système de fichiers dans la liste Emplacement.

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

  4. Sur la page d'accueil, cliquez sur Suivant.

  5. Dans la page Choisir les opérations, spécifiez un chaîne de connexion pour se connecter à Oracle E-Business Suite. Pour cela, procédez de la façon suivante :

    1. Dans la liste Sélectionner une liaison , cliquez sur oracleEBSBinding, puis sur Configurer.

    2. Dans la boîte de dialogue Configurer l’adaptateur , cliquez sur 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 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. 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 Oracle E-Business, consultez Créer l’URI de connexion Oracle E-Business Suite.

    4. Cliquez sur l’onglet Sécurité , puis dans la liste Type 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. Cliquez sur OK pour fermer la boîte de dialogue Configurer l’adaptateur, puis cliquez sur Se connecter. Une fois que Visual Studio a établi une connexion avec Oracle E-Business Suite, la status de connexion s’affiche comme Connectée. Vous pouvez également voir les métadonnées d’Oracle E-Business Suite affichées dans la page Choisir les opérations.

  6. Dans la page Choisir les opérations, dans la liste Sélectionner un type de contrat, cliquez sur Client (opérations sortantes).

  7. Dans la zone Sélectionner une catégorie , accédez à la table d’interface MS_SAMPLE_EMPLOYEE dans application de 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 cliquez sur Ajouter. L’opération Sélectionner est ajoutée à la zone Catégories et opérations ajoutées .

    Ajout du 02_MSB_GUI Sélectionner l’opération

    Notes

    Vous pouvez ajouter plusieurs opérations pour chaque artefact. Vous pouvez également ajouter des opérations pour différents artefacts 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 les opérations Oracle E-Business Suite.

  9. Dans la page Choisir les opérations, cliquez sur Suivant.

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

    1. 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. Pour ce didacticiel, tapez customServiceBehavior.
      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.

      Notes

      Étant donné que nous n’utilisons pas de certificats de service pour ce didacticiel, vous n’avez 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 « Propriétés X509ClientCertificateCredentialsElement » sur https://go.microsoft.com/fwlink/?LinkId=103771.

    2. 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 Pour que Microsoft Office SharePoint Server utilise le service WCF, vous devez définir ce paramètre 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 didacticiel, tapez customEndpointBehavior.
      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.

      Page Configurer les comportements des services et des points de terminaison

  11. Dans la page Configurer les comportements des services et des points de terminaison, cliquez sur Suivant.

  12. Dans la page Configurer la liaison et l’adresse du point de terminaison de service, le paramètre Sélectionner un contrat à configurer affiche l’artefact (MS_SAMPLE_EMPLOYEE) que vous avez configuré. La zone Opérations sous le contrat sélectionné affiche l’opération Sélectionner que vous avez sélectionnée pour l’artefact dans la page Choisir les opérations.

  13. 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 Members » sur 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.

    Cliquez sur Appliquer.

    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.

    Configurer la liaison de point de terminaison de service et la

  14. 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 de l’artefact Oracle E-Business Suite et l’opération sélectionnée pour l’artefact.

  15. Passez en revue le résumé, puis cliquez sur 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. Web.config fichier.

    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 à partir du composant WebPart Liste de données métiers dans Microsoft Office SharePoint Server, vous devez fournir la clause de filtre complète à partir de 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 WebPart Liste de données métiers :

where NAME like ‘JOHN’

Toutefois, si vous souhaitez que l’utilisateur fournisse uniquement le nom en tant qu’entrée pour la clause de filtre sans 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 la passer à 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ère 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. Cliquez avec le bouton droit sur le projet dans Explorateur de solutions, puis cliquez sur 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/

    Notes

    Vous devez publier le service WCF dans un emplacement avec 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 , cliquez sur Tous les fichiers projet.

  4. Cliquez sur Publier.

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

    1. Démarrez la console de gestion Microsoft IIS. Cliquez sur Démarrer, pointez sur Outils d'administration, puis cliquez sur Gestionnaire des services Internet (IIS).

    2. Accédez au nœud dans lequel vous avez publié le service. Pour le service MS_SAMPLE_EMPLOYEE, accédez à Internet Information Services><Computer Name>>Sites Web Sites> Web >par défautMS_SAMPLE_EMPLOYEE.

    3. Dans le volet droit, cliquez avec le bouton droit sur le fichier InterfaceTables_FND_APPS_MS_SAMPLE_EMPLOYEE.svc, puis cliquez sur 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 du 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 Business Data Catalog. Pour obtenir des instructions, consultez É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