irvinesunday/android-java-meetingfeedback-rest-sample

This showcase sample accesses Microsoft calendar and email data so users can send anonymous feedback on the meetings they attend.

Office 365 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

• Android Studio version 1.0 or later.
• An Office 365 account. You can sign up for an Office 365 Developer subscription that includes the resources that you need to start building Office 365 apps. If you get a developer subscription you also get an Office 365 account.
• A client id and redirect uri values of an application registered in Azure. The application must run the Send mail as a user and Read user calendars permissions. You can also add a native client application in Azure and grant proper permissions to it.

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.
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.

   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

• Office 365 APIs platform overview
• Office 365 SDK for Android
• Get started with Office 365 APIs in apps
• Office 365 APIs starter projects and code samples
• Office 365 Connect sample for Android
• Office 365 Code Snippets for Android
• Office 365 APIs Starter Project for Android
• Office 365 Profile sample for Android

Copyright

Copyright (c) 2015 Microsoft. All rights reserved.