Partager via

Comment utiliser un composant WebPart personnalisé avec Oracle E-Business Suite

  • Article

Cette section fournit des informations sur l’utilisation d’un composant WebPart personnalisé avec Microsoft Office SharePoint Server. Pour utiliser un composant WebPart personnalisé, vous devez effectuer les opérations suivantes :

  1. Créer un composant WebPart personnalisé

  2. Déployer le composant WebPart personnalisé sur un portail SharePoint

  3. Configurer le portail SharePoint pour utiliser le composant WebPart personnalisé

Avant de commencer

Avant de créer un composant WebPart personnalisé :

Étape 1 : Créer un composant WebPart personnalisé

  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 Bibliothèque de classes.

  3. Spécifiez un nom et un emplacement pour la solution. Pour cette rubrique, spécifiez CustomWebPart dans les zones Nom et Nom de la solution . Spécifiez un emplacement, puis cliquez sur OK.

  4. Ajoutez une référence au composant System.Web dans le projet. Cliquez avec le bouton droit sur le nom du projet dans Explorateur de solutions, puis cliquez sur Ajouter une référence. Dans la boîte de dialogue Ajouter une référence , sélectionnez System.Web sous l’onglet .NET , puis cliquez sur OK. Le composant System.Web contient l’espace de noms requis de System.Web.UI.WebControls.WebParts.

  5. Ajoutez le code requis en fonction de votre problème dans le projet. Pour obtenir l’exemple de code correspondant à un problème spécifique, consultez « Problèmes impliquant des composants WebPart personnalisés » dans Considérations relatives à l’utilisation de l’adaptateur Oracle-Business Suite avec SharePoint.

  6. Créez le projet. Une fois la génération réussie du projet, un fichier .dll, CustomWebPart.dll, est généré dans le <dossier> du projet/bin/Debug.

  7. Uniquement pour l’ordinateur 64 bits : signez le fichier CustomWebPart.dll avec un nom fort avant d’effectuer les étapes suivantes. Sinon, vous ne serez pas en mesure d’importer et, par conséquent, d’utiliser le CustomWebPart.dll dans le portail SharePoint dans « Étape 3 : Configurer le portail SharePoint pour utiliser le composant WebPart personnalisé ». Pour plus d’informations sur la signature d’un assembly avec un nom fort, consultez Guide pratique pour signer un assembly avec un nom fort.

Étape 2 : Déployer le composant WebPart personnalisé sur un portail SharePoint

Vous devez effectuer les opérations suivantes pour que le fichier CustomWebPart.dll (composant WebPart personnalisé) créé à l’étape 1 : Créer un composant WebPart personnalisé de cette rubrique soit utilisable sur le portail SharePoint :

  • Copiez le fichier CustomWebPart.dll dans le dossier bin du portail SharePoint : Microsoft Office SharePoint Server crée des portails sous le <dossier racine :>\Inetpub\wwwroot\wss\VirtualDirectories. Un dossier est créé pour chaque portail et peut être identifié avec le numéro de port. Vous devez copier le fichier CustomWebPart.dll créé dans « Étape 1 : Créer un composant WebPart personnalisé » de cette rubrique dans le <dossier lecteur> racine :\Inetpub\wwwroot\wss\VirtualDirectories\<Port_Number>\bin. Par exemple, si le numéro de port de votre portail SharePoint est 13614, vous devez copier le fichier CustomWebPart.dll dans le <dossier lecteur> racine :\Inetpub\wwwroot\wss\VirtualDirectories\13614\bin.

    Conseil

    Une autre façon de rechercher l’emplacement du dossier de votre portail SharePoint consiste à utiliser la fenêtre Gestionnaire des services Internet (IIS) (Démarrer>l’exécution>de l’inetmgr). Recherchez votre portail SharePoint dans la fenêtre Gestionnaire des services Internet (IIS) ([computer_name] > Sites > web [Nom du portail]), cliquez avec le bouton droit, puis cliquez sur Propriétés dans le menu contextuel. Dans la boîte de dialogue propriétés du portail SharePoint, cliquez sur l’onglet Répertoire d’accueil , puis sélectionnez la zone Chemin d’accès local .

  • Ajoutez l’entrée de contrôle sécurisé dans le fichier web.config : étant donné que le fichier CustomWebPart.dll sera utilisé sur différents ordinateurs et par plusieurs utilisateurs, vous devez déclarer le fichier comme « sécurisé ». Pour ce faire, ouvrez le fichier web.config situé dans le dossier du portail SharePoint à l’emplacement <racine> :\Inetpub\wwwroot\wss\VirtualDirectories\<Port_Number>. Dans la <SafeControls> section du fichier web.config, ajoutez l’entrée de contrôle sécurisé suivante :

    • Sur un ordinateur 32 bits :

      <SafeControl Assembly="CustomWebPart" Namespace="CustomWebPart" TypeName="*" Safe="True" />

    • Sur un ordinateur 64 bits :

      <SafeControl Assembly="CustomWebPart, Version=1.0.0.0, Culture=neutral, PublicKeyToken=<PUBLICKKEYTOKEN_OF_CustomWebPart.dll>" Namespace="CustomWebPart" TypeName="*" Safe="True" />

      Enregistrez le fichier web.config, puis fermez-le.

Étape 3 : Configurer le portail SharePoint pour utiliser le composant WebPart personnalisé

Vous devez ajouter le composant WebPart personnalisé à la Galerie de composants WebPart Microsoft Office SharePoint Server, afin de pouvoir l’utiliser sur votre portail SharePoint. Pour cela, procédez de la façon suivante :

  1. Démarrez l’Administration centrale de SharePoint 3.0. Cliquez sur Démarrer, pointez sur Tous les programmes, sur Microsoft Office Server, puis cliquez sur Administration centrale de SharePoint 3.0.

  2. Dans le volet de navigation gauche, cliquez sur le nom du fournisseur de services partagés (SSP) auquel vous souhaitez ajouter le composant WebPart personnalisé.

  3. Dans la page Administration des services partagés, dans le coin supérieur droit, cliquez sur Actions du site, puis sur Créer.

  4. Dans la page Paramètres du site, cliquez sur Composants WebPart sous la colonne Galeries .

  5. Dans la page Galerie de composants WebPart, pour ajouter le composant WebPart personnalisé à la galerie, cliquez sur Nouveau. À ce stade, le composant WebPart personnalisé n’est pas disponible dans la page Galerie de composants WebPart.

  6. Dans la page Nouveaux composants WebPart, recherchezCustomWebPart (nom du composant WebPart personnalisé) dans la liste, sélectionnez la zone case activée à gauche, puis cliquez sur Remplir la galerie en haut de la page. Cela ajoute l’entrée CustomWebPart dans la page Galerie de composants WebPart.

    Vous pouvez maintenant utiliser le composant WebPart personnalisé (CustomWebPart) pour créer des composants WebPart dans votre portail SharePoint. Le composant WebPart personnalisé (CustomWebPart) s’affiche sous la section Divers de la page Ajouter des composants WebPart.

Voir aussi

Utiliser l’adaptateur Oracle E-Business Suite avec SharePoint