A Step-by-Step guide on SMTP Configuration and File to Mail Scenario Using Process Integration Scenario in PI 7.1

Transcription

1 A Step-by-Step guide on SMTP Configuration and File to Mail Scenario Using Process Integration Scenario in PI 7.1 Applies to: SAP NetWeaver Process Integration 7.1 For more information, visit the SOA Management homepage. Summary This document gives complete step-by-step procedures for implementing and testing a File-to-Mail scenario from scratch using the Business Systems in the Integration Directory (ID). The document also provides some basic idea and working knowledge on how to configure SMTP. Some insight on TCodes- Profile Parameters (Transaction RZ10), User Maintenance (Transaction SU01), maintain services and assigning a client (Transaction SICF), SAPconnect Administration (Transaction SCOT) So, this document can be treated as a ready reference in real life situations when working with Mail scenario. Author: Sandeep Sharma Company: HCL Technology Noida Created on: 21 October 2009 Author Bio Sandeep Sharma is working as a SAP NetWeaver Consultant for HCL Technology Noida INDIA. He is SAP PI 7.0 certified developer. He is having a good experience in ALE/IDOC also SAP AG 1

2 Table of Contents Introduction... 3 Basic Concepts and Overview... 3 Requirement Study and Scope Identification... 3 Prerequisites... 4 Knowledge Requirements... 4 System Requirements... 4 Implementation Build Solution SMTP Configuration guide Purpose Prerequisites Process Flow Settings for the Profile Parameters (Transaction RZ10) User Maintenance (Transaction SU01) Assigning the Clients (Transaction SICF) SAPconnect Administration (Transaction SCOT) File to Mail Scenario Enterprise Service Repository (Designing) Design Objects: Integration Directory (Configuration) Directory Objects: Testing the Scenario (SXMB_IFR) Testing the Scenario (SXMB_MONI) Related Content Disclaimer and Liability Notice SAP AG 2

3 Introduction This guide gives you a clear IDEA and complete step by step procedures to be followed while implementing File to Mail scenario. There are many blogs and articles on SDN for XI and PI 7.0 for mail scenario. This guide is especially for PI 7.1 users and also for those who want to learn how to configure SMTP. It becomes very difficult for any beginner and Intermediate XI aspirants to implement such a scenario in PI 7.1 from scratch. Hence, I have tried to come up with a complete solution and How to guide document to provide all steps required implementing such a scenario from the very beginning. Hope this document will help all PI professionals as a ready reference in real life situation while working with File and Mail PI scenario in cross company environment. Happy Learning Basic Concepts and Overview As per general thumb rule to implement any XI scenario (like File - XI - File) we need to implement following: In SLD: Create Product and Software Components with/without dependencies, Technical System and Business System for each (Sender and Receiver) Tip: If we don t have sufficient information to create a Business System in SLD for Sender or Receiver then we can use Business Service in ID (Cross Company Environment). In ESR: Import Software Components that we have created in SLD, Create Namespaces then under Interface Object we have to create Data type, Message Type, Service Interface and actions for each (Sender and Receiver). After this we have to create Massage Mapping and Operation Mapping for the scenario under Mapping Objects. Finally we have to create one process integration scenario and activate all these objects we have created in ESR. In ID: Create Communication Channels for (Sender and Receiver), then apply model from ESR and import your process integration scenario which you have designed in ESR. Again we have to activate all these objects in ID. the Requirement Study and Scope Identification Create two third party Business System in SLD for Sender and Receiver Systems.If you don t have sufficient authorization to create it then you can ask your Basis team to create these for you or you can use Business Service in ID like in any Cross Company Environment 2009 SAP AG 3

4 Prerequisites Knowledge Requirements Basic knowledge of XI and how it works. Nice to have one file to file scenario implementation experience. Please see the reference section if you want to go through one file to file scenario example System Requirements Two Business Systems in SLD (System Landscape directory) are required which should be created using Third Party Option Access to Transactions RZ10, SU01, SICF, SCOT, SXMB_MONI, SXMB_IFR are required for PI System. Tip: If you don t have access right to any of this transaction, you can contact your basis /XI administrator so that he can help you to create / configure objects for you including SLD. Developer Access to PI System is required to create this scenario Implementation Build Solution 1 SMTP Configuration guide 1.1 Purpose To enable mail communication between SAP systems and SMTP mail server, without having to use additional external components, kernel of the SAP Web Application Server should be SMTP (Simple Mail Transfer Protocol) compatible. Using this SMTP functionality, it is possible to exchange faxes and messages which are packed as s. For this mail server should analyze the domain of the recipient addresses. Mail server either forwards the e- mails to an internal fax-/text message server or to an external provider To receive any fax or text message, server or provider sends s to addresses that have the domain of the SAP system. 1.2 Prerequisites To enable mail communication, mail server must be SMTP-compatible. 1.3 Process Flow Settings for the Profile Parameters (Transaction RZ10) If you want to use SMTP functionality, you have to adjust the profile of the SAP web application server because SAPConnect send job can only be scheduled for SMTP activated servers. Run tcode rz10 and create a profile SAP AG 4

5 Configure the following two profile parameters: A) icm/server_port_<*> = PROT=SMTP,PORT=<port> (this parameter opens a TCP/IP port for receiving mails through SMTP) here <*> stands for the sequence number (starting from zero)of frequently occurring parameters. <port> the number of the port that is to be used ( can t yet be used by another program on this host.) In my case here value of * (sequence number) is 2 and PORT = SAP AG 5

6 B) is/smtp/virt_host_<*> = <host>:<port>,<port>,...; This parameter defines a virtual mail host for receiving mails. Here <host> describes the name of the host to which the incoming mails are addressed. <port> describes the number of the port to which the incoming mails are addressed. Note: 1- This parameter is not required If one single client of the SAP system is receiving and processing all incoming mails). 2-Default value for this parameter is/smtp/virt_host_0 = *:*; 3-In case of multiple clients, a virtual host has to be created for each of these clients. In my example I have used *:25000 here * is used because I want the mails to be sent independently of the host being addressed and is the value of PORT SAP AG 6

7 User Maintenance (Transaction SU01) Create a service user to process incoming mails Call transaction SU01 to create a user with type Service and assign the profile S_A.SCON to this user SAP AG 7

8 Click on create 2009 SAP AG 8

9 User addresses Assign the valid Internet mail address to your user (which is supposed to receive s) in transaction SU01, under on the tab page Address Assigning the Clients (Transaction SICF) One SMTP server (SAPconnect) has already been created in transaction SICF and is delivered with every SAP system. Now Use this to create the first client and then create another SMTP server for each additional client. Run tcode SICF and enter the following details: Press F8. In the next screen double click on SAP connect 2009 SAP AG 9

10 Host data tab Enter the sequence number of a parameter is/smtp/virt_host_<*> from the profile. If you have only created one client and therefore have not specified this parameter type, enter 0.As shown in the figure: Enter *:* in host configuration information. Handler list Enter CL_SMTP_EXT_SAPCONNECT at position SAP AG 10

11 SAPconnect Administration (Transaction SCOT) In this step, Define SAPconnect settings for the client that is to be used for send processes. Run tcode SCOT Under Settings Default Domain, define the domain of the SAP system client. Each client has an SMTP node. This node is created by the SAP system and cannot be deleted. The following steps need to be carried out to configure the node so that sending Internet mail is possible: 1. First confirm that you are in the Node view, and then double click on that node name. 2. Choose Node in use. 3. In the Mail Host and Mail Port fields, specify the mail server to which the outbound mails are to be sent.in my case, Mail Host = smtp.rediffmailpro.com (or you can use IP address also ) and Mail Port = Next to Internet, click on set button and Enter the address area of the recipient addresses that are to be reached using this node. In general, * is used if all s are to be sent using SMTP. 5. Enter the output format for SAP documents and Confirm your selection 2009 SAP AG 11

12 Note: If you also want to configure the node for sending text messages (pager/sms) or faxes, please follow the reference link given at the end of this document SAP AG 12

13 Send Job (shift +F7) s sent from an SAP application are first stored in a queue. A periodical background process, the SAPconnect send job, gets the s from this queue and sends them over the Internet. To schedule this job in SAPconnect: Administration, proceed as follows: Press shift+f7 or click on the job button as shown in the figure below: 1. Choose View Jobs. 2. If no other job has been scheduled, choose Job Create. 3. Enter a job name ( for ex: MailSend)and confirm it. 4. Select the variant SAP&CONNECTALL by positioning the cursor on it. 5. Choose Schedule Job. In the next window, Choose Schedule periodically. Select the interval you require, such as 10 minutes. Choose Create SAP AG 13

14 2-File to Mail Scenario 2.1 Enterprise Service Repository (Designing) The first scenario that I am explaining is sending the file to the receiver through mail. File adapter will pick up the file from FTP, do the simple 1 to 1 transformation and send the file to the receiver through mail. The mail adapter is using the transport protocol as SMTP Design Objects: Data Types: Create the two Data Types, one for the source and other for the target side. Source Data Type: The source data type contains the following fields FROM, TO and CONTENT as shown below. Fig1. Source Data Type Target Data Type: Fig2.Target Data Type Message Types: Create the Message Type for both the data types as shown below SAP AG 14

15 Source Message Type: Fig3. Source Message Type Target Message Type: Fig4. Target Message Type Message Interfaces: Create the Message Interfaces for the above message types as shown below SAP AG 15

16 Outbound Message Interface: Fig5. Outbound Service Interface 2009 SAP AG 16

17 Inbound Message Interface: Fig6. Inbound Service Interface 2009 SAP AG 17

18 Message Mapping: Create the Message Mapping between the source message type and the target message type as shown below. Fig7. Message Mapping Operation Mapping: Create the Interface Mapping between the outbound and inbound interface as shown below. Fig8. Operation Mapping 2009 SAP AG 18

19 Actions: Create two actions for source service interface and the target service interface as shown below. Fig9. Source action Fig10. Target action 2009 SAP AG 19

20 Process Integration Scenario: Create a process integration scenario as shown below 1. Right click and insert your sender component. In my example it is SAMPLE_TEST_SCENARIO Again right click and insert your receiver component. In my example again it is SAMPLE_TEST_SCENARIO Right click on first component and click on insert action. Here assign your sender action. In this example it is FileSender. Or you may drag and drop this action. 4. Now right click on second component and click on insert action. Here assign your receiver action. In this example it is Mailreceiver. Or you may drag and drop this action. 5. Now click on sender action (FileSender) press shift button on keyboard and then click on receiver action (Mail receiver) both will be highlighted. release shift button and then right click and select option create connection between selected actions Fig11. Action connection 2009 SAP AG 20

21 Double click on the mid of arrow, a new window will open, 2009 SAP AG 21

22 Click on assign mapping and assign the mapping using drop down menu. Save and activate all your objects. Your ESR part is completed 2009 SAP AG 22

23 2.2. Integration Directory (Configuration) Directory Objects: Create the Business Scenario and create the sender business service (MAIL_SND) and receiver business service (MAIL_RCV).Assign sender and receiver Interface to both service. Assign these services to your business scenario. Sender Communication Channel: Create the sender communication channel of Adapter type as File. Select the Transport Protocol as FTP SAP AG 23

24 Fi12. Sender Communication Channel 2009 SAP AG 24

25 Receiver Communication Channel: Create the Receiver communication channel of Adapter type as MAIL. Fig13. Receiver Communication Channel 2009 SAP AG 25

26 Now go to tools tab and apply model from ESR Fig14. Apply ESR model In the wizard, Fill the details of process integration scenario which you have created in ESR Fig15. Wizard step SAP AG 26

27 Click on continue Fig16. Wizard step2 Click on finish Fig17. Wizard finish Click on close 2009 SAP AG 27

28 A new window will open Fig18. Model Configurator 2009 SAP AG 28

29 Click on sender action (FileSender) and assign communication component Fig19. Assign component in Model Configurator 2009 SAP AG 29

30 Again click on receiver action (MailReceiver) and assign communication component Fig20. Assign component in Model Configurator 2009 SAP AG 30

31 Now click on the arrow connecting two actions and assign the communication channels. Fig21. Assign channel in Model Configurator 2009 SAP AG 31

32 Click on simulation button (4 th button in the above screen shot) and select Generation Simulation radio button Fig22. Simulation Click on start After simulation new window will popup close that and again click on the simulation button SAP AG 32

33 This time select radio button Generation Fig23. Simulation generation 2009 SAP AG 33

34 Click on start. Again new window for log will popup close that. Click on apply button.following objects will be created. Fig24. Configuration objects scenario Save your configuration scenario and activate your change list. This completes your ID part SAP AG 34

35 2.3. Testing the Scenario (SXMB_IFR) 1- Open RWB->component Monitoring->Display->Integration Engine->Test Message Fill up the details as below and also take your payload from ESR message mapping with some test values. Paste that payload here in test message. Fig25. Test RWB Click on send message. Now you can check the message in SXMB_MONI. 2- Alternatively you can test the scenario by putting the file MAIL.TXT on your FTP. After some time file will be deleted from FTP 2009 SAP AG 35

36 2.4. Testing the Scenario (SXMB_MONI) To Test the scenario put the file MAIL.TXT on your FTP. After some time file will be deleted from FTP Message in SXMB_MONI is shown below. Fig26. Message in SXMB_MONI 2009 SAP AG 36

37 You will receive a mail in your box like the screenshot below: Fig27. Message in Inbox 2009 SAP AG 37

38 Related Content SMTP configure SAP AG 38

39 Disclaimer and Liability Notice This document may discuss sample coding or other information that does not include SAP official interfaces and therefore is not supported by SAP. Changes made based on this information are not supported and can be overwritten during an upgrade. SAP will not be held liable for any damages caused by using or misusing the information, code or methods suggested in this document, and anyone using these methods does so at his/her own risk. SAP offers no guarantees and assumes no responsibility or liability of any type with respect to the content of this technical article or code sample, including any liability resulting from incompatibility between the content within this document and the materials and services offered by SAP. You agree that you will not hold, or seek to hold, SAP responsible or liable with respect to the content of this document SAP AG 39