Skip to content

Commit dad4091

Browse files
jasonjohjasonjoh
authored
Merge pull request #22 from OfficeGlobal/master
HB of localized readme files
2 parents 1c513f7 + c7a8c99 commit dad4091

File tree

6 files changed

+750
-0
lines changed

6 files changed

+750
-0
lines changed

‎README-localized/README-es-es.md‎

Lines changed: 125 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,125 @@
1+
---
2+
page_type: sample
3+
products:
4+
- ms-graph
5+
languages:
6+
- csharp
7+
extensions:
8+
contentType: samples
9+
technologies:
10+
- Microsoft Graph
11+
createdDate: 5/25/2017 5:03:53 PM
12+
---
13+
# ConsoleApp-MicrosoftGraphAPI-DeltaQuery-DotNet
14+
15+
Esta aplicación de consola demuestra cómo realizar llamadas de Consulta Delta a la Graph API, permitiendo que las aplicaciones soliciten sólo datos modificados a los inquilinos de Microsoft Graph.
16+
17+
El ejemplo utiliza demostraciones de cómo se pueden hacer llamadas de Graph con el SDK de Graph y cómo se pueden manejar las respuestas.
18+
19+
El ejemplo específico usado en este ejemplo implica la supervisión de los cambios (suma y eliminación) de MailFolders en la cuenta de correo electrónico de un usuario.
20+
21+
## Como ejecutar este ejemplo
22+
23+
Para ejecutar este ejemplo necesitará:
24+
- Visual Studio 2017
25+
- Una conexión a Internet
26+
- Un inquilino del Azure Active Directory (Azure AD). Para más información sobre cómo conseguir un inquilino de Azure AD, por favor consulte [cómo conseguir un inquilino de Azure AD](https://azure.microsoft.com/en-us/documentation/articles/active-directory-howto-tenant/)
27+
28+
### Paso 1: Clone o descargue este repositorio
29+
30+
Desde la línea de comandos o shell:
31+
32+
`clonación de git https://github.com/microsoftgraph/ConsoleApp-DeltaQuery-DotNet`
33+
34+
### Paso 2: Registre la solicitud de muestra con su inquilino del Azure Active Directory
35+
36+
Hay un proyecto en este ejemplo. Para registrarlo, puede:
37+
38+
- o bien siga los pasos [paso 2: Registre la muestra con su inquilino del Azure Active Directory ](#step-2-register-the-sample-with-your-azure-active-directory-tenant)y[ paso 3: Configurar el ejemplo para usar el inquilino de Azure AD](#choose-the-azure-ad-tenant-where-you-want-to-create-your-applications)
39+
- o use los scripts de PowerShell que:
40+
- **automáticamente** crea las aplicaciones de Azure AD y los objetos relacionados (contraseñas, permisos, dependencias) para ti
41+
- modifica los archivos de configuración de los proyectos de Visual Studio.
42+
43+
Si desea usar esta automatización:
44+
45+
1. En Windows ejecute PowerShell y navegue hasta la raíz del directorio clonado
46+
1. En PowerShell, ejecute:
47+
48+
```PowerShell
49+
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process -Force
50+
```
51+
52+
1. Ejecute el script para crear su aplicación Azure AD y configure el código de la aplicación de muestra de acuerdo con ello.
53+
54+
```PowerShell
55+
.\AppCreationScripts\Configure.ps1
56+
```
57+
58+
> Otras formas de ejecutar los guiones se describen en [scripts de creación de aplicaciones ](./AppCreationScripts/AppCreationScripts.md)
59+
60+
1. Abra la solución de Visual Studio y haga clic en inicio.
61+
62+
Si no quieres usar esta automatización, sigue los siguientes pasos a continuación
63+
64+
#### Elija el inquilino de Azure AD donde quiere crear sus aplicaciones
65+
66+
Como primer paso, tendrá que:
67+
68+
1. Iniciar sesión en el[ Azure Portal](https://portal.azure.com)usando una cuenta de trabajo o de escuela, o una cuenta personal de Microsoft.
69+
1. Si su cuenta le da acceso a más de un inquilino, seleccione su cuenta en la esquina superior derecha y establezca su sesión de portal con el inquilino Azure AD deseado (usando**cambiar directorio**).
70+
1. En el panel de navegación de la izquierda, seleccione el servicio de**Azure Active Directory**, y luego seleccione **registros de aplicaciones (vista previa)**.
71+
72+
#### Registrar la aplicación cliente (ConsoleApp-DeltaQuery-DotNet)
73+
74+
1. En la página **Registros de aplicaciones (versión preliminar)**, seleccione **Registrar una aplicación**.
75+
1. Cuando aparezca la **página registrar una aplicación**, escriba la información de registro de su aplicación:
76+
- En la sección **Nombre**, introducir un nombre de aplicación significativo que se mostrará a los usuarios de la aplicación, por ejemplo`ConsoleApp-DeltaQuery-DotNet`.
77+
- En la sección **tipos de cuentas admitidas**, seleccione **cuentas en cualquier directorio organizacional y cuentas personales de Microsoft (por ejemplo, Skype, Xbox, Outlook.com)**.
78+
- Seleccione **registrar** para crear la aplicación.
79+
1. En la página **Información general** de la aplicación, busque el valor **Id. de la aplicación (cliente)** y guárdelo para más tarde. Lo necesitarás para configurar el archivo de configuración de Visual Studio para este proyecto.
80+
1. En la lista de páginas de la aplicación, seleccione **autenticación**.
81+
- En los *URI de redirección sugeridos para clientes públicos (móvil, escritorio)*, marque el segundo cuadro para que la aplicación pueda funcionar con las bibliotecas de MSAL utilizadas en la aplicación. (El cuadro debe contener la opción*urn:ietf:wg:oauth:2.0:oob*).
82+
1. En la lista de páginas de la aplicación, seleccione **Permisos de API**.
83+
- Haga clic en el botón **Agregar un permiso**.
84+
- Asegúrese de que la pestaña **API de Microsoft** está seleccionada.
85+
- En la sección *API de Microsoft más usadas*, haga clic en **Microsoft Graph**.
86+
- En la sección **Permisos delegados**, asegúrese de que se comprueben los permisos correctos: **Mail.Read**. Si es necesario, use el cuadro de búsqueda.
87+
- Seleccione el botón **Agregar permisos**.
88+
89+
### Paso 3: Configure el ejemplo para usar el inquilino de Azure AD
90+
91+
En los pasos siguientes, "ClientID" es lo mismo que "Application ID" o "AppId".
92+
93+
Abra la solución en Visual Studio para configurar los proyectos
94+
95+
#### Configure el proyecto del cliente
96+
97+
1. En la carpeta *ConsoleApplication*, renombre el archivo `appsettings.json.example` a `appsettings.json`
98+
1. Abra y edite el archivo `appsettings.json` para hacer el siguiente cambio
99+
1. Encuentre la línea donde se establece`ClientId` como `YOUR_CLIENT_ID_HERE` y reemplace el valor existente con el ID de la aplicación (clientId) de la aplicación `ConsoleApp-DeltaQuery-DotNet` copiada del Azure portal.
100+
101+
Limpie la solución, reconstruya la solución e inicie en el depurador.
102+
103+
## Colaboradores
104+
105+
Si quiere hacer su aportación a este ejemplo, vea [CONTRIBUTING.MD](/CONTRIBUTING.md).
106+
107+
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, vea [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.
108+
109+
## Preguntas y comentarios
110+
111+
Nos encantaría recibir sus comentarios sobre Webhooks de Microsoft Graph con el SDK de WebJobs. Puede enviarnos sus preguntas y sugerencias a través de la sección [Problemas](https://github.com/microsoftgraph/ConsoleApp-DeltaQuery-DotNet/issues) de este repositorio.
112+
113+
Las preguntas sobre Microsoft Graph en general deben publicarse en [desbordamiento de pila](https://stackoverflow.com/questions/tagged/MicrosoftGraph). Asegúrese de que sus preguntas o comentarios estén etiquetados con *\[MicrosoftGraph]*.
114+
115+
Si quiere sugerir alguna función, publique su idea en nuestra página de [User Voice](https://officespdev.uservoice.com/) y vote por sus sugerencias.
116+
117+
## Recursos adicionales
118+
119+
- [Ejemplo AAD DQ](https://github.com/Azure-Samples/active-directory-dotnet-graphapi-diffquery)
120+
- [Trabajando con Delta Query en Microsoft Graph ](https://developer.microsoft.com/en-us/graph/docs/concepts/delta_query_overview)
121+
- [Sitio para desarrolladores de Microsoft Graph](https://developer.microsoft.com/en-us/graph/)
122+
- [Llamar a Microsoft Graph desde una aplicación de ASP.NET MVC](https://developer.microsoft.com/en-us/graph/docs/platform/aspnetmvc)
123+
- [MSAL.NET](https://aka.ms/msal-net)
124+
125+
Copyright (c) 2019 Microsoft Corporation. Todos los derechos reservados.

‎README-localized/README-fr-fr.md‎

Lines changed: 125 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,125 @@
1+
---
2+
page_type: sample
3+
products:
4+
- ms-graph
5+
languages:
6+
- csharp
7+
extensions:
8+
contentType: samples
9+
technologies:
10+
- Microsoft Graph
11+
createdDate: 5/25/2017 5:03:53 PM
12+
---
13+
# ConsoleApp-MicrosoftGraphAPI-DeltaQuery-DotNet
14+
15+
Cette application de console montre comment effectuer des appels de requête delta à l’API Graph pour permettre aux applications de demander uniquement les données modifiées aux clients Microsoft Graph.
16+
17+
L’exemple montre comment les appels de graphiques peuvent être effectués avec le kit de développement logiciel (SDK) Graph et comment les réponses peuvent être gérées.
18+
19+
L’exemple spécifique utilisé dans cet exemple implique la surveillance des modifications (ajout et suppression) de MailFolders dans le compte de messagerie d’une personne.
20+
21+
## Exécution de cet exemple
22+
23+
Pour exécuter cet exemple, vous avez besoin des éléments suivants :
24+
- Visual Studio 2017
25+
- une connexion Internet
26+
- un client Azure Active Directory (Azure AD). Pour plus d’informations sur la façon d’obtenir un client Azure AD, voir [Obtention d’un client Azure AD](https://azure.microsoft.com/en-us/documentation/articles/active-directory-howto-tenant/)
27+
28+
### Étape 1 : Clonage ou téléchargement de ce référentiel
29+
30+
À partir de votre shell ou de la ligne de commande :
31+
32+
`git clone https://github.com/microsoftgraph/ConsoleApp-DeltaQuery-DotNet`
33+
34+
### Étape 2 : Inscription de l’exemple d’application avec votre client Azure Active Directory
35+
36+
Cet exemple contient un seul projet. Pour l’enregistrer, vous pouvez :
37+
38+
- soit suivre la procédure [Étape 2 : Inscription de l’exemple d’application avec votre client Azure Active Directory](#step-2-register-the-sample-with-your-azure-active-directory-tenant) et [Étape 3 : Configuration de l’échantillon pour utiliser votre client Azure AD](#choose-the-azure-ad-tenant-where-you-want-to-create-your-applications)
39+
- soit utiliser des scripts PowerShell qui :
40+
- créent **automatiquement** les applications Azure AD et les objets associés (mots de passe, autorisations, dépendances) à votre place
41+
- modifient les fichiers de configuration des projets Visual Studio.
42+
43+
Si vous voulez utiliser cette automatisation :
44+
45+
1. Sous Windows, exécutez PowerShell et accédez à la racine du répertoire cloné
46+
1. À partir de PowerShell, exécutez :
47+
48+
```PowerShell
49+
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process -Force
50+
```
51+
52+
1. Exécutez le script pour créer votre application Azure AD et configurez le code de l’exemple d’application en conséquence.
53+
54+
```PowerShell
55+
.\AppCreationScripts\Configure.ps1
56+
```
57+
58+
> D’autres méthodes d’exécution des scripts sont décrites dans [Scripts de création d’applications](./AppCreationScripts/AppCreationScripts.md)
59+
60+
1. Ouvrez le fichier de solution Visual Studio et cliquez sur Démarrer.
61+
62+
Si vous ne voulez pas utiliser cette automatisation, suivez les étapes ci-dessous.
63+
64+
#### Choix du client Azure AD où créer vos applications
65+
66+
Pour commencer, vous devez effectuer les opérations suivantes :
67+
68+
1. Connectez-vous au [portail Microsoft Azure](https://portal.azure.com) à l’aide d’un compte professionnel ou scolaire, ou d’un compte Microsoft personnel.
69+
1. Si votre compte vous propose un accès à plusieurs clients, sélectionnez votre compte en haut à droite et définissez votre session de portail sur le client Azure AD souhaité (à l’aide de **Changer de répertoire**).
70+
1. Dans le volet de navigation gauche, sélectionnez le service **Azure Active Directory**, puis sélectionnez **Inscriptions d’applications (préversion)**.
71+
72+
#### Inscription de l’application cliente (ConsoleApp-DeltaQuery-DotNet)
73+
74+
1. À la page **Inscriptions des applications (préversion)**, sélectionnez **Inscrire une application**.
75+
1. Lorsque la **page Inscrire une application** s’affiche, saisissez les informations d’inscription de votre application :
76+
- Dans la section **Nom**, saisissez un nom d’application significatif qui s’affichera pour les utilisateurs de l’application, par exemple `ConsoleApp-DeltaQuery-DotNet`.
77+
- Dans la section **Types de comptes pris en charge**, sélectionnez **Comptes dans un annuaire organisationnel et comptes personnels Microsoft (par ex. Skype, Xbox, Outlook.com)**.
78+
- Sélectionnez **S’inscrire** pour créer l’application.
79+
1. Sur la page **Vue d’ensemble** de l’application, notez la valeur **ID d’application (client)** et conservez-la pour plus tard. Vous en aurez besoin pour paramétrer le fichier de configuration de Visual Studio pour ce projet.
80+
1. Dans la liste des pages de l’application, sélectionnez **Authentification**.
81+
- Dans la boîte de dialogue *URI de redirection suggérés pour les clients publics (mobile, bureau)*, cochez la deuxième zone pour que l’application puisse utiliser les bibliothèques MSAL utilisées dans l’application. (La zone doit contenir l’option *urn:ietf:wg:oauth:2.0:oob*).
82+
1. Dans la liste des pages de l’application, sélectionnez **Permissions API**.
83+
- Cliquez sur le bouton **Ajouter une autorisation** puis,
84+
- Vérifiez que l'onglet **API Microsoft** est sélectionné
85+
- Dans la section *API Microsoft couramment utilisées*, cliquez sur **Microsoft Graph**
86+
- Dans la section **Autorisations déléguées**, assurez-vous que les autorisations appropriées sont vérifiées : **Mail.Read**. Utilisez la zone de recherche, le cas échéant.
87+
- Cliquez sur le bouton **Ajouter des autorisations**
88+
89+
### Étape 3 : Configuration de l’échantillon pour utiliser votre client Azure AD
90+
91+
Dans les étapes ci-dessous, « ID client » est identique à « ID de l’application ».
92+
93+
Ouverture de la solution dans Visual Studio pour configurer les projets
94+
95+
#### Configurer le projet client
96+
97+
1. Dans le dossier *ConsoleApplication*, renommez le fichier `appsettings.json.example` en `appsettings.json`.
98+
1. Ouvrez et modifiez le fichier `appSettings.json` pour apporter la modification suivante :
99+
1. Recherchez la ligne dans laquelle `ClientId` est défini comme `YOUR_CLIENT_ID_HERE` et remplacez la valeur existante par l’ID (client) de l’application `ConsoleApp-DeltaQuery-DotNet` copié à partir du portail Azure.
100+
101+
Nettoyez la solution, reconstruisez-la, puis démarrez-la dans le débogueur.
102+
103+
## Contribution
104+
105+
Si vous souhaitez contribuer à cet exemple, voir [CONTRIBUTING.MD](/CONTRIBUTING.md).
106+
107+
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.
108+
109+
## Questions et commentaires
110+
111+
N’hésitez pas à nous faire part de vos commentaires sur l’exemple de webhooks Microsoft Graph utilisant le kit de développement logiciel webjobs. Vous pouvez nous faire part de vos questions et suggestions dans la rubrique [Problèmes](https://github.com/microsoftgraph/ConsoleApp-DeltaQuery-DotNet/issues) de ce référentiel.
112+
113+
Les questions générales sur Microsoft Graph doivent être publiées sur le [Dépassement de capacité de la pile](https://stackoverflow.com/questions/tagged/MicrosoftGraph). Veillez à poser vos questions ou à rédiger vos commentaires en utilisant les tags *\[MicrosoftGraph]*.
114+
115+
Si vous avez des suggestions de fonctionnalité, soumettez votre idée sur notre page [Voix utilisateur](https://officespdev.uservoice.com/) et votez pour votre suggestion.
116+
117+
## Ressources supplémentaires
118+
119+
- [Exemple AAD DQ](https://github.com/Azure-Samples/active-directory-dotnet-graphapi-diffquery)
120+
- [Utilisation de la requête delta dans Microsoft Graph](https://developer.microsoft.com/en-us/graph/docs/concepts/delta_query_overview)
121+
- [Site des développeurs de Microsoft Graph](https://developer.microsoft.com/en-us/graph/)
122+
- [Appel de Microsoft Graph dans une application ASP.NET MVC](https://developer.microsoft.com/en-us/graph/docs/platform/aspnetmvc)
123+
- [MSAL.NET](https://aka.ms/msal-net)
124+
125+
Copyright (c) 2019 Microsoft Corporation. Tous droits réservés.

0 commit comments

Comments
 (0)