Table of contents
TOC
Réduire la table des matières
Développer la table des matières
Dernière mise à jour: 20/06/2018

Créer des gestionnaires de fichiers dans Office 365

Concerne : Office 365

Dans cette procédure pas à pas, vous apprendrez à créer un gestionnaire de fichiers basique adapté à un type de fichier personnalisé, à l'aide du modèle de projet de l'application de gestionnaire de fichiers. Vous pouvez télécharger le modèle pour Visual Studio 2013 et Visual Studio 2015 à partir de l'application de gestionnaire de fichiers, ou le localiser dans la section Modèles en ligne dans la boîte de dialogue Nouveau projet

Créer et personnaliser l'application Office 365

Comme mentionné précédemment, cet exemple se base sur le modèle de projet de l'application de gestionnaire de fichiers. Vous devrez donc, pour commencer, créer un nouveau projet en utilisant ce modèle. Vous pouvez le télécharger à partir de l'application de gestionnaire de fichiers ou le localiser dans la sectionModèles en ligne de la boîte de dialogue Nouveau projet.

Pour télécharger le modèle et créer le projet

  1. Dans le menu Fichier, cliquez sur Nouveau puis sur Projet.
  2. Dans le volet de gauche, sélectionnez En ligne, et dans la catégorie Visual C# sélectionnez Office.
  3. L'application de gestionnaire de fichiers devrait apparaître en tant qu'option dans le volet du milieu. Sélectionnez-la, entrez le nom « basifilehandler » et cliquez sur OK pour créer le projet.

Si vous n'avez pas encore installé le modèle, il vous sera demandé de le faire.

Vous allez ensuite enregistrer l'application auprès d'Azure AD, puis la modifier pour ajouter la fonctionnalité d'extension du gestionnaire de fichiers.

Pour enregistrer et configurer l'application auprès d'Azure AD

  1. Dans l'explorateur de solutions, faites un clic droit sur le nom du projet, puis choisissez Ajouter > service connecté.

  2. Sélectionnez les API Office 365 et cliquez sur Configurer.

  3. Cliquez sur Enregistrer votre application.

    Remarque Le texte dans la boîte de dialogue Ajouter service connecté peut différer légèrement selon la version de Visual Studio sur laquelle vous travaillez. Si Enregistrer votre application n'est pas disponible, vous devrez sans doute supprimer les valeurs des espaces réservés pour ClientId et ClientSecret dans le web.config. Pour cela, recherchez les clés suivantes dans le web.cong et supprimez-les :

```xml
<add key="ida:ClientId" value="[ClientId placeholder]" />
<add key="ida:ClientSecret" value="[ClientSecret placeholder]" />
```
  1. Connectez-vous en utilisant un compte administrateur client pour votre organisation de développement Office 365.

  2. Cliquez sur Propriétés de l'application.

  3. Ajoutez les éléments suivants à la liste d'URI de redirection :

- `http://basicfilehandler.azurewebsites.net` 

- `https://basicfilehandler.azurewebsites.net` 

**Remarque** Le site basicfilehandler.azurewebsites.net est l'endroit où l'application de gestionnaire de fichiers sera hébergée. Vous le créerez quand vous publierez ce projet sur Azure lors d'une étape ultérieure.
  1. Cliquez sur Appliquer pour fermer la boîte de dialogue Propriétés de l'application, puis sur OK pour fermer la boîte de dialogue Gestionnaire de services.

À ce stade, Visual Studio ajoute les packages NuGet nécessaires au projet. Vous êtes maintenant prêt à configurer les autorisations de votre application. Cette étape doit être effectuée sur le portail de gestion d'Azure AD.

  1. Connectez-vous au portail de gestion d'Azure AD.

  2. Dans le panneau de navigation situé sur la gauche, sélectionnez Active Directory. Assurez-vous que l'onglet Directory est bien sélectionné, puis cliquez sur le nom du répertoire.

  3. Sur la page du répertoire, sélectionnez Applications. Vous devriez voir apparaître votre application de gestionnaire de fichiers. Si vous ne la trouvez pas dans la liste, sélectionnez Application que ma société possède dans le menu déroulant Montrer.

  4. Sélectionnez votre application, puis cliquez sur Configurer dans le menu supérieur.

  5. Faites défiler la page jusqu'en bas puis sélectionnez Ajouter applications sous Autorisations pour d'autres applications.

  6. Sélectionnez Microsoft Graph, puis cliquez sur l'icône de coche.

  7. Sous Autorisations pour d'autres applications, cliquez sur la colonne Autorisations déléguées et sélectionnez Accéder en lecture et en écriture à des fichiers sélectionnés par l'utilisateur.

  8. Cliquez sur Enregistrer dans la barre de navigation inférieure.

Codez l'application de gestionnaire de fichiers

Vous êtes maintenant prêt à ajouter le code spécifique au gestionnaire de fichiers dans votre application. Si vous avez utilisé le modèle de projet Application de gestionnaire de fichiers pour créer le projet, l'essentiel du travail a déjà été effectué pour vous. Il ne vous reste qu'à ajouter du code aux méthodes NewFile, Open et Preview afin de spécifier ce qui doit se passer pour ce type de fichier personnalisé.

Vous pouvez trouver ces méthodes dans le fichier FileHandlerController.cs situé dans le dossier Controllers de la solution de projet.

Pour la méthode Preview, recherchez la déclaration de méthode suivante :

public async Task<ActionResult> Preview()

Pour la méthode Open, recherchez la déclaration de méthode suivante :

public async Task<ActionResult> Open()

Pour la méthode NewFile, recherchez la déclaration de méthode suivante :

public async Task<ActionResult> NewFile()

Remarque La première partie du code pour ces méthodes charge les paramètres d'activation. Les paramètres d'activation contiennent des informations qu'Office 365 inclut dans la demande POST effectuée auprès du gestionnaire de fichiers. Le code inclus avec le modèle de projet accède à ces valeurs et les met en cache dès que le gestionnaire de fichiers est appelé. Pour plus d'informations sur les paramètres disponibles, voir Paramètres d'activation du gestionnaire de fichiers.

Publier l'application

Vous êtes maintenant prêt à publier l'application sur Azure.

  1. Dans l’Explorateur de solutions, faites un clic droit sur le projet et sélectionnez Publier.

  2. Sélectionnez Sites web Microsoft Azure.

  3. Lorsque vous êtes invité à entrer vos informations d'identification, entrez les informations d'identification que vous utilisez pour gérer votre abonnement Azure.

  4. Dans Sélectionner des sites web existants, cliquez sur Nouveau.

  5. Entrez basicfilehandler en tant que nom du site.

  6. Si vous n'avez pas configuré de serveur de base de données, spécifiez Créer un nouveau serveur. Si vous l'avez fait, sélectionnez le serveur de base de donnée à utiliser.

  7. Cliquez sur Créer.

  8. Une fois le site créé, cliquez sur Publier.

Configurer le gestionnaire de fichiers

Après la publication de l'application de gestionnaire de fichiers, vous êtes prêt à le configurer dans Office 365.

  1. Accédez à l'l'exemple d'outil du gestionnaire de compléments, qui est un exemple d'outil que vous pouvez utiliser pour effectuer les requêtes nécessaire auprès de l'API Graph d'Azure AD afin de configurer le gestionnaire de fichiers. L'utilisation de l'outil du gestionnaire de compléments mettra à jour la configuration de l'application dans Azure AD.

    Remarque L'exemple d'outil du gestionnaire de compléments est uniquement destiné à des fins de démonstration et de test, et il ne doit pas être utilisé dans des environnements de production.

  2. Lorsque la page est chargée dans le navigateur, cliquez sur Se connecter en haut à droite de la page.

  3. Entrez les informations d'identification de l'administrateur client, puis cliquez sur se connecter.

  4. Sélectionnez le nom de votre application de gestionnaire de fichiers dans Mes applications dans la barre de navigation de gauche.

  5. Cliquez sur Enregistrer le complément.

  6. Dans la boîte de dialogue Enregistrer le complément, sélectionnez Gestionnaire de fichiers.

  7. Dans la liste déroulante, cliquez sur Complément Gestionnaire de fichiers.

  8. Entrez les détails pour votre gestionnaire de fichiers. Remarque Le protocole doit être https.

  9. Cliquez sur Mettre à jour le complément.

Tester le gestionnaire de fichiers

Pour tester votre application, téléchargez des exemples de fichiers utilisant votre type de fichier personnalisé vers votre site SharePoint. Lorsque vous affichez la bibliothèque de documents, ces fichiers doivent s'afficher avec l'image que vous avez choisie comme icône de fichier personnalisée. Si vous modifiez les métadonnées du complément dans Azure Active Directory, vous pouvez constater les changements dans Office 365 en actualisant votre navigateur.

© 2018 Microsoft