Skip navigation.

eDocs Home > BEA WebLogic Integration 8.1 Documentation > Using the Application Integration Design Console > Defining an Application View

Using the Application Integration Design Console

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

Defining an Application View

This section presents the following topics:

 

Before You Begin

When you define an application view, you are creating an XML-based interface between WebLogic Server and a particular EIS application within your enterprise. Once you create the application view, a business analyst can use it to create business processes that use the application. For any adapter, you can create any number of application views, each of which may contain any number of services and events.

Before you define an application view, make sure the following prerequisites are satisfied:

 

Application View Design Considerations

Before you start defining an application view, please read the following design considerations:

 

High-Level Procedure for Defining an Application View

Figure 2-1 summarizes the procedure for defining and configuring an application view.

Figure 2-1 Procedure for Defining and Configuring an Application View

Procedure for Defining and Configuring an Application View


 
  1. Log on to the WebLogic Integration Application Integration Design Console. For detailed information, see Step 1: Log On to the Application Integration Design Console.
  2. Select an existing application or specify a new application name and root directory. application view files are stored in a file system related to an application. For detailed information, see Step 2: Select an Application.
  3. Add folders as required to help you organize application views. For detailed information, see Step 3: Add a Folder
  4. Click Add application view to create a new application view for the appropriate adapter. An application view enables business processes to make use of the specified adapter's target EIS. For detailed information, see Step 4: Define an Application View.
  5. Choose to create a new connection or to use an existing connection. For detailed information, see Step 5: Establishing a Browsing Connection.

    6. If you choose to create a new connection, you must enter application connection parameters. The information is validated, and the application view is configured to connect to the specified system For detailed information, see Step 5A: Create a New Browsing Connection.

    If you choose to use an existing connection, you must select an adapter instance and a connection factory. For detailed information, see Step 5B: Reuse an Existing Browsing Connection.

  6. Add services and events that support business processes. For detailed information, see Step 6: Add Services and Events.

    7. Click Add Event or Add Service to define the appropriate events and services for this application view. For detailed information see Step 6A: Add a Service to an Application View and Step 6B: Add an Event to an Application View.

  7. Once you have finished adding events and services, display the Connection Information page to perform final configuration tasks. For detailed information, see Step 7: Perform Final Configuration Tasks.
  8. Test all services and events to make sure they can properly interact with the target EIS application. For detailed information see Step 8A: Test an Application View's Services and Step 8B: Test an Application View's Events.

    9. Once your services and events are tested and functioning, you are ready to publish the application view, allowing it to be used in business processes. For more information on using application views with business processes, see Using Application Views with Business Processes.

  9. Publish the application view to the target WebLogic Workshop application. This allows business process developers within the target application to interact with the newly published application view using an Application View control. For more information, see Step 9: Publish an Application View.

 

Sample Detailed Procedure for Defining an Application View

This section explains how to define and maintain application views using an EIS adapter for a hypothetical database EIS called simply DBMS. The steps in the procedure presented here correspond to the steps shown in Figure 2-1.

When you create application views for your enterprise, they may look different from those shown in this document. Such differences are to be expected, because the application view's adapter determines the information required for each application view page, and each enterprise has its own specialized adapters. For details about an adapter used in your enterprise, consult the relevant technical analyst or EIS specialist.

Note: Before performing the following steps, ensure that WebLogic Server is running on your system.

Step 1: Log On to the Application Integration Design Console

The Application Integration Design Console displays all the application views in your WebLogic Integration environment, organized in folders.

Warning: You should only have one instance of the Application Integration Design Console running on a single client machine. Running multiple consoles on a single machine may interfere with proper navigation between screens in your web browser.

To log on to the Application Integration Design Console:

  1. Open a new browser window.
  2. Enter the URL for your system's Application Integration Design Console. The actual URL you enter depends on your system. It should conform to the following format:
    3. http://host:port/wlai

    Note: You can also invoke the Application Integration Design Console from WebLogic Workshop. Open a WebLogic Workshop application, ensure that WebLogic Server is running, and then choose Tools—>WebLogic Integration—>Application Integration Design Console.

    The Application Integration Design Console Logon page is displayed.

    Procedure for Defining and Configuring an Application View


     
  3. Enter your WebLogic Server username and password, then click Login.

    4. The Select Application page is displayed.

    Procedure for Defining and Configuring an Application View


     

A menu bar appears at the top of each page which allows you to navigate to other pages and to administration consoles. The following table describes the menu items.

Menu Item

Action

Application Integration Server Configuration

Use the WebLogic Integration Administration Console to set application integration parameters. Open the WebLogic Integration Administration Console, select the System Configuration module, and then select the Application Integration module. See Managing WebLogic Integration Solutions for more information on setting application integration parameters.

Switch Application

Displays the Select Application page where you can choose a new application for the design-time session.

WebLogic Server Console

Invokes the WebLogic Server Administration Console.

WebLogic Integration Console

Invokes the WebLogic Integration Administration Console.

Glossary

Invokes a glossary of terms related to application integration.

Note: The glossary is in progress and will be populated with more terms in a future release. For additional glossary terms, see the WebLogic Platform Glossary.

Logout

Logs you out of the current design session and displays the Logon page.


 

Step 2: Select an Application

The Application Integration Design Console stores information about application views in a file-based repository. Before you create an application view, you must select an application to use in the design-time session. This determines where application view information is stored.

  1. To choose an existing, deployed application, select an application from the Deployed Applications drop-down list.

    2. Note: WebLogic Workshop does not deploy an application until you add a project. You must add a project to the application in WebLogic Workshop before the application appears on the Deployed Applications drop-down list.

  2. To create a repository for a new application, specify an application name and the root directory for the application. (You can also enter the application name and root directory for an existing, deployed application.)

    3. For example, the following figure shows the name and root directory for a new application.

    Procedure for Defining and Configuring an Application View


     
  3. Click OK.

    4. The Application View Design Console page is displayed.

    Note: If you do not see the Application View Design Console page, consult the WebLogic Server administrator.

Step 3: Add a Folder

The application views in your enterprise are organized in folders that may contain application views and subsidiary folders. Once you create a folder, you cannot move it to another folder. Before removing a folder, you must remove all application views and subfolders. Once you create an application view in a folder, you can remove the application view, but you cannot move it to another folder.

The following figure shows the root folder with one application view and two subsidiary folders.

Procedure for Defining and Configuring an Application View


 

To create a folder:

  1. To add a folder, click the new folder Procedure for Defining and Configuring an Application View icon:

    2. The Add Folder page is displayed.

    Procedure for Defining and Configuring an Application View


     
  2. In the New Folder field, enter the folder name. Any valid Java Identifier is allowed in a name.

    3. Note: The name Root is a reserved word, and cannot be used for a folder name. If you use Root as a name, you cannot import or export the folder using the import-export utility described in Importing and Exporting Application Views.

  3. Click Save. The new folder appears on the Application View Design Console page

Step 4: Define an Application View

  1. Add a new application view to the current folder by clicking Add Application View.

    2. Note: Make sure you are working in the appropriate folder before performing this step. Once you define an application view, you cannot move it to another folder.

    The Define New Application View page is displayed.

    Procedure for Defining and Configuring an Application View


     
  2. In the Application View Name field, enter a name. The name should describe the functions performed by this application. Each application view name must be unique to its adapter. Any valid Java Identifier is allowed in a name.

    3. The red asterisk next to the Application View Name field indicates that this is a required field.

    Note: The name Root is a reserved word, and cannot be used for an application view name. If you use Root as a name, you cannot import or export the application view using the import-export utility.

  3. In the Description field, enter any notes that may be helpful to people connecting to this application view from business processes created in WebLogic Workshop.
  4. From the Associated Adapter list, select an adapter to be used to create this application view.

    5. Note: You can define an application view without selecting the adapter type. This allows for instances where you realize that an application view is needed, but do not have sufficient information at the time to fully define the application view. You can create, name, and enter a description of the required application view without selecting the adapter type or further defining the application view. When more information is available, you can continue defining the application view.

  5. Click Create New Connection to create a new browsing connection.

    6. The Create New Browsing Connection page is displayed, as described in Step 5A: Create a New Browsing Connection on page 2-12.

  6. Click Reuse Existing Connection to use an existing browsing connection.

    7. The Select Browsing Connection page is displayed, as described in Step 5B: Reuse an Existing Browsing Connection on page 2-15.

  7. Click Cancel to return to the previously displayed folder.

    8. The application view is not created.

Step 5: Establishing a Browsing Connection

You must choose the type of connection factory to associate with the application view. You can create a connection factory within a new adapter instance or select a connection factory within an existing instance of the adapter.

An adapter instance acts as a communications gateway between WebLogic Server and your EIS. This gateway can be unidirectional or bidirectional. Adapter instances include inbound messaging capabilities (from the EIS to WebLogic Server) that supports events, and connection factories that support services (outbound requests from WebLogic Server). An application view uses an adapter instance as a gateway for one of three purposes:

You must either create a new adapter instance or select an existing adapter instance that the application view will use. To enable design-time browsing and service invocation, you must also designate which connection factory the application view should use to get the connections used to communicate with the EIS.

When you choose to create a new connection, WebLogic Integration creates the adapter instance for you, and the connection parameters you define are used to create the connection factory within the adapter instance. For more information, see Step 5A: Create a New Browsing Connection.

When you choose to reuse an existing connection, you select the adapter instance and factory by name and do not need to specify connection parameters directly. If you do not know the proper parameters required to connect to a given EIS, have an EIS specialist set up the adapter instance and connection factory to use and the select them from the Application Integration Design Console. For more information, see Step 5B: Reuse an Existing Browsing Connection.

When establishing connections, the Application Integration Design Console is optimized for ease of use by first-time users. When you create a new connection, the browsing connection is also assigned as the service connection. This saves the first-time user a step in the process. More advanced users are likely to reuse an existing connection. In this case, the user is more familiar with the specific connection requirements and must separately assign the service connection.

Step 5A: Create a New Browsing Connection

  1. You use the Create New Browsing Connection page to configure the connection properties, pool parameters, log level, and sign-on behavior of a new connection factory. This creates a new adapter instance and connection factory within it. The adapter instance and connection factory are given default names based on the application view name.

    2. The Create New Browsing Connection page indicates whether you need to define connection parameters. If the connection needs to have adapter-specific properties set, it indicates this with a Needed label next to the Define button. This label is removed once you provide connection parameters.

    Procedure for Defining and Configuring an Application View


     
  2. In the Connection Name field, accept the default connection name suffix. (The connection names are assigned by the system and are not editable.)
  3. In the Description field, enter a description for the new connection.
  4. Click Define to define the connection parameters for the browsing connection.

    5. The Configure Connection Parameters page is displayed.

    Procedure for Defining and Configuring an Application View


     
  5. Enter the database username and password.
  6. Define the network-related information necessary to enable the application view to interact with the target EIS. You need to enter this information only once per application view.

    7. Note: The fields displayed on the page you see may differ from those shown here. Which fields are displayed is determined by the adapter. For the required information for any remaining fields, refer to your adapter documentation. For BEA WebLogic Adapters, see "Defining Service Connection Parameters" in your adapter User Guide, available at the following URL:

    http://download.oracle.com/docs/cd/E13207_01/wladapters/docs81/index.html

    If you are using an adapter that uses a JDBC DataSource, do not create two Tx Data Sources that point to the same connection pool. If a transaction uses two different Tx Data Sources which are both pointed to the same connection pool, you will get an XA_PROTO error when you try to access the second connection.

    For more information on JDBC DataSources and WebLogic Server, see "JDBC DataSources" in Administration Console Online Help at the following location:

    http://download.oracle.com/docs/cd/E13222_01/wls/docs81/ConsoleHelp/jdbc_datasources.html

  7. Click Continue in the Configure Connection Parameters page to return to the Create New Browsing Connection page.
  8. Edit the connection pool and log parameters as required.
  9. Click OK.

    10. The Application View Administration page is displayed. On the Application View Administration page, you can add services and events to your application view.

    Procedure for Defining and Configuring an Application View


     

Step 5B: Reuse an Existing Browsing Connection

You use the Select Browsing Connection page to choose an existing connection. You select both the adapter instance and a connection factory within it, from which connections to the EIS are obtained. These connections are used for browsing your EIS during design-time editing sessions.

Procedure for Defining and Configuring an Application View


 

Using an existing connection factory can simplify server administration, especially in cases where multiple adapters interact with a single EIS. Also, using a shared connection factory allows an administrator to set the connection factory configuration parameters and direct users to select an existing connection. In this case, the users do not have to know how to configure connection parameters.

  1. Choose the Selected radio button next to the connection factory you want to reuse.
  2. Click OK.

    3. The Application View Administration page is displayed. On the Application View Administration page, you can add services and events to your application view.

    Procedure for Defining and Configuring an Application View


     

Step 6: Add Services and Events

The Add Service and Add Event pages allow you to add services and events that support specific business processes. An application view can have multiple services and events. The required business processes determine the types of services and events you include in your application views. Work with your business analyst to define the application's business requirements. Once you determine the necessary business processes, you can define the appropriate services and events.

Step 6A: Add a Service to an Application View

  1. On the Application View Administration page, click Add in the Services row.

    2. The Add Service page is displayed.

    Procedure for Defining and Configuring an Application View


     

Note: The fields displayed on the page you see may differ from those shown here. Which fields are displayed is determined by the adapter.

  1. In the Unique Service Name field, enter a name. The name should describe the function performed by this service. Each service name must be unique to its application view. Any valid Java Identifier is allowed in a name.
  2. In the Description field, enter any notes which may be helpful to people using this application view in business processes created in WebLogic Workshop.
  3. For the required information for any remaining fields, consult the relevant technical analyst or EIS specialist, or refer to your adapter documentation.

    4. Note: For BEA WebLogic Adapters, see "Setting Service Properties" in your adapter User Guide, available at the following URL:

    http://download.oracle.com/docs/cd/E13207_01/wladapters/docs81/index.html

    In many cases, this required information consists of an SQL statement for retrieving information from or updating information in a database. The following sample SQL statement retrieves customer information from a customer table based on a user-specified country value:

    select * from WEBLOGIC.CUSTOMER_TABLE 
    where COUNTRY=[country varchar]

    The sample application views provided with WebLogic Integration include services which use SQL statements. Display the Application View Administration page and click the View Summary link for a service. The Summary page includes an SQL statement.

  4. You can optionally specify environment variables for the application view in the Variables area in the lower portion of the Add Service page. For more information on environment variables, see Environment Variables for Application Views.

    5. Procedure for Defining and Configuring an Application View


     

    To add an environment variable:

    1. Enter a name for the environment variable in the Name field.
    2. Select a data type for the variable from the Type drop-down list.
    3. Optionally specify a default value and a description for the variable.
  5. When finished, click Add.

    6. The Application View Administration page is displayed. Note that the new service is shown along with links which allow you to edit, remove, and view information about the service.

  6. If you are finished adding services and do not plan to add any events, click Save to save the current application view information. You must create or select connections for services, as described in Step 7: Perform Final Configuration Tasks, before testing and publishing the application view.

Step 6B: Add an Event to an Application View

  1. On the Application View Administration page, click Add in the Events row.

    2. The Add Event page is displayed.

    Procedure for Defining and Configuring an Application View


     

    Note: The fields displayed on the page you see may differ from those shown here. Which fields are displayed is determined by the adapter.

  2. In the Unique Event Name field, enter a name. Each event name must be unique to its application view. Any valid Java Identifier is allowed in a name.
  3. In the Description field, enter any notes that may be helpful to people using this application view in business processes created in WebLogic Workshop.
  4. For the required information for any remaining fields, consult the relevant technical analyst or EIS specialist, or refer to your adapter documentation.

    5. Note: For BEA WebLogic Adapters, see "Setting Event Properties" in your adapter User Guide, available at the following URL:

    http://download.oracle.com/docs/cd/E13207_01/wladapters/docs81/index.html

  5. You can optionally specify environment variables for the application view in the Variables area in the lower portion of the Add Event page. For more information on environment variables, see Environment Variables for Application Views.

    6. Procedure for Defining and Configuring an Application View


     

    To add an environment variable:

    1. Enter a name for the environment variable in the Name field.
    2. Select a data type for the variable from the Type drop-down list.
    3. Optionally specify a default value and a description for the variable.
  6. When finished, click Add.

    7. The Application View Administration page is displayed. Note that the new event is shown along with links which allow you to edit, remove, and view information about the event.

  7. If you are finished adding services and events, click Save to save the current application view information. You must create or select connections for services and events, as described in Step 7: Perform Final Configuration Tasks, before testing and publishing the application view.

Step 7: Perform Final Configuration Tasks

Once you have finished adding services and events and have saved your application view, you must complete final configuration of connections before testing services and events. These configuration tasks are performed from the Application View Administration page.

Procedure for Defining and Configuring an Application View


 
  1. Click Select/Edit.

    2. The Connection Information page is displayed.

    Procedure for Defining and Configuring an Application View


     

    The Connection Information page is organized by connection type: service invocation, event delivery, and design-time browsing connections. (For more information on how application views use adapter instances and connection factories, see Step 5: Establishing a Browsing Connection.)

  2. To edit the connection for services and design-time browsing, click Browsing. (This is the browsing connection you defined in Step 5A: Create a New Browsing Connection.)

    3. The appropriate Edit Connection page is displayed. Note that only one connection is used for services and browsing and that changes made on the one Edit Connection page will appear on the other Edit Connection page.

  3. To create a new connection for services and design-time browsing, click Create New. (This is the connection you defined in Step 5A: Create a New Browsing Connection.)

    4. The appropriate Create New Connection page is displayed.

    If no connection parameters have been set for a connection and the Needed label is displayed nest to the Define button, the connection parameters page is displayed when you click OK on either the event or service connection page. When you click Continue, the Event or Service Connection page is displayed without the Needed label.

    Note: For BEA WebLogic Adapters, see "Defining Service Connection Parameters" in your adapter User Guide, available at the following URL:

    http://download.oracle.com/docs/cd/E13207_01/wladapters/docs81/index.html

  4. To select an existing connection that is different from the current connection, click the Select Existing... link.

    5. The appropriate Select Connection page is displayed. This page is the same as the page described in Step 5B: Reuse an Existing Browsing Connection.


     
  5. Click Event to configure the connection properties, enable or disable the namespace enforcement option, and set the log level for your event connection.

    6. The Edit Event Connection page is displayed.

    Procedure for Defining and Configuring an Application View


     

    The Edit Event Connection page allows you to define event connection parameters, enable or disable the namespace enforcement option, and specify what information will be logged for the connection factory.

  6. To enable namespace enforcement, check the Enable event namespace enforcement check box.

    7. Enable the namespace enforcement option to indicate that the client requires response documents and event documentst to declare the namespace indicated in the response/event definitions, and force the proper namespace declaration onto the response/event if needed.

    Some legacy adapters do not provide responses/events using the namespace declared in the response/event schema This option allows clients that perform schema-based XML checking to use such adapters.

    Note: If the adapter returns raw XML text (not parsed), enabling namespace enforcement has serious performance implications because it forces a parse of the XML text in order to inject the proper namespace declaration.

  7. Select one of the following settings for the log:
  8. Locate Connection Parameters and click Define to set the event delivery parameters.

    9. The Configure Event Delivery Parameters page is displayed.

    Procedure for Defining and Configuring an Application View


     

    The event delivery parameters you enter on this page enable connection to an EIS instance and are used when generating events. The properties are specific to the associated adapter and are defined in the wli-ra.xml file within the base adapter.

    Note: For BEA WebLogic Adapters, see "Defining Event Connection Parameters" in your adapter User Guide, available at the following URL:

    http://download.oracle.com/docs/cd/E13207_01/wladapters/docs81/index.html

  9. After you have set the event delivery parameters, click Continue to return to the Edit Event Connection page and then click OK to return to the Connection Information page.
  10. Click Back to return to the Application View Administration page.

Step 8A: Test an Application View's Services

The purpose of testing an application view service is to evaluate whether or not that service interacts properly with the target EIS. You can test an application view only if it is deployed and it contains at least one event or service. To test an application view service:

  1. In the Application View Administration page, click Test.

    2. The Summary for Application View page is displayed. Note that the Status is Testing and a Stop Testing link is displayed.

    You can optionally click Set Variables and Test. The Set Variables and Test Application View page is displayed. You can edit the values of environment variables and then click Test to test the application view.

    Procedure for Defining and Configuring an Application View


     
  2. In the Services area of the Events and Services tab, find the appropriate service and click Test.

    3. The Test Service page is displayed.

    Procedure for Defining and Configuring an Application View


     
  3. If necessary, enter the required data in the appropriate fields.

    4. Note: The fields displayed on your Test Service page may differ from those show here. Which fields are displayed is determined by the application view service. For a description of all fields, consult the relevant technical analyst or EIS specialist. For BEA WebLogic Adapters, see "Testing Services" in your adapter User Guide, available at the following URL:

    http://download.oracle.com/docs/cd/E13207_01/wladapters/docs81/index.html

  4. Click Test.

    5. If the application view service correctly processes the input data that you provided in step 3, the test is successful. The Test Result page, on which all input and output documents are listed, is displayed. If the service fails, the failure will be shown in the response field.

    Procedure for Defining and Configuring an Application View


     
  5. Repeat the test procedure (steps 1-4) for each service you want to test.
  6. After you finish testing the application view's services, you may publish the application view or, if you want to edit it, you may return to the Summary page, click Stop Testing.

Step 8B: Test an Application View's Events

The purpose of testing your application view events is to evaluate whether or not the application view responds correctly to the EIS application. You can test an application view only if it is deployed and it contains at least one event or service. To test an application view event:

  1. In the Application View Administration page, click Test.

    2. The Summary for Application View page is displayed. Note that the Status is Testing and a Stop Testing link is displayed.

  2. In the Events area on the Events and Services tab, find your event and click Test.

    3. The Test Event page is displayed.

    Procedure for Defining and Configuring an Application View


     

    Note: The fields displayed on your Test Event page may differ from those shown here. Which fields are displayed is determined by the application view event. For a description of all fields, consult the relevant technical analyst or EIS specialist. For BEA WebLogic Adapters, see your adapter User Guide, available at the following URL:

    http://download.oracle.com/docs/cd/E13207_01/wladapters/docs81/index.html

  3. Select a method for generating the test event:

    4. If the application view event responds correctly before the specified amount of time elapses, the test is successful.

If You Select Service

  1. From the Service drop-down list, select a service that triggers the event you are testing. For example, if you are testing the CustomerInserted event, select a service that invokes it, such as InsertCustomer.
  2. In the Time field, enter a reasonable period of time to wait, specified in milliseconds. (One minute = 60,000 milliseconds.)

    3. If the specified period elapses before the event succeeds, the test times out and a failure message is displayed.

  3. Click Test. The triggering service is executed.

    4. If the service requires input data, an input page is displayed.

    Note: For BEA WebLogic Adapters, see "Testing Events Using a Service" in your adapter User Guide, available at the following URL:

    http://download.oracle.com/docs/cd/E13207_01/wladapters/docs81/index.html

  4. If service input data is required, enter it in the appropriate fields, and click Test.

    5. The service is executed. If the test succeeds, the Test Result page is displayed, showing the event document, the service input document, and the service output document. If the test fails, the Test Result page displays only a Timed Out message.

  5. Do one of the following:
  6. When finished, save the application view.

If You Select Manual

  1. In the Time field, enter a reasonable time to wait, specified in milliseconds. (One minute = 60,000 milliseconds.)

    2. If this period elapses before the event succeeds, the test times out and a failure message is displayed.

  2. If the application you will use to trigger the event is not already open, open it now.

    3. Note: For BEA WebLogic Adapters, see "Testing Events Manually" in your adapter User Guide, available at the following URL:

    http://download.oracle.com/docs/cd/E13207_01/wladapters/docs81/index.html

  3. Click Test. The test waits for an event to trigger it.
  4. Using the triggering application, perform an action that executes the service that, in turn, tests the application view event.

    5. If the test succeeds, the Test Result page is displayed. This page, in turn, displays the event document from the application, the service input document, and the service output document.

    If the test fails or takes too long, the Test Result page is displayed, showing a Timed Out message.

  5. Do one of the following:
  6. When you are finished, save the application view.

Step 9: Publish an Application View

From the Summary page, you can publish an application view that has been tested. This generates an EJB within the application directory, publishes schema files to the WebLogic Workshop application for use in the XML Mapper, and makes the application view visible within WebLogic Workshop. The Application View control wizard browses only published application views.

When you publish an application view, it becomes a part of the WebLogic Workshop application. After publishing, the application view is controlled by the WebLogic Workshop application rather than the Application Integration Design Console. You must republish the application view if you edit it in the Application Integration Design Console.

Note: You must recreate any Application View control that uses an application view that has been modified in the Application Integration Design Console and republished.

When the application view has been published, a message similar to the following is displayed on the Summary page:

EastCoast.Sales.CustomerManagement published to:
C:\bea\weblogic81\domains\samples\integration\sampleApp\
sampleApp_EastCoast_Sales_CustomerManagement_ApplicationView-ejb.jar

All application integration artifacts (application views, schemas, and namespaces) are contained in the application view EJB. The EJB is rebuilt as necessary to reflect changes in the application integration artifact source files. The source files are maintained in the wlai-repository directory under the EAR root directory. When an application view is published, the schemas needed by the application view are copied into the Schemas/wlai directory in the WebLogic Workshop application.

When you publish an application view, testing is automatically stopped before the application view is published. This ensures that your temporary test application view deployments are removed from the server and do not interfere with your published application view.

Note: When you publish an application view, schemas are published to the WebLogic Workshop application. Publishing an application view and opening WebLogic Workshop may cause the Schema project to be rebuilt. If you edit a business process (for example, to define a start node) before the Schemas project has finished rebuilding, you may see an error message similar to the following:

The type for the variable could not be resolved. This may be due to not entering fully qualified type name. Please go to source to correct errors.

Make sure that the Schema project has completed its rebuild before editing the business process.

Published application views can be monitored and managed using the WebLogic Integration Administration Console. For more information on managing application views and adapter instances, see Managing WebLogic Integration Solutions.

Note: When you delete a previously published application view, associated wlai.channel file, and EJB file, the application view ID still appears in the WebLogic Integration Administration Console and is shown in an Undeployed state after you rebuild the application. The deleted application view ID is removed from WebLogic Integration Administration Console when you reboot the system.

 

Editing an Application View

When you define an application view, you must configure its connection parameters. After you add and test services and events, you may want to reconfigure the connection parameters or remove services and events.

To edit an existing application view:

  1. Open the application view.

    2. The Summary for Application View page is displayed.

  2. Click the Edit link under Available Actions.

    3. The Application View Administration page is displayed.

  3. To reconfigure the application view's connection parameters, select the Select/Edit link under Connections.

    4. The Connection Information page is displayed. Follow the instructions in Step 7: Perform Final Configuration Tasks.

  4. To add services or events, click Add in the Services or Events area. Follow the instructions in Step 6A: Add a Service to an Application View or Step 6B: Add an Event to an Application View.

 

Setting Transaction Timeout Values for Application Views

The current default JTA transaction timeout for domains generated by the Configuration Wizard is 30 seconds. Typically, many adapter calls can exceed 30 seconds. You can increase the server's default transaction timeout using the WebLogic Server Administration Console:

  1. Open the WebLogic Server Administration Console and log in.
  2. In the left pane, select Services—>JTA.

    3. The JTA configuration page is displayed.

  3. In the right pane, edit the Timeout Seconds field to reflect a longer timeout value. The suggested value is 500 seconds.

To implement the increased timeout value, you must republish your application views or manually change the weblogic-ejb-jar.xml descriptor in your previously published application views. To manually increase the value, insert the following into weblogic-ejb-jar.xml in the weblogic-enterprise-bean element for both the stateless and stateful session EJBs for the application view: 

<transaction-descriptor>
   <trans-timeout-seconds>500</trans-timeout-seconds>
</transaction-descriptor>

 

Environment Variables for Application Views

Application views contain metadata about associated services and events. This metadata often contains references to environment-specific resources or data values that may need to be updated dynamically. Environment variables allow these values to be updated dynamically, without having to undeploy, edit, and redeploy the application view. Once an environment variable is created, its value can be specified at time of deployment or dynamically at runtime.

Variable definitions will contain the following:

You can define new variables when adding or editing services or events. The list of existing variables is also displayed and can be edited on the Application View Administration and Application View Summary pages.

Once the application view has been published, an administrator can display environment variables and edit their values in the WebLogic Integration Administration Console. An administrator can not add or delete environment variables.

 

Database-Specific Error Messages

When using your published application views, you may see database-specific error messages written to the log file. The section identifies some of the more common database-specific error messages.

From time to time, when using Sybase or MSSQL databases, warnings are issued stating that the active database and/or language has been changed. These warnings come from the Sybase and MSSQL databases when the active database or language is changed on a connection. Since the catalog is changed at various points in the DBMS sample adapter, users of the sample adapter will inevitably see these messages. These warnings are harmless and can be ignored.

When an adapter instance in an MSSQL XA environment is automatically suspended and resumed, error messages similar to the following are thrown.

<Oct 15, 2003 4:40:30 PM PDT> <Error> <JDBC> <BEA-001112>
<Test "SELECT COUNT(*) FROM sysobjects" set up for pool "wlaiPool" failed with
exception: "javax.transaction.xa.XAException: [BEA][SQLServer JDBC Driver]
No more data available to read.".>

This is a JDBC-level error, generated as the JDBC container cleans up existing/dead connections to the restarted DBMS instance. This type of exception is normal in this case; the EIS is available, the adapter instance is resumed successfully, and the JDBC container recovers.

When using an application view with a Microsoft SQL Server or Sybase database, use the WebLogic Server Administration Console to enable the TestReservedConnection parameter for the connection pool used for application integration. If the parameter is not enabled, the auto resume or manual resume features do not work and a SQLException similar to the following is thrown:

java.sql.SQLException: [BEA][SQLServer JDBC Driver]No more data
available to read

 

Skip navigation bar  Back to Top Previous Next