Skip navigation.

Managing WebLogic Integration Solutions

  Previous Next vertical dots separating previous/next from contents/index/pdf Contents View as PDF   Get Adobe Reader

Process Configuration

This section provides the information you need to use the Process Configuration module of the WebLogic Integration Administration Console to:

Note: You must be logged in as a member of the Administrators, IntegrationAdministrators, or IntegrationOperators group to make changes to the configuration for a process or dynamic control. IntegrationOperators cannot modify process security policies. See Default Groups, Roles, and Security Policies.

The following topics are provided:

 


About Process Configuration

The following sections provide background information related to business process administration:

Managing Process Tracking Data

The data generated as process instances execute is initially stored in the runtime database. The monitoring information provided in the console is based on this data. In order to optimize performance, it is important to keep the amount of tracking data stored in the runtime database to a minimum. This is accomplished by:

A combination of system and process properties control the management of tracking data. The following table provides a summary of each property and its related configuration tasks. To learn how to carry out the configuration task, see the referenced topic.

Property

Configuration Task

Task Type and Reference

Default Tracking Level

Set the system default tracking level.

System Configuration. See Configuring the Default Tracking Level and Reporting Data Policy.

Tracking Level

Set or verify the tracking level for each process. The administrator can set the level for a process to:

  • Default (the system default tracking level)

  • Full, Node, Minimum, or None (setting overrides the system default tracking level)

Process Configuration. See Viewing and Changing Process Details.

Reporting Data Stream

Enable or disable the reporting data stream. If the reporting data stream is enabled, the specified reporting database is populated by a near real-time data stream.

System Configuration. See Configuring the Reporting Data and Purge Processes.

Purge Schedule

Enable or disable the purge process and set the regular intervals at which process runs to purge the data from the runtime database.

System Configuration. See Configuring the Reporting Data and Purge Processes.

Purge Delay

Set the amount of time after completion or termination before the instance data is subject to purge by the purge process.

System Configuration. See Configuring the Reporting Data and Purge Processes.

Default Reporting Data Policy

Set the system default reporting data policy to On or Off.

System Configuration. See Configuring the Default Tracking Level and Reporting Data Policy.

Reporting Data Policy

Set or verify the reporting data policy for each process:

  • On indicates that the instance data is transmitted to the reporting database if the reporting data stream is enabled. If the reporting data stream is disabled, no processes data is transmitted, regardless of the policy set.

  • Off indicates that the instance data is not subject to transfer to the reporting database, even if the reporting data stream is enabled (that is, the data is only purged).

  • Default indicates that the system default reporting data policy (described below) is used.

Process Configuration. See Viewing and Changing Process Details


 

To learn more, see the following topics:

Process Security Policies

To ensure process security, the administrator can configure the following security policies for a process:

To learn how to set the security policies, see Updating Security Policies.

Service Level Agreements

A service level agreement (SLA) specifies a performance target for a process. It is typically an internal or external commitment that a process will be executed within a specified period of time.

To assist you in achieving the SLA for a process, the WebLogic Integration Administration Console allows you to set the following thresholds:

Process status relative to these thresholds is tracked for each process instance as follows:

This ability to set SLA thresholds allows you to easily identify processes that do not execute within the target time frame. You can then make the changes necessary to meet agreements between suppliers and customers, or to achieve your own performance goals. To learn how to set the SLA for a process, see Viewing and Changing Process Details.

Process Versions

When developers need to modify a deployed process, they must create a new process version and then release it into production along with older versions. To learn more about creating and deploying new versions, see the following topics in Building Integration Applications in the WebLogic Workshop help:

When multiple versions are deployed, the system determines which version to use when creating new instances. The administrator controls the release of a process version by:

When creating a new instance, the system selects the version with the most recent activation time from among the enabled versions. (A disabled version is not available for selection.)

When an administrator activates a process by setting its activation time, instances currently running are not affected. Only instances that are created after the new version becomes active are created based on the new version.

If a newly activated version experiences problems, a rollback is easily accomplished by doing one of the following:

To learn more about how to enable or disable a version, or to configure the activation time, see Managing Process Versions.

Note: Processes that are not versioned can also be enabled and disabled. See Viewing and Changing Process Details. A process, whether versioned or not, is only executable if the Is Enabled property is set to true, and the current time is later than the Activation Date and earlier than the Deactivation Date.

Dynamic Controls

Dynamic controls, which currently include the Service Broker and Process controls, provide the means to dynamically set control attributes through a combination of look-up rules and look-up values. This process is known as dynamic binding. In dynamic binding, the process developer specifies look-up rules, and the administrator defines the look-up values. This design pattern allows control attributes to be reconfigured for a running application, without redeployment.

The look-up or selector values are stored in the DynamicProperties.xml file, which is located in the wliconfig subdirectory of the domain root. You can manage the values stored in the DynamicProperties.xml file from the View Dynamic Control Properties page of the Process Configuration module.

Dynamic binding changes made in the WebLogic Integration Administration Console override both configuration changes made in the Workshop development environment and static annotations.

To learn more about the dynamic controls, see the following topics in Building Integration Applications in the WebLogic Workshop help:

 


Overview of the Process Configuration Module

The following table lists the pages you can access from the Process Configuration module. The tasks and topics associated with each are provided.

Page

Associated Tasks

Topics

Process Types

Process Property Summary

View a list of process types. Display name, public URI, state (stateful or stateless), tracking level, reporting data policy, and SLA are displayed.

Listing and Locating Process Types

Access the Process Type Details page.

Process Type Details

View process properties. Identifying information (such as service URI and application name), configurable properties (display name, tracking level, reporting data policy, SLA), dynamic client callback properties, execution and authorization policies, variables, and active version are displayed.

Viewing and Changing Process Details

Access an interactive or printable graph of the process.

Viewing an Interactive or Printable Process Type Graph

Access one of the following pages to update settings:
Edit Process Properties
Edit Process Versioning
Add New Client Callback Properties
Edit Client Callback Properties
Edit Process Execution Policy
Edit Process Authorization Policy
Edit Method Authorization Policy
Edit Call Back Authorization Policy


Edit Process Properties

Update display name, SLA, SLA warning threshold, tracking level, and reporting data policy for the selected process type.

Viewing and Changing Process Details

Edit Process Versioning

Enable, disable, or set the activation date and time for the selected version.

Managing Process Versions

Add New Client Callback Properties

Add a selector value and properties, which can be used to dynamically configure the callback to the client.

Adding or Changing Dynamic Client Callback Selectors

Edit Client Callback Properties

Edit the properties used to dynamically configure the callback to the client.

Adding or Changing Dynamic Client Callback Selectors

Edit Process Execution Policy

Specify the run as identity for the process operations, and whether or not a single principal is required.

Updating Security Policies

Process Security Policies

Edit Process Authorization Policy

Set the minimum authorized roles for the methods (client requests) in the process.

Updating Security Policies

Process Security Policies

Edit Process Method Authorization Policy

Set additional authorized roles for the selected method. (Minimum authorized roles for all methods are set by the process authorization policy.)

Updating Security Policies

Process Security Policies

Edit Call Back Authorization Policy

Set the authorized roles for the selected callback.

Updating Security Policies

Process Security Policies

Dynamic Controls

View Dynamic Control Properties

View a list of dynamic controls. Control name, type, and selector value are displayed.

Listing and Locating Dynamic Controls

Delete a selector from the control.

Deleting Dynamic Control Selectors

Access the Add New or Edit page for the control to define properties for a new selector, or edit properties for an existing selector.

Adding or Changing Dynamic Control Selectors

Add New Process Control Selector

Define the properties for a new selector.

Defining Process Control Properties for a Selector

Edit Process Control Selector

Update the properties for an existing selector.

Defining Process Control Properties for a Selector

Add New Service Broker Control Selector

Define the properties for a new selector.

Defining Service Broker Control Properties for a Selector

Edit Service Broker Control Selector

Update the properties for an existing selector.

Defining Service Broker Control Properties for a Selector


 

 


Listing and Locating Process Types

The Process Property Summary page displays the following information for each deployed process type. For a more detailed description of the properties, see Viewing and Changing Process Details.


 

Note: The process types are listed alphabetically by display name.

Property

Description

Display Name

Display name assigned to the process. The name is a link to the Process Type Details page.

Note: If more than one version of the process is deployed, it is customary to append the version number to the display name, but this convention is not enforced.

Public URI

The process URI. If there are multiple versions deployed, this is the version group URI (that is, the version number is not appended).

State

The process type (Stateful or Stateless).

Tracking Level

The tracking level set for the process.

Reporting Data Policy

The reporting data policy set for tracking data.

SLA

Service level agreement set for the process.


 

To list and locate process types:

  1. From the home page, select the Process Configuration module.
  2. Scroll through the pages to locate a specific process type. Use the controls in the lower left corner. Go to a page by selecting the page number or by using the arrow buttons to go to the next , previous , first , or last page.

 


Listing and Locating Dynamic Controls

The View Dynamic Control Properties page displays the dynamic controls (Process and Service Broker controls) referenced by deployed processes. For each control, the selector values for any dynamic bindings are displayed. To learn how to add or change control selectors, see Adding or Changing Dynamic Control Selectors.


 

To list and locate dynamic controls:

  1. From the home page, select the Process Configuration module.
  2. From the left panel, select View Dynamic Controls.
  3. To locate a specific control, do one of the following:

 


Viewing and Changing Process Details

The Process Type Details page allows you to view or change process properties.


 


 

To view and change process details:

  1. Locate the process. See Listing and Locating Process Types.
  2. Click the process name to display the Process Type Details page.
  3. To update configurable properties, do the following:
    1. In the Configurable Properties section, click Configure to display the Edit Process Properties page.

    2.  
    3. Set the properties as required. The properties are described in the table that follows this procedure.
    4. Click Submit to update the properties and return to the Process Type Details page.
  4. To enable, disable, or activate a version, see Managing Process Versions.
  5. To configure dynamic client callback properties, see Adding or Changing Dynamic Client Callback Selectors.
  6. To update the execution policy, process authorization policy, or method authorization policy, see Updating Security Policies.

The following table summarizes the information displayed on the Process Type Details page.

Note: When the server is started in iterative development mode (iterativeDevFlag=true), updates to the configurable properties are overridden when the process is redeployed through an application build or process redeploy.

Property

Description

Administrator
Can Set
(Yes/No)

Service URI

The process URI. If there are multiple versions of the process, a version number is appended

No

Application Name

The name of the application.

No

Stateful/Stateless

The process type (Stateful or Stateless.) To learn more about how stateful and stateless processes are created, see Building Stateless and Stateful Business Processes in Building Integration Applications in the WebLogic Workshop Help.

No

Description

User-friendly description of the process.

No

Version Group URI

For versioned processes, the URI for the version group.

No

Process Graph

Links to an interactive or printable view of the process. See Viewing an Interactive or Printable Process Type Graph.

No

Configurable Properties

Display name

Display name assigned to the process.

Note: If more than one version of the process is deployed, it is customary to append the version number to the display name, but this convention is not enforced.

Yes

Tracking Level

The tracking level set for the process. The following types of events can be tracked:

Global events
Events such as start process, end process, suspend, and resume.

Node transitions
Events generated by each executed node (a start node event and an end or abort node event).

Yes

Full

Global events, node transitions, and data are tracked.

Node

Global events and node transitions are tracked.

Minimum

Global events, such as start process, end process, suspend, and resume, are tracked.

Default

Tracking level is set to the current system-wide setting (Full, Node, Minimum, or None). See Configuring the Default Tracking Level and Reporting Data Policy.

None

No events or data are tracked.

Reporting Data Policy

The reporting data policy set for tracking data.

Yes

On

Reporting data is enabled. The tracking data available for this process is transmitted to an offline database.

Off

Reporting data is disabled for this process.

Default

The reporting data policy is set to the system default reporting data policy. See Reporting and Purging Policies for Tracking Data.

Save Process Variable Values on Completion

The process variable values policy set for tracking variables.

Yes

On

Process variable tracking is enabled. After process completion, the variable values available for this process are stored in the run-time database.

The process variable values are archived in the archive database as two new event types: one each for variable summary and for variable detail. For information about how to access archived data, see http://download.oracle.com/docs/cd/E13214_01/wli/docs81/manage/archive.html

Off

Process variable tracking is disabled.

Default

The process variable tracking policy is set to the system default policy. See Reporting and Purging Policies for Tracking Data.

SLA

Service level agreements (SLA) expressed as the number of seconds, minutes, hours, or days. When this threshold has been reached, a red flag is displayed for the process instance.

For processes without an SLA, NA is displayed. To remove an SLA setting, enter 0 in the SLA field on the Edit Process Properties page.

To learn more about the SLA, see Service Level Agreements.

Yes

SLA Warning Threshold

A percent of the total SLA time. When this threshold has been reached, a warning flag is displayed for the process instance.

Yes

Is Enabled

For non-versioned processes, indicates whether the process is enabled (true) or disabled (false). For versioned processes, see the Version Group section.

Yes

Activation Time

For non-versioned processes, the date and time the process became, or is to become, active.

Yes

Deactivation Time

For non-versioned processes, the date and time the process is to become inactive.

Yes

Dynamic Client Callback Properties

Selector table

If the process includes a Client Response node for which a lookup property has been specified, this table lists the selector values configured by the administrator. If no values are listed, none have yet been added.

Yes

Selector name

The selector name used to look up the selector properties.

Edit

A link to the Edit Client Callback Properties page for the selector.

Delete

A control used to delete the selector.

Version Group

Version Group URI

The URI for the group.

No

Default Service URI

The URI for the process type.

No

Current Active

The process in the group that is currently active.

No

Version group table

Entry for each deployed version in the version group.

No

Display Name

Display name assigned to the process version.

No

Service URI

The URI for the process version.

No

Enabled

Indicates whether the process is enabled (true) or disabled (false).

Yes

Activation Date

Date and time the process version became, or is to become, active.

Yes

Deactivation Date

Date and time the process version is to become inactive.

Yes

Configure

Link to the Edit Process Versioning page, from which you can enable, disable, or update the activation time for the process version. See Managing Process Versions.


Security Policies

Execution Policy

Run As

The identity the operations in the process assume while executing. Options are caller's identity or start user.

Yes

Single Principal Required

Yes or No. If set to Yes, all incoming client requests must come from the same user.

Process Authorization Policy

Roles authorized to invoke process methods.

Yes

Method Authorization Policy

Additional roles authorized to invoke the method. (The roles specified for Process Authorization Policy are inherited by the method.)

Yes

Callback Authorization Policy

Roles authorized to invoke the callback.

Yes

Variables

Variables

Name and declared type for each variable defined.

No


 

 


Viewing an Interactive or Printable Process Type Graph

The Process Type Details page allows you to view an interactive or printable graph of the deployed process type. The graphical view represents your business process and its interactions with clients and resources, such as databases, JMS queues, file systems.

If there are running instances, you can access an interactive or printable graph of any instance from the Process Instance Detail page. See Viewing an Interactive or Printable Process Instance Graph.

Note: The interactive process graph requires Adobe SVG Viewer Version 3.0. To learn more, see Requirements for the Interactive Graph. The printable graph requires a PDF viewer such as Adobe Acrobat.

To view a printable graph for a process type:

Note: You must have Adobe Acrobat Reader installed to view the printable graph.

  1. Locate the process to view. See Listing and Locating Process Types.
  2. Click the process name to display the Process Type Details page.
  3. Click Printable View.
  4. The process graph is displayed as a PDF document.

To view the interactive graph for a process type:

  1. Verify that your browser meets the requirements. See Requirements for the Interactive Graph.
  2. Locate the process to view. See Listing and Locating Process Types.
  3. Click the process name to display the Process Type Details page.
  4. Click Interactive View.
  5. The Adobe SVG Viewer displays the interactive view as shown in the following figure.


     
  6. Do any of the following:

 


Managing Process Versions

The Version Group section of the Process Type Details page allows you to enable, disable, or set the activation time for the versions in a process group.


 

Note: If you are running with noiterativedev, running instances will not be terminated when you redeploy an EAR. In production it is recommended that you use the following flags when starting WebLogic Server: production noiterativedev nodebug notestconsole

See "Run-Time Tuning Issues" in the Performance Tips section of the WebLogic Integration Solutions Best Practices FAQ.

To enable, disable, or activate a version:

  1. Locate the process to view. See Listing and Locating Process Types.
  2. Click the process name to display the Process Type Details page.
  3. In the Version Group section, the current status of each version is displayed in the version table.

  4. In the version table, click the Configure link for the version.
  5. The Edit Process Versioning page is displayed.


     
  6. Do one or more of the following:
  7. Do one of the following:

Note: There should always be one active version. If no version is available (that is, all versions are disabled) when the process is invoked, an error is logged.

 


Adding or Changing Dynamic Client Callback Selectors

If a process includes a Client Response node for which a lookup property has been specified, the Process Type Details page includes a Dynamic Client Callback Properties section. This section allows you to define the selector values and properties required to dynamically configure the callback to the client.

To learn more about specifying a lookup property for a Client Response node, see Sending Messages to Clients in Building Integration Applications in the WebLogic Workshop help.

To add or change a dynamic client callback selector:

  1. Locate the process. See Listing and Locating Process Types.
  2. Click the process name to display the Process Type Details page.
  3. In the Dynamic Client Callback Properties section, do one of the following:
  4. Set the properties as required. For a description of the available properties, see the table at the end of this procedure.
  5. Click Submit.
  6. The Process Type Details page is displayed. If you added a new selector, the value is displayed.

The following table summarizes the settings available on the Add New Client Callback Properties and Edit Client Callback Properties pages.

Setting

Description

Required/
Optional

In the Selector Value field, enter the look up key.

The value used to select and dynamically set control attributes at runtime.

Note: This field cannot be edited on the Edit Client Callback Properties page.

Required

Select the No Dynamic Authentication, Basic Authentication, or Certificate Based Authentication option button.

Type of authentication.

Optional

In the User Name field, enter the user name.

If Basic Authentication is selected, the required user name.

Required if Basic Authentication is selected.

In the Password Alias field, enter the password alias.

The password alias used to look up the user password in the password store. See Password Aliases and the Password Store.

In the Client Certificate Alias field, enter the certificate alias.

Certificate alias for Certificate Based Authentication.

Required if Certificate Based Authentication is selected.

In the Client Certificate Password Alias field, enter the password alias.

Password alias to look up the certificate password in the password store. See Password Aliases and the Password Store.

In the Keystore Location field, enter the keystore location.

The keystore location.

In the Keystore Password Alias field, enter the password alias.

The password alias used to look up the keystore password in the password store. See Password Aliases and the Password Store.

In the Keystore Type field, enter the keystore type.

The keystore type.


 

To delete a dynamic client callback selector:

  1. Locate the process. See Listing and Locating Process Types.
  2. Click the process name to display the Process Type Details page.
  3. In the Dynamic Client Callback Properties section, click the Delete link to the right of the selector value.

 


Updating Security Policies

The Process Type Details page allows you to set the security policies for the process or its methods and callbacks.

Note: If an authenticator that implements the required MBeans is not configured, the options for configuring the process, method, and callback authorization policies are disabled. To learn more about the authenticator requirements, see Security Provider Requirements for User Management.

To set security policies:

  1. Locate the process to view. See Listing and Locating Process Types.
  2. Click the process name to display the Process Type Details page.
  3. To configure the execution policy for the process:
    1. In the Execution Policy section, click Configure.
    2. The Edit Process Execution Policy page is displayed.


       
    3. From the Run as drop-down list, select caller's identity or start user.
    4. Check or uncheck the Single Principal Required check box.
    5. Click Submit to update the properties and return to the Process Type Details page.
  4. To configure the authorization policies, do one or more of the following:
  5. Add or remove role assignments as follows:
  6. To add roles:

    1. From the Available Roles list, select the required roles. (To select multiple roles, press and hold the Ctrl key as you click each additional role.)
    2. Click the icon to move the selected roles to the Current Roles list.

    To remove roles:

    1. From the Current Roles list, select the roles to remove. (To select multiple roles, press and hold the Ctrl key as you click each additional role.)
    2. Click the icon to move the selected roles to the Available Roles list.
  7. Do one of the following:

 


Adding or Changing Dynamic Control Selectors

The View Dynamic Controls Properties page allows you to add new or update existing selectors.

To add or change a selector:

  1. Locate the dynamic control to update. See Listing and Locating Dynamic Controls.
  2. Do one of the following:
  3. Set the properties as required. For a description of the available properties, see the topic applicable to type of dynamic control.
  4. Do one of the following:

 


Defining Process Control Properties for a Selector

Note: The (Dynamic) Selector has now been deprecated. Please use the XML MetaData Cache Control to look up WebLogic Integration Administration Console configured values and then use the setProperties() calls of the Process Control to set the endpoint at runtime. For more information on the XML MetaData Cache Control, see XML MetaData Cache Control in Using Integration Controls in the WebLogic Workshop Help, and for more information on the Process Control, see Process Control in Using Integration Controls in the WebLogic Workshop Help. For more information on the WebLogic Integration Administration Console, see Managing WebLogic Integration Solutions.

The Add New Process Control Selector and Edit Process Control Selector pages allow you to set the selector value, target URI, user name, and password alias.


 

The following table summarizes the available settings.

Setting

Description

Required/
Optional

In the Selector Value field, enter the look up key.

The value used to select and dynamically set control attributes at runtime.

Note: This field cannot be edited on the Edit Process Control Selector page.

Required to Add

In the Target URI field, enter the URI for the target process.

The URI for the target process associated with this look up key.

Optional

In the User Name field, enter the user name.

The user name (if required) used to invoke the target process.

Optional

In the Password Alias field, enter the password alias.

The password alias used to look up the user password in the password store. See Password Aliases and the Password Store.

Optional


 

 


Defining Service Broker Control Properties for a Selector

Note: The (Dynamic) Selector has now been deprecated. Please use the XML MetaData Cache Control to look up WebLogic Integration Administration Console configured values and then use the setProperties() calls of the Service Broker Control to set the endpoint at runtime. For more information on the XML MetaData Cache Control, see XML MetaData Cache Control in Using Integration Controls in the WebLogic Workshop Help, and for more information on the Service Broker Control see, Service Broker Control in Using Integration Controls in the WebLogic Workshop Help. For more information on the WebLogic Integration Administration Console, see Managing WebLogic Integration Solutions.

The Add New Service Broker Control Selector and Edit Service Broker Selector pages allow you to set the selector value and associated properties.


 

The following table summarizes the available settings.

Setting

Description

Required/
Optional

In the Selector Value field, enter the look up key.

The value used to select and dynamically set control attributes at runtime.

Note: This field cannot be edited on the Edit Service Broker Selector page.

Required

In the End Point field, enter the URI for the target service.

The URI for the service end point associated with this look up key.

Optional

From the Protocol drop-down list, select the protocol.

Protocol to use when making the call. Valid values are
http-soap
http-xml
jms-soap
jms-xml
form-get
form-post

The default is http-soap.

Note: The WebLogic Integration Administration Console allows you to specify any of the above values, therefore, you must take care to select a protocol that is supported by the process. For example, raw XML (non-SOAP) protocols do not work with conversational web services.

Optional

Select the No Dynamic Authentication, Basic Authentication, or Certificate Based Authorization option button.

Type of authentication.

If client certificates are required, select Certificate Based Authorization and enter values in the Keystore Location, Keystore Password Alias, and Keystore Type fields.

Optional

In the User Name field, enter the user name.

The user name (if required) used to invoke the target process.

Required if Basic Authentication is selected.

In the Password Alias field, enter the password alias.

The password alias used to look up the user password in the password store. See Password Aliases and the Password Store.

In the Client Certificate Alias field, enter the certificate alias.

Certificate alias if the remote service requires SSL with two-way authentication or a digital signature.

Required if Certificate Based Authorization is selected.

In the Client Certificate Password Alias field, enter the password alias.

Password alias to look up the certificate password in the password store. See Password Aliases and the Password Store.

In the Keystore Location field, enter the keystore location.

The keystore location.

Required if Certificate Based Authorization is selected.

In the Keystore Password Alias field, enter the password alias.

The password alias used to look up the keystore password in the password store. See Password Aliases and the Password Store.

In the Keystore Type field, enter the keystore type.

The keystore type.


 

 


Deleting Dynamic Control Selectors

The View Dynamic Controls Properties page allows you to delete selectors.

To delete a selector:

  1. Locate the dynamic control to update. See Listing and Locating Dynamic Controls.
  2. Click the Delete link to the left of the selector value to be deleted.
  3. The selector is deleted from the list.

 

Skip navigation bar  Back to Top Previous Next