Skip to main content

Flowon CLI Tools

Version: 1.0
Last Updated: January 2025


Introduction​

At Flowon, we value software development engineering processes and best practices. Many enterprise projects fail not because of technical limitations, but because of the lack of sound engineering practices around deployment, versioning, and environment management. Flowon CLI Tools embodies our commitment to bringing modern DevOps practices to the Dataverse ecosystem.

Continuous Integration (CI) is the practice of frequently merging code changes into a shared repository, where automated builds and tests verify each change. Continuous Delivery (CD) extends this by automatically deploying validated changes to testing or production environments. Together, CI/CD forms the backbone of modern software delivery, enabling teams to release high-quality software faster and more reliably.

Flowon CLI Tools is an enterprise-grade command-line toolkit that brings these practices to Dataverse and Flowon projects. It automates the complete lifecycle of exporting, versioning, transforming, and deploying solutions, configurations, and data across environments - turning what was once a manual, error-prone process into a reliable, repeatable pipeline.

Flowon CLI Tools - CustomerPortal CI/CD Pipeline
RUNNING
~/CustomerPortal $Β 
Pipeline
πŸ“¦
Export
flowon export
β€”
πŸ”–
Version
increment-solution-version
β€”
πŸ—ΊοΈ
Mappings
generate-mappings
β€”
πŸ“„
OpenAPI
generate-openapi
β€”
πŸš€
Deploy
flowon import
β€”
Artifacts
CustomerPortal_managed.zip
CustomerPortal.flop
mappings.uat.xml
mappings.prod.xml
openapi.json
Environments
πŸ§ͺ
UAT
β€”
βš—οΈ
Staging
β€”
🌐
Production
β€”

Why CI/CD Matters​

Organizations that adopt CI/CD practices experience:

  • 70% reduction in deployment failures
  • 50% faster time to market for new features
  • 90% reduction in manual deployment effort
  • Near-zero environment drift between stages
  • Complete auditability of all changes
Without CI/CD
With Flowon CLI Tools
βœ•Manual exports
β†’
βœ“Automated exports
βœ•Copy/paste deployments
β†’
βœ“One-command deployments
βœ•"It works on my machine"
β†’
βœ“Consistent environments
βœ•No change history
β†’
βœ“Full Git history
βœ•Weekend deployments
β†’
βœ“Continuous delivery
βœ•Rollback? Start over
β†’
βœ“Instant rollbacks
βœ•Environment drift
β†’
βœ“Environment parity
βœ•Tribal knowledge
β†’
βœ“Documented pipelines
βœ•Fear of releases
β†’
βœ“Confidence in releases

Core Capabilities​

Flowon CLI Tools - Core Capabilities
Export
Solutions
Flowon Files (.flop)
Configuration
Business Data
Import
Solutions
Flowon Files (.flop)
Configuration
Business Data
Versioning
Solution versions
API versions
Semantic versioning
Data Mapping
Config maps
Entity maps
Localization
Connections
OpenAPI
Schema generation
Swagger docs
Client generation
Plugin Mgmt
Enable / Disable plugins
Recipe management
Deployment control

What Gets Exported/Imported​

Artifact TypeDescriptionFile Format
Dynamics SolutionsStandard CRM solutions (entities, forms, views, plugins, workflows)Managed/Unmanaged .zip
Flowon Package (.flop)Logic Blocks, Flows, Processes, APIs, Events, Service Connections, Recipes, Schedules.flop (structured XML)
Configuration DataEnvironment-specific settings, feature flags, URLsXML mapping files
Business DataReference data, lookup tables, seed dataXML data files
Localized ResourcesMulti-language labels, messages, templatesXML mapping files
Service ConnectionsExternal API configurations, credentials, certificatesXML mapping files

Tooling Capabilities Summary​

CapabilityCommandDescription
List Featuresflowon-dynamics featuresLists installed Flowon features
List Projectsflowon-dynamics projectsLists Flowon projects
Exportflowon-dynamics exportExports Dataverse and Flowon artifacts
Importflowon-dynamics importImports artifacts to target environment
Generate Mappingsflowon-dynamics generate-mappingsCreates data mapping files
Apply Mappingsflowon-dynamics apply-mappingsApplies transformations
Generate OpenAPIflowon-dynamics generate-openapiGenerates API documentation
Enable Pluginsflowon-dynamics enable-pluginsActivates Flowon plugins
Disable Pluginsflowon-dynamics disable-pluginsDeactivates Flowon plugins
Enable Recipeflowon-dynamics enable-recipeActivates Logic Recipes
Disable Recipeflowon-dynamics disable-recipeDeactivates Logic Recipes
Increment Versionflowon-dynamics increment-solution-versionBumps solution version
Generate Docsflowon-dynamics docsGenerates documentation

Next Steps​