Utiliser l’adaptateur de base de données Oracle avec SharePoint

Article
07/21/2023

L’Assistant Développement du service d’adaptateur WCF pour Visual Studio permet à l’adaptateur Microsoft BizTalk pour Oracle Database et à l’adaptateur Microsoft BizTalk pour Oracle E-Business Suite d’être consommés directement en tant que source de données externe dans Microsoft SharePoint. L’Assistant Ajout de développement de service qui prend en charge cette fonctionnalité est lancé avec le modèle service d’adaptateur WCF pour la création d’un nouveau site Web Visual C# dans Visual Studio. Le modèle est inclus avec le pack d’adaptateurs BizTalk. Vous devez également installer le Kit de développement logiciel (SDK) de l’adaptateur métier Microsoft Windows Communication Foundation (WCF).

Prise en charge des opérations SharePoint

L’Assistant Développement du service d’adaptateur génère un contrat de service spécial pour les cartes Oracle compatible avec Microsoft SharePoint. L’Assistant génère un contrat de service qui comprend les opérations suivantes pour l’intégration de l’adaptateur à Microsoft SharePoint :

Créer: Prise en charge par l’opération CreateItem_.
Lire: Prise en charge par l’opération ReadItem_.
Mettre à jour: Prise en charge par l’opération UpdateItem_.
Supprimer: Prise en charge par l’opération DeleteItem_.
Requête: Prise en charge par l’opération ReadList.
Associé: Prise en charge par l’opération Associate_.

Le contrat de service suivant a été généré à l’aide de l’adaptateur Microsoft BizTalk pour Oracle Database comme exemple. L’adaptateur est configuré pour fournir l’accès à la table EMP

    [System.ServiceModel.ServiceContractAttribute()]  
    public interface ISCOTT_EMP {  
  
    [System.ServiceModel.OperationContractAttribute()]  
    SCOTT_EMP_Record[] ReadList(System.Nullable<int> Limit);  
  
    [System.ServiceModel.OperationContractAttribute()]  
    void CreateItem(SCOTT_EMP_Record Input);  
  
    [System.ServiceModel.OperationContractAttribute()]  
    SCOTT_EMP_Record[] ReadItem_EMPNO(System.Nullable<decimal> EMPNO);  
  
    [System.ServiceModel.OperationContractAttribute()]  
    void UpdateItem_EMPNO(SCOTT_EMP_Record Input);  
  
    [System.ServiceModel.OperationContractAttribute()]  
    void DeleteItem_EMPNO(System.Nullable<decimal> EMPNO);  
  
    [System.ServiceModel.OperationContractAttribute()]  
    SCOTT_EMP_Record[] Associate_DEPTNO(System.Nullable<decimal> DEPTNO);  
}

Créer un site web pour héberger la base de données Oracle dans IIS

Ces étapes fournissent un exemple d’utilisation de l’Assistant Développement du service d’adaptateur WCF pour créer un service web WCF hébergeant l’adaptateur Microsoft BizTalk pour Oracle Database. Le contrat de service inclut des opérations directement compatibles avec Sharepoint. Afin qu’il puisse être consommé directement en tant que source de données externe. L’adaptateur est configuré pour s’authentifier auprès de la base de données Oracle à l’aide du compte SCOTT . Si le compte SCOTT est verrouillé, vous pouvez le déverrouiller en vous connectant à SQL Plus en tant que SYSDBA.

<Oracle Installation Bin Directory>\Sqlplus.exe SYS AS SYSDBA

Exécutez ensuite la commande suivante.

SQL> ALTER USER scott ACCOUNT UNLOCK;

Créer le projet de site web

Ouvrez Visual Studio.
Dans Visual Studio, dans le menu Fichier , sélectionnez Nouveau , puis cliquez sur Projet.
Dans la boîte de dialogue Nouveau projet , développez Autres langages , puis cliquez sur Visual C#. Recherchez le service d’adaptateur WCF dans la liste des modèles et cliquez dessus pour le sélectionner.

Notes

Le modèle service d’adaptateur WCF n’est pas disponible si le pack d’adaptateurs BizTalk 2013 n’est pas installé. Sur les systèmes x64, installez les versions x86 et x64 de BizTalk Adapter Pack 2013.
Spécifiez ScottEMP comme nom, puis cliquez sur OK. L’Assistant Développement du service d’adaptateur WCF démarre.
Dans la page Introduction, cliquez sur Suivant.
Dans la page Choisir des opérations , spécifiez la liaison oracleDBBinding .
Cliquez sur le bouton Configurer . La boîte de dialogue Configurer l’adaptateur s’affiche.
Sous l’onglet Sécurité , sélectionnez Nom d’utilisateur dans la zone de liste déroulante Type d’informations d’identification du client .
Entrez SCOTT comme nom d’utilisateur et entrez le mot de passe approprié pour le compte SCOTT. Le mot de passe par défaut du compte SCOTT est tiger.
Cliquez sur l’onglet Propriétés de l’URI , puis entrez l’adresse IP ou le nom d’hôte de votre serveur Oracle dans la zone Adresse du serveur .
Entrez le nom instance service de base de données Oracle correct dans la zone ServiceName. Vous pouvez copier les informations de nom instance à partir d’Oracle Enterprise Manager.
Appuyez sur le bouton OK de la boîte de dialogue Configurer l’adaptateur
Dans la page Choisir les opérations de l’Assistant, cliquez sur le bouton Se connecter et attendez quelques instants que les catégories soient générées pour la base de données Oracle.
Une fois les catégories ajoutées dans la liste Sélectionner une catégorie , faites défiler jusqu’à SCOTT et développez-la. Développez ensuite Table , puis cliquez sur l’entrée de table EMP .
Dans la liste Catégories et opérations disponibles , sélectionnez toutes les opérations de la liste, puis cliquez sur le bouton Ajouter . Toutes les opérations sont ajoutées à la liste Catégories et opérations ajoutées .
Dans la page Choisir les opérations , cliquez sur le bouton Suivant .
Dans la page Configurer les comportements des services et des points de terminaison , définissez le comportement du service UseServiceCertificate sur false pour cet exemple. Cliquez ensuite sur le bouton Suivant .
Dans la page Configurer la liaison et l’adresse du point de terminaison de service , cliquez sur le bouton Appliquer . Cliquez ensuite sur le bouton Suivant .
Dans la page Résumé , cliquez sur le bouton Terminer .
Cliquez sur l’option de menu Générer , puis sur Générer la solution. Vérifiez que la génération du projet a réussi sans erreurs.

Publier le nouveau service sur IIS

Pour cet exemple, vous allez publier le service hôte de l’adaptateur sur le serveur web IIS local.

Dans Explorateur de solutions pour Visual Studio, cliquez avec le bouton droit sur le projet ScottEmp, puis cliquez sur Propriétés. Les onglets projet Designer s’affichent.
Cliquez sur l’onglet Web , puis sur l’option Utiliser le serveur web IIS local .
Cliquez sur le bouton Créer un répertoire virtuel.
Ouvrez un navigateur web à l’adresse http://localhost/ScottEmp/ISCOTT_EMP.svcde service . Vous devez recevoir un message indiquant « Vous avez créé un service » indiquant que l’adaptateur est hébergé dans IIS.

Ajouter la source de données externe à un site SharePoint à l’aide de SharePoint Designer

Cette section explique comment ajouter le service WCF en tant que source de données externe à un nouveau site web à l’aide de SharePoint Designer.

Ouvrez SharePoint Designer et créez un site web.
Dans SharePoint Designer, développez Navigation et cliquez sur Types de contenu externe dans la liste Objets de site.
Cliquez sur le bouton de menu Type de contenu externe pour créer un nouveau type de contenu externe.
Cliquez sur le texte en regard de Nom pour modifier le nom du nouveau type de contenu externe. Entrez OracleEMP pour le nom.
Cliquez sur le lien de texte à côté du système externe , qui indique Cliquez ici pour découvrir les sources de données externes et les opérations.. Cela ouvre le Designer d’opération pour le type de contenu externe OracleEMP.
Cliquez sur le bouton Ajouter une connexion dans l’écran de découverte.
Dans la boîte de dialogue Sélection du type de source de données externe, choisissez Service WCF , puis cliquez sur le bouton OK .
Dans la boîte de dialogue Connexion WCF, dans la zone URL des métadonnées du service , entrez https://localhost/ScottEmp/ISCOTT_EMP.svc?wsdl
Dans la zone URL du point de terminaison de service , entrez https://localhost/ScottEmp/ISCOTT_EMP.svc
Cliquez sur le bouton OK pour fermer la boîte de dialogue Connexion WCF.
Une fois que les informations sur la source de données sont renseignées, développez la https://localhost/ScottEmp/ISCOTT_EMP.svc source de données et développez Méthodes web.
Cliquez avec le bouton droit sur la méthode Web ReadList , puis cliquez sur Nouvelle opération de liste de lecture. La boîte de dialogue De configuration de la liste de lecture est lancée.
Dans la boîte de dialogue Liste de lecture, cliquez sur Paramètres de retour , puis cliquez sur EMPNO dans les éléments de source de données. Cliquez sur l’identificateur Mapper à.
Cliquez sur Terminer dans la boîte de dialogue Liste de lecture.
Enregistrez la nouvelle source de données externe en tapant Ctrl+s.

Tester la connexion de source de données externe

Dans le nouveau site web, cliquez sur le bouton Créer des listes et des formulaires . La boîte de dialogue Créer une liste et un formulaire pour OracleEMP s’affiche.
Entrez OracleEMP_List nom de la liste, puis cliquez sur le bouton OK .
Une fois la liste créée, cliquez sur le bouton Affichage résumé dans le menu.
Cliquez sur OracleEMP_List sous Listes externes.
Cliquez sur le bouton Aperçu dans le navigateur dans le menu pour tester l’opération ReadList de l’adaptateur.

Dépanner

Sur les ordinateurs 64 bits, vous devez vous assurer que les composants clients Oracle 32 bits sont également installés. En effet, Visual Studio et ses Assistants s’exécutent en tant que processus 32 bits nécessitant l’accès aux composants 32 bits pendant le développement.

Partage via