Skip to main content

Export Operations

The export command extracts artifacts from a Dynamics 365 environment for version control and deployment.

Export Command Syntax

flowon export [options]

Options:
-s, --solution <n> Solution name to export
-p, --project <n> FlowOn project to export
-o, --output <path> Output directory
--managed Export as managed solution
--unmanaged Export as unmanaged solution
--include-data Include business data
--data-spec <path> Path to data specification file
-c, --connection <string> Connection string

Export Outputs

Solution Files

artifacts/
├── solutions/
│ ├── CustomerPortal_1.0.0.0_managed.zip
│ └── CustomerPortal_1.0.0.0_unmanaged.zip

FlowOn Package (.flop)

The .flop file is a comprehensive package containing all FlowOn artifacts:

artifacts/
├── flowon/
│ └── CustomerPortal.flop

Contents of .flop file:

ComponentDescription
Logic BlocksReusable logic components
FlowsFlow definitions and configurations
BPM ProcessesBusiness process definitions
APIsFlowOn API configurations
EventsEvent subscriptions and handlers
Service ConnectionsExternal service configurations
RecipesLogic Recipe definitions

Configuration and Data

artifacts/
├── data/
│ ├── moj_documenttype.xml
│ ├── moj_statusreason.xml
│ └── moj_notificationtemplate.xml
├── mappings/
│ ├── configuration.map.xml
│ ├── entity.map.xml
│ ├── localizedresource.map.xml
│ └── serviceconnection.map.xml

Export Examples

Export solution and FlowOn package:

flowon export \
--solution "CustomerPortal" \
--project "CustomerPortal" \
--output "./artifacts" \
--managed \
--unmanaged

Export with business data:

flowon export \
--solution "CustomerPortal" \
--project "CustomerPortal" \
--output "./artifacts" \
--include-data \
--data-spec "./specs/data-spec.xml"

.flop Package Contents

The FlowOn Package (.flop) is an extracted archive containing all FlowOn artifacts organized by category:

CustomerPortal.flop/

├── Api/ # API Configurations
│ ├── flwn_api/ # API definitions
│ │ └── [api-guid]/
│ │ └── data.xml
│ └── flwn_apiversion/ # API versions
│ └── [version-guid]/
│ └── data.xml

├── Logic/ # Logic Components
│ ├── flwn_configuration/ # Configuration settings
│ ├── flwn_eventdefinition/ # Event definitions
│ ├── flwn_eventhandler/ # Event handlers
│ ├── flwn_localizedresource/ # Localized strings
│ ├── flwn_logicblock/ # Logic Block definitions
│ ├── flwn_logicflow/ # Logic Flow definitions
│ ├── flwn_logicrecipe/ # Logic Recipe definitions
│ ├── flwn_schedule/ # Scheduled jobs
│ └── flwn_serviceconnection/ # External service connections

├── Mappings/ # Data Mapping Files
│ ├── configuration.datamap.xml
│ ├── entity.datamap.xml
│ ├── localizedresources.datamap.xml
│ └── serviceconnection.datamap.xml

├── Process/ # BPM Components
│ ├── flwn_businessprocess/ # Business process definitions
│ └── flwn_businessprocessversion/ # Process versions

└── manifest.xml # Package manifest

Package Categories

CategoryFolderContents
Api/ApiFlowOn API definitions and versions
Logic/LogicLogic Blocks, Flows, Recipes, Events, Schedules, Service Connections
Mappings/MappingsEnvironment-specific data mapping files
Process/ProcessBPM Business Processes and versions

Entity Types in .flop

EntityDescription
flwn_apiAPI definition records
flwn_apiversionAPI version records
flwn_configurationConfiguration key-value pairs
flwn_eventdefinitionCustom event definitions
flwn_eventhandlerEvent handler subscriptions
flwn_localizedresourceMulti-language text resources
flwn_logicblockLogic Block definitions
flwn_logicflowLogic Flow definitions
flwn_logicrecipeLogic Recipe definitions
flwn_scheduleScheduled job definitions
flwn_serviceconnectionExternal service connection configs
flwn_businessprocessBPM process definitions
flwn_businessprocessversionBPM process versions

manifest.xml

The manifest file contains package metadata:

<?xml version="1.0" encoding="utf-8"?>
<Manifest>
<ProjectName>CustomerPortal</ProjectName>
<ExportDate>2025-01-15T10:30:00Z</ExportDate>
<ExportedBy>admin@company.com</ExportedBy>
<SourceEnvironment>https://dev.crm.dynamics.com</SourceEnvironment>
<FlowOnVersion>1.0.224</FlowOnVersion>
<Contents>
<Category name="Api" count="2" />
<Category name="Logic" count="45" />
<Category name="Mappings" count="4" />
<Category name="Process" count="8" />
</Contents>
</Manifest>