Awesome

page_type: sample products:

• office-sp
• office-365 languages:
• javascript urlFragment: expense-manager-angular description: "This application is a stand-alone AngularJS application that performs CRUD operations against SharePoint/Office 365." extensions: contentType: samples technologies:
  • Azure AD createdDate: 6/19/2014 8:30:16 AM

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.

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

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

   

2. Create a new Site Collection

   

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

   

4. Click on the Solution Gallery Link.

   

5. Click the Upload Solution icon in the ribbon.

   

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

   

7. Activate the Solution.

   

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

   

9. Click the Custom tab.

   

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

    

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.

    

12. Browse to the Home Page.

    

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.

   

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

   

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

4. Give the application a name of Expense Manager:

   

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:

   

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.

   

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:

    

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

    

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.