From d8c51cdadbde4004238ad5cd9ba7468ae8476cd6 Mon Sep 17 00:00:00 2001 From: OfficeGlobal Date: Wed, 18 Mar 2020 14:58:55 +0100 Subject: [PATCH] HB of localized readme files --- README-localized/README-es-es.md | 56 ++++++++++++++++++++++++++++++++ README-localized/README-fr-fr.md | 56 ++++++++++++++++++++++++++++++++ README-localized/README-ja-jp.md | 56 ++++++++++++++++++++++++++++++++ README-localized/README-pt-br.md | 56 ++++++++++++++++++++++++++++++++ README-localized/README-ru-ru.md | 56 ++++++++++++++++++++++++++++++++ README-localized/README-zh-cn.md | 56 ++++++++++++++++++++++++++++++++ 6 files changed, 336 insertions(+) create mode 100644 README-localized/README-es-es.md create mode 100644 README-localized/README-fr-fr.md create mode 100644 README-localized/README-ja-jp.md create mode 100644 README-localized/README-pt-br.md create mode 100644 README-localized/README-ru-ru.md create mode 100644 README-localized/README-zh-cn.md diff --git a/README-localized/README-es-es.md b/README-localized/README-es-es.md new file mode 100644 index 0000000..c28444c --- /dev/null +++ b/README-localized/README-es-es.md @@ -0,0 +1,56 @@ +# Muestras de los contactos de Python # + +Esta muestra es un proyecto en curso con dos objetivos principales: mostrarme cómo usar fácilmente la [API de Office 365](http://msdn.microsoft.com/en-us/office/office365/api/api-catalog) desde Python, y ayudarme a aprender sobre Python y Django. Puntos a tener en cuenta: + +- Soy un principiante con respecto a Python y Django. Aparte de la aplicación de "encuestas" creada como parte del [tutorial de Django](https://docs.djangoproject.com/en/1.7/intro/tutorial01/), esta es la primera aplicación en Python que hago. Por este motivo, puedo hacer cosas en un método de una manera "no del todo óptimo" desde la perspectiva de Python. No dude en hacerme saber. +- Decidí elegir como objetivo la [API de contactos](http://msdn.microsoft.com/office/office365/APi/contacts-rest-operations) para esta muestra. Sin embargo, la misma metodología debería funcionar con cualquiera de las API de REST. +- He usado el servidor de desarrollo de Django,así que no he probado esto en los servidores del nivel de producción. +- He usado la base de datos de prueba SQLite que fue creada con el proyecto de Django, así que todo lo almacenado en la base de datos está en un archivo local en el equipo de desarrollo. + +## Software necesario ## + +- [Python 3.4.2](https://www.python.org/downloads/) +- [Django 1.7.1](https://docs.djangoproject.com/en/1.7/intro/install/) +- [Requests: HTTP for Humans](http://docs.python-requests.org/en/latest/) + +## Ejecutar la muestra ## + +Antes de empezar, se presupone que tiene Python y Django instalados. Los usuarios de Windows deben agregar el directorio de instalación de Python y el subdirectorio Scripts a su variable de entorno PATH. + +1. Descargue o bifurque el proyecto de ejemplo. +2. Abra el símbolo del sistema o el Shell en el directorio donde se encuentra `manage.py`. +3. Si puede ejecutar archivos BAT, ejecute setup\_project.bat. Si no es así, ejecute los tres comandos en el archivo manualmente. El último comando le pedirá que cree un superusuario, que usará más tarde para iniciar sesión. +4. Instale el módulo de Requests: HTTP for Humans desde la línea de comandos: `pip install requests` +5. [Registre la aplicación en Azure Active Directory](https://github.com/jasonjoh/office365-azure-guides/blob/master/RegisterAnAppInAzure.md). La aplicación tiene que registrarse como una aplicación web con la dirección URL de inicio de sesión de "http://127.0.0.1:8000/contacts", y se le deben conceder los permiso para "leer los contactos de los usuarios". +6. Edite el archivo `.\contacts\clientreg.py`. Copie la Id. de cliente de la aplicación obtenido durante el registro de la misma y péguelo como valor de la variable `Id`. Copie la clave creada durante el registro de la aplicación y péguela como valor de la variable `secreta`. Guarde el archivo. +7. Inicie el servidor de desarrollo: `python manage.py runserver` +8. Debe ver un resultado como el siguiente: +Realizando las comprobaciones del sistema... + + La comprobación del sistema no encontró ningún problema (0 silenciados). + 18 de diciembre de 2014 - 12:36:32 versión de Django 1.7.1, + usando la configuración 'pythoncontacts.settings' + iniciando el servidor de desarrollo en http://127.0.0.1:8000/ + Salga del servidor con Ctrl+Interrumpir. +9. Use el explorador para ir a http://127.0.0.1:8000/contacts. +10. Inicie sesión con su cuenta de superusuario. +11. Ahora, se le pedirá que conecte su cuenta de Office 365. Haga clic en el vínculo para hacer esto e inicie sesión con una cuenta de Office 365. +12. Debería ver una tabla que enumera los contactos existentes en su cuenta de Office 365. Puede hacer clic en el botón "contacto nuevo" para realizar esta acción o usar los botones "editar" o "eliminar" en los contactos existentes. +13. Si quiere ver la información que se almacena en la base de datos para el usuario de Django, también puede ir a http://127.0.0.1:8000/admin y hacer clic en el vínculo de conexiones de Office365. En caso de que quiera volver a pasar por el proceso de consentimiento también puede eliminar el registro del usuario del sitio de administración. + +## Historial de publicaciones ## + +Para obtener una versión de lanzamiento específica, vaya a https://github.com/jasonjoh/pythoncontacts/releases + +- **1.2: Funciones de correo y calendario.** El módulo o365service ahora tiene algunas funcionalidades de API del correo y el calendario. Sin interfaz de usuario para estas funciones, pero pueden ser llamadas a través de las nuevas clases de prueba agregadas a test.py. También se agregó una marca para deshabilitar la validación de certificados SSL para que pueda capturar solicitudes y respuestas con Fiddler. ([Entrada del blog](http://blogs.msdn.com/b/exchangedev/archive/2015/01/15/office-365-apis-and-python-part-3-mail-and-calendar-api.aspx)) +- **1.1: Funciones de contacto.** La aplicación ahora muestra una lista de contactos y permite al usuario crear nuevos contactos y editar o eliminar los existentes. ([Entrada del blog](http://blogs.msdn.com/b/exchangedev/archive/2015/01/09/office-365-apis-and-python-part-2-contacts-api.aspx)) +- **1.0: Versión inicial.** La aplicación permite que el usuario conecte una cuenta de Office 365 con una cuenta de aplicación local. La aplicación utiliza el código OAuth2 para garantizar el flujo y mostrar el token de acceso del usuario. ([Entrada del blog](http://blogs.msdn.com/b/exchangedev/archive/2015/01/05/office-365-apis-and-python-part-1-oauth2.aspx)) + +## Derechos de autor ## + +Copyright (c) Microsoft. Todos los derechos reservados. + +---------- +Conectar conmigo en Twitter [@JasonJohMSFT](https://twitter.com/JasonJohMSFT) + +Seguir el [blog de desarrollo de Exchange](http://blogs.msdn.com/b/exchangedev/) \ No newline at end of file diff --git a/README-localized/README-fr-fr.md b/README-localized/README-fr-fr.md new file mode 100644 index 0000000..0251870 --- /dev/null +++ b/README-localized/README-fr-fr.md @@ -0,0 +1,56 @@ +# Exemple de contacts Python # + +Cet exemple est un projet en cours avec deux objectifs principaux : montrer comment utiliser facilement les [API Office 365](http://msdn.microsoft.com/en-us/office/office365/api/api-catalog) depuis Python et m’assister dans ma découverte de Python et Django. Quelques points à garder à l’esprit : + +- Je suis un parfait débutant en Python et Django. À part l’application « sondages » créée dans le cadre du [Tutorial Django](https://docs.djangoproject.com/en/1.7/intro/tutorial01/), ceci est ma toute première application Python. Pour cette raison, je serai peut-être amené à faire des choses de manière « moins qu’optimale » d’un point de vue Python. N’hésitez pas à me le faire savoir ! +- J’ai choisi de cibler l’[API Contacts](http://msdn.microsoft.com/office/office365/APi/contacts-rest-operations) pour cet exemple. Cependant, la même méthodologie devrait fonctionner pour n’importe quelle API REST. +- J’ai utilisé le serveur de développement Django intégré, je n’ai pas testé ceci avec les serveurs de niveau de production. +- J’ai utilisé la base de données de test SQLite qui a été créée avec le projet Django, donc tout ce qui reçoit une base de données stockée se trouve dans un fichier local sur votre ordinateur de développement. + +## Logiciels requis ## + +- [Python 3.4.2](https://www.python.org/downloads/) +- [Django 1.7.1](https://docs.djangoproject.com/en/1.7/intro/install/) +- [Requests : HTTP for Humans](http://docs.python-requests.org/en/latest/) + +## Exécution de l’exemple ## + +Il est supposé que Python et Django sont installés avant de commencer. Les utilisateurs de Windows doivent ajouter le répertoire d'installation Python et le sous-répertoire Scripts à leur variable d'environnement PATH. + +1. Téléchargez ou dupliquez l’exemple de projet. +2. Ouvrez votre invite de commandes ou votre shell dans le répertoire dans lequel se trouve `manage.py`. +3. Si vous pouvez exécuter des fichiers BAT, exécutez setup\_project. bat. Si ce n’est pas le cas, exécutez manuellement les trois commandes dans le fichier. La dernière commande vous invite à créer un superutilisateur que vous utiliserez par la suite pour vous connecter. +4. Installez la bibliothèque Requests : HTTP for Humans depuis la ligne de commande : `pip install requests` +5. [Inscrivez l’application dans Azure Active Directory](https://github.com/jasonjoh/office365-azure-guides/blob/master/RegisterAnAppInAzure.md). L’application doit être inscrite en tant qu’application Web avec l’URL de connexion « http://127.0.0.1:8000/contacts », et vous devez disposer de l’autorisation « Lire les contacts des utilisateurs ». +6. Modifiez le fichier `.\contacts\clientreg.py`. Copiez l’ID client de votre application obtenue durant l’inscription de l’application et collez-le à l’emplacement de la valeur correspondant à la variable `id`. Copiez la clé créée durant l’inscription de l’application et collez-la à l’emplacement de la valeur correspondant à la variable `secret`. Enregistrez le fichier. +7. Démarrez le serveur de développement : `python manage.py runserver` +8. Vous devriez voir une sortie comme celle-ci : +Exécution de vérifications système... + + La vérification système n’a identifié aucun problème (0 silencieux). + 18 décembre 2014 – 12:36:32 Django version 1.7.1, + avec les paramètres « pythoncontacts.settings » + Démarrage du serveur de développement sur http://127.0.0.1:8000/ + Quittez le serveur avec la combinaison de touches CTRL + PAUSE. +9. Utilisez votre navigateur pour accéder à http://127.0.0.1:8000/contacts. +10. Connectez-vous avec votre compte de superutilisateur. +11. Vous devez maintenant être invité à vous connecter à votre compte Office 365. Cliquez sur le lien pour le faire et connectez-vous avec un compte Office 365. +12. Un tableau répertoriant les contacts existants dans votre compte Office 365 doit s’afficher. Vous pouvez cliquer sur le bouton « Nouveau contact » pour créer un contact, ou utiliser les boutons « Modifier » ou « Supprimer » dans les contacts existants. +13. Si vous voulez voir ce qui est stocké dans la base de données Django pour l’utilisateur, accédez à http://127.0.0.1:8000/admin et cliquez sur le lien Connexions Office 365. Vous pouvez également supprimer l’enregistrement de l’utilisateur depuis le site d’administration, au cas où vous voudriez repasser le processus de consentement. + +## Historique des versions ## + +Pour obtenir une version spécifique, accédez à https://github.com/jasonjoh/pythoncontacts/releases + +- **1.2 : Fonctions Messagerie et Calendrier.** Le module o365service inclut désormais une fonctionnalité API de messagerie et API de calendrier. Il n’y a aucune interface utilisateur pour ces fonctions, mais elles peuvent être invoquées via les nouvelles classes de test ajoutées à test.py. Également ajouté : un indicateur pour désactiver la validation de certificat SSL pour pouvoir capturer les requêtes et les réponses avec Fiddler. ([Billet de blog](http://blogs.msdn.com/b/exchangedev/archive/2015/01/15/office-365-apis-and-python-part-3-mail-and-calendar-api.aspx)) +- **1.1 : Fonctions de contact.** L’application affiche désormais une liste de contacts et autorise l’utilisateur à créer de nouveaux contacts ainsi que de modifier ou supprimer des contacts existants. ([Billet de blog](http://blogs.msdn.com/b/exchangedev/archive/2015/01/09/office-365-apis-and-python-part-2-contacts-api.aspx)) +- **1.0 : Version initiale.** L’application permet à l’utilisateur de se connecter à un compte Office 365 avec un compte d’application local. L’application effectue un flux d’octroi de code Oauth2 et affiche le jeton d’accès de l’utilisateur. ([Billet de blog](http://blogs.msdn.com/b/exchangedev/archive/2015/01/05/office-365-apis-and-python-part-1-oauth2.aspx)) + +## Copyright ## + +Copyright (c) Microsoft. Tous droits réservés. + +---------- +Suivez-moi sur Twitter [@JasonJohMSFT](https://twitter.com/JasonJohMSFT) + +Suivez le [blog de développement Exchange](http://blogs.msdn.com/b/exchangedev/) \ No newline at end of file diff --git a/README-localized/README-ja-jp.md b/README-localized/README-ja-jp.md new file mode 100644 index 0000000..639c6d6 --- /dev/null +++ b/README-localized/README-ja-jp.md @@ -0,0 +1,56 @@ +# Python 連絡先サンプル # + +このサンプルは、2 つの主な目標を持つ進行中のプロジェクトです。それは、Python から [Office 365 API](http://msdn.microsoft.com/en-us/office/office365/api/api-catalog) を簡単に利用する方法を示し、Python と Dango の学習を支援することです。注意すべきことがいくつかあります。 + +- 私は Python と Django の初心者です。[Django チュートリアル](https://docs.djangoproject.com/en/1.7/intro/tutorial01/)の一部として作成された「投票」アプリ以外に、これは私の初めての Python アプリです。そのため、Python の観点からして「最適ではない」方法で物事を勧めるかもしれません。その場合は、教えてください。 +- このサンプルでは、[連絡先 API](http://msdn.microsoft.com/office/office365/APi/contacts-rest-operations) を対象にしています。ただし、REST API でも同じ方法を使用できます。 +- 組み込みの Django 開発サーバーを使用していたので、運用レベルのサーバーではテストしていません。 +- Django プロジェクトを使用して作成された SQLite テスト データベースを使用していたため、保存されたデータベースを取得するものはすべて、開発マシンのローカル ファイルにあります。 + +## 必要なソフトウェア ## + +- [Python 3.4.2](https://www.python.org/downloads/) +- [Django 1.7.1](https://docs.djangoproject.com/en/1.7/intro/install/) +- [共有s:HTTP for Humans](http://docs.python-requests.org/en/latest/) + +## サンプルの実行 ## + +始める前に、Python と Django がインストールされていると仮定します。Windows ユーザーは、Python インストール ディレクトリと Scripts サブディレクトリを PATH 環境変数に追加する必要があります。 + +1. サンプル プロジェクトをダウンロードまたは分岐します。 +2. `manage.py` が存在するディレクトリに、コマンド プロンプトまたはシェルを開きます。 +3. BAT ファイルを実行できる場合は、setup\_project.bat を実行します。それ以外の場合は、手動で 3 つのコマンドを実行します。最後のコマンドでは、後でログオンするために使用するスーパーユーザーを作成するように求められます。 +4. インストールを要求します。コマンド ラインからの HTTP for Humans モジュール: `pip install requests` +5. [Azure Active Directory にアプリを登録します](https://github.com/jasonjoh/office365-azure-guides/blob/master/RegisterAnAppInAzure.md)。アプリは、サインオン URL が「http://127.0.0.1:8000/contacts」の Web アプリとして登録する必要があり、「ユーザーの連絡先を読み取る」権限を付与する必要があります。 +6. `.\contacts\clientreg.py` ファイルを編集します。アプリの登録時に取得したアプリのクライアント ID をコピーし、`ID` 変数の値として貼り付けます。アプリの登録時に作成したキーをコピーし、`秘密情報`変数の値として貼り付けます。ファイルを保存します。 +7. 開発サーバーを起動します。`python manage.py runserver` +8. 出力は次のようになります。 +システム チェックを実行します... + + システム チェックで問題が特定されませんでした (0 が無音)。 + 2014 年 12 月 18 日 - 12:36:32 + Django バージョン 1.7.1、 設定「pythoncontacts.settings」 + を使用 http://127.0.0.1:8000/ + で開発サーバーを起動 CTRL-BREAK でサーバーを終了。 +9. ブラウザーを使用して http://127.0.0.1:8000/contacts に移動します。 +10. スーパーユーザー アカウントでログインします。 +11. Office 365 アカウントに接続するように求められます。リンクをクリックして、Office 365 アカウントでログインします。 +12. Office 365 アカウントの既存の連絡先を一覧表示した表が表示されます。\[新しい連絡先] ボタンをクリックして、新しい連絡先を作成するか、既存の連絡先の \[編集] または \[削除] ボタンを使用します。 +13. ユーザーの Django データベースに保存されている内容を表示するには、http://127.0.0.1:8000/admin に移動してから、Office365 の接続リンクをクリックします。同意プロセスを再度実行する場合に備えて、管理サイトからユーザーの記録を削除することもできます。 + +## リリース履歴 ## + +特定のリリース バージョンを取得するには、https://github.com/jasonjoh/pythoncontacts/releases にアクセスしてください。 + +- **1.2:メールおよび予定表の機能。**o365service モジュールには、いくつかのメール API および予定表 API 機能があります。これらの機能に UI はありませんが、test.py に追加された新しいテスト クラスを使用して呼び出すことができます。また、Fiddler を使用して要求や応答をキャプチャできるように、SSL 証明書の検証を無効にするフラグを追加しました。([ブログ投稿](http://blogs.msdn.com/b/exchangedev/archive/2015/01/15/office-365-apis-and-python-part-3-mail-and-calendar-api.aspx)) +- **1.1:連絡先の機能。**これで、連絡先の一覧が表示され、ユーザーは新しい連絡先を作成したり、既存の連絡先を編集または削除したりできます。([ブログ投稿](http://blogs.msdn.com/b/exchangedev/archive/2015/01/09/office-365-apis-and-python-part-2-contacts-api.aspx)) +- **1.0:最初のリリース。**アプリは、ユーザーが Office 365 アカウントをローカル アプリ アカウントに接続できるようにします。アプリは OAuth2 コード付与フローを実行し、ユーザーのアクセス トークンを表示します。([ブログ投稿](http://blogs.msdn.com/b/exchangedev/archive/2015/01/05/office-365-apis-and-python-part-1-oauth2.aspx)) + +## 著作権 ## + +Copyright (c) Microsoft.All rights reserved. + +---------- +Twitter ([@JasonJohMSFT](https://twitter.com/JasonJohMSFT)) でぜひフォローしてください。 + +[Exchange 開発ブログ](http://blogs.msdn.com/b/exchangedev/)をフォローする \ No newline at end of file diff --git a/README-localized/README-pt-br.md b/README-localized/README-pt-br.md new file mode 100644 index 0000000..da1c819 --- /dev/null +++ b/README-localized/README-pt-br.md @@ -0,0 +1,56 @@ +# Exemplo de Contatos do Python # + +Este exemplo é um projeto em andamento com dois objetivos principais: mostrar como usar facilmente as [APIs do Office 365](http://msdn.microsoft.com/en-us/office/office365/api/api-catalog) do Python e me ajudar a aprender o Python e Django. Alguns pontos para lembrar: + +- Eu sou um iniciante em Python e Django. Além do aplicativo de "votações" criado como parte do [tutorial do Django](https://docs.djangoproject.com/en/1.7/intro/tutorial01/), esse é o meu primeiro aplicativo Python. Por isso, posso fazer as coisas de uma maneira "inadequada", de uma perspectiva do Python. Sinta-se livre para me avisar! +- Eu escolhi segmentar a [API de Contatos](http://msdn.microsoft.com/office/office365/APi/contacts-rest-operations) para este exemplo. No entanto, a mesma metodologia deve funcionar para qualquer uma das APIs REST. +- Usei o servidor de desenvolvimento interno do Django, portanto não testei isso com nenhum servidor em nível de produção. +- Usei o banco de dados de teste SQLite que é criado com o projeto Django, portanto, qualquer coisa que possua um banco de dados armazenado está em um arquivo local na sua máquina de desenvolvimento. + +## Software necessário ## + +- [Python 3.4.2](https://www.python.org/downloads/) +- [Django 1.7.1](https://docs.djangoproject.com/en/1.7/intro/install/) +- [Solicitações: HTTP for Humans](http://docs.python-requests.org/en/latest/) + +## Execução da amostra ## + +Presume-se que você tenha o Python e o Django instalados antes de começar. Os usuários do Windows devem adicionar a pasta de instalação do Python e o subdiretório Scripts à variável de ambiente PATH. + +1. Baixe ou bifurque o projeto de exemplo. +2. Abra o seu prompt de comando ou o Shell no diretório onde `manage.py` está localizado. +3. Se você puder executar arquivos BAT, execute setup\_project. bat. Caso contrário, execute os três comandos automaticamente no arquivo. O último comando solicitará que você crie um superusuário, que será usado mais tarde para fazer logon. +4. Instale as Solicitações: o modulo HTTP for Humans na linha de comando: `pip install requests` +5. [Registrar o aplicativo no Azure Active Directory](https://github.com/jasonjoh/office365-azure-guides/blob/master/RegisterAnAppInAzure.md). O aplicativo deve ser registrado como um aplicativo Web com um URL de Logon "http://127.0.0.1:8000/contacts" e deve ter permissão para "Ler os contatos dos usuários". +6. Edite o arquivo `.\contacts\clientreg.py`. Copie a ID do cliente obtida durante o registro do aplicativo e cole-a como o valor da variável `id`. Copie a chave criada durante o registro do aplicativo e cole-a como o valor da variável `segredo`. Salve o arquivo. +7. Inicie o servidor de desenvolvimento: `python manage.py runserver` +8. Você deve ver um resultado como: +Executando verificações do sistema... + + A verificação do sistema não identificou nenhum problema (0 silenciado). + 18 de dezembro de 2014 - 12:36:32 + Django versão 1.7.1, usando as configurações 'pythoncontacts.settings' + Iniciando servidor de desenvolvimento em http://127.0.0.1:8000/ + Encerre o servidor com CTRL-BREAK. +9. Use seu navegador para acessar http://127.0.0.1:8000/contacts. +10. Entre com sua conta de superusuário. +11. Agora você deve ser solicitado a conectar sua conta do Office 365. Clique no link para fazer isso e entre com uma conta do Office 365. +12. Você deve ver uma tabela listando os contatos existentes na sua conta do Office 365. Você pode clicar no botão "Novo Contato" para criar um novo contato ou usar os botões "Editar" ou "Excluir" nos contatos existentes. +13. Se você quiser ver o que é armazenado no banco de dados Django para o usuário, acesse também http://127.0.0.1:8000/admin e clique no link de conexões do Office365. Você também pode excluir o registro do usuário do site de administração, caso queira passar pelo processo de consentimento novamente. + +## Histórico de versões ## + +Para obter uma versão específica do lançamento, acesse https://github.com/jasonjoh/pythoncontacts/releases + +- **1.2: Funções de Email e Calendário.** O módulo o365service agora possui algumas funcionalidades da API de Email e da API de Calendário. Não há interface do usuário para essas funções, mas elas podem ser invocadas pelas novas classes de teste adicionadas ao test.py. Também foi adicionado um sinalizador para desativar a validação do certificado SSL, para que você possa capturar solicitações e respostas com o Fiddler. ([Postagem no Blog](http://blogs.msdn.com/b/exchangedev/archive/2015/01/15/office-365-apis-and-python-part-3-mail-and-calendar-api.aspx)) +- **1.1: Funções de contato.** O aplicativo agora exibe uma lista de contatos e permite ao usuário criar novos contatos e editar ou excluir os existentes. ([Postagem no Blog](http://blogs.msdn.com/b/exchangedev/archive/2015/01/09/office-365-apis-and-python-part-2-contacts-api.aspx)) +- **1.0: Versão inicial.** O aplicativo permite que o usuário conecte uma conta do Office 365 a uma conta do aplicativo local. O aplicativo concede fluxo de concessão do código OAuth2 e exibe o token de acesso do usuário. ([Postagem no Blog](http://blogs.msdn.com/b/exchangedev/archive/2015/01/05/office-365-apis-and-python-part-1-oauth2.aspx)) + +## Direitos Autorais ## + +Copyright (c) Microsoft. Todos os direitos reservados. + +---------- +Conecte-se comigo no Twitter [@JasonJohMSFT](https://twitter.com/JasonJohMSFT) + +Siga o [Blog de desenvolvedores do Exchange](http://blogs.msdn.com/b/exchangedev/) \ No newline at end of file diff --git a/README-localized/README-ru-ru.md b/README-localized/README-ru-ru.md new file mode 100644 index 0000000..9de75f4 --- /dev/null +++ b/README-localized/README-ru-ru.md @@ -0,0 +1,56 @@ +# Пример использования API контактов в Python # + +Этот пример представляет собой текущий проект, направленный на достижение двух целей: показать, как просто пользоваться [API Office 365](http://msdn.microsoft.com/en-us/office/office365/api/api-catalog) c Python и помочь мне изучить Python и Django. Несколько важных примечаний: + +- Я — абсолютный новичок в Python и Django. Если не считать приложение для проведения опросов, которое входит в [Руководство по Django](https://docs.djangoproject.com/en/1.7/intro/tutorial01/), это мое первое приложение Python. Поэтому мои решения могут оказываться не самыми оптимальными с точки зрения Python. Буду благодарен за замечания по этому поводу! +- Для этого примера я решил использовать [API контактов](http://msdn.microsoft.com/office/office365/APi/contacts-rest-operations). Однако такая методология будет работать для всех API REST. +- Я использовал встроенный сервер разработки Django, и этот пример еще не тестировался на производственных серверах. +- Я использовал тестовую базу данных, которая появилась при создании проекта Django, поэтому все, что сохраняется в качестве базы данных — это локальный файл на компьютере разработчика. + +## Необходимое программное обеспечение ## + +- [Python 3.4.2](https://www.python.org/downloads/) +- [Django 1.7.1](https://docs.djangoproject.com/en/1.7/intro/install/) +- [Запросы: HTTP for Humans](http://docs.python-requests.org/en/latest/) + +## Запуск примера ## + +Предполагается, что вы установили Python и Django перед началом. Пользователям Windows следует добавить каталог установки и подкаталог сценариев Python в переменную среду PATH. + +1. Скачайте проект приложения или создайте вилку. +2. Откройте командную строку или оболочку в каталоге, в котором находится `manage.py`. +3. Если возможно запускать файлы BAT, запустите setup\_project. bat. Если нет, запустите три команды в файле вручную. Последняя команда предложит вам создать суперпользователь, для входа в систему позже. +4. Установите библиотеку Requests: Модуль HTTP for Humans из командной строки: `pip install requests` +5. [Зарегистрируйте приложение в Azure Active Directory](https://github.com/jasonjoh/office365-azure-guides/blob/master/RegisterAnAppInAzure.md). Приложение нужно регистрировать как веб-приложение с URL-адресом для входа "http://127.0.0.1:8000/contacts", при этом нужно предоставить разрешение на "Чтение контактов пользователей". +6. Измените файл `.\contacts\clientreg.py`. Скопируйте идентификатор клиента, полученный при регистрации приложения, и вставьте его в качестве значения переменной `id`. Скопируйте ключ, созданный при регистрации приложения, и вставьте его в качестве значения переменной `secret`. Сохраните файл. +7. Запустите сервер разработки: `python manage.py runserver` +8. Вы увидите: +Выполнение системных проверок... + + Проверка системы не обнаружила ошибок (0). + 18 декабря 2014 г. 12:36:32 + Django версии 1.7.1, использованы параметры 'pythoncontacts.settings' + Запуск сервера разработки на http://127.0.0.1:8000/ + Выход с сервера с помощью CTRL-BREAK. +9. Перейдите на страницу http://127.0.0.1:8000/contacts, используя браузер. +10. Войдите в свою учетную запись суперпользователя. +11. Появится предложение о подключении учетной записи Office 365. Нажмите на ссылку, чтобы подтвердить это действие, и войдите через свою учетную запись Office 365. +12. Отобразится таблица со списком контактов, имеющихся в вашей учетной записи Office 365. Создать новый контакт можно, щелкнув кнопку "Создать контакт". Имеющиеся контакты можно "Редактировать" или "Удалить" с помощью соответствующих кнопок. +13. Чтобы узнать, что хранится в базе данных Django пользователя, перейдите на http://127.0.0.1:8000/admin и щелкните ссылку подключений Office 365. Запись пользователя с сайта администратора можно удалить, если процесс подтверждения необходимо пройти заново. + +## Журнал выпусков ## + +Любую конкретную версию выпуска можно найти здесь: https://github.com/jasonjoh/pythoncontacts/releases + +- **1.2: Функции Почты и Календаря.** В модуль службы o365 теперь включен определенный функционал API Почты и API Календаря. Эти функции не отображаются в пользовательском интерфейсе, но их можно вызвать с помощью новых тестовых классов, добавленных в test.py. Кроме того, добавлены отметки для отключения проверки SSL-сертификата, чтобы можно было записывать запросы и ответы с помощью Fiddler. ([Запись блога](http://blogs.msdn.com/b/exchangedev/archive/2015/01/15/office-365-apis-and-python-part-3-mail-and-calendar-api.aspx)) +- **1.1: Функции Контактов.** Теперь в приложении содержится список контактов, и пользователь может создавать новые контакты и редактировать или удалять существующие. ([Запись блога](http://blogs.msdn.com/b/exchangedev/archive/2015/01/09/office-365-apis-and-python-part-2-contacts-api.aspx)) +- **1.0: Первый выпуск.** Через приложение пользователь может связать учетную запись Office 365 c локальной учетной записью в приложении. Приложение создает поток предоставления кода OAuth2 и выводит маркер доступа для пользователя. ([Запись блога](http://blogs.msdn.com/b/exchangedev/archive/2015/01/05/office-365-apis-and-python-part-1-oauth2.aspx)) + +## Авторские права ## + +(c) Корпорация Майкрософт (Microsoft Corporation). Все права защищены. + +---------- +Работайте со мной на сайте Twitter [@JasonJohMSFT](https://twitter.com/JasonJohMSFT) + +Следуйте инструкциям в [блоге разработчиков Exchange](http://blogs.msdn.com/b/exchangedev/) \ No newline at end of file diff --git a/README-localized/README-zh-cn.md b/README-localized/README-zh-cn.md new file mode 100644 index 0000000..6e9c815 --- /dev/null +++ b/README-localized/README-zh-cn.md @@ -0,0 +1,56 @@ +# Python 联系人示例 # + +该示例是一个正在进行的项目，其主要目标有两个：演示如何轻松使用 Python 中的 [Office 365 API](http://msdn.microsoft.com/en-us/office/office365/api/api-catalog)，以及帮助我学习 Python 和 Django。需要考虑的几个事项： + +- 对于 Python 和 Django，我完全是一个新手。除了作为 [Django 教程](https://docs.djangoproject.com/en/1.7/intro/tutorial01/)的一部分创建的“投票”应用之外，这是我有史以来的第一个 Python 应用。因此，从 Python 的角度来看，我可能会以一种“不太理想”的方式做事。请随时让我知道！ +- 我选择设定此示例的[联系人 API](http://msdn.microsoft.com/office/office365/APi/contacts-rest-operations)。但是，此方法对任何 REST API 均适用。 +- 我使用的是内置 Django 开发服务器，因此尚未在任何生产级服务器上测试过它。 +- 我使用在 Django 项目中创建的 SQLite 测试数据库，因此存储的任何数据库内容都位于开发计算机上的本地文件中。 + +## 所需软件 ## + +- [Python 3.4.2](https://www.python.org/downloads/) +- [Django 1.7.1](https://docs.djangoproject.com/en/1.7/intro/install/) +- [请求：HTTP for Humans](http://docs.python-requests.org/en/latest/) + +## 运行示例 ## + +在开始之前，假定你已安装了 Python 和 Django。Windows 用户应将 Python 安装目录和脚本子目录添加到其 PATH 环境变量中。 + +1. 下载示例项目或为其创建分支。 +2. 在 `manage.py` 所在的目录中打开命令提示符或 shell。 +3. 如果可以运行 BAT 文件，请运行 setup\_project.bat。如果没有，请手动运行文件中的三个命令。最后一个命令将提示你创建超级用户，稍后将使用它登录。 +4. 安装请求：来自命令行的 HTTP for Humans 模块：`pip install requests` +5. [在 Azure Active Directory 中注册应用](https://github.com/jasonjoh/office365-azure-guides/blob/master/RegisterAnAppInAzure.md)。应将应用注册为具有“http://127.0.0.1:8000/contacts”登录 URL 的 Web 应用，并应授予“读取用户联系人”的权限。 +6. 编辑 `.\contacts\clientreg.py` 文件。复制在应用注册期间获取的应用的客户端 ID，并将其粘贴为 `id` 变量的值。复制在应用注册期间创建的密钥，并将其粘贴为 `secret` 变量的值。保存文件。 +7. 启动开发服务器：`python manage.py runserver` +8. 你应该会看到如下所示的输出： +正在执行系统检查... + + 系统检查未发现任何问题（0 静默）。 + 2014 年 12 月 18 日 - 12:36:32 + Django 版本 1.7.1，使用设置“pythoncontacts.settings” + 在 http://127.0.0.1:8000/ 上启动开发服务器 + 使用 CTRL-BREAK 退出服务器。 +9. 使用浏览器访问 http://127.0.0.1:8000/contacts。 +10. 使用你的超级用户帐户登录。 +11. 此时系统会提示你连接 Office 365 帐户。单击该链接以执行此操作并使用 Office 365 帐户登录。 +12. 你将看到一个表，其中列出了 Office 365 帐户中的现有联系人。你可以单击“新建联系人”按钮来创建新联系人，或使用现有联系人上的“编辑”或“删除”按钮。 +13. 如果要查看该用户存储在 Django 数据库中的内容，也请访问 http://127.0.0.1:8000/admin，然后单击 Office365 连接链接。你也可以从管理网站中删除用户的记录，以防再次经历同意流程。 + +## 发布历史记录 ## + +若要获取特定发布版本，请访问 https://github.com/jasonjoh/pythoncontacts/releases + +- **1.2：邮件和日历功能。**o365service 模块现在具有某些邮件 API 和日历 API 功能。这些功能没有 UI，但是可以通过添加到 test.py 的新测试类来调用它们。此外还添加了一个用于禁用 SSL 证书验证的标志，以便你能够使用 Fiddler 捕获请求和响应。（[博客文章](http://blogs.msdn.com/b/exchangedev/archive/2015/01/15/office-365-apis-and-python-part-3-mail-and-calendar-api.aspx)） +- **1.1：联系人功能。**现在，应用将显示联系人列表，并允许用户创建新联系人以及编辑或删除现有联系人。（[博客文章](http://blogs.msdn.com/b/exchangedev/archive/2015/01/09/office-365-apis-and-python-part-2-contacts-api.aspx)） +- **1.0：初始发行版。**应用允许用户使用本地应用帐户连接 Office 365 帐户。应用可执行 OAuth2 代码授予流程并显示用户的访问令牌。（[博客文章](http://blogs.msdn.com/b/exchangedev/archive/2015/01/05/office-365-apis-and-python-part-1-oauth2.aspx)） + +## 版权信息 ## + +版权所有 (c) Microsoft。保留所有权利。 + +---------- +在 Twitter 上通过 [@JasonJohMSFT](https://twitter.com/JasonJohMSFT) 与我联系 + +关注 [Exchange 开发人员博客](http://blogs.msdn.com/b/exchangedev/) \ No newline at end of file