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

Configurez et mettez à jour les gestionnaires de fichiers dans Office 365

S'applique à : Office 365

Le manifeste d’application et la propriété addIns

L'Entité application dans l'Azure Active Directory (AD) contient une nouvelle propriété, addIns, pour prendre en charge les gestionnaires de fichiers. 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 avec Office 365, en spécifiant les comportements nouveau fichier, ouvrir et aperçu 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"
                }
            ]
        }
    ]
}

Remarque les clés de propriété sont sensibles à la casse.

Le schéma est décrit dans la table suivante.

MembreDescriptionType de donnéesParentMembres de l'enfant
addInsÉlément racine ; contient un tableau d'objets définissant les gestionnaires de fichiers dans l'application.tableauaucuntype
propriétés
idIdentifie un complément individuel dans la collection de compléments ; vous pouvez utiliser un outil de génération de GUID pour générer la valeur.GUIDaddInsaucun
typeLe type du complément. Pour les gestionnaires de fichiers, la valeur est "FileHandler".chaîneaddInsaucun
propriétésDéfinit les propriétés du gestionnaire de fichiersobjetaddInsextension
fileIcon
newFileUrl
previewUrl
openUrl
extensionL'extension du gestionnaire de fichiers sans le caractère "." de début ; par exemple, "psd". Plusieurs extensions de fichiers, séparées par un point-virgule, peuvent être indiquées.chaînepropriétésaucun
fileIconl'URL de l'icône représentant le type de fichier ; par exemple, "https://fabrikam.com/SampleFileHandler/psdicon.png". Le protocole doit être https et peut être n'importe quel format d'image pouvant être affiché dans une page HTML. L'image se redimensionnera automatiquement et la dimension recommandée pour l'image est de 32x32 pixels.chaînepropriétésaucun
newFileUrll'URL de la fonction nouveau fichier ; par exemple, "https://fabrikam.com/SampleFileHandler/newFile". Le protocole doit être https.chaînepropriétésaucun
previewUrll'URL de la fonction aperçu ; par exemple, "https://fabrikam.com/SampleFileHandler/preview". Le protocole doit être https.chaînepropriétésaucun
openUrll'URL de la fonction qui ouvre le fichier en édition ; par exemple, "https://fabrikam.com/SampleFileHandler/open". Le protocole doit être https.chaînepropriétésaucun

Pour configurer un gestionnaire de fichiers, vous devez ajouter les détails du gestionnaire de fichiers, via la propriété addIns, au manifeste de l'application dans Azure AD. Il n’existe actuellement aucune IU dans le portail de gestion d'Azure pour réaliser cela, de sorte que vous devez le faire manuellement en utilisant des requêtes de l’API Azure AD Graph.

Avec la première requête, vous devez récupérer l'objectId de l'application. Pour ce faire, vous utilisez une requêteGET avec l'appId comme paramètre de filtre pour la requête. Remarque l'objectId et l'appId sont tous deux des GUID qui identifient l'application, mais ils n'ont pas la même valeur.

Vous pouvez trouver l'appId, également connu comme le Client ID, dans la page de configuration de votre application dans le portail Azure Management, dans la propriété Client ID. Vous pouvez également le trouver dans la clé ClientID de la section appSettings du web.config de votre application.

Pour récupérer l'objectId, envoyez la requête GET suivante à l'Azure AD Graph.

GET https://graph.windows.net/contoso.com/applications?api-version=1.6&$filter=appId%20eq%20'appId'

Remplacez contoso.com par votre domaine client, et appId par la valeur de Client ID. Cette requête retournera l'objet application, qui contient la propriété objectId.

Vous êtes maintenant prêt à construire la requête pour mettre à jour la configuration du gestionnaire de fichiers, ainsi que suit :

PATCH https://graph.windows.net/contoso.com/applications/objectId/?api-version=1.6

Remplacez contoso.com par votre domaine client et objectId par la valeur objectId que vous avez récupérée avec la première requête. Définissez le type de contenu comme application/json, et passez le json spécifiant les détails de la configuration du gestionnaire de fichiers dans le corps de la requête.

Remarque la propriété addIns fait partie du schéma d'Azure AD Graph 1.6, de sorte que vous devez spécifier 1.6 pour les paramètres api-version, comme montré dans les exemples précédents.

Pour plus d'informations, voir Contrôle de version de l'API Azure AD Graph.

Remarque après la mise à jour de la configuration de l'application, vos modifications ne seront pas visibles si vous téléchargez le fichier manifeste.

Exemple d'outil Gestionnaire de complément

Vous pouvez utiliser l'Exemple d'outil Gestionnaire de compléments pour faire que les requêtes Azure AD Graph configurent et mettent à jour un gestionnaire de fichiers une fois que vous avez enregistré l'application de gestionnaire de fichiers dans Azure AD. L'utilisation de l'outil Gestionnaire de compléments mettra à jour la configuration de l'application dans Azure AD.

Remarque l'exemple d'outil 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.

Pour utiliser l'outil Gestionnaire de complément pour configurer un gestionnaire de fichiers

  1. Aller à Exemple d'outil Gestionnaire de complément.
  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 le 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.

Si le gestionnaire de fichiers a été configuré avec succès, vous verrez une boîte de message confirmant la réussite de la mise à jour.

© 2018 Microsoft