TIBCO ActiveMatrix Adapter for SAP Examples

Transcription

1 TIBCO ActiveMatrix Adapter for SAP Examples Software Release 7.1 November 2014 Two-Second Advantage

2 Important Information SOME TIBCO SOFTWARE EMBEDS OR BUNDLES OTHER TIBCO SOFTWARE. USE OF SUCH EMBEDDED OR BUNDLED TIBCO SOFTWARE IS SOLELY TO ENABLE THE FUNCTIONALITY (OR PROVIDE LIMITED ADD-ON FUNCTIONALITY) OF THE LICENSED TIBCO SOFTWARE. THE EMBEDDED OR BUNDLED SOFTWARE IS NOT LICENSED TO BE USED OR ACCESSED BY ANY OTHER TIBCO SOFTWARE OR FOR ANY OTHER PURPOSE. USE OF TIBCO SOFTWARE AND THIS DOCUMENT IS SUBJECT TO THE TERMS AND CONDITIONS OF A LICENSE AGREEMENT FOUND IN EITHER A SEPARATELY EXECUTED SOFTWARE LICENSE AGREEMENT, OR, IF THERE IS NO SUCH SEPARATE AGREEMENT, THE CLICKWRAP END USER LICENSE AGREEMENT WHICH IS DISPLAYED DURING DOWNLOAD OR INSTALLATION OF THE SOFTWARE (AND WHICH IS DUPLICATED IN THE LICENSE FILE) OR IF THERE IS NO SUCH SOFTWARE LICENSE AGREEMENT OR CLICKWRAP END USER LICENSE AGREEMENT, THE LICENSE(S) LOCATED IN THE LICENSE FILE(S) OF THE SOFTWARE. USE OF THIS DOCUMENT IS SUBJECT TO THOSE TERMS AND CONDITIONS, AND YOUR USE HEREOF SHALL CONSTITUTE ACCEPTANCE OF AND AN AGREEMENT TO BE BOUND BY THE SAME. This document contains confidential information that is subject to U.S. and international copyright laws and treaties. No part of this document may be reproduced in any form without the written authorization of TIBCO Software Inc. TIBCO, Two-Second Advantage, TIBCO ActiveMatrix Adapter for SAP, TIBCO ActiveMatrix Binding Type for Adapter, TIBCO ActiveMatrix BusinessWorks, TIBCO ActiveMatrix Implementation Type for TIBCO Adapters, TIBCO ActiveMatrix Service Bus, TIBCO ActiveMatrix Service Grid, TIBCO Adapter SDK, TIBCO Administrator, TIBCO Business Studio, TIBCO Designer, TIBCO Enterprise Message Service, TIBCO Hawk, TIBCO Rendezvous, and TIBCO Runtime Agent are either registered trademarks or trademarks of TIBCO Software Inc. in the United States and/or other countries. Enterprise Java Beans (EJB), Java Platform Enterprise Edition (Java EE), Java 2 Platform Enterprise Edition (J2EE), and all Java-based trademarks and logos are trademarks or registered trademarks of Oracle Corporation in the U.S. and other countries. All other product and company names and marks mentioned in this document are the property of their respective owners and are mentioned for identification purposes only. THIS SOFTWARE MAY BE AVAILABLE ON MULTIPLE OPERATING SYSTEMS. HOWEVER, NOT ALL OPERATING SYSTEM PLATFORMS FOR A SPECIFIC SOFTWARE VERSION ARE RELEASED AT THE SAME TIME. SEE THE README FILE FOR THE AVAILABILITY OF THIS SOFTWARE VERSION ON A SPECIFIC OPERATING SYSTEM PLATFORM. THIS DOCUMENT IS PROVIDED AS IS WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT. THIS DOCUMENT COULD INCLUDE TECHNICAL INACCURACIES OR TYPOGRAPHICAL ERRORS. CHANGES ARE PERIODICALLY ADDED TO THE INFORMATION HEREIN; THESE CHANGES WILL BE INCORPORATED IN NEW EDITIONS OF THIS DOCUMENT. TIBCO SOFTWARE INC. MAY MAKE IMPROVEMENTS AND/OR CHANGES IN THE PRODUCT(S) AND/OR THE PROGRAM(S) DESCRIBED IN THIS DOCUMENT AT ANY TIME. THE CONTENTS OF THIS DOCUMENT MAY BE MODIFIED AND/OR QUALIFIED, DIRECTLY OR INDIRECTLY, BY OTHER DOCUMENTATION WHICH ACCOMPANIES THIS SOFTWARE, INCLUDING BUT NOT LIMITED TO ANY RELEASE NOTES AND "READ ME" FILES. Copyright TIBCO Software Inc. ALL RIGHTS RESERVED. TIBCO Software Inc. Confidential Information

3 iii Contents Preface v Related Documentation vi TIBCO ActiveMatrix Adapter for SAP Documentation vi Other TIBCO Product Documentation vi Third-Party Documentation viii Typographical Conventions ix Connecting with TIBCO Resources xii How to Join TIBCOmmunity xii How to Access TIBCO Documentation xii How to Contact TIBCO Support xii Chapter 1 Introduction Examples Overview BusinessWorks 5 Examples BusinessWorks 6 Example Prerequisites of Running Examples Required Software Importing the Examples Starting the EMS Server Chapter 2 Dynamic Logon and External Commit Example Overview Configuring the Example Running the Example Expected Results Chapter 3 Inbound IDoc with Inbound BAPI Example Overview Configuring the Example Running the Example Expected Results Chapter 4 Outbound IDoc with Remote TIDManager Example Overview

4 iv Configuring the Example Running the Example Expected Results Chapter 5 Outbound RFC with Inbound BAPI Example Overview Configuring the Example Running the Example Expected Results Chapter 6 Outbound IDoc in IDocFormat Example Overview Configuring the Example Running the Example Expected Results Chapter 7 Salesforce Opportunity to SAP Order Example Overview Configuring the Example Running the Example Expected Results Index

5 v Preface TIBCO ActiveMatrix Adapter for SAP is a bi-directional gateway between SAP applications and applications configured for the TIBCO environment. The adapter can remotely connect and operate with SAP systems running on OS platforms not supported by the adapter. This manual explains how to run packaged examples in TIBCO Designer. Topics Related Documentation, page vi Typographical Conventions, page ix Connecting with TIBCO Resources, page xii

6 vi Related Documentation Related Documentation This section lists documentation resources you may find useful. TIBCO ActiveMatrix Adapter for SAP Documentation The following documents form the TIBCO ActiveMatrix Adapter for SAP documentation set: TIBCO ActiveMatrix Adapter for SAP Concepts Read this manual for terminology and concepts of the product. Before reading other manuals in this documentation set, you need to be familiar with the information in this manual. TIBCO ActiveMatrix Adapter for SAP Installation Read this manual for instructions on site preparation and installation. TIBCO ActiveMatrix Adapter for SAP Configuration and Deployment Read this manual for instructions on how to create, configure, and deploy adapter projects. Read this manual to work through the examples provided with the adapter. TIBCO ActiveMatrix Adapter for SAP Release Notes Read this release notes for a list of new and changed features. This document also contains lists of known issues and closed issues for this release. TIBCO ActiveMatrix Adapter Framework Documentation Read this documentation for instructions on how to install, configure and deploy the adapter in TIBCO ActiveMatrix BusinessWorks 6. Other TIBCO Product Documentation Table 1 TIBCO Products (Sheet 1 of 3) You may find it useful to read the documentation for the following TIBCO products: TIBCO Product TIBCO ActiveMatrix Binding Type for Adapters Description This product is a TIBCO ActiveMatrix binding that integrates TIBCO Adapters with the TIBCO ActiveMatrix environment.

7 Preface vii Table 1 TIBCO Products (Sheet 2 of 3) TIBCO Product TIBCO ActiveMatrix BusinessWorks TIBCO ActiveMatrix Adapter Framework TIBCO ActiveMatrix Implementation Type for TIBCO Adapters TIBCO ActiveMatrix Service Bus TIBCO ActiveMatrix Service Grid TIBCO Adapter SDK TIBCO Administrator TIBCO Business Studio TIBCO Designer TIBCO Enterprise Message Service TIBCO Hawk Description This product provides an integration platform that enables companies to rapidly integrate systems and automate business processes. This product provides a visual, model-driven development environment for configuring supported TIBCO adapters in TIBCO Business Studio. This product provides capabilities to upload and deploy adapter configurations (packaged as EAR files) using TIBCO ActiveMatrix Administrator GUI. This product is a lightweight enterprise service bus (ESB) that mediates the communication between applications and services by routing and transforming disparate data formats and transport protocols. This product is a scalable and extensible platform for developing, deploying, and managing applications that conform to a service-oriented architecture. This product provides a class library that helps developers implement an adapter with minimal effort. This product provides capabilities for managing users, monitoring machines, and deploying and managing applications that use TIBCO products. This product provides capabilities that help business analysts document business processes, solution engineers implement business processes, and SOA developers create composite applications. This product provides a graphical user interface to create TIBCO ActiveMatrix BusinessWorks process definitions, or create or modify TIBCO Adapter configurations. This product sends messages from your applications in a format that conforms to the Java Messaging Service (JMS) specification. This product is for monitoring and managing distributed applications and systems throughout the enterprise.

8 viii Related Documentation Table 1 TIBCO Products (Sheet 3 of 3) TIBCO Product TIBCO Rendezvous TIBCO Runtime Agent Description This product uses messages to enable distributed application programs to communicate across a wide variety of hardware platforms and programming languages. This product is a bundle of TIBCO software and third-party software that is required to run many TIBCO applications such as TIBCO ActiveMatrix BusinessWorks, TIBCO Adapters, and so on. Third-Party Documentation You may also find it useful to read the documentation on the following websites: This website is the SAP Help Portal where you can find documentation on all SAP products, including SAP ECC 6.0 releases and SAP NetWeaver. In order for TIBCO ActiveMatrix Adapter for SAP to exchange data with SAP systems, you must make configurations in the SAP system to allow for communication and the exchange of messages to take place. This website offers detailed information on such configuration. This website is provided by the SAP Support Portal and contains documentation on installations and upgrades. The documentation available contains information on components that can be used along with TIBCO ActiveMatrix Adapter for SAP, and the installation of the Secure Network Communications (SNC) libraries where security is required between the adapter and SAP systems. This website provides information on the different types of SAP Connectors available. TIBCO ActiveMatrix Adapter for SAP is based on the SAP Java Connector libraries. You can download the latest versions of these libraries from this website.

9 Preface ix Typographical Conventions The following typographical conventions are used in this manual. Table 2 General Typographical Conventions Convention ENV_NAME TIBCO_HOME TIB_ADR3_HOME code font bold code font Use TIBCO products are installed into an installation environment. A product installed into an installation environment does not access components in other installation environments. Incompatible products and multiple instances of the same product must be installed into different installation environments. An installation environment consists of the following properties: Name Identifies the installation environment. This name is referenced in documentation as ENV_NAME. The default value is TIBCO_HOME. Directory The folder into which the product is installed. This folder is referenced in documentation as TIBCO_HOME. TIBCO ActiveMatrix Adapter for SAP is installed into a directory within a TIBCO_HOME directory. This directory is referenced in documentation as TIB_ADR3_HOME. The default value of TIB_ADR3_HOME depends on the operating system. For example, on Windows systems, the default value is C:\tibco\adapter\adr3\ReleaseNumber. Code font identifies commands, code examples, filenames, pathnames, and output displayed in a command window. For example: Use MyCommand to start the foo process. Bold code font is used in the following ways: In procedures, to indicate what a user types. For example: Type admin. In large code samples, to indicate the parts of the sample that are of particular interest. In command syntax, to indicate the default parameter for a command. For example, if no parameter is specified, MyCommand is enabled: MyCommand [enable disable].

10 x Typographical Conventions Table 2 General Typographical Conventions (Cont d) Convention italic font Key combinations Use Italic font is used in the following ways: To indicate a document title. For example: See TIBCO ActiveMatrix Adapter for SAP Concepts. To introduce new terms. For example: A portal page may contain several portlets. Portlets are mini-applications that run in a portal. To indicate a variable in a command or code syntax that you must replace. For example: MyCommand PathName. Key name separated by a plus sign indicate keys pressed simultaneously. For example: Ctrl+C. Key names separated by a comma and space indicate keys pressed one after the other. For example: Esc, Ctrl+Q. The note icon indicates information that is of special interest or importance, for example, an additional action required only in certain circumstances. The tip icon indicates an idea that could be useful, for example, a way to apply the information provided in the current section to achieve a specific result. The warning icon indicates the potential for a damaging situation, for example, data loss or corruption if certain steps are taken or not taken.

11 Preface xi Table 3 Syntax Typographical Conventions Convention Use [ ] An optional item in a command or code syntax. For example: MyCommand [optional_parameter] required_parameter A logical OR that separates multiple items of which only one may be chosen. For example, you can select only one of the following parameters: MyCommand param1 param2 param3 { } A logical group of items in a command. Other syntax notations may appear within each logical group. For example, the following command requires two parameters, which can be either the pair param1 and param2, or the pair param3 and param4. MyCommand {param1 param2} {param3 param4} In the next example, the command requires two parameters. The first parameter can be either param1 or param2 and the second can be either param3 or param4: MyCommand {param1 param2} {param3 param4} In the next example, the command can accept either two or three parameters. The first parameter must be param1. You can optionally include param2 as the second parameter. And the last parameter is either param3 or param4. MyCommand param1 [param2] {param3 param4}

12 xii Connecting with TIBCO Resources Connecting with TIBCO Resources How to Join TIBCOmmunity TIBCOmmunity is an online destination for TIBCO customers, partners, and resident experts. It is a place to share and access the collective experience of the TIBCO community. TIBCOmmunity offers forums, blogs, and access to a variety of resources. To register, go to How to Access TIBCO Documentation You can access TIBCO documentation here: How to Contact TIBCO Support For comments or problems with this manual or the software it addresses, contact TIBCO Support as follows: For an overview of TIBCO Support, and information about getting started with TIBCO Support, visit this site: If you already have a valid maintenance or support contract, visit this site: Entry to this site requires a user name and password. If you do not have a user name, you can request one.

13 1 Chapter 1 Introduction This chapter describes the example projects packaged with TIBCO ActiveMatrix Adapter for SAP and preparation you need to do before running the sample projects. Topics Examples Overview, page 2 Prerequisites of Running Examples, page 4

14 2 Introduction Examples Overview TIBCO ActiveMatrix Adapter for SAP provides seven examples to show how the adapter interacts with the SAP system. After installing TIBCO ActiveMatrix Adapter for SAP, navigate to the TIBCO_ADR3_HOME\examples directory. You can find two example folders. The BusinessWorks 5 examples are in the BusinessWorks5 folder. And the BusinessWorks 6 examples are in the BusinessWorks6 folder. BusinessWorks 5 Examples You can find the following examples in the BusinessWorks5 folder: Dynamic Logon and External Commit This example shows how to use the dynamic logon and the Inbound BAPI transaction support features provided by the adapter in TIBCO Designer. Inbound IDoc with Inbound BAPI This example shows how to use the Subscription Service and the Request-Response Service in TIBCO Designer. Outbound IDoc with Remote TIDManager This example shows how to use the remote TIDmanager and how to use the Publication Service in multiple adapter instances in TIBCO Designer. Outbound RFC with Inbound BAPI This example shows how to use the Request-Response Invocation Service and the Request-Response Service in TIBCO Designer. Outbound IDoc in IDocFormat This example shows how to publish IDocs in the IDocFormat publish mode and pass control fields of IDoc as JMS properties in TIBCO Designer. Salesforce Salesforce Opportunity to SAP Order This example shows how to set up communication between the SAP system and Salesforce.com by using the adapter in TIBCO Designer. Before running these examples, you need to import the example projects into TIBCO Designer. See Importing Examples to TIBCO Designer on page 5.

15 Examples Overview 3 BusinessWorks 6 Example You can find the following example in the BusinessWorks6 folder: Saleforce Salesforce Opportunity to SAP Order This example shows how to set up communication between the SAP system and Salesforce.com by using the adapter in TIBCO Business Studio. Before running this example, you need to import the example project into TIBCO Business Studio. See Importing the Example to TIBCO Business Studio on page 5.

16 4 Introduction Prerequisites of Running Examples Before running the examples, you need to install the required software, import the examples and start the EMS server. For the required software, see Required Software on page 4. For how to import examples and start the EMS server, see Importing the Examples on page 4 and Starting the EMS Server on page 6. Required Software You need to install the following software to run the BusinessWorks 5 examples: TIBCO ActiveMatrix Adapter for SAP TIBCO ActiveMatrix BusinessWorks 5.x TIBCO Runtime Agent TIBCO ActiveMatrix BusinessWorks Plug-in for Salesforce.com You need to install the following software to run the BusinessWorks 6 example: TIBCO ActiveMatrix Adapter for SAP TIBCO ActiveMatrix BusinessWorks 6.x TIBCO ActiveMatrix Adapter Framework TIBCO Runtime Agent TIBCO ActiveMatrix BusinessWorks Plug-in for Salesforce.com For the BusinessWorks 5 example, the version of TIBCO ActiveMatrix BusinessWorks Plug-in for Salesforce.com must be or later. For the BusinessWorks 6 example, the version of TIBCO ActiveMatrix BusinessWorks Plug-in for Salesforce.com must be or later. Importing the Examples Based on the platform in which you run the examples, choose one of the following ways to import the examples: Importing Examples to TIBCO Designer, page 5 Importing the Example to TIBCO Business Studio, page 5

17 Prerequisites of Running Examples 5 Importing Examples to TIBCO Designer This procedure is specific to the BusinessWorks 5 examples in the BusinessWorks5 folder. To import an example to TIBCO Designer: 1. Open TIBCO Designer. 2. In the startup window, click New empty project. 3. In the Save Project window, click next to the Project Directory field to select a directory for the new project and specify a name for it. 4. Select UTF-8 from the TIBCO Messaging Encoding list. 5. (Optional) Select one option from the Multi-User System list and specify the applicable values according to your system setting. Click OK. 6. Click Project > Import Full Project. 7. In the Import Project window, click the ZIP Archive tab and click to locate the example to be imported. Click OK. The examples are located in the TIBCO_ADR3_HOME\examples\BusinessWorks5 directory. 8. In the Import - Options window, click Replace existing global variables with those in import and Overwrite on name conflict. Click Apply. 9. Click Save to save the project. The selected example is displayed in TIBCO Designer. Importing the Example to TIBCO Business Studio This procedure is specific to the BusinessWorks 6 example in the BusinessWorks6 folder. To import an example to TIBCO Business Studio: 1. Open TIBCO Business Studio. 2. Click File > Import. 3. In the Import window, expand the General folder and select the Existing Studio Projects into Workspace item. Click Next. 4. In the Import Projects window, click Select archive file. Then click Browse next to the Select archive file field to locate the example to be imported. The example is located in the TIBCO_ADR3_HOME\examples\BusinessWorks6\Salesforce directory. 5. Click Finish.

18 6 Introduction The selected example is displayed in TIBCO Business Studio. Starting the EMS Server All of the examples use the JMS transport type. Ensure that the TIBCO Enterprise Message Service server is running and accessible to the machine on which the adapter is installed before starting the adapters. To start the EMS server, click Start > All Programs > TIBCO > TIBCO EMS [version_number] > Start EMS Server.

19 7 Chapter 2 Dynamic Logon and External Commit This chapter describes how to configure and run the DynamicLogonExternalCommit example in TIBCO Designer. Topics Example Overview, page 8 Configuring the Example, page 9 Running the Example, page 11 Expected Results, page 12

20 8 Dynamic Logon and External Commit Example Overview The DynamicLogonExternalCommit example shows how to use the dynamic logon and the Inbound BAPI transaction support features provided by the adapter. This example contains two processes, Create SalesOrder and Create SaleOrder with Auto Commit. Both of the processes are configured with Request-Response Services. When running the processes, the adapter creates a dynamic connection to create sales orders in the SAP system. The adapter packages the Create_SalesOrder_Send_Template.xml file in the TIBCO_ADR3_HOME\examples\BusinessWorks5\DynamicLogonExternalCommit directory. The Create_SalesOrder_Send_Template.xml file contains the input data of these two processes. The adapter invokes the BAPI_SALESORDER_CREATEFROMDAT function module to create a sales order in the SAP system based on the input data in the Create_SalesOrder_Send_Template.xml file. If an error occurs when the adapter invokes the BAPI_SALESORDER_CREATEFROMDAT function module, the error is written to the OrderStatus.xml file. However, these two processes use different function models and mechanisms to commit and roll back a sales order in the SAP system: In the Create SalesOrder process, if the adapter fails to create a sales order, the adapter invokes the BAPI_TRANSACTION_ROLLBACK function module to roll back the sales order. Otherwise, the adapter invokes the BAPI_TRANSACTION_COMMIT function module to commit the created sales order. In the Create SaleOrder with Auto Commit process, if the adapter fails to create a sales order, the sales order is automatically rolled back without the invocation of any function module. Otherwise, the BAPI_TRANSACTION_COMMIT function module is automatically invoked to commit the created sales order.

21 Configuring the Example 9 Configuring the Example After importing the example to TIBCO Designer, as described in Importing Examples to TIBCO Designer on page 5, you need to ensure that the adapter can access to the SAP system before running the process. To set up a connection between the adapter and the SAP system: 1. In TIBCO Designer, open the DynamicLogonExternalCommit example project. 2. In the Global Variables panel, click. The Global Variables editor is displayed.

22 10 Dynamic Logon and External Commit 3. Enter values for the following global variables: UDConnection\AppServer UDConnection Client UDConnection\ConnectionType UDConnection\GroupName UDConnection\Language UDConnection\MsgServer UDConnection\Password UDConnection\SNC_lib UDConnection\SNC_mode UDConnection\SNC_partnername UDConnection\SNC_qop UDConnection\SNC_bSSO UDConnection\SNC_ssoSend UDConnection\SNC_x509 UDConnection\SystemName UDConnection\SystemNumber UDConnection\UserName JMSProviderUrl ASAP_HOME ASAP_HOME is the home directory where you install the adapter. For example, E:\TIBCO_HOME\adapter\adr3\ Click OK. 5. In the Project panel, click the adapter instance, and then, in the Configuration panel, click the Design-Time Connection tab. 6. Click Test Connection to validate your connection.

23 Running the Example 11 Running the Example Ensure that you have configured the example, as described in Configuring the Example on page 9. To run the example, complete the following tasks: Task A, Start the Adapter, page 11 Task B, Run the Process, page 11 Task A Start the Adapter The adapter must be running before you run the example. To start the adapter: 1. In TIBCO Designer, click Tools > Show Adapter Tester. 2. In the Adapter Tester window, click the adapter instance in the left panel. 3. In the Run Settings tab in the right panel, specify the directory where you run the processes and the executable file. 4. Click Start to start the adapter. Task B Run the Process After starting the adapter, complete the following steps to run the process: 1. In the Project panel, click the process that you want to run. 2. In the Tester panel, click to load the process. 3. In the Select Process to Load window, click Load Selected. 4. Navigate to the TIBCO_ADR3_HOME\examples\BusinessWorks5\ DynamicLogonExternalCommit directory and update the Create_SalesOrder_Send_Template.xml file. The process is automatically triggered.

24 12 Dynamic Logon and External Commit Expected Results You can view the example results in the TIBCO_ADR3_HOME\examples\BusinessWorks5\ DynamicLogonWithExternalCommit directory. When the process is finished, all the results of creating a sales order are written to the output file named OrderStatus.xml. If the creation is successful, you can also check the sales order information in the SAP system. You can also check the symbolic destination of the active connection in the SAP server or check the adapter log file to get the dynamic connection result. The log file is located in the TIBCO_ADR3_HOME\logs directory.

25 13 Chapter 3 Inbound IDoc with Inbound BAPI This chapter describes how to configure and run the InboundIDocWithInboundBAPI example in TIBCO Designer. Topics Example Overview, page 14 Configuring the Example, page 15 Running the Example, page 16 Expected Results, page 17

26 14 Inbound IDoc with Inbound BAPI Example Overview The InboundIDocWithInboundBAPI example shows how to use the Subscription Service and the Request-Response Service. This example contains the Vendor process. Once you update the VendorInputFile.xml file, the Vendor process is triggered. The Request-Response Service invokes the BAPI_GL_ACC_EXISTENCECHECK functional module to validate the G/L account in the VendorInputFile.xml file. You can find the VendorInputFile.xml file in the TIBCO_ADR3_HOME\examples\BusinessWorks5\InboundIDocWithInboundBAPI directory. If the G/L account in the VendorInputFile.xml file is valid, the Vendor process publishes a message to the adapter to create a vender based on the information in the VendorInputFile.xml file. Once the adapter receives the message as a CREMAS04 IDoc, the CREMAS04 IDoc is used to create a vendor in the SAP system. If the G/L account is invalid, an error message is written to the output file.

27 Configuring the Example 15 Configuring the Example After importing the example to TIBCO Designer, as described in Importing Examples to TIBCO Designer on page 5, you need to ensure that the adapter can access the SAP system before running the process. To set up a connection between the adapter and the SAP system: 1. In TIBCO Designer, open the InboundIDocWithInboundBAPI example project. 2. In the Global Variables panel, click. The Global Variables editor is displayed. 3. Enter values for the following global variables: AppServer Client GatewayService Password SystemNumber UserName JMSProviderUrl ASAP_HOME ASAP_HOME is the home directory where you install the adapter. For example, E:\TIBCO_HOME\adapter\adr3\ Click OK. 5. (Optional) Change the Inbound TID management mode: a. In the Project panel, click the R3AdapterConfiguration adapter instance. b. In the Configuration panel, click the Adapter Services tab. c. Change the TID management mode. Ensure that the TIDmanager clients in all the adapter instances match the TID manager server in the TIDManager, when you select the Remote TID management mode. 6. In the Project panel, click the adapter instance, and then, in the Configuration panel, click the Design-Time Connection tab. 7. Click Test Connection to validate your connection.

28 16 Inbound IDoc with Inbound BAPI Running the Example Ensure that you have configured the example, as described in Configuring the Example on page 15. To run the example, complete the following tasks: Task A, Start the Adapter, page 16 Task B, Run the Process, page 16 Task A Start the Adapter The adapter must be running before you run the example. To start the adapter: 1. In TIBCO Designer, click Tools > Show Adapter Tester. 2. In the Adapter Tester window, click the adapter instance in the left panel. 3. In the Run Settings tab in the right panel, specify the directory where the processes run and the executable file. 4. Click Start to start the adapter. If you have configured the adapter instance with the remote Inbound TIDManagement, before start the adapter, first start the TIDManager. Task B Run the Process After starting the adapter, complete the following steps to run the process: 1. In the Project panel, click the Vendor process. 2. In the Tester panel, click to load the process. 3. In the Select Process to Load window, click Load Selected. 4. Navigate to the TIBCO_ADR3_HOME\examples\BusinessWorks5\ InboundIDocWithInboundBAPI directory and update the VendorInputFile.xml file. The process is automatically triggered.

29 Expected Results 17 Expected Results You can view the example results in the TIBCO_ADR3_HOME\examples\BusinessWorks5\InboundIDocWithInboundBAPI directory. If the G/L account is valid, a vendor is created in the SAP system. You can check the vendor information in the SAP system. If the G/L account is invalid, the error is written to the error.xml file.

30 18 Inbound IDoc with Inbound BAPI

31 19 Chapter 4 Outbound IDoc with Remote TIDManager This chapter describes how to configure and run the OutboundIDocWithRemoteTIDManager example in TIBCO Designer. Topics Example Overview, page 20 Configuring the Example, page 21 Running the Example, page 22 Expected Results, page 24

32 20 Outbound IDoc with Remote TIDManager Example Overview The OutboundIDocWithRemoteTIDManagerexample shows how to use the remote TID manager and how to use the Publication Service in multiple adapter instances. This example contains the following three processes: CREMAS Process Receives a message from the Publication Service and saves the message containing SAP Vendor Master Data to an output file. DEBMAS Process Receives a message from the Publication Service and saves the message containing SAP Customer Master Data to an input file. MATMAS Process Receives a message from the Publication Service and saves the message containing SAP Material Master Data to an input file.

33 Configuring the Example 21 Configuring the Example After importing the example to TIBCO Designer, as described in Importing Examples to TIBCO Designer on page 5, you need to ensure that the adapter can access the SAP system before running the process. To set up a connection between the adapter and the SAP system: 1. In TIBCO Designer, open the OutboundIDocWithRemoteTIDManager example project. 2. In the Global Variables panel, click. The Global Variable editor is displayed. 3. Enter values for the following global variables: AppServer Client GatewayService Password SystemNumber UserName JMSProviderUrl ASAP_HOME ASAP_HOME is the home directory where you install the adapter. For example, E:\TIBCO_HOME\adapter\adr3\ Click OK. 5. In the Project panel, click the adapter instance, and then, in the Configuration panel, click the Design-Time Connection tab. 6. Click Test Connection to validate your connection.

34 22 Outbound IDoc with Remote TIDManager Running the Example Ensure that you have configured the example, as described in Configuring the Example on page 21. To run the example, complete the following tasks: Task A, Start the Adapter and TIDManager, page 22 Task B, Run the Process, page 22 Task A Start the Adapter and TIDManager The TIDManager and the adapter must be running before you run the example. To start the TIDManager and the adapter: 1. In TIBCO Designer, click Tools > Show Adapter Tester. 2. In the Adapter Tester window, click the TIDManager instance in the left panel. 3. In the Run Settings tab in the right panel, specify the directory where the processes run and the executable file. 4. Click Start to start the TIDManager. 5. In the left panel, click the adapter instance. 6. In the Run Settings tab in the right panel, specify the directory where the processes run and the executable file. 7. Click Start to start the adapter. Task B Run the Process After starting the adapter and TID manager, complete the following steps to run the process: 1. In the Project panel, click the process which you want to test. 2. In the Tester panel, click to load the process. 3. In the Select Process to Load window, click Load Selected.

35 Running the Example Log on to the SAP system and send an IDoc to start the process: To start the MATMAS process: Send a MATMAS01 IDoc using ALE/IDoc messaging and execute the SAP transaction BD10. To start the DEBMAS process: Send a DEBMAS01 IDoc using ALE/IDoc messaging and execute the SAP transaction BD12. To start the CREMAS process: Send a CREMAS01 IDoc using ALE/IDoc messaging and execute the SAP transaction BD14. The process is triggered automatically.

36 24 Outbound IDoc with Remote TIDManager Expected Results You can find the example results in the TIBCO_ADR3_HOME\examples\BusinessWorks5\ OutboundIDocWithRemoteTIDManager directory: The CREMAS_IDocNumber.xml file that contains the Vendor Master Data is created, when the CREMAS process completed. The DEBMAS_IDocNumber.xml file that contains the Customer Master Data is created, when the DEBMAS process completed. The MATMAS_IDocNumber.xml file that contains the Material Master Data is created, when the MATMAS process is completed.

37 25 Chapter 5 Outbound RFC with Inbound BAPI This chapter describes how to configure and run the OutboundRFCWithInboundBAPI example in TIBCO Designer. Topics Example Overview, page 26 Configuring the Example, page 27 Running the Example, page 28 Expected Results, page 30

38 26 Outbound RFC with Inbound BAPI Example Overview The OutboundRFCWithInboundBAPI example shows how to use the Request-Response Invocation Service and the Request-Response Service. This example contains two processes. The only difference between the two processes is that the Using JMS process uses the JMS transport but the Using RV process uses the Rendezvous transport. The Using JMS and the Using RV processes receive an event from the SAP system by invoking the BAPI_XBP_EVENT_RAISE function module. The Request-Response Invocation Service forwards this event to the Request-Response Service. When the value of the EVENTID parameter in the incoming event is CUSTOMER, the adapter invokes the BAPI_CUSTOMER_GETDETAIL2 function module to check if the customer number provided for the EVENTPARAM parameter is valid. If the customer number is valid, the process writes the customer information to an output file. Otherwise, the Request-Response Invocation Service receives an error message. When the value of the EVENTID parameter in the incoming event is VENDOR, the adapter invokes the BAPI_VENDOR_GETDETAIL function module to check if the customer number provided for the EVENTPARAM parameter is valid. If the customer number is valid, the process writes the customer information to an output file. Otherwise, the Request-Response Invocation Service receives an error message. When the value of the EVENTID parameter in the incoming event is neither CUSTOMER nor VENDOR, the Request-Response Invocation Service receives an error message.

39 Configuring the Example 27 Configuring the Example After importing the example to TIBCO Designer, as described in Importing Examples to TIBCO Designer on page 5, you need to ensure that the adapter can access to the SAP system before running the process. To set up a connection between the adapter and the SAP system: 1. In TIBCO Designer, open the OutboundRFCWithInboundBAPI example project. 2. In the Global Variables panel, click. The Global Variables editor is displayed. 3. Enter values for the following global variables: AppServer GatewayHost ProgramID Client GatewayService Password SystemNumber UserName JMSProviderUrl ASAP_HOME ASAP_HOME is the home directory where you install the adapter. For example, E:\TIBCO_HOME\adapter\adr3\ Click OK. 5. In the Project panel, click the adapter instance, and then, in the Configuration panel, click the Design-Time Connection tab. 6. Click Test Connection to validate your connection.

40 28 Outbound RFC with Inbound BAPI Running the Example Ensure that you have configured the example, as described in Configuring the Example on page 27. To run the example, complete the following tasks: Task A, Start the Adapter, page 28 Task B, Run the Process, page 28 Task A Start the Adapter The adapter must be running before you run the example. To start the adapter: 1. In TIBCO Designer, click Tools > Show Adapter Tester. 2. In the Adapter Tester window, click the adapter instance in the left panel. 3. In the Run Settings tab in the right panel, specify the directory where the processes are run and the executable file. 4. Click Start to start the adapter. Task B Run the Process After starting the adapter, complete the following steps to run the process: 1. In the Project panel, click the process which you want to test. 2. In the Tester panel, click to load the process. 3. In the Select Process to Load window, click Load Selected. 4. Log on to the SAP system and execute the SAP transaction SE Execute the BAPI_XBP_EVENT_RAISE the function module. 6. Enter the RFC Destination based on the configuration in the TIBCO Designer project.

41 Running the Example Configure the customer and vendor information according to events to be tested: a. To validate a customer master record, set the EVENTID parameter to CUSTOMER and enter a customer number for the EVENTPARAM parameter. b. To validate a vendor master record, set the EVENTID parameter to VENDOR and enter a vendor number for the EVENTPARAM parameter. c. To test an invalid event, enter a value for the EVENTID parameter that is neither CUSTOMER nor VENDOR. The process is automatically triggered.

42 30 Outbound RFC with Inbound BAPI Expected Results You can view the example results in the TIBCO_ADR3_HOME\examples\BusinessWorks5\OutboundRFCWithInboundBAPI directory: The Vendor.xml is created when the value of the EVENTID parameter is VENDOR. The Customer.xml is created when the value of the EVENTID parameter is CUSTOMER. The SAP system receives an error message when the value of the EVENTID parameter is neither VENDOR nor CUSTOMER.

43 31 Chapter 6 Outbound IDoc in IDocFormat This chapter describes how to configure and run the OutboundIDocInIDocFormat example in TIBCO Designer. Topics Example Overview, page 32 Configuring the Example, page 33 Running the Example, page 34 Expected Results, page 35

44 32 Outbound IDoc in IDocFormat Example Overview The OutboundIDocInIDocFormat example shows how to send IDocs in the IDocFormat publish mode and pass control fields of IDoc as JMS properties. This example contains two processes, CREMA04_PROC and MATMAS05_PROC. The configurations of these two processes are the same except for the IDoc type. The processes are triggered when the Publication Service publishes an IDoc. The adapter passes the control fields of IDocs as JMS properties. You can check the control fields in the JMS Application Properties activity. When the Subscription Service receives this IDoc which the Publication Service publishes, the WAIT_FOR_MSG_PROC process is triggered to wait for the IDoc confirmation message report originated by this Subscription Service.

45 Configuring the Example 33 Configuring the Example After importing the example to TIBCO Designer, as described in Importing Examples to TIBCO Designer on page 5, ensure that the adapter can access to the SAP system before running the process. To set up a connection between the adapter and the SAP system: 1. In TIBCO Designer, open the OutboundIDocInIDocFormat example project. 2. In the Global Variables panel, click. The Global Variables editor is displayed. 3. Enter values for the following global variables: AppServer Client GatewayHost GatewayService Password ProgramID SystemNumber UserName ASAP_HOME ASAP_HOME is the home directory where you install the adapter. For example, E:\TIBCO_HOME\adapter\adr3\ Click OK. 5. In the Project panel, click the adapter instance, and then, in the Configuration panel, click the Design-Time Connection tab. 6. Click Test Connection to validate your connection.

46 34 Outbound IDoc in IDocFormat Running the Example Ensure that you have configured the example, as described in Configuring the Example on page 33. To run the example, complete the following tasks: Task A, Start the Adapter, page 34 Task B, Run the Process, page 34 Task A Start the Adapter The adapter must be running before you run the example. To start the adapter: 1. In TIBCO Designer, click Tools > Show Adapter Tester. 2. In the Adapter Tester window, click the adapter instance in the left panel. 3. In the Run Settings tab in the right panel, specify the directory where you run the processes and the executable file. 4. Click Start to start the adapter. Task B Run the Process After starting the adapter, complete the following steps to run the process: 1. In the Project panel, click the process that you want to run. 2. In the Tester panel, click to load the process. 3. In the Select Process to Load window, click Load Selected. 4. Log on to the SAP system and publish a MATMAS05 IDoc or a CREMAS04 IDoc. The process is automatically triggered.

47 Expected Results 35 Expected Results You can view the example results in the TIBCO_ADR3_HOME\examples\BusinessWorks5\OutboundIDocInIDocFormat directory. If no error occurs and the IDoc type is MATMAS05 or CREMAS04, the IDoc number and other related information are written to the matmas05_success.txt file or the cremas04_success.txt file. If an error occurs during the delivery, the error information is written to the idoc_exception.txt file.

48 36 Outbound IDoc in IDocFormat

49 37 Chapter 7 Salesforce Opportunity to SAP Order This chapter describes how to configure and run the SalesforceOpportunityToSAPOrder example in TIBCO Designer and TIBCO Business Studio. Topics Example Overview, page 38 Configuring the Example, page 39 Running the Example, page 41 Expected Results, page 44

50 38 Salesforce Opportunity to SAP Order Example Overview The SalesforceOpportunityToSAPOrder example shows how to set up communication between the SAP system and Salesforce.com by using the adapter. The example contains two processes, SyncOpportunityProcess and OrderDeliveryProcess. In thebusinessworks 6 example,the OrderDeliveryProcess process is named as UpdateOpportunityFromSAPDelivery. SyncOpportunityProcess process The workflow action is triggered to send outbound messages to the process when you create a record of the Opportunity object with the stage of Closed Won or edit a record of the Opportunity object by setting the stage to Closed Won in the Salesforce.com. The adapter invokes the BAPI_SALESORDER_CREATEFROMDAT function module to create a sales order in the SAP system based on the outbound messages. When an error occurs in the invocation, this error is written to the OrderStatus.xml file. In the BusinessWorks 6 example, there is no output for the invocation error. If the adapter fails to create the sales order, the adapter invokes the BAPI_TRANSACTION_ROLLBACK function module to roll back the sales order. Otherwise, the adapter invokes BAPI_TRANSACTION_COMMIT function module to commit the created sales order. Then update the opportunity object in the Salesforce.com with the sales order number. OrderDeliveryProcess process This process is triggered when the adapter publishes a DESADV IDoc containing the Opportunity ID. This process updates the Opportunity object in Salesforce.com with the SAP delivery number as the tracking number.

51 Configuring the Example 39 Configuring the Example After importing the example to TIBCO Designer or TIBCO Business Studio, as described in Importing the Examples on page 4, you need to ensure that the adapter can access the SAP system before running the process. Based on the platform in which you run the example, choose one of the following ways to set up a connection between the adapter and the SAP system before you run the process: Set Up a Connection in TIBCO Designer, page 39 Set Up a Connection in TIBCO Business Studio, page 40 Set Up a Connection in TIBCO Designer 1. In TIBCO Designer, open the SalesforceOpportunityToSAPOrder example project. 2. In the Global Variables panel, click. The Global Variables editor is displayed. 3. Enter values for the following global variables: AppServer Client GatewayHost Password ProgramID SystemNumber UserName GatewayService Salesforce.connection\salesforce.password Salesforce.connection\salesforce.username Salesforce.connection\serverURL ASAP_HOME ASAP_HOME is the home directory where you install the adapter. For example, E:\TIBCO_HOME\adapter\adr3\ Click OK.

52 40 Salesforce Opportunity to SAP Order 5. In the Project panel, click the adapter instance, and then, in the Configuration panel, click the Design-Time Connection tab. 6. Click Test Connection to validate your connection. Set Up a Connection in TIBCO Business Studio 1. In TIBCO Business Studio, open the SalesforceOpportunityToSAPOrder example project. 2. In the Project Explorer view, expand the Module Description resource and double-click the Module Properties item.the Module Properties editor is displayed. 3. Enter values for the following properties: SAPAppServer SAPClient SAPGatewayHost SAPPassword SAPProgramID SAPSystemNumber SAPUserName SAPOrderFile SAPGatewayService salesforce_password salesforce_username 4. Click Save.

53 Running the Example 41 Running the Example Ensure that you have configured the example, as described in Configuring the Example on page 39. To run the example, complete the following tasks: Task A, Start the Adapter, page 41 Task B, Run the Process, page 42 Task A Start the Adapter The adapter must be running before you run this example. Based on the platform in which you run the example, choose one of the following ways to start the adapter: Start the Adapter in TIBCO Designer, page 41 Start the Adapter in TIBCO Business Studio, page 41 Start the Adapter in TIBCO Designer 1. In TIBCO Designer, click Tools > Show Adapter Tester. 2. In the Adapter Tester window, click the adapter instance in the left panel. 3. In the Run Settings tab in the right panel, specify the directory where you run the processes and the executable file. 4. Click Start to start the adapter. Start the Adapter in TIBCO Business Studio 1. In TIBCO Business Studio, click Run > Run Configuration. 2. In the Run Configuration window, double-click the Adapter Launcher item to create a configuration to start the adapter. The Adapter Configuration tab is displayed in the right panel. 3. Click Browse next to the Adapter Configuration field to select the adapter you want to start. 4. In the Adapter Configuration selection dialog, expand the salesforce_opportunity_to_sap_orderproject directory and click the R3AdapterConfiguration.model adapter. Click OK. 5. Click Apply,and then click Run to start the adapter.