Create Client Side App to SP2013 Using TypeScript, React and @PnP/PnPjs

Screenshot 2018-09-22 at 14.26.23

 

Client Side Development to SP2013 is not new, but in this Post I’ll try explain my experience with develop a Client Solution App with same technology that are use with SPFx,  Typescript, React, React-Ui-Fabric-React Components, I use the @PnP/PnPjs to access Lista Data.

SPFx is supported in SP2016 (Feature Pack 2) and SP2019 but not in SP2013.

First Step is create a Type Script React Project, I use the create-react-app with create-react-app-ts script  this will scaffold a project with tools necessary to create a React App with TypeScript

If you don’t have installed create-react-app  you must install with:

npm install create-react-app -g 

Can find more information here:

https://www.npmjs.com/package/create-react-app

after you have to install the react-scripts-ts with:

npm i react-scripts-ts -g

Can find more information here:

https://github.com/wmonk/create-react-app-typescript

Finally create the project:

create-react-app  <projectName> –scripts-version=react-scripts-ts

I use MAC OS X as my principal environment for development and for simplify the creation of a React Project with TypeScript I create a simple bash shell script that only receive a project name as parameter.

Here the my script:

CreateReactTS.sh . that have the following code:

create-react-app $1 –scripts-version=react-scripts-ts

To work with project I use VSCode as my editor , but you can use what you want, please see what is create, for details please see this links:

https://github.com/wmonk/create-react-apptypescript/blob/master/template/README.md​

https://github.com/facebook/create-react-app​

Screenshot 2018-10-03 at 21.18.35
Let start creating our SharePoint 2013 App. 🙂
Install Required Packages:
I use additional packages :

 

Project Organization:

Class to access SharePoint Data (services.ts) here are defined all methods to get data from SharePoint,  I use @PnP/PnPjs .

Note on use@PnP/PnPjs  , we are using SharePoint 2013 REST API’s,  first we have to setup@PnP/PnPjs .:

This is required in SharePoint 2013.

Screenshot 2018-10-03 at 21.43.06

Sample of my service.ts class:

Screenshot 2018-10-03 at 21.55.21

I use a class for some staff I use in my components, that I called util.ts

Screenshot 2018-10-03 at 22.01.38

Here my Application  App.tsx

Screenshot 2018-10-03 at 22.08.10

Screenshot 2018-10-03 at 22.11.52

 

Let’s compile my Application and prepare to deploy to SharePoint.

First thing is define a environment var called PUBLIC_URL to the location of SharePoint library where the build directory is replicated.

export PUBLIC_URL = “/Shared%20Documents/App/build”

On build process all path of our files, css, jscript, etc.. are reference to this location in the index.html.

Next, build the App.

npm run build

go to the build directory of your project and you will see the compiled files:

Screenshot 2018-10-04 at 09.32.57

Open the project folder with File Explorer in Windows or Finder in MAC and copy all the content of build directory to your SharePoint Document Library.

Screenshot 2018-10-04 at 09.42.56

In Document Library:

Screenshot 2018-10-04 at 11.24.48

After I create a WebPart based on Content Editor WebPart, point to my Index.html

Screenshot 2018-10-04 at 11.33.15

Upload the dwp file to WebPart Gallery and is ready to use. 🙂

Here my Sample:

Screenshot 2018-10-04 at 11.38.20

Screenshot 2018-10-04 at 11.39.36

 

 

 

 

 

 

 

 

 

 

 

 

 

One thought on “Create Client Side App to SP2013 Using TypeScript, React and @PnP/PnPjs

Os comentários estão fechados.