PREREQUISITES

• Install node.js (we only needed to get npm)

  • Obtain the Windows setup from the Node.js website and run it.

• webpack npm install webpack

• Visual Studio Code.

RUNNING THE APPLICATION

In Visual Studio Code's terminal window (accessible by hitting ctrl tilde) issue the following command:

npm run dev

This will start up a web server and launch a browser pointing to the application's home page

SOURCE CONTROL

• You can use the tf.exe command line tool which allows you to fully interact with TFS. To make it easier you can add the path to this file to your PATH environment variable. This file is typically located here: C:\Program Files (x86)\Microsoft Visual Studio 12.0\Common7\IDE

  Here are some useful commands:

  • Get Latest https://www.visualstudio.com/en-us/docs/tfvc/get-command

  • Checkout Just modify the file and this will check it out automatically

  • Checkin https://www.visualstudio.com/en-us/docs/tfvc/checkin-command

  • Undo local changes https://www.visualstudio.com/en-us/docs/tfvc/undo-command

  • Shelve https://www.visualstudio.com/en-us/docs/tfvc/shelve-command

  • Unshelve https://www.visualstudio.com/en-us/docs/tfvc/unshelve-command

  For view history, comparing, resolving conflicts, etc, I’d recommend using Source Control Explorer in Visual Studio

Hosting on IIS

• URL Rewrite module must be installed
• A Web.config file must exist in the root directory. Use the Web.config file located in the external folder
• Application needs to have its own app pool running in classic mode.
  • Vue-js routing needs the <base href=”application virtual folder goes here”> in index.html when the application is not hosted in the root
• Configure webpack’s publicPath variable to tell the bundle the root directory where the application is hosted.

GOTCHAS

a) v-mask is used to mask certain input fields. This component does not support IE 9 and 10 out-of-the-box We had to make a change to it in order to support these browsers. Because of this, the changes will not visible to everybody since it had to be made in Julio's local node_modules. Ideally we would fork the project or have our own NPM server. For the time being this change needs to occur in every developer's node_modules directory. The changes are:

file: ace-ui\node_modules\v-mask\dist\index.js

Replace functions updateValue and updateMask with this:

function updateValue(el) { var force = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : false; var value = el.value, _el$dataset$previousV = el.getAttribute('data-previous-value'), previousValue = _el$dataset$previousV === undefined ? "" : _el$dataset$previousV, mask = el.getAttribute('data-mask');

  if (force || value && value !== previousValue && value.length > previousValue.length) {
     el.value = (0, _format2.default)(value, mask);
     (0, _utils.trigger)(el, 'input');
  }

  el.setAttribute('data-previous-value', value);

}

function updateMask(el, mask) { el.setAttribute('data-mask', mask) }