From 5b01fa9794ca884b4330ec421895371d0bed3d75 Mon Sep 17 00:00:00 2001 From: OfficeGlobal <47977325+OfficeGlobal@users.noreply.github.com> Date: Sat, 3 Oct 2020 01:16:03 +0200 Subject: [PATCH] HB of localized readme files (#76) Co-authored-by: OfficeGlobal --- .../README-Localized/README-es-es.md | 120 +++++++++++++++ .../README-Localized/README-fr-fr.md | 120 +++++++++++++++ .../README-Localized/README-ja-jp.md | 120 +++++++++++++++ .../README-Localized/README-pt-br.md | 120 +++++++++++++++ .../README-Localized/README-ru-ru.md | 120 +++++++++++++++ .../README-Localized/README-zh-cn.md | 120 +++++++++++++++ .../README-Localized/README-es-es.md | 140 ++++++++++++++++++ .../README-Localized/README-fr-fr.md | 140 ++++++++++++++++++ .../README-Localized/README-ja-jp.md | 140 ++++++++++++++++++ .../README-Localized/README-pt-br.md | 140 ++++++++++++++++++ .../README-Localized/README-ru-ru.md | 140 ++++++++++++++++++ .../README-Localized/README-zh-cn.md | 140 ++++++++++++++++++ 12 files changed, 1560 insertions(+) create mode 100644 Samples/auth/Office-Add-in-Microsoft-Graph-ASPNET/README-Localized/README-es-es.md create mode 100644 Samples/auth/Office-Add-in-Microsoft-Graph-ASPNET/README-Localized/README-fr-fr.md create mode 100644 Samples/auth/Office-Add-in-Microsoft-Graph-ASPNET/README-Localized/README-ja-jp.md create mode 100644 Samples/auth/Office-Add-in-Microsoft-Graph-ASPNET/README-Localized/README-pt-br.md create mode 100644 Samples/auth/Office-Add-in-Microsoft-Graph-ASPNET/README-Localized/README-ru-ru.md create mode 100644 Samples/auth/Office-Add-in-Microsoft-Graph-ASPNET/README-Localized/README-zh-cn.md create mode 100644 Samples/auth/Outlook-Add-in-Microsoft-Graph-ASPNET/README-Localized/README-es-es.md create mode 100644 Samples/auth/Outlook-Add-in-Microsoft-Graph-ASPNET/README-Localized/README-fr-fr.md create mode 100644 Samples/auth/Outlook-Add-in-Microsoft-Graph-ASPNET/README-Localized/README-ja-jp.md create mode 100644 Samples/auth/Outlook-Add-in-Microsoft-Graph-ASPNET/README-Localized/README-pt-br.md create mode 100644 Samples/auth/Outlook-Add-in-Microsoft-Graph-ASPNET/README-Localized/README-ru-ru.md create mode 100644 Samples/auth/Outlook-Add-in-Microsoft-Graph-ASPNET/README-Localized/README-zh-cn.md diff --git a/Samples/auth/Office-Add-in-Microsoft-Graph-ASPNET/README-Localized/README-es-es.md b/Samples/auth/Office-Add-in-Microsoft-Graph-ASPNET/README-Localized/README-es-es.md new file mode 100644 index 000000000..599dd3e06 --- /dev/null +++ b/Samples/auth/Office-Add-in-Microsoft-Graph-ASPNET/README-Localized/README-es-es.md @@ -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. + + diff --git a/Samples/auth/Office-Add-in-Microsoft-Graph-ASPNET/README-Localized/README-fr-fr.md b/Samples/auth/Office-Add-in-Microsoft-Graph-ASPNET/README-Localized/README-fr-fr.md new file mode 100644 index 000000000..daf312ab3 --- /dev/null +++ b/Samples/auth/Office-Add-in-Microsoft-Graph-ASPNET/README-Localized/README-fr-fr.md @@ -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. + + diff --git a/Samples/auth/Office-Add-in-Microsoft-Graph-ASPNET/README-Localized/README-ja-jp.md b/Samples/auth/Office-Add-in-Microsoft-Graph-ASPNET/README-Localized/README-ja-jp.md new file mode 100644 index 000000000..8caa95cf4 --- /dev/null +++ b/Samples/auth/Office-Add-in-Microsoft-Graph-ASPNET/README-Localized/README-ja-jp.md @@ -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 +--- +# Office アドインの Microsoft Graph と MSAL.NET を使用して OneDrive データを取得する + +Microsoft Graph に接続して OneDrive for Business に保存されている最初の 3 つのブックを検索し、それらのファイル名を取得して、Office.js. を使用してその名前を Office ドキュメントに挿入できるよう Microsoft Outlook アドインの作成方法について学習します。 + +## 機能 +オンライン サービス プロバイダーからのデータを統合すると、アドインの価値が向上し、採用できる機会が増えます。このコード サンプルでは、Microsoft Graph にアドインを接続する方法を示します。このコード サンプルを使用して、以下を実行します。 + +* Office アドインから Microsoft Graph に接続します。 +* MSAL.NET ライブラリを使用して、アドインに OAuth 2.0 承認フレームワークを実装します。 +* Microsoft Graph から OneDrive REST API を使用します。 +* Office UI 名前空間を使用してダイアログを表示します。 +* ASP.NET MVC、MSAL 3.x.x for .NET、Office.js を使用してアドインをビルドします。 +* アドインでアドイン コマンドを使用します。 + +## 適用対象 + +- Windows 上の Excel (1 回限りの購入とサブスクリプション) +- Windows 上の PowerPoint (1 回限りの購入とサブスクリプション) +- Windows 上の Word (1 回限りの購入とサブスクリプション) + +## 前提条件 + +このコード サンプルを実行するには、以下が必要です。 + +* Visual Studio 2019 以降。 + +* SQL Server Express (最新バージョンの Visual Studio では自動的にインストールされなくなりました。) + +* [Office 365 開発者プログラム](https://aka.ms/devprogramsignup)に参加すると取得できる Office 365 アカウント。Office 365 の 1 年間の無料サブスクリプションが含まれています。 + +* Office 365 サブスクリプションの OneDrive for Business に保存された少なくとも 3 つの Excel ワークブック。 + +* Windows 上の Office のバージョン 16.0.6769.2001 以降。 + +* [Office Developer Tools](https://www.visualstudio.com/en-us/features/office-tools-vs.aspx) + +* Microsoft Azure テナント。このアドインには、Azure Active Directory (AD) が必要です。Azure AD は、アプリケーションでの認証と承認に使う ID サービスを提供します。ここでは、試用版サブスクリプションを取得できます。[Microsoft Azure](https://account.windowsazure.com/SignUp)。 + +## ソリューション + +ソリューション | 作成者 +---------|---------- +Office アドイン Microsoft Graph ASP.NET | Microsoft + +## バージョン履歴 + +バージョン | 日付 | コメント +---------| -----| -------- +1.0 | 2019 年 7 月 8 日 | 初期リリース + +## 免責事項 + +**このコードは、明示または黙示のいかなる種類の保証なしに*現状のまま*提供されるものであり、特定目的への適合性、商品性、権利侵害の不存在についての暗黙的な保証は一切ありません。** + +---------- + +## ソリューションの構築と実行 + +### ソリューションを構成する + +1. **Visual Studio** で、**Office-Add-in-Microsoft-Graph-ASPNETWeb** プロジェクトを選択します。**[プロパティ]** で、**[SSL が有効]** が **True** であることを確認します。**[SSL URL]** で、次の手順でリストされているのと同じドメイン名とポート番号が使用されていることを確認します。 + +2. [Azure の管理ポータル](https://manage.windowsazure.com)を使用してアプリケーションを登録します。**Office 365 テナントの管理者の ID でログインして、そのテナントに関連付けられている Azure Active Directory で作業していることを確認します。**アプリケーションの登録の方法については、「[Microsoft ID プラットフォームにアプリケーションを登録する](https://docs.microsoft.com/graph/auth-register-app-v2)」を参照してください。次に示す設定を使用します。 + + - REDIRCT URI: https://localhost:44301/AzureADAuth/Authorize + - サポートされているアカウントの種類:"この組織のディレクトリ内のアカウントのみ" + - 暗黙的な付与:暗黙的な付与オプションを有効にしない + - API アクセス許可 (委任されたアクセス許可、アプリケーション アクセス許可ではありません):**Files.Read.All** と **User.Read** + + > 注:注: アプリケーションを登録したら、Azure の管理ポータルにある [アプリの登録] の **[概要]** ブレードの**アプリケーション (クライアント) ID** と**ディレクトリ (テナント) ID** をコピーします。**[証明書とシークレット]** ブレードでクライアント シークレットを作成したら、それもコピーします。 + +3. web.config で、前の手順でコピーした値を使用します。**[AAD:ClientID]** にクライアント ID、**[AAD:ClientSecret]** にクライアント シークレット、**[AAD:O365TenantID]** にテナント ID を設定します。 + +### ソリューションを実行する + +1. Visual Studio ソリューション ファイルを開きます。 +2. [**ソリューション エクスプローラー**] (プロジェクト ノードではありません) で、[**Office-Add-in-Microsoft-Graph-ASPNET**] ソリューションを右クリックし、**[スタートアップ プロジェクトの設定]** を選択します。[**マルチ スタートアップ プロジェクト**] ラジオ ボタンを選択します。最後に「Web」で終わるプロジェクトが表示されていることを確認します。 +3. [**ビルド**] メニューで [**ソリューションのクリーン**] を選択します。終了したら、[**ビルド**] メニューをもう一度開き、[**ソリューションのビルド**] を選択します。 +4. [**ソリューション エクスプローラー**] で、[**Office-Add-in-Microsoft-Graph-ASPNET**] を選択します (一番上のソリューション ノードではなく、「Web」で終わる名前のプロジェクトではありません)。 +5. [**プロパティ**] ウィンドウで、[**ドキュメントの開始**] ドロップダウンを開き、3 つのオプション (Excel、Word、または PowerPoint) のいずれかを選択します。 + + ![必要な Office ホスト アプリケーションを選択する:Excel、PowerPoint、または Word](images/SelectHost.JPG) + +6. F5 キーを押します。 +7. Office アプリケーションで、[**OneDrive ファイル**] グループから [**挿入**]、[**アドインを開く**] の順に選択して、タスク ウィンドウのアドインを開きます。 +8. アドインのページとボタンは、わかりやすく説明不要です。 + +## 既知の問題 + +* ファブリック スピナー制御が、わずかに表示されるか、まったく表示されません。 + +## 質問とコメント + +このサンプルに関するフィードバックをお寄せください。このリポジトリの「*問題*」セクションでフィードバックを送信できます。 +Office アドインの開発に関する質問は、「[Stack Overflow](http://stackoverflow.com)」に投稿してください。質問には、[office-js]、および [MicrosoftGraph] のタグを付けてください。 + +## その他のリソース + +* [Microsoft Graph ドキュメント](https://docs.microsoft.com/graph/) +* [Office アドイン ドキュメント](https://docs.microsoft.com/office/dev/add-ins/overview/office-add-ins) + +## 著作権 +Copyright (c) 2019 Microsoft Corporation.All rights reserved. + +このプロジェクトでは、[Microsoft オープン ソース倫理規定](https://opensource.microsoft.com/codeofconduct/)が採用されています。詳細については、「[倫理規定の FAQ](https://opensource.microsoft.com/codeofconduct/faq/)」を参照してください。また、その他の質問やコメントがあれば、[opencode@microsoft.com](mailto:opencode@microsoft.com) までお問い合わせください。 + + diff --git a/Samples/auth/Office-Add-in-Microsoft-Graph-ASPNET/README-Localized/README-pt-br.md b/Samples/auth/Office-Add-in-Microsoft-Graph-ASPNET/README-Localized/README-pt-br.md new file mode 100644 index 000000000..35b32c1c9 --- /dev/null +++ b/Samples/auth/Office-Add-in-Microsoft-Graph-ASPNET/README-Localized/README-pt-br.md @@ -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 +--- +# Obtenha dados do OneDrive usando o Microsoft Graph e o MSAL.NET em um Suplemento do Office + +Aprenda a criar um suplemento do Microsoft Office que se conecte ao Microsoft Graph, encontre as três primeiras pastas de trabalho armazenadas no OneDrive for Business, busca seus nomes de arquivo e insira os nomes em um documento do Office usando o Office.js. + +## Recursos +A integração de dados de provedores de serviço online aumenta o valor e a adoção de seus suplementos. O código a seguir mostra como conectar seu suplemento ao Microsoft Graph. Use este exemplo de código para: + +* Conectar-se ao Microsoft Graph a partir de um Suplemento do Office. +* Use a Biblioteca MSAL.NET para implementar a estrutura de autorização do OAuth 2.0 em um suplemento. +* Use as APIs REST do OneDrive a partir do Microsoft Graph. +* Exiba uma caixa de diálogo usando o namespace da interface do usuário do Office. +* Crie um Suplemento usando ASP.NET MVC, MSAL 3.x.x para NET e Office.js. +* Use comandos de suplemento no suplemento. + +## Aplicável a + +- Excel no Windows (compra única e assinatura) +- PowerPoint no Windows (compra única e assinatura) +- Word no Windows (compra única e assinatura) + +## Pré-requisitos + +Para executar este exemplo de código, são necessários. + +* Visual Studio 2019 ou posterior. + +* SQL Server Express (não é mais instalado automaticamente com versões recentes do Visual Studio). + +* Uma conta do Office 365 que você pode obter ingressando no [Programa para Desenvolvedores do Office 365](https://aka.ms/devprogramsignup) que inclui uma assinatura gratuita de 1 ano do Office 365. + +* Pelo menos três pastas de trabalho do Excel armazenadas no OneDrive for Business na sua assinatura do Office 365. + +* Office para Windows, versão 16.0.6769.2001 ou posterior. + +* [Ferramentas para Desenvolvedores do Office](https://www.visualstudio.com/en-us/features/office-tools-vs.aspx) + +* Um Locatário do Microsoft Azure. Este suplemento requer o Azure Active Directiory (AD). O Active AD fornece serviços de identidade que os aplicativos usam para autenticação e autorização. Você pode adquirir uma assinatura de avaliação aqui: [Microsoft Azure](https://account.windowsazure.com/SignUp). + +## Solução + +Solução | Autor(es) +---------|---------- +suplemento do Office Microsoft Graph ASP.NET | Microsoft + +## Histórico de versão + +Versão | Data | Comentários +---------| -----| -------- +1.0 | 8 de julho de 2019 | Versão inicial + +## Aviso de isenção de responsabilidade + +**ESSE CÓDIGO É FORNECIDO *NAS CIRCUNTÂNCIAS ATUAIS*SEM GARANTIA DE QUALQUER TIPO, SEJA EXPLÍCITA OU IMPLÍCITA, INCLUINDO QUAISQUER GARANTIAS IMPLÍCITAS DE ADEQUAÇÃO A UMA FINALIDADE ESPECÍFICA, COMERCIABILIDADE OU NÃO VIOLAÇÃO.** + +---------- + +## Compile e execute a solução. + +### Configurar a solução + +1. No **Visual Studio**, escolha o projeto **Office-suplemento-Microsoft-Graph-ASPNETWeb**. Em **Propriedades**, certifique-se de que o **SSL Habilitado** seja **Verdadeiro**. Verifique se o **URL SSL** usa o mesmo nome de domínio e número da porta que estão listados no próximo passo. + +2. Registre o seu aplicativo usando o [Portal de Gerenciamento do Azure](https://manage.windowsazure.com). **Faça logon com a identidade de um administrador da sua locação do Office 365 para garantir que você esteja trabalhando em um Azure Active Directory associado a essa locação.** Para aprender como registrar seus aplicativos, confira[Registrando um aplicativo na Microsoft Identity Platform](https://docs.microsoft.com/graph/auth-register-app-v2). Use as seguintes configurações: + + - REDIRECIONE O URI: https://localhost:44301/AzureADAuth/Authorize + - TIPOS DE CONTA COM SUPORTE: “Apenas contas neste diretório organizacional” + - CONCESSÃO IMPLÍCITA: Não ative nenhuma opção de Concessão Implícita + - PERMISSÕES de API (permissões delegadas, não permissões de aplicativo): **Files.Read.All** e **User.Read** + + > Observação: Após registrar o seu aplicativo, copie a **ID do Aplicativo (cliente)** e a **ID do Diretório (locatário)** na folha **Visão geral** do Registro de Aplicativo no Portal de Gerenciamento do Azure. Ao criar o segredo do cliente na folha **Certificados e segredos**, copie-o também. + +3. No web.config, use os valores que você copiou na etapa anterior. Defina **AAD: ClientID** para a ID do cliente, defina **AAD: ClientSecret** para o seu segredo de cliente e defina **"AAD: O365TenantID"** à sua ID de locatário. + +### Executar a solução + +1. Abra o arquivo de solução do Visual Studio. +2. Clique com o botão direito do mouse **Office-suplemento-Microsoft-Graph-ASPNET** solução no **Gerenciador de Soluções** (não os nós do projeto), em seguida, escolha **Configurar projetos de inicialização**. Marque a caixa de seleção **vários projetos de inicialização**. Verifique se o projeto que termina com "Web" está listado primeiro. +3. No menu **Compilar**, selecione **Solução Limpa**. Quando terminar, abra o menu **Compilar** novamente e selecione **Compilar Solução**. +4. No **Gerenciador de soluções**, selecione o nó do projeto **Suplemento-Office-Microsoft-Graph-ASPNET** (não o primeiro nó da solução e não o projeto cujo nome termina em "Web"). +5. No painel **Propriedades**, abra o menu suspenso Iniciar Documento e escolha uma das três opções (Excel, Word ou PowerPoint). + + ![Escolha o aplicativo host do Office desejado: Excel ou PowerPoint ou Word](images/SelectHost.JPG) + +6. Pressione F5. +7. No aplicativo do Office, escolha **Inserir** > **Abrir Suplemento** no grupo **Arquivos do OneDrive** para abrir o suplemento do painel de tarefas. +8. As páginas e os botões do suplemento são auto-explicativos. + +## Problemas conhecidos + +* O controle giratório do Fabric só aparece brevemente ou nem isso. + +## Perguntas e comentários + +Gostaríamos de saber sua opinião sobre este exemplo. Você pode enviar seus comentários na seção *Problemas* deste repositório. +Perguntas sobre o desenvolvimento de suplementos do Office devem ser publicadas em [Stack Overflow](http://stackoverflow.com). Certifique-se de que as suas perguntas estejam marcadas com [office-js], [MicrosoftGraph]. + +## Recursos adicionais + +* [Documentação do Microsoft Graph](https://docs.microsoft.com/graph/) +* [Documentação de Suplementos do Office](https://docs.microsoft.com/office/dev/add-ins/overview/office-add-ins) + +## Direitos autorais +Direitos autorais (c) 2019 Microsoft Corporation. Todos os direitos reservados. + +Este projeto adotou o [Código de Conduta do Código Aberto da Microsoft](https://opensource.microsoft.com/codeofconduct/). Para saber mais, confira [Perguntas frequentes sobre o Código de Conduta](https://opensource.microsoft.com/codeofconduct/faq/) ou contate [opencode@microsoft.com](mailto:opencode@microsoft.com) se tiver outras dúvidas ou comentários. + + diff --git a/Samples/auth/Office-Add-in-Microsoft-Graph-ASPNET/README-Localized/README-ru-ru.md b/Samples/auth/Office-Add-in-Microsoft-Graph-ASPNET/README-Localized/README-ru-ru.md new file mode 100644 index 000000000..0374ff8bf --- /dev/null +++ b/Samples/auth/Office-Add-in-Microsoft-Graph-ASPNET/README-Localized/README-ru-ru.md @@ -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 +--- +# Получение данных OneDrive с помощью Microsoft Graph и MSAL.NET в надстройке Office + +Узнайте, как создать надстройку Microsoft Office, которая подключается к Microsoft Graph, находит первые три книги, сохраненные в OneDrive для бизнеса, извлекает их имена и вставляет имена в документ Office с помощью Office.js. + +## Функции +Интегрируя данные поставщиков интернет-служб, вы повышаете ценность и популярность своих надстроек. В этом примере кода показано, как подключить надстройку к Microsoft Graph. С его помощью можно: + +* подключиться к Microsoft Graph из надстройки Office; +* использовать библиотеку MSAL.NET для внедрения инфраструктуры авторизации OAuth 2.0 в надстройке; +* использовать REST API для OneDrive из Microsoft Graph; +* отображать диалоговое окно с использованием пространства имен пользовательского интерфейса Office; +* создать надстройку с помощью ASP.NET MVC, MSAL 3.x.x для .NET, и Office.js; +* использовать команды надстроек в надстройке. + +## Сфера применения + +- Excel для Windows (единовременная покупка и подписка) +- PowerPoint для Windows (единовременная покупка и подписка) +- Word для Windows (единовременная покупка и подписка) + +## Необходимые компоненты + +Чтобы запустить этот пример кода, необходимо следующее: + +* Visual Studio 2019 или более поздней версии. + +* SQL Server Express (больше не устанавливается автоматически с последними версиями Visual Studio). + +* Учетная запись Office 365, которую получают участники [Программы для разработчиков Office 365](https://aka.ms/devprogramsignup), предоставляется вместе с бесплатной годичной подпиской на Office 365. + +* Минимум три книги Excel сохранены в OneDrive для бизнеса в составе подписки на Office 365. + +* Office для Windows, версии 16.0.6769.2001 или выше + +* [Office Developer Tools](https://www.visualstudio.com/en-us/features/office-tools-vs.aspx) + +* Клиент Microsoft Azure. Эта надстройка требует наличия Azure Active Directiory (AD). В Azure AD доступны службы идентификации, которые приложения используют для проверки подлинности и авторизации. Здесь можно получить пробную подписку: [Microsoft Azure](https://account.windowsazure.com/SignUp). + +## Решение + +Решение | Авторы +---------|---------- +Надстройка Office в Microsoft Graph ASP.NET | Microsoft + +## Журнал версий + +Версия | Дата | Примечания +---------| -----| -------- +1.0 | 8 июля 2019 г. | Первый выпуск + +## Заявление об отказе + +**ЭТОТ КОД ПРЕДОСТАВЛЯЕТСЯ *КАК ЕСТЬ* БЕЗ КАКОЙ-ЛИБО ЯВНОЙ ИЛИ ПОДРАЗУМЕВАЕМОЙ ГАРАНТИИ, ВКЛЮЧАЯ ПОДРАЗУМЕВАЕМЫЕ ГАРАНТИИ ПРИГОДНОСТИ ДЛЯ КАКОЙ-ЛИБО ЦЕЛИ, ДЛЯ ПРОДАЖИ ИЛИ ГАРАНТИИ ОТСУТСТВИЯ НАРУШЕНИЯ ПРАВ ИНЫХ ПРАВООБЛАДАТЕЛЕЙ.** + +---------- + +## Построение и запуск решения + +### Настройка решения + +1. В **Visual Studio** выберите проект **Office-Add-in-Microsoft-Graph-ASPNETWeb**. Убедитесь, что в окне **Свойства** для параметра **SSL включен** задано значение **Иcтина**. Убедитесь, что в поле **URL-адрес SSL** используются доменное имя и номер порта, указанные на следующем этапе. + +2. Зарегистрируйте свое приложение на [портале управления Azure](https://manage.windowsazure.com). **Войдите в систему, используя учетные данные администратора Office 365, чтобы убедиться, что вы работаете в службе Azure Active Directory, связанной с ними.** Сведения о регистрации приложений см. в статье [Регистрация приложения с помощью платформы удостоверений Майкрософт](https://docs.microsoft.com/graph/auth-register-app-v2). Используйте указанные ниже параметры: + + - URI ПЕРЕНАПРАВЛЕНИЯ: https://localhost:44301/AzureADAuth/Authorize + - ПОДДЕРЖИВАЕМЫЕ ТИПЫ УЧЕТНЫХ ЗАПИСЕЙ "Учетные записи только в этом каталоге организации" + - НЕЯВНОЕ ПРЕДОСТАВЛЕНИЕ РАЗРЕШЕНИЯ: Не включайте никакие параметры неявного предоставления разрешений + - РАЗРЕШЕНИЯ API (делегированные, не разрешения приложений): **Files.Read.All** и **User.Read** + + > Примечание. После регистрации приложения скопируйте **идентификатор приложения (клиента)** и **идентификатор директории (клиента)** в колонке **Обзор** регистрации приложения на портале управления Azure. Также скопируйте секретный код клиента, созданный в колонке **Сертификаты и секреты**. + +3. В узле web.config используйте значения, скопированные на предыдущем этапе. Для параметра **AAD:ClientID** задайте значение идентификатора клиента, а для параметра **AAD:ClientSecret** — значение секретного кода клиента. Задайте ваш идентификатор клиента Office 365 в **"AAD:O365TenantID"**. + +### Запуск решения + +1. Откройте файл решения в Visual Studio. +2. Щелкните правой кнопкой мыши **Office-Add-in-Microsoft-Graph-ASPNET** в **Обозревателе решений** (не узлы проекта), и выберите **Назначить запускаемые проекты**. Выберите переключатель **Несколько запускаемых проектов**. Убедитесь, что проект, имя которого заканчивается на "Web", указан первым. +3. В меню **Построение** выберите команду **Очистить решение**. После выполнения команды снова откройте меню **Построение** и выберите команду **Построить решение**. +4. В **Обозревателе решений** выберите узел проекта **Office-Add-in-Microsoft-Graph-ASPNET** (не верхний узел решения и не узел проекта, имя которого заканчивается на "Web"). +5. В области **Свойства** откройте раскрывающийся список **Начальный документ** и выберите один из трех вариантов (Excel, Word или PowerPoint). + + ![Выбор ведущего приложения Office:](images/SelectHost.JPG) Excel, PowerPoint или Word](images/SelectHost.JPG) + +6. Нажмите клавишу F5. +7. В приложении Office выберите **Вставить** > **Открыть приложение** в группе **Файлы OneDrive**, чтобы открыть надстройку "Область задач". +8. Страницы и кнопки в надстройке не требуют объяснений. + +## Известные проблемы + +* Элемент управления "Счетчик" может не появляться. + +## Вопросы и комментарии + +Мы будем рады узнать ваше мнение об этом примере. +Своими мыслями можете поделиться на вкладке *Проблемы* этого репозитория. Общие вопросы о разработке надстроек Office следует задавать на сайте [Stack Overflow](http://stackoverflow.com). Помечайте свои вопросы тегами [office-js] и [MicrosoftGraph]. + +## Дополнительные ресурсы + +* [Документация по Microsoft Graph](https://docs.microsoft.com/graph/) +* [Документация по надстройкам Office](https://docs.microsoft.com/office/dev/add-ins/overview/office-add-ins) + +## Авторские права +© Корпорация Майкрософт (Microsoft Corporation), 2019. Все права защищены. + +Этот проект соответствует [Правилам поведения разработчиков открытого кода Майкрософт](https://opensource.microsoft.com/codeofconduct/). Дополнительные сведения см. в разделе [часто задаваемых вопросов о правилах поведения](https://opensource.microsoft.com/codeofconduct/faq/). Если у вас возникли вопросы или замечания, напишите нам по адресу [opencode@microsoft.com](mailto:opencode@microsoft.com). + + diff --git a/Samples/auth/Office-Add-in-Microsoft-Graph-ASPNET/README-Localized/README-zh-cn.md b/Samples/auth/Office-Add-in-Microsoft-Graph-ASPNET/README-Localized/README-zh-cn.md new file mode 100644 index 000000000..283c7a8b2 --- /dev/null +++ b/Samples/auth/Office-Add-in-Microsoft-Graph-ASPNET/README-Localized/README-zh-cn.md @@ -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 +--- +# 使用 Microsoft Graph 和 MSAL.NET 在 Office 外接程序中获取 OneDrive 数据 + +了解如何构建连接到 Microsoft Graph 的 Microsoft Office 外接程序，查找存储在 OneDrive for Business 中的前三个工作簿，提取其文件名，然后使用 Office.js 将名称插入 Office 文档。 + +## 功能 +集成来自联机服务提供程序的数据可提高外接程序的价值和采用率。此代码示例演示了如何将外接程序连接到 Microsoft Graph。使用此代码示例可执行以下操作： + +* 从 Office 外接程序连接到 Microsoft Graph。 +* 使用 MSAL.NET 库在外接程序中实现 OAuth 2.0 授权框架。 +* 从 Microsoft Graph 中使用 OneDrive REST API。 +* 使用 Office UI 命名空间显示对话框。 +* 使用 ASP.NET MVC、适用于 .NET 的 MSAL 3.x.x 和 Office.js 构建外接程序。 +* 在外接程序中使用外接程序命令。 + +## 适用于 + +- Windows 版 Excel（一次性购买和订阅） +- Windows 版 PowerPoint（一次性购买和订阅） +- Windows 版 Word（一次性购买和订阅） + +## 先决条件 + +必须符合以下条件才能运行此代码示例。 + +* Visual Studio 2019 或更高版本。 + +* SQL Server Express（不再随最新版本的 Visual Studio 一起自动安装。） + +* Office 365 帐户，获取方法为加入 [Office 365 开发人员计划](https://aka.ms/devprogramsignup)，其中包含为期 1 年的免费 Office 365 订阅。 + +* 在 Office 365 订阅的 OneDrive for Business 中存储的至少三个 Excel 工作簿。 + +* Windows 版 Office，版本 16.0.6769.2001 或更高版本。 + +* [Office 开发人员工具](https://www.visualstudio.com/en-us/features/office-tools-vs.aspx) + +* 一个 Microsoft Azure 租户。此外接程序需要 Azure Active Directiory (AD)。Azure AD 为应用程序提供了用于进行身份验证和授权的标识服务。你还可在此处获得试用订阅：[Microsoft Azure](https://account.windowsazure.com/SignUp)。 + +## 解决方案 + +解决方案 | 作者 +---------|---------- +Office 外接程序 Microsoft Graph ASP.NET | Microsoft + +## 版本历史记录 + +版本 | 日期 | 批注 +---------| -----| -------- +1.0 | 2019 年 7 月 8 日| 初始发行版 + +## 免责声明 + +**此代码*按原样提供*，不提供任何明示或暗示的担保，包括对特定用途适用性、适销性或不侵权的默示担保。** + +---------- + +## 构建和运行解决方案 + +### 配置解决方案 + +1. 在 **Visual Studio** 中，选择**“Office-Add-in-Microsoft-Graph-ASPNETWeb”**项目。在**“属性”**中，确保**“已启用 SSL”**为**“True”**。验证 **SSL URL** 使用的域名和端口号与下一步中列出的相同。 + +2. 使用 [Azure 管理门户](https://manage.windowsazure.com)注册你的应用程序。**使用 Office 365 租赁的管理员标识登录，以确保正在使用与该租赁相关联的 Azure Active Directory。**若要了解如何注册应用程序，请参阅 [向 Microsoft 标识平台注册应用程序](https://docs.microsoft.com/graph/auth-register-app-v2)。使用以下设置： + + - 重定向 URI：https://localhost:44301/AzureADAuth/Authorize + - 支持的帐户类型：“仅限此组织目录中的帐户” + - 隐式授权：不启用任何隐式授权选项 + - API 权限（代理权限，而不是应用程序权限）：**Files.Read.All** 和 **User.Read** + + > 注意：注册应用程序之后，复制 Azure 管理门户的**“概览”**部分上的**“应用程序(客户端) ID”**和**“目录(租户) ID”**。在**“证书和密码”**部分创建客户端密码时，同样复制该密码。 + +3. 在 web.config 中，使用你在上一步中复制的值。将**“AAD:ClientID”**设置为客户端 ID，将**“AAD:ClientSecret”**设置为客户端密码，并将**“AAD:O365TenantID”**设置为租户 ID。 + +### 运行解决方案 + +1. 打开 Visual Studio 解决方案文件。 +2. 在**解决方案资源管理器**（而不是项目节点）中右键单击 **Office-Add-in-Microsoft-Graph-ASPNET** 解决方案，然后选择“**设置启动项目**”。选择“**多启动项目**”单选按钮。请确保先列出以“Web”结尾的项目。 +3. 在“**生成**”菜单上，选择“**清理解决方案**”。完成后，再次打开“**生成**”菜单，并选择“**生成解决方案**”。 +4. 在“**解决方案资源管理器**”中，选择“**Office-Add-in-Microsoft-Graph-ASPNET**”项目节点（而不是顶部的解决方案节点，也不是名称以“Web”结尾的项目）。 +5. 在“**属性**”窗格中，打开“**启动文档**”下拉列表，然后选择三个选项之一（“Excel”、“Word”或“PowerPoint”）。 + + ![选择所需的 Office 主机应用程序：](images/SelectHost.JPG)Excel、PowerPoint 或 Word](images/SelectHost.JPG) + +6. 按 F5。 +7. 在 Office 应用程序中，选择“**OneDrive文件**”组中的“**插入**”>“**打开外接程序**”，打开任务窗格外接程序。 +8. 外接程序中的页面和按钮一目了然。 + +## 已知问题 + +* 结构微调控件仅暂时显示或根本不显示。 + +## 问题和意见 + +我们乐意倾听你对此示例的反馈。可以在此存储库中的*“问题”*部分向我们发送反馈。 +与开发 Office 外接程序相关的问题应发布到[堆栈溢出](http://stackoverflow.com)。确保你的问题使用了 [office-js] 和 [MicrosoftGraph] 标记。 + +## 其他资源 + +* [Microsoft Graph 文档](https://docs.microsoft.com/graph/) +* [Office 外接程序文档](https://docs.microsoft.com/office/dev/add-ins/overview/office-add-ins) + +## 版权信息 +版权所有 (c) 2019 Microsoft Corporation。保留所有权利。 + +此项目已采用 [Microsoft 开放源代码行为准则](https://opensource.microsoft.com/codeofconduct/)。有关详细信息，请参阅[行为准则 FAQ](https://opensource.microsoft.com/codeofconduct/faq/)。如有其他任何问题或意见，也可联系 [opencode@microsoft.com](mailto:opencode@microsoft.com)。 + + diff --git a/Samples/auth/Outlook-Add-in-Microsoft-Graph-ASPNET/README-Localized/README-es-es.md b/Samples/auth/Outlook-Add-in-Microsoft-Graph-ASPNET/README-Localized/README-es-es.md new file mode 100644 index 000000000..cb44a35e4 --- /dev/null +++ b/Samples/auth/Outlook-Add-in-Microsoft-Graph-ASPNET/README-Localized/README-es-es.md @@ -0,0 +1,140 @@ +--- +page_type: sample +products: +- office-outlook +- office-365 +languages: +- javascript +extensions: + contentType: samples + technologies: + - Add-ins + createdDate: 5/1/2019 1:25:00 PM +description: "Obtenga más información sobre cómo crear un complemento de Microsoft Outlook que se conecte a Microsoft Graph" +--- + +# Obtenga libros de Excel cuando usa Microsoft Graph y MSAL en un complemento de Outlook. + +Infórmese sobre cómo crear un complemento de Microsoft Outlook que se conecta a Microsoft Graph, busca los primeros tres libros almacenados en OneDrive para la Empresa, encuentra sus nombres de archivo y los inserta en un nuevo formulario de redacción de mensajes en Outlook. + +## Características + +Integrar datos de proveedores de servicios en línea aumenta el valor y la adopción de los complementos. En este ejemplo de código se muestra cómo conectar el complemento de Outlook con Microsoft Graph. Use este ejemplo de código para: + +* Conectarse a Microsoft Graph desde un complemento de Office. +* Use la biblioteca MSAL .NET para implementar el marco de autorización OAuth 2.0 en un complemento. +* Usar las API de REST de OneDrive y Excel desde Microsoft Graph. +* Mostrar un diálogo usando el espacio de nombres de la interfaz de usuario de Office. +* Construir un complemento usando ASP.NET MVC, MSAL 3.x.x para .NET, y Office.js. + +## Se aplica a + +- Outlook en todas las plataformas + +## 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, la cual puede obtener al unirse al [programa para desarrolladores de Office 365](https://aka.ms/devprogramsignup), que incluye una suscripción gratuita de 1 año a Office 365. + +* Al menos tres libros de Excel almacenados en OneDrive para la Empresa en su suscripción a Office 365. + +* Opcional, si desea depurar en el escritorio en lugar de en Outlook Online: Outlook para Windows, versión 1809 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 Outlook 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**Outlook-Add-in-Microsoft-Graph-ASPNETWeb**. Asegúrese de que en las **propiedades** 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**Outlook-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 selección **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 **Outlook-Add-in-Microsoft-Graph-ASPNET**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 en el menú desplegable **iniciar acción** y elija si desea ejecutar el complemento en el escritorio de Outlook o con Outlook en la web en uno de los navegadores de la lista. (*No elija Internet Explorer. Vea los siguientes **problemas conocidos** para saber por qué.*) + + ![Elija el servidor de Oulook deseado: escritorio o uno de los exploradores](images/StartAction.JPG) + +6. Pulse F5. La primera vez que haga esto, se le pedirá que especifique el correo electrónico y la contraseña del usuario que usará para depurar el complemento. Use las credenciales del administrador en el espacio empresarial de O365. + + ![Formulario con cuadros de texto para el correo electrónico y la contraseña del usuario](images/CredentialsPrompt.JPG) + + >NOTA: Se abrirá el explorador en la página de inicio de sesión de Office en la web. (Por lo tanto, si esta es la primera vez que ejecuta el complemento, deberá escribir el nombre de usuario y la contraseña dos veces.) + +Los pasos restantes dependen de si está ejecutando el complemento en el escritorio de Outlook u Outlook en la Web. + +### Ejecute la solución con Outlook en la Web + +1. Outlook para web se abrirá en una ventana del explorador. En Outlook, haga clic en **nuevo** para crear un mensaje de correo electrónico. +2. Debajo del formulario de redacción está una barra de herramientas con botones para **enviar**, **descartar**, entre otras utilidades. En función de la experiencia de **Outlook en la Web** que use, el icono del complemento estará cerca del extremo derecho de la barra de herramientas, o bien en el menú desplegable que se abre al hacer clic en el botón **...** de la barra de herramientas. + + ![Icono del complemento para insertar archivos](images/Onedrive_Charts_icon_16x16px.png) + +3. Haga clic en el icono para abrir el complemento del panel de tareas. +4. Use el complemento para agregar al mensaje los nombres de los tres primeros libros de la cuenta OneDrive del usuario. Las páginas y los botones del complemento se explican por sí mismos. + +## Ejecutar el proyecto con la versión de escritorio de Outlook + +1. Se abrirá la versión de escritorio de Outlook. En Outlook, haga clic en **nuevo correo** para crear un mensaje de correo electrónico. +2. En la cinta de **mensajes** del formulario de **mensajes**, hay un botón etiquetado como **complemento abierto** en un grupo llamado **archivos de OneDrive**. Haga clic en el botón para abrir el complemento. +3. Use el complemento para agregar al mensaje los nombres de los tres primeros libros de la cuenta OneDrive del usuario. 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. +* Si lo está ejecutando en Internet Explorer, recibirá un mensaje de error cuando intente iniciar sesión, donde se indicará que deberá colocar `https://localhost:44301` y `https://outlook.office.com` (u `https://outlook.office365.com`) en la misma zona de seguridad. Pero, este error se produce incluso después de haberlo completado. + +## Preguntas y comentarios + +Nos encantaría recibir sus comentarios sobre la muestra para *obtener libros de Excel usando Microsoft Graph y MSAL en un complemento de Office* Puede enviarnos comentarios a través de la sección de *problemas* del repositorio. +Las preguntas generales sobre desarrollo en Office 365 deben publicarse en [Stack Overflow](http://stackoverflow.com/questions/tagged/Office365+API). Asegúrese de que sus preguntas están etiquetadas con [office-js], [MicrosoftGraph] y [API]. + +## 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 +Copyright (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, 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. + + diff --git a/Samples/auth/Outlook-Add-in-Microsoft-Graph-ASPNET/README-Localized/README-fr-fr.md b/Samples/auth/Outlook-Add-in-Microsoft-Graph-ASPNET/README-Localized/README-fr-fr.md new file mode 100644 index 000000000..f67879caf --- /dev/null +++ b/Samples/auth/Outlook-Add-in-Microsoft-Graph-ASPNET/README-Localized/README-fr-fr.md @@ -0,0 +1,140 @@ +--- +page_type: sample +products: +- office-outlook +- office-365 +languages: +- javascript +extensions: + contentType: samples + technologies: + - Add-ins + createdDate: 5/1/2019 1:25:00 PM +description: "Découvrir comment créer un complément Microsoft Outlook qui se connecte à Microsoft Graph" +--- + +# Obtenir des classeurs Excel à l’aide de Microsoft Graph et MSAL dans un complément Outlook + +Découvrez comment créer un complément Microsoft Outlook 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 nouveau formulaire de composition de message dans Outlook. + +## Fonctionnalités + +L'intégration de données à partir de fournisseurs de services en ligne augmente la valeur et l’adoption de vos compléments. Cet exemple de code vous présente comment connecter votre complément Outlook à Microsoft Graph. Utilisez cet exemple de code pour : + +* Se connecter à Microsoft Graph à partir d’un complément Office. +* Utilisez la bibliothèque MSAL .NET pour implémenter l’infrastructure d’autorisation OAuth 2.0 dans un complément. +* Utiliser les API REST OneDrive 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 en utilisant l’ASP.NET MVC, de MSAL 3.x.x pour .NET et d’Office.js. + +## Produits concernés + +- Outlook sur l'ensemble des plateformes + +## 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 (s'il n'est pas installé automatiquement sur 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. + +* De façon facultative, si vous voulez déboguer sur le bureau plutôt qu’Outlook Online : Office sur Windows, version 1809 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 Outlook 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 **Outlook-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 la solution **Outlook-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 **Outlook-Add-in-Microsoft-Graph-ASPNET** (et non le projet dont le nom se termine par « Web »). +5. Dans le volet **Propriétés**, ouvrez la liste déroulante **Action de démarrage** et indiquez si vous souhaitez exécuter le complément dans la version de bureau d’Outlook ou avec Outlook sur le web dans l’un des navigateurs répertoriés. (*Ne choisissez pas Internet Explorer. Pour en savoir plus, consultez les **Problèmes connus** ci-dessous.*) + + ![Choisissez l’hôte Oulook souhaité : bureau ou l’un des navigateurs](images/StartAction.JPG) + +6. Appuyez sur la touche F5. La première fois que vous effectuez cette opération, vous êtes invité à spécifier l’adresse de courrier et le mot de passe de l’utilisateur que vous utilisez pour le débogage du complément. Utilisez les informations d’identification d’un administrateur pour votre client Office 365. + + ![Formulaire incluant des zones de texte pour l’adresse de courrier et le mot de passe de l’utilisateur](images/CredentialsPrompt.JPG) + + >REMARQUE : Le navigateur s’ouvre sur la page de connexion pour Office sur le Web. (si vous exécutez le complément pour la première fois, vous devez entrer le nom d’utilisateur et le mot de passe à deux reprises). + +Les étapes restantes varient selon que vous utilisez le complément dans la version de bureau d’Outlook ou Outlook sur le web. + +### Exécutez la solution avec Outlook sur le web + +1. Outlook pour le web s’ouvre dans une fenêtre du navigateur. Dans Outlook, cliquez sur **Nouveau** pour créer un nouveau message. +2. Sous le formulaire composer, figure une barre d’outils contenant des boutons permettant d'**Envoyer**, d'**Ignorer** et d’autres utilitaires. Selon l'expérience **Outlook sur le web** que vous utilisez, l’icône du complément se trouve à l’extrémité droite de la barre d’outils ou dans le menu déroulant qui s’ouvre lorsque vous cliquez sur le bouton **...** dans cette barre d’outils. + + ![Icône pour le complément Insérer des fichiers](images/Onedrive_Charts_icon_16x16px.png) + +3. Cliquez sur l'icône pour ouvrir le complément de volet Office. +4. Utilisez le complément pour ajouter les noms des trois premiers classeurs dans le message du compte OneDrive de l’utilisateur. Les pages et les boutons du complément sont explicites. + +## Exécutez le projet avec la version de bureau d’Outlook + +1. La version de bureau d’Outlook s’ouvre. Dans Outlook, cliquez sur **Nouveau message** pour créer un nouveau message. +2. Dans le ruban **Message** du formulaire **Message**, il existe un bouton intitulé **Ouvrir un complément** dans un groupe appelé **Fichiers OneDrive**. Cliquez sur le bouton pour ouvrir le complément. +3. Utilisez le complément pour ajouter les noms des trois premiers classeurs dans le message du compte OneDrive de l’utilisateur. Les pages et les boutons du complément sont explicites. + +## Problèmes connus + +* Le contrôle bouton de progression de la structure s’affiche brièvement, voire pas du tout. +* Si vous exécutez dans Internet Explorer, un message d’erreur apparaît lorsque vous tentez de vous connecter, indiquant que vous devez placer `https://localhost:44301` et `https://outlook.office.com` (ou `https://outlook.office365.com`) dans la même zone de sécurité. Cette erreur se produit même si vous l’avez fait. + +## Questions et commentaires + +Nous aimerions recevoir vos commentaires relatifs à l’exemple *Obtenir des classeurs Excel à l’aide de Microsoft Graph et MSAL dans un complément Office*. 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 d’Office 365, envoyez-les sur [Stack Overflow](http://stackoverflow.com/questions/tagged/Office365+API). Assurez-vous que vos questions comportent les balises [office-js], [MicrosoftGraph] et [API]. + +## 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. + + diff --git a/Samples/auth/Outlook-Add-in-Microsoft-Graph-ASPNET/README-Localized/README-ja-jp.md b/Samples/auth/Outlook-Add-in-Microsoft-Graph-ASPNET/README-Localized/README-ja-jp.md new file mode 100644 index 000000000..634d58f8d --- /dev/null +++ b/Samples/auth/Outlook-Add-in-Microsoft-Graph-ASPNET/README-Localized/README-ja-jp.md @@ -0,0 +1,140 @@ +--- +page_type: sample +products: +- office-outlook +- office-365 +languages: +- javascript +extensions: + contentType: samples + technologies: + - Add-ins + createdDate: 5/1/2019 1:25:00 PM +description: "Microsoft Graph に接続する Microsoft Outlook アドインを構築する方法を学習します。" +--- + +# Outlook アドインで Microsoft Graph と MSAL を使用して Excel ブックを取得する + +Microsoft Graph に接続し、OneDrive for Business に保存されている最初の 3 つのブックを検索して、それらのファイル名を取得して Outlook の新しいメッセージの作成フォームにその名前を挿入できるよう Microsoft Outlook アドインの作成方法について学習します。 + +## 機能 + +オンライン サービス プロバイダーからのデータを統合すると、アドインの価値が向上し、採用できる機会が増えます。このコード サンプルでは、Microsoft Graph に Outlook アドインを接続する方法を示します。このコード サンプルを使用して、以下を実行します。 + +* Office アドインから Microsoft Graph に接続します。 +* MSAL .NET ライブラリを使用して、アドインに OAuth 2.0 承認フレームワークを実装します。 +* Microsoft Graph から OneDrive REST API を使用します。 +* Office UI 名前空間を使用してダイアログを表示します。 +* ASP.NET MVC、MSAL 3.x.x for .NET、Office.js を使用してアドインをビルドします。 + +## 適用対象 + +- すべてのプラットフォームの Outlook + +## 前提条件 + +このコード サンプルを実行するには、以下が必要です。 + +* Visual Studio 2019 以降。 + +* SQL Server Express (最新バージョンの Visual Studio で自動的にインストールされない場合。) + +* [Office 365 開発者プログラム](https://aka.ms/devprogramsignup)に参加すると取得できる Office 365 アカウント。Office 365 の 1 年間の無料サブスクリプションが含まれています。 + +* Office 365 サブスクリプションの OneDrive for Business に保存された少なくとも 3 つの Excel ワークブック。 + +* Outlook Online の代わりにデスクトップでデバッグする場合は、省略可能です。Outlook for Windows のバージョン 1809 以降。 +* [Office Developer Tools](https://www.visualstudio.com/en-us/features/office-tools-vs.aspx) + +* Microsoft Azure テナント。このアドインには、Azure Active Directory (AD) が必要です。Azure AD は、アプリケーションでの認証と承認に使う ID サービスを提供します。ここでは、試用版サブスクリプションを取得できます。[Microsoft Azure](https://account.windowsazure.com/SignUp)。 + +## ソリューション + +ソリューション | 作成者 +---------|---------- +Outlook Add-in Microsoft Graph ASP.NET | Microsoft + +## バージョン履歴 + +バージョン | 日付 | コメント +---------| -----| -------- +1.0 | 2019 年 7 月 8 日 | 初期リリース + +## 免責事項 + +**このコードは、明示または黙示のいかなる種類の保証なしに*現状のまま*提供されるものであり、特定目的への適合性、商品性、権利侵害の不存在についての暗黙的な保証は一切ありません。** + +---------- + +## ソリューションの構築と実行 + +## ソリューションを構成する + +1. **Visual Studio** で、**Outlook-Add-in-Microsoft-Graph-ASPNETWeb** プロジェクトを選択します。**[プロパティ]** で、**[SSL が有効]** が **True** であることを確認します。**[SSL URL]** で、次の手順でリストされているのと同じドメイン名とポート番号が使用されていることを確認します。 + +2. [Azure の管理ポータル](https://manage.windowsazure.com)を使用してアプリケーションを登録します。**Office 365 テナントの管理者の ID でログインして、そのテナントに関連付けられている Azure Active Directory で作業していることを確認します。**アプリケーションの登録の方法については、「[Microsoft ID プラットフォームにアプリケーションを登録する](https://docs.microsoft.com/graph/auth-register-app-v2)」を参照してください。次に示す設定を使用します。 + + - REDIRCT URI: https://localhost:44301/AzureADAuth/Authorize + - サポートされているアカウントの種類:"この組織のディレクトリ内のアカウントのみ" + - 暗黙的な付与:暗黙的な付与オプションを有効にしない + - API アクセス許可 (委任されたアクセス許可、アプリケーション アクセス許可ではありません):**Files.Read.All** と **User.Read** + + > 注:注: アプリケーションを登録したら、Azure の管理ポータルにある [アプリの登録] の **[概要]** ブレードの**アプリケーション (クライアント) ID** と**ディレクトリ (テナント) ID** をコピーします。**[証明書とシークレット]** ブレードでクライアント シークレットを作成したら、それもコピーします。 + +3. web.config で、前の手順でコピーした値を使用します。**[AAD:ClientID]** にクライアント ID、**[AAD:ClientSecret]** にクライアント シークレット、**[AAD:O365TenantID]** にテナント ID を設定します。 + +## ソリューションを実行する + +1. Visual Studio ソリューション ファイルを開きます。 +2. [**ソリューション エクスプローラー**] (プロジェクト ノードではありません) で、[**Outlook-Add-in-Microsoft-Graph-ASPNET**] ソリューションを右クリックし、**[スタートアップ プロジェクトの設定]** を選択します。[**マルチ スタートアップ プロジェクト**] ラジオ ボタンを選択します。最後に「Web」で終わるプロジェクトが表示されていることを確認します。 +3. [**ビルド**] メニューで [**ソリューションのクリーン**] を選択します。終了したら、[**ビルド**] メニューをもう一度開き、[**ソリューションのビルド**] を選択します。 +4. [**ソリューション エクスプローラー**] で、[**Outlook-Add-in-Microsoft-Graph-ASPNET**] を選択します (一番上のソリューション ノードではなく、「Web」で終わる名前のプロジェクトではありません)。 +5. [**プロパティ**] ウィンドウで、[**操作の開始**] ドロップ ダウンを開き、表示されたブラウザーのいずれかで、デスクトップ Outlook または Outlook on the web でアドインを実行するかどうかを選択します。(*Internet Explorer は選択しないでください。理由については、以下の**既知の問題**を参照してください。*) + + ![希望の Oulook ホスト: デスクトップまたはブラウザーのいずれかを選択します](images/StartAction.JPG) + +6. F5 キーを押します。初めて実行するときに、アドインのデバッグに使用するユーザーのメールアドレスとパスワードを指定するように求められます。O365 テナントの管理者の資格情報を使用します。 + + ![ユーザーのメールアドレスとパスワードを入力するテキスト ボックスを含むフォーム](images/CredentialsPrompt.JPG) + + >注:ブラウザーが開き、Office on the web 用の [ログイン] ページが表示されます。(つまり、アドインを初めて実行する場合は、ユーザー名とパスワードを 2 回入力します)。 + +残りの手順は、デスクトップ版の Outlook または Outlook on the web でアドインを実行しているかどうかによって異なります。 + +### Outlook on the web を使用してソリューションを実行する + +1. Outlook for Web はブラウザー ウィンドウで開きます。Outlook で、[**新規**] をクリックして、新しいメール メッセージを作成します。 +2. [作成] フォームの下には、[**送信**]、[**廃棄**]、その他のユーティリティ用のボタンを含むツール バーがあります。使用している **Outlook on the web** エクスペリエンスによっては、アドイン用アイコンはこのツールバーの右端にあるか、このツール バーの [**...**] ボタンをクリックするとき開くドロップ ダウン メニューにあります。 + + ![ファイル挿入アドイン用アイコン](images/Onedrive_Charts_icon_16x16px.png) + +3. アイコンをクリックして、タスク ウィンドウ アドインを開きます。 +4. アドインを使用して、ユーザーの OneDrive アカウントにある最初の 3 つのワークブックの名前をメッセージに追加します。アドインのページとボタンは、わかりやすく説明不要です。 + +## デスクトップ版の Outlook でプロジェクトを実行する + +1. デスクトップ版の Outlook が開きます。Outlook で、[**新規メール**] をクリックして、新しいメール メッセージを作成します。 +2. [**メッセージ**] フォームの [**メッセージ**] リボンには、[**OneDrive ファイル**] と呼ばれるグループに [** 開いているアドイン**] とラベル付けされたボタンがあります。そのボタンをクリックして、アドインを開きます。 +3. アドインを使用して、ユーザーの OneDrive アカウントにある最初の 3 つのワークブックの名前をメッセージに追加します。アドインのページとボタンは、わかりやすく説明不要です。 + +## 既知の問題 + +* ファブリック スピナー制御が、わずかに表示されるか、まったく表示されません。 +* Internet Explorer で実行している場合は、ログインしようとすると、「同じセキュリティ ゾーンに `https://localhost:44301` および `https://outlook.office.com` (または `https://outlook.office365.com`) を配置する必要があります」というエラーが表示されます。ただし、それを行っている場合でも、このエラーが発生します。 + +## 質問とコメント + +*Office アドインで Microsoft Graph および MSAL を使用して Excel ワークブックを取得する* サンプルに関するフィードバックをお寄せください。このリポジトリの「*問題*」セクションでフィードバックを送信できます。 +Office 365 開発全般の質問につきましては、「[Stack Overflow](http://stackoverflow.com/questions/tagged/Office365+API)」に投稿してください。質問には、[office-js]、[MicrosoftGraph]、[API] のタグを付けてください。 + +## その他のリソース + +* [Microsoft Graph ドキュメント](https://docs.microsoft.com/graph/) +* [Office アドイン ドキュメント](https://docs.microsoft.com/office/dev/add-ins/overview/office-add-ins) + +## 著作権 +Copyright (c) 2019 Microsoft Corporation.All rights reserved. + +このプロジェクトでは、[Microsoft オープン ソース倫理規定](https://opensource.microsoft.com/codeofconduct/)が採用されています。詳細については、「[倫理規定の FAQ](https://opensource.microsoft.com/codeofconduct/faq/)」を参照してください。また、その他の質問やコメントがあれば、[opencode@microsoft.com](mailto:opencode@microsoft.com) までお問い合わせください。 + + diff --git a/Samples/auth/Outlook-Add-in-Microsoft-Graph-ASPNET/README-Localized/README-pt-br.md b/Samples/auth/Outlook-Add-in-Microsoft-Graph-ASPNET/README-Localized/README-pt-br.md new file mode 100644 index 000000000..1c5346d95 --- /dev/null +++ b/Samples/auth/Outlook-Add-in-Microsoft-Graph-ASPNET/README-Localized/README-pt-br.md @@ -0,0 +1,140 @@ +--- +page_type: sample +products: +- office-outlook +- office-365 +languages: +- javascript +extensions: + contentType: samples + technologies: + - Add-ins + createdDate: 5/1/2019 1:25:00 PM +description: "Saiba como criar um suplemento do Microsoft Outlook que se conecta ao Microsoft Graph" +--- + +# Obter pastas de trabalho do Excel usando o Microsoft Graph e MSAL em um Suplemento do Outlook + +Aprenda a criar um suplemento do Microsoft Outlook que se conecta ao Microsoft Graph, encontra as três primeiras pastas de trabalho armazenadas no OneDrive for Business, busca seus nomes de arquivo e insere os nomes em um novo formulário de redação de mensagens no Outlook. + +## Recursos + +A integração de dados de provedores de serviço online aumenta o valor e a adoção de seus suplementos. O código a seguir mostra como conectar seu suplemento ao Microsoft Graph. Use este exemplo de código para: + +* Conectar-se ao Microsoft Graph a partir de um Suplemento do Office. +* Use a Biblioteca do MSAL .NET para implementar a estrutura de autorização do OAuth 2.0 em um suplemento. +* Use as APIs REST do OneDrive a partir do Microsoft Graph. +* Exiba uma caixa de diálogo usando o namespace da interface do usuário do Office. +* Crie um Suplemento usando ASP.NET MVC, MSAL 3.x.x para NET e Office.js. + +## Aplicável ao + +- Outlook em todas as plataformas + +## Pré-requisitos + +Para executar este exemplo de código, são necessários. + +* Visual Studio 2019 ou posterior. + +* SQL Server Express (se não for instalado automaticamente com versões recentes do Visual Studio.) + +* Uma conta do Office 365 que você pode obter ingressando no [Programa para Desenvolvedores do Office 365](https://aka.ms/devprogramsignup) que inclui uma assinatura gratuita de 1 ano do Office 365. + +* Pelo menos três pastas de trabalho do Excel armazenadas no OneDrive for Business na sua assinatura do Office 365. + +* Opcional, se você quiser depurar na área de trabalho em vez do Outlook Online: Outlook para Windows, versão 1809 ou posterior. +* [Ferramentas para Desenvolvedores do Office](https://www.visualstudio.com/en-us/features/office-tools-vs.aspx) + +* Um Locatário do Microsoft Azure. Este suplemento requer o Azure Active Directiory (AD). O Active AD fornece serviços de identidade que os aplicativos usam para autenticação e autorização. Você pode adquirir uma assinatura de avaliação aqui: [Microsoft Azure](https://account.windowsazure.com/SignUp). + +## Solução + +Solução | Autor(es) +---------|---------- +Suplemento do Office Microsoft Graph ASP.NET | Microsoft + +## Histórico de versão + +Versão | Data | Comentários +---------| -----| -------- +1.0 | 8 de julho de 2019 | Versão inicial + +## Aviso de isenção de responsabilidade + +**ESSE CÓDIGO É FORNECIDO *NAS CIRCUNTÂNCIAS ATUAIS*SEM GARANTIA DE QUALQUER TIPO, SEJA EXPLÍCITA OU IMPLÍCITA, INCLUINDO QUAISQUER GARANTIAS IMPLÍCITAS DE ADEQUAÇÃO A UMA FINALIDADE ESPECÍFICA, COMERCIABILIDADE OU NÃO VIOLAÇÃO.** + +---------- + +## Compile e execute a solução. + +## Configurar a solução + +1. No **Visual Studio**, escolha o projeto **Outlook-Add-in-Microsoft-Graph-ASPNETWeb**. Em **Propriedades**, certifique-se que o **SSL Habilitado** está definido como True. Verifique se o **URL SSL** usa o mesmo nome de domínio e número da porta que estão listados no próximo passo. + +2. Registre o seu aplicativo usando o [Portal de Gerenciamento do Azure](https://manage.windowsazure.com). **Faça logon com a identidade de um administrador da sua locação do Office 365 para garantir que você esteja trabalhando em um Azure Active Directory associado a essa locação.** Para aprender como registrar seus aplicativos, confira[Registrando um aplicativo na Microsoft Identity Platform](https://docs.microsoft.com/graph/auth-register-app-v2). Use as seguintes configurações: + + - REDIRECIONE O URI: https://localhost:44301/AzureADAuth/Authorize + - TIPOS DE CONTA COM SUPORTE: “Apenas contas neste diretório organizacional” + - CONCESSÃO IMPLÍCITA: Não ative nenhuma opção de Concessão Implícita + - PERMISSÕES de API (permissões delegadas, não permissões de aplicativo): **Files.Read.All** e **User.Read** + + > Observação: Após registrar o seu aplicativo, copie a **ID do Aplicativo (cliente)** e a **ID do Diretório (locatário)** na folha **Visão geral** do Registro de Aplicativo no Portal de Gerenciamento do Azure. Ao criar o segredo do cliente na folha **Certificados e segredos**, copie-o também. + +3. No web.config, use os valores que você copiou na etapa anterior. Defina **AAD: ClientID** para a ID do cliente, defina **AAD: ClientSecret** para o seu segredo de cliente e defina **"AAD: O365TenantID"** à sua ID de locatário. + +## Executar a solução + +1. Abra o arquivo de solução do Visual Studio. +2. Clique com o botão direito do mouse em **Office-suplemento-Microsoft-Graph-ASPNET** na solução **Gerenciador de Soluções** (não os nós do projeto), em seguida, escolha **Configurar projetos de inicialização**. Marque o botão de opção **Vários projetos de inicialização**. Verifique se o projeto que termina com "Web" está listado primeiro. +3. No menu **Compilar**, selecione **Solução Limpa**. Quando terminar, abra o menu **Compilar** novamente e selecione **Compilar Solução**. +4. Em **Gerenciador de Soluções**, selecione o nó do projeto **Suplemento-Office-Microsoft-Graph-ASPNET** (não o primeiro nó da solução e não o projeto cujo nome termina em "Web"). +5. No painel **Propriedades**, abra o menu suspenso **Iniciar Ação** e escolha se deseja executá-lo no Outlook ou no Outlook na Web em um dos navegadores listados. (*Não escolha o Internet Explorer. Confira **Problemas Conhecidos** abaixo para saber o porquê.*) + + ![Escolha o host Oulook desejado: a área de trabalho ou um dos navegadores](images/StartAction.JPG) + +6. Pressione F5. Na primeira vez que você fizer isso, você será instruído a especificar o email e a senha do usuário que você usará para depurar o suplemento. Use as credenciais de um administrador para locação do O365. + + ![Formulário com caixas de texto para email e senha do usuário](images/CredentialsPrompt.JPG) + + >OBSERVAÇÃO: O navegador abrirá a página de logon do Office na Web. (Portanto, se for a primeira vez que você executa o suplemento, insira o nome de usuário e a senha duas vezes.) + +As etapas restantes dependem de você estar executando o suplemento no Outlook ou no Outlook na Web. + +### Executar a solução com o Outlook na Web + +1. O Outlook para Web será aberto em uma janela do navegador. No Outlook, clique em **Novo** para criar uma nova mensagem de email. +2. Abaixo do formulário de redação está uma barra de ferramentas com os botões para **Enviar**, **Descartar** e outros utilitários. Dependendo da experiência do **Outlook na Web** que você está usando, o ícone do suplemento estará próximo à extremidade direita dessa barra de ferramentas ou estará no menu suspenso que será aberto quando você clica no botão **...** dessa barra de ferramentas. + + ![Ícone de Suplemento Inserir Arquivos](images/Onedrive_Charts_icon_16x16px.png) + +3. Clique no ícone para abrir o suplemento do painel de tarefas. +4. Use o suplemento para adicionar os nomes das três primeiras pastas de trabalho da conta do OneDrive do usuário à mensagem. As páginas e os botões do suplemento são autoexplicativos. + +## Executar o projeto com a área de trabalho do Outlook + +1. A área de trabalho do Outlook será aberta. No Outlook, clique em **Novo Email** para criar uma nova mensagem de email. +2. Na faixa de opções **Mensagem** do formulário **Mensagem**, há um botão rotulado **Abrir Suplemento** em um grupo chamado **Arquivos do OneDrive**. Clique no botão para abrir o suplemento. +3. Use o suplemento para adicionar os nomes das três primeiras pastas de trabalho da conta do OneDrive do usuário à mensagem. As páginas e os botões do suplemento são autoexplicativos. + +## Problemas conhecidos + +* O controle giratório do Fabric só aparece brevemente ou nem isso. +* Se você estiver executando no Internet Explorer, receberá uma mensagem de erro ao tentar fazer login, dizendo que deve colocar `https://localhost:44301` e `https://outlook.office.com` (ou `https://outlook.office365.com`) na mesma zona de segurança. Mas esse erro ocorre mesmo que você tenha feito isso. + +## Perguntas e comentários + +Gostaríamos de receber seus comentários sobre o exemplo *Obter as pastas de trabalho do Excel usando o Microsoft Graph e MSAL em um Suplemento do Office*. Você pode enviar seus comentários na seção *Problemas* deste repositório. +Perguntas sobre o desenvolvimento do Office 365 em geral devem ser postadas no [Stack Overflow](http://stackoverflow.com/questions/tagged/Office365+API). Certifique-se de que as suas perguntas estejam marcadas com [office-js], [MicrosoftGraph] e [API]. + +## Recursos adicionais + +* [Documentação do Microsoft Graph](https://docs.microsoft.com/graph/) +* [Documentação de Suplementos do Office](https://docs.microsoft.com/office/dev/add-ins/overview/office-add-ins) + +## Direitos autorais +Direitos autorais (c) 2019 Microsoft Corporation. Todos os direitos reservados. + +Este projeto adotou o [Código de Conduta do Código Aberto da Microsoft](https://opensource.microsoft.com/codeofconduct/). Para saber mais, confira [Perguntas frequentes sobre o Código de Conduta](https://opensource.microsoft.com/codeofconduct/faq/) ou contate [opencode@microsoft.com](mailto:opencode@microsoft.com) se tiver outras dúvidas ou comentários. + + diff --git a/Samples/auth/Outlook-Add-in-Microsoft-Graph-ASPNET/README-Localized/README-ru-ru.md b/Samples/auth/Outlook-Add-in-Microsoft-Graph-ASPNET/README-Localized/README-ru-ru.md new file mode 100644 index 000000000..bf836010e --- /dev/null +++ b/Samples/auth/Outlook-Add-in-Microsoft-Graph-ASPNET/README-Localized/README-ru-ru.md @@ -0,0 +1,140 @@ +--- +page_type: sample +products: +- office-outlook +- office-365 +languages: +- javascript +extensions: + contentType: samples + technologies: + - Add-ins + createdDate: 5/1/2019 1:25:00 PM +description: "Сведения о создании надстройки Microsoft Outlook, подключающейся к Microsoft Graph" +--- + +# Получение книг Excel с помощью Microsoft Graph и MSAL в надстройке Outlook + +Узнайте, как создать надстройку Microsoft Outlook, которая подключается к Microsoft Graph, находит первые три книги, сохраненные в OneDrive для бизнеса, извлекает их имена и вставляет имена в новую форму создания сообщения в Outlook. + +## Функции + +Интегрируя данные поставщиков интернет-служб, вы повышаете ценность и популярность своих надстроек. В этом примере кода показано, как подключить надстройку Outlook к Microsoft Graph. С его помощью можно: + +* подключиться к Microsoft Graph из надстройки Office; +* использовать библиотеку MSAL .NET для внедрения инфраструктуры авторизации OAuth 2.0 в надстройке; +* использовать REST API для OneDrive из Microsoft Graph; +* отображать диалоговое окно с использованием пространства имен пользовательского интерфейса Office; +* создать надстройку с помощью ASP.NET MVC, MSAL 3.x.x для .NET и Office.js. + +## Область применения + +- Outlook на всех платформах + +## Предварительные требования + +Чтобы запустить этот пример кода, необходимо следующее: + +* Visual Studio 2019 или более поздней версии. + +* SQL Server Express (если автоматически не установлен с последними версиями Visual Studio). + +* Учетная запись Office 365, которую получают участники [программы для разработчиков Office 365](https://aka.ms/devprogramsignup), предоставляющаяся вместе с бесплатной годичной подпиской на Office 365. + +* Минимум три книги Excel, сохраненные в OneDrive для бизнеса в составе подписки на Office 365. + +* (Необязательно) Если вы хотите выполнить отладку в классической версии, а не в Outlook Online: Outlook для Windows версии 1809 или более поздней. +* [Office Developer Tools](https://www.visualstudio.com/en-us/features/office-tools-vs.aspx) + +* Клиент Microsoft Azure. Эта надстройка требует наличия Azure Active Directiory (AD). В Azure AD доступны службы идентификации, которые приложения используют для проверки подлинности и авторизации. Здесь можно получить пробную подписку: [Microsoft Azure](https://account.windowsazure.com/SignUp). + +## Решение + +Решение | Авторы +---------|---------- +Надстройка Outlook в Microsoft Graph ASP.NET | Майкрософт + +## Журнал версий + +Версия | Дата | Примечания +---------| -----| -------- +1.0 | 8 июля 2019 г. | Первый выпуск + +## Заявление об отказе + +**ЭТОТ КОД ПРЕДОСТАВЛЯЕТСЯ *КАК ЕСТЬ* БЕЗ КАКОЙ-ЛИБО ЯВНОЙ ИЛИ ПОДРАЗУМЕВАЕМОЙ ГАРАНТИИ, ВКЛЮЧАЯ ПОДРАЗУМЕВАЕМЫЕ ГАРАНТИИ ПРИГОДНОСТИ ДЛЯ КАКОЙ-ЛИБО ЦЕЛИ, ДЛЯ ПРОДАЖИ ИЛИ ГАРАНТИИ ОТСУТСТВИЯ НАРУШЕНИЯ ПРАВ ИНЫХ ПРАВООБЛАДАТЕЛЕЙ.** + +---------- + +## Построение и запуск решения + +## Настройка решения + +1. В **Visual Studio** выберите проект **Outlook-Add-in-Microsoft-Graph-ASPNETWeb**. Убедитесь, что в окне **Свойства** для параметра **SSL включен** задано значение **True**. Убедитесь, что в поле **URL-адрес SSL** используются доменное имя и номер порта, указанные на следующем этапе. + +2. Зарегистрируйте свое приложение на [портале управления Azure](https://manage.windowsazure.com). **Войдите в систему, используя учетные данные администратора Office 365, чтобы убедиться, что вы работаете в службе Azure Active Directory, связанной с ними.** Сведения о регистрации приложений см. в статье [Регистрация приложения с помощью платформы удостоверений Майкрософт](https://docs.microsoft.com/graph/auth-register-app-v2). Используйте указанные ниже параметры: + + - URI ПЕРЕНАПРАВЛЕНИЯ: https://localhost:44301/AzureADAuth/Authorize + - ПОДДЕРЖИВАЕМЫЕ ТИПЫ УЧЕТНЫХ ЗАПИСЕЙ "Учетные записи только в этом каталоге организации" + - НЕЯВНОЕ ПРЕДОСТАВЛЕНИЕ РАЗРЕШЕНИЯ: Не включайте никакие параметры неявного предоставления разрешений + - РАЗРЕШЕНИЯ API (делегированные, не разрешения приложений): **Files.Read.All** и **User.Read** + + > Примечание. После регистрации приложения скопируйте **идентификатор приложения (клиента)** и **идентификатор директории (клиента)** в колонке **Обзор** регистрации приложения на портале управления Azure. Также скопируйте секретный код клиента, созданный в колонке **Сертификаты и секреты**. + +3. В узле web.config используйте значения, скопированные на предыдущем этапе. Для параметра **AAD:ClientID** задайте значение идентификатора клиента, а для параметра **AAD:ClientSecret** — значение секретного кода клиента. Задайте ваш идентификатор клиента Office 365 в **"AAD:O365TenantID"**. + +## Запуск решения + +1. Откройте файл решения в Visual Studio. +2. Щелкните правой кнопкой мыши решение **Outlook-Add-in-Microsoft-Graph-ASPNET** в **Обозревателе решений** (не узлы проекта) и выберите **Назначить запускаемые проекты**. Установите переключатель **Несколько запускаемых проектов**. Убедитесь, что проект, имя которого заканчивается на "Web", указан первым. +3. В меню **Сборка** выберите команду **Очистить решение**. После выполнения команды снова откройте меню **Сборка** и выберите **Собрать решение**. +4. В **Обозревателе решений** выберите узел проекта **Outlook-Add-in-Microsoft-Graph-ASPNET** (не верхний узел решения и не узел проекта, имя которого заканчивается на "Web"). +5. В области **Свойства** откройте раскрывающийся список **Действие при запуске** и выберите запуск надстройки в классической версии Outlook или Outlook в Интернете в одном из перечисленных браузеров. (*Не выбирайте Internet Explorer. Причины см. в разделе **Известные проблемы** ниже.*) + + ![Выберите нужное ведущее приложение Outlook: классическое или в одном из браузеров](images/StartAction.JPG) + +6. Нажмите клавишу F5. При первом запуске вам будет предложено указать адрес электронной почты и пароль пользователя, которые будут использоваться для отладки надстройки. Используйте учетные данные администратора своего клиента Office 365. + + ![Форма с текстовыми полями для электронной почты и пароля пользователя](images/CredentialsPrompt.JPG) + + >ПРИМЕЧАНИЕ. Браузер откроется на странице входа в Office в Интернете. (Если это первый запуск надстройки, вы введете имя пользователя и пароль дважды.) + +Остальные действия зависят от среды работы надстройки: классическая версия Outlook или Outlook в Интернете. + +### Запуск решения в Outlook в Интернете + +1. Outlook в Интернете откроется в окне браузера. В Outlook щелкните **Создать**, чтобы создать сообщение электронной почты. +2. Под областью создания сообщения расположена панель инструментов с кнопками **Отправить**, **Отменить** и другими функциями. В зависимости от используемого интерфейса **Outlook в Интернете** значок надстройки расположен с правого края этой панели инструментов или в раскрывающемся меню, появляющемся при нажатии кнопки **...** на этой панели инструментов. + + ![Значок для надстройки "Вставка файлов"](images/Onedrive_Charts_icon_16x16px.png) + +3. Щелкните значок, чтобы открыть надстройку области задач. +4. С помощью надстройки добавьте имена первых трех книг из учетной записи OneDrive пользователя в сообщение. Страницы и кнопки надстройки не требуют объяснений. + +## Запуск проекта в классической версии Outlook + +1. Откроется классическое приложение Outlook. В Outlook щелкните **Создать сообщение**, чтобы создать сообщение электронной почты. +2. На ленте **Сообщение** формы **Сообщение** есть кнопка **Открыть надстройку** в группе **Файлы OneDrive**. Нажмите кнопку, чтобы открыть надстройку. +3. С помощью надстройки добавьте имена первых трех книг из учетной записи OneDrive пользователя в сообщение. Страницы и кнопки надстройки не требуют объяснений. + +## Известные проблемы + +* Индикатор работы Fabric отображается кратковременно или совсем не отображается. +* Если вы работаете в Internet Explorer, при попытке входа возникает ошибка с сообщением о необходимости разместить `https://localhost:44301` и `https://outlook.office.com` (или `https://outlook.office365.com`) в одной зоне безопасности. Но эта ошибка появляется даже после выполнения этого действия. + +## Вопросы и комментарии + +Мы будем рады получить ваши отзывы о примере *получения книг Excel с помощью Microsoft Graph и MSAL в надстройке Office*. +Своими мыслями можете поделиться на вкладке *Проблемы* этого репозитория. Общие вопросы о разработке решений для Office 365 следует публиковать на сайте [Stack Overflow](http://stackoverflow.com/questions/tagged/Office365+API). Помечайте свои вопросы тегами [office-js], [MicrosoftGraph] и [API]. + +## Дополнительные ресурсы + +* [Документация по Microsoft Graph](https://docs.microsoft.com/graph/) +* [Документация по надстройкам Office](https://docs.microsoft.com/office/dev/add-ins/overview/office-add-ins) + +## Авторские права +© Корпорация Майкрософт (Microsoft Corporation), 2019. Все права защищены. + +Этот проект соответствует [Правилам поведения разработчиков открытого кода Майкрософт](https://opensource.microsoft.com/codeofconduct/). Дополнительные сведения см. в разделе [часто задаваемых вопросов о правилах поведения](https://opensource.microsoft.com/codeofconduct/faq/). Если у вас возникли вопросы или замечания, напишите нам по адресу [opencode@microsoft.com](mailto:opencode@microsoft.com). + + diff --git a/Samples/auth/Outlook-Add-in-Microsoft-Graph-ASPNET/README-Localized/README-zh-cn.md b/Samples/auth/Outlook-Add-in-Microsoft-Graph-ASPNET/README-Localized/README-zh-cn.md new file mode 100644 index 000000000..cc9599322 --- /dev/null +++ b/Samples/auth/Outlook-Add-in-Microsoft-Graph-ASPNET/README-Localized/README-zh-cn.md @@ -0,0 +1,140 @@ +--- +page_type: sample +products: +- office-outlook +- office-365 +languages: +- javascript +extensions: + contentType: samples + technologies: + - Add-ins + createdDate: 5/1/2019 1:25:00 PM +description: "了解如何构建连接到 Microsoft Graph 的 Microsoft Outlook 外接程序。" +--- + +# 使用 Microsoft Graph 和 MSAL 在 Outlook 外接程序中获取 Excel 工作簿 + +了解如何构建连接到 Microsoft Graph 的 Microsoft Outlook 外接程序，查找存储在 OneDrive for Business 中的前三个工作簿，提取其文件名，然后将名称插入 Outlook 中的新邮件撰写表单。 + +## 功能 + +集成来自联机服务提供程序的数据可提高外接程序的价值和采用率。此代码示例演示了如何将 Outlook 外接程序连接到 Microsoft Graph。使用此代码示例可执行以下操作： + +* 从 Office 外接程序连接到 Microsoft Graph。 +* 使用 MSAL .NET 库在外接程序中实现 OAuth 2.0 授权框架。 +* 从 Microsoft Graph 中使用 OneDrive REST API。 +* 使用 Office UI 命名空间显示对话框。 +* 使用 ASP.NET MVC、适用于 .NET 的 MSAL 3.x.x 和 Office.js 构建外接程序。 + +## 适用于 + +- 所有平台上的 Outlook + +## 先决条件 + +必须符合以下条件才能运行此代码示例。 + +* Visual Studio 2019 或更高版本。 + +* SQL Server Express（如果不随最新版本的 Visual Studio 一起自动安装。） + +* Office 365 帐户，获取方法为加入 [Office 365 开发人员计划](https://aka.ms/devprogramsignup)，其中包含为期 1 年的免费 Office 365 订阅。 + +* 在 Office 365 订阅的 OneDrive for Business 中存储的至少三个 Excel 工作簿。 + +* 如果要在桌面而不是 Outlook Online 上进行调试，则是可选的：Windows 版 Outlook，版本 1809 或更高版本。 +* [Office 开发人员工具](https://www.visualstudio.com/en-us/features/office-tools-vs.aspx) + +* 一个 Microsoft Azure 租户。此外接程序需要 Azure Active Directiory (AD)。Azure AD 为应用程序提供了用于进行身份验证和授权的标识服务。你还可在此处获得试用订阅：[Microsoft Azure](https://account.windowsazure.com/SignUp)。 + +## 解决方案 + +解决方案 | 作者 +---------|---------- +Outlook 外接程序 Microsoft Graph ASP.NET | Microsoft + +## 版本历史记录 + +版本 | 日期 | 批注 +---------| -----| -------- +1.0 | 2019 年 7 月 8 日| 初始发行版 + +## 免责声明 + +**此代码*按原样提供*，不提供任何明示或暗示的担保，包括对特定用途适用性、适销性或不侵权的默示担保。** + +---------- + +## 构建和运行解决方案 + +## 配置解决方案 + +1. 在 **Visual Studio** 中，选择**“Outlook-Add-in-Microsoft-Graph-ASPNETWeb”**项目。在**“属性”**中，确保**“已启用 SSL”**为**“True”**。验证 **SSL URL** 使用的域名和端口号与下一步中列出的相同。 + +2. 使用 [Azure 管理门户](https://manage.windowsazure.com)注册你的应用程序。**使用 Office 365 租赁的管理员标识登录，以确保正在使用与该租赁相关联的 Azure Active Directory。**若要了解如何注册应用程序，请参阅 [向 Microsoft 标识平台注册应用程序](https://docs.microsoft.com/graph/auth-register-app-v2)。使用以下设置： + + - 重定向 URI：https://localhost:44301/AzureADAuth/Authorize + - 支持的帐户类型：“仅限此组织目录中的帐户” + - 隐式授权：不启用任何隐式授权选项 + - API 权限（代理权限，而不是应用程序权限）：**Files.Read.All** 和 **User.Read** + + > 注意：注册应用程序之后，复制 Azure 管理门户的**“概览”**部分上的**“应用程序(客户端) ID”**和**“目录(租户) ID”**。在**“证书和密码”**部分创建客户端密码时，同样复制该密码。 + +3. 在 web.config 中，使用你在上一步中复制的值。将**“AAD:ClientID”**设置为客户端 ID，将**“AAD:ClientSecret”**设置为客户端密码，并将**“AAD:O365TenantID”**设置为租户 ID。 + +## 运行解决方案 + +1. 打开 Visual Studio 解决方案文件。 +2. 在**解决方案资源管理器**（而不是项目节点）中右键单击 **Outlook-Add-in-Microsoft-Graph-ASPNET** 解决方案，然后选择“**设置启动项目**”。选择“**多启动项目**”单选按钮。请确保先列出以“Web”结尾的项目。 +3. 在“**生成**”菜单上，选择“**清理解决方案**”。完成后，再次打开“**生成**”菜单，并选择“**生成解决方案**”。 +4. 在“**解决方案资源管理器**”中，选择“**Outlook-Add-in-Microsoft-Graph-ASPNET**”项目节点（而不是顶部的解决方案节点，也不是名称以“Web”结尾的项目）。 +5. 在**“属性”**窗格中，打开**“启动操作”**下拉列表，然后选择在桌面 Outlook 中，还是在列出的浏览器之一中的 Outlook 网页版中运行外接程序。（*请勿选择“Internet Explorer”。有关原因，请参阅以下**已知问题**。*） + + ![选择所需的 Oulook 主机：台式机或浏览器之一](images/StartAction.JPG) + +6. 按 F5。首次执行此操作时，系统将提示你指定用于调试外接程序的用户的电子邮件和密码。使用你的 O365 租户的管理员凭据。 + + ![带用户电子邮件和密码文本框的窗体](images/CredentialsPrompt.JPG) + + >注意：浏览器将打开 Office 网页版的登录页面。（因此，如果这是首次运行该外接程序，则将输入两次用户名和密码。） + +剩余步骤取决于你是在桌面 Outlook 还是 Outlook 网页版中运行外接程序。 + +### 在 Outlook 网页版中运行解决方案 + +1. 将在浏览器窗口中打开 Outlook 网页版。在 Outlook​​ 中，单击**“新建”**新建电子邮件。 +2. 撰写窗体下面是一个工具栏，包含用于**“发送”**、**“放弃”**和其他实用工具的按钮。根据你正在使用的 **Outlook 网页版**体验，该外接程序的图标位于此工具栏最右端附近，或者位于你单击此工具栏上的 **...** 按钮时将打开的下拉菜单上。 + + ![“插入文件外接程序”的图标](images/Onedrive_Charts_icon_16x16px.png) + +3. 单击此图标，打开任务窗格外接程序。 +4. 使用外接程序将用户的 OneDrive 帐户中的前三个工作簿的名称添加到邮件中。外接程序的页面和按钮一目了然。 + +## 在桌面版 Outlook 中运行项目。 + +1. 桌面版 Outlook 将打开。在 Outlook​​ 中，单击**“新建电子邮件”**新建电子邮件。 +2. 在**“邮件”**窗体的**“邮件”**功能区上，在名为“**OneDrive 文件**”的组中有一个标为“**打开外接程序**”的按钮。单击该按钮，打开外接程序。 +3. 使用外接程序将用户的 OneDrive 帐户中的前三个工作簿的名称添加到邮件中。外接程序的页面和按钮一目了然。 + +## 已知问题 + +* 结构微调控件仅暂时显示或根本不显示。 +* 如果你在 Internet Explorer 中运行，则当你尝试登录时，将收到一条错误消息，提示你必须将 `https://localhost:44301` 和 `https://outlook.office.com`（或者 `https://outlook.office365.com`）放在相同的安全区域中。但是即使你这样做，也会发生此错误。 + +## 问题和意见 + +我们希望得到你对*“使用 Microsoft Graph 和 MSAL 在 Outlook 外接程序中获取 Excel 工作簿”* 示例的相关反馈。可以在此存储库中的*“问题”*部分向我们发送反馈。 +与 Office 365 开发相关的问题一般应发布到 [Stack Overflow](http://stackoverflow.com/questions/tagged/Office365+API)。确保你的问题使用了 [office-js]、[MicrosoftGraph] 和 [API] 标记。 + +## 其他资源 + +* [Microsoft Graph 文档](https://docs.microsoft.com/graph/) +* [Office 外接程序文档](https://docs.microsoft.com/office/dev/add-ins/overview/office-add-ins) + +## 版权信息 +版权所有 (c) 2019 Microsoft Corporation。保留所有权利。 + +此项目已采用 [Microsoft 开放源代码行为准则](https://opensource.microsoft.com/codeofconduct/)。有关详细信息，请参阅[行为准则 FAQ](https://opensource.microsoft.com/codeofconduct/faq/)。如有其他任何问题或意见，也可联系 [opencode@microsoft.com](mailto:opencode@microsoft.com)。 + +