This showcase sample accesses Microsoft calendar and email data so users can send anonymous feedback on the meetings they attend.
Switch branches/tags
Nothing to show
Clone or download
Ricardo Loo
Ricardo Loo Merge pull request #16 from microsoftgraph/Telemetry
Added SampleID header
Latest commit 086dbd3 Aug 2, 2016

README.md

Office 365 Meeting Feedback sample for Android

Build Status

Meeting Feedback sample for Android

Meeting Feedback uses the Office 365 endpoints in the Microsoft Graph to retrieve calendar events and send email's in behalf of the signed in user.

Device requirements

To run the sample, your device needs to meet the following requirements:

  • Android API level 15 or later.

Prerequisites

The sample includes an Android client and a Ruby on Rails server-side component. You also must setup an alias from where your users can get email notifications.

Android client component

Ruby on Rails application component

  • Ruby 2.0.0
  • Ruby Development Kit (for Windows installations only)

Install the Ruby on Rails application

  1. Go to the webservice folder in the O365-Android_MeetingFeedback repository.

  2. Run the following commands to perform the following tasks:

    • Install the builder gem
    • Install the Meeting Feedback Ruby on Rails application
    • Create the Meeting Feedback database
    • Start the Meeting Feedback service on port 5000
gem install builder
bundle install
rake db:create && rake db:migrate && bundle exec foreman start -p 5000

Setup an email group to receive anonymous email notifications

The app sends an email notification to the meeting organizer when one of the meetings that he hosts gets reviewed. The email comes from a designated email address to keep the feedback anonymous. You must setup an Exchange group on Office 365 for this to work. To setup an Exchange group, follow these steps.

  1. Go to http://office.com and sign in with a tenant administrator.
  2. Click on the Admin tile.
  3. On the navigation bar, click Admin -> Exchange.
  4. Click groups in the recipients section.
  5. Click the plus sign to add a new security group.
  6. Add a display name, alias, and email address and save the group.
  7. Select the group and click the pencil icon to edit.
  8. Go to group delegation and give the users of the app the Send As permission as shown in the following picture. Office 365 Meeting Feedback sample
  9. Update the value of the REVIEW_SENDER_ADDRESS value in the Constants.java file to match the email address of your group.

Open the sample using Android Studio

  1. Install Android Studio and add the Android SDK packages according to the instructions on developer.android.com.

  2. Download or clone this sample.

  3. Start Android Studio.

    1. Select Open an existing Android Studio project.
    2. Browse to your local repository and select the O365-Android-MeetingFeedback project. Click OK.
  4. Open the Constants.java file.

    1. Find the SERVICE_ENDPOINT constant and set the value to the machine IP address and port where you're running the Ruby on Rails service.
    2. Find the CLIENT_ID constant and set its String value equal to the client id you registered in Azure Active Directory.
    3. Find the REDIRECT_URI constant and set its String value equal to the redirect URI you registered in Azure Active Directory. Office 365 Meeting Feedback sample

    Note: If you have don't have CLIENT_ID and REDIRECT_URI values, add a native client application in Azure and take note of the CLIENT_ID and REDIRECT_URI.

Once you've built the sample, you can run it on an emulator or device.

Contributing

If you'd like to contribute to this sample, see CONTRIBUTING.MD.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.

Questions and comments

We'd love to get your comments about the Office 365 Meeting Feedback sample. You can send your questions and suggestions to us in the Issues section of this repository.

Questions about Office 365 development in general should be posted to Stack Overflow. Make sure that your questions or comments are tagged with [Office365] and [API].

Do you want to read about our developer journey building this sample? Read our Medium article.

Additional resources

Copyright

Copyright (c) 2015 Microsoft. All rights reserved.