src/main/asciidoc/howto/howtoBuild.adoc

= openKonsequenz - How to build the module "gridFailureInformation@openK"

:Date: 2020-03-24
:Revision: 1

:icons:
:source-highlighter: highlightjs
:highlightjs-theme: solarized_dark

:imagesdir: ../img
:iconsdir: ../img/icons

:lang: en
:encoding: utf-8
<<<

IMPORTANT: Please be sure that you have first *Portal (Auth n Auth)* and *ContactBaseData* installed and configured!

== Requirements
* Node.js 12.14.0
* Angular-CLI

== How to build the Backend
To build the backend you need to have installed Apache Maven and Java (look at `/deploy/`*get_started.txt*).

== How to build the Frontend

=== Install Node.js

Node.js is an open-source, cross-platform JavaScript run-time environment for executing JavaScript (also Typescript which is a strongly typed form of JavaScript) code server-side.

* Download Node.js 12.14.0 from https://nodejs.org/download/release/v12.14.0/ by clicking on a xxx.msi image for windows.
* Run the downloaded Node.js .msi Installer - including accepting the license, selecting the destination, and authenticating for the install.
This requires Administrator privileges, and you may need to authenticate
* To ensure Node.js has been installed, run the following in your terminal - you should get something like 12.14.0

[source,command]
----
    $ node -v
----
{blank}

=== Update the npm Angular-CLI client
This package manager comes bundled with Node.js and its good to have the latest version.

* Open a command line and navigate to the root folder of the frontend project
* Run the following commands (the version is defined in the package.json file):

[source,command]
----
    $ npm install --save-dev @angular/cli
----
{blank}

[source,command]
----
    $ npm install
----
{blank}

TIP: Next Step -> Read the *grid-failure-information_howtoRun* file!

== How to build the SIT-Web-FE (Map- and Table-Component)
=== Prerequirements

* Open a command line and make sure that nest-cli is installed:
+
[source,command]
----
    $ nest -version
----
{blank} 
=> This should show the version number. 

* If you miss the version number or get an error then install the nest-cli with the following command:
+
[source,command]
----
    $ npm install -g @nestjs/cli
----
{blank} 

=== Build and run the SIT-Web-Cache-Service

* Open a command line and navigate to the folder of the service project
(_grid-failure-information-web-cache_).

* To build the service run the commands:
+
[source,command]
----
   $  npm install
   $  nest build
----
{blank} 
=> A folder named '_dist_' should be created in the project folder containing *.js and *.ts files.

* Start the service with the following command for testing:
+
[source,command]
----
   $  npm run start
----
{blank} 
=> After the nest service is started you can test the service within your browser by calling the following address: http://localhost:3000/public-sit. (You should replace _localhost_ with your own network address.) 

=== Build the SIT-Web-FE

* Open a command line and navigate to the root folder of the project. +
=> The project.json file should be in the same folder.

* Install the required dependencies with the following command:
+
[source,command]
----
    $ npm install
----
{blank}

* Build the map and table component:
+
[source,command]
----
    $ npm install
    $ npm run build-comp-full
----
{blank}
=> A folder named '_dist/grid-failure-information-web-comp_' should be created in the project root folder.

TIP: Next Step -> Read the *howtoRun* file!