Skip to content

Dnext Frontend SDK Libraries

DNext

This project is a collection of Angular libraries that are used in the DNext Services projects. The libraries are divided into multiple packages and each package has its own purpose.

This project was generated with Angular CLI version 18.0.2.

Development server

Run ng serve for a dev server. Navigate to http://localhost:4200/. The application will automatically reload if you change any of the source files.

Build

Run ng build or if you want to build specific one you can follow the package.json scripts to build the project. The build artifacts will be stored in the dist/ directory.

📦 Packages

The packages: Packages are under the @dnext-angular/...,

Package Name Version Description
agreement 4.5.0 TMF Agreement Management API
http 1.2.2 Authorization and HTTP helper package
validator 1.4.0 Angular validator package
directives 1.3.0 Angular directives package
utilities 1.2.0 Angular utilities package
common 1.1.1 Common model library
product-catalog 1.2.0 Product Catalog Mngt Service
product-ordering 1.3.0 Product Ordering Management
resource-ordering 1.3.0 Resource Ordering Management
service-ordering 1.3.0 Service Ordering Management
quote 1.2.0 Quote Management Service
pofo 1.2.0 Product Order Fulfillment Orchestration
sofo 1.2.0 Service Order Fulfillment Orchestration
rofo 1.2.0 Resource Order Fulfillment Orchestration
drapms 1.2.0 Roles and Permission
dbpmms-form 1.1.0 DBPMMS Form management API
dbpmms-op 1.5.0 DBPMMS Operate API for BPM/Workflow Engine Mgmt.
dbpmms-usertask 1.2.0 DBPMMS User Task API
dbpmms-userticket 2.2.0 DBPMMS BackOffice User Ticket
dtts 1.4.3 DTTS Trouble Ticket Service
dcomms 1.3.0 DCOMMS Communication Service Mgmt.

The libraries are installed in the node_modules folder and can be imported in the Angular application.

  • For example, to install the @dnext-angular/product-ordering library, run the following command: 
    npm install @dnext-angular/product-ordering

🧬 Configuration

@dnext-angular/...,

package name Configuration variable name API path
agreement agreementManagementApi '/api/agreementManagement/v4'
product-catalog productCatalogManagementApi '/api/productCatalogManagement/v4'
product-ordering productOrderingManagementApi '/api/productOrderingManagement/v4'
service-ordering serviceOrderingManagementApi '/api/serviceOrderingManagement/v4'
resource-ordering resourceOrderingManagementApi '/api/resourceOrderingManagement/v4'
qutoe quoteManagementApi '/api/quoteManagement/v4'
pofo productOrderFulfillmentOrchestrationApi '/api/productOrderFulfillmentOrchestration/v1'
sofo serviceOrderFulfillmentOrchestrationApi '/api/serviceOrderFulfillmentOrchestration/v1'
rofo resourceOrderFulfillmentOrchestrationApi '/api/resourceOrderFulfillmentOrchestration/v1'
drapms rolesAndPermissionsManagementApi '/api/rolesAndPermissionsManagement/v5'
dbpmms-op bpmManagementOperateApi '/api/bpmManagement/operateManagement/v1'
dbpmms-usertask bpmManagementUserTaskApi '/api/bpmManagement/userTaskManagement/v1'
dbpmms-form bpmManagementFormApi '/api/bpmManagement/formManagement/v1'
dbpmms-userticket bpmManagementUserTicketApi '/api/bpmManagement/backOfficeUserTicketManagement/v1'
dtts troubleTicketApi '/api/troubleTicket/v5'
dcomms communicationManagementApi '/api/communicationManagement/v4'

NPM Registry configuration

To use the libraries in your Angular application, you need to configure the NPM registry in .npmrc file.

@dnext-angular:registry=https://nexus.orbitant.dev/repository/npm-private/
@dnext-react:registry=https://nexus.orbitant.dev/repository/npm-private/
@dnext:registry=https://nexus.orbitant.dev/repository/npm-private/
//nexus.orbitant.dev/repository/npm-private/:username=rnd-frontend-writer
//nexus.orbitant.dev/repository/npm-private/:_password={{PASSWORD}}

🧬 Build the libraries

Example of building the Agreement library: 

npm run build:agreement

🧬 How to test my changes locally

  1. Clone the repository
  2. Run npm install
  3. Build the agreement library: 
    npm run build:agreement
  4. Pack the library: 
    npm run pack ./dist/agreement/angular
    the package will be created in the root folder.
  5. dnext-angular-agreement-{{version}}.tgz
  6. In your test application:
  7. Copy the tarball to /src/assets
  8. Add to package.json
  9. "@dnext-angular/agreement": "../src/assets/dnext-angular-agreement-{{version}}.tgz"
  10. Run npm install

Change Log

All notable changes to this project will be documented in this file. The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Each package have changelog.md file. If we are changed, deleted or added new feature/attribute in this project, we should be add in this file the changes according to ChangeLog standards and version number.