Teamcenter Product

Cost Management
Gateway for SAP S/
4HANA

SAP S/4HANA®
Preparation Guide
Teamcenter PCM Gateway for SAP S/4HANA 2403
Unpublished work. © 2024 Siemens

This Documentation contains trade secrets or otherwise confidential information owned by Siemens Industry Software Inc. or
its affiliates (collectively, “Siemens”), or its licensors. Access to and use of this Documentation is strictly limited as set forth in
Customer’s applicable agreement(s) with Siemens. This Documentation may not be copied, distributed, or otherwise disclosed
by Customer without the express written permission of Siemens, and may not be used in any way not expressly authorized by
Siemens.

This Documentation is for information and instruction purposes. Siemens reserves the right to make changes in specifications
and other information contained in this Documentation without prior notice, and the reader should, in all cases, consult
Siemens to determine whether any changes have been made.
No representation or other affirmation of fact contained in this Documentation shall be deemed to be a warranty or give rise to
any liability of Siemens whatsoever.
If you have a signed license agreement with Siemens for the product with which this Documentation will be used, your use of
this Documentation is subject to the scope of license and the software protection and security provisions of that agreement.
If you do not have such a signed license agreement, your use is subject to the Siemens Universal Customer Agreement, which
may be viewed at https://www.sw.siemens.com/en-US/sw-terms/base/uca/, as supplemented by the product specific terms
which may be viewed at https://www.sw.siemens.com/en-US/sw-terms/supplements/.
SIEMENS MAKES NO WARRANTY OF ANY KIND WITH REGARD TO THIS DOCUMENTATION INCLUDING, BUT NOT LIMITED
TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT OF
INTELLECTUAL PROPERTY. SIEMENS SHALL NOT BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL OR
PUNITIVE DAMAGES, LOST DATA OR PROFITS, EVEN IF SUCH DAMAGES WERE FORESEEABLE, ARISING OUT OF OR RELATED
TO THIS DOCUMENTATION OR THE INFORMATION CONTAINED IN IT, EVEN IF SIEMENS HAS BEEN ADVISED OF THE POSSIBILITY
OF SUCH DAMAGES.

TRADEMARKS: The trademarks, logos, and service marks (collectively, "Marks") used herein are the property of Siemens or other
parties. No one is permitted to use these Marks without the prior written consent of Siemens or the owner of the Marks,
as applicable. The use herein of third party Marks is not an attempt to indicate Siemens as a source of a product, but is
intended to indicate a product from, or associated with, a particular third party. A list of Siemens’ Marks may be viewed at:
www.plm.automation.siemens.com/global/en/legal/trademarks.html. The registered trademark Linux® is used pursuant to a
sublicense from LMI, the exclusive licensee of Linus Torvalds, owner of the mark on a world-wide basis.

About Siemens Digital Industries Software

Siemens Digital Industries Software is a global leader in the growing field of product lifecycle management (PLM),
manufacturing operations management (MOM), and electronic design automation (EDA) software, hardware, and services.
Siemens works with more than 100,000 customers, leading the digitalization of their planning and manufacturing processes. At
Siemens Digital Industries Software, we blur the boundaries between industry domains by integrating the virtual and physical,
hardware and software, design and manufacturing worlds. With the rapid pace of innovation, digitalization is no longer
tomorrow’s idea. We take what the future promises tomorrow and make it real for our customers today. Where today meets
tomorrow. Our culture encourages creativity, welcomes fresh thinking and focuses on growth, so our people, our business, and
our customers can achieve their full potential.

Support Center: support.sw.siemens.com

Send Feedback on Documentation: support.sw.siemens.com/doc_feedback_form

 Contents

Preface 5

Introduction 1-1

Supported SAP Products 2-1

Software Prerequisites to Run Teamcenter Product Cost Management

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

SAP Function Calls Used and Permissions Required

SAP Function Calls Used and Permissions Required by Teamcenter Product Cost
Management ───────────────────────── 4-1
UCON Blocklist ──────────────────────────── 4-2

SAP Transport Packages for Teamcenter Product Cost Management

Gateway for SAP S/4HANA Functionality 5-1

Set Up to Trigger Data Transfer From SAP to a target system

Overview ────────────────────────────── 6-1
Table Definition /TESISPLM/ZPTC ──────────────────── 6-1
Z-Table ABAP Functions ──────────────────────── 6-3
SAP Event Trigger ────────────────────────── 6-4

Glossary A-1

Teamcenter Product Cost Management Gateway for SAP S/4HANA - Preparation Guide, Teamcenter PCM Gateway for SAP S/4HANA 2403
3
© 2024 Siemens
4 Teamcenter Product Cost Management Gateway for SAP S/4HANA - Preparation Guide, Teamcenter PCM Gateway for SAP S/4HANA
2403
© 2024 Siemens
 Preface
This documentation cannot be used as a substitute for consulting advice, because it can never consider
the individual business processes and configuration. Despite our best efforts it is probable that some
information about functionality and coherence may be incomplete.

Issue: March 2024

Legal notice:

All rights reserved. No part of this documentation may be copied by any means or made available to
entities or persons other than employees of the licensee of the Active Integration Gateway or those that
have a legitimate right to use this documentation as part of their assignment on behalf of the licensee to
enable or support usage of the software for use within the boundaries of the license agreement.

© 2002-2024 Siemens Industry Software Inc.

Trademark notice:

Siemens, the Siemens logo and Opcenter are registered trademarks of Siemens AG.

Camstar and Teamcenter are trademarks or registered trademarks of Siemens Industry 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 SAP
or its affiliates in Germany and other countries.

TESIS is a registered trademark of TESIS GmbH.

InfluxDB® is a trademark registered by InfluxData, which is not affiliated with, and does not endorse, this
product.

Telegraf™ is a trademark owned by InfluxData, which is not affiliated with, and does not endorse, this
product.

The Grafana® Word Mark and Grafana Logo are either registered trademarks/service marks or
trademarks/service marks of Coding Instinct AB, in the United States and other countries and are used
with Coding Instinct’s permission. We are not affiliated with, endorsed or sponsored by Coding Instinct,
or the Grafana community.

Teamcenter Product Cost Management Gateway for SAP S/4HANA - Preparation Guide, Teamcenter PCM Gateway for SAP S/4HANA 2403
5
© 2024 Siemens
 Nagios®, the Nagios logo, and Nagios graphics are the servicemarks, trademarks, or registered
trademarks owned by Nagios Enterprises, which is not affiliated with, and does not endorse, this
product.

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

Acknowledgements

This product includes numerous open source components. For more information, please refer to the
readme on OSS in the download section. In particular we like to point out:

Contains portions or was derived from the RSA Data Security, Inc. MD5 Message-Digest Algorithm.

This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit.
(http://www.openssl.org/) This product includes cryptographic software written by Eric Young
([email protected]).

6 Teamcenter Product Cost Management Gateway for SAP S/4HANA - Preparation Guide, Teamcenter PCM Gateway for SAP S/4HANA
2403
© 2024 Siemens
 1. Introduction
The Teamcenter Product Cost Management Gateway for SAP S/4HANA (TCPCM4S) software solution is
an integration software that provides data and process integration between Teamcenter Product Cost
Management® by Siemens Industry Software Inc. and SAP S/4HANA® by SAP AG

TCPCM4S provides functionality to sync masterdata from SAP ERP, search and import calculations into
Teamcenter Product Cost Management. It is also possible to show a preview of the calculation prior to
the 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 specific
solution requirements.

Teamcenter Product Cost Management Gateway for SAP S/4HANA - Preparation Guide, Teamcenter PCM Gateway for SAP S/4HANA 2403
1-1
© 2024 Siemens
 1. Introduction

1-2 Teamcenter Product Cost Management Gateway for SAP S/4HANA - Preparation Guide, Teamcenter PCM Gateway for SAP S/4HANA
2403
© 2024 Siemens
 2. Supported SAP Products
Please see also: How to obtain the SAP GUI release and patch level information. For information
about the SAP GUI support deadlines of SAP refer to https://launchpad.support.sap.com/#/notes/
147519.

The latest information on supported products is available in the readme file

Teamcenter_PCM_Gateway_for_S4HANA_2403_README_for_Teamcenter_*.txt. It can be downloaded
from Support Center.

Active Integration Gateway 2403 supports Active Integration Software Certifications.

Teamcenter Product Cost Management Gateway for SAP S/4HANA - Preparation Guide, Teamcenter PCM Gateway for SAP S/4HANA 2403
2-1
© 2024 Siemens
 2. Supported SAP Products

2-2 Teamcenter Product Cost Management Gateway for SAP S/4HANA - Preparation Guide, Teamcenter PCM Gateway for SAP S/4HANA
2403
© 2024 Siemens
 3. Software Prerequisites to Run
Teamcenter Product Cost Management
Gateway 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 files
TCPCM4S requires to communicate with SAP are not included in the TCPCM4S installation package and
need to be obtained directly from SAP ONE Support Launchpad or with the help of your SAP support
partner.

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

3.2 How to Obtain the SAP and SAP GUI Release and Patch Level
Information
SAP Version

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

Teamcenter Product Cost Management Gateway for SAP S/4HANA - Preparation Guide, Teamcenter PCM Gateway for SAP S/4HANA 2403
3-1
© 2024 Siemens
 3. Software Prerequisites to Run Teamcenter Product Cost Management Gateway for SAP S/4HANA

SAP GUI Version:

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

3-2 Teamcenter Product Cost Management Gateway for SAP S/4HANA - Preparation Guide, Teamcenter PCM Gateway for SAP S/4HANA
2403
© 2024 Siemens
 Netweaver RFC SDK

3.3 Netweaver RFC SDK

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

For Windows the corresponding files have to be copied into <GS_ROOT>/bin64:

• libsapnwrfc.dll

• libsapucum.dll

• icudt*.dll

• icuin*.dll

• icuuc*.dll

For Linux the corresponding files have to be copied into <GS_ROOT>/lib64:

• libsapnwrfc.so

• libsapucum.so

• libicudata.so*

• libicui18n.so*

• libicuuc.so*

Teamcenter Product Cost Management Gateway for SAP S/4HANA - Preparation Guide, Teamcenter PCM Gateway for SAP S/4HANA 2403
3-3
© 2024 Siemens
 3. Software Prerequisites to Run Teamcenter Product Cost Management Gateway for SAP S/4HANA

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 runtime
libraries.

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

3.4 JCO (Java Connector) Libraries

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

• A couple of not yet migrated standard functions are still using the JCO adapter at the moment, these
are in the following areas:

Routing

iPPE

Project System

Manufacturing functionality, especially Routing Transfer and Vendor Management.

• Any customer specific functionality using JCO (reading or writing SAP fields that are inaccessible by
the default SAP mechanisms).

In previous AIG versions, custom SAP functions were called via JCO. This will still be the case until the
code has been replaced with generated code for the NW interface.

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

AIG uses SAP JCO Release 3.0.9 (or higher) for all platforms. This version can be downloaded on the SAP
Service Marketplace. Depending on the hardware and OS platform, you need a different JCO package.

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

Required files:

3-4 Teamcenter Product Cost Management Gateway for SAP S/4HANA - Preparation Guide, Teamcenter PCM Gateway for SAP S/4HANA
2403
© 2024 Siemens
 JCO (Java Connector) Libraries

• sapjco3.dll (.so)

• sapjco3.jar

• sapjco3.pdb

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

Caution:
The used Java version 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 and check the output: if it does not state anything about
64-bit, it is a 32-bit Java version and needs the 32-bit JCO package. The minimum required Java
version for SAP JCO is JSE 1.7.0.

Teamcenter Product Cost Management Gateway for SAP S/4HANA - Preparation Guide, Teamcenter PCM Gateway for SAP S/4HANA 2403
3-5
© 2024 Siemens
 3. Software Prerequisites to Run Teamcenter Product Cost Management Gateway for SAP S/4HANA

3-6 Teamcenter Product Cost Management Gateway for SAP S/4HANA - Preparation Guide, Teamcenter PCM Gateway for SAP S/4HANA
2403
© 2024 Siemens
 4. SAP Function Calls Used and Permissions
Required
4.1 SAP Function Calls Used and Permissions Required by
Teamcenter Product Cost Management
Mandatory Functions

The following RFC access permissions are required:

• function group SYST

• RFC_PING

• SYSTEM_RESET_RFC_SERVER

• SCSI_GET_SYSTEM_INFO

Overview of Functions

A complete overview of SAP functions that could be called can be found in the TCPCM4S API Reference
under 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. Ideally
you get all SAP permissions for the TCPCM4S user(s) during development. Then after development is
complete, you can extract a list of functions from the log and give it to your SAP administrator to limit
the SAP permissions for the testing phase.

The system log file sap_function_calls.log in the BGS Admin UI contains a list of all called SAP functions.
Please see Administrative User Interface in the Installation Guide — TCPCM4S on how to login to the
Admin UI. Refer to the Admin UI Guide for more details.

Teamcenter Product Cost Management Gateway for SAP S/4HANA - Preparation Guide, Teamcenter PCM Gateway for SAP S/4HANA 2403
4-1
© 2024 Siemens
 4. SAP Function Calls Used and Permissions Required

Caution:
The log file does not list the following "connector internal" calls:

• RFC_PING

• RFC_GET_FUNCTION_INTERFACE

• DDIF_FIELDINFO_GET

• SYSTEM_RESET_RFC_SERVER

4.2 UCON Blocklist

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

TCPCM4S is fully compatible with the above mentioned API changes done by SAP. Siemens PLM Software
provides a SAP Transport Package with wrapper functions to re-enable the communication between AIG
and SAP. It is not required to expose the RFC function modules by disabling the UCON Blocklist.

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 of
Client>; Caller Program :<Caller program from which RFC call is made>".

Example from TCPCM4S:

Error Message: RFC code = 4 (RFC_ABAP_MESSAGE) :: Incompatible

Call Rejected, see note 2295840; Called Incompatible
Function :RFC_GET_SAP_SYSTEM_PARAMETERS; Caller Program :nwpipe; Caller
Dest. :demchdc81!

More information and a list of BAPIs being blocked by UCON functionality can be downloaded via the
following OSS note:

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

4-2 Teamcenter Product Cost Management Gateway for SAP S/4HANA - Preparation Guide, Teamcenter PCM Gateway for SAP S/4HANA
2403
© 2024 Siemens
 UCON Blocklist

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 Support Center.

Teamcenter Product Cost Management Gateway for SAP S/4HANA - Preparation Guide, Teamcenter PCM Gateway for SAP S/4HANA 2403
4-3
© 2024 Siemens
 4. SAP Function Calls Used and Permissions Required

4-4 Teamcenter Product Cost Management Gateway for SAP S/4HANA - Preparation Guide, Teamcenter PCM Gateway for SAP S/4HANA
2403
© 2024 Siemens
 5. SAP Transport Packages for Teamcenter
Product Cost Management Gateway for SAP
S/4HANA Functionality
In order to implement enhanced SAP ABAP functionality provided by Siemens Industry Software, offers
SAP transport packages to add the required additional functionality to SAP.

A complete description of the Transport Packages can be found in the file <GS_ROOT>/var/template/sap/
TransportPackages/readme.txt. You will find the transport packages in the directory <GS_ROOT>/var/
template/sap/TransportPackages.

After importing a Transport Package, make sure the appropriate SAP users are allowed to use it.

The complete list of Transport Packages is documented in the API Documentation — TCPCM4S:

→ List of SAP Function Groups and Functions used by TCPCM4S

Caution:
Same as the code itself, the ABAP code TCPCM4S provides in the SAP transport packages may
change. If you are using such an ABAP please make sure to update it as well when TCPCM4S is
updated.
In order to check if you already have the latest package, do the following: In both your TCPCM4S
installations (the new and the old one), go to the directory <GS_ROOT>/var/template/sap/
TransportPackages. Open each zip file that contains an ABAP you implemented in your SAP (e.g.
TESISPLM_T4S_MISC.zip). Find there one file K900*.ET1 and one file R900*.ET1 each (e.g. the two
files K900123.ET1 and R900123.ET1). If you find exactly the same file names in the old and the
new TCPCM4S version, then everything is OK. If the number in the name (representing the ABAP
version number of this specific ABAP code), in the new TCPCM4S installation is higher than in the
old one, you have to update the ABAP in SAP to the new one.

Teamcenter Product Cost Management Gateway for SAP S/4HANA - Preparation Guide, Teamcenter PCM Gateway for SAP S/4HANA 2403
5-1
© 2024 Siemens
 5. SAP Transport Packages for Teamcenter Product Cost Management Gateway for SAP S/4HANA Functionality

5-2 Teamcenter Product Cost Management Gateway for SAP S/4HANA - Preparation Guide, Teamcenter PCM Gateway for SAP S/4HANA
2403
© 2024 Siemens
 6. Set Up to Trigger Data Transfer From SAP
to a target system
6.1 Overview
Common use case examples:

• An object or a structure is created first in SAP and needs to be transferred to a target system.

• Information on a SAP object is changed and needs to be updated on the corresponding target system
object.

The Z-Table is a transparent custom table in the SAP database. It is used for cases where data transfer
needs to be triggered from within SAP to a target system. Creating an entry for an object in the table is
usually triggered by a SAP event like "save material master data". On this event a user exit or some other
BADI functions catches the object data and can use ABAP functions to create an entry for that object.

• Import Transport Package TESISPLM_T4S_ZPTC

The Z-Table and ABAP functions to maintain it are provided by Siemens PLM. The Transport
Package TESISPLM_T4S_ZPTC to create Z-Table and ABAP functions is stored here: <GS_ROOT>/var/
template/sap/TransportPackages/TESISPLM_T4S_ZPTC.zip

All the functions and the database table itself are created within the namespace /TESISPLM/.

Caution:
Only the _INT/_INTERN functions should be used within SAP user exists or BADIs as they will
not perform additional RFC authority checks.

6.2 Table Definition /TESISPLM/ZPTC

Table attributes

Description Production Trigger Cache

Delivery Class A
Maintenance Check "Table maintenance allowed"

Teamcenter Product Cost Management Gateway for SAP S/4HANA - Preparation Guide, Teamcenter PCM Gateway for SAP S/4HANA 2403
6-1
© 2024 Siemens
 6. Set Up to Trigger Data Transfer From SAP to a target system

Table Fields

Dec. Check
Fields Key Int. Field Type Data Type Length places Table
MANDT X X MANDT CLNT 3 0 T000
ID X X INT4 INT4 10 0
OBJECT_TYP CHAR10 CHAR 10 0
OBJECT_ID CHAR80 CHAR 80 0
OBJECT_DESC CHAR255 CHAR 255 0
REASON1 CHAR255 CHAR 255 0
REASON2 CHAR255 CHAR 255 0
STATUS_E2S CHAR1 CHAR 1 0
ERROR_MSG1 CHAR255 CHAR 255 0
ERROR_MSG2 CHAR255 CHAR 255 0
ERROR_MSG3 CHAR255 CHAR 255 0
DELETED CHAR1 CHAR 1 0
CREATED_DATE DATE_ DATS 8 0
CREATED_TIME TIME_ TIMS 6 0
CREATED_USER ERNAM CHAR 12 0
CHANGED_DATE DATE_ DATS 8 0
CHANGED_TIME TIME_ TIMS 6 0
CHANGED_USER AENAM CHAR 12 0

Table Settings

Data Class APPL1

Size Category 9
Buffering Check "Buffering not allowed"

Number Range for Indexes

Caution:
The database table doesn´t contain out of the box configured indexes. Adding such indexes is a
customization step based on the individual use cases the table should be used for.

To assign IDs automatically on creation of table entries we need to define a number range object in SAP.
Please follow these steps:

1. Create the Number Range Object ZPTC (Transaction SNRO)

Number Length Domain: /TESISPLM/ZPTC

6-2 Teamcenter Product Cost Management Gateway for SAP S/4HANA - Preparation Guide, Teamcenter PCM Gateway for SAP S/4HANA
2403
© 2024 Siemens
 Z-Table ABAP Functions

Number range transaction: ZPTC

Warning %: 5

Buffer: 1

2. Create an interval (Transaction ZPTC):

Number: 01; From number: 0000000001; To number: 2147483640 (not external)

6.3 Z-Table ABAP Functions

The following functions are required with the Z-Table. Please also see SAP Function Calls Used and
Permissions Required.

/TESISPLM/ZPTC_INSERT
To insert one line into the table
/TESISPLM/ZPTC_INSERT_INTERN
To insert one line into the table - internal, not remote enabled call without RFC authority check -
should be used for SAP user exits calls only.
/TESISPLM/ZPTC_UPDATE
To update one line of the table.
/TESISPLM/ZPTC_UPDATE_INTERN
To update one line of the table - internal, not remote enabled call without RFC authority check -
should be used for SAP user exits calls only.
/TESISPLM/ZPTC_DELETE
To delete one line of the table.
/TESISPLM/ZPTC_DELETE_INTERN
To delete one line of the table - internal, not remote enabled call without RFC authority check -
should be used for SAP user exits calls only.
/TESISPLM/ZPTC_GET_DETAIL
To read one complete line of the table.
/TESISPLM/ZPTC_GET_DETAIL_INT
To read one complete line of the table - internal, not remote enabled call without RFC authority
check - should be used for SAP user exits calls only.
/TESISPLM/ZPTC_DYN_SEARCH
To read the ids of the table which fulfill a given pattern.
/TESISPLM/ZPTC_DYN_SEARCH_INT

Teamcenter Product Cost Management Gateway for SAP S/4HANA - Preparation Guide, Teamcenter PCM Gateway for SAP S/4HANA 2403
6-3
© 2024 Siemens
 6. Set Up to Trigger Data Transfer From SAP to a target system

To read the ids of the table which fulfill a given pattern - internal, not remote enabled call without
RFC authority check - should be used for SAP user exits calls only.
/TESISPLM/ZPTC_DYN_DELETE
To delete the lines of the table which fulfill a given pattern.
/TESISPLM/ZPTC_DYN_DELETE_INT
To delete the lines of the table which fulfill a given pattern - internal, not remote enabled call
without RFC authority check - should be used for SAP user exits calls only.
/TESISPLM/ZPTC_DYN_SEARCH
To read the ids of the table which fulfill a given pattern.
/TESISPLM/ZPTC_DYN_SEARCH_INT
To read the IDs of the table which fulfill a given pattern - internal, not remote enabled call without
RFC authority check - should be used for SAP user exits calls only.
/TESISPLM/ZPTC_DYN_DELETE
To delete the lines of the table which fulfill a given pattern.
/TESISPLM/ZPTC_DYN_DELETE_INT
To delete the lines of the table which fulfill a given pattern - internal, not remote enabled call
without RFC authority check - should be used for SAP user exits calls only.

6.4 SAP Event Trigger

All transfers of data to Teamcenter will be event triggered only. There is currently no option to provide
interactive user actions to initiate data transfer in SAP GUI. Therefore you need to extend available user
exits on user actions or else activate BADI in a desired way.

Example on User-Exit Modification

SAP provides user exists on some objects and actions. Please read the SAP documentation to find the
required user exit to support your use case.

This example explains the modification of the user exit on a Material Master save action (transaction
MM01 or MM02). The code checks if an entry in ZPTC for this Material Master already exists. The
function /TESISPLM/ZPTC_INSERT is used to create an entry. Otherwise the existing entry will be
updated by /TESISPLM/ZPTC_UPDATE:

DATA: r1(18) TYPE c,

r2(18) TYPE c,
l_matnr TYPE /tesisplm/zptc-object_id,
l_matnr_ext TYPE /tesisplm/zptc-object_id,
l_description(255) TYPE c,
l_blndouble TYPE string,
l_id_update(18) TYPE c,
l_str_zptc TYPE /tesisplm/zptc,

6-4 Teamcenter Product Cost Management Gateway for SAP S/4HANA - Preparation Guide, Teamcenter PCM Gateway for SAP S/4HANA
2403
© 2024 Siemens
 SAP Event Trigger

l_cross_plant_status type mara-mstae,

l_reason1 type char255,
l_reason2 type char255.

l_cross_plant_status = wmara-mstae.

*
* Generic User Exit for T4S Tests...
*
IF l_cross_plant_status = 40.

* Map Information we need from the Material

l_matnr = wmara-matnr.
l_description = 'Triggered by MM user exit!'.

* just some defaults

l_blndouble = 'false'.
l_id_update = ''.

* Check if the Object exists already in the Table.

CLEAR l_str_zptc.
SELECT SINGLE * INTO l_str_zptc FROM /tesisplm/zptc
WHERE status_e2s = '' AND
deleted = '' AND
object_typ = 'MATERIAL' AND
object_id = l_matnr.

IF NOT ( l_str_zptc IS INITIAL ).

l_id_update = l_str_zptc-id.
CONDENSE l_id_update NO-GAPS.

l_blndouble = 'true'.
ENDIF.

* H -> New material; V -> Changed material

* IF wstat-aktyp = 'V'.

IF l_blndouble = 'false'.

CALL FUNCTION '/TESISPLM/ZPTC_INSERT_INTERN'

EXPORTING
obj_typ = 'MATERIAL'
obj_id = l_matnr
obj_desc = l_description
reas1 = ''
reas2 = ''
stat_e2s = ''
err1 = ''
err2 = ''

Teamcenter Product Cost Management Gateway for SAP S/4HANA - Preparation Guide, Teamcenter PCM Gateway for SAP S/4HANA 2403
6-5
© 2024 Siemens
 6. Set Up to Trigger Data Transfer From SAP to a target system

err3 = ''
IMPORTING
e_return = r1
e_id = r2.

* if the entry exists already in the table

* (but was not modified yet), we update the entry
ELSE.

l_description = 'Updated by MM user exit!'.

CALL FUNCTION '/TESISPLM/ZPTC_UPDATE_INTERN'

EXPORTING
i_id = l_id_update
i_obj_typ = ''
i_obj_id = ''
i_obj_desc = l_description
i_rea1 = ''
i_rea2 = ''
i_stat_e2s = ''
i_err1 = ''
i_err2 = ''
i_err3 = ''
i_del = ''
i_reset = ''
IMPORTING
e_return = r1.

ENDIF.
ENDIF.

6-6 Teamcenter Product Cost Management Gateway for SAP S/4HANA - Preparation Guide, Teamcenter PCM Gateway for SAP S/4HANA
2403
© 2024 Siemens
 A. Glossary
A
ABAP
Advanced Business Application Programming: A proprietary programming language of SAP AG.

Admin
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 UI
Web based administrative user interface of the GS and BGS.

AIG
The entire Active Integration Gateway product family.

AIG_ROOT
Please see GS_ROOT and BGS_ROOT. This term is used if something applies to both the GS and BGS.

AI Object
Application Interface Object.

API
Application Programming Interface.

Apps
Please see GS.

AppServer
Application Server.

B
BAPI
Business Application Programming Interface: SAP interface that allows external programs to access SAP
objects and business processes.

Basic Gateway Service

The component of AIG that is responsible for Licensing, Logging and Job management.

Teamcenter Product Cost Management Gateway for SAP S/4HANA - Preparation Guide, Teamcenter PCM Gateway for SAP S/4HANA 2403
A-1
© 2024 Siemens
 A. Glossary

BGS
Basic Gateway Service.

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

BMIDE
The Teamcenter Business Modeler IDE (Integrated Development Environment).

BOM
Bill Of Materials: A list of the parts or components and their quantities that are required to build a
product.

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

BOP
Bill Of Process: A list of the operations and steps in a manufacturing process along with all their
instructions, consumed materials, resources, work places and machines.

C
CC Object
Collaboration Context Object.

CEP
Camstar Enterprise Platform.

Change Master
An SAP object containing the metadata for a change number. See also Engineering Change Master
(ECM).

Characteristic
An attribute of an SAP class.

CIO
Camstar Interoperability.

D
Data Carrier
See Vault.

A-2 Teamcenter Product Cost Management Gateway for SAP S/4HANA - Preparation Guide, Teamcenter PCM Gateway for SAP S/4HANA
2403
© 2024 Siemens
 Dataview
An extension to the Teamcenter RAC (and Active Workspace) that displays real-time Enterprise
Application data associated with a Teamcenter object.

Dataview mark-up
The language understood by the Dataview. The Dataview receives messages written in this language
from the T4x server, formatted as XML or JSON. Users do not normally see such messages, but they
may appear in log files or error messages. The "prop mapping" (e.g., t4s_prop_mapping_template.sd)
contains TCL commands that compose messages in the Dataview mark-up language.

DC_ROOT
The installation directory of Deployment Center (e.g., C:\Siemens\DeploymentCenter).

DCD
Data Collection Definition.

DIR
An SAP Document Info Record.

Document Key
The unique identifier of a Document Info Record consisting of the combination of Document Type,
Document Number, Document Part and Document Version.

Document Structure
A list of the document parts or components and their quantities that are required to assemble a
structured document, similar to a BOM.

E
EA
Enterprise Application.

ECM
An SAP Engineering Change Master.

ECN
Engineering Change Notice. Can also be called an Engineering Change Note, Engineering Change Order
(ECO), or just an Engineering Change (EC).

Enterprise Application
Any software or set of computer programs used by business users to perform various business functions
in the context of the current integration portfolio with Teamcenter.

Teamcenter Product Cost Management Gateway for SAP S/4HANA - Preparation Guide, Teamcenter PCM Gateway for SAP S/4HANA 2403
A-3
© 2024 Siemens
 A. Glossary

EPM
Enterprise Process Modeling.

ERP
Enterprise Resource Planning: The integrated management of main business processes such as
production planning, purchasing inventory, sales, marketing, finance, human resources, and more.

EWI
Electronic Work Instructions.

F
File Stream
A method of directly transferring an Original to SAP rather than using SAPftp or SAPhttp.

FN4S
Opcenter Connect FN for SAP S/4HANA.

G
Gateway Menu
A menu of Teamcenter Gateway functions that is available in the Teamcenter RAC.

Gateway Service
The component of AIG that manages the communication between Teamcenter and Enterprise
Applications and drives the Mapping process.

GRM
Generic Relationship Management: Provides a general way in which two objects can be associated via a
relationship.

GS
Gateway Service.

GS_ROOT
The installation directory of the GS (e.g., C:\Siemens\GS).

GUI
Graphical User Interface.

GUID
Globally Unique Identifier.

A-4 Teamcenter Product Cost Management Gateway for SAP S/4HANA - Preparation Guide, Teamcenter PCM Gateway for SAP S/4HANA
2403
© 2024 Siemens
 I
IDGEN
ID Generator: A mechanism to get an external ID from an Enterprise Application when assigning a
Teamcenter ID.

Inspection Plan
A list of characteristics to be inspected in an inspection operation and the associated test equipment to
be used.

iPPE
Integrated Product and Process Engineering: An SAP module that can be used to mange products with
many variants.

ITK
Integration Toolkit: A set of software tools provided by Siemens PLM Software that can be used to
integrate third-party or user-developed applications with Teamcenter.

J
JCO
Java Connector: An interface allowing Java applications to connect to SAP. In the context of , it is now
mostly replaced by the NetWeaver RFC SDK.

JDBC
Java Database Connectivity: An API for the programming language Java that defines how a client may
access a database.

Job
A collection of operations to be performed in the background rather than as part of a user’s interactive
session. The Teamcenter Gateway features asynchronous transfer, which is managed via a Job.

Job Agent
The component of the Gateway Service that executes Jobs.

Job Pool
A queue of all Jobs (whether pending, currently executing or completed) that is managed by the BGS.

Job Server
The component of the Basic Gateway Service that manages the Job Pool and distributes pending Jobs
to Job Agents for processing.

Teamcenter Product Cost Management Gateway for SAP S/4HANA - Preparation Guide, Teamcenter PCM Gateway for SAP S/4HANA 2403
A-5
© 2024 Siemens
 A. Glossary

JSON
JavaScript Object Notation: A lightweight data-interchange format. (See https://www.json.org/ for more
information.)

K
KPro
Knowledge Provider: A cross-application and cross-media technical information infrastructure within the
framework of SAP. See also Data Carrier.

L
LOV
List of Values: Teamcenter term for a list of selectable values for a property. See also Value Set.

M
Mapping
The part of the T4x configuration that contains the code to control the behavior of the data transfer
between Teamcenter and an Enterprise Application.

MFK
Multi-field key functionality in Teamcenter.

MM
An SAP Material Master.

MOM
Manufacturing Operations Management.

MRP
Manufacturing Resource Planning: A production planning, scheduling and inventory control system used
to manage manufacturing processes.

N
NCN
Non-Conformance Notification.

NetWeaver RFC SDK

Libraries allowing third-party applications to connect to SAP using RFCs. It can be obtained from the SAP
ONE Support Launchpad.

A-6 Teamcenter Product Cost Management Gateway for SAP S/4HANA - Preparation Guide, Teamcenter PCM Gateway for SAP S/4HANA
2403
© 2024 Siemens
 O
Object Key
A string containing the ID of an Enterprise Application object. If the identifier is a combination of
multiple keys, then the Object Key is a combination of those keys in a defined order and format.

Object Link
A relation between two SAP objects such as a Material Master and a Document Info Record.

Object Management Record

An SAP object that links an ECM to another SAP object such as a Material Master or Document Info
Record.

OOTB
Out Of The Box: A feature or function that works without any modification or customization.

Original
A representation of a file in SAP.

OSS Notes
An online patch service for SAP. A specific patch can be identified by its OSS Note number.

P
PIR
An SAP Purchase Info Record.

Portal Transaction
A transfer to an Enterprise Application that is not triggered by a workflow handler but via the Gateway
Menu.

R
RAC
The Teamcenter Rich Application Client. Also referred to as Rich Client or Portal.

Revision Level
An SAP attribute that uniquely identifies the particular version of an SAP Material Master or Document
Info Record associated with a Change Master.

RFC
Remote Function Call.

Teamcenter Product Cost Management Gateway for SAP S/4HANA - Preparation Guide, Teamcenter PCM Gateway for SAP S/4HANA 2403
A-7
© 2024 Siemens
 A. Glossary

S
SAP
SAP S/4HANA® or SAP Business Suite®.

SAP GUI
The client application for SAP.

SAP Logon
The application that a user runs to start the SAP GUI for a particular system. It may also refer to the
process of logging in to SAP in Teamcenter via .

SAP Portal iView URL

The URL of the SAP Integrated View (iView) that can be used to show SAP content in a browser window.

Session Log
A T4x logfile on the BGS containing log information for a specific Teamcenter session in which T4x
functions have been executed.

SSL
Secure Sockets Layer.

T
T4O_ROOT
See GS_ROOT.

T4S 4-Tier Client (SAP Lite)

A stripped down GS that is only able to open the SAP GUI on a Teamcenter 4-Tier Client.

T4x
The entire Teamcenter Gateway product family.

TAO
The ACE ORB: An open-source and standards-compliant real-time C++ implementation of CORBA
(Common Object Request Broker Architecture) based upon the Adaptive Communication Environment
(ACE).

TargetTypeName
The T4x internal name for a transaction type, such as MaterialMaster or DocumentInfoRecord.

A-8 Teamcenter Product Cost Management Gateway for SAP S/4HANA - Preparation Guide, Teamcenter PCM Gateway for SAP S/4HANA
2403
© 2024 Siemens
 TC
Teamcenter.

TCL
Tool Command Language: A high-level, general-purpose, interpreted, dynamic programming language.
(See https://www.tcl.tk/ for more information.)

TCPCM
Teamcenter Product Cost Management.

TCPCM4S
Teamcenter Product Cost Management Gateway for SAP S/4HANA.

TEM
Teamcenter Environment Manager.

TLS
Transport Layer Security.

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

Transaction Log
A T4x logfile on the BGS containing log information for a specific T4x transaction.

Transfer Window
The window that is displayed when triggering transactions via the Gateway Menu.

Transport Package
A file containing a set of functions that can be imported to SAP.

U
UOM
Unit of Measure.

URI
Uniform Resource Identifier: A string of characters in a specific format (such as a URL or URN)
that unambiguously identifies a particular resource. URIs are often used to identify configurations in

Teamcenter Product Cost Management Gateway for SAP S/4HANA - Preparation Guide, Teamcenter PCM Gateway for SAP S/4HANA 2403
A-9
© 2024 Siemens
 A. Glossary

Java and other languages. (See https://en.wikipedia.org/wiki/Uniform_Resource_Identifier for more

information.)

URL
Uniform Resource Locator: A URI that identifies a web resource by specifying its location on a computer
network and a mechanism for retrieving it.

URN
Uniform Resource Name: A URI that identifies a resource by name without specifying a location or access
method.

User Exit (SAP)

SAP program code that is called if an object like a Material Master has been changed or updated. In the
context of T4S, it is often used to initiate the process to trigger a transfer from SAP to Teamcenter.

User Log
A T4x logfile on the BGS containing log information written to a customized logchannel.

V
Value Set
SAP term for a list of selectable values for a Characteristic. See also LOV.

Vault
A server where an SAP Document Info Record Original is stored. Also called Data Carrier.

W
WBS
An SAP Work Breakdown Structure.

X
XML
Extensible Markup Language: A format for storing and transporting data that is both human-readable
and machine-readable.

XRT
XML Rendering Template: Also known as an XML Rendering Stylesheet, this is an XML document stored
in a dataset that defines how parts of the Teamcenter user interface are rendered. They are used for the
Rich Client as well as Active Workspace.

A-10 Teamcenter Product Cost Management Gateway for SAP S/4HANA - Preparation Guide, Teamcenter PCM Gateway for SAP S/
4HANA 2403
© 2024 Siemens
 Z
ZPTC
The short name for a Z-Table with the name /TESISPLM/ZPTC, which is used to trigger transfers from
SAP.

Z-Table
A custom SAP table ("Z" is a well-known prefix name for custom tables in the SAP world). In the context
of , this refers to the table /TESISPLM/ZPTC, which is used to trigger transfers from SAP.

Teamcenter Product Cost Management Gateway for SAP S/4HANA - Preparation Guide, Teamcenter PCM Gateway for SAP S/4HANA 2403
A-11
© 2024 Siemens