Skip to main content

Integration Architecture

Flowon products are designed to work together seamlessly, creating a unified platform for no-code development.

Architecture Overview

SOURCE OF REQUEST
Business Intent → Dynamics 365 CE
PLANE 1ACCESS PLANE
Web AppsMobile AppsExternal APIsCI/CD Pipelines
requests enter via API Builder
PLANE 2API PLANE
API Builder
REST Endpoints · OpenAPI Docs · Access Control · Versioning
APILogicBlocks for field validation & business rules
APIProcess OrchestratorProcess Actions trigger Process Orchestrator operations
Process Orchestrator manages the process - Logic evaluates the rules
PLANE 3PROCESS PLANE
Process Orchestrator
Stages · Routing · Assignments · Escalations
Process OrchestratorLogicFlows run on stage enter & exit
Process OrchestratorLogicBlocks guard stage transitions
Logic is the rules engine - API and Process Orchestrator both delegate to it
PLANE 4LOGIC PLANEFOUNDATION
FLOWON LOGIC - ALL PRODUCTS BUILD ON THIS
Blocks
Formulas · Decisions · Validations
Flows
Multi-step automation
Recipes
Event-driven triggers
SERVICE CONNECTIONSLogic calls external APIs · OAuth · REST · SOAP
EVENT BUS
All products emit & subscribe to custom events · Handlers · Schedules · Cross-product communication
All planes operate natively within the Dynamics 365 CE environment

Integration Points

FromToIntegration
Process OrchestratorLogicStages use Logic Flows for automation
Process OrchestratorLogicTransitions use Logic Blocks for guards
APILogicActions use Logic Blocks for validation
APIProcess OrchestratorProcess Actions trigger Process Orchestrator operations
LogicExternalService Connections call external APIs
AllEventsCustom events for cross-component communication

Product Interactions

Logic ↔ Process Orchestrator

Process Orchestrator leverages Logic Composer extensively:

Business Process Stage
├── On Entering
│ └── Run Logic Flow: "InitializeStage"
├── Assignment
│ └── Run Decision Table: "DetermineAssignee"
├── Validation
│ └── Run Validation Set: "StageValidations"
├── On Exiting
│ └── Run Logic Flow: "FinalizeStage"
└── Transitions
└── Guard: Run Logic Block: "CanTransition"

Logic ↔ API

API Builder uses Logic for business rules:

API Action: CreateOrder
├── Pre-Validation
│ └── Run Validation Set: "OrderValidations"
├── Pre-Processing
│ └── Run Logic Flow: "PrepareOrder"
├── Execute (CRUD operation)
└── Post-Processing
└── Run Logic Flow: "ProcessOrderCreated"

Process Orchestrator ↔ API

API exposes Process Orchestrator operations:

POST /api/orders/{id}/actions/submit
└── Triggers Process Orchestrator Transition: "Submit for Approval"

POST /api/orders/{id}/actions/approve
└── Triggers Process Orchestrator Transition: "Approve"

GET /api/orders/{id}/process-status
└── Returns current stage, history, available actions

Event-Driven Integration

Flowon's event system enables loose coupling between products. Instead of direct calls, components emit named events that any number of handlers can subscribe to - including Logic Flows, Process Orchestrator triggers, and external integrations. This allows the platform to react to business activity without hard-wiring dependencies between products.

Trigger
Order Created
Event
OrderCreated
SendConfirmationEmail
UpdateInventory
NotifySalesTeam
TriggerProcess OrchestratorProcess
chains ↓
Process Orchestrator Chain - triggered by TriggerProcess OrchestratorProcess
Process Orchestrator
Process Started
Event
ProcessStarted
Handler
LogProcessStart

Solution Dependencies

Flowon products are packaged as separate Dataverse solutions and must be installed in dependency order. Flowon Base is the shared foundation required by all products. Logic Composer extends Base with the declarative engine, and Process Orchestrator requires Logic to be present. API Builder depends only on Base and can be deployed independently.

Install first
Flowon Base
Foundation - required by all products
Logic Composer
Logic ToolsLogic Runtime
requires Base
Process Orchestrator
Process Orchestrator ToolsProcess Orchestrator Runtime
requires Logic
API Builder
API ToolsAPI Runtime
requires Base

Data Flow

Every request entering the platform passes through a consistent processing pipeline. API Builder acts as the entry point, delegating to Logic for business rules and Dataverse for persistence. Process Orchestrator processes run asynchronously alongside this pipeline, reacting to events emitted at each stage.

External Request
Inbound call from Web App, Mobile App, or External System
API Builder
Authentication · Authorization · Request routing
Logic Composer
Validation · Business Rules · Pre/Post processing
Dataverse
CRUD operation executed against the data store
Process Orchestrator
Process trigger - if applicable to the operation
Events
Event handlers - notify subscribers, trigger side-effects

Next Steps