sp2013sync

v1.2 - Maxime
Fork from https://github.com/jeffangama/gulpsynchLocalToRemote

Objective :

Work on SharePoint 2013 files in VSCode.
Using gulp task you can download, upload and watch files.

You can clone this repo or integrate the synch tools by getting the installation files in InstallationFiles folder.
You can install in into an existing project bu using procedure below.

Contents

• Installation
• Usage

Installation

If you clone the repo, do not follow the below procedure :

Step 0

Install node.js :)

Step 1

npm init

Step 2

Open package.json, after description, add "," then paste

"dependencies": {
    "gulp": "^3.9.1",
    "gulp-clean": "^0.3.2",
    "gulp-plumber": "^1.1.0",
    "gulp-process-only-modified-files": "^1.0.0",
    "node-file-cache": "^1.0.2",
    "gulp-spsync-creds": "^2.3.8",
    "sp2013sync": "^1.0.5"
  },

Step 4

Install dependencies

npm install --save

Step 5

Copy the files config.js, gulpfile.js and settings.js into your solution folder.

Step 6

Create a creds.js file int the folder parent of your solution folder . This file is outside of the solution folder to avoid to upload it to git.

module.exports = {
    dev: {        
    "username": "user@domain.com",
    "password": "password"
    }
}.dev;

Step 7

Configure config.json

    "site": "http://test-site-url",
    "skipInstall": false,
    "verbose": "false",
    "config":"Dev",
    "remoteFoldersToGet":["SiteAssets","_catalogs/masterpage"], //folders for which you want to retrieve content in the populate task
    "location":"src" //location where files will be downloaded, uploaded and watched

This file allows you to configure many profiles and select the one you want to activate by exporting the wanted config name.

Usage

• A) Push the files to SharePoint immediately. It will need a confirm and then it will create the folder by it self.
  Only the updated files since last push will be pushed. If it is the first push, all files will be pushed.
  (if you change the option published to false in config.json, the default gulp task will not publish files)

gulp 

• B) Watch changes and push immediately each file you update

gulp watch

• C) Same as A) with publish (if you change the option published to false in config.json, the default gulp task will not publish files)

gulp publish

• D) Publish all files to SharePoint regardless of the modification dates

gulp publish-all

• E) If you want to retrieve all items from the folders defined in "remoteFoldersToGet" :

gulp populate