Angular App in SharePoint
Angular is very powerful framework and SharePoint has rich REST API Interface. Building Single Page Applications that lives in SharePoint provides an easy and fast way to build and deploy apps.
Angular CLI
Angular CLI is the way to start a new angular application. Make sure you have latest NodeJS installed. Once NodeJS is install, open command line/terminal and install angular-cli:
npm install -g @angular/cli@latest
Once Angular CLI is installed scaffold a new project using
ng new sp-ng
after scaffolding of new project and installation of all dependencies, check that we have a working angular project using
ng serve -o
We are all ready with a working Angular project.
Support for Local Development
One of the challenge that we face for developing for SharePoint is support for local development and debugging. Andrew Koltyakov has developed a fantastic node package to enable local development support in NodeJS based applications. Grab SharePoint REST API Proxy (sp-rest-proxy) package and install this using
npm install sp-rest-proxy --save-dev
Once installed configure this using instructions on GitHub page.
Configure environment setting in Angular
Angular supports environment settings and it will be pick up correct settings when you build for production. In explorer window, find environment.ts and environment.prod.ts and and add config entries for development and production.
Install and Use PnP SharePoint JavaScript library
To inter react with SharePoint REST API, install PnP SharePoint JavaScript library :
npm install @pnp/logging @pnp/common @pnp/odata @pnp/sp --save
Create a new Angular Service sp.service.ts to offload SharePoint API Communication. Here we are using fromPromise to convert Promise to an Observable.
Query SharePoint data using this service:
You should see the result on local development server on http://localhost:4200
Source code on GitHub : https://github.com/SumitRAgrawal/ng-sp/tree/master/hello-world