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

Aperçu des gestionnaires de fichiers Office 365

S'applique à : Office 365

Les gestionnaires de fichiers sont des nouveaux types de complément Office qui intègrent des types de fichiers non Microsoft à Office 365 de la même façon que les types de fichiers Office.

Grâce aux gestionnaires de fichiers, vous pouvez activer les expériences utilisateur suivantes pour les types de fichiers non-Microsoft :

  • icônes de fichiers personnalisés
  • créez de nouveaux fichiers dans le navigateur
  • aperçu du fichier
  • vue enrichie/capacité d'édition

Que contient un gestionnaire de fichiers Office 365

Un gestionnaire de fichiers comprend ce qui suit :

  • Point de terminaison du gestionnaire de fichiers Une application hébergée dans le cloud qui propose en option des fonctionnalités de création, de prévisualisation et de modification pour les nouveaux types de fichiers pris en charge par le gestionnaire de fichiers.
  • Icône de fichier L'image qui représente le type de fichier dans Office 365.

Application du gestionnaire de fichiers

L'application du gestionnaire de fichiers est une application hébergée sur le cloud qui inclut une logique fonctionnelle pour la création, la prévisualisation, l’ouverture et l’enregistrement des types de fichiers qu'elle gère. Elle peut être hébergé sur n’importe quel pile, y compris des piles non Microsoft. Les gestionnaires de fichiers utilisent Azure Active Directory pour pouvoir accéder aux ressources d’Office 365. Par conséquent, votre application doit être enregistrée avec Azure AD. Pour en savoir plus sur l'enregistrement d'une application avec Azure AD, voir la rubrique : Utilisation de Visual Studio pour enregistrer votre application et ajouter des API Office 365 et Enregistrez manuellement votre application avec Azure AD afin qu'elle puisse accéder aux API Office 365.

Voir la rubrique Créer des gestionnaires de fichiers dans Office 365 pour une procédure pas à pas à l'aide de Visual Studio pour créer, déployer et enregistrer un gestionnaire de fichiers de base.

Pour un exemple de gestionnaire de fichiers plus complexe, voir GPX-FileHandler sur GitHub.

Gestionnaires de fichiers à l'exécution

Le gestionnaire de fichiers est appelé avec les URL newFileUrl, openUrl ou previewUrl spécifiées dans la propriété compléments du manifeste de l'application Azure AD. Pour comprendre ce qui se passe, jetons un coup d'œil au scénario dans lequel un utilisateur clique sur les ellipses (...) pour ouvrir la légende du fichier. S'il existe un gestionnaire de fichiers enregistré pour ce type de fichier, Office 365 appelle l'application du gestionnaire de fichiers en adressant une requête POST à l'URL spécifiée dans le previewUrl pour le manifeste de l'application, en passant l'emplacement du fichier, avec d'autres détails dans la requête. L'URL previewUrl pointe vers une méthode dans l'application du gestionnaire de fichiers qui récupérera un flux de fichier pour le fichier, puis utilise ce flux pour fournir un aperçu du fichier dans le navigateur.

C'est la même approche pour la fonctionnalité ouverte. Dans un scénario où l'utilisateur clique sur Modifier dans le navigateurou directement sur le titre du document dans la bibliothèque, Office 365 adresse une requête POST à l'URL openUrl. Ce point de terminaison charge le flux de fichiers dans un éditeur approprié, permettant à l'utilisateur de modifier le fichier. L'application doit également permettre à l'utilisateur d'enregistrer le fichier en transmettant le flux de fichier mis à jour à l'emplacement du fichier, spécifié dans le paramètre d'activation filePut.

Lorsqu'un utilisateur clique sur Nouveau fichier, Office 365 adresse une requête POST à newFileUrl. Ce point de terminaison ouvre ensuite l'éditeur approprié pour permettre à l'utilisateur d'ajouter du contenu au nouveau fichier. L'application doit permettre à l'utilisateur de sauvegarder le fichier à nouveau dans l'emplacement du fichier spécifié dans le paramètre d'activation filePut.

Paramètres d’activation

Dans créer nouveau, ouvrez et prévisualisez les scénarios, votre application nécessite des détails appelés paramètres d'activation, sur le fichier, le client, le client Office 365, etc... pour fonctionner avec le fichier. Office 365 inclut ces détails en tant que données de formulaire envoyées dans la requête POST aux méthodes d'ouverture ou de prévisualisation.

Tableau 1. Descriptions des paramètres d'activation qu'Office 365 envoie lorsque le gestionnaire de fichiers est lancé.

ParamètreDescription
ClientLe client Office 365 à partir duquel le fichier est ouvert ou prévisualisé, notamment « SharePoint ».
CultureNameLe nom de la culture de la conversation actuelle, utilisé pour la localisation.
FileGetL'URL complète du point de terminaison REST que votre application appelle pour récupérer le fichier à partir d'Office 365. Votre application doit l'appeler par la méthode HTTP GET.
FilePutL'URL complète du point de terminaison REST que votre application appelle pour enregistrer le fichier à nouveau dans Office 365. Votre application doit l'appeler par la méthode HTTP POST.
ResourceIdL'URL du client Office 365 utilisée pour obtenir le jeton d'accès à partir d'Azure AD.
FileIdL'ID de document pour un document spécifique qui permet à votre application d'ouvrir plus d'un document en même temps.

Accédez à ces valeurs à partir du corps de la requête, à l'aide de la collection Request.Form. Par exemple :

Request.Form["FileId"];

L'application doit mettre en cache ces valeurs dès que le gestionnaire de fichiers est appelé, car la première fois que l'application est invoquée pour un utilisateur sans jeton d'accès, elle sera redirigée vers Azure AD, déclenchant le flux de code d'autorisation OAuth. Leur mise en cache les rend immédiatement disponibles une fois l'autorisation Azure AD terminée et le navigateur redirigé vers le gestionnaire de fichiers. Vous pouvez voir un exemple d'utilisation d'un objet de modèle de données et de méthode de gestionnaire pour mettre en cache le paramètre d'activation dans un témoin, dans l'exemple GPX-FileHandler, plus précisément ActivationParameters.cs et FileHandlerController.cs.

Manifeste d’application et la propriété addIns.

Spécifiez les détails du gestionnaire de fichiers dans la propriété addIns du manifeste de l'application. La propriété addIns énumère les gestionnaires de fichiers contenus dans une application, et les propriétés associées. Ces détails sont utilisés pour configurer un gestionnaire de fichiers pour une extension de Office 365, spécifiant le comportement en ouverture et en prévisualisation du nouveau fichier pour cette extension.

La syntaxe du manifeste est :

{
    "addIns": [
        {
            "id": "unique guid",
            "type": "FileHandler",
            "properties": [
                {
                    "key": "extension",
                    "value": "List of file extensions separated by semicolons"
                },
                {
                    "key": "fileIcon",
                    "value": "URL of icon for the file type"
                },
                {
                    "key": "newFileUrl",
                    "value": "URL for the new file function"
                },
                {
                    "key": "openUrl",
                    "value": "URL for the file open function"
                },
                {
                    "key": "previewUrl",
                    "value": "URL for the file preview function"
                }
            ]
        }
    ]
}

Pour configurer le gestionnaire de fichiers, vous devez mettre à jour le manifest de l'application dans Azure AD. Il n’existe actuellement aucune IU dans le portail de gestion Azure pour réaliser cela, vous devez donc le faire en utilisant les requêtes de l'API Azure AD Graph Voir Configuration et mise à jour des gestionnaires de fichiers dans Office 365 pour plus d'informations.

Disponibilité du gestionnaire de fichiers

Le tableau suivant répertorie les services Office 365 qui prennent en charge les gestionnaires de fichiers.

Nom du serviceDisponibilité
SharePoint OnlineGénéralement disponible
OneDrive EntrepriseGA
Outlook Web AppGA

Dans cette section

© 2018 Microsoft