A Step-By-Step Guide on SMTP Configuration and File to Mail Scenario Using Process Integration...

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com

2009 SAP AG 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.

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


2009 SAP AG 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 ......................................................................................................................... 4

1 SMTP Configuration guide............................................................................................................................... 4

1.1 Purpose ..................................................................................................................................................... 4

1.2 Prerequisites ............................................................................................................................................. 4

1.3 Process Flow ............................................................................................................................................. 4 1.3.1 Settings for the Profile Parameters (Transaction RZ10)...................................................................................... 4

1.3.2. User Maintenance (Transaction SU01) .............................................................................................................. 7

1.3.3. Assigning the Clients (Transaction SICF) .......................................................................................................... 9

1.3.4. SAPconnect Administration (Transaction SCOT) ............................................................................................. 11

2-File to Mail Scenario ...................................................................................................................................... 14

2.1 Enterprise Service Repository (Designing) ............................................................................................. 14 Design Objects: .......................................................................................................................................................... 14

2.2. Integration Directory (Configuration) ...................................................................................................... 23 Directory Objects: ...................................................................................................................................................... 23

2.3. Testing the Scenario (SXMB_IFR) ......................................................................................................... 35

2.4. Testing the Scenario (SXMB_MONI) ..................................................................................................... 36

Related Content ................................................................................................................................................ 38

Disclaimer and Liability Notice .......................................................................................................................... 39



2009 SAP AG 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 the following:

In SLD: Create Product and Software Components with/without dependencies, Technical System and Business System for each (Sender and Receiver)

Tip: If we dont 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.

Requirement Study and Scope Identification

Create two third party Business System in SLD for Sender and Receiver Systems .If you dont 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 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 dont 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 e-mails. 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 e-mails 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

1.3.1 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.



2009 SAP AG 5

Configure the following two profile parameters:

A) icm/server_port_ = PROT=SMTP,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.

the number of the port that is to be used ( cant yet be used by another program on this host.)

In my case here value of * (sequence number) is 2 and PORT = 25000



2009 SAP AG 6

B) is/SMTP/virt_host_ = :,,...;

This parameter defines a virtual mail host for receiving mails.

Here describes the name of the host to which the incoming mails are addressed.

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 25000 is the value of PORT.



2009 SAP AG 7

1.3.2. 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.



2009 SAP AG 8

Click on create



2009 SAP AG 9

User addresses

Assign the valid Internet mail address to your user (which is supposed to receive e-mails) in transaction SU01, under E-Mail on the tab page Address.

1.3.3. 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 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 1.



2009 SAP AG 11

1.3.4. 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 = 25.

4. 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 e-mails are to be sent using SMTP.

5. Enter the output format for SAP documents and Confirm your selection



2009 SAP AG 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.



2009 SAP AG 13

Send Job (shift +F7)

E-mails sent from an SAP application are first stored in a queue. A periodical background process, the SAPconnect send job, gets the e-mails 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.



2009 SAP AG 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.



2009 SAP AG 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.



2009 SAP AG 16

Outbound Message Interface:

Fig5. Outbound Service Interface



2009 SAP AG 17

Inbound Message Interface:

Fig6. Inbound Service Interface



2009 SAP AG 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 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 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 1.0

2. Again right click and insert your receiver component. In my example again it is SAMPLE_TEST_SCENARIO 1.0

3. 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 21

Double click on the mid of arrow, a new window will open,



2009 SAP AG 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 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.



2009 SAP AG 24

Fi12. Sender Communication Channel



2009 SAP AG 25

Receiver Communication Channel:

Create the Receiver communication channel of Adapter type as MAIL.

Fig13. Receiver Communication Channel



2009 SAP AG 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 step1



2009 SAP AG 27

Click on continue

Fig16. Wizard step2

Click on finish

Fig17. Wizard finish

Click on close



2009 SAP AG 28

A new window will open

Fig18. Model Configurator



2009 SAP AG 29

Click on sender action (FileSender) and assign communication component

Fig19. Assign component in Model Configurator



2009 SAP AG 30

Again click on receiver action (MailReceiver) and assign communication component

Fig20. Assign component in Model Configurator



2009 SAP AG 31

Now click on the arrow connecting two actions and assign the communication channels.

Fig21. Assign channel in Model Configurator



2009 SAP AG 32

Click on simulation button (4th 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.



2009 SAP AG 33

This time select radio button Generation

Fig23. Simulation generation



2009 SAP AG 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.



2009 SAP AG 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 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 37

You will receive a mail in your box like the screenshot below:

Fig27. Message in Inbox



2009 SAP AG 38

Related Content

SMTP configure

http://help.sap.com/saphelp_nw04/helpdata/en/af/73563c1e734f0fe10000000a114084/frameset.htm

http://help.sap.com/saphelp_nw04/helpdata/EN/e3/94007075cae04f930cc4c034e411e1/content.htm

http://help.sap.com/saphelp_nw04/Helpdata/EN/6b/4493404f673028e10000000a1550b0/content.htm



2009 SAP AG 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.

A Step-By-Step Guide on SMTP Configuration and File to Mail Scenario Using Process Integration...

Documents

Transcript of A Step-By-Step Guide on SMTP Configuration and File to Mail Scenario Using Process Integration...