oe-metadata-ui v2.3.0

oe-metadata-ui

This module provides support for holding and serving metadata used by oe-ui framework.

dependency

• oe-cloud
• oe-logger

Installation, test cases and code coverage

Pre-requisite

• Connectivity to npmjs and github when you use npm on command line
• Refer sample .npmrc and .gitconfig as shown below

.npmrc

http-proxy=http://proxy/
https-proxy=https://proxy/
registry="http://registry.npmjs.org"
no_proxy=
strict-ssl=false
python=E:\Python27\python.exe

.gitconfig

[http]
proxy = http://proxy/
[https]
proxy = https://proxy/

Installation

$ git clone https://github.com/EdgeVerve/oe-metadata-ui.git
$ cd oe-skeleton
$ npm install --no-optional

Run Test cases

grunt mochaTest

Run test with coverage

Run test cases along with code coverage - code coverage report will be available in coverage folder

$ npm run grunt-cover

Run as independent Server

$ node test/server.js

browse http://localhost:3000/explorer

CI CD

CI CD is available and you may have to do minor changes as below.

.gitlab-ci.yml

This file is responsible for running CI/CD in gitlabs. you don't have to chagne anything in file. It will run npm run grunt-cover job which will internally run mocha test/test.js along with coverage.

Gruntfile.js

This file is used when CI/CD run test and coverage. you may want to modify following acceptance parameters.

 check: {
            lines: 90,
            statements: 90,
            branches: 50,
            functions: 100
          },

README.md

you should change this file as per your module.

ESLint

.eslintrc and .eslintignore files you need not to modify. However it is good practice to run following command before you push into git. Or else CI/CD pipeline will fail.

$ eslint . --fix

Developing oe-cloud module

You can do following things in this oe-cloud module.

• Add models specific to your module (see common/modles folder)
• Add mixins which will get attached to BaseEntity (see common/mixins folder)
• Add middleware (see server/middleware folder and server/middleware.json)
• Add Boot script (see server/boot folder)

Developing test script

There is test folder created. you need to modify following files for your project

datasources*.json

There are several total 3 datasource.x.json files each for Mongo, PostgreSQL and Oracle. you should change database name at least for Mongo and PostgreSQL

server.js

you may want to run this module as independent server during your development. Mostly you don't have to chagne this file unless you are having mixin. For that have line similar to below for your mixin.

oecloud.attachMixinsToBaseEntity("SkeletonMixin");

test.js

This is typical mocha unit test case file. you can keep adding test cases to it.

Adding models to your test scripts

you can add models that you want to use only for your test scripts in test/common/models folder and then modify test/model-config.json file to have entry for the model.

Adding boot script to your test scripts

you can add boot script in test/boot folder. This will be executed as part of boot in application.

Similarly you can also have middleware/mixins for testing - which is mostly not required.

Documentation

Templates

Specify path under client.templatePath: ... in config.json

Observed that embedsMany fields need to be posted with underscore-prefix. "addresses" -> the property is generated as "_addresses"