FOUR-22532: Integrations - Colleague

[eiresendez]

This PR addresses the implementation of the Colleague Integration Epic for automation via Playwright Bot Script in ProcessMaker.

Solution

This PR includes the following key features:

• BOT Automation: Implements a DOM-based automation system for ProcessMaker BOTs to interact with Colleague forms.
• Instruction Interface: Adds an admin panel to configure BOT instructions
• BOTs now map and submit data from internal TCE tables (atce_logging_history, atce_course_admin_period, atce_substitution) to specific forms in Colleague
• Implements RUN TEST functionality for validating field mapping before submission
• Validation & Error Handling: Includes mechanisms to verify data integrity before submission and log failures

How to test

1. Navigate to the ProcessMaker Admin interface > FormBot.
2. Create or edit a BOT, enter valid JSON/JS instructions and verify Logs.
3. Use RUN TEST to simulate TCE Colleague data submission.
4. Confirm Colleague records reflect accurate data
5. Check error logs for edge cases (missing or invalid fields).
6. Validate results in Colleague directly via the corresponding forms

Related tickets

• FOUR-22532
• Package SIS Integration PR

.

[processmaker-sonarqube]

Quality Gate passed

Issues
0 New issues
0 Fixed issues
0 Accepted issues

Measures
0 Security Hotspots
No data about Coverage
No data about Duplication

See analysis details on SonarQube