Skip to content

Commit 5b01fa9

Browse files
OfficeGlobalOfficeGlobal
OfficeGlobal
and
OfficeGlobal
authored
HB of localized readme files (#76)
Co-authored-by: OfficeGlobal <[email protected]>
1 parent 65dc776 commit 5b01fa9

File tree

12 files changed

+1560
-0
lines changed

12 files changed

+1560
-0
lines changed

‎Samples/auth/Office-Add-in-Microsoft-Graph-ASPNET/README-Localized/README-es-es.md

Lines changed: 120 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,120 @@
1+
---
2+
page_type: sample
3+
products:
4+
- office-excel
5+
- office-365
6+
languages:
7+
- javascript
8+
extensions:
9+
contentType: samples
10+
technologies:
11+
- Add-ins
12+
createdDate: 5/1/2019 1:25:00 PM
13+
---
14+
# Obtener datos de OneDrive usando Microsoft Graph y MSAL.NET en un complemento de Office
15+
16+
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.
17+
18+
## Características
19+
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:
20+
21+
* Conéctese a Microsoft Graph desde un complemento de Office.
22+
* Utilice la biblioteca de MSAL.NET para implementar el marco de autorización de OAuth 2.0 en un complemento.
23+
* Utilice las APIs OneDrive REST de Microsoft Graph.
24+
* Mostrar un diálogo usando el espacio de nombres de la interfaz de usuario de Office.
25+
* Construya un complemento usando ASP.NET MVC, MSAL 3.x.x para .NET, y Office.js.
26+
* Usar los comandos de un complemento en un complemento
27+
28+
## Se aplica a
29+
30+
- Excel en Windows (compra única y suscripción)
31+
- PowerPoint en Windows (compra única y suscripción)
32+
- Word en Windows (compra única y suscripción)
33+
34+
## Requisitos previos
35+
36+
Para ejecutar este ejemplo de código, se requiere lo siguiente.
37+
38+
* Visual Studio 2019 o posterior.
39+
40+
* SQL Server Express (ya no se instala automáticamente con versiones recientes de Visual Studio).
41+
42+
* 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.
43+
44+
* Al menos tres cuadernos de Excel almacenados en OneDrive para empresas en su suscripción a Office 365.
45+
46+
* Office en Windows, versión 16.0.6769.2001 o superior.
47+
48+
* [Herramientas para desarrolladores de Office](https://www.visualstudio.com/en-us/features/office-tools-vs.aspx)
49+
50+
* 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).
51+
52+
## Solución
53+
54+
Solución | Autor(es)
55+
---------|-----------
56+
complementos de Office en Microsoft Graph ASP.NET | Microsoft
57+
58+
## Historial de versiones
59+
60+
Versión | Fecha | Comentarios
61+
---------| -----| --------
62+
1.0 |8 de julio de 2019| Lanzamiento inicial
63+
64+
## Renuncia
65+
66+
**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. **
67+
68+
----------
69+
70+
## Compilar y ejecutar la solución
71+
72+
### Configurar la solución
73+
74+
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.
75+
76+
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:
77+
78+
- URI REDIRCT: https://localhost:44301/AzureADAuth/Authorize
79+
- TIPOS DE CUENTA ADMITIDAS: «Solo las cuentas de este directorio organizativo»
80+
- CONCESIÓN IMPLÍCITA: No habilitar ninguna opción de subvención implícita
81+
- PERMISOS DE LA API (Permisos delegados, no permisos de aplicación): **Files.Read.All** y **User.Read**
82+
83+
> 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.
84+
85+
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
86+
87+
### Ejecute la solución
88+
89+
1. Abra el archivo de la solución de Visual Studio.
90+
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.
91+
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**.
92+
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").
93+
5. En el panel** Propiedades**, abra la lista desplegable **niciar documento** y elija una de las tres opciones (Excel, Word o PowerPoint).
94+
95+
![ Elija la aplicación host de Office que desee:](images/SelectHost.JPG) Word, Excel o PowerPoint](images/SelectHost.JPG)
96+
97+
6. Pulse F5.
98+
7. En la aplicación de Office, elija **insertar** > **Abrir complemento**en los**archivos de OneDrive** para abrir el complemento del panel de tareas.
99+
8. Las páginas y los botones del complemento se explican por sí mismos.
100+
101+
## Problemas conocidos
102+
103+
* El control del hilandero de la tela aparece sólo brevemente o no aparece en absoluto.
104+
105+
## Preguntas y comentarios
106+
107+
Nos encantaría recibir sus comentarios sobre este ejemplo. Puede enviarnos comentarios a través de la sección *Problemas* de este repositorio.
108+
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].
109+
110+
## Recursos adicionales
111+
112+
* [Documentación de Microsoft Graph](https://docs.microsoft.com/graph/)
113+
* [Documentación de complementos de Office](https://docs.microsoft.com/office/dev/add-ins/overview/office-add-ins)
114+
115+
## Derechos de autor
116+
Derechos de autor (c) 2019 Microsoft Corporation. Todos los derechos reservados.
117+
118+
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.
119+
120+
<img src="https://telemetry.sharepointpnp.com/pnp-officeaddins/auth/Office-Add-in-Microsoft-Graph-ASPNET" />

‎Samples/auth/Office-Add-in-Microsoft-Graph-ASPNET/README-Localized/README-fr-fr.md

Lines changed: 120 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,120 @@
1+
---
2+
page_type: sample
3+
products:
4+
- office-excel
5+
- office-365
6+
languages:
7+
- javascript
8+
extensions:
9+
contentType: samples
10+
technologies:
11+
- Add-ins
12+
createdDate: 5/1/2019 1:25:00 PM
13+
---
14+
# Obtenir des données OneDrive à l’aide de Microsoft Graph et MSAL.NET dans un complément Office
15+
16+
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.
17+
18+
## Fonctionnalités
19+
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 :
20+
21+
* Se connecter à Microsoft Graph à partir d’un complément Office.
22+
* Utiliser la bibliothèque MSAL.NET pour implémenter l’infrastructure d’autorisation OAuth 2.0 dans un complément.
23+
* Utiliser les API REST OneDrive à partir de Microsoft Graph.
24+
* Afficher une boîte de dialogue à l’aide de l’espace de noms de l’interface utilisateur Office.
25+
* Créer un complément à l’aide d’ASP.NET MVC, de MSAL 3.x.x pour .NET et d’Office.js.
26+
* Utiliser les commandes de complément dans un complément.
27+
28+
## S’applique à
29+
30+
- Excel sur Windows (achat définitif et abonnement)
31+
- PowerPoint sur Windows (achat définitif et abonnement)
32+
- Word sur Windows (achat définitif et abonnement)
33+
34+
## Conditions préalables
35+
36+
Pour exécuter cet exemple de code, les éléments suivants sont requis.
37+
38+
* Visual Studio 2019 ou version ultérieure.
39+
40+
* SQL Server Express (N’est plus installé automatiquement avec les versions récentes de Visual Studio.)
41+
42+
* 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.
43+
44+
* Au moins trois classeurs Excel stockés sur OneDrive Entreprise dans votre abonnement Office 365.
45+
46+
* Office sur Windows, version 16.0.6769.2001 ou ultérieure.
47+
48+
* [Outils de développement Office](https://www.visualstudio.com/en-us/features/office-tools-vs.aspx)
49+
50+
* 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).
51+
52+
## Solution
53+
54+
Solution | Auteur(s)
55+
---------|----------
56+
complément Office Microsoft Graph ASP.NET | Microsoft
57+
58+
## Historique des versions
59+
60+
Version | Date | Commentaires
61+
---------| -----| --------
62+
1.0 | 8 juillet 2019 | Publication initiale
63+
64+
## Clause d’exclusion
65+
66+
**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.**
67+
68+
----------
69+
70+
## Générez et exécutez la solution
71+
72+
### Configurer la solution
73+
74+
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.
75+
76+
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 :
77+
78+
- URI DE REDIRECTION : https://localhost:44301/AzureADAuth/Authorize
79+
- TYPE DE COMPTES PRIS EN CHARGE : « Comptes dans cet annuaire organisationnel uniquement »
80+
- OCTROI IMPLICITE : Ne pas activer les options d’octroi implicite
81+
- AUTORISATIONS API (Autorisations déléguées, sans autorisations de l’application) : **Files.Read.All** et **User.Read**
82+
83+
> 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.
84+
85+
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.
86+
87+
### Exécutez la solution
88+
89+
1. Ouvrez le fichier de solution Visual Studio.
90+
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.
91+
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**.
92+
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 »).
93+
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).
94+
95+
![Choisissez l’application hôte Office souhaitée :](images/SelectHost.JPG) Excel ou PowerPoint ou Word](images/SelectHost.JPG)
96+
97+
6. Appuyez sur la touche F5.
98+
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.
99+
8. Les pages et les boutons du complément sont explicites.
100+
101+
## Problèmes connus
102+
103+
* Le contrôle bouton fléché Fabric s’affiche brièvement, voire pas du tout.
104+
105+
## Questions et commentaires
106+
107+
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.
108+
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].
109+
110+
## Ressources supplémentaires
111+
112+
* [Documentation Microsoft Graph](https://docs.microsoft.com/graph/)
113+
* [Documentation pour compléments Office](https://docs.microsoft.com/office/dev/add-ins/overview/office-add-ins)
114+
115+
## Copyright
116+
Copyright (c) 2019 Microsoft Corporation. Tous droits réservés.
117+
118+
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.
119+
120+
<img src="https://telemetry.sharepointpnp.com/pnp-officeaddins/auth/Office-Add-in-Microsoft-Graph-ASPNET" />

0 commit comments

Comments
 (0)