Partager via

Étape 2 : Créer un fichier de définition d’application pour les opérations de composant métier Siebel

Étape 2 sur 4

Durée d’exécution : 15 minutes

Objectif: Le catalogue de données métiers 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 consommer.

L’outil Éditeur de définition de catalogue de données métiers vous permet de créer un fichier de définition d’application pour le catalogue de données métiers. Cet outil génère automatiquement le code XML du fichier de définition. Par conséquent, vous n’avez 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 consiste à effectuer une opération de requête sur le composant d’entreprise compte pour récupérer une liste d’enregistrements. Pour ce faire, vous devez effectuer un ensemble de tâches dans l’Éditeur de définition de catalogue de données métiers. Cette rubrique fournit des instructions sur la façon d’effectuer ces tâches.

Conditions préalables

Création d’un fichier de définition d’application

Cette section fournit des instructions pas à pas pour créer un fichier de définition d’application pour le service WCF.

Se connecter au service WCF et créer des entités

Vous devez vous connecter au service WCF pour extraire le langage WSDL (Web Services Description Language) pour le service. À partir de WSDL, l’éditeur de définition de catalogue de données métiers extrait les méthodes. Ces méthodes peuvent être utilisées pour créer des entités. Pour cet exemple, vous devez créer une entité pour l’opération de requête sur le composant métier compte.

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

  1. Démarrez l’éditeur de définition du catalogue de données métiers. Dans le menu Démarrer , cliquez sur Éditeur de définition de catalogue de données Métiers Microsoft.

  2. Dans l’outil, cliquez sur Ajouter un système LOB.

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

  4. Dans la zone URL, tapez l’URL du service WCF. L’URL doit être au format suivant :

    https://<computer_name>/Siebel_Account/BusinessObjects_Account_Account_Operation.svc?wsdl

    où, BusinessObjects_Account_Account_Operation.svc est le fichier de service créé pour le contrat Siebel.

    L’URL que vous devez taper est disponible lorsque vous testez si le service WCF est publié avec succès, comme décrit à l’étape 1 : Publier les opérations de composant métier Siebel en tant que service WCF.

  5. Cliquez sur Se connecter.

  6. Cliquez sur l’onglet Ajouter une méthode web pour afficher les opérations que vous avez sélectionnées dans l’Assistant Développement du service de l’adaptateur WCF. Vous verrez la méthode Query .

    Ajouter des méthodes web à l’application BDC

  7. Faites glisser la méthode Query vers l’aire de conception, puis cliquez sur OK.

  8. 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, tapez Siebel_Account, puis cliquez sur OK. Une entité, Entity0, est créée dans l’éditeur de définition de catalogue de données métiers.

    Important

    L’outil Éditeur de définition de catalogue de données métiers ne gère pas les types de données énumérés. Ainsi, l’outil Éditeur de définition de catalogue de données métiers importe les champs jusqu’à ce qu’il rencontre un type de données énuméré et ignore les champs restants. L’outil Éditeur de définition de catalogue de données métiers génère également une erreur. Vous pouvez ignorer cette erreur et continuer en cliquant sur OK. Vous pouvez ajouter manuellement les champs requis dans le fichier de définition d’application à une étape ultérieure.

  9. Modifiez les noms d’entité pour utiliser des noms plus conviviaux. Pour cet exemple, remplacez Entity0 par Compte.

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

    2. Sélectionnez le nœud Entity0 .

    3. Dans le volet Propriétés, tapez Compte dans le champ Nom .

      Renommez l’entité

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 les opérations de composant métier sélectionnées dans le système Siebel, 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 (étape 1 : Publier les opérations de composant métier Siebel en tant que service WCF). Vous devez spécifier les mêmes valeurs pour les propriétés de la méthode.

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

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

  2. Cliquez sur le nœud Requête, puis dans le volet Propriétés, cliquez sur le bouton à points de suspension (...) en face du champ 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 dans le champ Nom pour HttpHeaderUserName. De même, tapez MyUserHeader pour le champ PropertyValue. Sélectionnez System.String pour le champ Type .

    Ajouter une propriété

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

  5. Cliquez sur OK.

Configurer un Sign-On individuel pour se connecter à un système Siebel

Une fois que vous avez terminé d’effectuer toutes les procédures de cette rubrique, vous aurez créé un XML de définition d’application qui peut être importé dans une application SharePoint. À partir de l’application, vous allez appeler les opérations de composant métier Siebel (exposées en tant que méthodes Web) pour récupérer les données pertinentes du système Siebel. Pour l’activer, vous devez créer un mappage entre un utilisateur dans le système Siebel et l’utilisateur dans l’application SharePoint. Vous créez ce mappage dans le site web Administration centrale sharePoint après avoir importé le code XML 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 de catalogue de données métiers.

Pour définir la propriété SecondarySsoApplicationId

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

  2. Cliquez sur Siebel_Account_Instance et, dans le volet Propriétés, cliquez sur le bouton de sélection (...) sur le champ Propriétés .

  3. Dans la fenêtre Éditeur de collection PropertyView, cliquez sur Ajouter, puis, dans le volet Propriétés, tapez SecondarySsoApplicationId pour le champ Nom . De même, tapez SiebelSSO pour le champ PropertyValue . Sélectionnez System.String pour le champ Type .

    Ajouter la propriété SSO

  4. Cliquez sur OK.

Condition requise : effectuer une opération de requête sur le composant Professionnel du compte

La première exigence de cet exemple est de créer une définition d’application qui peut être utilisée pour effectuer une opération de requête sur le composant métier compte. Pour obtenir cette exigence, vous devez effectuer l’ensemble de tâches suivant :

  • Dans la méthode Query, créez un filtre et mappez-le au paramètre sur lequel l’opération de requête est effectuée. Pour le composant entreprise Compte, vous allez effectuer une requête en utilisant le paramètre SearchExpr. Par conséquent, vous allez mapper le filtre au paramètre SearchExpr .

  • Créez une instance de méthode Finder pour la méthode Query. 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 SearchExpr

  1. Créez un filtre pour la méthode Query.

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

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

      Ajouter un filtre à une méthode

    3. Dans le volet Propriétés, tapez SearchExpression dans le champ Nom.

    4. Pour la propriété FilterType , sélectionnez Equals.

      Spécifiez un nom de filtre et un type

  2. Mappez le filtre au paramètre SearchExpr dans la méthode Query.

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

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

    3. Développez le nœud AccountQueryInputRecord , puis développez le deuxième nœud AccountQueryInputRecord .

    4. Cliquez sur le nœud SearchExpr et, dans le volet Propriétés, sélectionnez SearchExpression dans la liste FilterDescriptor.

      Mapper un paramètre à un filtre

      Important

      AccountQueryInputRecord contient également un nœud QueryFields, qui contient à son tour un nœud Item. Vous devez supprimer le nœud Élément, sinon l’opération Query sur le composant métier Compte risque de ne pas donner les résultats souhaités. Pour supprimer le nœud Élément , cliquez avec le bouton droit sur le nœud, puis sélectionnez Supprimer.

Pour créer une instance de méthode Finder pour la méthode Query

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

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

    Capture d’écran montrant comment ajouter une instance de méthode Finder.

  3. Dans la fenêtre Créer une instance de méthode, cliquez sur Finder pour le type d’instance de méthode.

  4. Cliquez sur Retour dans la section Retour TypeDescriptor.

    Capture d’écran montrant où afficher la section Retour TypeDescriptor.

  5. Cliquez sur OK.

  6. Dans le volet Propriétés, tapez QueryAccount dans le champ Nom.

    Spécifiez un nom pour l’instance de méthode

Supprimer les paramètres du type System.Nullable

Les paramètres de retour de la fonction De requête peuvent contenir des paramètres de type System.Nullable. En raison de la présence de ces paramètres dans la définition de l’application, vous pouvez obtenir une erreur lors de la présentation des données Siebel sur un portail SharePoint. Par conséquent, vous devez supprimer les paramètres du type System.Nullable de la définition de l’application.

En outre, pour chaque paramètre de type System.Nullable, l’Éditeur de définition de catalogue de données métiers crée un autre paramètre de type System.Boolean et ajoute « Spécifié » au nom du paramètre. Par exemple, le paramètre AccountRole est de type System.Nullable. Par conséquent, l’éditeur de définition de catalogue de données métiers ajoute un paramètre AccountRoleSpecified à la liste des paramètres. Vous devez également supprimer ces paramètres.

Remarque

Vous pouvez voir le type de paramètre en sélectionnant le paramètre dans l’Éditeur de définition de catalogue de données métiers et en examinant la valeur de la propriété TypeName dans le volet Propriétés.

Remarque

Vous pouvez ignorer cette étape si l’application ne contient aucun paramètre de type System.Nullable.

Pour supprimer les paramètres du type System.Nullable pour la méthode Query

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

  2. Développez le nœud Requête , puis développez le nœud Paramètres .

  3. Développez le nœud Retour , puis développez le deuxième nœud Retour .

  4. Cliquez avec le bouton droit sur le paramètre à supprimer, puis sélectionnez Supprimer.

  5. Dans la boîte de dialogue, cliquez sur OK.

Exporter la définition d’application vers un fichier

Vous avez maintenant créé une définition d’application qui contient les métadonnées d’instance système Siebel. Vous devez exporter cette définition vers un fichier XML, qui peut être importé dans Microsoft Office SharePoint Server.

Pour exporter la définition de l’application vers un fichier

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

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

Modifier le fichier de définition d’application pour inclure des paramètres spécifiques

Comme mentionné précédemment dans cette rubrique, l’outil Éditeur de définition de catalogue de données métiers ne gère pas les types de données énumérés. L’outil Éditeur de définition de catalogue de données métiers importe les champs jusqu’à ce qu’il rencontre un type de données énuméré et ignore les champs restants. Par conséquent, certains champs souhaités dans votre application peuvent être omis. Vous pouvez modifier manuellement le fichier de définition d’application pour inclure ces champs.

Remarque

Vous devez vous assurer que les paramètres que vous ajoutez sont présents dans le fichier .cs généré par l'Assistant de développement du service d'adaptateur WCF à l’étape 1 : publier les opérations de composant métier Siebel comme un service WCF.

Dans ce fichier de définition d’application, vous allez ajouter ou supprimer des paramètres de retour pour la méthode QueryAccount .

Pour modifier le fichier de définition d’application

  1. Ouvrez le fichier de définition d’application, Siebel_Account.xml, à l’aide de Visual Studio ou d’un autre éditeur.

  2. Modifiez le fichier de définition d’application pour remplacer les paramètres de la méthode QueryAccount .

    1. Dans le fichier de définition d’application, recherchez les éléments suivants :

      <TypeDescriptor TypeName="BDC.AccountQueryRecord,Siebel_Account" Name="Item">

    2. Dans la <TypeDescriptors> balise, remplacez les éléments existants <TypeDescriptor> par les éléments suivants :

      
<TypeDescriptor TypeName="System.String, mscorlib, Version=2.0.0.0, Culture=neutral, PublicKeyToken=<token>" Name="Id" />
<TypeDescriptor TypeName="System.String, mscorlib, Version=2.0.0.0, Culture=neutral, PublicKeyToken=<token>" Name="Country" />
<TypeDescriptor TypeName="System.String, mscorlib, Version=2.0.0.0, Culture=neutral, PublicKeyToken=<token>" Name="Name" />
<TypeDescriptor TypeName="System.String, mscorlib, Version=2.0.0.0, Culture=neutral, PublicKeyToken=<token>" Name="Location" />

    3. Enregistrez et fermez le fichier.

    Conseil / Astuce

    Vous pouvez importer le fichier de définition d’application mis à jour dans l’outil Éditeur de définition du catalogue de données métiers pour afficher les champs nouvellement ajoutés. Toutefois, avant d’importer, vous devrez supprimer l’application « Siebel_Account » existante de l’outil Éditeur de définition du catalogue de données métiers.

Étapes suivantes

Vous devez maintenant créer une application SharePoint pour récupérer des données à partir d’un système Siebel. Consultez l’étape 3 : Créer une application SharePoint pour récupérer des données à partir de Siebel pour des instructions.

Voir aussi

Tutoriel 1 : Présentation des données à partir d’un système Siebel sur un site SharePoint