Ansicht
Dokumentation

LCM_ESIGN_SEND - Maintain Outbound Communication for e-Sign

Vendor Master (General Section)   BAL Application Log Documentation  
This documentation is copyright by SAP AG.

Use this Business Add-In in CM-LT component to set the outbound communication to the service provider, who most likely uses a REST or SOAP API provided by a vendor.

Note before Implementation:

To create a BAdI implementation, you can use the transactions SE18 or SE19, or you can use the Custom Logic app in the front-end system. If you use the Custom Logic app, the following applies:

• The app provides a special ABAP language version ABAP for Key Users. This makes the implementation of BAdIs for business experts and implementation consultants easier.

• The app ensures that you can use only released interfaces.

If you use the transactions SE19 or SE18 to create a BAdI implementation, the implementation is not visible in the Custom Logic app.

If several BAdI implementations exist, the system runs through the implementations in the following order:

1. Implementations created in the transactions SE18 or SE19.
2. Implementation created in the Custom Logic app.

BAdI method documentation:

Use this method to prepare e-Signature envelope data and send it to the external service provider through a Web service request. The content and format of data to be prepared depends on the vendor service API (please ensure to consult the vendor’s API documentation). Using the keys provided as import parameters, additional information about the Legal Transaction and the Legal Documents, especially the binary content of the document for example, can be read.

Import parameters

LEGALTRANSACTIONUUID – This is the GUID of Legal Transaction to which the envelope has been attached. This parameter can be used to read additional Legal Transaction information through the CDS view A_LegalTransaction.

IT_LGLCNTNTMDOCUMENTUUID – This is the table of Legal Document GUID which contains documents to be sent by this envelope. This parameter can be used to read additional Legal Document information through the CDS view A_LegalDocument. Do make use of the public DMS (Document Management services) API to access binary content using the keys LGLCNTNTMDOCUMENTLINKEDOBJECT and LGLCNTNTMDOCUMENTLINKEDOBJKEY.

Changing Parameters

LCM_T_MESSAGE – This parameter is a reference to message container. Add any kind of messages (success or error) that may have occurred throughout the preparation or service request communication.

LGLCNTNTMSGNTRGRPLINKDOBJ – This GUID identifies the envelope with the external web service API. After successfully requesting the envelope, the system returns the GUID within this parameter. It can be used in later steps to receive status, send updates, and similar steps.

Please refer to the example class implementation CL_LCM_ESIGN_SEND_EXAMPLE related to this BAdI.

Addresses (Business Address Services)   BAL_S_LOG - Application Log: Log header data  
This documentation is copyright by SAP AG.

Length: 3102 Date: 20240523 Time: 204710     sap01-206 ( 62 ms )