Skip to content

Organization Structure ​

When integrating a business system with the workflow engine, organization data (departments, users, groups, positions) must be synchronized so that assignees, permissions, and related features work correctly.

See Integration with Business Systems for the full integration path.

Overview ​

The workflow engine organization model includes departments, users, groups, positions, and their relationships. In production, data should be synchronized from the business system rather than using built-in test data.

Testing vs production

  • Testing: You may use the engine's built-in organization data for API integration.
  • Production: Organization data must be synchronized from the business system, with user and department IDs consistent with the business system.

Implementation ​

Adapter development ​

Implement an organization adapter to read data from the business system and load it into the workflow engine. Common approaches:

  • Extend the organization adapter interface according to your business data model
  • Pull organization data from the business system via REST APIs
  • Configure scheduled sync via SQL when the data source is directly accessible

Online configuration ​

The management console supports configuring data sources and sync policies, including:

  • Enable/disable data sources
  • Initialization mode and sync frequency
  • SQL or API configuration for departments, users, groups, positions, etc.