SSP Config Cookbook

Configuration CookbookSAP S/4HANA Self-Service Procurement Document Version: 1.0 – 2013-01-17 S/4HANA Self-Service Procurement Configuration Cookbook CUSTOMER menu names. S/4HANA Self-Service Procurement Typographic Conventions . F 2 or E N T E R . and key concepts of a programming language when they are surrounded by body text. This includes file and directory names and their paths. table names.Typographic Conventions Type Style Description Example Words or characters quoted from the screen. upgrade and database tools. EXAMPLE Keys on the keyboard. Textual cross-references to other documents. and menu options. SELECT and INCLUDE. Angle brackets indicate that you replace these words and characters with appropriate entries to make entries in the system. and names of installation. 2 Example Emphasized words or expressions. source text. These include report names. CUSTOMER © 2015 SAP SE or an SAP affiliate company. program names. All rights reserved. pushbuttons labels. These are words or characters that you enter in the system exactly as they appear in the documentation. screen titles. menu paths. EXAMPLE Technical names of system objects. These include field names. for example. names of variables and parameters. transaction codes. messages. for example. Example Exact user entry. Example Output on the screen. <Example> Variable user entry. 0 2015-10-7 Primary version S/4HANA Self-Service Procurement Document History CUSTOMER © 2015 SAP SE or an SAP affiliate company. All rights reserved.Document History Version Date Change 1. 3 . ............................................. 16 Enrich Catalog Data during import to S/4 HANA ..................5 4..1.......................................1................... 5 2 2................................... S/4HANA Self-Service Procurement Config cookbook ...........................12 3...... 7 2................................................................... 17 Transfer Additional Parameters while Launching Catalog ..........4.....2 4..........................................................................................13 3.........................................................................................................................................4 3 3............................... 9 2. 17 Modify Approver Data .1................................................................ 7 2.........................................................................................................................1 Enable Customer Fields on Catalog Items .........1.......................3 Upload Images............................................................. 17 4 CUSTOMER © 2015 SAP SE or an SAP affiliate company................ 17 Set Proxy Server Settings ............................................ 9 2....................................3 2.................................................16 Enrich Catalog Data while Adding Items to Cart ................................................................................ 9 2........................................................................... 10 2................................................... 8 Maintain Catalog Data .............................................................. 5 Assign PPOMA Attributes to Users...........................1...............................................................3 4.....14 3......3.......6 4...................................1 4.. 8 2................................16 BAdI for Search Ranking -Customer Search Results .....................................................................1 Catalog Items .............................................................. 12 Import Catalog Data ................7 Business Add-Ins ............................3...............1 SAP NetWeaver Enterprise Search and Self-Service Requisition ..................................................................................... All rights reserved..14 4 4..........................................2 Import Formats for Catalog Data .................................................3 Attachments .1 Maintain External Web..................................................2 Search Terms .....................1 Configure Content Management Service................................................................................................................................................. 8 Maintain Common Currency ..........................................................................1.........Services .......................................................................1.............................................Contents 1 1..... 9 Index Catalog Data /Configure Embedded Search .............................1 Configure Cross Catalog Search (Optional) ...................................16 Enrich Catalog Data while Adding Items to Requisition ...............................2 2..13 3.................................................2 Maintain Additional Attributes for Catalogs .....4 Import Catalog Data .............................................4 4.....................................1 Configure Users in PPOMA .... 7 Define Number Ranges .................................................................................................................................................................................................... Following is the list of attributes and their default values: Mandatory Attributes Default Value Document Type BSART Note The document type should be configured in the customizing for SAP Materials Management under SAP Implementation Guide→ Materials Management  Purchasing Purchase Requisition -> Define Document Types Company Code BURKS Cost Center COSTCENTER Catalog CATALOG Note The catalogs that an employee is allowed to access and procure form have to be configured in the customizing for SAP Materials Management under SAP Implementation Guide Materials Management PurchasingEnvironment DataWeb Services: ID and Description Purchasing Organization EKORG Purchasing Group RESPPGRP Account Assignment Category KNTTP Material Group MATKL S/4 HANA Self-Service Procurement Configure Users in PPOMA CUSTOMER © 2015 SAP SE or an SAP affiliate company. 1. You can do so using transaction PPOMA.1 Configure Users in PPOMA You need to assign the business partner information corresponding to a user to the organization (Org) structure in transaction PPOMA. All rights reserved. You cannot assign users with employee role directly in transaction PPOMA. 5 . You can also assign these attributes at the organization level and inherit to the users with employee role.1 Assign PPOMA Attributes to Users You need to assign certain mandatory attributes to a user who is assigned the employee role. Mandatory Attributes Default Value Currency WAERS Plant WERKS Note The above sections are mandatory for Create Purchase Requisitions and My Purchase Requisitions apps. 6 CUSTOMER © 2015 SAP SE or an SAP affiliate company. S/4HANA Self-Service Procurement Configure Users in PPOMA . All rights reserved. You need not determine the catalog link that is needed for your requirement nor do you have access a third-party catalog user interface to select catalog items. You must perform the configuration steps only if you use cross-catalog search in the Create Purchase Requisitions app. Catalog data (in OCI 5. Catalog Data/Material Master Data Extraction 1.1 Catalog Items The number ranges for catalog items can be defined in the Customizing for Materials Management (SAP MM) under SAP Implementation Guide  Materials Management  Purchasing Purchase Requisition Self-Service Procurement  Define Number Ranges for Catalog Items and enter 01 as the catalog item number key range. If you have material master data.1 Define Number Ranges To enable import of items in a catalog.2 Configure Cross Catalog Search (Optional) Self-Service Requisitions in S/4HANA provides cross-catalog search to simplify the user experience.0 format as a JSON file or through HTTP service from your catalog partner To process the data perform the following steps: 1. Pre-requisites  Set up catalogs (WebService ID and other settings)  Configure SAP CMS (Content Management Service) for loading images/attachments  Catalog data is available in OCI 5. 2. extract the same into SAP MM staging tables. 2. you cannot extract catalog items. Note This section is optional.1. you must define the number ranges for the following attributes: 2. Index the data to be made available for cross-catalog search The settings required for the above steps are explained in details in the sections below. You can also perform this configuration using the transaction /SNRO for number range object MMPUR_CAT.0 format) is replicated to SAP MM staging tables. 2. Note If you do not assign a number range. All rights reserved. 7 . S/4 HANA Self-Service Procurement Configure Cross Catalog Search (Optional) CUSTOMER © 2015 SAP SE or an SAP affiliate company. You can now search for any catalog items or material master items from the simple search bar provided in the application. In this customizing. S/4HANA Self-Service Procurement Configure Cross Catalog Search (Optional) . You can define the common currency in the Customizing for Materials Management under SAP Implementation Guide  Materials Management  Purchasing Purchase Requisition Purchase RequisitionSelf-Service Procurement Maintain Common Currency Note You must activate and maintain the common currency in the system before importing catalog data. The number ranges for attachments can be defined in the Customizing for Materials Management under SAP Implementation Guide  Materials Management  Purchasing Purchase Requisition Self-Service Procurement Define Number Ranges for Attachments.2. . run the program MM_PUR_CTLG_EXT_COM_CUR_UPD to apply and adjust the new currency to all the catalog items that were imported.1. 2. In this customizing. you need to maintain number ranges. You must also re-index the data after this activity. you need to maintain number ranges.3 Attachments OCI 5. This price can be used later as filter criteria for searching catalog items. If you change the common currency after the extraction of data. do not change the common currency after the data is extracted. 8 CUSTOMER © 2015 SAP SE or an SAP affiliate company. The number ranges for search terms can be defined in the Customizing for Materials Management under SAP Implementation Guide  Materials Management  Purchasing Purchase Requisition Self-Service Procurement  Define Number Ranges for Search Terms.2 Maintain Common Currency You must activate a common currency if you want to enable the price filter for search items. enter number ranges for number range objects MMPUR_ST and enter 01 for the search item number key range. All rights reserved. select the number range object MMPUR_ATT and enter 01 as the attachment key number range. 2.0 provides an option for catalogs to send images and attachments for an item.2 Search Terms OCI 5. To enable extraction of attachment data from catalogs.0 provides an option for catalogs to send specific search terms for each catalog item. The price of the catalog items in different currencies is converted to a common currency by the system during import of catalog data.1. To enable extraction of data for search terms from catalogs. 1 Maintain External Web. if you want to import data from this catalog using catalog data import 2. or repository address.0.3 Maintain Catalog Data You need to define the catalogs that will be used for self-service procurement. Note To configure SAP NetWeaver Enterprise Search in ABAP AS (Embedded Search). Embedded Search is the Enterprise Search component in the AS ABAP. 9 . Don’t Show: Select the check box. Embedded Search: Embedded Search serves SAP Business Suite applications as a basic search technology platform for searching business objects using the HANA engine.3.4 Index Catalog Data /Configure Embedded Search SAP NetWeaver Enterprise Search is a search solution providing unified.3. OCI Extr: Select the check-box. Search object connectors are used to connect search providers to SAP NetWeaver Enterprise Search to make objects of a specific type that are stored on them available for searching. if you do not want to show in Catalogs tab page 5.2. the connectivity data can be an RFC destination.com Technology Platform SAP NetWeaver Enterprise Search. Also. Enter transaction SPRO 2. Depending on the type of search provider involved. To do so. Select the web service from drop down list and maintain the attributes 4. refer to SAP Note 1164979.sap. Go to SAP Implementation Guide  SAP Implementation Guide  Materials Management  Purchasing Purchase Requisition Self-Service Procurement Define Additional Attributes for Product Catalog Categories 3.2 Maintain Additional Attributes for Catalogs You can also define the visibility of punch out catalogs and specify whether the catalog is used for extraction of data using OCI 5. and secure real-time access to enterprise data and information from within and outside of a company. S/4 HANA Self-Service Procurement Configure Cross Catalog Search (Optional) CUSTOMER © 2015 SAP SE or an SAP affiliate company. etc.Services You can define the webservice ID and description associated with a catalog in the Customizing for Materials Management under SAP Implementation Guide  Materials Management  PurchasingEnvironment Data Web Services: ID and Description 2. comprehensive. see http://help. All rights reserved. The search returns data from SAP systems and other search providers and allows direct access to the associated applications and actions. follow the sections below: 2. Perform the following steps: 1. URL. a search object Connector can be created.1. Select this line and click on the button Create Connector.2 Create Search Object Connectors You can create search object connectors using the ESH Administrator Cockpit. The administrator has to build search object connectors from these business templates and run index over these search object connectors to enable SAP NetWeaver Enterprise Search for the above mentioned master data.1 Set-up Search Templates and Search Object Connectors SAP NetWeaver delivers search object connector templates which are business templates within the Enterprise Search screens. Using a search template. Following is a list of other search templates: 10 Search Template Description MM_PUR_CTLG_SRH Search Results Model (Catalog Item Main Data) MM_PUR_CTLG_ATTCH Images and Attachments CUSTOMER © 2015 SAP SE or an SAP affiliate company. Once the connectors are created.1. data is indexed automatically.2. Perform the following steps to create search object connectors: Enter transaction ESH_COCKPIT Click Switch to Modeler. You can see all the templates for Requisition under the software component MM-PURREQ Search for the right business template (or model). S/4HANA Self-Service Procurement Configure Cross Catalog Search (Optional) . All rights reserved.4. 2.4. 2. You can mass create search object connectors using transaction ESH_COCKPIT.4. A search template includes the description of the selection attributes for search and the structure of the result data. Repeat steps 3 and 4 to create connectors for other templates under the component MM-PUR-REQ component listed below. ESH Search Connectors are not available on the customer system by default and the administrator needs to create one search connector for each business template (search model). The Search object connector is created. The search object connector delivers the result data in a predefined form for the specified selection attributes.1 SAP NetWeaver Enterprise Search and Self-Service Requisition Self-service requisition cross-catalog search relies on the following data providers for essential master data and they need to be indexed for access by SAP NetWeaver Enterprise Search  Catalog content from Supplier Catalogs  Material Master Data from MM SAP NetWeaver Enterprise Search (ESH) business templates (Search Models) for the above mentioned master data are delivered as part of S/4HANA. Search Template Description MM_PUR_CTLG_ATTRB Attributes MM_PUR_CTLG_CUST_FLD Customer Fields MM_PUR_CTLG_PRC_CON Converted Price Data (Prices in Different Exchange Rates) MM_PUR_CTLG_SRCHTRM Search Terms S/4 HANA Self-Service Procurement Configure Cross Catalog Search (Optional) CUSTOMER © 2015 SAP SE or an SAP affiliate company. All rights reserved. 11 . Click Save 3. index the data and use embedded search APIs to search for the items. perform the steps below: 1. All rights reserved. For more information. In the Phys. S/4HANA Self-Service Procurement Configure Content Management Service .3 Configure Content Management Service S/4HANA self-service requisition cross-catalog search feature requires the content management service to be configured for storing the images during extraction. Some of the important tables are listed here: 12 Table Description MMPUR_CAT_ITM Main data for catalog items MMPUR_CAT_PRCONV Price converted to common currency MMPUR_CAT_LNGTXT Long text MMPUR_CAT_DSCTXT Description MMPUR_CAT_PRCSCL Price scales MMPUR_CAT_ITM_SRH Search terms description CUSTOMER © 2015 SAP SE or an SAP affiliate company. The content management repository is MMPUR_CAT_CONTENT and the contents are maintained in the table MMPUR_CAT_CNTNT. You need cross-client customizing authorizations to maintain configuration for CMS. Go to SAP Implementation Guide  SAP NetWeaver Knowledge Management  Settings in the Knowledge Warehouse System  Content Management Service  Define Content Repositories 3. The imported catalog items data and master data in SAP Materials Management is stored in S/4HANA tables. select MMPUR_CAT_CONTENT and click on Edit 4. Verify the client allowed for cross-client settings and make settings in that client.1 Import Catalog Data Cross-catalog search is performed by syndicating data from the catalog items and material master into a single source of data for search. enter the physical path for storing the files 5. see tables in the package VDM_MM_PUR_CATALOG. In the Content Repository field. Note This is a cross-client setting. Enter transaction SPRO 2. Select the HTTPS requirement in fields HTTPS on frontend and HTTPs on backend 6. You must maintain the entries for the physical path for storage and HTTPS requirement for loading images (if any). To do so. Syndicating data from all the catalogs into a single source is performed by importing catalog content from various catalogs both internal or third party and storing the data after validation in S/4HANA catalog data tables.Path field. 13 .0 specification in two ways:  JSON file  HTTP(s) Webservice The master data in SAP Materials Management can be imported using a report You can download the OCI 5. multiple customer fields are supported in open catalog interface.sap.Table Description MMPUR_CAT_MGPTXT Material group text MMPUR_CAT_ATMAIN Attachments Main MMPUR_CAT_ATTCHM Attachments MMPUR_CAT_ATTHMB Thumbnail Attachment MMPUR_CAT_ATHTXT Attachment text MMPUR_CAT_ATTRB Attributes for catalog Items Note The master data maintained in SAP Materials Management can also be imported using extraction reports provided to form single source of data for search.0.1 Enable Customer Fields on Catalog Items Starting with OCI 5. 3.com/srm  open catalog interface S/4 HANA Self-Service Procurement Configure Content Management Service CUSTOMER © 2015 SAP SE or an SAP affiliate company. You can maintain the customer fields in the INCLUDE structure MMPUR_CA_INCL_CAT_ITM of the table MMPUR_CAT_ITM.2 Import Formats for Catalog Data Third party catalog providers can supply the data according to OCI 5. a catalog import cockpit has been provided. All rights reserved.0 specifications from SAP service market place using https://service. For importing data into staging DB. The following diagram depicts the steps involved in preparing the data for cross-catalog search: 3.1.1. In the Import File/URL field.2 Upload/Import from Web service This section explains the process of importing the catalog data by connecting to a supplier provided HTTP(s) web service. User name.1. the system administrator has to configure the system in such a way that if it encounters any URL that contains the term imageloader. 1. you need not enter here.File 4.1 Upload File This section explains the procedure to importing the catalog data from JSON files. Select Import Image checkbox. you must assign the role MMPUR_CAT_CONTENT_MGMT role to your user.3 Upload Images The images hosted on the ABAP server or any other server needs to be configured in web dispatcher. Select Import Action applicable . Enter transaction MMPUR_CAT_EXT 2.4 Import Catalog Data The catalog import cockpit facilitates importing data from OCI 5. S/4HANA Self-Service Procurement Configure Content Management Service . Select Import Action applicable .4. Enter transaction MMPUR_CAT_EXT Catalog Importer screen appears. In the Image Folder field. To import the catalog. provide the path for the file to be imported 5. Provide the URL. Click on Schedule Job button 8.4. system will access the URL using the given user id and password in this 14 CUSTOMER © 2015 SAP SE or an SAP affiliate company. Add a catalog web service ID or select an existing catalog web service ID 3.1. Give a requested page. password and page size. For this. 3.0 compliant catalogs through HTTP(s) web service or JSON files or importing material master data from SAP Materials Management. 3. Add a catalog web service ID or select an existing catalog web service id 3. Note If the catalog web service ID configuration has a user and password details. If you enter user and password. 1. the catalog data is stored in the database tables and indexed 3.3. All rights reserved. 2. it should be re-directed to the server where images are loaded.1.1. enter the path for the folder containing images 7.HTTP/HTTPS 4. if you want to import images 6. Define extraction schedule to start immediately or to start at a specified date/time Upon successful importing. All catalog items are added to tables. 15 . Delta load Reschedule delta : ON Use when you want to change some data or add additional items in already imported catalog Upon successful importing. 1. use Reschedule Delta indicator. the catalog data is stored in DB tables and indexed. Click on Schedule Job button 4. S/4 HANA Self-Service Procurement Configure Content Management Service CUSTOMER © 2015 SAP SE or an SAP affiliate company. The use of these indicators is explained in the table below: Importing Type Values of Indicators Remarks Full Load or Initial Load Reschedule delta : OFF Use when you are importing data into a catalog first time. The use of these indicators are explained in the table below: Importing Type Values of Indicators Remarks Full Load or Initial Load Reschedule delta : OFF Use when you are importing data into a catalog first time. Delta load Reschedule delta : ON Use when you want to change some data or add additional items in already imported catalog Upon successful importing. Click on Schedule Job button. Select MATERIAL MASTER 3.3 Import Data from Material Master This section explains importing the MM Material Master data. You can also provide a transaction ID and the requested page if you like to resume a stalled transaction from a desired page. All catalog items are added to tables. Define Job schedule. Click on Import Image checkbox. 8. then you need to implement the BAdI MMPUR_CAT_PROXY_INFO to provide proxy info. 5.screen. if you want to import images. the catalog data is stored in the database tables and indexed. If you use proxy server. either to start immediately or to start a specified date/time. 5.1. The extraction is done using an ABAP report. Provide the folder path for the folder containing images in Image Folder. select the Reschedule Delta indicator. Define Job schedule. either to start immediately or to start a specified date/time. 3. 6. Enter transaction MMPUR_CAT_EXT 2.4. For Delta import. 7. All rights reserved. For delta import. verify the catalog data and determine the need for converting the data to suit your organizational requirements. Once all the required items are included in mini cart. This search behavior can be influenced by using the BADI MM_PUR_CTLG_BDI_SRH. a purchase requisition is created. The final search results are consolidation of search results from both more relevant columns and less relevant columns with search results from more relevant columns showing up on the top. Order the cart: User wants to order the shopping cart with selected items with default cart data such as account assignment. The system searches the relevant columns first and then searches on other columns. vendor name. shipping address. When the user clicks on this action. long description. Catalog data can be used to create requisitions from search results or punch out catalog. images and customer fields. When a user clicks on this action. You can enrich any of this data by implementing the BAdI. S/4HANA Self-Service Procurement Business Add-Ins . description. All rights reserved. Typically. a draft purchase requisition is created which is converted to a purchase requisition document on order. manufacturer name. Review Cart: User may want to review and make changes to the cart data. 16 CUSTOMER © 2015 SAP SE or an SAP affiliate company.3 Enrich Catalog Data while Adding Items to Requisition Catalog data may need to be enhanced to ensure that correct data is used for creating a purchase requisition.4 Business Add-Ins 4. 4. the items are added to mini-cart.1 Enrich Catalog Data during import to S/4 HANA Business Add-Ins (BAdI) has been provided to enrich data before importing into S/4HANA tables. attributes. The catalog data is validated before importing and hence ensure that your catalog data is correct. when a user adds items to cart from search or punch-out catalog. material group. user has two options such as order the cart or review the cart.2 BAdI for Search Ranking -Customer Search Results The search keyword provided in the search box searches across indexed catalog item data on all data. Some of the catalog data is more relevant than other data. search terms. Mini cart has just basic item data with minimal validations. For example. If you face any issue in importing catalog data or if the data is not imported due to errors. 4. Enhancement Spot: MMPUR_CATALOG_ENRICH_DATA BAdI Definition: MMPUR_CATALOG_ENRICH_DATA The interface method ENRICH_ITEM_DATA provides access to catalog item data. BAdI to enrich third party Catalog Data: You can use these BAdI to alter data according to your organizations’ requirements or to fill customer fields from OCI data. price scales. 7 Modify Approver Data You can use this BAdI to modify the appearance of approver data.6 Transfer Additional Parameters while Launching Catalog You can use this BAdI to transfer additional parameters to an external Web Service. All rights reserved.You may want to enhance the catalog data transferred for creating the Requisition. such as a product catalog or a vendor list. 17 .4 Enrich Catalog Data while Adding Items to Cart You can use this BAdI to enhance catalog data items from punch out or cross catalog search when items are transferred from mini cart to purchase requisition. Enhancement spot: MMPUR_CAT_PROXY_INFO BadI name: MMPUR_CAT_PROXY_INFO 4. 4.5 Set Proxy Server Settings You can use this BAdI to specify the proxy server settings to access the Internet. Enhancement spot: MMPUR_CAT_CLL_ENRCH BAdI name: MMPUR_CAT_CLL_ENRCH 4. like approver name on the user interface of My Purchase Requisition app. Enhancement pot: ES_MMPUR_REQ_APPR_PRV BAdI name: BD_MMPUR_REQ_APPR_PRV S/4 HANA Self-Service Procurement Business Add-Ins CUSTOMER © 2015 SAP SE or an SAP affiliate company. Enhancement spot: MMPUR_CATALOG_TRANSFER BadI name: MMPUR_CATALOG_ENRICH_DATA 4. epx#trademark for additional trademark information and notices.com/corporate-en/legal/copyright/index. SAP and other SAP products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of SAP SE (or an SAP affiliate company) in Germany and other countries.www. All rights reserved.com/contactsap © 2015 SAP SE or an SAP affiliate company. Please see http://www. Material Number: . All other product and service names mentioned are the trademarks of their respective companies. No part of this publication may be reproduced or transmitted in any form or for any purpose without the express permission of SAP SE or an SAP affiliate company.sap. sap.