# Forms Wizard Launcher (cf.cplace.formsWizard.formsWizardExecution)

## Overview

The Forms Wizard Launcher app provides a widget for starting Forms Wizards from page layouts. It enables embedding wizard launch buttons directly into pages, allowing end users to initiate guided, multi-step data collection workflows. Additionally, this app can replace the standard "Create page" function with a customized Forms Wizard.

**Icon**: fa-info

## Dependencies

This app has no additional app dependencies beyond the platform:
- `cf.cplace.platform` (cplace Basis) - always installed

**Note**: This app is a companion to the core Forms Wizard app (`cf.cplace.formsWizard`). While it can be installed independently, its widget launches wizards created and configured via the Forms Wizard app. For full wizard functionality, the `cf.cplace.formsWizard` app must also be installed in the workspace.

## Types Provided

**None** - This app provides no custom types. It is a widget-only app that extends the cplace platform with a wizard launch button.

## Widgets Provided

| Widget | Widget Kind | Embedding Context | Description | Use Case |
|--------|-------------|-------------------|-------------|----------|
| Start Wizard | `cf.cplace.formsWizard.startWizardWidget` | INSIDE_RICHSTRING | Button widget for launching a Forms Wizard | Place on pages where users need to start a guided wizard for creating or editing pages |

### Start Wizard Widget Details

**Purpose**: Provides a button that launches a multi-step Forms Wizard for guided page creation or data collection workflows.

**Key Features**:
- Launches configured Forms Wizards from within page layouts
- Supports integration with connected table widgets
- Supports conditional visibility via Low-Code scripts
- Renders as a button inside rich string content (not as a standalone framed widget)

**Embedding Context**: `INSIDE_RICHSTRING` only — this widget is embedded inside Rich String widgets without a frame, not placed as a standalone widget in the layout grid.

**Configuration Requirements**:
- Must reference an active Forms Wizard (created and configured via the `cf.cplace.formsWizard` app)
- The referenced wizard must be activated before it can be launched

**Tags**: `form`, `references`, `searchable`, `connected`, `low-code`

## Usage Notes

### When to Use This App

- **Guided Page Creation**: When users should create pages through a multi-step wizard rather than the standard "Create page" dialog
- **Embedded Wizard Buttons**: When wizard launch buttons need to appear directly on pages (dashboards, overview pages, type layouts)
- **Custom Create Replacement**: When the standard "Create page" function should be replaced with a wizard for specific types

### Prerequisites

1. The `cf.cplace.formsWizard` app must be installed in the same workspace (provides wizard configuration types and administration widgets)
2. At least one Forms Wizard must be configured and activated
3. The wizard's triggering type must match the context where the Start Wizard widget is placed

### Common Patterns

1. **Dashboard Launch Button**: Place widget on a dashboard page inside a Rich String widget to provide a prominent "Start Wizard" button
2. **Type Overview Button**: Embed widget on type overview pages so users can create new instances via guided wizard
3. **Connected Table Integration**: Connect the widget to a table widget to launch wizards in the context of selected items

### Key Considerations

- Install this app in every workspace where end users need to launch wizards — the main Forms Wizard app alone only provides wizard configuration/administration capabilities
- The widget only appears in the `INSIDE_RICHSTRING` embedding context, so it must be placed inside a Rich String widget
- Wizards must be activated (via the Wizard Activation widget from `cf.cplace.formsWizard`) before they can be launched

## Related Apps

| App | Relationship |
|-----|--------------|
| `cf.cplace.formsWizard` (Forms Wizard) | Provides wizard configuration types, administration widgets, and the wizard execution engine; must be installed for wizards to function |

## Investigation Metadata

- **Date**: 2026-04-01
- **Workspace**: [App Investigation] cf.cplace.formsWizard.formsWizardExecution
- **Platform version**: Current (localhost:8083)