Files
espocrm/custom/workflows

Workflow Definitions

This directory contains workflow definitions in JSON format that can be imported into EspoCRM using the workflow manager script.

File Format

Simple Workflow

{
    "type": "simple",
    "name": "workflow-name",
    "entity_type": "EntityName",
    "trigger_type": "afterRecordSaved",
    "is_active": true,
    "description": "Description of what this workflow does",
    "category": "Category Name",
    "conditions_all": [],
    "conditions_any": [],
    "conditions_formula": null,
    "actions": []
}

Trigger Types:

  • afterRecordSaved - After record is created or updated
  • afterRecordCreated - Only after record is created
  • scheduled - Runs on a schedule
  • manual - Manually triggered

Condition Types:

  • equals, notEquals, greaterThan, lessThan, contains, notContains, isEmpty, isNotEmpty, isTrue, isFalse, wasEqual, wasNotEqual, changed, notChanged

Action Types:

  • sendEmail - Send email to recipient
  • createEntity - Create a new record
  • updateEntity - Update current record
  • relateTo - Link to another record
  • unrelateFrom - Unlink from record
  • applyAssignmentRule - Apply assignment rules
  • createNotification - Create notification

BPM Flowchart

{
    "type": "bpm",
    "name": "flowchart-name",
    "target_type": "EntityName",
    "is_active": true,
    "description": "Description",
    "data": {
        "list": []
    },
    "elements_data_hash": {},
    "event_start_all_id_list": []
}

Usage

Import a workflow:

docker exec espocrm php /var/www/html/custom/scripts/workflow_manager.php import /var/www/html/custom/workflows/your-workflow.json

Export a workflow:

docker exec espocrm php /var/www/html/custom/scripts/workflow_manager.php export <workflow-id> /var/www/html/custom/workflows/exported.json

Examples

  • vmh-erstberatung-abschliessen.json - Sends email and sets status when consultation is completed