https://github.com/tompaana/dynamic-form-flow-sample
This sample demonstrates how to add dynamic features to form flows of a bot built on Microsoft Bot Framework.
https://github.com/tompaana/dynamic-form-flow-sample
Last synced: 8 months ago
JSON representation
This sample demonstrates how to add dynamic features to form flows of a bot built on Microsoft Bot Framework.
- Host: GitHub
- URL: https://github.com/tompaana/dynamic-form-flow-sample
- Owner: tompaana
- License: mit
- Created: 2016-12-08T10:59:26.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2016-12-14T15:13:45.000Z (about 9 years ago)
- Last Synced: 2025-04-08T08:06:03.789Z (9 months ago)
- Language: C#
- Size: 368 KB
- Stars: 8
- Watchers: 4
- Forks: 7
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Dynamic FormFlow Sample #
This sample demonstrates how to add dynamic features to FormFlow implementation
of a bot built on Microsoft Bot Framework. The central points are explained in
my blog post creatively named
[How to Create Dynamic FormFlow](http://tomipaananen.azurewebsites.net/?p=1641).
The approach implemented by this sample is especially useful for scenarios where
the user is searching an item from an existing catalog. Instead of displaying
all the options for narrowing down the desired item, we only display options
available based on the data previously collected. In some cases we can skip part
of the queries altogether as they have but only one option. See the three
example flows below.
**Few examples of the flow:**
| Flow 1 | Flow 2 | Flow 3 |
| ------ | ------ | ------ |
|  |  |  |
## Important classes ##
**[Spaceship](/DynamicFormFlowSample/Models/Spaceship.cs)** represents the item
we are searching for and its properties. This is the class the FormFlow takes
and starts filling values with.
**[SpaceshipData](/DynamicFormFlowSample/Data/SpaceshipData.cs)** contains the
catalog and some helper methods.
**[SpaceshipSelectionForm](/DynamicFormFlowSample/Forms/SpaceshipSelectionForm.cs)**
contains the FormFlow builder and the methods implementing the dynamics:
checking if the fields (queries) are necessary, what options should be available
and response validation.
**[SpaceshipSelectionDialog](/DynamicFormFlowSample/Dialogs/SpaceshipSelectionDialog.cs)**
is the root dialog of the bot and takes control of the flow once the FormFlow
is finished. If more than one option remains, it will display a carousel of the
spaceships left for the user to choose from.
## See also ##
* [FormFlow documentation](https://docs.botframework.com/en-us/csharp/builder/sdkreference/forms.html)
* [Pizza Bot Sample](https://github.com/Microsoft/BotBuilder/tree/master/CSharp/Samples/PizzaBot)