Étape 2 : Créer un fichier de définition d’application pour les artefacts Oracle E-Business Suite

Durée d’exécution : 15 minutes

Objectif: La fonctionnalité Business Data Catalog dans Microsoft SharePoint Server expose et incorpore des données provenant d’applications métier dans des portails. Pour incorporer ces données dans votre site portail, vous devez créer un fichier de définition d’application que Microsoft Office SharePoint Server peut utiliser.

L’outil Éditeur de définition d’entreprise Data Catalog, disponible avec le Kit de développement logiciel (SDK) Microsoft Office SharePoint Server 2007, vous permet de créer un fichier de définition d’application pour l’Data Catalog d’entreprise. Cet outil génère automatiquement un fichier XML pour le fichier de définition. Vous n’avez donc pas besoin de créer manuellement le fichier dans un éditeur XML.

L’objectif de l’application Microsoft Office SharePoint Server que vous créez est de :

• Interrogez un employé dans la table d’interface MS_SAMPLE_EMPLOYEE à l’aide d’un composant WebPart Liste de données métiers basé sur un nom d’employé.

• Effectuez une recherche en texte intégral à partir de Microsoft Office SharePoint Server sur la table d’interface MS_SAMPLE_EMPLOYEE.

  Pour chacune de ces exigences, vous devez effectuer un ensemble de tâches dans l’outil Éditeur de définition business Data Catalog. Cette rubrique fournit des instructions sur la façon d’effectuer ces tâches.

Prérequis

• Vous devez avoir installé l’Éditeur de définition business Data Catalog dans le cadre du Kit de développement logiciel (SDK) Microsoft Office SharePoint Server 2007.

• Publiez le service WCF comme décrit dans Étape 1 : Utiliser l’adaptateur Oracle E-Business pour créer et publier un service WCF.

Se connecter au service métier WCF et créer une entité

Vous devez vous connecter au service WCF pour extraire le langage WSDL (Web Services Description Language) du service. À partir de WSDL, l’éditeur de définition business Data Catalog extrait les méthodes. Ces méthodes peuvent être utilisées pour créer des entités. Pour ce didacticiel, une entité est créée.

Pour se connecter au service WCF et créer des entités

1. Démarrez l’Éditeur de définition de Data Catalog d’entreprise. Dans le menu Démarrer, cliquez sur Éditeur de définition Microsoft Business Data Catalog.

2. Dans la barre d’outils, cliquez sur Ajouter un système métier.

3. Dans la fenêtre Ajouter un système métier, cliquez sur Se connecter au webservice.

4. Dans la zone URL , tapez l’URL du service WCF. Pour ce tutoriel, l’URL sera :

   https://<COMPUTER_NAME>:<PORT_NUMBER>/MS_SAMPLE_EMPLOYEE/InterfaceTables_FND_APPS_MS_SAMPLE_EMPLOYEE.svc
   

   L’URL est disponible lorsque vous testez si le service WCF est publié correctement, comme décrit dans Étape 1 : Utiliser l’adaptateur Oracle E-Business pour créer et publier un service WCF.

5. Cliquez sur Connecter.

6. Pour afficher les opérations que vous avez sélectionnées dans l’Assistant Développement du service d’adaptateur WCF, cliquez sur l’onglet Ajouter une méthode web . La méthode suivante s’affiche : Select.

7. Faites glisser les méthodes Select vers la Surface de conception. Lorsque vous faites glisser la méthode vers la Surface de conception, une entité est créée et la méthode devient partie intégrante de cette entité.

   

8. Cliquez sur OK.

9. Dans la boîte de dialogue Entrer le nom du système métier , tapez un nom dans la zone Nom du système métier . Pour cet exemple, appelez-le MS_SAMPLE_EMPLOYEE, puis cliquez sur OK.

10. Dans l’Éditeur de définition business Data Catalog, l’entité nouvellement créée est répertoriée comme Entity0. Renommez l’entité En Employé. Effectuez les étapes suivantes pour renommer l’entité :

    1. Développez le nœud MS_SAMPLE_EMPLOYEE , puis le nœud Entités .

    2. Sélectionnez le nœud Entity0 .

    3. Dans le volet Propriétés, tapez Employee dans la zone Nom .

       

Spécifier des en-têtes de nom d’utilisateur et de mot de passe pour les méthodes

Lors de la création d’un service WCF pour l’opération Sélectionner sur la table d’interface MS_SAMPLE_EMPLOYEE dans Oracle E-Business Suite, vous avez spécifié des en-têtes de nom d’utilisateur et de mot de passe dans le cadre de la configuration du comportement du point de terminaison à l’étape 1 : Utiliser l’adaptateur Oracle E-Business pour créer et publier un service WCF. Vous devez spécifier les mêmes valeurs pour la propriété De méthode Select.

Pour spécifier des en-têtes de nom d’utilisateur et de mot de passe pour la méthode Select

1. Dans le volet Objets de métadonnées, développez le nœud Employé , puis le nœud Méthodes .

2. Cliquez sur le nœud Sélectionner , puis dans le volet Propriétés, cliquez sur le bouton de sélection (...) par rapport à la zone Propriétés .

3. Dans la fenêtre Éditeur de collection PropertyView, cliquez sur Ajouter et, dans le volet Propriétés, tapez HttpHeaderUserName pour la zone Nom . Tapez MyUserHeader pour la zone PropertyValue . Sélectionnez System.String pour la zone Type .

4. Dans la fenêtre Éditeur de collection PropertyView, cliquez sur Ajouter et, dans le volet Propriétés, tapez HttpHeaderPassword pour la zone Nom . De même, tapez MyPasswordHeader pour la zone PropertyValue . Sélectionnez System.String pour la zone Type .

   

5. Cliquez sur OK.

Scénario 1 : Interroger les employés à l’aide d’un composant WebPart Liste de données métiers

Pour créer un fichier de définition d’application qui peut être utilisé pour rechercher des employés à partir d’un composant WebPart Liste de données métiers et en fonction du nom de l’employé, vous devez effectuer l’ensemble de tâches suivant.

1. Dans la méthode Select , créez un filtre et mappez-le au paramètre FILTER .

2. Créez une méthode Finder instance pour la méthode Select. Une méthode Finder récupère une liste d’enregistrements en fonction d’un filtre.

Pour créer un filtre et le mapper au paramètre FILTER

1. Créez un filtre.

   1. Dans le volet Objets de métadonnées, développez le nœud Employé , puis le nœud Méthodes .

   2. Développez la méthode Select , cliquez avec le bouton droit sur Filtres, puis cliquez sur Ajouter un filtre.

      

   3. Dans le volet Propriétés, pour la propriété FilterType , sélectionnez Égal.

   4. Dans le volet Propriétés, tapez EmployeeName dans la zone Nom .

      

2. Mapper le filtre au paramètre FILTER dans la méthode Select .

   1. Dans le volet Objets de métadonnées, développez le nœud Employé , puis le nœud Méthodes .

   2. Développez la méthode Select , puis le nœud Paramètres .

   3. Développez le nœud FILTER , puis cliquez sur le deuxième nœud FILTER .

   4. Dans le volet Propriétés, sélectionnez EmployeeName dans la liste FilterDescriptor .

      

Pour créer une méthode Finder instance pour la méthode Select

1. Dans le volet Objets de métadonnées, développez le nœud Employé , puis le nœud Méthodes .

2. Développez le nœud Sélectionner , cliquez avec le bouton droit sur Instances, puis cliquez sur Ajouter une instance de méthode.

   

3. Dans la fenêtre Créer une instance de méthode, cliquez sur Finder pour Type d’instance de méthode. Sélectionnez Retourpour Type de retourDescriptor.

   

4. Cliquez sur OK.

5. Dans le volet Propriétés, tapez Finder_Instance dans la zone Nom .

   

Scénario 2 : recherche Full-Text sur MS_SAMPLE_EMPLOYEE table d’interface à partir de Microsoft Office SharePoint Server

Pour créer un fichier de définition d’application qui peut être utilisé pour effectuer une recherche en texte intégral sur MS_SAMPLE_EMPLOYEE table d’interface à partir de Microsoft Office SharePoint Server, vous devez effectuer l’ensemble de tâches suivant.

• Dans la méthode Select , créez un identificateur et mappez-le au paramètre FILTER et à la valeur de retour qui stocke le nom de l’employé.

• Créez une méthode Finder spécifique instance pour select. La méthode Recherche spécifique recherche un enregistrement spécifique en fonction de l’identificateur, c’est-à-dire d’un nom d’employé.

• Créez une méthode ID Enumerator instance.

Pour créer un identificateur et le mapper au paramètre FILTER et à la valeur de retour du nom de l’employé

1. Créez un identificateur pour l’entité Employee .

   1. Dans le volet Objets de métadonnées, développez le nœud Employé .

   2. Cliquez avec le bouton droit sur le nœud Identificateurs , puis sélectionnez Ajouter un identificateur.

      

   3. Dans le volet Propriétés, tapez EmployeeName dans la zone Nom .

   4. Sélectionnez System.String pour la zone Type .

      

2. Mappez l’identificateur au paramètre FILTER de la méthode Select .

   1. Dans le volet Objets de métadonnées, développez le nœud Employé , puis le nœud Méthodes .

   2. Développez la méthode Select , puis le nœud Paramètres .

   3. Développez le paramètre FILTER , puis cliquez sur le deuxième nœud FILTER .

   4. Dans le volet Propriétés, sélectionnez EmployeeName[Employee] dans la liste Identificateur .

      

3. Mappez l’identificateur à la valeur de retour du nom de l’employé.

   1. Dans le volet Objets de métadonnées, développez le nœud Employé , puis le nœud Méthodes .

   2. Développez la méthode Select , puis le nœud Paramètres .

   3. Développez le nœud Retour , puis le deuxième nœud Retour , puis le nœud Élément , puis cliquez sur le nœud Nom .

   4. Dans le volet Propriétés, sélectionnez EmployeeName[Employee] dans la liste Identificateur .

Pour créer une méthode Finder spécifique instance pour la méthode Select

1. Dans le volet Objets de métadonnées, développez le nœud Employé , puis le nœud Méthodes .

2. Développez le nœud Sélectionner , cliquez avec le bouton droit sur Instances, puis sélectionnez Ajouter une instance de méthode pour ouvrir la fenêtre Créer une instance de méthode.

   

3. Dans la fenêtre Créer une instance de méthode, sélectionnez Recherche spécifique pour Type d’instance de méthode. Sélectionnez Retourpour Type de retourDescriptor.

   

4. Cliquez sur OK.

5. Dans le volet Propriétés, tapez SpeciFinder_Instance pour la zone Nom .

Pour créer une méthode Id Enumerator instance pour la méthode Select

1. Dans le volet Objets de métadonnées, développez le nœud Employé , puis le nœud Méthodes .

2. Développez le nœud Sélectionner , cliquez avec le bouton droit sur Instances, puis sélectionnez Ajouter une instance de méthode pour ouvrir la fenêtre Créer une instance de méthode.

   

3. Dans la fenêtre Créer une instance de méthode, sélectionnez Id Énumérateur pour Type d’instance de méthode. Sélectionnez Retourpour Type de retourDescriptor.

   

4. Cliquez sur OK.

5. Dans le volet Propriétés, tapez IDEnumerator_Instance pour la zone Nom .

Définir les paramètres par défaut pour les instances de méthode

La méthode Select vous oblige à spécifier les noms des colonnes. Par conséquent, vous devez spécifier une valeur par défaut pour le paramètre COLUMN_NAMES pour les instances de méthode Finder, Specific Finder et Id Enumerator créées précédemment. En outre, vous devez également spécifier une valeur par défaut pour le paramètre FILTER pour la méthode Id Enumerator instance.

Pour définir les paramètres par défaut pour les instances de méthode

1. Dans le volet Objets de métadonnées, développez le nœud Employé , puis le nœud Méthodes .

2. Développez le nœud Sélectionner , puis le nœud Paramètres .

3. Développez le nœud COLUMN_NAMES , puis sélectionnez le paramètre COLUMN_NAMES .

4. Dans le volet Propriétés, cliquez sur le bouton de sélection (...) dans la zone Valeurs par défaut .

5. Dans la boîte de dialogue Éditeur de collection DefaultValueView , cliquez sur Ajouter, puis dans le volet de propriétés, cliquez sur Finder_Instance dans la liste SelectMethodInstance .

   

6. Tapez * dans la zone Valeur .

7. De même, répétez les étapes 5 et 6 pour ajouter des valeurs par défaut pour les instances de méthode SpecificFinder_Instance et IDEnumerator_Instance .

8. Dans la boîte de dialogue Éditeur de collection DefaultValueView , cliquez sur OK.

9. Ensuite, ajoutez une valeur par défaut pour le paramètre FILTER pour la méthode IDEnumerator_Instance instance. Développez le nœud FILTER , puis sélectionnez le paramètre FILTER .

10. Dans le volet Propriétés, cliquez sur le bouton de sélection (...) dans la zone Valeurs par défaut .

11. Dans la boîte de dialogue Éditeur de collection DefaultValueView , cliquez sur Ajouter, puis dans le volet de propriétés, cliquez sur IDEnumerator_Instance dans la liste SelectMethodInstance .

12. Tapez % dans la zone Valeur .

    

13. Dans la boîte de dialogue Éditeur de collection DefaultValueView , cliquez sur OK.

Configurer une Sign-On unique pour la connexion à Oracle E-Business Suite

Une fois que vous avez terminé d’effectuer toutes les procédures de cette rubrique, vous avez créé un fichier de définition d’application qui peut être importé dans une application SharePoint. À partir de l’application, vous appelez les méthodes pour récupérer les données pertinentes à partir d’Oracle E-Business Suite. Pour cela, vous devez créer un mappage entre un utilisateur dans Oracle E-Business Suite et l’utilisateur de l’application SharePoint. Vous créez ce mappage dans la console Administration centrale de SharePoint après avoir importé le fichier de définition d’application.

Toutefois, pour créer le mappage, vous devez définir une propriété SecondarySsoApplicationId dans l’Éditeur de définition business Data Catalog.

Pour définir la propriété SecondarySsoApplicationId

1. Dans le volet Objets de métadonnées, développez le nœud MS_SAMPLE_EMPLOYEE , puis le nœud Instances .

2. Cliquez sur MS_SAMPLE_EMPLOYEE_Instance, puis dans le volet Propriétés, cliquez sur le bouton de sélection (...) par rapport à la zone Propriétés .

3. Dans la boîte de dialogue Éditeur de collection PropertyView , cliquez sur Ajouter et, dans le volet Propriétés, tapez SecondarySsoApplicationId pour la zone Nom . De même, tapez OracleSSO pour la zone PropertyValue . Sélectionnez System.String pour la zone Type .

   

4. Cliquez sur OK.

Exporter la définition d’application dans un fichier

Vous avez maintenant créé une définition d’application qui contient des métadonnées Oracle E-Business Suite instance. Vous devez exporter cette définition dans un fichier XML, qui peut être importé dans Microsoft Office SharePoint Server.

Pour exporter la définition d’application dans un fichier

1. Dans le volet Objets de métadonnées, cliquez avec le bouton droit sur le nœud MS_SAMPLE_EMPLOYEE , puis cliquez sur Exporter.

2. Enregistrez le fichier en tant que Employee.xml.

Étapes suivantes

Vous devez maintenant créer une application SharePoint pour récupérer des données à partir d’Oracle E-Business Suite. Pour obtenir des instructions, consultez Étape 3 : Créer une application SharePoint pour récupérer des données à partir d’Oracle E-Business Suite.

Voir aussi

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