Inbund Email Cnfiguratin fr Offline Apprvals Applies t: SAP NW2004s (700) SRM 5.00 Fr mre infrmatin, visit the Supplier Relatinship Management hmepage. Summary A functinal requirement f the shpping cart apprval wrkflw in SRM was t enable External (Offline) Apprval f New Candidate Jb Requests. When new shpping carts are created, an email is generated frm the SRM system and is sent t identified jb apprver(s). The actin t apprve r deny the request is dne directly within the email and triggers a reply message that is ruted back t SRM fr prcessing. Inbund SMTP cnfiguratin is required t handle delivery f reply messages t the SRM system n a specific prt in rder t autmate the denial r apprval transactin. Prper inbund SMTP ruting requires establishing an external MX (Mail exchanger) recrd, setting up DNS fr ruting t the email gateway, and cnfiguratin f the email gateway t act as a mail relay sending directly t the internal SRM hst using the required prt. This dcument highlights the technical steps required in rder t cnfigure apprvals by an external email system. Mst f these steps are nrmally perfrmed via SAP Basis resurce. Certain steps, like setting up the users, require invlvement frm the security team. Authrs: Cmpany: Yasb Mhammed (Yasb.Mhammed@dayzim.cm), Phil Lng (Phil.Lng@dayzim.cm) Day & Zimmermann (Philadelphia) Created n: 28 Octber 2008 Authr Bis Yasb Mhammed is a Lead SAP Basis Admin in SAP Technlgy Grup f Day & Zimmermann. Yasb has implemented many technical functinalities bth n Java / ABAP Technlgy ranging frm setting up SSO t creating Web Dynprs Phil Lng is Manager f Business Technlgy Services at Day & Zimmermann. Phil has served as the Lead Technical Architect fr a majrity f the Day & Zimmermann SAP systems including ERP 2005, several Enterprise Prtal landscapes, e-recruiting with integrated TREX, CRM, SRM with Adbe Dcument Services, BI, Duet and SharePint integratin slutins. SDN - sdn.sap.cm BPX - bpx.sap.cm BOC - bc.sap.cm 2008 SAP AG 1
Inbund Email Cnfiguratin fr Offline Apprvals Table f Cntents Prerequisites...3 Step 1. Cnfiguratin f Prfile Pramaters...3 Step 2. Setup a User in the System...4 Step 3. Assign the Client t SICF Service SAPCnnect...5 Step 4. Cnfiguratin in Transactin SCOT...6 Step 5. Define Exit Rules fr Inbund Prcessing (Transactin SO50)....8 Step 6. Defining Ruting Rules n E-mail Server...8 Related Cntent...9 Disclaimer and Liability Ntice...10 SDN - sdn.sap.cm BPX - bpx.sap.cm BOC - bc.sap.cm 2008 SAP AG 2
Inbund Email Cnfiguratin fr Offline Apprvals Prerequisites ABAP Based SAP Web Applicatin Server 620 and higher. SAP Web Applicatin Server can directly cmmunicate with SMTP server requiring n Gateway. SMTP Server with its IP r lad balanced hstname. Step 1. Cnfiguratin f Prfile Pramaters Adjust the prfile Parameters icm/server_prt_<*> = PROT=SMTP,PORT=<prt> This pens a TCP/IP prt fr receiving mails by the SMTP Plug-In. <prt> specifies the number f the prt that yu shuld use. This must nt be ccupied by any ther prgram n this hst (fr example, Sendmail usually uses prt 25). If n mails (including status ntificatins) are t be received in this SAP system, <prt> can be set t 0. Yu can use the TIMEOUT ptin t define a maximum wait time fr a respnse frm the mail server (in secnds). is/smtp/virt_hst_<*> = <hst>:<prt>,<prt>,...; This defines a "virtual mail hst" fr receiving mails. If all incming mails (including status ntificatins) are t be received and prcessed in a single client f this SAP system, this parameter is nt required (an entry is/smtp/virt_hst_0 = *:* is then assumed by default). If yu want several clients t be able t receive, yu must create a virtual mail hst fr every client. <hst> specifies the name f the hst t which incming mails are addressed. The "*" value can als be specified here if the mail distributin is t ccur independently f the addressed hst. Imprtant: If the mail is t be distributed accrding t hst names, yu must assign different IP addresses t these hst names. <prt> specifies the number f a prt t which incming mails are addressed. Several prts may be specified fr each hst, and several hsts (with several prts if necessary) may be specified fr each virtual mail hst. Imprtant: The parameter line must always be cmpleted with a semicln (even if nly ne hst is invlved). The assignment f virtual mail hsts t clients is carried ut in the SAP system Example. With tw clients capable f receiving mail, the prfile parameters culd read as fllws. icm/server_prt_0 = PROT=HTTP,PORT=1080 icm/server_prt_1 = PROT=HTTPS,PORT=1443 icm/server_prt_2 = PROT=SMTP,PORT=25000,TIMEOUT=180 icm/server_prt_3 = PROT=SMTP,PORT=25001,TIMEOUT=180 is/smtp/virt_hst_0 = *:25000; is/smtp/virt_hst_1 = *:25001; In RZ10 Instance Prfile. If yu have mre than ne App. Server then supply the parameter in each f the App. Server. SDN - sdn.sap.cm BPX - bpx.sap.cm BOC - bc.sap.cm 2008 SAP AG 3
Inbund Email Cnfiguratin fr Offline Apprvals Step 2. Setup a User in the System User administratin transactin SU01 System user In each client f an SAP system in which incming mails (r status ntificatins fr sent mails) are t be received, a system user must be created t prcess the incming messages. T d this, use transactin SU01 t create a user f the type "system", and assign the "S_A.SCON" prfile t this user. User addresses Each individual user wh wants t receive e-mails in an SAP system needs an Internet mail address. This is als used as a sender address fr sending e-mails. In transactin SU01, enter the Internet mail address f a user in the field "E-Mail" under "Address". As a dmain, use the dmain f the SAP system client. As an example "firstname.lastname@crmprd.cmpany.cm". SDN - sdn.sap.cm BPX - bpx.sap.cm BOC - bc.sap.cm 2008 SAP AG 4
Inbund Email Cnfiguratin fr Offline Apprvals Step 3. Assign the Client t SICF Service SAPCnnect Fr each client f an SAP system in which incming mails (r status ntificatins fr sent mails) are t be received, and prcessed if necessary, yu must create an SMTP server in which the assignment t a virtual mail hst as well as the lgn data is defined. In transactin SICF, an SMTP server (envelpe icn) shuld already be available in every SAP system. This is delivered by SAP. Use this fr the first client that yu want t be able t receive mails, and create a new SMTP server fr every ther client. Yu must make the fllwing settings n the SMTP servers: Hst data Fr "Prfile Parameter Number", enter the sequence number f a parameter is/smtp/virt_hst_<*> frm the prfile. If yu have nly ne client and did nt create such a parameter in the prfile, enter 0. Service data Enter the client int which the mails received using this virtual mail hst are t be directed, as well as the lgn data (user, passwrd, language) f the service user that was created fr inbund mails. Make sure that Handler list CL_SMTP_EXT_SAPCONNECT exists. SDN - sdn.sap.cm BPX - bpx.sap.cm BOC - bc.sap.cm 2008 SAP AG 5
Inbund Email Cnfiguratin fr Offline Apprvals Step 4. Cnfiguratin in Transactin SCOT Make the SAPcnnect settings separately in each client frm which e-mails are t be sent r received. Default dmain The dmain f this SAP system client is defined here, fr example, crm-prd.cmpany.cm. It is used fr the fllwing purpses: The SMTP Plug-In lgs n t the mail server with the dmain as ID. The message ID f utging mails is created with this dmain. If an SAP user wh has nt entered an Internet mail address in their user master recrd sends an e-mail, a sender address is generated frm the SAP user name and this dmain, fr example SMITHJ@crm-prd.cmpany.cm. Create SMTP Nde There is always a single SMTP nde in each client. It is created autmatically by the system and cannt be deleted. It is cnfigured as fllws (duble-click n the nde name): Select "Nde in use". Under "Mail Hst" and "Mail Prt", specify the mail server t which utbund mails are t be transferred. Select "Set" fr "Internet". Specify address areas f recipient addresses that are t be reached using these ndes (usually "*" if all e-mails are t be sent using SMTP). SDN - sdn.sap.cm BPX - bpx.sap.cm BOC - bc.sap.cm 2008 SAP AG 6
Inbund Email Cnfiguratin fr Offline Apprvals Fr "Output Frmats fr SAP Dcuments", the fllwing is recmmended: SAPscript / Smart Frms PDF ABAP List HTM Business Object / Link HTM RAW Text TXT Schedule Send-Jbs. Within SAPcnnect administratin (SCOT) Prceed as fllws: Chse "View" --> "Jbs". Check whether a jb is already scheduled (displayed as a calendar icn). Chse "Jb" --> "Create", and specify a jb name. Place the cursr n the "SAP&CONNECTALL" variant, and chse "Schedule Jb". Chse "Schedule peridically". Specify a time interval (fr example, 10 minutes), and chse "Create". Receiving With the settings made s far, SAP users can already receive e-mails in their inbx in the Business Wrkplace (transactin SBWP) at the address entered in the user master recrd. If, n receipt f e-mails t a specific address r with specific cntents (fr example XML dcuments), yu want a prgram that prcesses these e-mails t start autmatically, yu can cnfigure this under "Settings" --> "Inbund Prcessing". SDN - sdn.sap.cm BPX - bpx.sap.cm BOC - bc.sap.cm 2008 SAP AG 7
Inbund Email Cnfiguratin fr Offline Apprvals If, n receipt f e-mails t a specific address r frm a specific sender, yu want these t be directed autmatically t anther recipient r a distributin list, yu can cnfigure this under "Settings" --> "Inbund Distributin". Step 5. Define Exit Rules fr Inbund Prcessing (Transactin SO50). Inbund prcessing shuld be defined s that incming messages can be ruted apprpriately. Nte: - In rder t implement successfully and fully ffline apprvals, there are ther functinal Netwrk related steps and cnfiguratin that are necessary, as example, Setup f fllwing jbs which retrieves messages. CREATE BID INVITATIONS RBBP_NOTIFICATION_OFFAPP RBBP_OFFLINE_EVAL Step 6. Defining Ruting Rules n E-mail Server. Settings n the mail server (SAP-external cnfiguratin) T be able t receive mails in the SAP system, yu need t set yur mail server s that certain mail addresses are frwarded t ne r several SAP systems r clients. Fr this purpse, yu need t define ruting rules that assign a mail hst and/r prt t address areas (generic address parts, usually the dmain), fr example: *@crm-prd.cmpany.cm --> SAPWASHst:25000 *@crm-test.cmpany.cm --> SAPWASHst:25001 Yu can define ruting rules, example in Prf-pint which diverts the messages n a particular prt t email address that yu wuld chse t create. SDN - sdn.sap.cm BPX - bpx.sap.cm BOC - bc.sap.cm 2008 SAP AG 8
Inbund Email Cnfiguratin fr Offline Apprvals Related Cntent http://help.sap.cm/search/highlightcntent.jsp http://help.sap.cm/saphelp_nw70/helpdata/en/55/a8b538891b11d2a25a00a0c943858e/frameset.htm http://help.sap.cm/saphelp_nw70/helpdata/en/55/a8b538891b11d2a25a00a0c943858e/frameset.htm Fr mre infrmatin, visit the Supplier Relatinship Management hmepage. SDN - sdn.sap.cm BPX - bpx.sap.cm BOC - bc.sap.cm 2008 SAP AG 9
Inbund Email Cnfiguratin fr Offline Apprvals Disclaimer and Liability Ntice This dcument may discuss sample cding r ther infrmatin that des nt include SAP fficial interfaces and therefre is nt supprted by SAP. Changes made based n this infrmatin are nt supprted and can be verwritten during an upgrade. SAP will nt be held liable fr any damages caused by using r misusing the infrmatin, cde r methds suggested in this dcument, and anyne using these methds des s at his/her wn risk. SAP ffers n guarantees and assumes n respnsibility r liability f any type with respect t the cntent f this technical article r cde sample, including any liability resulting frm incmpatibility between the cntent within this dcument and the materials and services ffered by SAP. Yu agree that yu will nt hld, r seek t hld, SAP respnsible r liable with respect t the cntent f this dcument. SDN - sdn.sap.cm BPX - bpx.sap.cm BOC - bc.sap.cm 2008 SAP AG 10