Créer des Outlook à l’aide de SharePoint Framework
Introduit dans SharePoint Framework v1.10, vous pouvez implémenter un Outlook Web App avec le SharePoint Framework et utiliser SharePoint comme hôte pour votre solution.
L’utilisation SharePoint Framework en tant que plateforme pour vos Outlook d’application web inclut les avantages suivants :
- Le modèle de développement est similaire aux composants Web SharePoint Framework web
- Le même code peut fonctionner dans SharePoint, Microsoft Teams et Microsoft Office
- Votre complément est hébergé automatiquement pour le client sans que vous n’exigeiez la mise en service de services supplémentaires.
- Authentification simplifiée pour accéder à différents services dans Microsoft 365
- Vous pouvez bénéficier du même modèle de gestion des autorisations et des accès que dans SharePoint, avec un accès aisé aux API Microsoft Graph et à d’autres services
Notes
Cette fonctionnalité est actuellement partagée comme expérimentale. Cela signifie que l’étendue et la prise en charge de cette fonctionnalité sont limitées & ne sont pas recommandées pour les environnements de production. En outre, il n’y a pas de calendrier ni d’engagement sur l’avenir de cette fonctionnalité.
Attention
Cette fonctionnalité expérimentale est uniquement prise en charge dans Outlook Web Access pour le moment.
Processus de développement
Vous pouvez commencer à développer des Outlook à l’aide de la version SharePoint Framework version 1.10 ou ultérieure. Pour utiliser cette fonctionnalité dans la prévisualisation du développeur, vous devez inclure l’argument lors de l’exécution du --plusbeta générateur Yeoman :
yo @microsoft/sharepoint --plusbeta
Cela crée un fichier manifeste Office de la solution dans un nouveau dossier appelé officeAddin. Ce fichier est généré automatiquement avec les paramètres par défaut, ce qui permet à votre partie Web d’être utilisée dans Outlook Web App en tant qu’extension du volet De tâches.
Vous devrez déployer la solution sur un client à l’aide de l’option de déploiement étendue au client pour vous assurer que le composant est disponible dans le contexte de l’URL du composant tel que défini dans le fichier manifeste XML. Ce paramètre peut être ajusté dans le fichier package-solution.json en mettant à jour skipFeatureDeployment le fichier as true .
Notes
Pour plus d’informations sur le fichier manifeste, voir : Office de recherche : Office manifeste XML des modules complémentaires.
Utiliser le Office JavaScript SDK (Office.js) dans le code du site Web
Avant de pouvoir utiliser Office SDK JavaScript dans votre code, vous devez inclure les types corrects pour la solution. Vous pouvez installer les derniers types en ajoutant le package @ types/office-js à votre solution à l’aide de la commande suivante :
npm install @types/office-js --save-dev
Vous pouvez détecter si le partie Web Part s’exécute dans le contexte Office à l’aide du contexte de page comme indiqué sur la propriété suivante, qui fait référence au SDK JavaScript Office. Cette valeur de propriété dépend du contexte dans lequel le code est exécuté.
this.context.sdks.office
Par exemple, vous pouvez accéder à la boîte de réception de messagerie à l’aide de la propriété suivante :
this.context.sdks.office.context.mailbox
Notes
Pour plus d’informations sur Office fonctionnalités de l’API JavaScript, voir : Office: Documentationde référence sur les API.
Prise en charge de la configuration Office des modules
Office Les add-ins créés avec le SharePoint Framework prise en charge d’une option de configuration à une seule fois lors de l’affichage initial du module. Il s’agit d’une fonctionnalité facultative, qui peut être contrôlée à partir du fichier manifeste du add-in. L’option de configuration est contrôlée dans l’URL de la solution dans le fichier manifeste. Par défaut, l’option de configuration est activée et l’URL est la suivante :
https://{tenant}.sharepoint.com/_layouts/15/outlookhostedapp.aspx
?componentId=c76ba09e-4068-4233-b342-aedfc75a6578&isConfigureMode=true
Si votre add-in ne comprend aucune option de configuration initiale, vous pouvez supprimer le paramètre de requête isConfigureMode et mettre à jour l’URL. Dans l’exemple, cela signifie ajuster l’URL comme suit :
https://{tenant}.sharepoint.com/_layouts/15/outlookhostedapp.aspx
?componentId=c76ba09e-4068-4233-b342-aedfc75a6578
Notez que le paramètre de requête componentId est un GUID propre à la solution, qui doit être remplacé par la valeur de votre propre composant.
Important
L’option de configuration n’est disponible que lors de l’affichage initial du add-in. Il n’est pas pris en charge de reconfigurer le module après la configuration initiale. Il s’agit actuellement de la conception, car il n’existe aucune fonctionnalité de configuration similaire pour les Office des modules. S’il existe une demande pour cette fonctionnalité, n’hésitez pas à nous en faire savoir plus à l’aide de UserVoice.
Déploiement de votre add-in
Le déploiement est un processus en deux étapes pour les Outlook Web App :
- Déployer la solution dans SharePoint catalogue d’applications
- Utiliser le chargement latéral pour activer le Outlook Web App
Vous pouvez déployer votre solution sur Outlook Web App à l’aide de la technique de chargement de version secondaire en suivant les étapes suivantes :
Déplacez-vous vers Outlook client web à l’aide de votre navigateur.
Activez l’un des messages existants dans votre boîte de réception.
Select [...] and choose Get Add-ins:

Sélectionnez Mes modules dans le menu de gauche :

Sélectionnez Ajouter à partir d’un fichier... sous les add-ins personnalisés:

Télécharger fichier manifeste XML de votre solution de projet sous le dossier officeAddin.
Sélectionnez Installer sur le message d’avertissement pour que votre add-in soit disponible sur le client

Fermez la fenêtre du add-in en sélectionnant X dans le coin supérieur droit
Réactivez le menu contexté à partir de [...] _ and select _ SPFx template to activate the add-in in your inbox (name can be adjusted in the manifest file as needed)
Important
Ce processus de déploiement est pour la prévisualisation. Le processus change une fois que la prise en charge est étendue à d’Office applications web et de bureau à l’avenir.