서비스 컨테이너

이 문서의 샘플 및 예제는 JEE 환경의 AEM Forms용입니다.

EJB 공급자와 같은 다양한 공급자를 사용하여 서비스 컨테이너에 있는 AEM Forms 서비스(암호화 서비스, 장기 및 단기 프로세스 등) 를 호출할 수 있습니다. EJB 공급자는 RMI/IIOP를 통해 AEM Forms 서비스를 호출할 수 있도록 합니다. 웹 서비스 공급자는 SOAP/HTTP 및 SOAP/JMS와 같은 표준을 사용하여 서비스를 웹 서비스(WSDL 생성)로 노출합니다.

다음 표에서는 AEM Forms 서비스를 프로그래밍 방식으로 호출할 수 있는 다양한 방법에 대해 설명합니다.

호출 메서드

설명

원격 통합

원격 통합을 통해 Flex 클라이언트가 서비스 작업을 호출할 수 있습니다. (AEM Forms에서 더 이상 사용되지 않는 AEM Forms 호출) AEM Forms Remoting을 참조하십시오.)

Java API

Java API는 AEM Forms 서비스를 호출할 수 있습니다. Java API는 클라이언트 라이브러리 및 Java 호출 API로 구성됩니다. ( Java API를 사용하여 AEM Forms 호출 을 참조하십시오.)

웹 서비스

AEM Forms은 SOAP/HTTP와 같은 웹 서비스 표준을 지원합니다. 서비스는 W3C에서 정의한 웹 서비스 표준을 준수하는 WSDL을 사용하여 웹 서비스로 노출될 수 있습니다.

.NET Framework 및 Sun™ Web Services SDK를 포함하여 모든 웹 서비스 스택에서 서비스를 호출할 수 있습니다. (웹 서비스를 사용하여 AEM Forms 호출을 참조하십시오.)

REST 요청

AEM Forms은 REST 요청을 지원합니다. 서비스는 HTML 페이지에서 직접 호출할 수 있습니다. (REST 요청을 사용하여 AEM Forms 호출을 참조하십시오.)

다음 그림은 AEM Forms 서비스를 프로그래밍 방식으로 호출할 수 있는 다른 방법을 시각적으로 보여줍니다.

노트

AEM Forms SDK를 사용하여 AEM Forms 서비스를 호출할 수 있는 클라이언트 애플리케이션을 만드는 것 외에도, 서비스 컨테이너에 배포할 수 있는 구성 요소를 만들 수 있습니다. 예를 들어, 프로세스에서 사용할 수 있는 사용자 지정 데이터 유형을 포함하는 은행 구성 요소를 만들 수 있습니다. 즉, com.adobe.idp.BankAccount 과 같은 데이터 유형을 만들 수 있습니다. 그런 다음 클라이언트 응용 프로그램에서 com.adobe.idp.BankAccount 인스턴스를 만들 수 있습니다.

서비스 컨테이너는 다음 기능을 제공합니다.

  • 다른 방법을 사용하여 AEM Forms 서비스를 호출할 수 있습니다. 모든 메서드를 사용하여 호출할 수 있도록 끝점을 설정하여 서비스를 구성할 수 있습니다.Remoting, Java API, 웹 서비스 및 REST (프로그래밍 방식으로 끝점 관리 를 참조하십시오.)

  • 메시지를 호출 요청이라는 정규화된 형식으로 변환합니다. 호출 요청은 클라이언트 애플리케이션(또는 다른 서비스)에서 서비스 컨테이너에 있는 서비스로 전송됩니다. 호출 요청에는 호출할 서비스의 이름 및 작업을 수행하는 데 필요한 데이터 값과 같은 정보가 포함되어 있습니다. 많은 서비스가 작업을 수행하는 데 문서를 필요로 합니다. 따라서 호출 요청에는 일반적으로 PDF 데이터, XDP 데이터, XML 데이터 등의 문서를 포함합니다.

  • 호출 요청을 적절한 서비스에 라우팅합니다(호출할 서비스의 이름은 호출 요청의 일부).

  • 호출자가 지정된 서비스 작업을 호출할 권한이 있는지 여부를 확인하는 등의 작업을 수행합니다. 호출 요청에 유효한 AEM Forms 사용자 이름과 암호가 포함되어야 합니다.

    서비스에 호출 요청을 보내는 방법에는 여러 가지가 있습니다. 또한 필요한 입력 값을 서비스에 보내는 방법에는 여러 가지가 있습니다. 예를 들어 Java API를 사용하여 PDF 문서가 필요한 서비스를 호출한다고 가정해 보겠습니다. 해당 Java 메서드에는 PDF 문서를 허용하는 매개 변수가 포함되어 있습니다. 이 경우 매개 변수의 데이터 유형은 com.adobe.idp.Document입니다. (Java API🔗를 사용하여 AEM Forms 서비스에 데이터 전달 을 참조하십시오.)

    감시 폴더를 사용하여 서비스를 호출하는 경우 구성된 감시 폴더에 파일을 배치할 때 호출 요청이 전송됩니다. 이메일을 사용하여 서비스를 호출하는 경우 이메일 메시지가 구성된 받은 편지함에 도달하면 호출 요청이 서비스로 전송됩니다.

    작업이 수행되면 서비스 컨테이너가 호출 응답을 다시 전송합니다. 호출 응답에는 작업 결과와 같은 정보가 포함되어 있습니다. 예를 들어 작업에서 PDF 문서를 수정하는 경우 호출 응답에 수정된 PDF 문서가 포함됩니다. 작업이 실패한 경우 호출 응답에 오류 메시지가 포함됩니다.

    호출 응답이 호출 요청을 보내는 것과 같은 방식으로 검색할 수 있습니다. 즉, Java API를 사용하여 호출 요청이 전송되는 경우 Java API를 사용하여 호출 응답을 검색할 수 있습니다. 예를 들어 작업에서 PDF 문서가 수정된다고 가정합니다. 서비스를 호출한 Java 메소드의 반환 값을 가져와 수정된 PDF 문서를 검색할 수 있습니다.

    긴 기간 프로세스가 호출되면 호출 응답에는 호출 요청과 연관된 식별자 값이 포함됩니다. 이 식별자 값을 사용하면 나중에 프로세스의 상태를 확인할 수 있습니다. 예를 들어, MortgageLoan의 장기간 서비스를 고려해 보십시오. 식별자 값을 사용하여 프로세스가 성공적으로 완료되었는지 확인할 수 있습니다. (인간 중심의 장기 프로세스 호출 참조)

    다음 다이어그램은 서비스를 호출하는 클라이언트 애플리케이션(Java API를 사용하는)을 보여줍니다.

    클라이언트 응용 프로그램이 서비스를 호출하는 경우 다음과 같은 세 가지 이벤트가 발생합니다.

    1. 클라이언트 응용 프로그램이 서비스에 호출 요청을 보냅니다.
    2. 서비스는 호출 요청에 지정된 작업을 수행합니다.
    3. 서비스 컨테이너는 클라이언트 응용 프로그램에 대한 호출 응답을 반환합니다.

참고 항목

AEM Forms 프로세스 이해

AEM Forms Remoting을 사용하여 AEM Forms 호출(AEM Forms에서 더 이상 사용되지 않음)

Java API를 사용하여 AEM Forms 호출

웹 서비스를 사용하여 AEM Forms 호출

인간 중심 장기 프로세스 호출

REST 요청을 사용하여 AEM Forms 호출

이 페이지에서는