Using the Declarative Page Flows Subtab

Using Declarative Page Flows

The Introduction page for Declarative Flows is the starting point for setting up and using Declarative Page Flows. The Declarative Page Flows framework enables you to customize, upgrade, and troubleshoot the content and flow of JSPs, without having to modify code. The key concept of the framework involves the abstraction of JSPs into named logical entities, called Logical Pages. The components of the Declarative Page Flows framework are Physical Pages, Logical Pages, Rules, and Business Flows.

You can perform the following tasks from the Declarative Page Flows subtab:

For an introduction to Declarative Page Flows concepts, please see Understanding Declarative Page Flows.

Managing Physical Pages

The main page for Physical Pages is the starting point for viewing, registering, and updating Physical Pages. Physical Pages are JavaServer Pages (JSPs). Use this procedure to manage Physical Pages. For an introduction to Declarative Page Flows concepts, please see Understanding Declarative Page Flows.

Steps

  1. In the Design tab, navigate to Declarative Page Flows > Physical Pages.

  2. If you want to change which Physical Pages display in the table, then:

    1. To make Physical Pages from all applications to display in the table, then choose All from the drop-down list at the top of the table.

    2. If you want to filter the table by application, then choose a module prefix from the drop-down list labeled View at the top of the table.

    3. If you want to search the table of Physical Pages, then type the name of a Physical Page or part of the name of a Physical Page into the text input field.

    4. Click Go. The results display in the table.

  3. If you want to register a Physical Page, then click Create. This opens the page where you edit the details of a new Physical Page.

  4. If you want to update an existing Physical Page, then click its name in the table. This opens the page where you edit the details of an existing Physical Page.

Related Topics

Editing Physical Page Details

Using Declarative Page Flows

Editing Physical Page Details

On the details page for Physical Pages, you complete the procedures of either registering or updating Physical Pages. Use this procedure to edit the details of new or existing Physical Pages. For an introduction to Declarative Page Flows concepts, please see Understanding Declarative Page Flows.

Steps

  1. In the Design tab, navigate to Declarative Page Flows > Physical Pages, then either click Create to register a new page or click the name of a JSP to modify its details.

  2. Type into the Name field to edit the name of the Physical Page.

  3. Type into the Description field to edit the description of the Physical Page. This field is optional.

  4. If you are registering a new Physical Page, then choose an application from the Application drop-down list. If you are updating an existing Physical Page, then you cannot edit this field. It is permanently set when you create the Physical Page.

  5. If you are registering a new Physical Page, then click Create to save.

  6. If you are updating an existing Physical Page, then click Update to save.

Related Topics

Managing Physical Pages

Using Declarative Page Flows

Managing Logical Pages

The main page for Logical Pages is the starting point for viewing, creating, and updating Logical Pages. Logical Pages can be utilized either stand-alone or to represent nodes in a Business Flow. One or more Physical Pages map to each Logical Page. Use this procedure to manage Logical Pages. For an introduction to Declarative Page Flows concepts, please see Understanding Declarative Page Flows.

Steps

  1. In the Design tab, navigate to Declarative Page Flows > Logical Pages.

  2. If you want to change which Logical Pages display in the table, then:

    1. If you want to allow Physical Pages from all applications to display in the table, then choose All from the drop-down list labeled View at the top of the table.

    2. If you want to filter the table by application, then choose a module prefix from the drop-down list labeled View at the top of the table.

    3. If you want to search the table of Physical Pages, then type the name of a Physical Page or part of the name of a Physical Page into the text input field.

    4. Click Go. The results display in the table.

  3. If you want to create a Logical Page, then click Create. This opens the page where you edit the details of a new Logical Page.

  4. If you want to update an existing Logical Page, then click its name in the table. This opens the page where you edit the details of an existing Logical Page.

Related Topics

Editing Logical Page Details

Using Declarative Page Flows

Editing Logical Page Details

On the details page for Logical Pages, you complete the procedures of either creating or updating Logical Pages. Use this procedure to edit the details of new or existing Logical Pages. For an introduction to Declarative Page Flows concepts, please see Understanding Declarative Page Flows.

Steps

  1. In the Design tab, navigate to Declarative Page Flows > Logical Pages, then either click Create or click a page name in the table.

  2. Type into the Name field to edit the name of the Logical Page.

  3. Type into the Description field to edit the description of the Logical Page. This field is optional.

  4. If you are creating a new Logical Page, then choose an application from the Application drop-down list. If you are updating an existing Logical Page, then you cannot edit this field. It is permanently set when you create the Rule.

  5. Edit the Page Controller field if you do not want to use the default Java class which is prefilled in the field. The class designated here implements the Logical Page Controller interface and provides values to evaluate Rules.

  6. Type into the Default Physical Page field to edit the name of the Physical Page that displays when none of the Rules evaluate to true. Optionally, click Go to choose from a list of values.

  7. Edit the Page Display Rules table; one row in the table represents one Rule:

    1. Type into the Sequence column to edit the order in which the Rules are evaluated.

    2. Type into the Rule Name column to edit the name of the Rule. Optionally, click Go to choose from a list of values.

    3. Type into the Description column to edit the description of the Rule.

    4. Type into the Physical column to edit the name of the Physical Page that is associated with the Rule. Optionally, click Go to choose from a list of values.

  8. Repeat step 7 as desired.

  9. Optionally, click Add Rows to add empty rows to the table.

  10. If you are creating a new Logical Page, then click Create to save.

  11. If you are updating an existing Logical Page, then click Update to save.

Related Topics

Managing Logical Pages

Using Declarative Page Flows

Managing Rules

The main page for Rules is the starting point for viewing, creating, and updating Rules. In the context of a Logical Page, Rules determine either what Physical Page needs to be rendered or what Logical Page displays next. Use this procedure to manage Rules. For an introduction to Declarative Page Flows concepts, please see Understanding Declarative Page Flows.

Steps

  1. In the Design tab, navigate to Declarative Page Flows > Rules.

  2. If you want to change which Rules display in the table, then:

    1. If you want Rules from all applications to display in the table, then choose All from the drop-down list labeled View at the top of the table.

    2. If you want to filter the table by application, then choose a module prefix from the drop-down list labeled View at the top of the table.

    3. If you want to search the table of Rules, then type the name of a Rule or part of the name of a Rule into the text input field.

    4. Click Go. The results display in the table.

  3. If you want to create a Physical Page, then click Create. This opens the page where you edit the details of a new Rule.

  4. If you want to update an existing Rule, then click its name in the table. This opens the page where you edit the details of an existing Rule.

Related Topics

Editing Rule Details

Using Declarative Page Flows

Editing Rule Details

On the details page for Rules, you complete the procedures of either creating or updating Rules. Use this procedure to edit the details of new or existing Rules. For an introduction to Declarative Page Flows concepts, please see Understanding Declarative Page Flows.

Steps

  1. In the Design tab, navigate to Declarative Page Flows > Rules, then either click Create or click a Rule name in the table.

  2. Type into the Name field to edit the name of the Rule. If you are working with an existing Rule, then you cannot edit this field.

  3. Type into the Description field to edit the description of the Rule. This field is optional.

  4. If you are creating a new Rule, then choose an application from the Application drop-down list. If you are updating an existing Rule, then you cannot edit this field. It is permanently set when you create the Rule.

  5. Edit the Rule Conditions table; one row in the table represents one Rule Condition:

    1. Type a parameter into the Parameter column.

    2. Choose an operator from the drop-down list in the Condition column.

    3. Type a value into the Value column.

  6. Repeat step 5 as desired.

  7. Optionally, click Add Rows to add empty rows to the table.

  8. If you are creating a new Rule, then click Create to save.

  9. If you are updating an existing Rule, then click Update to save.

Related Topics

Managing Rules

Using Declarative Page Flows

Managing Business Flows

The main page for Business Flows is the starting point for viewing, creating, updating, previewing, and cloning Business Flows. Business Flows are page display sequences that address specific business processes. For example, you can create a Business Flow for the process of purchasing an item from an online store, or you can create a Business Flow for the process of resolving a user's service request. Business Flows can be either linear or branched in structure. Use this procedure to manage Business Flows. For an introduction to Declarative Page Flows concepts, please see Understanding Declarative Page Flows.

Steps

  1. In the Design tab, navigate to Declarative Page Flows > Business Flows.

  2. If you want to change which Business Flows display in the table, then:

    1. If you want Business Flows from all applications to display in the table, then choose All from the drop-down list labeled View at the top of the table.

    2. If you want to filter the table by application, then choose a module prefix from the drop-down list labeled View at the top of the table.

    3. If you want to search the table of Business Flows, then type the name of a Business Flow or part of the name of a Business Flow into the text input field.

    4. Click Go. The results display in the table.

  3. To update an existing Business Flow, click its name in the table.

  4. To create a branch in this Business Flow, click the icon in the Create Flow Branch column.

  5. To preview an existing Business Flow, click the icon in the Preview column.

  6. To view the different versions of a flow, then click the icon in the View Versions column.

  7. If you want to create a Business Flow, then click Create Flow.

  8. If you want to create a duplicate of a flow, then click Duplicate Flow.

Related Topics

Editing Business Flow Details

Creating Flow Branches

Duplicating Flows

Viewing Flow Versions

Using Declarative Page Flows

Editing Business Flow Details

On the details page for Business Flows, you can edit the basic settings of new or existing Business Flows. After using this page, you can open the Map Flows page to define the conditional branches in the Business Flow. Use one of the following procedures:

For an introduction to Declarative Page Flows concepts, please see Understanding Declarative Page Flows.

Creating a New Business Flow

Use this procedure to edit the basic settings of a new business flow. For an introduction to Declarative Page Flows concepts, please see Understanding Declarative Page Flows.

Steps

  1. In the Design tab, navigate to Declarative Page Flows > Business Flows, then click Create.

  2. Type a flow name into the Name field.

  3. Choose an application from the Application drop-down list.

  4. Optionally, type a description into the Description field.

  5. Optionally, select the Secure check box if the flow is to use HTTPS.

  6. Edit the Finalization Class field if you want use a Java class other than the default Finalization Class (which is prefilled in the field). The class designated here implements the FlowFinalizer interface and executes at the end of the Business Flow.

  7. Type the name of the Logical Page that should be invoked after the completion of the flow into the Page to Display After Completing the Flow field. Optionally, click Go to choose from a list of values.

  8. Type the name of the first Logical Page in the flow into the First Page of the Flow field. Optionally, click Go to choose from a list of values.

  9. Optionally, edit the Default Flow Sequence table; if the flow you are creating is linear, then complete this table. If the flow you are creating has conditional branches, then proceed to step 10.

    1. Type numbers into the Sequence fields to indicate the page order within the flow.

    2. Click Go to choose a Logical Page to set as the Next Logical. When you make your choice, the Next Logical and Description fields will automatically fill.

    3. Repeat step b as desired. If needed, click Add Rows to add additional rows to the table.

  10. Click Create to save.

  11. Click Create Flow Branch. This opens the page where you define the conditional branches of a nonlinear flow.

  12. Optionally, click View Flow Versions to view all the versions of this business flow.

Related Topics

Managing Business Flows

Using Declarative Page Flows

Updating an Existing Business Flow

Use this procedure to edit the basic settings of an existing business flow. For an introduction to Declarative Page Flows concepts, please see Understanding Declarative Page Flows.

Steps

  1. In the Design tab, navigate to Declarative Page Flows > Business Flows, then click a flow name in the table.

  2. Optionally, type a flow description into the Description field.

  3. Optionally, select the Secure check box if the flow is to use HTTPS.

  4. Type the name of the Finalization Class into the Finalization Class field. This is the name of a Java class. The class implements the FlowFinalizer interface and executes at the end of the Business Flow.

  5. Type the name of the Logical Page that should be invoked after the completion of the flow into the Page to Display after Completing the Flow field. Optionally, click Go to choose from a list of values.

  6. Type the name of the first Logical Page in the flow into the First Page of the Flow field. Optionally, click Go to choose from a list of values.

  7. If the flow you are working with is linear (does not contain any conditional branches), then you can define the flow sequence in the Default Flow table.

  8. Click Update to save.

  9. If the flow you are working with is nonlinear (contains one or more conditional branches), then click Create Flow Branch to begin defining the branches of the flow.

  10. To view the different versions of this flow, click View Flow Versions.

Related Topics

Managing Business Flows

Using Declarative Page Flows

Creating Flow Branches

Business Flows are page display sequences that address specific business processes. The Create Flow Branch page allows you to define conditional branches within nonlinear business flows. Use this procedure to set the sequences of Logical Pages within Business Flows. For an introduction to Declarative Page Flows concepts, please see Understanding Declarative Page Flows.

Steps

  1. Choose a Logical Page from the Current Logical drop-down list. The Current Logical Page is the name of the Logical Page that you are setting up on this screen. After you save your work, you can repeat this entire procedure with another Logical Page within the Business Flow.

  2. In the Default Next Logical field, type the name of the Logical Page that displays if there are no Rules in the table below, or if none of the Rules in the table below evaluate to "true." Optionally, click Go to choose from a list of values.

  3. Edit the Logical Node Rules table.

    1. Type numbers into the Sequence fields to set the order in which the Rules are evaluated.

    2. In the Next Logical fields, type the name of the Logical Page that you want to display after the Current Logical Page, only if the Rule in the next column evaluates to "true." Optionally, click Go to choose from a list of values.

    3. In the Rule Name fields, type name of the Rule that controls whether or not the Logical Page in the previous column displays. Optionally, click Go to choose from a list of values.

  4. Optionally, click Add Rows to add empty rows to the table.

  5. If you are creating a new Current Logical Page setup, then click Create to save. This opens another Create Flow Branch page where you can repeat this entire procedure with another Current Logical Page.

  6. If you are updating an existing Flow Branch setup, then click Update to save. This opens another Create Flow Branch page where you can repeat this entire procedure with another Current Logical Page.

  7. If you have no more Current Logical Pages to set up, then click Finish. This completes the procedures of either creating or updating Business Flows.

Related Topics

Managing Business Flows

Using Declarative Page Flows

Duplicating Business Flows

Use this procedure to duplicate business flows. For an introduction to Declarative Page Flows concepts, please see Understanding Declarative Page Flows.

Steps

  1. In the Design tab, navigate to Declarative Page Flows > Business Flows, then click Duplicate Flow.

  2. Click Go to choose the flow from a list of values. Edit the name of the flow if desired.

  3. Click Duplicate to generate a duplicate of the flow. The Flow Details page automatically opens, where you can edit the details of the duplicate flow.

Related Topics

Managing Business Flows

Using Declarative Page Flows

Viewing Flow Versions

Use this procedure to view all of the versions of a given business flow. For an introduction to Declarative Page Flows concepts, please see Understanding Declarative Page Flows.

Steps

  1. Choose which of the flows will be "active" by selecting the appropriate radio button in the table.

  2. Click Update to save.

  3. Optionally, click a flow name in the table.

    This opens the page where you can edit the basic details of an existing flow.

Related Topics

Managing Business Flows

Using Declarative Page Flows