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 Flowon API
PLANE 2API PLANE
Flowon API
REST Endpoints · OpenAPI Docs · Access Control · Versioning
APILogicBlocks for field validation & business rules
APIBusiness OrchestratorProcess Actions trigger Business Orchestrator operations
Business Orchestrator manages the process — Logic evaluates the rules
PLANE 3PROCESS PLANE
Flowon Business Orchestrator
Stages · Routing · Assignments · Escalations
Business OrchestratorLogicFlows run on stage enter & exit
Business OrchestratorLogicBlocks guard stage transitions
Logic is the rules engine — API and Business 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
Business OrchestratorLogicStages use Logic Flows for automation
Business OrchestratorLogicTransitions use Logic Blocks for guards
APILogicActions use Logic Blocks for validation
APIBusiness OrchestratorProcess Actions trigger Business Orchestrator operations
LogicExternalService Connections call external APIs
AllEventsCustom events for cross-component communication

Product Interactions

Logic ↔ Business Orchestrator

Flowon Business Orchestrator leverages Flowon Logic 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

Flowon API 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"

Business Orchestrator ↔ API

API exposes Business Orchestrator operations:

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

POST /api/orders/{id}/actions/approve
└── Triggers Business 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, Business 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
TriggerBusiness OrchestratorProcess
chains ↓
Business Orchestrator Chain — triggered by TriggerBusiness OrchestratorProcess
Business Orchestrator
Process Started
Event
ProcessStarted
Handler
LogProcessStart

Solution Dependencies

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

Install first
Flowon Base
Foundation — required by all products
Flowon Logic
Logic ToolsLogic Runtime
requires Base
Flowon Business Orchestrator
Business Orchestrator ToolsBusiness Orchestrator Runtime
requires Logic
Flowon API
API ToolsAPI Runtime
requires Base

Data Flow

Every request entering the platform passes through a consistent processing pipeline. Flowon API acts as the entry point, delegating to Logic for business rules and Dataverse for persistence. Business 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
Flowon API
Authentication · Authorization · Request routing
Flowon Logic
Validation · Business Rules · Pre/Post processing
Dataverse
CRUD operation executed against the data store
Flowon Business Orchestrator
Process trigger — if applicable to the operation
Events
Event handlers — notify subscribers, trigger side-effects

Next Steps