Creating Workflow Models

אתה מציג תוכן עזרה עבור גרסה:

6.2
גירסאות קודמות

You create a workflow model to define the series of steps executed when a user starts the workflow. When a user starts a workflow, an instance is started; this is a copy of the workflow model at that point in time.

When you first create a new workflow model it contains:

The steps, Flow Start and Flow End.
These represent the beginning and end of the workflow. These steps are required and cannot be edited/removed.
An example Participant step named Step 1.
This step is configured to assign a work item to the admin user. Edit or delete this step, and add steps as required.

Open the Workflow Models console; for example:

http://localhost:4502/libs/cq/workflow/admin/console/content/models.html/etc/workflow/models

Select Create, then Create Model.

The Add Workflow Model dialog appears. Enter the Title and Name (optional) before selecting Done.

The new model is listed in the Workflow Models console.

Select your new workflow, then use Edit to open it for configuration:

Open the Workflow console. For example, http://localhost:4502/libs/cq/workflow/content/console.html.
On the Models tab, click New. The New Workflow dialog opens.
Type the title for your workflow and click OK.
The new model appears in the Models tab.
Select your model, then click Edit to open it for configuration.

Editing an existing workflow can be done in the same manner as creating a workflow - after the actual create/new action. Again, it is dependent on the UI you are using:

Touch-Optimized UI
Classic UI

You can create a Transient workflow model when creating a new model, or by editing an existing one:

Create and/or edit the workflow model according to the UI you are using.

Select the Page tab of sidekick, followed by Page Properties... to open the dialog.

In the dialog activate Transient Workflow (or deactivate if required):

Click OK to save this setting, followed by Save All to save the updates to the workflow model.

הערה:

When you run a workflow in transient mode AEM does not store any workflow history. Therefore, Timeline does not display any information related to that workflow.

You will need to add steps to your model to represent the activity to perform - each step performs a specific activity. A selection of step components are available in a standard AEM instance.

When you edit a model, the available steps appear in the various groups of the Components tab in the workflow sidekick.

הערה:

For information about the primary step components that are installed with AEM, see Workflow Steps Reference.

To add steps to your workflow model:

Open your workflow model for editing.

Drag the required workflow step component from the sidekick to the model. A checkmark icon on the component indicates a valid drop location.

At run time, steps are executed in the order in which they appear in the model. After adding step components, you can drag them to a different location in the model.

You can Edit step components to configure and customize their behavior using the Step Properties dialogs.

To open the Step Properties dialog for a step either:

Right-click the step in the workflow model and click Edit.
Double-click on the step.

הערה:

For information about the primary step components that are installed with AEM, see Workflow Steps Reference.

Configure the Step Properties as required; depending on the step type there may be several tabs available. For example, the default Participant Step, present in a new workflow as Step 1:

Click OK to save your updates to the step.

Click Save (top left-hand corner of the model panel) to save the update to your workflow model.

אזהרה:

Although you have saved updates to the individual step, these will not be persisted to the workflow model until you click Save.

You can configure AEM to display DEBUG messages in the log files:

Open the Configuration Manager of the Web Console; for example:

http://localhost:4502/system/console/configMgr

Configure the Apache Sling Logging Configuration and Apache Sling Logging Logger Configuration (Factory Configuration) as required.

הערה:

See Logging for further information.

When the development is finished, set the Log Level back to Info.

Test your new workflow as follows:

Start your workflow model from the console.
Define the Payload and click OK.
Take actions as required so that the workflow proceeds.
Monitor the log files while the workflow is running.

הערה:

It is a good practice when debugging a workflow to test the workflow with a variety of payload types; including types that are different to the one for which it has been developed. For example, if you intend your workflow to deal with Assets, test it by setting a Page as payload and make sure that it does not throw errors.

You can configure a form to be processed by the selected workflow. When users submit the form, a new workflow instance is created with the data of the form submission as its payload.

To configure the workflow to be used with your form:

Create a new page and open it for editing.

Add a Form component to the page.

Edit the Start of Form component that appeared in the page.

Use Start Workflow to select the desired workflow from those available:

Click OK to confirm the new form configuration.

To illustrate some of the possibilities for creating a workflow, the following example creates a variation of the Publish Example workflow.

Create a new workflow model.

The new workflow will contain:

Flow Start
Step 1
Flow End

To open the properties dialog for Step 1 either:

Right-click on Step 1 and click Edit.
Double-click on Step 1.

In the Common tab enter Validate Content for both the Title and Description.

Open the User/Group tab. Select Administrator (admin) for the User/Group field.

Click OK.

You will be returned to the overview of the workflow model, here Step 1 will have been renamed to Validate Content.

Drag an Or Split onto the workflow and position it between Validate Content and Flow End.

Open the Or Split for editing.

Configure:

Common: select 2 Branches
Branch 1: select Default Route.
Branch 2: ensure Default Route is not selected.

Click OK to save your updates to the OR Split.

Drag a Participant Step to the left-hand branch, open the properties, specify the following values, and click OK:

Title: Cancel Publish
User/Group: Administrator (admin)

Drag a Process Step to the right-hand branch, open the properties, specify the following values, and click OK:

Title: Publish Page
Process: select Activate Page. This process publishes the selected page to the publisher instances.

Click Save (top left-hand corner of the model panel) to save all the updates to your workflow model.

אזהרה:

Although you have saved updates to the individual steps, these will not be persisted to the workflow model until you click Save.

Your new workflow model will look like:

OR Split steps allow you to introduce conditional processing paths into your workflow.

To define an OR rule, proceed as follows:

Create two scripts and save them in the repository, for example under:

/apps/myapp/workflow/scripts

הערה:

The scripts must have a function check() that returns a boolean.

Edit the workflow and add the OR Split to the model.

Edit the properties of Branch 1 of the OR Split:

Define this as the Default Route by setting the Value to true.
As Rule, set the path to the script. For example:
/apps/myapp/workflow/scripts/myscript1.ecma

הערה:

You can switch the branch order if required.

Edit the properties of the Branch 2 of the OR Split.

As Rule, set the path to the other script. For example:
/apps/myapp/workflow/scripts/myscript2.ecma

Set the properties of the individual steps in each branch. Make sure the User/Group is set.

Click Save to persist your changes for the workflow model.

אזהרה:

Although you have saved updates to the individual steps, these will not be persisted to the workflow model until you click Save.

הערה:

See Using ECMAScript.

The following sample script returns true if the node is a JCR_PATH located under /content/geometrixx/en:

function check() {
    if (workflowData.getPayloadType() == "JCR_PATH") {
	     var path = workflowData.getPayload().toString();
	     var node = jcrSession.getItem(path);
	     
	     if (node.getPath().indexOf("/content/geometrixx/en") >= 0) {
	     	return true;
	     } else {
	     	return false;
	     }	
     } else {
     	return false;
     }
}

With AEM you can associate a workflow with forms (using the Forms components or AEM Forms). It enables you to build processes in which visitors will input information based on multiple forms; for example, an online registration process.

In this section you will create a two-step process to display two characteristics of the "Product of the Day". In the first step, the author will fill out the first form to define the name of the product. In the second step, the author will fill out the second form and specify the designer of the product. The result will be displayed in the Product of the Day page.

To create the Product of the Day page:

In the Sites (using the touch-optimized UI, or Websites if using the classic UI) console navigate to Geometrixx Outdoors Site, English, Equipment (/content/geometrixx-outdoors/en/equipment).

Create a new page with the following properties:

Template: Content Page without Sidebar
Title: Product of the Day

Open the new page for editing. The page has a section with two columns. These two columns each contain a single Text component with no text. Add the following text to the components:

Left-hand column: Name:
Right-hand column: Designed By:

Add a Text component to each of the two columns, below the existing paragraphs.

Use CRXDE Lite to find the name of the nodes (in the repository) that are associated with the paragraphs that you added to the Product of the Day page.

Open CRXDE Lite in your web browser. For example, http://localhost:4502/crx/de

In the node tree, expand the node:

/content/geometrixx-outdoors/en/equipment/product-of-the-day/jcr:content/par

Below the par node, the colctrl nodes represent the columns on the Product of the Day page, and the col_break nodes represent the end of the columns. The left-hand column is the first colctrl node, and the right-hand column is the second colctrl node.

Note the name of the second text node after the first colctrl node. The second text node represents the empty text component that you added to the left-hand column.

Note the name of the second text node after the second colctrl node. The second text node represents the empty text component that you added to the right-hand column.

In the following graphic, the text nodes are text_1958199362 and text. Your node names will probably have different identifying characters following the text prefix (text_<id>).

To create the first form (form1):

In the Sites (using the touch-optimized UI, or Websites if using the classic UI) console navigate to Geometrixx Outdoors Site, English, Equipment (/content/geometrixx-outdoors/en/equipment).

Create a new page with the following properties:

Template: Content Page without Sidebar
Title: form1

הערה:

The location of the form pages is not important.

Open the form1 page and delete the 2 Columns component.

Add a Form component to the page (underneath the existing Text components).

Edit the Form Start component and set the following properties (on the Advanced tab) to link the form to a workflow:

Action Type: Edit Workflow Controlled Resource(s)
Form Identifier: form1

Click OK.

Add a Text Field component between the Start of Form and the End of Form bars of the Form component.

Edit the Text Field component to specify the following property values:

Element Name: ./jcr:content/par/text_****/text
Title: Product Name:

הערה:

text<_id> is the name of the node that represents the empty paragraph on the Product of the Day page. In the previous example, the node name is text_1958199362.

Click OK.

הערה:

When the form is submitted, the value in this field is stored in the <payload-path>/jcr:content/par/text_0/text node.

Add a Workflow Submit Button(s) component immediately below the Text Field component. This component provides the submit button of the form.

To create the second form (form2):

In the Sites (using the touch-optimized UI, or Websites if using the classic UI) console navigate to Geometrixx Outdoors Site, English, Equipment (/content/geometrixx-outdoors/en/equipment).

Create a new page with the following properties:

Template: Content Page without Sidebar
Title: form2

הערה:

The location of the form pages is not important.

Open the form2 page and delete the 2 Columns component.

Add a Form component to the page (underneath the existing Text components).

Edit the Form Start component and set the following properties:

Form tab:
- Thank You Page: {payload}.html
Advanced tab:
- Action Type: Edit Workflow Controlled Resource(s)
- Form Identifier: form2

Click OK.

Add a Text Field component between the Start of Form and the End of Form bars of the Form component.

Edit the Text Field component to specify the following property values:

Element Name: ./jcr:content/par/text/text
Title: Developer Name:

הערה:

text<_id> is the name of the node that represents the empty paragraph on the Product of the Day page. In the previous example, the node name is text.

Click OK.

הערה:

When the form is submitted, the value in this field is stored in the <payload-path>/jcr:content/par/text_2/text node.

Add a Workflow Submit Button(s) component immediately below the Text Field component. This component provides the submit button of the form.

To create the workflow:

Create a new workflow with the title Product of the Day and open it for editing.

Delete Step 1.

Drag a Form Participant Step component to the workflow. Specify the following property values:

Title: Step 1
User/Group: Administrator (admin)
Form path: /content/geometrixx-outdoors/en/equipment/form1

Add a Form Participant Step component after Step 1 and specify the following property values:

Title: Step 2
User/Group: Administrator (admin)
Form path: /content/geometrixx-outdoors/en/equipment/form2

Click Save (top left-hand corner of the model panel) to save the updates to your workflow model.

אזהרה:

Although you have saved updates to the individual steps, these will not be persisted to the workflow model until you click Save.

Open the Product of the Day page for editing. If the page was still open from a previous procedure then reload it.

Start the Product of the Day workflow for the page.

Open the Notification Inbox.

Click on the payload link (in this case /content/geometrixx-outdoors/en/equipment/product-of-the-day).

This will open the form.

In the Product Name field, type Abidjan Water Red, and click next. The form2 page opens.

In the Developer Name field, type Abidjan and click finish.

הודעות המתפרסמות ב- Twitter™‎ ו- Facebook אינן מכוסות בתנאי Creative Commons.

הצהרות משפטיות | מדיניות פרטיות מקוונת

Creating Workflow Models

Creating a New Workflow

Creating a New Workflow - Touch-Optimized UI

Creating a New Workflow - Classic UI

Editing an Existing Workflow

Creating a Transient Workflow

Adding a Step to a Model

Editing a Workflow Step

Debugging and Testing Workflows

Using Workflows to Process Form Submissions

Example: Creating a Simple Workflow

Example: Defining a Rule for an OR Split

Function Check()

Example: Collecting Data Using Forms and Workflows

Create the Product of the Day page

Obtain the paragraph node names

Create the first form (form1)

Create the second form (form2)

Create the workflow

Apply the workflow to the Product of the Day page

שאל את הקהילה

איך פונים אלינו

Creating Workflow Models

Creating a New Workflow

Creating a New Workflow - Touch-Optimized UI

Creating a New Workflow - Classic UI

Editing an Existing Workflow

Creating a Transient Workflow

Adding a Step to a Model

Editing a Workflow Step

Debugging and Testing Workflows

Using Workflows to Process Form Submissions

Example: Creating a Simple Workflow

Example: Defining a Rule for an OR Split

Function Check()

Example: Collecting Data Using Forms and Workflows

Create the Product of the Day page

Obtain the paragraph node names

Create the first form (form1)

Create the second form (form2)

Create the workflow

Apply the workflow to the Product of the Day page

Language Navigation

Language Navigation