teamcenter product cost management gateway for sap s ...the ucon blacklist prevents external...

30
Teamcenter Product Cost Management Gateway for SAP S/ 4HANA - SAP S/4HANA® Preparation Guide

Upload: others

Post on 24-Mar-2020

21 views

Category:

Documents


0 download

TRANSCRIPT

TeamcenterProduct CostManagementGateway for SAP S/4HANA-SAP S/4HANA®Preparation Guide

Contents

Preface 3

Introduction 1-1

Supported SAP Products 2-1

Software Prerequisites to Run Teamcenter Product CostManagement Gateway for SAP S/4HANA

Legal Information ───────────────────────────────────── 3-1How to Obtain the SAP and SAP GUI Release and Patch Level Information ─ 3-1Netweaver RFC SDK ──────────────────────────────────── 3-3JCO (Java Connector) Libraries ───────────────────────────── 3-4

SAP Function Calls Used and Permissions RequiredSAP Function Calls Used and Permissions Required by Teamcenter Product Cost

Management ──────────────────────────────────── 4-1UCON Blacklist ─────────────────────────────────────── 4-2

Glossary A-1

Preparation Guide 2© 2019 Siemens Product Lifecycle Management Software, Inc.

PrefaceThis documentation cannot be used as a substitute for consulting advice, because it can never considerthe individual business processes and configuration. Despite our best efforts it is probable that someinformation about functionality and coherence may be incomplete.

Issue: August 2019

Legal notice:

All rights reserved. No part of this documentation may be copied by any means or made available toentities or persons other than employees of the licensee of the Teamcenter Product Cost ManagementGateway for SAP S/4HANA or those that have a legitimate right to use this documentation as part oftheir assignment on behalf of the licensee to enable or support usage of the software for use within theboundaries of the license agreement.

© 2018-2019 Siemens Product Lifecycle Management Software Inc.

Trademark notice:

Siemens, the Siemens logo and SIMATIC IT are registered trademarks of Siemens AG.

Camstar and Teamcenter are trademarks or registered trademarks of Siemens Product LifecycleManagement Software Inc. or its subsidiaries in the United States and in other countries.

Oracle is a registered trademark of Oracle Corporation.

SAP, R/3, SAP S/4HANA®, SAP Business Suite® and mySAP are trademarks or registered trademarks of SAPor its affiliates in Germany and other countries.

TESIS is a registered trademark of TESIS GmbH.

All other trademarks, registered trademarks or service marks belong to their respective holders.

Preparation Guide 3© 2019 Siemens Product Lifecycle Management Software, Inc.

4 Preparation Guide© 2019 Siemens Product Lifecycle Management Software, Inc.

1. IntroductionThe Teamcenter Product Cost Management Gateway for SAP S/4HANA (TCPCM4S) software solution isan integration software that provides data and process integration between Teamcenter Product CostManagement® by Siemens Product Lifecycle Management Software Inc. and SAP S/4HANA® by SAP AG

TCPCM4S provides functionality to sync masterdata from SAP ERP, search and import calculations intoTeamcenter Product Cost Management. It is also possible to show a preview of the calculation prior tothe import. TCPCM4S also comes with an authentication suite to authenticate against SAP ERP.

This document details the components of Teamcenter Product Cost Management Gateway for SAP S/4HANA integration, which are available out of the box and configurable to meet customer specificsolution requirements.

Preparation Guide 1-1© 2019 Siemens Product Lifecycle Management Software, Inc.

1. Introduction

1-2 Preparation Guide© 2019 Siemens Product Lifecycle Management Software, Inc.

2. Supported SAP ProductsPlease see: How to obtain the SAP GUI release and patch level information

The latest information on supported products is available in the readme fileTeamcenter_PCM_Gateway_for_S4HANA_19.1_README_for_Teamcenter_*.txt. It can be downloadedfrom GTAC from Teamcenter and TeamcenterRapid Start / Integrations directory.

Caution:

Please also see https://launchpad.support.sap.com/#/notes/147519 for supported products.

• 7.40: Full support up to January 9th, 2018. Restricted support until June 30th, 2018. Noextended support is offered

• 7.50: Full support up to April 9th, 2019. Restricted support until September 30th, 2019. Noextended support is offered.

Preparation Guide 2-1© 2019 Siemens Product Lifecycle Management Software, Inc.

2. Supported SAP Products

2-2 Preparation Guide© 2019 Siemens Product Lifecycle Management Software, Inc.

3. Software Prerequisites to RunTeamcenter Product Cost ManagementGateway for SAP S/4HANA

3.1 Legal Information

SAP does not allow their software partners to ship files owned by SAP. As a result, some of the filesTCPCM4S requires to communicate with SAP are not included in the TCPCM4S installation package andneed to be obtained directly from SAP ONE Support Launchpad or with the help of your SAP supportpartner.

In order to download software from the SAP ONE Support Launchpad, a valid web login with user andpassword is necessary.

3.2 How to Obtain the SAP and SAP GUI Release and Patch LevelInformation

SAP Version

In the main menu point System – Status, check the point "Component version".

Preparation Guide 3-1© 2019 Siemens Product Lifecycle Management Software, Inc.

SAP GUI Version:

In the SAP logon window, click on the icon in the upper left corner (where you may minimize and closewindows by default) and select "About SAP logon". Then a new window opens that shows theinformation. Example from a SAP GUI 7.40 with patch level 0:

3. Software Prerequisites to Run Teamcenter Product Cost Management Gateway for SAP S/4HANA

3-2 Preparation Guide© 2019 Siemens Product Lifecycle Management Software, Inc.

3.3 Netweaver RFC SDK

Depending on the SAP system configuration those file versions may be different. Unfortunately cannotcheck which are the correct files, so in case of a problem with SAP communication (in most cases in DIRhandling only) please ask your SAP specialist for help and provide the correct files. The SAP RFC SDK canbe downloaded from the SAP ONE Support Launchpad

The corresponding files have to be copied into the GS bin directory (<GS_ROOT>\bin64):

• libsapnwrfc.dll (.so)

• libsapucum.dll (.so)

• libicudecnumber.dll (.so)

For more details, please read <GS_ROOT>\bin64\readme.sapnwrfclib

Caution:

If the Netweaver runtime library files are missing, the GS will not start.

As the GS can still use some SAP JCO functionalities, it additionally may require the JCO runtimelibraries.

If the correct version of the files can´t be clearly identified, the best possibility to find the correctpackage is downloading several packages from SAP and checking if the transaction is successful. In orderto avoid a long search, first check the following in the SAP GUI: How to obtain the SAP GUI release andpatch level information. Then try downloading only the packages from SAP with similar descriptions.

Netweaver RFC SDK

Preparation Guide 3-3© 2019 Siemens Product Lifecycle Management Software, Inc.

3.4 JCO (Java Connector) Libraries

Using JCO may not be necessary for the basic functionality. Examples where JCO may be necessary are:

• Some T4x web services.

• A couple of not yet migrated standard functions are still using the JCO adapter at the moment, thisare in the following areas:Routing ChangeMaterial BatchesiPPEProject SystemManufacturing functionality, especially Routing Transfer .

• Any customer specific functionality using JCO (reading or writing SAP fields that are inaccessible bythe default SAP mechanisms).In previous T4S versions, custom SAP functions where called via JCO. This will still be the case untilthe code has been replaced with generated code for the NW interface.

• Some features use the SAP JCO adapter without telling it explicitly.

uses SAP JCO Release 3.0.9 (or higher) for all platforms. This version can be downloaded on the SAPService Marketplace. Depending on the hardware and OS platform (Windows, UNIX, Linux), you need adifferent JCO package. This Java process is independent from the Java process started with Teamcenter,it may use completely different environment settings.

The system hardware determines the package where to take the SAP JCO library files from. In Linux/UNIX, the command uname -a tells some details. As not every hardware is certified with Teamcenter,you may refer to the Active Integration Software Certifications to exclude some hardware packages.

Required files:

• sapjco3.dll (.so)

• sapjco3.jar

• sapjco3.pdb

For more details, please see <GS_ROOT>\bin64\readme.sapnwrfclib.

3. Software Prerequisites to Run Teamcenter Product Cost Management Gateway for SAP S/4HANA

3-4 Preparation Guide© 2019 Siemens Product Lifecycle Management Software, Inc.

Caution:

The Java version used in your machines determines whether the 32-bit or 64-bit libraries are used.Depending on the Java version, it might be necessary to use the 32-bit JCO package even on a 64-bit system. In a command shell, enter java –version. Check the output: if it does not stateanything about 64 bit, it is a 32-bit Java version and needs the 32-bit JCO package. The minimumrequired Java version for SAP JCO is JSE 1.7.0.

JCO (Java Connector) Libraries

Preparation Guide 3-5© 2019 Siemens Product Lifecycle Management Software, Inc.

3. Software Prerequisites to Run Teamcenter Product Cost Management Gateway for SAP S/4HANA

3-6 Preparation Guide© 2019 Siemens Product Lifecycle Management Software, Inc.

4. SAP Function Calls Used and PermissionsRequired

4.1 SAP Function Calls Used and Permissions Required byTeamcenter Product Cost Management

Mandatory Functions

The following RFC access permissions are needed in any case:

• function group SYST

• RFC_PING

• SYSTEM_RESET_RFC_SERVER

• SCSI_GET_SYSTEM_INFO

• RFC_GET_FUNCTION_INTERFACE

Overview of Functions

A complete overview of SAP functions that could be called can be found in the TCPCM4S API Referenceunder List of SAP Function Groups and Functions used by TCPCM4S:

The calls are grouped by permissions.

List of actually Used Function Calls

TCPCM4S provides a log file that lists all actually used function calls after they have been used. Ideallyyou get all SAP permissions for the TCPCM4S user(s) during development. Then after development iscomplete, you can extract a list of functions from the log and give it to your SAP administrator to limitthe SAP permissions for the testing phase.

In the BGS Admin UI you will find the logfile sys/sap_function_calls.log. It contains a list off all called SAPfunctions. Please see Configure T4x BGS Using BGS Admin UI in the Active Integration - InstallationGuide on how to login to the Admin UI. Please use the help function of the Admin UI for more details.

Preparation Guide 4-1© 2019 Siemens Product Lifecycle Management Software, Inc.

Caution:

The logfile does not list the following "connector internal" calls:

• RFC_PING

• RFC_GET_FUNCTION_INTERFACE

• DDIF_FIELDINFO_GET

• SYSTEM_RESET_RFC_SERVER

4.2 UCON Blacklist

The UCON Blacklist prevents external applications such as T4S to work properly with SAP S/4HANA®.Siemens PLM Software provides a SAP Transport Package with wrapper functions. This way T4S can bere-enabled to communicate with SAP. It is not required to expose the RFC function modules by disablingthe UCON Blacklist.

With SAP S/4HANA® version 1511 SP02 and higher, SAP uses the UCON Blacklist functionality to blockcertain RFC function modules. The reason for this is that many API calls (BAPIs) have been changed, andmay not be backwards compatible. So the result could be that inconsistent or wrong data is beingcommitted to the database. In order to avoid such an issue without even being recognized by the clientcaller (e.g. TCPCM4S), this blacklist was introduced to block all APIs which have been changed in anincompatible way.

TCPCM4S Version 19.1 and higher is fully compatible with the above mentioned API changes done bySAP. However the UCON Blacklist prevents external applications such as TCPCM4S to work properly withSAP S/4HANA®.

When a blocked remote enabled function module (RFC FM) is called from an external client on a SAP S/4HANA® system, an error is raised and shown to the caller with the following error text:

"UCON RFC Rejected; Called Function :<RFC FM NAME>; Caller SID :<SID ofClient>; Caller Program :<Caller program from which RFC call is made>".

Example from TCPCM4S:

Error Message: RFC code = 4 (RFC_ABAP_MESSAGE) :: Incompatible CallRejected, see note 2295840; Called IncompatibleFunction :RFC_GET_SAP_SYSTEM_PARAMETERS; Caller Program :nwpipe; CallerDest. :demchdc81!

More information and a list of BAPIs being blocked by this blacklist can be downloaded via the followingOSS note:

4. SAP Function Calls Used and Permissions Required

4-2 Preparation Guide© 2019 Siemens Product Lifecycle Management Software, Inc.

# 2259818 - RFC enabled Function Modules with incompatible signature change compared to its versionin ERP are blocked from external access

Importing and enabling the UCON Transport Packages

All required information can be found in the readme file that comes with the Transport Packages:

<GS_ROOT>/var/template/sap/TransportPackages/UCON/readme.txt

It can be located in the TCPCM4S GS installation package that is available on GTAC.

UCON Blacklist

Preparation Guide 4-3© 2019 Siemens Product Lifecycle Management Software, Inc.

4. SAP Function Calls Used and Permissions Required

4-4 Preparation Guide© 2019 Siemens Product Lifecycle Management Software, Inc.

A. Glossary

A

ABAPABAP is a proprietary programming language of the SAP AG.

Adminis the term used in this document for people who install and configure Teamcenter and its components.This is in contrast to the "user" role.

Admin UIWeb based administrative user interface of the GS and BGS.

AIGThe entire Active Integration Gateway product family.

AIG_ROOTPlease see GS_ROOT and BGS_ROOT. This term is used if something is true for both the GS and BGS.

AI-ObjectApplication-Interface Object

APIApplication Programming Interface.

AppsSee "GS".

AppServerApplication Server.

B

BAPIThe Business Application Programming Interface allows external programs to access objects andbusiness processes in SAP.

BGSBasic Gateway Service.

Preparation Guide A-1© 2019 Siemens Product Lifecycle Management Software, Inc.

BGS_ROOTThe installation directory of the Basic Gateway Service (e.g. C:\Siemens\BGS).

BMIDETeamcenter Business Modeler IDE (Integrated Development Environment)

BOMA Bill Of Materials is a list of the parts or components and their quantities that are required to build aproduct.

BOM HeaderA BOM Header is the top item of a BOM. BOMs can have multiple levels, so this often means the topitem of the actual level.

BOPThe Bill Of Process describes a manufacturing process and lists the operations and steps with all theirinstructions, consumed materials, resources, work places and machines.

C

CCObjectCollaboration Context Object

CEPCamstar Enterprise Platform

Change MasterThe Engineering Change Master (ECM) contains the metadata to a change number.

CharacteristicAn characteristic is an attribute of a SAP class.

CIOCamstar Interoperability

CLM4SClosed Loop Manufacturing for SAP S/4HANA®

D

Data CarrierPlease see Vault.

A. Glossary

A-2 Preparation Guide© 2019 Siemens Product Lifecycle Management Software, Inc.

DataviewThe Dataview is an extension to the Teamcenter RAC and is deployed as part of the TEM installationprocess of the Teamcenter Gateway. The Dataview is used to display the real-time data of externalapplications, associated with Teamcenter objects.

Dataview mark-upis the language understood by the Dataview. The Dataview receives messages written in this languagefrom the T4x server. Such messages can be formatted as XML or JSON. Normally users do not see suchmessages. They may however appear in log files or error messages. The so called prop mapping (e.g.t4s_prop_mapping_template.sd) contains TCL commands that compose messages in the Dataviewmark-up.

DCDData Collection Definition

DIRDIR is the abbreviation for a SAP Document Info Record.

Document KeyA Document Info Record is identified by the combination of Document Type, Document Number,Document Part and Document Version.

Document StructureA Document Structure is like a Bill Of Materials for Documents.

E

EAstands for Enterprise Application, any software or set of computer programs used by business users toperform various business functions in context of current integration's portfolio with Teamcenter.

ECNThe Engineering Change Notice can also be called an Engineering Change Note, Engineering ChangeOrder (ECO), or just an Engineering Change (EC).

EPMEnterprise Process Modeling

EWIElectronic Work Instructions

Preparation Guide A-3© 2019 Siemens Product Lifecycle Management Software, Inc.

F

File StreamMethod of transfer to send an original to SAP.

G

Gateway MenuAn additional menu item of the Teamcenter Gateway software available in the Teamcenter RAC.

GRMThe Generic Relationship Management provides a general way in which two objects can be associatedvia a relationship.

GSGateway Service, manages the communication between Enterprise Applications.

GS_ROOTThe installation directory of the Gateway Service (e.g. C:\Siemens\GS).

GUIGraphical user interface.

GUIDGlobally Unique Identifier

I

IDGENThe IDGEN is a mechanism to get an external ID from the ERP system when assigning a Teamcenter ID.

Inspection PlanContains characteristics to be inspected in an operation and equipment to be used.

iPPEIntegrated Product and Process Engineering is a module that can be used to mange products with manyvariants.

ITKThe Integration Toolkit (ITK) is a set of software tools provided by Siemens PLM Software that you canuse to integrate third-party or user-developed applications with Teamcenter.

A. Glossary

A-4 Preparation Guide© 2019 Siemens Product Lifecycle Management Software, Inc.

J

JCOThe Java Connector is an interface to . In the context of it is now mostly replaced by the Netweaver RFCinterface.

JDBCJava Database Connectivity is an application programming interface (API) for the programming languageJava, which defines how a client may access a database.

JobTeamcenter Gateway features asynchronous transfer. This datatransfer is managed via a Job.

Job PoolThe Job Pool contains all finished and unprocessed Jobs. It is managed by the BGS.

Job ServerThe Job Server on the Basic Gateway Service (BGS) manages the Job and distribution them to the JobAgent for processing.

JSONJavaScript Object Notation is a lightweight data-interchange format1.

K

KProKpro stands for Knowledge Provider. See also Data Carrier.

L

LOVList of Values

M

MappingThe mapping is part of the T4x configuration. It contains the code that controls the behavior of the datatransfer between Teamcenter and the ERP system.

1 JSON.org

Preparation Guide A-5© 2019 Siemens Product Lifecycle Management Software, Inc.

MFKMulti-key functionality in Teamcenter.

MMMM is the abbreviation for a SAP Material Master.

MOMManufacturing Operations Management

N

NCNNon-Conformance Notification

NetWeaver RFC SDKThe NetWeaver RFC SDK contains libraries for 3rd party applications to connect to . It can be obtainedfrom the SAP ONE Support Launchpad.

O

Object KeyThe Object Key is a string that contains the ID of an Enterprise Application object. If the identifier is acombination of multiple keys, then the Object Key is a combination of those keys in a defined order andformat.

Object LinkA relation between SAP objects like Material Master and Document Info Record.

Object Management RecordBelongs to a SAP Change Number and Documents changes of one particular SAP object like a MaterialMaster.

OOTBOut of the box

OriginalA representation of a file in SAP.

OSS NoteThe OSS Note is an online patch service for SAP. The patch can be identified by the OSS Notes number.

A. Glossary

A-6 Preparation Guide© 2019 Siemens Product Lifecycle Management Software, Inc.

P

PIRPIR is an abbreviation for a SAP Purchase Info Record.

Portal TransactionThis means that a transfer to SAP that is not triggered by a workflow handler but via the Gateway Menu.

R

RACstands for Rich Application Client also referred to as rich client or portal.

Revision LevelUsed to show changes with reference to a change to a SAP Material Master or Document Info Record.

RFCRemote Function Call (SAP)

S

SAPSAP S/4HANA® / SAP Business Suite®

SAP GUIThis is the application for the SAP Business Suite® and SAP S/4HANA®.

SAP LogonThis is the application that a user needs to start the SAP GUI for a particular system. It may also refer tothe process of logging in to SAP in Teamcenter via .

SAP Portal iView URLCan be used to show sap content in a browser window.

Session LogShows one log file for each Teamcenter session. Written if T4x transactions are executed

SSLSecure Sockets Layer.

Preparation Guide A-7© 2019 Siemens Product Lifecycle Management Software, Inc.

T

T4O_ROOTPlease see GS_ROOT

T4S 4-Tier Client (SAP Lite)The 4-Tier Client or SAP Lite is a stripped down GS. It´s only purpose is to open the SAP GUI on aTeamcenter 4-Tier Client.

T4xThe entire Teamcenter Gateway product family.

TAOThe ACE ORB is a open-source and standards-compliant real-time C++ implementation of CORBA basedupon the Adaptive Communication Environment (ACE).

TargetTypeNameThis is the T4x internal name for the transaction type. E.g. MaterialMaster orDocumentInfoRecord.

TCTeamcenter

TCLis a high-level, general-purpose, interpreted, dynamic programming language.

TCPCMTeamcenter Product Cost Management

TCPCM4STeamcenter Product Cost Management Gateway for SAP S/4HANA

TEMTeamcenter Environment Manager

Transaction CodeA Transaction Code is a quick access code for a Transaction in the SAP GUI:

A. Glossary

A-8 Preparation Guide© 2019 Siemens Product Lifecycle Management Software, Inc.

Transaction LogThe Transaction Log is a T4x logfile on the BGS. It contains log information for a specific T4x transaction.

Transfer WindowThe Transfer Window triggers transactions via the Gateway Menu.

Transport PackageA file that contains functions that can be imported to SAP.

U

UOMUOM stands for Unit of Measure.

URIUnified Resource Identifier: a generalized from of a resource locator (URL) and resource name (URN),which just identifies a resource, but is not necessarily sufficient to locate (find) the resource. URIs areoften used to identify configurations in Java and other languages. See https://en.wikipedia.org/wiki/Uniform_Resource_Identifier for more details.

URLUnified Resource Locator: a string with a certain format, allowing to load a resource from a network.URLs are a specific form or URNs.

User Exit (SAP)A User Exit is a code for a program that is called if an object like an MaterialMaster has been changed orupdated. In the context of T4S it is often used to initiate the process to trigger a transfer from SAP toTeamcenter.

User LogThe User Log is a T4x logfile on the BGS. If you define a customized logchannel, the information iswritten into a User Log of that name.

V

Value SetA Value Set is the SAP term for a list of selectable values for a characteristic.

VaultThe Vault is a server where a SAP DocumentInfoRecord original is stored. A synonym is also Data Carrier.

Preparation Guide A-9© 2019 Siemens Product Lifecycle Management Software, Inc.

W

WBSWBS is an abbreviation for a SAP Work Breakdown Structure.

X

XMLExtensible Markup Language is designed to store and transport data in a format that is both human- andmachine-readable.

XRTstands for XML Rendering Template, also known as XML Rendering Stylesheet. These are XMLdocuments stored in datasets that define how parts of the Teamcenter user interface are rendered. Theyare used for the Rich Client as well as the Active Workspace.

Z

ZPTCThis is the short name for a Z-Table with the name /TESISPLM/ZPTC, used to trigger a transfer from SAP.

Z-Table"Z" is a well-known prefix name for custom tables in the SAP world. A special table used with is thetable /TESISPLM/ZPTC.

A. Glossary

A-10 Preparation Guide© 2019 Siemens Product Lifecycle Management Software, Inc.

Siemens Industry Software

HeadquartersGranite Park One5800 Granite ParkwaySuite 600Plano, TX 75024USA+1 972 987 3000

AmericasGranite Park One5800 Granite ParkwaySuite 600Plano, TX 75024USA+1 314 264 8499

EuropeStephenson HouseSir William Siemens SquareFrimley, CamberleySurrey, GU16 8QD+44 (0) 1276 413200

Asia-PacificSuites 4301-4302, 43/FAIA Kowloon Tower, Landmark East100 How Ming StreetKwun Tong, KowloonHong Kong+852 2230 3308

About Siemens PLM SoftwareSiemens PLM Software, a business unit ofthe Siemens Industry Automation Division,is a leading global provider of productlifecycle management (PLM) software andservices with 7 million licensed seats and71,000 customers worldwide.Headquartered in Plano, Texas, SiemensPLM Software works collaboratively withcompanies to deliver open solutions thathelp them turn more ideas into successfulproducts. For more information onSiemens PLM Software products andservices, visit www.siemens.com/plm.

© 2019 Siemens Product LifecycleManagement Software Inc. Siemens, theSiemens logo and SIMATIC IT are registeredtrademarks of Siemens AG. Camstar, D-Cubed, Femap, Fibersim, Geolus, I-deas, JT,NX, Omneo, Parasolid, Solid Edge,Syncrofit, Teamcenter and Tecnomatix aretrademarks or registered trademarks ofSiemens Product Lifecycle ManagementSoftware Inc. or its subsidiaries in theUnited States and in other countries. Allother trademarks, registered trademarks orservice marks belong to their respectiveholders.