An Expense Manager scenario with a App for SharePoint with a Provider Hosted AngularJS backend.
JavaScript C# HTML CSS ASP
Switch branches/tags
Nothing to show
Clone or download

readme.md

Expense Manager with AngularJS, SharePoint/Office 365 and Microsoft Azure Active Directory

If you're new to AngularJS check out the AngularJS in 60-ish Minutes video tutorial or download the free eBook. Also check out The AngularJS Magazine for up-to-date information on using AngularJS to build Single Page Applications (SPAs).

A presentation on all samples can be found in the presentation folder within this repository.

PowerPoint slide titled Expenses Manager Code Sample with AngularJS and Office 365 APIs by Jeremy Thake Technical Product Manager Microsoft Corporation

An on-demand web cast recorded by Jeremy Thake can be found on Channel 9.

This application is a stand-alone AngularJS application that performs CRUD operations against SharePoint/Office 365. Authentication relies on Microsoft Azure Active Directory. This application demonstrates:

  • Consuming data provided by SharePoint/Office 365 RESTful APIs
  • Authentication against Microsoft Azure Active Directory
  • A custom "middle-man" proxy that allows cross-domain calls to be made to SharePoint/Office 365
  • A complete application with read-only and editable data
  • Using AngularJS with $http in a factory to access a backend RESTful service
  • Techniques for showing multiple views of data (card view and list view)
  • Custom filters for filtering customer and product data
  • A custom directive to ensure unique values in a form for email
  • A custom directive that intercepts $http and jQuery XHR requests (in case either are used) and displays a loading dialog
  • A custom directive that handles highlighting menu items automatically based upon the path navigated to by the user
  • Form validation using AngularJS

Application page for Expense Management employees list view

Prerequisites

  • Azure subscription (trial will work)
  • Office 365 tenant
  • SharePoint site collection in your Office 365 tenant

Office 365 and SharePoint Setup

Following are the steps to upload the ExpensesTrackerSiteTemplate.wsp template into an existing Office 365/SharePoint site collection solution folder. Then create a Site instance within that site collection based on that site template called "Expense Tracker Site Template". This will create an Expenses site with 3 lists for employees, expenses, and states.

  1. Go To the Admin Screen

    Active Directory

  2. Create a new Site Collection

    Active Directory

  3. Fill in New Site Collection Form, select template later under the custom tab for the template of the top level site.

    Active Directory

  4. Click on the Solution Gallery Link.

    Active Directory

  5. Click the Upload Solution icon in the ribbon.

    Active Directory

  6. Browse to the .wsp file included in the package. (in this case it is the expenses.wsp) and upload the solution.

    Active Directory

  7. Activate the Solution.

    Active Directory

  8. Click the Browse tab to get back to the home page.

    Active Directory

  9. Click the Custom tab.

    Active Directory

  10. Select the Expenses (the one you uploaded and activated) solution and click OK.

    Active Directory

  11. Set the default SharePoint Security Groups. Sometimes they line up perfectly, sometimes you might have to line them up with the drop down menu.

    Active Directory

  12. Browse to the Home Page.

    Active Directory

  13. If needed click on Site Contents to see the lists.

Azure and Application Setup

To get the application running you'll need to do the following:

  1. Login to your Azure Management Portal and select Active Directory from the left menu.

    Active Directory

  2. Click on the directory you'd like to use (Default Directory will work fine)

    Active Directory

  3. Click the "Add an application you're developing" link

  4. Give the application a name of Expense Manager:

    Active Directory

  5. Click the arrow to go to the next screen and enter the following for the information in the screen. Substitute your Office 365 Tenant ID for YOUR_TENANT:

    Active Directory

  6. Press the Complete button in the wizard to create the application.

  7. Click the CONFIGURE link at the top of the Expense Manager application screen.

  8. Scroll to the "keys" section and select 1 year from the dropdown.

  9. Note the Client ID and key value that are displayed. You'll need to update the application's web.config file with these values in a moment.

    Active Directory

  10. Scroll down to the "permissions to other applications" section of the screen.

  11. In the first dropdown in the Microsoft Azure Active Directory column select Office 365 SharePoint Online and make the selections shown next:

    Active Directory

  12. Click the Select application drop and add the following permission for Microsoft Azure Active Directory (see the first entry in the image below):

    Active Directory

  13. Click the Save icon at the bottom of the interface.

  14. Open the Expense Manager's .sln file in Visual Studio 2013 or higher (click Download Zip in Github and extract the project if you haven't already)

  15. Open web.config and replace Tenant, TenantID, ClientID and Password values with the values displayed in the Azure Directory screen shown earlier:

    <add key="ida:Tenant" value="YOUR TENANT DOMAIN NAME (ex: acmecorp)" />
    <add key="ida:TenantID" value="YOUR ACTIVE DIRECTORY TENANTID (a GUID)" />
    <add key="ida:ClientID" value="YOUR ACTIVE DIRECTORY APP CLIENTID" />
    <add key="ida:Password" value="YOUR ACTIVE DIRECTORY APP PASSWORD" />
  1. Open index.html from the root of the project and scroll to the bottom.
  2. Locate the expenseManager.baseSPUrl variable and update YOUR_TENANT with your Office 365 tenant ID.
  3. Press F5 to build and run the application.
  4. You should be taken to a login screen where you can login using your Office 365 credentials.

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.