DIGIT Urban
PlatformDomainsAcademyDesign SystemFeedback
v2.3
v2.3
  • DIGIT
  • Training Event
  • Architecture
  • Roadmap
  • Release Notes
    • MDMS Configuration & Service Build Updates
    • FSM Release Notes
    • HRMS Release Notes
    • EDCR Release Notes
    • Bill Amendment Release Notes
  • Products & Modules
    • mCollect (MCS)
      • mCollect Master Data Templates
        • Service Category
        • Service Sub Category
        • Service Sub Category GL Code Mapping
      • mCollect Roadmap
      • mCollect User Manual
        • MCS Citizen User Manual
        • MCS Employee User Manual
    • Trade License (TL)
      • TL Brochure
      • TL Roadmap
      • TL Module Functional Specifications
      • TL Workflows
      • TL Implementation Guide
      • TL Master Data Templates
        • Trade Type
        • Trade Sub Type
        • Trade Category
        • Trade License Fee
        • Structure Sub Type
        • Structure Type
        • Trade License Document Attachment
      • TL Service Configuration
      • TL User Manual
        • Citizen User Manual
        • Employee User Manual
      • TL Demo Script
    • Public Grievances & Redressal (PGR)
      • PGR Brochure
      • PGR Roadmap
      • PGR Module Functional Specifications
      • PGR Workflows
      • PGR Master Data Templates
        • Grievance Type
        • Grievance Sub Type
      • PGR Service Configuration
        • PGR Migration
      • PGR Implementation Guide
      • PGR User Manual
        • Complaint Types List
        • Employee User Manual
        • Citizen User Manual
      • PGR Demo Script
    • Property Tax
      • PT Brochure
      • PT Roadmap
      • PT Module Functional Specifications
      • PT Workflows
      • PT Implementation Guide
      • PT Master Data Templates
        • Mutation Fee
        • Rebate Rates
        • Penalty Rates
        • Interest Rates
        • Tax Rates
        • Unit Rates
        • Special Category Documents
        • Owner Special Category
        • Ownership Sub Category
        • Ownership Category
        • Usage Category Detail
        • Road Type
        • Construction Type
        • Property Type
        • Property Sub Type
        • Usage Category Major
        • Usage Category Minor
        • Usage Category Sub Minor
      • PT Data Migration
      • PT User Manual
        • Citizen User Manual
        • Employee User Manual
    • Water & Sewerage (W&S)
      • W&S Module Functional Specifications
      • Sewerage Charges Master Data Templates
        • Sewerage Rates
        • Sewerage Penalty Rates
        • Sewerage Interest Rates
      • Water Charges Master Data Templates
        • Water Rates (Metered)
        • Pipe Size Types
        • Water Source Types
        • Water Rates (Non-Metered)
        • Water Penalty Rates
        • Water Interest Rates
      • W&S User Manual
        • W&S Citizen User Manual
        • W&S Employee User Manual
    • Online Building Plan Approval System (OBPAS)
      • OBPAS Module Functional Specifications
      • OBPAS Master Data Templates
        • Fee Structure
        • NOC Departments
        • Stakeholders Type
        • List Of Services
        • Service-Wise Documents
        • Building Occupancy
        • Building Sub Occupancy
        • Building Usage
        • Inspection Checklist
        • Town Planning Schemes
      • OBPAS Brochure
      • OBPAS User Manual
        • OBPAS Citizen User Manual
        • OBPAS Employee User Manual
    • Faecal Sludge Management (FSM)
      • FSM Service Configuration
      • FSM Calculator v1.0
      • FSM Vendor Registry v1.0
      • FSM Vehicle Registry v1.0
      • FSM User Manual
        • Citizen User Manual
        • Employee User Manual
        • DSO User Manual
        • Septage Treatment Plant Operator User Manual
    • Finance
      • Finance Implementation Guide
      • Finance User Manual
        • Employee User Manual
        • Admin User Manual
        • Finance Reports Manual
      • Finance Module Functional Specifications
      • Finance Master Data Templates
        • Bank Account
        • Chart Of Accounts
        • Funds
        • Function
        • Contractors
        • Suppliers
        • Schemes
        • Sub Schemes
        • Banks
        • Bank Branch
        • Deduction
        • Opening Balances
        • Sub Ledger Category
        • Sub Ledger Master
    • Fire NOC
      • Fire NOC Master Data Templates
        • Building Usage Type
        • Building Sub Usage Type
        • Fire Station Master
        • Areas Served Master
        • Fire Station Mapping
        • Fire NOC Fee
      • Fire NOC User Manual
        • Fire NOC Citizen User Manual
        • Fire NOC Employee User Manual
    • DIGIT Service Configuration
      • Core Services
        • Workflow Services
        • Location Services
        • User Services
        • Access Control Services
        • PDF Generation Service
        • MDMS (Master Data Management Service)
        • Payment Gateway Service
        • User Session Management In DIGIT
        • Indexer Service
        • URL Shortening Service
      • Business Service
        • Bill Amendment
      • Municipal Service
        • PGR Services 2.0
          • PGR Migration
        • Trade-License Service
        • BPA Service
          • BPA Service Setup and Configuration
          • BPA Calculator Service
          • Land Services
          • Noc Services
      • Utilities
    • Product FAQs
  • Configuration Guide
    • Git Repos
    • Setting up DIGIT
      • Configuring InfraOps
      • Setting up DIGIT Environment
      • Email And SMS Setup
      • FileStore Setup
      • Setting Up SSL Certificate
      • Periodic Log Cleanup
    • Setting up Master Data
      • MDMS Overview
      • Configuring Tenants
      • Configuring Master Data
      • Adding New Master
      • State Level Vs City Level Master
    • Master Data Collection Templates
      • Environment Setup
        • State Level Setup
          • Tenants Information
          • SMS Account Configuration
          • Email Account Configuration
          • Google Play Store Account
          • Payment Gateway Configuration
          • POS Integration Configuration
          • Domain Name Configuration
          • SSL Configuration
          • ULB Departments
          • ULB Designations
          • Localization
          • Google Map Configuration
        • ULB Level Setup
          • Boundary Hierarchies
          • Boundary Data
          • Cross Hierarchy Mapping
          • ULB Bank Accounts
      • Module Setup
        • Web Portals Templates
          • State Portal
          • ULB Portal
        • HRMS Data Templates
          • User Roles
          • System Users
        • Billing And Payments Data Templates
          • Tax Heads
          • Receipt Format
          • Demand Bill Format
        • DSS Data Templates
          • KPI Acceptance
        • Workflow Data Templates
          • Workflow Actions
          • Workflow Levels
          • Workflow Process
          • Workflow Notifications
        • Common Configuration Details
          • Standard Document List
          • Service Document Mapping
          • Checklist
          • Configuring Data FAQs
    • Configuring Workflows
      • Setting Up Workflows
      • Configuring Workflows For An Entity
    • Configuring Services
      • API Dos and Don'ts
      • Setting Up Service Locally
      • Configuring New Reports
        • Types Of Reports Used In Report Service
        • Impact Of Heavy Reports On Platform
      • Customizing PDF Notices And Certificates
        • Integration Of PDF In UI For Download And Print PDF
        • Customizing PDF Receipts & Certificates
    • Persister Configuration
    • Indexer Configuration
    • Setting up a Language
      • Adding New Language
      • Setting Up Default Language For SMS & Emails
    • Configuring Localization
      • Setup Base Product Localization
      • Configure SMS and Email
    • Setting Up SMS Gateway
      • Using The Generic GET & POST SMS Gateway Interface
    • Configuration FAQs
    • Setting Up eDCR Service
    • Adding Roles To System
    • Mapping Roles With APIs
    • DSS Configuration And Setup
      • Building New Dashboards
    • Setting Up Finance Service
    • Adding New APIs For Access
    • Deployment Of App on Play Store
  • Customization Guide
    • Frontend/UI
    • DIGIT Customization
      • API Do's & Don'ts
      • Writing A New Customer
      • Enhancing Existing Service
  • Deployment Guide
    • Setup Requirements
      • Tech Enablement Training - Essential Skills and Pre-requisites
      • DIGIT Rollout Program Governance
      • DevOps Skills Requirements
      • Infra Requirements
      • Team Composition for DIGIT Implementation
      • Infra Best Practices
      • Operational Best practices
      • Why Kubernetes for DIGIT
    • Supported Clouds
      • Google Cloud
      • Azure
      • AWS
      • VSphere
      • SDC
      • NIC
    • Deployment - Key Concepts
      • Security Practices
      • CI/CD
      • Readiness & Liveness
      • Resource Requests & Limits
    • Understanding ERP Stack
      • ERP Monolithic Architecture
      • ERP Hybrid Architecture
      • ERP Coexistence Architecture
      • APMDP-HYBRID-INFRA-ARCHITECTURE
      • eGov SmartCity eGovernance Suite
      • ERP Deployment Process
      • ERP Release Process
      • ERP User Guide
    • Deploying DIGIT Services
      • Deployment Architecture
      • Routing Traffic
      • Backbone Deployment
    • Troubleshooting
      • Distributed Tracing
      • Logging
      • Monitoring & Alerts
  • Training Resources
    • Training Videos
  • Partner Support
    • eGov Enablement Support for DIGIT
    • Troubleshooting Guide
Powered by GitBook

​All content on this page by eGov Foundation is licensed under a Creative Commons Attribution 4.0 International License.

On this page
  • Overview
  • Prerequisites
  • Configurations and Setup
  • References

Was this helpful?

Edit on Git
Export as PDF
  1. Configuration Guide

Setting Up eDCR Service

PreviousConfiguration FAQsNextAdding Roles To System

Last updated 4 years ago

Was this helpful?

Overview

This document mainly covers all the steps that one needs to do for setting up a new instance of eDCR (Development Control Regulations). Say when a new State is to be set up, there are some activities to be executed in a defined order. Setting up an instance of an application server and configuring customer-specific rules, and data, etc are a few of the key activities.

  • Centralized Server hosting all the ULBs within a state

  • All ULBs access the software over API calls.

  • Uniform code base supporting all the ULBs for the state. City-specific changes are maintained using client-specific implementation repositories.

  • A separate schema for each ULB in the database.

Prerequisites

  • Prior Knowledge of Java/J2EE.

  • Prior Knowledge of Spring and Hibernate

  • Prior knowledge of Maven

  • Prior knowledge of Git.

  • Install the below version of the software in local machine

    • maven v3.2.x

    • PostgreSQL v9.6

    • Git 2.8.3

    • JDK 8 update 112 or higher

Configurations and Setup

eDCR Service repository will be used to define default rules. The statewide rules to be defined within the client implementation repository.

How to set up a client implementation repository

After creating a client implementation repository, If you want to override rules processing for features, then create a project under egov directory like egov-client-impl.

The client-specific rules are configurable in the individual client implementation module. Here the rules are fetched by state wise, district wise, ULB wise, or grade-wise.

How to override rule processing across the state for a feature

The EG_CITY table, master data is used to decide the rules.

  1. If the rules are the same for a feature across the state then the filename must need to keep like Far_{Client.id}.

  2. The client id used with the feature class name and configures in the properties file should match, then only the system will pick features and process otherwise it won't pick the file.

How to override rule processing district, city, and grade wise for a feature

  1. If the rules varying across district, city, and grade wise within a state then must need to follow the following naming conventions.

  2. If the rules are varying from district to district, then the respective district-related rules need code under separate files with a filename like Far_{District Name}. eg: Far_Udalguri.

  3. Similarly, if rules varying for city and grade wise then those respective rules need to code under separate files with a filename like Far_{City Name}, Far_{Grade}. eg: Far_Dispur, Far_Corp

  4. The district, city, and grade information will be reading from the eg_city table, so in this table need to update that information before starting the coding.

  5. In a state, only for one or two cities if the rules are changing then need to override rules only for those cities in a separate file, for other all cities the default code will pick. Here default code is state level (Far_{Client id}) configured one.

Configuration Changes to setup State and Cities

  1. The state is configured by adding property tenant.{domain_name}=schema_name (state_name) in egov-erp-override.properties.

  2. Each new ULB is enabled by adding a schema name and domain name in egov-erp-override.properties file(Available in Wildfly server under ${HOME_DIR}/wildfly-11.0.0.Final/modules/system/layers/base/org/egov/settings/main/config). Schema names should follow a naming standard, It should be the same as that of the city name.

  3. Each ULB can be configured by adding an entry like tenant.{domain_name}=schema_name (city_name) in egov-erp-override.properties file.

  4. Insert data into eg_city, in the city table domain URL value should be the same as configured tenant domain_name in the egov-erp-override.properties.

Changes required for local machine workspace setup

  1. After set up is done, the local ubuntu machine need to update the domain URLs in the host file which you are going to use for scrutinizing and fetching the plan.

  2. Navigate to the root directory and from there open the host config file available in the location 'etc/hosts'. Map the domain URLs with a local IP address in the hosts file and save the changes.

  3. Update settings in standalone.xml under ${HOME_DIR}/wildfly-11.0.0.Final/standalone/configuration

  4. Add 'max-post-size' attribute with value 100mb in bytes in the below location,

  5. <server name="default-server"> <http-listener name="default" socket-binding="http" max-post-size="104857600" redirect-socket="https" enable-http2="true"/> <https-listener name="https" max-post-size="104857600" socket-binding="https" security-realm="ApplicationRealm" enable-http2="true"/> <host name="default-host" alias="localhost"> <location name="/" handler="welcome-content"/> <http-invoker security-realm="ApplicationRealm"/> </host> </server>

MDMS Integration

If you want to fetch master data from MDMS for following ApplicationType, ServiceType, OccupancyType, SubOccupancyType, Usages then the following configurations are needed,

Add the property and update the MDMS search URL, mdms.searchurl=/egov-mdms-service/v1/_search in application-config-client.properties file or egov-erp-override.properties file

  1. By default, the master data will be fetched from the database.

  2. If you want to fetch from MDMS instead of the database then the above configurations are required.

  1. After setup is done APIs one must use state domain URL and in the contract tenantId of concern, the city has to be passed to scrutinize multiple cities.

  2. One should not use the city domain URL to scrutinize or fetch plan if used that way, the response will be empty.

  3. The tenantId used should follow {state_name.city_name} naming convention, then the state_name passed in the request and city code in the state schema must be the same.

References

Title

Link

Design and Architecture

API Contracts

Repository the default rule processing code available

Sample client implementation repository

Configuring MDMS

Branch out and create a eDCR service repository from master repository. Refer for the client implementation setup has been done.

Here client id nothing but a state name, the client.id need to update with the state name in application-config-client.properties file (Available in ) or in egov-erp-override.properties file(Available in Wildfly server under ${HOME_DIR}/wildfly-11.0.0.Final/modules/system/layers/base/org/egov/settings/main/config).

Eg: Here filename to be added as Far_Assam.java for the Assam state rules.

Setup your eDCR service workspace by following the instructions provided in

Enable fetch master data from MDMS by adding mdms.enable=true property in application-config-client.properties file (Available in ) or in egov-erp-override.properties file(Available in Wildfly server under ${HOME_DIR}/wildfly-11.0.0.Final/modules/system/layers/base/org/egov/settings/main/config).

Add the property and update the MDMS hostname, mdms.host=HOST_NAME} in application-config-client.properties file or egov-erp-override.properties file

All content on this page by is licensed under a .

JBoss Wildfly v11.x
https://github.com/egovernments/egov-dcr-client/blob/master/egov/egov-client-impl/src/main/resources/config/application-config-client.properties
https://github.com/egovernments/egov-dcr-client/blob/master/egov/egov-client-impl/src/main/java/org/egov/client/edcr/Far_Client.java
https://github.com/egovernments/eGov-dcr-service/blob/master/README.md
https://github.com/egovernments/egov-dcr-client/blob/master/egov/egov-client-impl/src/main/resources/config/application-config-client.properties
{
Development Control Rules (Digit-DCR)
https://github.com/egovernments/digit-bpa/blob/master/egov/egov-edcr/dcrasservice.yaml
https://github.com/egovernments/eGov-dcr-service
https://github.com/egovernments/egov-dcr-client
Configuring Master Data
https://github.com/egovernments/eGov-dcr-service - Connect to preview
https://github.com/egovernments/egov-dcr-client - Connect to preview
​
eGov Foundation
Creative Commons Attribution 4.0 International License
Creative Commons License