BEA WebLogic User Manual
  1. Manuals
  2. Brands
  3. BEA Manuals
  4. Adapter
  5. WebLogic Server
  6. User manual
BEA WebLogic User Manual

BEA WebLogic User Manual

Adapter for manugistics
Hide thumbs Also See for WebLogic:
Table of Contents

Advertisement

Quick Links

Download this manual See also: User Manual, Manual
WebLogic
BEA
Adapter for
Manugistics
™
User Guide
Release 7.0.3
Document Date: April 2003

Advertisement

Table of Contents
loading

Related Manuals for BEA WebLogic

Summary of Contents for BEA WebLogic

  • Page 1 WebLogic Adapter for Manugistics ™ User Guide Release 7.0.3 Document Date: April 2003...
  • Page 2 Restricted Rights Legend This software and documentation is subject to and made available only pursuant to the terms of the BEA Systems License Agreement and may be used or copied only in accordance with the terms of that agreement. It is against the law to copy the software except as specifically allowed in the agreement.

  • Page 3: Table Of Contents

    Introduction ....................... 1-1 How the BEA WebLogic Adapter for Manugistics Works....... 1-3 How Services in the BEA WebLogic Adapter for Manugistics Work ..1-3 How Events in the BEA WebLogic Adapter for Manugistics Work ..1-5 How the Adapter Interfaces with Manugistics Processes ......1-7 2.
  • Page 4 Tracing and Performance................... 5-3 Creating Traces for Services and Events ............5-3 Creating Traces for a Service ..............5-4 Creating or Modifying the Tracing Level for an Event......5-6 Creating Adapter Logs for an Event............5-9 BEA WebLogic Adapter for Manugistics User Guide...

  • Page 5: About This Document

    About This Document The BEA WebLogic Adapter for Manugistics User Guide is organized as follows: Chapter 1, “Introducing the BEA WebLogic Adapter for Manugistics,”describes the components of the BEA WebLogic Adapter for Manugistics, describes its features, and presents a high-level description of how the adapter works.

  • Page 6: Related Information

    BEA WebLogic Adapter for Manugistics Installation and Configuration Guide BEA WebLogic Adapter for Manugistics Release Notes BEA WebLogic Server installation and user documentation, which is available at the following URL: http://edocs.bea.com/more_wls.html BEA WebLogic Integration installation and user documentation, which is available at the following URL: http://edocs.bea.com/more_wli.html...

  • Page 7: Documentation Conventions

    #include <iostream.h> void main ( ) the pointer psz chmod u+w * \tux\data\ap .doc tux.doc BITMAP float Identifies significant words in code. monospace boldface Example: text void commit ( ) Identifies variables in code. monospace italic Example: text String expr BEA WebLogic Adapter for Manugistics User Guide...
  • Page 8 Example: buildobjclient [-v] [-o name ] [-f file-list]... [-l file-list]... Indicates the omission of items from a code example or from a syntax line. The vertical ellipsis itself should never be typed. viii BEA WebLogic Adapter for Manugistics User Guide...

  • Page 9: Introducing The Bea Weblogic Adapter For Manugistics

    HAPTER Introducing the BEA WebLogic Adapter for Manugistics This section introduces the components of the BEA WebLogic Adapter for Manugistics, describes its features, and presents a high-level description of how the adapter works. It includes the following topics: Introduction How the BEA WebLogic Adapter for Manugistics Works...
  • Page 10 BEA WebLogic Integration, true integration of Manugistics with all your various disparate applications is not only possible, it is very easy. Whether you are moving information into or out of Manugistics, the BEA WebLogic Adapter for Manugistics provides a proven, easy to use, cost effective architecture that: Protects your organization’s investment in legacy systems.

  • Page 11: How The Bea Weblogic Adapter For Manugistics Works

    How Services in the BEA WebLogic Adapter for Manugistics Work Services configured in the BEA WebLogic Adapter for Manugistics allow you to use data from order processing, enterprise resource planning (ERP), and enterprise-wide data warehouse systems to update the Manugistics UDM. Relevant data for Manugistics includes order and sales information, purchase orders, inventory balances, and forecasts usually available in the external systems.The adapter uses the...
  • Page 12 As data becomes available in applications such as Oracle, Siebel, or SAP, and is passed to the adapter within the BEA WebLogic Integration environment, it is parsed by the adapter to ensure its compatibility with the Manugistics UDM. Use the Manugistics VIEWpoint client, a graphical user interface for the Manugistics platform, to configure a batch mode import file to match the data passed from the adapter.

  • Page 13: How Events In The Bea Weblogic Adapter For Manugistics Work

    How Events in the BEA WebLogic Adapter for Manugistics Work Events configured in the BEA WebLogic Adapter for Manugistics allow you to use forecast data generated by Manugistics to update order processing, enterprise resource planning (ERP), and enterprise-wide data warehouse systems. Relevant data for the Manugistics NetWORKS solutions includes order and sales information, purchase orders, inventory balances, and forecasts usually available in the external systems.
  • Page 14 UDM is updated with the forecast data, the adapter converts the data into XML and passes it through WebLogic Integration so that it can be used to update systems such as SAP and Siebel. For more information on the how the adapter works with Manugistics, see “How the Adapter Interfaces with Manugistics Processes”...

  • Page 15: How The Adapter Interfaces With Manugistics Processes

    The Manuba batch process uses this information to carry out the export of data from the Manugistics database. The BEA WebLogic Adapter for Manugistics receives data from systems such as SAP and transforms the data into XML. Once it is in XML, the adapter can convert it to the format that can be used by the Manugistics Manuba process to update the Manugistics UDM.
  • Page 16 Introducing the BEA WebLogic Adapter for Manugistics When you configure services, you must provide information about your Manugistics system, such as the location of the Manuba batch file, that will allow the adapter to invoke the Manuba process. BEA WebLogic Adapter for Manugistics User Guide...

  • Page 17: Creating And Configuring Events

    HAPTER Creating and Configuring Events An event adapter is the inbound interface from a Manugistics application to WebLogic Integration Studio. This section describes how to create, configure, and test an event adapter. It contains the following topics: Creating an Application View Folder...
  • Page 18 Creating and Configuring Events Here, is the IP address or host name where the WebLogic appserver-host Integration Server is installed, and is the socket on which the server is port listening. The port, if not changed during installation, defaults to 7001.

  • Page 19: Creating An Event Adapter Application View

    For more information, see Chapter 4, “Creating Schema Repositories.” To create an event adapter application view: 1. Log on to the WebLogic Integration Application View Console at http://appserver-host:port/wlai Here is the IP address or host name where the WebLogic...
  • Page 20 If the application view is deployed, you can access the window by first undeploying the application view. a. Type the name of the BEA WebLogic Adapter for Manugistics session base directory in the Session path field. This directory holds your Manugistics schema information and contains the...

  • Page 21: Configuring An Event Adapter Application View

    A service should be added for each event that is used by the application view. To add an event to, and deploy, an event adapter application view: 1. Log on to the WebLogic Integration Application View Console at http://appserver-host:port/wlai BEA WebLogic Adapter for Manugistics User Guide...
  • Page 22 Creating and Configuring Events 2. Select the folder in which this application view resides. 3. Select the application view. 4. In the Administration window of the WebLogic Integration Application View Console, choose Add Event. The Add Event window opens. Figure 2-6 Add Event Window - ManugisticsSQL 5.
  • Page 23 For example, if Maximum Rows is set to 5, and 23 new rows are found to have been added when the database is polled, four events containing five rows and one event containing three rows are created. BEA WebLogic Adapter for Manugistics User Guide...
  • Page 24 RDBMS. If no value is specified, connection will use the Driver, URL, UserId and Password specified in the service. 6. Select a schema from the drop-down list. 7. Select trace settings as follows: BEA WebLogic Adapter for Manugistics User Guide...
  • Page 25 For more information about tracing, Chapter 5, “Using Tracing.” 8. Click Add. The Application View Administration window opens. Figure 2-7 Application View Administration Window BEA WebLogic Adapter for Manugistics User Guide...

  • Page 26: Deploying An Application View

    You must deploy an application view before you can test its services and events or use the application view in the WebLogic Server environment. Application view deployment places relevant metadata about its services and events into a run-time metadata repository.
  • Page 27 Deploying an Application View Figure 2-8 Application Administration Window 2. Click Continue. The Deploy Application View window opens. BEA WebLogic Adapter for Manugistics User Guide 2-11...
  • Page 28 5. To validate that the application view was successfully deployed, proceed to the main Application View Console window and double-click the folder in which you created the application view. You should see the name of the new application view with a status of deployed. 2-12 BEA WebLogic Adapter for Manugistics User Guide...

  • Page 29: Testing Events Using Application View Console

    You can test configuration using the Application View Console. To confirm that a deployed event adapter application view is correctly configured and can receive events: 1. Log on to the WebLogic Integration Application View Console at http://appserver-host:port/wlai 2. Select the folder in which the application view resides and then select the application view.
  • Page 30 This provides a 30-second period during which you can access the Manugistics client program (or your favorite utility) to manually invoke a request from Manugistics to your event adapter. 5. Click Test. 2-14 BEA WebLogic Adapter for Manugistics User Guide...

  • Page 31: Testing Event Adapter Application Views Using Wli Studio

    Testing Event Adapter Application Views Using WLI Studio You can test configuration using WebLogic Integration Studio. To confirm that a deployed event adapter application view is correctly configured and can receive events: 1. Log on to WebLogic Integration Studio.
  • Page 32 Creating and Configuring Events Figure 2-14 Selecting Create Template in WebLogic Integration Studio 2. In the Organization pane, select an organization to create a new workflow template. 3. Right-click Templates and select Create Template. The Template Properties window opens. Figure 2-15 Template Properties Window 4.
  • Page 33 Testing Event Adapter Application Views Using WLI Studio Figure 2-16 Displaying the New Template in WebLogic Integration Studio 7. To select node properties, right-click the Start node. Figure 2-17 Selecting Node Properties in WebLogic Integration Studio 8. Select Properties from the pop-up menu.
  • Page 34 Select the variable type XML from the drop-down list. g. Select the Input and Output options in the Parameter group. h. Click OK. 9. Right-click the template in the organization pane of WebLogic Integration Studio and select Save. 10. Right-click the event definition folder and select Properties.
  • Page 35 Ensure that Active is checked. b. Click OK. You may now initiate events from your Enterprise Information System (EIS). For the BEA WebLogic Adapter for Manugistics, you can create events through Manugistics Manuba or the Manugistics Client (ViewPoint) test program.
  • Page 36 Creating and Configuring Events The Workflow Variables window opens. 15. Click View XML to see the entire contents of the workflow message (messages are also known as documents). Figure 2-22 Workflow Variables Window 2-20 BEA WebLogic Adapter for Manugistics User Guide...

  • Page 37: Creating And Configuring Services

    HAPTER Creating and Configuring Services The service adapter for Manugistics is WebLogic Integration’s interface to Manugistics. It enables your business processes to move information to your Manugistics application system. This section describes how to create, configure, and test a service adapter application view. It includes the following topics:...
  • Page 38 The Configure Connection Parameters window opens. Figure 3-2 Configure Connection Parameters Window a. Enter the name of the BEA WebLogic Adapter for Manugistics session base directory in the Session path field. This directory holds your Manugistics schema information and contains the...

  • Page 39: Configuring A Service Adapter Application View

    To configure a service adapter application view: 1. Log on to the Application View Console at http://appserver-host:port/wlai Here, is the IP address or host name where the WebLogic appserver-host Integration Server is installed, and is the socket on which the server is port listening.
  • Page 40 Creating and Configuring Services Figure 3-3 Administration Window 3. From the left navigation pane, select Add Service. The Add Service window opens. Figure 3-4 Add Service Window...

  • Page 41: Configuring A Service Adapter Application View

    Description Trace Generates a basic trace that displays the input XML (up to 300 bytes) before parsing, and shows the request being processed. For more information about tracing, see Chapter 5, “Using Tracing.” BEA WebLogic Adapter for Manugistics User Guide...
  • Page 42 Creating and Configuring Services Table 3-2 Trace Options Parameter Description Verbose Trace Generates a trace that displays configuration parameters used by the adapter. For more information about tracing, see Chapter 5, “Using Tracing.” Document Trace Generates a trace that displays the input document after it was analyzed and the response document being returned.

  • Page 43: Deploying An Application View

    You must deploy an application view before you can test its services and events or use the application view in the WebLogic Server environment. Application view deployment places relevant metadata about its services and events into a run-time metadata repository.
  • Page 44 3. Update service parameters, connection pool parameters, log configuration, and security as required. For more information, see “Defining an Application View” in Using Application Integration: http://edocs.bea.com/wli/docs70/aiuser/2usrdef.htm 4. Click Deploy to save and deploy the service adapter. The Summary for Application View Manugistics Service window opens on...

  • Page 45: Testing Services Using Application View Console

    You can test using the Application View Console. To confirm that a deployed service adapter application view is correctly configured: 1. Log on to the WebLogic Integration Application View Console at http://appserver-host:port/wlai 2. Select the folder in which the application view resides and then select the application view.
  • Page 46 Creating and Configuring Services Figure 3-9 Application View Summary 3. Click Test. The console displays the test entry input box. Figure 3-10 Test Service Window 4. In the text box, enter a valid XML string that will act as the request data. 5.

  • Page 47: Testing Service Adapter Application Views Using Wli Studio

    Figure 3-11 Test Service Output Testing Service Adapter Application Views Using WLI Studio You can test service adapter application views using WebLogic Integration Studio. To confirm that a deployed service adapter application view is correctly configured and that it can process services: 1.
  • Page 48 Creating and Configuring Services Figure 3-12 WebLogic Integration Studio 3. Right-click Templates and select Create Template. The Template Properties dialog box appears. Figure 3-13 Template Properties Dialog Box a. Enter a name for your workflow template. b. Click OK. 4. Right-click the new template and select Create Template Definition.
  • Page 49 5. Click OK. The template appears in WebLogic Integration Studio. 6. Right-click the Task node and select Properties. Figure 3-15 Choosing Node Properties in WebLogic Integration Studio The Task Properties dialog box opens. Figure 3-16 Task Properties 7. Select Add.
  • Page 50 Creating and Configuring Services The Add Action dialog box opens. Figure 3-17 Add Action 8. Click AI Actions, and then Call Application View Service. The Call Service dialog box appears. Figure 3-18 Call Service Dialog Box 3-14...
  • Page 51 Click OK. f. Click Set in the Call Service dialog box to set the request document. As this is only a partial workflow, the request document containing the request must be set. BEA WebLogic Adapter for Manugistics User Guide 3-15...
  • Page 52 Ensure that Active is checked. b. Click OK. You can now initiate the workflow from the BEA Worklist. 11. From the Start menu, select BEA WebLogic Platform 7.0 , WebLogic Integration 7.0, and then Worklist. 12. Log on to Worklist.
  • Page 53 Testing Service Adapter Application Views Using WLI Studio Figure 3-21 WebLogic Integration Worklist Window - Workflow Start a. Select the workflow that was just created from the workflow list. b. Click OK. You receive a message indicating that your workflow started successfully.
  • Page 54 Creating and Configuring Services 3-18...

  • Page 55: Creating Schema Repositories

    Without this metadata, the Application Explorer can't generate these schemas for you. Because Manugistics doesn't expose any of the metadata the BEA Application Explorer uses to generate the XML schemas, you must create these schemas. After you have created the schema repository and schemas, you can configure services and events.

  • Page 56: Naming A Schema Repository

    You assign each application view to a schema repository; several application views can be assigned to the same repository. All BEA WebLogic adapters use a schema repository to store their schema information for use by the Application View Console. The schema repository is a directory containing: A manifest file that describes the event and service schemas.

  • Page 57: The Repository Manifest

    The manifest has a connection section and a schema reference section, named . The connection section contains default values that are used when schemaref creating the application view. The schema reference name appears in the schema BEA WebLogic Adapter for Manugistics User Guide...

  • Page 58: Creating A Repository Manifest

    The repository manifest is an XML file with the root element manifest and two sub-elements: appears once and is optional for the BEA WebLogic Adapter for connection Manugistics. If you do not want to enter default values, then include only the XML tags with no values.

  • Page 59: Creating A Schema

    Creating a Schema Schemas describe the rules of the XML documents that traverse WebLogic Integration. You can generate a schema manually or by using a schema-generating tool. Note: If you manually create an XML schema, the namespace prefix in the manifest...
  • Page 60 <xsd:attribute name="type" type="xsd:string" use="required"/> <xsd:attribute name="null" type="xsd:string" use="optional"/> </xsd:extension> </xsd:simpleContent> </xsd:complexType> </xsd:element> <xsd:element name="DMDGROUP" minOccurs="0"> <xsd:complexType> <xsd:simpleContent> <xsd:extension base="xsd:string"> <xsd:attribute name="type" type="xsd:string" use="required"/> <xsd:attribute name="null" type="xsd:string" use="optional"/> </xsd:extension> </xsd:simpleContent> </xsd:complexType> </xsd:element> <xsd:element name="LOC" minOccurs="0"> BEA WebLogic Adapter for Manugistics User Guide...
  • Page 61 <xsd:attribute name="null" type="xsd:string" use="optional"/> </xsd:extension> </xsd:simpleContent> </xsd:complexType> </xsd:element> <xsd:element name="TYPE" minOccurs="0"> <xsd:complexType> <xsd:simpleContent> <xsd:extension base="xsd:string"> <xsd:attribute name="type" type="xsd:string" use="required"/> <xsd:attribute name="null" type="xsd:string" use="optional"/> </xsd:extension> </xsd:simpleContent> </xsd:complexType> </xsd:element> <xsd:element name="FCSTID" minOccurs="0"> <xsd:complexType> BEA WebLogic Adapter for Manugistics User Guide...
  • Page 62 <xsd:attribute name="null" type="xsd:string" use="optional"/> </xsd:extension> </xsd:simpleContent> </xsd:complexType> </xsd:element> <xsd:element name="SCENBITS" minOccurs="0"> <xsd:complexType> <xsd:simpleContent> <xsd:extension base="xsd:string"> <xsd:attribute name="type" type="xsd:string" use="required"/> <xsd:attribute name="null" type="xsd:string" use="optional"/> </xsd:extension> </xsd:simpleContent> </xsd:complexType> </xsd:element> <xsd:element name="MODEL" minOccurs="0"> <xsd:complexType> <xsd:simpleContent> BEA WebLogic Adapter for Manugistics User Guide...
  • Page 63 </xsd:simpleContent> </xsd:complexType> </xsd:element> <xsd:element name="CURRDATE" minOccurs="0"> <xsd:complexType> <xsd:simpleContent> <xsd:extension base="xsd:string"> <xsd:attribute name="type" type="xsd:string" use="required"/> <xsd:attribute name="null" type="xsd:string" use="optional"/> </xsd:extension> </xsd:simpleContent> </xsd:complexType> </xsd:element> </xsd:sequence> </xsd:complexType> </xsd:element> </xsd:sequence> <xsd:attribute name="table" type="xsd:string" use="optional"/> </xsd:complexType> </xsd:element> </xsd:schema> BEA WebLogic Adapter for Manugistics User Guide...
  • Page 64 Creating Schema Repositories 4-10 BEA WebLogic Adapter for Manugistics User Guide...

  • Page 65: Using Tracing

    This section describes tracing for services and events. It contains the following topics: Levels and Categories of Tracing Tracing and Performance Creating Traces for Services and Events BEA WebLogic Adapter for Manugistics User Guide...

  • Page 66: Levels And Categories Of Tracing

    Using Tracing Levels and Categories of Tracing Tracing is provided by both the BEA adapter framework and by the BEA WebLogic Adapter for Manugistics. The BEA WebLogic Integration framework provides five distinct levels of tracing: Table 5-1 Levels of Tracing...

  • Page 67: Tracing And Performance

    The default setting is off. Note: To obtain the appropriate trace, both the level and the category must be declared. In a debug situation, BEA Customer Support will request (minimally) a Basic and a Verbose trace. Tracing and Performance The additional trace capabilities provided by the adapter are not strictly hierarchic;...

  • Page 68: Creating Traces For A Service

    The Deploy Application View window opens. 7. Navigate to the Log Configuration area and select the desired trace level. This pane enables you to select the trace level for the BEA WebLogic Integration framework. BEA WebLogic Adapter for Manugistics User Guide...
  • Page 69 Creating Traces for Services and Events Figure 5-2 Deploy Application View window For maximum tracing, select Log all Messages. This is recommended to obtain optimum debugging information for BEA support personnel. Note: This causes all generated messages to be written to the log. You must...

  • Page 70: Creating Or Modifying The Tracing Level For An Event

    Using Tracing Creating or Modifying the Tracing Level for an Event To create or modify the WebLogic framework tracing level for an event: 1. Logon to the BEA WebLogic Server Console. 2. In the left pane, select Web Applications. 3. Select BEA_MGISTICS_1_0_EventRouter.war.
  • Page 71 Creating Traces for Services and Events Figure 5-4 WebLogic Server Console: Configuration This pane enables you to select the trace level for the BEA WebLogic Integration framework. For maximum tracing, enter DEBUG. This is recommended to obtain optimum debugging information for BEA support personnel.
  • Page 72 This change need only be made once. It is set for all events associated with a given adapter. 12. Return to the WebLogic Server Console. 13. Select Applications from the WebLogic Server Console. 14. Select the adapter whose EventRouter you have modified in the previous steps. 15. Select the Deploy tab in the right pane.

  • Page 73: Creating Adapter Logs For An Event

    5. Click Add to continue to the next configuration pane. 6. Click Continue to move to the next configuration pane. The Deploy Application View window opens. 7. Navigate to the Log Configuration area and select the desired trace level. BEA WebLogic Adapter for Manugistics User Guide...
  • Page 74 Using Tracing This pane enables you to select the trace level for the BEA WebLogic Integration framework. Figure 5-7 Deploy Application View window For maximum tracing, select Log all Messages. This is recommended to obtain optimum debugging information for BEA support personnel.

Table of Contents