+ All Categories
Home > Documents > January 2014 SAP NetWeaver Process Integration, business ... · B2B - Trading Partner Management...

January 2014 SAP NetWeaver Process Integration, business ... · B2B - Trading Partner Management...

Date post: 04-Feb-2021
Category:
Upload: others
View: 0 times
Download: 0 times
Share this document with a friend
48
B2B - Trading Partner Management (TPM) January 2014 SAP NetWeaver Process Integration, business-to-business add-on 1.0
Transcript
  • B2B - Trading Partner Management (TPM)

    January 2014

    SAP NetWeaver Process Integration, business-to-business add-on 1.0

  • © 2014 SAP AG or an SAP affiliate company. All rights reserved. 2

    Agenda

    TPM templates

    Functional profiles

    Trading partner profiles

    Trading partner agreements

    TPM administration settings

    TPM runtime access

    TPM UDFs

  • © 2014 SAP AG or an SAP affiliate company. All rights reserved. 3

    How to access TPM ?

    You follow the procedure below to access B2B TPM application:

    1. You need to assign user roles for managing the TPM tool. Without these roles being added

    to your user, you wouldn't have access to Trading Partner Management. For more

    information about required TPM roles, refer assigning user roles for managing B2B

    application in B2B Security Guide.

    2. Enter the URL format as http:/b2bic in the Web browser and logon to

    B2B Integration Cockpit application.

    3. To access Trading Partner Management tool, choose Trading Partner Management.

    4. Important:

    – Before referring this guide, make sure you are on the following SP and patch level of B2B components:

    B2B Add-On SP2

    o B2B ToolKit SP2 Patch 12

    o XI CONTENT B2B TOOLKIT 1.0 Patch 3

    o XI CONTENT B2B MAPPING KIT 1.0 Patch 2

    Note: It is important to install latest patch for PIB2BTOOLKIT on SP02 level to benefit from this TPM feature.

    https://websmp203.sap-ag.de/~sapidb/011000358700000125752013E/SAPNWB2B_Security_Guide.pdfhttps://websmp203.sap-ag.de/~sapidb/011000358700000125752013E/SAPNWB2B_Security_Guide.pdfhttps://websmp203.sap-ag.de/~sapidb/011000358700000125752013E/SAPNWB2B_Security_Guide.pdfhttps://websmp203.sap-ag.de/~sapidb/011000358700000125752013E/SAPNWB2B_Security_Guide.pdf

  • © 2014 SAP AG or an SAP affiliate company. All rights reserved. 4

    SCM/SRM

    Functional profiles (custom Parameters)

    Automatic Certificate Rollover

    UI

    ERP CRM Non-SAP system

    TPM User

    Search

    Partner Name Identifiers (DUNS, ILNS,

    Supplier No etc.) Classification Parameters: o Partner Type o Region o Industry o Parent Group Company

    Trading partner

    Management

    Create/Edit/View

    EDI Acknowledgment

    Parameters Agreements: Exceptional Rules based conditions

    Local Message Monitoring (UDS)

    ESR (Message Mapping)

    EDI Runtime Parameters

    Encoding, indent etc.

    Generic

    Converter

    Module

    EDI Separator

    receiver channel

    Agreements: Exceptional Rules based conditions

    TPM UDF

    NWA Key Store Party

    TPM Content Access Module

    Integration Visibility & MFM Monitoring

    Integration Directory

    Copy Import/Export QA/Dev/Prod

    Trading Partner Management-Partner Profile

    Contacts and Documents

  • TPM templates

    You access and create TPM template in TPM system by choosing Trading Partner Management >

    Profiles > Templates

  • © 2014 SAP AG or an SAP affiliate company. All rights reserved. 6

    TPM template

    What type of parameters are found in a template?

    o A template consists of the following parameters:

    o Display Name

    o Display Type

    o Code List

    o Property Key

    o Default Value

    TPM Template

    Property Key Default Value

    What is a 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.

  • © 2014 SAP AG or an SAP affiliate company. All rights reserved. 7

    TPM template

    What are Key-pair values?

    o A set of property keys and associated values that are defined in a template are known as Key-value

    Pairs. Important: These keys and values are case sensitive.

    What kind of templates can be created?

    o Templates are custom build forms that stores generic data which can be reusable. Based of your business

    requirement you can create different templates. Few examples are Material Code Mapping, EDI

    separators for partners, status Indicator fields etc. and , a template can consists of the following

    information:

  • Functional profiles

    You access and create TPM template in TPM system by choosing Trading Partner Management >

    Profiles > Functional Profiles

  • © 2014 SAP AG or an SAP affiliate company. All rights reserved. 9

    Functional profile

    What is a functional profile?

    o Functional profile is a collection of TPM templates that uses custom key value for that can be accessed

    during message mapping

    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”.

    You can configure the system

    environment in Administration

    >Configuration

  • 10 © 2014 SAP AG or an SAP affiliate company. All rights reserved.

    Define a name

    for the functional

    profile

    To add a template

    to a profile, choose

    Add

    Choose this button

    to apply templates

    to the profile

    Parameters from

    the applied

    templates are

    displayed here

  • © 2014 SAP AG or an SAP affiliate company. All rights reserved. 11

    What is the purpose of a functional profile?

    o You use functional profiles to group different templates. Functional profiles themselves can be reused

    across different partners.

    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 UDF’s . For more information about UDF’s, refer the TPM User

    Defined Functions

    Functional profile

  • © 2014 SAP AG or an SAP affiliate company. All rights reserved. 12

    Functional profile

    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.

  • Trading partner profiles

    You access Partner Profiles in TPM system by choosing Partners tab page.

  • © 2014 SAP AG or an SAP affiliate company. All rights reserved. 14

    Trading partner profile

    EDI Message

    Type and Ack

    requirements

    Exceptional

    conditions via

    agreements

    Add/ Edit/ View/ Copy/ Search

    Partner Profile

    Certificates

    Roll Over

    EDI Runtime

    Parameters

    Custom

    Parameters

    What is purpose of 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

    Identity and

    classification

    Contacts and

    Documents

    reference

  • © 2014 SAP AG or an SAP affiliate company. All rights reserved. 15

    General tab

    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.

    Define the partner

    details Provide

    classification of the

    trade

    Determine the Party

    Name (or attach existing

    Party) from Integration

    Directory

  • © 2014 SAP AG or an SAP affiliate company. All rights reserved. 16

    Contacts tab

    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.

    Note: This information is NOT used during runtime

  • © 2014 SAP AG or an SAP affiliate company. All rights reserved. 17

    Documents tab

    In this tab page you provide the references to existing documents

    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.

  • © 2014 SAP AG or an SAP affiliate company. All rights reserved. 18

    Identities tab

    You provide the details such as identifier, agency code, and agency scheme for identifying business

    partners.

    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.

    Define the agency

    scheme that is

    implemented

    Determine unique ID

    that has been

    assigned to the

    partner

    Define the

    agency

    qualifier

    code

  • © 2014 SAP AG or an SAP affiliate company. All rights reserved. 19

    Messages tab

    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.

  • © 2014 SAP AG or an SAP affiliate company. All rights reserved. 20

    EDI acknowledgement tab

    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.

    How to access information during runtime?

    You have to use TPMContentAccessModule as first module on the sender channel during runtime in

    your Integrated Configuration scenario. This module automatically read the EDI message information for

    sender and receiver identifiers, find the corresponding TPM Partners and fill the correct dynamic

    headers for acknowledgment processing as defined in TPM

    Enable the check box Read from dynamic headers in EDI Seperator receiver channel. If no values are

    there in dynamic headers, EDI Seperator receiver channel will use the current default configuration from

    the channel.

  • © 2014 SAP AG or an SAP affiliate company. All rights reserved. 21

    Functional profile tab

    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.

  • © 2014 SAP AG or an SAP affiliate company. All rights reserved. 22

    Agreements tab

    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.

  • © 2014 SAP AG or an SAP affiliate company. All rights reserved. 23

    Certificates tab

    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.

    Certificate

    Name

    Time when

    the

    certificate is

    extended

    Time when

    the validity

    of the

    certificate

    expires

  • Trading partner agreements

    You access partner agreements in TPM system by choosing Agreements tab page.

  • © 2014 SAP AG or an SAP affiliate company. All rights reserved. 25

    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].

    3) Functional Profile (custom key-value parameters) [through UDFs in Message Mapping] .

    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 profile’s 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.

  • © 2014 SAP AG or an SAP affiliate company. All rights reserved. 26

    Trading partner agreements

    What all parameters are included in condition?

    o Sender Partner Name (Mandatory) Sender Partner Unique Identifier (Optional)

    o Receiver Partner Name (Mandatory) Receiver Partner Unique Identifier (Optional)

    o Direction (Inbound/Outbound)

    o Message Type related Parameters (examples:. UN EDIFACT ORDERS 96A or .* EDIFACT .* )

  • © 2014 SAP AG or an SAP affiliate company. All rights reserved. 27

    Condition/Rules

    Parameter

    Response Returned if a

    condition Matches

    Used during

    Message

    Mapping

    Used by Generic

    converter Module

    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

    1

    2 3

  • © 2014 SAP AG or an SAP affiliate company. All rights reserved. 28

    Trading partner agreements

    Is agreement definition mandatory in a Partner Profile? What are the benefits?

    o No, it is optional. See use cases below

    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 don’t 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.

    Is it mandatory to define both EDI parameters and Functional Profile both in an

    agreement?

    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.

  • © 2014 SAP AG or an SAP affiliate company. All rights reserved. 29

    Trading partner agreements

    What is the relevance of Control Key in agreements?

    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.

  • © 2014 SAP AG or an SAP affiliate company. All rights reserved. 30

    Trading partner agreements

    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 screen.

    If the values 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

  • © 2014 SAP AG or an SAP affiliate company. All rights reserved. 31

    Trading partner agreements

    What are the options possible while defining an agreement?

    o While defining, agreement has two parts. One (Marked as A) is mandatory and other (Marked as B on

    next slide) is optional

    o Both can be defined together. During PI runtime (for converter module parameters), only A will be used

    o During Functional profile Access from Message Mapping, you can access parameters based on either A

    or B

    A

  • © 2014 SAP AG or an SAP affiliate company. All rights reserved. 32

    B

    Separate UDFs are available for accessing both the agreement conditions.

    What is the usecase of Optional Agreement Option B?

    In case you would like to access agreement (and hence) Functional Profile on basis of standard PI

    Parameters in the agreement condition

    Trading partner agreements

  • © 2014 SAP AG or an SAP affiliate company. All rights reserved. 33

    Trading partner agreements

    What are mandatory and optional partner parameters while defining partners in an

    agreement?

    o Partner Name is mandatory while identifiers are optional.

    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

  • © 2014 SAP AG or an SAP affiliate company. All rights reserved. 34

    Trading partner agreements

    What is the best way of defining message type in an agreement condition?

    o Depending on your usecase, TPM agreement condition is completely flexible. You can define the agreement

    with exact matching values of an incoming/outgoing EDI payload or you can make it flexible by defining

    fields as *.

    o If you are defining strictly, then make sure the incoming/outgoing EDI document exactly matches with the

    EDI message definition in agreement otherwise runtime will not be able to access the correct agreement.

    o Important :If you have a bulk interchange of different message types together, make sure you define “.* ” in

    Message Type and Message Version field. Agreement condition can be defined on an interchange level (and

    not on individual message level)

    o If you have a bulk Interchange with same message types in it, you can define the agreement with exact

    message release version or “ .* ”. Both ways are accepted.

    o Tip: If you want to use same EDI Parameters and Functional Profile parameters for the same Partner,

    direction and EDI Format, it is recommended to use “.* ” in Message release and version field.

  • © 2014 SAP AG or an SAP affiliate company. All rights reserved. 35

    Trading partner agreements

    Example usecases where you may need to defined more than one agreement for the

    same partner and direction but for different message types:

    1) Either you are exchanging different EDI formats with the partner (eg. EDIFACT and X12) and for each

    you have to maintain a different converter module and/or functional profile parameter values.

    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

  • TPM runtime access

  • © 2014 SAP AG or an SAP affiliate company. All rights reserved. 37

    TPM runtime access

    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.

  • © 2014 SAP AG or an SAP affiliate company. All rights reserved. 38

    TPM runtime access - monitoring

    TPMContentAccessModule when added does the following:

    1) Enable monitoring related parameters in XI message headers so that you can

    create UDS in local message monitoring and enable search. (See Next Slide)

    2) Enable acknowledgement related settings from TPM so that EDI Separator can

    apply the settings.

    3) Enable module related EDI parameters as defined in TPM agreement

  • © 2014 SAP AG or an SAP affiliate company. All rights reserved. 39

    TPM runtime access - monitoring

    o PartnerName

    o PartnerType

    o PartnerIndustry

    o PartnerRegion

    o PartnerParentGroup

    o PartnerPIParty

    o ReceiverPartnerName

    o ReceiverPartnerType

    o ReceiverPartnerIndustry

    o ReceiverPartnerRegion

    o ReceiverPartnerParentGroup

    o ReceiverPartnerPIParty

    o SenderPartnerName

    o SenderPartnerType

    o SenderPartnerIndustry

    o SenderPartnerRegion

    o SenderPartnerParentGroup

    o SenderPartnerPIParty

    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

    Partner Name information is set based on the following:

    1) For Inbound EDI messages, sender id is considered

    2) For Outbound messages, receiver id is considered.

    NOTE: While creating an UDS, you have to use the following Dynamic header namespace

    http://sap.com/xi/XI/EDISeparator/EDISeparator

  • TPM administration settings

    You access administration settings in TPM system by choosing Administration tab

  • © 2014 SAP AG or an SAP affiliate company. All rights reserved. 41

    Administration

    You can enable the change log

    You can export/import the TPM configuration

    settings in the form of a file.

    Important: Before Importing the TPM content

    on a different system landscape, make sure

    corresponding directory content is already

    transported.

    Important: According to current behavior,

    when you import a TPM configuration file into

    other system (eg. trasferring from Dev to QA or

    QA to Production) in the landscape, all existing

    data/information is replaced by the content

    included in the current import file i.e. it

    completely overwrites the existing data.

  • Appendix

  • © 2014 SAP AG or an SAP affiliate company. All rights reserved. 43

    Assigning user roles for managing the TPM tool

    For more information about TPM roles, refer assigning user roles for managing B2B

    application in B2B Security Guide.

    https://websmp203.sap-ag.de/~sapidb/011000358700000125752013E/SAPNWB2B_Security_Guide.pdfhttps://websmp203.sap-ag.de/~sapidb/011000358700000125752013E/SAPNWB2B_Security_Guide.pdfhttps://websmp203.sap-ag.de/~sapidb/011000358700000125752013E/SAPNWB2B_Security_Guide.pdf

  • © 2014 SAP AG or an SAP affiliate company. All rights reserved. 44

    TPM UDF’s Description Arguments

    getParty

    Returns the Integration

    directory Party name for

    given values

    agency - Agency Qualifier Code

    scheme - Agency Scheme

    partyIdentifier - Identifier Name

    getPartyID Returns the Identifier value

    for a given Party , agency

    qualifier code and agency

    scheme

    partyName- Party Name

    agency – Agency Name

    scheme – Agency Scheme

    getAgreementID

    Returns the TPM agreement

    ID for given PI parameters.

    The values should match

    exactly as defined in

    agreement

    senderParty – Sender Partner Identifier

    senderQual – Sender Partner Agency qualifier code

    receiverParty – Receiver Partner Identifier

    receiverQual – Receiver Partner Agency qualifier code

    senderService – Sender Business Component

    receiverService – Receiver Business Component

    interf – Interface

    namespace – Interface Namespace

    getAgreementID Choose this UDF if you need

    to retrieve parameters such

    as senderID, receiverID, and

    so on.

    senderID – Sender Partner Identifier

    senderIDQual – Sender Partner Agency Qualifier Code

    receiverID – Receiver Partner Identifier

    receiverIDQual – Receiver Partner Agency Qualifier Code

    msg_protc – Message Format

    msg_type – Message type

    msg_ver – Message version

    msg_rel – Message release

    msg_agency – Message agency

    msg_subver – Message subversion

    direction- Message direction

    TPM User Defined Functions (UDF)

  • © 2014 SAP AG or an SAP affiliate company. All rights reserved. 45

    TPM UDF’s Description Arguments

    getAgreementID Returns the TPM agreement

    ID for given Partner

    Parameters. The values

    should match exactly as

    defined in agreement

    senderProfileID – Sender Partner name

    receiverProfileID – Receiver Partner Name

    msg_protc –Message format

    msg_type – Message type

    msg_ver – Message version

    msg_subver – Message subversion

    msg_rel – message release

    msg_agency – Message Agency

    direction – Message direction

    getFunctionalProfileName Returns Functional Profile

    name for the given agreement

    ID as defined in TPM. To be

    used with getAgreementID

    function

    agreementID – Agreement ID

    getFunctionalProfileProperty Returns value of a given

    functional Profile’s key

    profileName – Functional Profile name

    keyName – key name as defined in functional profile

    getSystemEnvironment Returns the current activated

    system environment test or

    production from TPM.

    getIdentity Returns the required identity

    for the given partner ID and

    Qualifier code

    sourceID – Partner Identifier

    sourceQual – Source partner qualifier agency code

    targetQual – Target partner qualifier agency code

    TPM User Defined Functions (UDF)

  • © 2014 SAP AG or an SAP affiliate company. All rights reserved. 46

    1. senderID – Sender Partner Identifier

    2. senderIDQual – Sender Partner Agency Qualifier Code

    3. receiverID – Receiver Partner Identifier

    4. receiverIDQual – Receiver Partner Agency Qualifier Code

    5. msg_protc – Message Format

    6. msg_type – Message type

    7. msg_ver – Message version

    8. msg_rel – Message release

    9. msg_agency – Message agency

    10. msg_subver – Message subversion

    11. direction- Message direction

    Example- Accessing TPM information using UDF

    getAgreementID

  • © 2014 SAP AG or an SAP affiliate company. All rights reserved.

    Thank you

  • © 2014 SAP AG or an SAP affiliate company. All rights reserved. 48

    © 2014 SAP AG or an SAP affiliate company.

    All rights reserved.

    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.

    National product specifications may vary.

    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 AG’s 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.

    http://global12.sap.com/corporate-en/legal/copyright/index.epxhttp://global12.sap.com/corporate-en/legal/copyright/index.epxhttp://global12.sap.com/corporate-en/legal/copyright/index.epxhttp://global12.sap.com/corporate-en/legal/copyright/index.epxhttp://global12.sap.com/corporate-en/legal/copyright/index.epx

Recommended