Академический Документы
Профессиональный Документы
Культура Документы
TPM templates
Functional profiles
Trading partner profiles
Trading partner agreements
TPM administration settings
TPM runtime access
TPM UDFs
You access and create TPM template in TPM system by choosing Trading Partner Management >
Profiles > Templates
TPM template
o TPM template consists of unique set of values that are defined by the user. It is created for specific
business requirements. Each value in the template represents referential information that are defined as
per the business transaction. You can attach a template to multiple functional profile.
TPM Template
You access and create TPM template in TPM system by choosing Trading Partner Management >
Profiles > Functional Profiles
Functional profile
o The default key-value pairs defined in a template are applied to test and production values. You cannot
add a new key-value pair to an existing profile but you can edit any existing values in a profile. During
message mapping runtime, either the test or production value is returned based on the selected system
environment under Administration.
Parameters from
the applied
templates are
displayed here
o Functional profile can be independent or can be attached to a trading partner agreement. During runtime
based on the conditions in an agreement, the functional profiles values can be used for messages
mapping
o You can access functional profile during runtime either by calling an agreement or by directly calling a
Functional profile Name using predefined UDFs . For more information about UDFs, refer the TPM User
Defined Functions
The figure below describes a runtime message mapping scenario, wherein an Idoc
XML file is mapped to an EDI XML file using a functional profile that is defined as
per an agreement.
Use Case
For example, you can build a functional profile for processing transaction
requirements such as material codes, partner specific delimiters and so on.
You access Partner Profiles in TPM system by choosing Partners tab page.
Trading partner profile
o Trading partner profile provides a central access to the following partner related information and
configuration:
Identity and classification parameters such as partner name, partner type, classification details and so
on. This data also get passed to monitoring so that you can created User Defined Search Attributes
and perform a search based on these parameters.
Defining certificate rollover from NWA key store
Custom parameters such as functional profiles
Details on agreements that are defined for specific trading partners
Details of EDI run time parameters such as encoding, intending and so on that are used to configure
generic converter module
Partner Profile
Identity and EDI Message Certificates EDI Runtime Exceptional Custom Contacts and
classification Type and Ack Roll Over Parameters conditions via Parameters Documents
requirements agreements reference
The general tab page consists of information that are partner specific and the classification categories.
These details can be using during local message monitoring for searching EDI messages via UDS.
Below are the important fields and their description that needs to be configured
You should also create a Profile for your own organization. You can select Partner Type as self. This is
needed during runtime, while creating Agreements and also an essential part for monitoring.
This tab page you provide the details of the trading partners such as e-mail, phone, mobile and so on.
You can provide multiple contacts and provide a short description about the contact along with the
address in two separate fields.
You can provide short description on each saved documents and edit them as per your requirement.
Though TPM does not provides you a Document Management system, the reference to documents
provides you a central screen for accessing all partner related data.
There is a F4 help from which you can choose the standard agencies.
You can also define your own custom identifiers (for example, SupplierNo, CustomerNo and so on. )
Predefined UDFs in message mapping provides you the access to these identities (ie. you can provide
one identifier code, agency qualifier code and target qualifier code to get the right unique identifier value
for the partner.
Very Important: This is the core of TPM during runtime and monitoring . Please make sure you define
the correct values in identities. You cannot define same values for a given combination of Agency Code
and identifier for multiple partners.
Determine unique ID Define the
that has been agency Define the agency
assigned to the qualifier scheme that is
partner code implemented
This provides a consolidated view on messages that are getting exchanged between the trading partners
In the message format column press F4 and select the required EDI message format and select relevant
message type.
You can add the following EDI formats currently (EDIFACT, EANCOM, X12, TRADACOMS, Odette). The
values in the drop down will appear only if you imported the correct required content via EDI Content
Manager.
You can also select XML messages and manually type the Message Type and Version value. You can
use this feature to defined agreements based on XML and use the functional profile for different
conditions for XML related scenarios.
This information is not used during runtime however it is a mandatory step before defining an
agreement.
This functionality enables the processing of EDI acknowledgements, such as EDIFACT, EANCOM and
ANSI X12, for inbound and outbound EDI communications. Select and save the settings as per the
requirement that can be used during runtime.
For Inbound, settings are same as provided by EDI Separator receiver channel. You can configure it now
based on individual partners. For Outbound, values will be used by Generic Converter module during
time to set the corresponding fields in a EDI message.
In this tab page you can add functional profiles that are specific to a trading partner.
In the functional profile column press F4 and select the relevant functional profile and save the changes.
For more information about functional profiles, refer to the Functional profile slide.
By clicking the link you can only view the functional profile. As functional profiles are reusable and can
be used across multiple partners, you cannot change it from the partner screen.
This information is not used during run time but is an essential step if you want to define agreements.
You use this functionality to store partner agreements. You choose Create to create agreement and then
save the changes.
For more information about agreements, refer the Trading partner agreement slide.
You can define the automatic certificate Rollovers for NWA certificates in Profiles > Certificate section.
Currently, you can only view the certificate profiles related to a specific trading partner in the Certificate
Tab of Partner Profile. You can also add, edit and store certificates in Profiles > Certificate section.
By default, the expiry time of certificate is selected as Rollover time. You can customize this time
according to your need.
You cannot add/store a new certificate form this screen. You can only access the certificate that have
already been uploaded in NWA.
After RollOver, new certificate replace the old active certificate. You can also define the backup view to
archive the replaced certificate.
Time when
Time when
Certificate the validity
the
Name of the
certificate is
certificate
extended
expires
You access partner agreements in TPM system by choosing Agreements tab page.
Trading partner agreements
What is an agreement?
Agreement is conditional rule that can be defined in TPM. Based on the condition, 3 components can be
selected during runtime
1) Control Key to be used for this message/partner conversion [by generic Converter Module] (refer EDI
Content Manager documentation)
2) EDI parameters (converter module parameters based on EDI message type) [by
GenericConverterModule].
Agreements can be accessed in TPM via two different options. One via a separate Agreements tab and
other way is to access from the partner profile screen under Agreement tab. There is NO functional
difference. Only those agreements will appear under partner profiles Agreement tab that are related to
that partner. You can go to separate Agreement tab in case you want to search, maintain agreements in
bulk irrespective of partners.
o Direction (Inbound/Outbound)
Used by Generic
converter Module
Used during
Message
Mapping
2 3
Note: Functional Profiles can be selected only if you have already attached to the
partner profile. If agreement is Inbound, it displays the values from Sender
Partner. If it is outbound, it displays the values from Receiver Partner
What are typical use cases when I would like to use this agreement?
o You have a VAN scenario where you are sending/receiving data for multiple partners via single
communication channel but you would like to use different EDI runtime parameters for each partner (eg.
encoding, indent etc.)
o You would like to maintain all EDI related runtime parameters for a partner centrally even if they are
common so that you dont have to change it in converter modules during everytime there is a change
request. You can access trading partner management and change the parameters directly in TPM
configurations without redeploying the scenarios in runtime.
o You would like to maintain/access custom parameters (functional profiles) based on certain agreement
conditions.
o No, you can defined either of them or both based on your usecase. You can remove the value from EDI
parameter fields and leave them blank.
Control Key is a versioning mechanism available in EDI Content Manager through which runtime get to
know the ruleset version to be used for XML-EDI or EDI-XML version. SAP ships all the rules for
different EDI versions in default Control Key known as SAP or SAP-EANCOM. Users can customize
the standard ruleset definitions by creating their own Control Key (versions)
Current way of defining relation between runtime and Control Key is through Control Key Association
table and you can define the specific Control Key to be used by PI runtime scenarios. EDI converter
Module during runtime checks Control Key association table to find the right Control key to use for that
PI scenario.
New way of defining is via TPM based on the Agreements. If it is set, then converter module (if enabled
for TPM) takes the value as per agreement definition and does not access Control Key scenario
association table.
What are the special considerations to define EDI parameters in the agreement. How it is
accessed during runtime?
o You have to add TPMContentAccessModule in your configuration scenarios before the Generic
converter module. You need to add it either on the sender or receiver side depending on your
Inbound/Outbound EDI processing scenarios
o Value for Generic converter module parameter tpm.enable should be true
o You can define zero or more parameters depending on your usecase.
o Whenever you create a new agreement, default EDI values are displayed on the agreement
If the valuesscreen.
are blank,,
converter module will
replace it will the value
defined in module
context in integration
directory or will use the
default values during
runtime
Separate UDFs are available for accessing both the agreement conditions.
What are mandatory and optional partner parameters while defining partners in an
agreement?
o During Runtime, PI finds the partner name on the basis of incoming/outgoing EDI message from the
senderid+ qualifier and receiver id+qualifier fields and finds the matching partner names. Then it looks
for the matching agreement condition between two partners along with other condition parameters.
For example, If you have different sender/receivers id's for Test and Production, there are two options:
Create two separate agreement rows based on these different sender and/or receiver ids for Test and
Production (or define in Test and change in production). OR
Create a single agreement row and leave the identifier field blank so that same agreement/condition
can be used in both Test and Production
2) You are exchanging a bulk interchange with the partner having different messages and for all messages
except invoices ,you want to apply encoding A. However for Invoices you would like to use encoding B.
You can define two agreements for the same sender partner ,receiver partner and direction
combination. One with .* in message type and version and other one with Invoice specifically mentioned
in Message Type and/or Release
Important: If you are defining more than one agreement, make sure your definition is aligned with
the runtime behavior.
o PI runtime gives priority to exact matching agreement. So, in above case, if you define an agreement
with Invoice and the interchange contain only one or more invoices, then the invoice will be used. If you
have invoices as part of bulk interchange with different message types, then it is important that you
define agreement with .* and in this case specialization to invoice cannot be maintained.
o Runtime access the agreement in the following priority (for the same partners and direction) wherever
applicable Message Format -> Message Agency -> Message release -> Message Type -> Message
Subversion/Association Code -> Message Version
During runtime, information defined in the TPM can be accessed in the following
manner:
o You need to add TPMContentAccessModule in your Integration scenarios wherever you have EDI
document processing.
Important: You must use enable.edisepUsage parameter as a precautionary step, before using TPM content access
module parameter.
o Set enable.ediAckProfile to true. This parameter when it is set to true is required for applying the TPM
settings to EDI Separator Receiver channel. The module reads parameters from TPM related to EDI
acknowledgment settings and publishes them to PI processing pipe-line. This parameter needs to be set
for the TPMContentAccessModule only in the ICO(s) where EDI Separator receiver channel is used.
o Depending on the Inbound/Outbound EDI processing, you need to add this module either on sender or
receiver side respectively
o This module should be added before generic converter module. Set the value of module parameter
tpm.enable of genericConverterModule to true. It will then fetch the a) Control Key info and b) module
parameters info as per TPM agreement.
o Enable the checkbox Read From Dynamic header in EDI Seperator receiver channel to apply the TPM
settings.
Important: In case if you are using EDISearchParametersModule, then it should be used in order such that it is before
genericConverterModule and used after TPMContentAccessModule. It is recommended to use EDISearchParametersModule
as it enables monitoring based on sender ID, receiver ID, interchange number, and correlation number.
2) Enable acknowledgement related settings from TPM so that EDI Separator can
apply the settings.
You can create the UDS and enable search on the following parameters from TPM.
Sender Partner and Receiver Partner Information is set based on the sender and receiver ids from the
Inbound/Outbound EDI message
NOTE: While creating an UDS, you have to use the following Dynamic header namespace
http://sap.com/xi/XI/EDISeparator/EDISeparator
2014 SAP AG or an SAP affiliate company. All rights reserved. 39
TPM administration settings
For more information about TPM roles, refer assigning user roles for managing B2B
application in B2B Security Guide.
No part of this publication may be reproduced or transmitted in any form or for any purpose without the express permission of SAP AG or an
SAP affiliate company.
SAP and other SAP products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of SAP AG
(or an SAP affiliate company) in Germany and other countries. Please see http://global12.sap.com/corporate-en/legal/copyright/index.epx for additional
trademark information and notices.
Some software products marketed by SAP AG and its distributors contain proprietary software components of other software vendors.
These materials are provided by SAP AG or an SAP affiliate company for informational purposes only, without representation or warranty of any kind,
and SAP AG or its affiliated companies shall not be liable for errors or omissions with respect to the materials. The only warranties for SAP AG or
SAP affiliate company products and services are those that are set forth in the express warranty statements accompanying such products and
services, if any. Nothing herein should be construed as constituting an additional warranty.
In particular, SAP AG or its affiliated companies have no obligation to pursue any course of business outlined in this document or any related
presentation, or to develop or release any functionality mentioned therein. This document, or any related presentation, and SAP AGs or its affiliated
companies strategy and possible future developments, products, and/or platform directions and functionality are all subject to change and may be
changed by SAP AG or its affiliated companies at any time for any reason without notice. The information in this document is not a commitment,
promise, or legal obligation to deliver any material, code, or functionality. All forward-looking statements are subject to various risks and uncertainties
that could cause actual results to differ materially from expectations. Readers are cautioned not to place undue reliance on these forward-looking
statements, which speak only as of their dates, and they should not be relied upon in making purchasing decisions.