Partager via

Étape 4 : implémenter la solution Outlook avancée basée sur du code

  • Article

Dernière modification : mardi 6 juillet 2010

S’applique à : SharePoint Server 2010

Les étapes suivantes montrent comment créer une solution Microsoft Outlook avancée basée sur du code qui utilise Microsoft Business Connectivity Services (BCS).

Conditions requises

  1. Étape 1 : créer le modèle BDC

  2. Étape 2 : Créer un abonnement au cache

  3. Étape 3 : Créer le manifeste de solution

Pour créer le projet de complément Outlook

  1. Créez un projet de complément Outlook 2010 en C# dans Microsoft Visual Studio 2010 :

    1. Dans Visual Studio 2010, cliquez sur Fichier, sur Nouveau, puis sur Projet.

    2. Dans la boîte de dialogue Nouveau projet, dans le volet Modèles installés, développez Visual C#, Office, puis sélectionnez 2010.

    3. Dans la barre supérieure du volet central, sélectionnez .NET Framework 3.5 dans la liste déroulante.

    4. Dans le volet central, sélectionnez Complément Outlook 2010.

    5. Le nom du projet par défaut est OutlookAddIn1. Vous pouvez spécifier un nom de projet différent si vous le souhaitez.

      Vous pouvez conserver les valeurs par défaut pour l’emplacement et le nom de la solution, ou les modifier si vous voulez des valeurs différentes.

    6. Cliquez sur OK pour créer le projet.

  2. Effectuez les étapes ci-après pour ajouter les références suivantes :

    • Microsoft.BusinessData

    • Microsoft.Office.BusinessApplications.Runtime

    1. Dans l’Explorateur de solutions, recherchez le nœud Références sous votre projet, cliquez dessus avec le bouton droit, puis sélectionnez Ajouter une référence.

    2. Dans la boîte de dialogue Ajouter une référence, cliquez sur l’onglet Parcourir, puis accédez à l’assembly désiré dans le dossier d’installation d’Office (généralement %ProgramFiles%\Microsoft Office\Office14\).

    3. Double-cliquez sur l’assembly pour l’ajouter.

    4. Répétez ce processus pour chaque assembly.

  3. Ajoutez les directives using suivantes en haut de ThisAddIn.cs.

    using BCSRuntime = Microsoft.Office.BusinessApplications.Runtime;
using System.IO;

  4. Ajoutez la ligne de code suivante au début de la classe ThisAddIn pour déclarer la variable globale pour le RuntimeClass.

    public static BCSRuntime.RuntimeClass newRuntime = null;

  5. Ajoutez le code suivant dans le corps de la méthode ThisAddIn_StartUp.

    La variable solutionOIRNamePath pointe vers le dossier cible de déploiement de la solution, qui contient tous les autres artefacts de la solution (modèle BDC et abonnements de cache).

    string solutionOIRNamePath = Path.Combine(AppDomain.CurrentDomain.BaseDirectory, "oir.config");
newRuntime = new BCSRuntime.RuntimeClass();
newRuntime.Register(soltionOIRNamePath, new NewRuntimeCallback(), this.Application);

  6. Ajoutez le code suivant dans le corps de la méthode ThisAddIn_Shutdown.

    newRuntime.Unregister();

  7. Ajoutez une nouvelle classe nommée ContosoSalesManagerRuntimeCallback :

    1. Dans l’Explorateur de solutions, cliquez avec le bouton droit sur le nœud du projet, sélectionnez Ajouter, puis Classe.

    2. Dans la boîte de dialogue Ajouter un nouvel élément, tapez ContosoSalesManagerRuntimeCallback.cs comme nom de la classe, puis cliquez sur Ajouter.

  8. Dans ContosoSalesManagerRuntimeCallback.cs, ajoutez les directives using suivantes en haut du fichier.

    using BCSRuntime = Microsoft.Office.BusinessApplications.Runtime;
using System.Windows.Forms;

  9. Ajoutez : BCSRuntime.IRuntimeCallback à la fin de class ContosoSalesManagerRuntimeCallback.

    De cette façon, la classe hérite de l’interface IRuntimeCallback.

  10. Ajoutez le code suivant dans le corps de la classe ContosoSalesManagerRuntimeCallback.

    public ContosoSalesManagerRuntimeCallback()
{
}

public void RegistrationComplete(string solutionID, bool success)
{
    if (null != solutionID && success)
    {
        // Solution registration succeeded.
        // To Do: Trigger any custom events.
        // Example: MessageBox.Show("Solution registration succeeded for solution ID: {0}", solutionID);
    }
    else
    {
        // Solution registration failed.                
        // Example: MessageBox.Show("Solution registration failed for solution ID: {0}", solutionID);                
    }
}

  11. Générez la solution.

    Le fichier d’assembly de la solution est créé, par exemple OutlookAddIn1.dll dans le dossier bin\debug si vous utilisez la configuration debug.

  12. Vous disposez désormais du modèle de base pour une solution avancée basée sur du code. Vous pouvez ajouter votre propre code à cette solution pour créer des personnalisations telles que des Rubans personnalisés, des volets de tâches ou d’autres éléments personnalisés au niveau de l’interface utilisateur.

Étapes suivantes

Étape 5 : créer un package et déployer la solution Outlook avancée à base de code