Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
56 changes: 56 additions & 0 deletions README-localized/README-es-es.md
Original file line number Diff line number Diff line change
@@ -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/)
56 changes: 56 additions & 0 deletions README-localized/README-fr-fr.md
Original file line number Diff line number Diff line change
@@ -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/)
56 changes: 56 additions & 0 deletions README-localized/README-ja-jp.md
Original file line number Diff line number Diff line change
@@ -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/)をフォローする
Loading