THIS/
│
├── Folder Example...
│ ├── File Example...
│ ├── File Example...
│ └── File Example...
│
├── .gitignore
└── README.md
Este proyecto fue creado con el fin de crear un ecosistema que integre dos herramientas muy conocidad, la cuales son ERPNext y Camunda BPM. Esto es debido a que no existe, hasta el momento, manera alguna de unir estas dos herramientas para poder utilizarlas dentro de un mismo contexto.
Incio como un proyecto escolar para Proyectos Computacionales en la carreara de Ingeniería en Sistemas Inteligentes, en la UASLP.
Este repositorio fue creado para albergar todo lo necesario para instanciar el stack ERP-BPM además de los microservicios necesarios para iniciar la comunicacion entre los dos recurso.
A continuación, se explicara la manera de implementar, instanciar y utilizar el ecosistema completo.
Los requisitos necesarios para ello son los siguientes:
In order to implement a ready to test environment of tecnologies used in this project we need cover the configuration steps in the next sections.
We going to need get the main stack that results after cloning the repository using git (download), then we configure the environment with Docker (how to install) and YAML files.
For some implementations, tecnologies, modifications and more is necessary that we install NodeJS in our computer.
In order to install and configure a local ERPNext client we can follow the next steps. To see other options and details about a more complete configuration for the environment see ERPNext installation.
- Cloning the repository for ERPNext client
git clone https://github.com/frappe/frappe_docker.git
- Move to the repo directory.
cd frappe_docker
- Copy the example docker environment file to .env
cp env-local .env
- Start docker containers with the name of your proyect. This step can take minutes to be ready.
# docker-compose --project-name <project-name> up -d
- The default user is
Administrator
and password$ADMIN_PASSWORD
.
Now to configure the environment for Zeebe local client we need to follow the next steps. Also we can see a more complete configuration at Zeebe.
- Clone repository for Zeebe
git clone https://github.com/zeebe-io/zeebe-docker-compose
- Move to operate folder in repository folder
https://github.com/AngelAngelopoulos/ERPNext-CamundaBPM-Integration/wiki/Zeebe-Environment
- Run docker containers
docker-compose up
-
Now we can easily access to Docker Desktop on "Images" section and run camunda/operate to start the local client of Camunda Cloud with Zeebe.
-
Finally we can access to http://127.0.0.1:8080/login in our navigator to access the local client. Default user is
demo
and password isdemo
.
To achieve implement a process in the Camunda client is necesary design a diagram that represent the flow of the process using BPMN a graphical notation to design business processes. Camunda Modeler is a tool from Camunda that help us to create our process diagrams and simplify deployment on Camunda client.
For a demo we use two process examples: (ACTUALIZA ENLACES)
- Diagram of Selling a product online
- Diagram of Patient admission to a hospital
Note: The BPMN language suported on Camunda differs from Camunda Cloud because have different workflow engines, both supported by community and may have more features in future relases. See the actual BPMN elements alowed latest relase for Camunda Cloud.
To install Hasura its requiredhave Docker installed and configured, this will be our Microservice trigger, when a new Patient (or another Entity) is created, Hasura activates an Event, this is a webhooks that sends a POST message to an endpoint (our service start-process) and initiates the process in Camunda BPM, in operate portal we shall be the new instance of the process
You can instantiate the functions in the Cloud using Openfaas (see the Installation Guide) or AWS lambda (see our Implmenetation Guide) in each case, it can be achieved using a Multiservice gestor, so, this can be used as trigger for the functions, using Javascript to create Microservices, then, is is the API and the endpoints start-process and send-message