How to install a new module - BEXIS2/Core GitHub Wiki

How to install a module

  1. Create a new folder in …\Console\BExIS.Web.Shell\Areas for a module that is intended to be installed and paste/checkout contents/repository of the module to that folder.
  2. Go to …\Console\Workspace\Modules and open the file Modules.Catalog.xml
  3. In Modules.Catalog.xml add a new line for the new module with its id and order, set status to "pending".
  4. In Microsoft Visual Studio Code, under Solution Explorer->Modules, create a new folder for the module (e.g., EMM).
  5. Add all existing projects of the module (right-click on folder -> add existing project) to the new folder.
  6. Build the new model and the whole solution and start.
  7. After the first start of BEXIS2, in Modules.Catalog.xml the status should change from "pending" to "inactive", change the status to "active". After re-login, all related menu entries will be visible.
  8. Under Feature Permission, the new module should be visible to the user.

Troubleshooting

  • check in the database if seed data was imported (featurepermissions, operations)
  • check entries in Module.Catalog.xml
  • check if all projects are added
  • check references in each project and correct yellow marked once
  • re-built
  • empty temp .net folder