Flowon.Xrm.Tools.CommandLine 1.1.2

Flowon.Xrm.Tools.CommandLine

A .NET global tool that provides a command-line interface for automating Flowon Logic Fabric (Flowon for Dynamics 365 / Microsoft Dataverse) tasks — exporting and importing Flowon projects, managing plugins and Logic Recipes, generating OpenAPI schemas and documentation, and versioning solutions. Ideal for build pipelines and ALM/DevOps automation.

Installation

Install the tool globally with the .NET CLI:

dotnet tool install --global Flowon.Xrm.Tools.CommandLine

Once installed, the tool is available on the PATH as flowon-dynamics:

flowon-dynamics --help

To update to the latest version:

dotnet tool update --global Flowon.Xrm.Tools.CommandLine

Usage

flowon-dynamics <command> [options]

Every command that talks to Dataverse requires a --connectionstring (-c) option. This is a standard Dataverse ServiceClient connection string, for example:

AuthType=ClientSecret;Url=https://contoso.crm.dynamics.com;ClientId=<app-id>;ClientSecret=<client-secret>

Most commands also accept --log-level (-l) to control console output verbosity:

Value	Description
None (default)	No logging is emitted.
Info	Minimal logging for tracking progress.
Verbose	Detailed logging for diagnostic purposes.

Commands

Command	Alias	Description
projects	p	Lists Flowon projects in the target environment.
features	f	Lists installed Flowon features.
export	e	Exports a Flowon project and/or its Dynamics 365 solution.
import	i	Imports a Flowon package, a Dynamics 365 solution, and/or data files.
generate-mappings	gm	Extracts data mapping files from a Flowon project file.
apply-mappings	am	Applies data mapping files to a Flowon project.
generate-openapi	openapi	Generates the OpenAPI schema for a Flowon API.
publish-api	pa	Publishes the draft version of a Flowon API.
enable-plugins	ep	Enables Flowon plugins in the target environment.
disable-plugins	dp	Disables Flowon plugins in the target environment.
enable-recipe	er	Enables one or more Logic Recipes.
disable-recipe	dr	Disables one or more Logic Recipes.
increment-solution-version	isv	Increments the version of a Dynamics 365 solution.
create-patch	cp	Creates a new solution patch.
docs	d	Generates documentation for a Flowon package.

Run flowon-dynamics <command> --help at any time to see the options for a specific command.

---

projects

Lists the Flowon projects deployed in the target environment, together with their associated solution name, solution type, and publisher prefix.

Option	Alias	Required	Description
--connectionstring	-c	Yes	The connection string for Dynamics 365.
--log-level	-l	No	Log verbosity (default None).

flowon-dynamics projects -c "AuthType=ClientSecret;Url=https://contoso.crm.dynamics.com;ClientId=<id>;ClientSecret=<secret>"

features

Lists the Flowon features that are installed in the target environment.

Option	Alias	Required	Description
--connectionstring	-c	Yes	The connection string for Dynamics 365.
--log-level	-l	No	Log verbosity (default None).

flowon-dynamics features -c "AuthType=ClientSecret;Url=https://contoso.crm.dynamics.com;ClientId=<id>;ClientSecret=<secret>"

export

Exports a Flowon project (.flop package) and, optionally, its associated Dynamics 365 solution (managed and/or unmanaged) and a data export driven by a data specification file.

Option	Alias	Required	Description
--connectionstring	-c	Yes	The connection string for Dynamics 365.
--project-name	-p	Yes	The name of the Flowon project to export.
--solution-managed	-sm	No	Export the managed solution associated with the project (default false).
--solution-unmanaged	-su	No	Export the unmanaged solution associated with the project (default false). Fails if the underlying solution is managed.
--output-directory	-o	Yes	The output directory. Created automatically if it doesn't exist.
--data-spec-file-path	-ds	No	Path to a data specification file describing which data to export.
--log-level	-l	No	Log verbosity (default None).

flowon-dynamics export `
  -c "AuthType=ClientSecret;Url=https://contoso.crm.dynamics.com;ClientId=<id>;ClientSecret=<secret>" `
  -p "Contoso Sales" `
  -sm -su `
  -o "./out" `
  -ds "./data-spec.json"

import

Imports a Dynamics 365 solution and/or Flowon package into the target environment, optionally seeding data via data files and applying data map files while importing a Flowon package. At least one of --package-file-path, --solution-file-path, or --data-file-path must be supplied.

Option	Alias	Required	Description
--connectionstring	-c	Yes	The connection string for Dynamics 365.
--package-file-path	-p	No	Path to the Flowon package (.flop) file to import.
--solution-file-path	-s	No	Path to the Dynamics 365 solution file to import.
--override-unmanaged-customizations	-oc	No	Overwrite unmanaged customizations layered on top of existing managed solution components. Requires --solution-file-path.
--map-file-path	-m	No	One or more Flowon mapping file paths to apply while importing a package. Requires --package-file-path.
--data-file-path	-d	No	One or more Flowon data file paths to import.
--log-level	-l	No	Log verbosity (default None).

flowon-dynamics import `
  -c "AuthType=ClientSecret;Url=https://contoso.crm.dynamics.com;ClientId=<id>;ClientSecret=<secret>" `
  -s "./ContosoSales_managed.zip" -oc `
  -p "./ContosoSales.flop" `
  -m "./mappings/Account.map" "./mappings/Contact.map" `
  -d "./data/seed-data.flod"

generate-mappings

Extracts the data mapping files bundled inside a Flowon project (.flop) file to a local directory, so they can be inspected or customized before being re-applied with apply-mappings.

Option	Alias	Required	Description
--project-file-path	-p	Yes	The Flowon project file path.
--output-directory	-o	Yes	The output directory for the extracted mapping files. Created automatically if it doesn't exist.
--log-level	-l	No	Log verbosity (default None).

flowon-dynamics generate-mappings -p "./ContosoSales.flop" -o "./mappings"

apply-mappings

Applies one or more Flowon data mapping files against a Flowon project already deployed in the target environment.

Option	Alias	Required	Description
--connectionstring	-c	Yes	The connection string for Dynamics 365.
--project-name	-p	Yes	The name of the Flowon project to apply the mapping files to.
--map-file-path	-m	No	One or more Flowon mapping file paths to apply.
--log-level	-l	No	Log verbosity (default None).

flowon-dynamics apply-mappings `
  -c "AuthType=ClientSecret;Url=https://contoso.crm.dynamics.com;ClientId=<id>;ClientSecret=<secret>" `
  -p "Contoso Sales" `
  -m "./mappings/Account.map" "./mappings/Contact.map"

generate-openapi

Generates the OpenAPI (Swagger) schema file for a published Flowon API. If --version is omitted, the latest published version is used.

Option	Alias	Required	Description
--connectionstring	-c	Yes	The connection string for Dynamics 365.
--project-name	-p	Yes	The name of the Flowon project associated with the API.
--api	-a	Yes	The name of the Flowon API to export.
--version	-v	No	The published API version. Defaults to the latest published version.
--output-directory	-o	Yes	The output directory for the generated schema file. Created automatically if it doesn't exist.
--log-level	-l	No	Log verbosity (default None).

flowon-dynamics generate-openapi `
  -c "AuthType=ClientSecret;Url=https://contoso.crm.dynamics.com;ClientId=<id>;ClientSecret=<secret>" `
  -p "Contoso Sales" -a "Sales API" -o "./schemas"

publish-api

Publishes the draft version of a Flowon API as a new major or minor version.

Option	Alias	Required	Description
--connectionstring	-c	Yes	The connection string for Dynamics 365.
--project	-p	Yes	The Flowon project associated with the API.
--api	-a	Yes	The name of the Flowon API to publish.
--version	-v	No	The publish strategy: Major (default) or Minor.
--log-level	-l	No	Log verbosity (default None).

flowon-dynamics publish-api `
  -c "AuthType=ClientSecret;Url=https://contoso.crm.dynamics.com;ClientId=<id>;ClientSecret=<secret>" `
  -p "Contoso Sales" -a "Sales API" -v Minor

enable-plugins

Enables all Flowon plugin steps in the target environment.

Option	Alias	Required	Description
--connectionstring	-c	Yes	The connection string for Dynamics 365.
--log-level	-l	No	Log verbosity (default None).

flowon-dynamics enable-plugins -c "AuthType=ClientSecret;Url=https://contoso.crm.dynamics.com;ClientId=<id>;ClientSecret=<secret>"

disable-plugins

Disables all Flowon plugin steps in the target environment. Useful before a bulk data import to prevent plugins from firing.

Option	Alias	Required	Description
--connectionstring	-c	Yes	The connection string for Dynamics 365.
--log-level	-l	No	Log verbosity (default None).

flowon-dynamics disable-plugins -c "AuthType=ClientSecret;Url=https://contoso.crm.dynamics.com;ClientId=<id>;ClientSecret=<secret>"

enable-recipe

Enables one or more Flowon Logic Recipes for a given project.

Option	Alias	Required	Description
--connectionstring	-c	Yes	The connection string for Dynamics 365.
--project	-p	Yes	The Flowon project associated with the recipe(s).
--recipe	-r	Yes	One or more recipe names to enable.
--log-level	-l	No	Log verbosity (default None).

flowon-dynamics enable-recipe `
  -c "AuthType=ClientSecret;Url=https://contoso.crm.dynamics.com;ClientId=<id>;ClientSecret=<secret>" `
  -p "Contoso Sales" -r "Lead Qualification" "Order Approval"

disable-recipe

Disables one or more Flowon Logic Recipes for a given project.

Option	Alias	Required	Description
--connectionstring	-c	Yes	The connection string for Dynamics 365.
--project	-p	Yes	The Flowon project associated with the recipe(s).
--recipe	-r	Yes	One or more recipe names to disable.
--log-level	-l	No	Log verbosity (default None).

flowon-dynamics disable-recipe `
  -c "AuthType=ClientSecret;Url=https://contoso.crm.dynamics.com;ClientId=<id>;ClientSecret=<secret>" `
  -p "Contoso Sales" -r "Lead Qualification"

increment-solution-version

Increments the version number of a Dynamics 365 solution using the specified strategy.

Option	Alias	Required	Description
--connectionstring	-c	Yes	The connection string for Dynamics 365.
--solution	-s	Yes	The unique name of the Dynamics 365 solution.
--version	-v	Yes	The increment strategy: Major, Minor, Revision, or Build.
--log-level	-l	No	Log verbosity (default None).

flowon-dynamics increment-solution-version `
  -c "AuthType=ClientSecret;Url=https://contoso.crm.dynamics.com;ClientId=<id>;ClientSecret=<secret>" `
  -s "ContosoSales" -v Build

create-patch

Creates a new solution patch for an existing Dynamics 365 solution.

Option	Alias	Required	Description
--connectionstring	-c	Yes	The connection string for Dynamics 365.
--solution-name	-sn	Yes	The unique name of the parent solution to create a patch for.
--patch-name	-pn	Yes	The display name of the solution patch.
--version	-v	No	The version of the patch (e.g. 1.0.0.1). Must be a valid version if specified.
--log-level	-l	No	Log verbosity (default None).

flowon-dynamics create-patch `
  -c "AuthType=ClientSecret;Url=https://contoso.crm.dynamics.com;ClientId=<id>;ClientSecret=<secret>" `
  -sn "ContosoSales" -pn "ContosoSales Patch 1" -v "1.0.0.1"

docs

Generates human-readable documentation from the contents of a Flowon package (.flop) file.

Option	Alias	Required	Description
--package-file-path	-p	Yes	The Flowon package file path to generate documentation for.
--output-directory	-o	Yes	The output directory where the documentation is saved.
--log-level	-l	No	Log verbosity (default None).

flowon-dynamics docs -p "./ContosoSales.flop" -o "./docs"

License

Copyright © Flowon Corp. All rights reserved.