Procédure : Enregistrer un complément gestionnaire de fichiers manuellement.

Article
04/08/2023

Pour développer un complément gestionnaire de fichiers, vous devez tout d’abord charger le manifeste de votre gestionnaire de fichier dans l’inscription de votre application dans Azure Active Directory. Cette opération peut être effectuée par programmation ou via l’éditeur de manifeste d’application Azure Active Directory.

Manifeste d’application et propriété addIns

Les manifestes de gestionnaires de fichiers sont stockés avec le manifeste de votre application dans Azure Active Directory. La propriété addIns du manifeste d’application répertorie les compléments d’une application, tels que les gestionnaires de fichiers et leurs propriétés associées.

Le manifeste est constitué d’un ensemble de propriétés clé-valeur qui définissent les propriétés du gestionnaire de fichiers. Pour plus d’informations sur le manifeste du gestionnaire de fichiers, voir Vue d’ensemble du Gestionnaire de fichiers.

Exemple de manifeste de gestionnaire de fichiers :

{
"id": "968A844F-7A47-430C-9163-07AE7C31D407",
"type": "FileHandler",
"properties": [
    { "key": "version", "value": "2" },
    { "key": "fileTypeDisplayName", "value": "Display name of the file format" },
    { "key": "fileTypeIcon", "value": "{\"svg\":\"https://example.org/icon.svg\",\"png1x\":\"https://example.org/icon@1x.png\",\"png1.5x\":\"https://example.org/icon@1.5x.png\",\"png2x\":\"https://example.org/icon@2x.png\"}" },
    { "key": "appIcon", "value": "{\"svg\":\"https://example.org/app-icon.svg\",\"png1x\":\"https://example.org/app-icon@1x.png\",\"png1.5x\":\"https://example.org/app-icon@1.5x.png\",\"png2x\":\"https://example.org/app-icon@2x.png\"}" },
    { "key": "actions", "value": "json string of additional actions"}
  ]
}

Pour inscrire un gestionnaire de fichiers, vous devez mettre à jour la collection addIns dans le manifeste d’application stocké dans Azure Active Directory.

Mise à jour du manifeste d’application dans AAD

Cette méthode vous oblige à mettre à jour le manifeste JSON directement dans AAD.

Accéder à l’application dans Azure Active Directory
Sélectionnez l’option de menu de gauche « Manifeste »
Collez votre gestionnaire de fichiers Add-In JSON dans le tableau « addIns » comme indiqué ci-dessous :

{
	"id": "9280aaa1-65c3-4a01-9ced-4f3e8e989c56",
	"acceptMappedClaims": null,
	"accessTokenAcceptedVersion": 2,
	"addIns": [
		{
			"id": "328486ea-7159-4b6a-a2aa-f036b2423b23",
			"type": "FileHandler",
			"properties": [
				{
					"key": "version",
					"value": "2"
				},
				{
					"key": "fileTypeDisplayName",
					"value": "Contoso Markdown"
				},
				{
					"key": "fileTypeIcon",
					"value": "{\"svg\":\"https://localhost:3000/images/icons/icon.svg\",\"png1x\":\"https://localhost:3000/images/icons/icon@1x.png\",\"png1.5x\":\"https://localhost:3000/images/icons/icon@1.5x.png\",\"png2x\":\"https://localhost:3000/images/icons/icon@2x.png\"}"
				},
				{
					"key": "appIcon",
					"value": "{\"svg\":\"https://localhost:3000/images/icons/app-icon.svg\",\"png1x\":\"https://localhost:3000/images/icons/app-icon@1x.png\",\"png1.5x\":\"https://localhost:3000/images/icons/app-icon@1.5x.png\",\"png2x\":\"https://localhost:3000/images/icons/app-icon@2x.png\"}"
				},
				{
					"key": "actions",
					"value": "[{\"type\":\"newFile\",\"url\":\"https://localhost:3000/markdown/create\",\"availableOn\":{\"file\":{\"extensions\":[\".md\"]},\"web\":{}}},{\"type\":\"open\",\"url\":\"https://localhost:3000/markdown/edit\",\"availableOn\":{\"file\":{\"extensions\":[\".md\"]},\"web\":{}}},{\"type\":\"preview\",\"url\":\"https://localhost:3000/markdown/preview\",\"availableOn\":{\"file\":{\"extensions\":[\".md\"]},\"web\":{}}}]"
				}
			]
		}
	],
  "allowPublicClient": true,
  remainder omitted...
}

Sélectionnez « Enregistrer » dans la barre de menus supérieure

Utilisation de Microsoft Graph pour inscrire un gestionnaire de fichiers

Vous pouvez mettre à jour par programmation une inscription d’application AAD pour ajouter le manifeste du gestionnaire de fichiers. Cela nécessite deux applications existantes : l’application Gestionnaire de fichiers et une application disposant Directory.ReadWrite.All d’autorisations pour autoriser les mises à jour de l’inscription du gestionnaire de fichiers.

Vous devez acquérir un jeton du porteur pour accéder à Microsoft Graph. Pour en savoir plus sur les jetons, consultez la documentation sur les jetons AAD. Ce jeton doit inclure les Directory.ReadWrite.All autorisations mentionnées ci-dessus.
Notez l’ID d’objet de l’application qui représente l’inscription du gestionnaire de fichiers dans laquelle le manifeste sera injecté. Vous pouvez le trouver dans la page « Vue d’ensemble » de l’inscription de l’application et est différent de l’ID de l’application.
Maintenant, en utilisant le jeton de l’étape 1 et l’ID d’objet de l’étape 2, vous pouvez effectuer une requête PUT pour https://graph.microsoft.com/v1.0/applications/${objectId}/addIns inclure le manifeste dans le corps comme indiqué.

PUT https://graph.microsoft.com/v1.0/applications/${objectId}/addIns HTTP/1.1
Authorization: Bearer ${AAD Token}
Accept: application/json
Content-Type: application/json

{
  "value": [{
      {
        "id": "968A844F-7A47-430C-9163-07AE7C31D407",
        "type": "FileHandler",
        "properties": [
            { "key": "version", "value": "2" },
            { "key": "fileTypeDisplayName", "value": "Display name of the file format" },
            { "key": "fileTypeIcon", "value": "{\"svg\":\"https://example.org/icon.svg\",\"png1x\":\"https://example.org/icon@1x.png\",\"png1.5x\":\"https://example.org/icon@1.5x.png\",\"png2x\":\"https://example.org/icon@2x.png\"}" },
            { "key": "appIcon", "value": "{\"svg\":\"https://example.org/app-icon.svg\",\"png1x\":\"https://example.org/app-icon@1x.png\",\"png1.5x\":\"https://example.org/app-icon@1.5x.png\",\"png2x\":\"https://example.org/app-icon@2x.png\"}" },
            { "key": "actions", "value": "json string of additional actions"}
        ]
        }
  }]
}

Maintenant que le manifeste de votre gestionnaire de fichiers a été inscrit avec votre application dans AAD, vous pouvez procéder à la génération et au test de votre complément gestionnaire de fichiers.

Remarque

Vous pouvez voir un exemple complet d’acquisition d’un jeton, de création d’une application et d’inscription du complément gestionnaire de fichiers dans les outils de l’exemple Nodejs.

Importante

L’affichage des modifications apportées au manifeste du gestionnaire de fichiers peut prendre 24 à 48 heures. Voir Actualiser le cache du gestionnaire de fichiers pour découvrir comment forcer le vidage du cache à des fins de développement.

Share via

Procédure : Enregistrer un complément gestionnaire de fichiers manuellement.

Manifeste d’application et propriété addIns

Mise à jour du manifeste d’application dans AAD

Utilisation de Microsoft Graph pour inscrire un gestionnaire de fichiers

Ressources supplémentaires