mirror of
https://github.com/Alfresco/alfresco-ng2-components.git
synced 2025-05-12 17:04:57 +00:00
7d061b2c11
* remove deprecated code part 1 * remove deprecation step 2 * fix spellcheck * fix * fix lint * fix not used import * remove deprecation * fix test first part after remove deprecation * fix test * fix sidebar demo shell
81 lines
5.4 KiB
Markdown
81 lines
5.4 KiB
Markdown
---
|
|
Title: Start Form component
|
|
Added: v2.0.0
|
|
Status: Active
|
|
Last reviewed: 2018-06-08
|
|
---
|
|
|
|
# [Start Form component](../../lib/core/form/components/start-form.component.ts "Defined in start-form.component.ts")
|
|
|
|
Displays the Start [`Form`](../../lib/process-services/task-list/models/form.model.ts) for a process.
|
|
|
|
|
|
|
|
## Basic Usage
|
|
|
|
```html
|
|
<adf-start-form
|
|
[processDefinitionId]="currentProcessDef.id"
|
|
(outcomeClick)="onOutcomeClick($event)">
|
|
</adf-start-form>
|
|
```
|
|
|
|
## Class members
|
|
|
|
### Properties
|
|
|
|
| Name | Type | Default value | Description |
|
|
| ---- | ---- | ------------- | ----------- |
|
|
| data | [`FormValues`](../../lib/core/form/components/widgets/core/form-values.ts) | | Custom form values map to be used with the rendered form. |
|
|
| disableCompleteButton | `boolean` | false | If true then the `Complete` outcome button is shown but it will be disabled. |
|
|
| disableStartProcessButton | `boolean` | false | If true then the `Start Process` outcome button is shown but it will be disabled. |
|
|
| fieldValidators | [`FormFieldValidator`](../../lib/core/form/components/widgets/core/form-field-validator.ts)`[]` | \[] | Contains a list of form field validator instances. |
|
|
| form | [`FormModel`](../../lib/core/form/components/widgets/core/form.model.ts) | | Underlying [form model](../../lib/core/form/components/widgets/core/form.model.ts) instance. |
|
|
| formId | `string` | | The id of the form definition to load and display with custom values. |
|
|
| formName | `string` | | Name of the form definition to load and display with custom values. |
|
|
| nameNode | `string` | | Name to assign to the new node where the metadata are stored. |
|
|
| nodeId | `string` | | Content Services node ID for the form metadata. |
|
|
| path | `string` | | Path of the folder where the metadata will be stored. |
|
|
| processDefinitionId | `string` | | Definition ID of the process to start. |
|
|
| processId | `string` | | Process ID of the process to start. |
|
|
| readOnly | `boolean` | false | Toggle readonly state of the form. Forces all form widgets to render as readonly if enabled. |
|
|
| readOnlyForm | `boolean` | false | Is the form read-only (ie, can't be edited)? |
|
|
| saveMetadata | `boolean` | false | Toggle saving of form metadata. |
|
|
| showCompleteButton | `boolean` | true | Toggle rendering of the `Complete` outcome button. |
|
|
| showDebugButton | `boolean` | false | Toggle debug options. |
|
|
| showOutcomeButtons | `boolean` | true | Should form outcome buttons be shown? |
|
|
| showRefreshButton | `boolean` | true | Should the refresh button be shown? |
|
|
| showSaveButton | `boolean` | true | Toggle rendering of the `Save` outcome button. |
|
|
| showTitle | `boolean` | true | Toggle rendering of the form title. |
|
|
| showValidationIcon | `boolean` | true | Toggle rendering of the validation icon next to the form title. |
|
|
| taskId | `string` | | Task id to fetch corresponding form and values. |
|
|
|
|
### Events
|
|
|
|
| Name | Type | Description |
|
|
| ---- | ---- | ----------- |
|
|
| executeOutcome | [`EventEmitter`](https://angular.io/api/core/EventEmitter)`<`[`FormOutcomeEvent`](../../lib/core/form/components/widgets/core/form-outcome-event.model.ts)`>` | Emitted when any outcome is executed. Default behaviour can be prevented via `event.preventDefault()`. |
|
|
| formCompleted | [`EventEmitter`](https://angular.io/api/core/EventEmitter)`<`[`FormModel`](../../lib/core/form/components/widgets/core/form.model.ts)`>` | Emitted when the form is submitted with the `Complete` outcome. |
|
|
| formContentClicked | [`EventEmitter`](https://angular.io/api/core/EventEmitter)`<`[`ContentLinkModel`](../../lib/core/form/components/widgets/core/content-link.model.ts)`>` | Emitted when a field of the form is clicked. |
|
|
| formDataRefreshed | [`EventEmitter`](https://angular.io/api/core/EventEmitter)`<`[`FormModel`](../../lib/core/form/components/widgets/core/form.model.ts)`>` | Emitted when form values are refreshed due to a data property change. |
|
|
| formError | [`EventEmitter`](https://angular.io/api/core/EventEmitter)`<`[`FormFieldModel`](../core/form-field.model.md)`[]>` | Emitted when the supplied form values have a validation error. |
|
|
| formLoaded | [`EventEmitter`](https://angular.io/api/core/EventEmitter)`<`[`FormModel`](../../lib/core/form/components/widgets/core/form.model.ts)`>` | Emitted when the form is loaded or reloaded. |
|
|
| formSaved | [`EventEmitter`](https://angular.io/api/core/EventEmitter)`<`[`FormModel`](../../lib/core/form/components/widgets/core/form.model.ts)`>` | Emitted when the form is submitted with the `Save` or custom outcomes. |
|
|
| error | [`EventEmitter`](https://angular.io/api/core/EventEmitter)`<any>` | Emitted when any error occurs. |
|
|
| outcomeClick | [`EventEmitter`](https://angular.io/api/core/EventEmitter)`<any>` | Emitted when the user clicks one of the outcome buttons that completes the form. |
|
|
|
|
## Details
|
|
|
|
The [Start Process component](../process-services/start-process.component.md) uses the Start [`Form`](../../lib/process-services/task-list/models/form.model.ts) component
|
|
to display the
|
|
[start form](http://docs.alfresco.com/process-services1.6/topics/none_start_event.html)
|
|
for the process.
|
|
|
|
The `outcomeClick` event is passed a string containing the ID of the outcome button that
|
|
the user clicked. You can pass this value to the `startProcess` method (defined in the
|
|
[Process service](../process-services/process.service.md)) when activating the process, if necessary.
|
|
|
|
## See also
|
|
|
|
- [Process service](../process-services/process.service.md)
|