사용자 정의 구현을 위한 트랜잭션 레코드 record-a-transaction-for-custom-implementations

버전
문서 링크
AEM 6.5
여기 클릭
AEM as a Cloud Service
이 문서

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

사용자 지정 코드를 사용하여 PDF 양식을 제출할 수 있습니다. 또는 AEM Forms에서 제공하는 제출 방법 대신 사용자 지정 방법을 사용하여 양식을 제출합니다. 이전에 언급된 AEM Forms API의 모든 작업 및 사용자 지정 구현은 트랜잭션으로 계산되지 않습니다. AEM Forms은 트랜잭션과 같은 작업을 기록할 수 있도록 TransactionRecorder API를 제공합니다.

트랜잭션을 기록하려면 표준 슬링 서블릿을(를) 작성하고 클라이언트에서 서블릿을 호출하여 트랜잭션을 기록합니다. AJAX 또는 기타 모든 표준 메서드를 사용하여 서블릿을 호출할 수 있습니다.

샘플 서버측 코드 sample-server-sided-code

아래 샘플 코드를 사용하여 사용자 지정 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();
    }
}

샘플 클라이언트측 코드 sample-client-side-code

아래 샘플 코드를 사용하여 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
})
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab