사용자 지정 구현에 대한 트랜잭션 기록

TransactionRecorder API를 사용하여 자동으로 트랜잭션으로 계산되지 않는 작업을 기록합니다

사용자 지정 코드를 사용하여 PDF 양식을 제출하거나, AEM Forms에서 제공하는 제출 메서드를 사용하는 대신 에이전트 UI 미리 보기 URL을 최종 사용자에게 전송하여 대화형 커뮤니케이션을 미리 보거나, 사용자 지정 방법을 사용하여 양식을 제출할 수 있습니다. 이전에 언급된 모든 작업 및 AEM Forms API의 사용자 지정 구현은 트랜잭션으로 간주되지 않습니다. AEM Forms은 트랜잭션과 같은 작업을 기록하기 위한 API TransactionRecorder 를 제공합니다.

트랜잭션을 기록하려면 표준 sling 서블릿을 작성하고 클라이언트에서 서블릿을 호출하여 트랜잭션을 기록합니다. AJAX 또는 기타 표준 방법을 사용하여 서블릿을 호출할 수 있습니다.

샘플 서버측 코드

아래 샘플 코드를 사용하여 사용자 지정 OSGi 번들을 사용하여 JAVA 클래스에서 TransactionRecorder API를 실행할 수 있습니다.

import com.adobe.aem.transaction.core.ITransactionRecorder;
import com.adobe.aem.transaction.core.model.TransactionRecord;
import com.adobe.aem.transaction.core.exception.TransactionException;
import com.adobe.aem.transaction.core.FormsTransactionConstants;

@Reference
private ITransactionRecorder transactionRecorder;
 
doPost (SlingHttpServletRequest request, SlingHttpServletResponse response) {
    transactionRecorder.startContext();
    TransactionRecord txRecord = extractTxRecordFromRequest(request); //extract transaction relevant data from request
    try {
        bool success = doBillableWork();
        if (success) {
            transactionRecorder.recordTransaction(txRecord);
        }
    } catch (Exception e) {
        //exception handling
    } finally {
        transactionRecorder.endContext();
    }
}

//Here, it is assumed that txInfo is passed in Stringified json form in the ajax call (in data parameter). You can pass txInfo from client in any way that you find suitable.
private TransactionRecord extractTxRecordFromRequest(SlingHttpServletRequest request) {
    BufferedReader bufferedReader = new BufferedReader(new InputStreamReader(request.getInputStream()));
    Map<String, Object> txDataMap = new HashMap<String, Object>();
    String txData = bufferedReader.readLine();
    JSONObject txInfo= new JSONObject(txData );
    try {
        String resourceType= txInfo.getString("resourceType");
        String transactionType = txInfo.getString("transactionType");
        Integer transactionCount = (Integer)txInfo.get("transactionCount");
        //Extract all the relevant tx record attributes similarly and pass them in Transaction Record constructor as per the java doc}
        return new TransactionRecord(transactionCount, transactionType, resourceType, ..);
    } catch (JSONException e) {
        //exception handling
    } finally {
        bufferedReader.close();
    }
}

샘플 클라이언트측 코드

아래 샘플 코드를 사용하여 TransactionRecorderAPI가 있는 서블릿을 호출할 수 있습니다.

$.ajax({
   type: 'POST',
   url: url, //servlet url
   contentType: 'application/json; UTF-8',
   data: JSON.stringify({transactionCount : 1, 
                        transactionType: "SUBMIT",
                        resourceType: "FORM",
                        resourceSubType: "ADAPTIVE-FORM"}),
   success: successHandler,
   error: faultHandler
})

이 페이지에서는