Skip to content

Commit

Permalink
HB of localized readme files (#76)
Browse files Browse the repository at this point in the history
Co-authored-by: OfficeGlobal <OfficeGlobal@microsoft.com>
  • Loading branch information
OfficeGlobal and OfficeGlobal committed Oct 2, 2020
1 parent 65dc776 commit 5b01fa9
Show file tree
Hide file tree
Showing 12 changed files with 1,560 additions and 0 deletions.
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).

![ Elija la aplicación host de Office que desee:](images/SelectHost.JPG) 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 [opencode@microsoft.com](mailto:opencode@microsoft.com) si tiene otras preguntas o comentarios.

<img src="https://telemetry.sharepointpnp.com/pnp-officeaddins/auth/Office-Add-in-Microsoft-Graph-ASPNET" />
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).

![Choisissez l’application hôte Office souhaitée :](images/SelectHost.JPG) 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 [opencode@microsoft.com](mailto:opencode@microsoft.com) pour toute question ou tout commentaire.

<img src="https://telemetry.sharepointpnp.com/pnp-officeaddins/auth/Office-Add-in-Microsoft-Graph-ASPNET" />

0 comments on commit 5b01fa9

Please sign in to comment.