-
Notifications
You must be signed in to change notification settings - Fork 837
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Co-authored-by: OfficeGlobal <[email protected]>
- Loading branch information
1 parent
65dc776
commit 5b01fa9
Showing
12 changed files
with
1,560 additions
and
0 deletions.
There are no files selected for viewing
120 changes: 120 additions & 0 deletions
120
Samples/auth/Office-Add-in-Microsoft-Graph-ASPNET/README-Localized/README-es-es.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,120 @@ | ||
--- | ||
page_type: sample | ||
products: | ||
- office-excel | ||
- office-365 | ||
languages: | ||
- javascript | ||
extensions: | ||
contentType: samples | ||
technologies: | ||
- Add-ins | ||
createdDate: 5/1/2019 1:25:00 PM | ||
--- | ||
# Obtener datos de OneDrive usando Microsoft Graph y MSAL.NET en un complemento de Office | ||
|
||
Aprenda a crear un complemento de Microsoft Office que se conecta a Microsoft Graph, encuentra los tres primeros libros de trabajo almacenados en OneDrive para empresas, obtiene sus nombres de archivo e inserta los nombres en un documento de Office utilizando Office.js. | ||
|
||
## Características | ||
La integración de los datos de los proveedores de servicios en línea aumenta el valor y la adopción de sus complementos. En este ejemplo de código se muestra cómo conectar el complemento con Microsoft Graph. Use este ejemplo de código para: | ||
|
||
* Conéctese a Microsoft Graph desde un complemento de Office. | ||
* Utilice la biblioteca de MSAL.NET para implementar el marco de autorización de OAuth 2.0 en un complemento. | ||
* Utilice las APIs OneDrive REST de Microsoft Graph. | ||
* Mostrar un diálogo usando el espacio de nombres de la interfaz de usuario de Office. | ||
* Construya un complemento usando ASP.NET MVC, MSAL 3.x.x para .NET, y Office.js. | ||
* Usar los comandos de un complemento en un complemento | ||
|
||
## Se aplica a | ||
|
||
- Excel en Windows (compra única y suscripción) | ||
- PowerPoint en Windows (compra única y suscripción) | ||
- Word en Windows (compra única y suscripción) | ||
|
||
## Requisitos previos | ||
|
||
Para ejecutar este ejemplo de código, se requiere lo siguiente. | ||
|
||
* Visual Studio 2019 o posterior. | ||
|
||
* SQL Server Express (ya no se instala automáticamente con versiones recientes de Visual Studio). | ||
|
||
* Una cuenta de Office 365 que puede obtener al unirse al [programa de desarrollo de Office 365](https://aka.ms/devprogramsignup) que incluye una suscripción gratuita de 1 año a Office 365. | ||
|
||
* Al menos tres cuadernos de Excel almacenados en OneDrive para empresas en su suscripción a Office 365. | ||
|
||
* Office en Windows, versión 16.0.6769.2001 o superior. | ||
|
||
* [Herramientas para desarrolladores de Office](https://www.visualstudio.com/en-us/features/office-tools-vs.aspx) | ||
|
||
* Un inquilino de Microsoft Azure. Este complemento requiere Azure Active Directiory (AD). Azure (AD) le ofrece servicios de identidad que las aplicaciones usan para autenticación y autorización. Las suscripciones de prueba se pueden adquirir aquí: [Microsoft Azure](https://account.windowsazure.com/SignUp). | ||
|
||
## Solución | ||
|
||
Solución | Autor(es) | ||
---------|----------- | ||
complementos de Office en Microsoft Graph ASP.NET | Microsoft | ||
|
||
## Historial de versiones | ||
|
||
Versión | Fecha | Comentarios | ||
---------| -----| -------- | ||
1.0 |8 de julio de 2019| Lanzamiento inicial | ||
|
||
## Renuncia | ||
|
||
**ESTE CÓDIGO SE PROPORCIONA*TAL CUAL* SIN GARANTÍA DE NINGÚN TIPO, YA SEA EXPRESA O IMPLÍCITA, INCLUYENDO CUALQUIER GARANTÍA IMPLÍCITA DE IDONEIDAD PARA UN PROPÓSITO PARTICULAR, COMERCIABILIDAD O NO INFRACCIÓN. ** | ||
|
||
---------- | ||
|
||
## Compilar y ejecutar la solución | ||
|
||
### Configurar la solución | ||
|
||
1. En **Visual Studio**, elija el proyecto**Office-Add-in-Microsoft-Graph-ASPNETWeb**. En **Propiedades**, asegúrese de que el**SSL esté activado** y sea **Verdadero**. Compruebe que la **URL de SSL** use el mismo nombre de dominio y número de puerto que se indica en el paso 3 que se muestra a continuación. | ||
|
||
2. Registre la aplicación mediante el [Portal de administración de Azure](https://manage.windowsazure.com). **Ingrese con la identidad de un administrador de su Oficina 365 para asegurarse de que está trabajando en un Directorio Activo Azure que está asociado con esa tenencia.** Para saber cómo registrar aplicaciones, consulte [Registrar una aplicación en el Microsoft Identity Platform](https://docs.microsoft.com/graph/auth-register-app-v2). Use la siguiente configuración: | ||
|
||
- URI REDIRCT: https://localhost:44301/AzureADAuth/Authorize | ||
- TIPOS DE CUENTA ADMITIDAS: «Solo las cuentas de este directorio organizativo» | ||
- CONCESIÓN IMPLÍCITA: No habilitar ninguna opción de subvención implícita | ||
- PERMISOS DE LA API (Permisos delegados, no permisos de aplicación): **Files.Read.All** y **User.Read** | ||
|
||
> Nota: Después de registrar la aplicación, copie la **Id. de la aplicación (cliente)** y el**Id. del directorio (inquilino)** en la hoja de **información general** del registro de la aplicación en el Portal de administración de Azure. Cuando cree el secreto de cliente en la hoja de **Certificados y Secretos**, cópielo. | ||
3. En web.config, use los valores que copió en el paso anterior. Establezca **AAD:ClientID** en su identificación de cliente, **AAD:ClientSecret** en el secreto de cliente, y finalmente **"AAD:O365TenantID"** en la identificación de inquilino | ||
|
||
### Ejecute la solución | ||
|
||
1. Abra el archivo de la solución de Visual Studio. | ||
2. Haga clic con el botón derecho en solución en**Office-Add-in-Microsoft-Graph-ASPNET** en el **Explorador de soluciones ** (no en los nodos del proyecto) y luego, seleccione **establecer proyectos de inicio**. Seleccione el botón de radio **Proyectos de inicio múltiples**. Asegúrate de que el proyecto que termina con "Web" aparece en primer lugar. | ||
3. En el menú **compilación**, seleccione **Limpiar solución**. Cuando termine, abra de nuevo el menú **Compilación**. y seleccione **Solución de compilación**. | ||
4. En el **Explorador de soluciones**, seleccione el nodo de proyecto **Office-Add-in-ASPNET-SSO**nodo del proyecto (no el nodo superior de la solución y no el proyecto cuyo nombre termina en "Web"). | ||
5. En el panel** Propiedades**, abra la lista desplegable **niciar documento** y elija una de las tres opciones (Excel, Word o PowerPoint). | ||
|
||
 Word, Excel o PowerPoint](images/SelectHost.JPG) | ||
|
||
6. Pulse F5. | ||
7. En la aplicación de Office, elija **insertar** > **Abrir complemento**en los**archivos de OneDrive** para abrir el complemento del panel de tareas. | ||
8. Las páginas y los botones del complemento se explican por sí mismos. | ||
|
||
## Problemas conocidos | ||
|
||
* El control del hilandero de la tela aparece sólo brevemente o no aparece en absoluto. | ||
|
||
## Preguntas y comentarios | ||
|
||
Nos encantaría recibir sus comentarios sobre este ejemplo. Puede enviarnos comentarios a través de la sección *Problemas* de este repositorio. | ||
Las preguntas sobre el desarrollo de complementos de oficina deben enviarse a [Stack Overflow](http://stackoverflow.com). Asegúrate de que tus preguntas estén etiquetadas con [office-js] y [MicrosoftGraph]. | ||
|
||
## Recursos adicionales | ||
|
||
* [Documentación de Microsoft Graph](https://docs.microsoft.com/graph/) | ||
* [Documentación de complementos de Office](https://docs.microsoft.com/office/dev/add-ins/overview/office-add-ins) | ||
|
||
## Derechos de autor | ||
Derechos de autor (c) 2019 Microsoft Corporation. Todos los derechos reservados. | ||
|
||
Este proyecto ha adoptado el [Código de conducta de código abierto de Microsoft](https://opensource.microsoft.com/codeofconduct/). Para obtener más información, consulte[Preguntas frecuentes sobre el código de conducta](https://opensource.microsoft.com/codeofconduct/faq/) o póngase en contacto con [[email protected]](mailto:[email protected]) si tiene otras preguntas o comentarios. | ||
|
||
<img src="https://telemetry.sharepointpnp.com/pnp-officeaddins/auth/Office-Add-in-Microsoft-Graph-ASPNET" /> |
120 changes: 120 additions & 0 deletions
120
Samples/auth/Office-Add-in-Microsoft-Graph-ASPNET/README-Localized/README-fr-fr.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,120 @@ | ||
--- | ||
page_type: sample | ||
products: | ||
- office-excel | ||
- office-365 | ||
languages: | ||
- javascript | ||
extensions: | ||
contentType: samples | ||
technologies: | ||
- Add-ins | ||
createdDate: 5/1/2019 1:25:00 PM | ||
--- | ||
# Obtenir des données OneDrive à l’aide de Microsoft Graph et MSAL.NET dans un complément Office | ||
|
||
Découvrez comment créer un complément Microsoft Office qui se connecte à Microsoft Graph, qui trouve les trois premiers classeurs stockés dans OneDrive Entreprise, qui récupère leurs noms de fichiers et les insère dans un document Office à l’aide de Office.js. | ||
|
||
## Fonctionnalités | ||
Le fait d’intégrer des données à partir de fournisseurs de services en ligne augmente la valeur et l’adoption de vos compléments. Cet exemple de code vous montre comment connecter votre complément à Microsoft Graph. Utilisez cet exemple de code pour : | ||
|
||
* Se connecter à Microsoft Graph à partir d’un complément Office. | ||
* Utiliser la bibliothèque MSAL.NET pour implémenter l’infrastructure d’autorisation OAuth 2.0 dans un complément. | ||
* Utiliser les API REST OneDrive à partir de Microsoft Graph. | ||
* Afficher une boîte de dialogue à l’aide de l’espace de noms de l’interface utilisateur Office. | ||
* Créer un complément à l’aide d’ASP.NET MVC, de MSAL 3.x.x pour .NET et d’Office.js. | ||
* Utiliser les commandes de complément dans un complément. | ||
|
||
## S’applique à | ||
|
||
- Excel sur Windows (achat définitif et abonnement) | ||
- PowerPoint sur Windows (achat définitif et abonnement) | ||
- Word sur Windows (achat définitif et abonnement) | ||
|
||
## Conditions préalables | ||
|
||
Pour exécuter cet exemple de code, les éléments suivants sont requis. | ||
|
||
* Visual Studio 2019 ou version ultérieure. | ||
|
||
* SQL Server Express (N’est plus installé automatiquement avec les versions récentes de Visual Studio.) | ||
|
||
* Compte Office 365 que vous pouvez obtenir en rejoignant le [programme pour les développeurs Office 365](https://aka.ms/devprogramsignup) incluant un abonnement gratuit de 1 an à Office 365. | ||
|
||
* Au moins trois classeurs Excel stockés sur OneDrive Entreprise dans votre abonnement Office 365. | ||
|
||
* Office sur Windows, version 16.0.6769.2001 ou ultérieure. | ||
|
||
* [Outils de développement Office](https://www.visualstudio.com/en-us/features/office-tools-vs.aspx) | ||
|
||
* Un locataire Microsoft Azure. Ce complément requiert Azure Active Directiory (AD). Azure AD fournit des services d’identité que les applications utilisent à des fins d’authentification et d’autorisation. Un abonnement d’évaluation peut être demandé ici : [Microsoft Azure](https://account.windowsazure.com/SignUp). | ||
|
||
## Solution | ||
|
||
Solution | Auteur(s) | ||
---------|---------- | ||
complément Office Microsoft Graph ASP.NET | Microsoft | ||
|
||
## Historique des versions | ||
|
||
Version | Date | Commentaires | ||
---------| -----| -------- | ||
1.0 | 8 juillet 2019 | Publication initiale | ||
|
||
## Clause d’exclusion | ||
|
||
**CE CODE EST FOURNI *EN L’ÉTAT*, SANS GARANTIE D'AUCUNE SORTE, EXPRESSE OU IMPLICITE, Y COMPRIS TOUTE GARANTIE IMPLICITE D'ADAPTATION À UN USAGE PARTICULIER, DE QUALITÉ MARCHANDE ET DE NON-CONTREFAÇON.** | ||
|
||
---------- | ||
|
||
## Générez et exécutez la solution | ||
|
||
### Configurer la solution | ||
|
||
1. Dans **Visual Studio**, choisissez le projet **Office-Add-in-Microsoft-Graph-ASPNETWeb**. Dans **Propriétés**, assurez-vous que **SSL activé** est défini sur **True**. Vérifiez que l’**URL SSL** utilise le même nom de domaine et le même numéro de port que ceux répertoriés à l’étape suivante. | ||
|
||
2. Inscrivez votre application à l’aide du [portail de gestion Azure](https://manage.windowsazure.com). **Connectez-vous à l’aide de l’identité d’un administrateur de votre location Office 365 afin de vous assurer que vous travaillez dans un répertoire Azure Active Directory associé à cette location.** Pour savoir comment inscrire votre application, consulter [Inscrire une application sur la Plateforme d’identités Microsoft](https://docs.microsoft.com/graph/auth-register-app-v2). Utilisez les paramètres suivants : | ||
|
||
- URI DE REDIRECTION : https://localhost:44301/AzureADAuth/Authorize | ||
- TYPE DE COMPTES PRIS EN CHARGE : « Comptes dans cet annuaire organisationnel uniquement » | ||
- OCTROI IMPLICITE : Ne pas activer les options d’octroi implicite | ||
- AUTORISATIONS API (Autorisations déléguées, sans autorisations de l’application) : **Files.Read.All** et **User.Read** | ||
|
||
> Remarque : Une fois que vous avez enregistré votre application, copiez l’**ID d’application (client)** et l’**ID d’annuaire (locataire)** sur le panneau **Vue d’ensemble** de l’inscription de l’application dans le portail de gestion Azure. Lorsque vous créez la clé secrète cliente sur le panneau **Certificats et clés secrètes**, copiez-la également. | ||
3. Dans web.config, utilisez les valeurs que vous avez copiées à l’étape précédente. Définissez **AAD:ClientID** sur votre ID client, définissez **AAD:ClientSecret** sur votre clé secrète client et définissez **"AAD:O365TenantID"** sur votre ID locataire. | ||
|
||
### Exécutez la solution | ||
|
||
1. Ouvrez le fichier de solution Visual Studio. | ||
2. Cliquez avec le bouton droit sur solution **Office-Add-in-Microsoft-Graph-ASPNET** dans l’**Explorateur de solutions** (pas les nœuds de projet), puis sélectionnez **définir les projets de démarrage**. Sélectionnez la case d’option **Plusieurs projets de démarrage**. Assurez-vous que le projet se termine par « Web » apparaît en premier. | ||
3. Dans le menu **Générer**, sélectionnez **Nettoyer la solution**. Une fois l’opération terminée, ouvrez de nouveau le menu **Build**, puis sélectionnez **Générer la solution**. | ||
4. Dans l’**Explorateur de solutions**, sélectionnez le nœud de projet **Office-Add-in-Microsoft-Graph-ASPNET** (et non le projet dont le nom se termine par « WebAPI »). | ||
5. Dans le volet **Propriétés**, ouvrez la liste déroulante **Document de départ**, puis choisissez l’une des trois options (Excel, Word ou PowerPoint). | ||
|
||
 Excel ou PowerPoint ou Word](images/SelectHost.JPG) | ||
|
||
6. Appuyez sur la touche F5. | ||
7. Dans l’application Office, sélectionnez **Insérer** > **Ouvrir un complément** dans le groupe **Fichiers OneDrive** pour ouvrir le complément du volet Office. | ||
8. Les pages et les boutons du complément sont explicites. | ||
|
||
## Problèmes connus | ||
|
||
* Le contrôle bouton fléché Fabric s’affiche brièvement, voire pas du tout. | ||
|
||
## Questions et commentaires | ||
|
||
Nous serions ravis de connaître votre opinion sur cet exemple. Vous pouvez nous envoyer vos commentaires via la section *Problèmes* de ce référentiel. | ||
Si vous avez des questions sur le développement des compléments Office, envoyez-les sur [Stack Overflow](http://stackoverflow.com). Assurez-vous que vos questions comportent les balises [office-js] et [MicrosoftGraph]. | ||
|
||
## Ressources supplémentaires | ||
|
||
* [Documentation Microsoft Graph](https://docs.microsoft.com/graph/) | ||
* [Documentation pour compléments Office](https://docs.microsoft.com/office/dev/add-ins/overview/office-add-ins) | ||
|
||
## Copyright | ||
Copyright (c) 2019 Microsoft Corporation. Tous droits réservés. | ||
|
||
Ce projet a adopté le [code de conduite Open Source de Microsoft](https://opensource.microsoft.com/codeofconduct/). Pour en savoir plus, reportez-vous à la [FAQ relative au code de conduite](https://opensource.microsoft.com/codeofconduct/faq/) ou contactez [[email protected]](mailto:[email protected]) pour toute question ou tout commentaire. | ||
|
||
<img src="https://telemetry.sharepointpnp.com/pnp-officeaddins/auth/Office-Add-in-Microsoft-Graph-ASPNET" /> |
Oops, something went wrong.