T4S4  18.2 C7549 A21431
Teamcenter Gateway for SAP S/4HANA API Reference
T4X::CONNECTION2EA Namespace Reference

Functions

 checkConnection2EA ProductKey ?Mode? ?TargetType? ?TransAction?
 Read the current stored EA login info's and tests the connection. More...
 
 checkConnection2EA4Batchjob ProductKey SessionId ?Mode? ?TargetType? ?TransAction?
 Read the current stored EA login info's for a given Teamcenter Session Id and tests the connection. More...
 
 checkConnection2EA4Session ProductKey SessionId ?Mode? ?TargetType? ?TransAction?
 Read the current stored EA login info for a given Teamcenter Session Id and tests the connection. More...
 
 checkConnection2EA4Transaction ProductKey SessionId TransactionId ?Mode? ?TargetType? ?TransAction?
 Read the current stored EA login info for a given Teamcenter Session Id and tests the connection. More...
 
 deleteConnectionInfo ProdKey System ?SysArgs? ?Mode? ?TargetType? ?TransAction?
 deleteConnectionInfo deletes the EA connection info from the internal shared memory buffer More...
 
 getPreferredConnection2EA4Session ProductKey SessionId args
 Return the currently active EA system. More...
 
 readConnectionInfo4Session ProductKey SessionId ?Mode? ?TargetType? ?TransAction? args
 Read the currently stored EA connection info for a given Teamcenter Session Id. More...
 
 selectActiveConnection2EA ProductKey SessionId EASystem ?SysArgs? args
 defines given EA System as active More...
 
 setConnectionInfo ProdKey System LogonInfo ?Mode? ?TargetType? ?TransAction?
 setConnectionInfo stores the encrypted connection info into the internal shared memory buffer via the storeConnectionInfo function. More...
 
 setConnectString ProdKey System ConnectString
 setConnectString stores the connection info into the internal shared memory buffer More...
 
 testEALogin ProductKey args
 testEALogin reads the currently stored EA login info for the testscript env and tests the connection More...
 
 verifyConnection2EASystem4Session ProductKey SessionId EASystem ?SysArgs? ?Mode? ?TargetType? ?TransAction?
 Read the current stored EA login info's for a given Teamcenter Session Id, EA System and tests the connection. More...
 

Function Documentation

◆ checkConnection2EA()

T4X::CONNECTION2EA::checkConnection2EA   ProductKey ?Mode? ?TargetType? ?TransAction?  

Read the current stored EA login info's and tests the connection.

Parameters
ProductKeyproduct key (T4S, T4O, T4EA,...)
ModeTransfer mode like WORKFLOW, PORTAL, BATCH, RTP, LOV, ... default = "*" for all.
TargetTypeEA target object type like Item, BOM, ... default = "*" for all.
TransActiontransfer action in the GUI like CREATE, CHANGE, ... default = "*" for all.
Returns
LOGON_OK | LOGON_ERROR | MISSING_LOGIN_DATA

References T4S::CONNECTION2SAP::checkConnection2SAP(), T4X::CORE::getSessionLogChannel(), T4X::CORE::storeMessage2(), and tpwrite().

Referenced by testEALogin().

◆ checkConnection2EA4Batchjob()

T4X::CONNECTION2EA::checkConnection2EA4Batchjob   ProductKey SessionId ?Mode? ?TargetType? ?TransAction?  

Read the current stored EA login info's for a given Teamcenter Session Id and tests the connection.

Parameters
ProductKeyproduct key (T4S, T4O, T4EA,...)
SessionIdunique session ID for the users Teamcenter session
ModeTransfer mode like WORKFLOW, PORTAL, BATCH, RTP, LOV, ... default = "*" for all.
TargetTypeEA target object type like ITEM, BOM, ... default = "*" for all.
TransActiontransfer action in the GUI like CREATE, CHANGE, ... default = "*" for all.
Returns
LOGON_OK | LOGON_ERROR | MISSING_LOGIN_DATA | ERROR_NO_ACTIVE_CONNECTION

References checkConnection2EA4Session().

Referenced by T4S::CONNECTION2SAP::checkConnection2SAP4Batchjob().

◆ checkConnection2EA4Session()

T4X::CONNECTION2EA::checkConnection2EA4Session   ProductKey SessionId ?Mode? ?TargetType? ?TransAction?  

Read the current stored EA login info for a given Teamcenter Session Id and tests the connection.

Parameters
ProductKeyproduct key (T4S, T4O, T4EA,...)
SessionIdunique session ID for the users Teamcenter session
ModeTransfer mode like WORKFLOW, PORTAL, BATCH, RTP, LOV, ... default = "*" for all.
TargetTypeEA target object type like Item, BOM, ... default = "*" for all.
TransActiontransfer action in the GUI like CREATE, CHANGE, ... default = "*" for all.
Returns
LOGON_OK | LOGON_ERROR | MISSING_LOGIN_DATA

Referenced by checkConnection2EA4Batchjob(), checkConnection2EA4Transaction(), and T4S::CONNECTION2SAP::checkConnection2SAP4Session().

◆ checkConnection2EA4Transaction()

T4X::CONNECTION2EA::checkConnection2EA4Transaction   ProductKey SessionId TransactionId ?Mode? ?TargetType? ?TransAction?  

Read the current stored EA login info for a given Teamcenter Session Id and tests the connection.

Parameters
ProductKeyproduct key (T4S, T4O, T4EA,...)
SessionIdunique session ID for the users Teamcenter session
TransactionIdunique logfile name to log messages in the trans log file
ModeTransfer mode like WORKFLOW, PORTAL, BATCH, RTP, LOV, ... default = "*" for all.
TargetTypeEA target object type like ITEM, BOM, ... default = "*" for all.
TransActiontransfer action in the GUI like CREATE, CHANGE, ... default = "*" for all.
Returns
LOGON_OK | LOGON_ERROR | MISSING_LOGIN_DATA

References checkConnection2EA4Session().

Referenced by T4S::CONNECTION2SAP::checkConnection2SAP4Transaction().

◆ deleteConnectionInfo()

T4X::CONNECTION2EA::deleteConnectionInfo   ProdKey System ?SysArgs? ?Mode? ?TargetType? ?TransAction?  

deleteConnectionInfo deletes the EA connection info from the internal shared memory buffer

Parameters
ProdKeyproduct key (T4S, T4O, T4EA,...)
System
SysArgsadditional system info
ModeTransfer mode like WORKFLOW, PORTAL, BATCH, RTP, LOV, ... default = "*" for all.
TargetTypeEA target object type like Product, ... default = "*" for all.
TransActiontransfer action in the GUI like CREATE, CHANGE, ... default = "*" for all.
Returns
None

References tpco_closeSrvSession(), tpco_connectTo(), and tpco_shmdelete().

Referenced by T4S::CONNECTION2SAP::deleteConnectionInfo().

◆ getPreferredConnection2EA4Session()

T4X::CONNECTION2EA::getPreferredConnection2EA4Session   ProductKey SessionId args  

Return the currently active EA system.

getPreferredConnection2EA4Session reads the EA connection info for a given Teamcenter session id from the internal shared memory buffer and returns the active (preferred) connection information. If no active (preferred) connection for the Session Id is found, an additional check for the wild card SessionId is done. In the case of an error NOT_STORED is returned.

Parameters
ProductKeyproduct key (T4S, T4O, T4EA,...)
SessionIdunique session ID for the users Teamcenter session
argsunused
Returns
depending on product "System", "System@Client" or "NOT_STORED"

References tpco_shmget().

Referenced by readConnectionInfo4Session().

◆ readConnectionInfo4Session()

T4X::CONNECTION2EA::readConnectionInfo4Session   ProductKey SessionId ?Mode? ?TargetType? ?TransAction? args  

Read the currently stored EA connection info for a given Teamcenter Session Id.

readConnectionInfo4Session reads the EA connection info for a given Teamcenter session id from the internal shared memory buffer, so that it can be used for the next EA transaction.

Parameters
ProductKeyproduct key (T4S, T4O, T4EA,...)
SessionIdunique session ID for the users teamcenter session
ModeTransfer mode like WORKFLOW, PORTAL, BATCH, RTP, LOV, ... default = "*" for all.
TargetTypeEA target object type like Item, BOM, ... default = "*" for all.
TransActiontransfer action in the GUI like CREATE, CHANGE, ... default = "*" for all.
argsunused
Returns
"NOT_STORED", "IS_STORED" or "IS_STORED_FULL"

References getPreferredConnection2EA4Session(), T4X::CORE::getSessionLogChannel(), tpco_shmget(), and tpwrite().

◆ selectActiveConnection2EA()

T4X::CONNECTION2EA::selectActiveConnection2EA   ProductKey SessionId EASystem ?SysArgs? args  

defines given EA System as active

Parameters
ProductKeyproduct key (T4S, T4O, T4EA,...)
SessionIdunique session ID for the users Teamcenter session or if you specific "*" the default connection for all sessions.
EASystemname of the EA system to verify
SysArgs
argsunused
Returns
None

References T4X::CORE::getSessionLogChannel(), tpco_shmset(), and tpwrite().

Referenced by T4S::CONNECTION2SAP::selectActiveConnection2SAP(), testEALogin(), and verifyConnection2EASystem4Session().

◆ setConnectionInfo()

T4X::CONNECTION2EA::setConnectionInfo   ProdKey System LogonInfo ?Mode? ?TargetType? ?TransAction?  

setConnectionInfo stores the encrypted connection info into the internal shared memory buffer via the storeConnectionInfo function.

Parameters
ProdKeyproduct key (T4S, T4O, T4EA,...)
SystemIdentifier (name for an EA system)
LogonInfolist containing product specific logon values
ModeTransfer mode like WORKFLOW, PORTAL, BATCH, RTP, LOV, ... default = "*" for all.
TargetTypeEA target object type like Item, BOM, ... default = "*" for all.
TransActiontransfer action in the GUI like CREATE, CHANGE, ... default = "*" for all.
Returns
None

Referenced by T4S::CONNECTION2SAP::setConnectionInfo2(), and T4S::CONNECTION2SAP::setConnectionInfoPlain2().

◆ setConnectString()

T4X::CONNECTION2EA::setConnectString   ProdKey System ConnectString  

setConnectString stores the connection info into the internal shared memory buffer

Parameters
ProdKeyproduct key (T4S, T4O, T4EA,...)
SystemIdentifier (name for an EA system)
ConnectStringtechnical connection endpoint (e.g. a URL for a web service, a database connect string, a file name, etc.)
Returns
None

References tpco_shmset().

◆ testEALogin()

T4X::CONNECTION2EA::testEALogin   ProductKey args  

testEALogin reads the currently stored EA login info for the testscript env and tests the connection

This is a test procedure and should only be used in scripts!

Parameters
ProductKeyproduct key (T4S, T4O, T4EA,...)
argsunused
Returns
OK|ERROR

References checkConnection2EA(), and selectActiveConnection2EA().

Referenced by T4S::CONNECTION2SAP::testSAPLogin().

◆ verifyConnection2EASystem4Session()

T4X::CONNECTION2EA::verifyConnection2EASystem4Session   ProductKey SessionId EASystem ?SysArgs? ?Mode? ?TargetType? ?TransAction?  

Read the current stored EA login info's for a given Teamcenter Session Id, EA System and tests the connection.

Parameters
ProductKeyproduct key (T4S, T4O, T4EA,...)
SessionIdunique session ID for the users Teamcenter session
EASystemname of the EA system to verify
SysArgs- additional login info, e. g. SAP client
ModeTransfer mode like WORKFLOW, PORTAL, BATCH, RTP, LOV, ... default = "*" for all.
TargetTypeEA target object type like Item, BOM, ... default = "*" for all.
TransActiontransfer action in the GUI like CREATE, CHANGE, ... default = "*" for all. (currently ignored by T4EA)
Returns
LOGON_OK | LOGON_OK_PARTIAL | LOGON_ERROR | MISSING_LOGIN_DATA

References selectActiveConnection2EA().

Referenced by T4S::CONNECTION2SAP::verifyConnection2SAPSytem4Session().