{"id":22389793,"url":"https://github.com/entando/entando-process-driven-plugin","last_synced_at":"2025-08-14T04:15:55.827Z","repository":{"id":35344177,"uuid":"204005721","full_name":"entando/entando-process-driven-plugin","owner":"entando","description":"Repository for the plugin that is part of the Entando Business Automation Bundle","archived":false,"fork":false,"pushed_at":"2023-05-24T19:05:22.000Z","size":11214,"stargazers_count":8,"open_issues_count":0,"forks_count":1,"subscribers_count":9,"default_branch":"develop","last_synced_at":"2024-04-14T07:54:27.275Z","etag":null,"topics":["entando"],"latest_commit_sha":null,"homepage":"https://dev.entando.org","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"lgpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/entando.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-08-23T13:39:16.000Z","updated_at":"2024-04-14T07:54:27.276Z","dependencies_parsed_at":"2023-01-15T19:00:19.919Z","dependency_job_id":null,"html_url":"https://github.com/entando/entando-process-driven-plugin","commit_stats":null,"previous_names":[],"tags_count":105,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/entando%2Fentando-process-driven-plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/entando%2Fentando-process-driven-plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/entando%2Fentando-process-driven-plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/entando%2Fentando-process-driven-plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/entando","download_url":"https://codeload.github.com/entando/entando-process-driven-plugin/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":228224699,"owners_count":17887844,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["entando"],"created_at":"2024-12-05T03:13:16.626Z","updated_at":"2024-12-05T03:13:17.282Z","avatar_url":"https://github.com/entando.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Entando - Process Driven Apps Plugin\n\nJenkins:\n[![Build Status](https://jenkins.entandocloud.com/buildStatus/icon?job=de-entando-process-driven-plugin-master)](https://jenkins.entandocloud.com/job/de-entando-process-driven-plugin-master/)\n[![Coverage Status](https://coveralls.io/repos/github/entando/entando-process-driven-plugin/badge.svg?branch=master)](https://coveralls.io/github/entando/entando-process-driven-plugin?branch=master)\n\nJenkins X:\n[![Build Status](https://img.shields.io/endpoint?url=https%3A%2F%2Fstatusbadge-jx.apps.serv.run%2Fentando%2Fentando-process-driven-plugin)](https://github.com/entando/devops-results/tree/logs/jenkins-x/logs/entando/entando-process-driven-plugin/master)\n[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=entando_entando-process-driven-plugin\u0026metric=alert_status)](https://sonarcloud.io/dashboard?id=entando_entando-process-driven-plugin)\n[![Coverage](https://sonarcloud.io/api/project_badges/measure?project=entando_entando-process-driven-plugin\u0026metric=coverage)](https://entando.github.io/devops-results/entando-process-driven-plugin/master/jacoco/index.html)\n[![Vulnerabilities](https://sonarcloud.io/api/project_badges/measure?project=entando_entando-process-driven-plugin\u0026metric=vulnerabilities)](https://entando.github.io/devops-results/entando-process-driven-plugin/master/dependency-check-report.html)\n[![Code Smells](https://sonarcloud.io/api/project_badges/measure?project=entando_entando-process-driven-plugin\u0026metric=code_smells)](https://sonarcloud.io/dashboard?id=entando_entando-process-driven-plugin)\n[![Security Rating](https://sonarcloud.io/api/project_badges/measure?project=entando_entando-process-driven-plugin\u0026metric=security_rating)](https://sonarcloud.io/dashboard?id=entando_entando-process-driven-plugin)\n[![Technical Debt](https://sonarcloud.io/api/project_badges/measure?project=entando_entando-process-driven-plugin\u0026metric=sqale_index)](https://sonarcloud.io/dashboard?id=entando_entando-process-driven-plugin)\n\n# Introduction\n\nFor more information and documentation visit: https://developer.entando.com, or https://forum.entando.org. Or for the latest\nnews or product information please visit the main website: https://www.entando.com.\n\nInformation below is for running locally or building from source. For usage information see the links above.\n\n\n## Scope\n\nThe scope of this service is to provide a clean and simple API to allow Micro Frontend Widgets to integrate with BPM Providers:\n\n## Environment Configuration\n\nYou'll need these environment variables set in order to run the project. Some variables are **required** and _MUST_ be set in order to run the server:\n\n### Required Environment Variables:\n\n\u003e - `PORT`: TCP Port where the server will run. Default: `8081`\n\u003e - `KEYCLOAK_AUTH_URL`: The keycloak authentication URL. Default: `http://localhost:8081/auth`\n\u003e - `KEYCLOAK_REALM`: The keycloak realm. Default: `entando-development`\n\u003e - `KEYCLOAK_CLIENT_ID`: The keycloak resource/clientId. Default: `entando-pda`\n\u003e - `KEYCLOAK_CLIENT_SECRET`: The keycloak client secret.\n\n### Optional Environment Variables:\n\n\u003e - `LOG_LEVEL`: Log level. Default: `INFO`\n\n## Development\n\nEntando PDA Plugin uses Entando `web-commons` and `keycloak-connector`.\n\nIn order to make it work on dev environment, you have to clone and install the dependencies\nor just add to your IntelliJ workspace.\n\n- Web Commons: https://github.com/entando/web-commons\n- Keycloak Connector: https://github.com/entando/keycloak-commons\n\n```\nmvn spring-boot:run -Dspring-boot.run.profiles=dev\n```\n\n## API Docs\n\nSwagger Docs are available at http://localhost:8080/swagger-ui.html\n\n## Docker Hub\n\nLatest version deployed on Docker Hub:\n\n- https://hub.docker.com/r/entando/entando-process-driven-plugin\n\n## Sonar Cloud Report:\n\n- https://sonarcloud.io/dashboard?id=entando_entando-process-driven-plugin\n\n## Configuration and Manual Steps\n### Initial Deploy\n1. Log in to Keycloak as an admin and add the PDA roles to your user account. \n   * Go to `Users → admin → Role Mappings` and add the roles for the \nentando-pda-plugin-server\n2. Log in to the App Builder and configure the PDA Connection. \n   * The Page Templates hardcode the name of the datasource. You can choose to change the name there or simply use 'pam-demo' as the connection name.\n   * Set the engine to 'pam' which will work for jBPM or PAM.\n   * Provide your connection URL to the KIE Server rest services, e.g  http://my.server.net:8080/kie-server/services/rest/server\n   * Username/password should be for a service account user in jBPM or PAM itself, e.g. krisv.\n   * The Timeout is in milliseconds, e.g. 60000.\n3. (If you didn't use pam-demo as your datasource name) Go to `Pages → Management` and for the following pages configure the data source for their widgets. Click `Design` on the page, then `Settings` on any widgets with `Settings` to review and update the config settings.\n   * PDA Dashboard\n   * PDA Process Definition\n   * PDA Smart Inbox\n   * PDA Task Details\n\n### Setup the project directory after customization\n1. Prepare the bundle directory: `cp -r bundle_src bundle`\n2. Initialize the project: `ent prj init`\n3. Initialize publication: `ent prj pbs-init` (requires the git bundle repo url)\n\n### Publish the bundle after customization\n1. Build: `ent prj build` (build the frontend and backend) or `ent prj fe-build -a` (to just build the frontend, including changes from bundle_src)\n2. Publish: `ent prj pub` or `ent prj fe-push` (publish all or just the frontend)\n3. Deploy (after connecting to k8s): `ent prj deploy`\n4. Install the bundle via 1) App Builder, 2) `ent prj install`, or 3) `ent prj install --conflict-strategy=OVERRIDE` on subsequent installs.\n5. Iterate steps 1-4 to publish new versions.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fentando%2Fentando-process-driven-plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fentando%2Fentando-process-driven-plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fentando%2Fentando-process-driven-plugin/lists"}