끝점 레지스트리 서비스 정보
Endpoint Registry 서비스는 끝점을 프로그래밍 방식으로 관리하는 기능을 제공합니다. 예를 들어 다음 유형의 끝점을 서비스에 추가할 수 있습니다.
EJB
SOAP
감시 폴더
이메일
(AEM Forms에 사용되지 않음) 원격
작업 관리자
SOAP, EJB 및 (JEE의 AEM Forms에 사용되지 않음) 원격 끝점은 활성화된 각 서비스에 대해 자동으로 생성됩니다. SOAP 및 EJB 종단점은 모든 서비스 작업에 대해 SOAP 및 EJB를 사용으로 설정합니다.
원격 끝점을 사용하면 Flex 클라이언트가 끝점이 추가된 AEM Forms 서비스에서 작업을 호출할 수 있습니다. 종단점과 동일한 이름의 Flex 대상이 만들어지고 Flex 클라이언트는 해당 대상을 가리키는 RemoteObjects를 만들어 관련 서비스에서 작업을 호출할 수 있습니다.
전자 메일, 작업 관리자 및 감시 폴더 끝점은 서비스의 특정 작업만 노출합니다. 이러한 끝점을 추가하려면 호출할 메서드를 선택하고, 구성 매개 변수를 설정하고, 입력 및 출력 매개 변수 매핑을 지정하는 두 번째 구성 단계가 필요합니다.
TaskManager 끝점을 카테고리. 그런 다음 이러한 카테고리는 TaskManager를 통해 Workspace에 노출되며 최종 사용자는 분류되는 TaskManager 종단점을 볼 수 있습니다. Workspace 내에서 최종 사용자는 탐색 창에 이러한 카테고리를 볼 수 있습니다. 각 카테고리 내의 종단점은 Workspace의 프로세스 시작 페이지에서 프로세스 카드로 표시됩니다.
Endpoint Registry 서비스를 사용하여 다음 작업을 수행할 수 있습니다.
EJB 끝점을 추가합니다. (자세한 내용은 EJB 끝점 추가)
SOAP 끝점을 추가합니다. (자세한 내용은 SOAP 끝점 추가)
감시 폴더 끝점 추가(참조) 감시 폴더 끝점 추가)
전자 메일 끝점을 추가합니다. (자세한 내용은 전자 메일 끝점 추가)
원격 끝점을 추가합니다. (자세한 내용은 원격 끝점 추가)
TaskManager 끝점 추가( TaskManager 끝점 추가)
끝점 수정(참조) 끝점 수정)
끝점 제거(참조) 끝점 제거 중)
끝점 커넥터 정보 검색(참조) 끝점 커넥터 정보 검색)
AEM Forms Java API를 사용하여 프로그래밍 방식으로 EJB 엔드포인트를 서비스에 추가할 수 있습니다. EJB 끝점을 서비스에 추가하면 클라이언트 응용 프로그램이 EJB 모드를 사용하여 서비스를 호출할 수 있습니다. 즉, AEM Forms을 호출하는 데 필요한 연결 속성을 설정할 때 EJB 모드를 선택할 수 있습니다. (자세한 내용은 연결 속성 설정)
웹 서비스를 사용하여 EJB 끝점을 추가할 수 없습니다.
일반적으로 EJB 엔드포인트는 기본적으로 서비스에 추가됩니다. 그러나 프로그래밍 방식으로 배치된 프로세스 또는 EJB 엔드포인트가 제거되고 다시 추가해야 할 때 EJB 엔드포인트를 추가할 수 있습니다.
서비스에 EJB 끝점을 추가하려면 다음 작업을 수행합니다.
EndpointRegistry Client
개체.프로젝트 파일 포함
개발 프로젝트에 필요한 파일을 포함합니다. 프로젝트의 클래스 경로에 다음 JAR 파일을 추가해야 합니다.
이러한 JAR 파일의 위치에 대한 자세한 내용은 AEM Forms Java 라이브러리 파일 포함.
EndpointRegistry 클라이언트 개체 만들기
프로그래밍 방식으로 EJB 엔드포인트를 추가하려면 먼저 EndpointRegistryClient
개체.
EJB 끝점 속성 설정
서비스에 대한 EJB 끝점을 생성하려면 다음 값을 지정합니다.
EJB
.*
). 그러나 모든 서비스 작업을 호출하는 대신 특정 작업을 지정하려면 와일드카드 문자( *
).EJB 끝점 만들기
EJB 끝점 속성을 설정한 후 서비스에 대한 EJB 끝점을 생성할 수 있습니다.
엔드포인트 활성화
새 끝점을 만든 후 활성화해야 합니다. 끝점을 활성화하면 이 엔드포인트를 사용하여 서비스를 호출할 수 있습니다. 끝점을 활성화하면 관리 콘솔 내에서 볼 수 있습니다.
추가 참조
Java API를 사용하여 EJB 엔드포인트를 추가합니다.
프로젝트 파일을 포함합니다.
Java 프로젝트의 클래스 경로에 adobe-livecycle-client.jar와 같은 클라이언트 JAR 파일을 포함합니다. (
EndpointRegistry 클라이언트 개체를 만듭니다.
ServiceClientFactory
연결 속성을 포함하는 객체입니다.EndpointRegistryClient
생성자를 사용하여 객체를 전달하고 ServiceClientFactory
개체.EJB 끝점 속성을 설정합니다.
CreateEndpointInfo
생성자를 사용하여 개체를 작성합니다.CreateEndpointInfo
개체 setConnectorId
메서드 및 문자열 값 전달 EJB
.CreateEndpointInfo
개체 setDescription
메서드를 사용하여 끝점을 설명하는 문자열 값을 전달합니다.CreateEndpointInfo
개체 setName
메서드를 사용하여 이름을 지정하는 문자열 값을 전달합니다.CreateEndpointInfo
개체 setServiceId
메서드를 사용하여 서비스 이름을 지정하는 문자열 값을 전달합니다.CreateEndpointInfo
개체 setOperationName
메서드를 사용하여 작업 이름을 지정하는 문자열 값을 전달합니다. SOAP 및 EJB 끝점에 대해 와일드카드 문자( *
)을 포함할 수 없습니다.EJB 끝점을 생성합니다.
를 호출하여 끝점을 만듭니다 EndpointRegistryClient
개체 createEndpoint
메서드 및 전달 CreateEndpointInfo
개체. 이 메서드는 Endpoint
새 EJB 엔드포인트를 나타내는 객체입니다.
끝점을 활성화합니다.
를 호출하여 끝점을 활성화합니다 EndpointRegistryClient
개체의 활성화 메서드 및 전달 Endpoint
반환되는 개체 createEndpoint
메서드를 사용합니다.
추가 참조
빠른 시작: Java API를 사용하여 EJB 엔드포인트 추가
AEM Forms Java API를 사용하여 프로그래밍 방식으로 서비스에 SOAP 엔드포인트를 추가할 수 있습니다. SOAP 끝점을 추가하면 클라이언트 응용 프로그램이 SOAP 모드를 사용하여 서비스를 호출하도록 합니다. 즉, AEM Forms을 호출하는 데 필요한 연결 속성을 설정할 때 SOAP 모드를 선택할 수 있습니다.
웹 서비스를 사용하여 SOAP 끝점을 추가할 수 없습니다.
일반적으로 SOAP 엔드포인트는 기본적으로 서비스에 추가되지만, 프로그래밍 방식으로 배포된 프로세스에 SOAP 엔드포인트를 추가하거나 SOAP 엔드포인트를 제거한 후 다시 추가해야 하는 경우 SOAP 엔드포인트를 추가할 수 있습니다.
서비스에 SOAP 끝점을 추가하려면 다음 작업을 수행합니다.
EndpointRegistryClient
개체.프로젝트 파일 포함
개발 프로젝트에 필요한 파일을 포함하십시오. Java를 사용하여 클라이언트 응용 프로그램을 만드는 경우 필요한 JAR 파일을 포함하십시오. 웹 서비스를 사용하는 경우 프록시 파일을 포함해야 합니다.
프로젝트의 클래스 경로에 다음 JAR 파일을 추가해야 합니다.
SOAP 끝점을 만들려면 이러한 JAR 파일이 필요합니다. 그러나 SOAP 종단점을 사용하여 서비스를 호출하는 경우에는 JAR 파일을 추가해야 합니다. AEM Forms JAR 파일에 대한 자세한 내용은 AEM Forms Java 라이브러리 파일 포함.
EndpointRegistry 클라이언트 개체 만들기
서비스에 SOAP 엔드포인트를 프로그래밍 방식으로 추가하려면 EndpointRegistryClient
개체.
SOAP 끝점 특성 설정
서비스에 SOAP 끝점을 추가하려면 다음 값을 지정합니다.
SOAP
.*
). 그러나 모든 서비스 작업을 호출하는 대신 특정 작업을 지정하려면 와일드카드 문자( *
).SOAP 끝점 만들기
SOAP 끝점 특성을 설정한 후 SOAP 끝점을 만들 수 있습니다.
엔드포인트 활성화
새 끝점을 만든 후 활성화해야 합니다. 엔드포인트가 활성화되면 서비스를 호출하는 데 사용할 수 있습니다. 엔드포인트를 활성화하면 관리 콘솔 내에서 볼 수 있습니다.
추가 참조
Java API를 사용하여 서비스에 SOAP 엔드포인트를 추가합니다.
프로젝트 파일을 포함합니다.
Java 프로젝트의 클래스 경로에 adobe-livecycle-client.jar와 같은 클라이언트 JAR 파일을 포함합니다.
EndpointRegistry 클라이언트 개체를 만듭니다.
ServiceClientFactory
연결 속성을 포함하는 객체입니다.EndpointRegistryClient
생성자를 사용하여 객체를 전달하고 ServiceClientFactory
개체.SOAP 끝점 특성을 설정합니다.
CreateEndpointInfo
생성자를 사용하여 개체를 작성합니다.CreateEndpointInfo
개체 setConnectorId
메서드 및 문자열 값 전달 SOAP
.CreateEndpointInfo
개체 setDescription
메서드를 사용하여 끝점을 설명하는 문자열 값을 전달합니다.CreateEndpointInfo
개체 setName
메서드를 사용하여 이름을 지정하는 문자열 값을 전달합니다.CreateEndpointInfo
개체 setServiceId
메서드를 사용하여 서비스 이름을 지정하는 문자열 값을 전달합니다.CreateEndpointInfo
개체 setOperationName
메서드 및 작업 이름을 지정하는 문자열 값 전달 SOAP 및 EJB 끝점에 대해 와일드카드 문자( *
)을 포함할 수 없습니다.SOAP 끝점을 만듭니다.
를 호출하여 끝점을 만듭니다 EndpointRegistryClient
개체 createEndpoint
메서드 및 전달 CreateEndpointInfo
개체. 이 메서드는 Endpoint
새 SOAP 끝점을 나타내는 개체입니다.
끝점을 활성화합니다.
를 호출하여 끝점을 활성화합니다 EndpointRegistryClient
개체의 enable 메서드 및 전달 Endpoint
반환되는 개체 createEndpoint
메서드를 사용합니다.
추가 참조
빠른 시작: Java API를 사용하여 SOAP 엔드포인트 추가
AEM Forms Java API를 사용하여 프로그래밍 방식으로 감시 폴더 엔드포인트를 서비스에 추가할 수 있습니다. 감시 폴더 종단점을 추가하면 사용자가 폴더에 파일(예: PDF 파일)을 배치할 수 있습니다. 파일이 폴더에 배치되면 구성된 서비스가 호출되어 파일을 조작합니다. 서비스가 지정된 작업을 수행하면 수정된 파일이 지정된 출력 폴더에 저장됩니다. 감시 폴더는 고정된 속도 간격으로 또는 매주 월요일, 수요일, 금요일 정오처럼 크론 스케줄로 스캔되도록 구성됩니다.
Observed Folder 엔드포인트를 서비스에 프로그래밍 방식으로 추가할 목적으로는 다음 단기 프로세스를 고려하십시오. EncryptDocument. (자세한 내용은 AEM Forms 프로세스 이해)
이 프로세스는 비보안 PDF 문서를 입력 값으로 수락한 다음 비보안 PDF 문서를 암호화 서비스의 EncryptPDFUsingPassword
작업. PDF 문서는 암호로 암호화되며, 암호로 암호화된 PDF 문서는 이 프로세스의 출력 값입니다. 입력 값의 이름(비보안 PDF 문서)은 InDoc
그리고 데이터 유형은 다음과 같습니다. com.adobe.idp.Document
. 출력 값의 이름(암호로 암호화된 PDF 문서)은 SecuredDoc
그리고 데이터 유형은 다음과 같습니다. com.adobe.idp.Document
.
웹 서비스를 사용하여 감시 폴더 끝점을 추가할 수 없습니다.
감시 폴더 끝점을 서비스에 추가하려면 다음 작업을 수행합니다.
EndpointRegistryClient
개체.프로젝트 파일 포함
개발 프로젝트에 필요한 파일을 포함하십시오. Java를 사용하여 클라이언트 응용 프로그램을 만드는 경우 필요한 JAR 파일을 포함하십시오. 웹 서비스를 사용하는 경우 프록시 파일을 포함해야 합니다.
프로젝트의 클래스 경로에 다음 JAR 파일을 추가해야 합니다.
이러한 JAR 파일의 위치에 대한 자세한 내용은 AEM Forms Java 라이브러리 파일 포함.
EndpointRegistry 클라이언트 개체 만들기
프로그래밍 방식으로 감시 폴더 끝점을 추가하려면 EndpointRegistryClient
개체.
감시 폴더 끝점 특성 설정
서비스에 대한 감시 폴더 끝점을 만들려면 다음 값을 지정합니다.
WatchedFolder
.EncryptDocument
.invoke
.구성 값 지정
서비스에 Observed Folder 끝점을 프로그래밍 방식으로 추가할 때 Observed Folder 끝점에 대한 구성 값을 지정해야 합니다. 이러한 구성 값은 관리 콘솔을 사용하여 감시 폴더 종단점이 추가된 경우 관리자가 지정합니다.
다음 목록은 Observed Folder 끝점을 서비스에 프로그래밍 방식으로 추가할 때 설정되는 구성 값을 지정합니다.
data*
, 일치하는 모든 파일 및 폴더 data*
안 찍혔어 여기에는 이름이 인 파일과 폴더가 포함됩니다 data1
, data2
등 또한, 패턴은 와일드카드 패턴으로 보완하여 파일 패턴을 지정할 수 있다. 감시 폴더는 다음과 같은 와일드카드 패턴을 지원하도록 정규 표현식을 수정합니다. *.*
및 *.pdf
. 이러한 와일드카드 패턴은 정규 표현식에서 지원되지 않습니다.*
, 일치하는 모든 파일 및 폴더 input*
다 찍혔어 여기에는 이름이 인 파일과 폴더가 포함됩니다 input1
, input2
등 기본값은 *
입니다. 이 값은 모든 파일과 폴더를 나타냅니다. 또한, 패턴은 와일드카드 패턴으로 보완하여 파일 패턴을 지정할 수 있다. 감시 폴더는 다음과 같은 와일드카드 패턴을 지원하도록 정규 표현식을 수정합니다. *.*
및 *.pdf
. 이러한 와일드카드 패턴은 정규 표현식에서 지원되지 않습니다. 이 값은 필수입니다.result/%Y/%M/%D/
입니다. 감시 폴더 내의 결과 폴더입니다.preserve/%Y/%M/%D/
입니다.failure/%Y/%M/%D/
입니다.입력 매개 변수 값 정의
감시 폴더 끝점을 만들 때는 입력 매개 변수 값을 정의해야 합니다. 즉, 감시 폴더에 의해 호출되는 작업에 전달되는 입력 값을 설명해야 합니다. 예를 들어 이 주제에 도입된 프로세스를 생각해 보십시오. 여기에는 이름이 인 입력 값이 한 개 있습니다 InDoc
및 해당 데이터 유형이 com.adobe.idp.Document
. 이 프로세스에 대해 감시 폴더 끝점을 만들 때(프로세스가 활성화되면 서비스가 됨) 입력 매개 변수 값을 정의해야 합니다.
감시 폴더 끝점에 필요한 입력 매개 변수 값을 정의하려면 다음 값을 지정합니다.
입력 매개 변수 이름: 입력 매개 변수의 이름입니다. 입력 값의 이름은 프로세스에 대해 워크벤치에서 지정됩니다. 입력 값이 서비스 작업(Workbench에서 생성된 프로세스가 아닌 서비스)에 속하는 경우 입력 이름이 component.xml 파일에 지정됩니다. 예를 들어 이 섹션에 도입된 프로세스의 입력 매개 변수 이름은 다음과 같습니다 InDoc
.
매핑 유형: 서비스 작업을 호출하는 데 필요한 입력 값을 구성하는 데 사용됩니다. 매핑 유형에는 두 가지 유형이 있습니다.
Literal
: 감시 폴더 엔드포인트는 필드에 입력한 값이 표시되는 대로 사용됩니다. 모든 기본 Java 유형이 지원됩니다. 예를 들어 API가 String, long, int 및 Boolean과 같은 입력을 사용하는 경우 문자열이 적절한 유형으로 변환되고 서비스가 호출됩니다.Variable
: 입력한 값은 감시 폴더에서 입력을 선택하는 데 사용하는 파일 패턴입니다. 예를 들어, 매핑 유형에 대해 변수를 선택하고 입력 문서가 PDF 파일이어야 하는 경우 *.pdf
를 매핑 값으로 사용하십시오.매핑 값: 매핑 유형의 값을 지정합니다. 예를 들어 Variable
매핑 유형에서 *.pdf
를 파일 패턴으로 사용합니다.
데이터 유형: 입력 값의 데이터 형식을 지정합니다. 예를 들어 이 섹션에 도입된 프로세스의 입력 값의 데이터 유형은 다음과 같습니다 com.adobe.idp.Document
.
출력 매개 변수 값 정의
감시 폴더 끝점을 만들 때는 출력 매개 변수 값을 정의해야 합니다. 즉, 감시 폴더 끝점에 의해 호출되는 서비스에서 반환되는 출력 값을 설명해야 합니다. 예를 들어 이 주제에 도입된 프로세스를 생각해 보십시오. 여기에는 라는 출력 값이 있습니다 SecuredDoc
및 해당 데이터 유형이 com.adobe.idp.Document
. 이 프로세스에 대해 감시 폴더 끝점을 만들 때(프로세스가 활성화되면 서비스가 됨) 출력 매개 변수 값을 정의해야 합니다.
감시 폴더 끝점에 필요한 출력 매개 변수 값을 정의하려면 다음 값을 지정합니다.
출력 매개 변수 이름: 출력 매개 변수의 이름입니다. 프로세스 출력 값의 이름은 Workbench에 지정됩니다. 출력 값이 서비스 작업(Workbench에서 생성된 프로세스가 아닌 서비스)에 속하는 경우 출력 이름이 component.xml 파일에 지정됩니다. 예를 들어 이 섹션에 도입된 프로세스의 출력 매개 변수의 이름은 다음과 같습니다 SecuredDoc
.
매핑 유형: 서비스 및 작업의 출력을 구성하는 데 사용됩니다. 다음 옵션을 사용할 수 있습니다.
%F.pdf
소스 대상은 sourcefilename.pdf입니다. 예를 들어 이 섹션에 도입된 프로세스는 단일 문서를 반환합니다. 따라서 매핑 유형은 %F.pdf
( %F
은(는) 지정된 파일 이름을 사용함을 의미합니다.) 패턴 %E
입력 문서의 확장자를 지정합니다.Result\%F\
및 소스 대상은 Result\sourcefilename\source1 (output 1) 및 Result\sourcefilename\source2 (output 2)입니다.Result\%F\
및 소스 대상은 Result\sourcefilename\file1 및 Result\sourcefilename\file2입니다. 맵에 두 개 이상의 개체가 있는 경우 패턴은 Result\%F.pdf
소스 대상은 Result\sourcefilename1.pdf (출력 1), Result\sourcefilenam2.pdf (출력 2) 등입니다.데이터 유형: 반환 값의 데이터 형식을 지정합니다. 예를 들어 이 섹션에 도입된 프로세스의 반환 값의 데이터 유형은 다음과 같습니다 com.adobe.idp.Document
.
감시 폴더 끝점 만들기
끝점의 속성, 구성 값을 설정하고 입력 및 출력 매개 변수 값을 정의한 후에는 감시 폴더 끝점을 만들어야 합니다.
엔드포인트 활성화
감시 폴더 끝점을 만든 후 활성화해야 합니다. 엔드포인트가 활성화되면 서비스를 호출하는 데 사용할 수 있습니다. 끝점을 활성화하면 관리 콘솔 내에서 볼 수 있습니다.
추가 참조
AEM Forms Java API를 사용하여 감시 폴더 엔드포인트를 추가합니다.
프로젝트 파일을 포함합니다.
Java 프로젝트의 클래스 경로에 adobe-livecycle-client.jar와 같은 클라이언트 JAR 파일을 포함합니다.
EndpointRegistry 클라이언트 개체를 만듭니다.
ServiceClientFactory
연결 속성을 포함하는 객체입니다.EndpointRegistryClient
생성자를 사용하여 객체를 전달하고 ServiceClientFactory
개체.감시 폴더 끝점 특성을 설정합니다.
CreateEndpointInfo
생성자를 사용하여 개체를 작성합니다.CreateEndpointInfo
개체 setConnectorId
메서드 및 문자열 값 전달 WatchedFolder
.CreateEndpointInfo
개체 setDescription
메서드를 사용하여 끝점을 설명하는 문자열 값을 전달합니다.CreateEndpointInfo
개체 setName
메서드를 사용하여 이름을 지정하는 문자열 값을 전달합니다.CreateEndpointInfo
개체 setServiceId
메서드를 사용하여 서비스 이름을 지정하는 문자열 값을 전달합니다.CreateEndpointInfo
개체 setOperationName
메서드 및 작업 이름을 지정하는 문자열 값 전달 일반적으로 Workbench에서 만든 프로세스에서 시작된 서비스에 대한 감시 폴더 끝점을 만들 때 작업 이름이 호출됩니다.구성 값을 지정합니다.
감시 폴더 끝점에 대해 설정할 각 구성 값에 대해 CreateEndpointInfo
개체 setConfigParameterAsText
메서드를 사용합니다. 예를 들어 url
구성 값, 호출 CreateEndpointInfo
개체 setConfigParameterAsText
메서드를 사용하여 다음 문자열 값을 전달합니다.
url
구성 값, 지정 url
.url
구성 값에서 감시 폴더 위치를 지정합니다.EncryptDocument 서비스에 대해 설정된 모든 구성 값을 보려면 다음 위치에 있는 Java 코드 예를 참조하십시오. 빠른 시작: Java API를 사용하여 감시 폴더 엔드포인트 추가.
입력 매개 변수 값을 정의합니다.
를 호출하여 입력 매개 변수 값을 정의합니다 CreateEndpointInfo
개체 setInputParameterMapping
메서드를 사용하여 다음 값을 전달합니다.
InDoc
.InDoc
입력 매개 변수 com.adobe.idp.Document
.variable
.를 호출합니다 setInputParameterMapping
정의할 각 입력 매개 변수 값에 대한 메서드입니다. EncryptDocument 프로세스에는 입력 매개 변수가 하나만 있으므로 이 메서드를 한 번 호출해야 합니다.
출력 매개 변수 값을 정의합니다.
를 호출하여 출력 매개 변수 값을 정의합니다 CreateEndpointInfo
개체 setOutputParameterMapping
메서드를 사용하여 다음 값을 전달합니다.
SecuredDoc
.SecuredDoc
출력 매개 변수 com.adobe.idp.Document
.%F.pdf
.감시 폴더 끝점을 만듭니다.
를 호출하여 끝점을 만듭니다 EndpointRegistryClient
개체 createEndpoint
메서드 및 전달 CreateEndpointInfo
개체. 이 메서드는 Endpoint
감시 폴더 끝점을 나타내는 개체입니다.
끝점을 활성화합니다.
를 호출하여 끝점을 활성화합니다 EndpointRegistryClient
개체 enable
메서드 및 전달 Endpoint
반환되는 개체 createEndpoint
메서드를 사용합니다.
추가 참조
빠른 시작: Java API를 사용하여 감시 폴더 엔드포인트 추가
다음 빠른 시작: Java API를 사용하여 감시 폴더 엔드포인트 추가 는 빠른 시작을 컴파일하기 위해 Java 프로젝트에 포함되어야 하는 상수 파일을 사용합니다. 이 상수 파일은 감시 폴더 끝점을 추가할 때 설정해야 하는 구성 값을 나타냅니다. 다음 Java 코드는 상수 파일을 나타냅니다.
/**
* This class contains constants that can be used when setting Watched Folder
* configuration values
*/
public final class WatchedFolderEndpointConfigConstants {
public static final String PROPERTY_FILEPROVIDER_URL = "url";
public static final String PROPERTY_PROPERTY_ASYNCHRONOUS = "asynchronous";
public static final String PROPERTY_CRON_EXPRESSION = "cronExpression";
public static final String PROPERTY_PURGE_DURATION = "purgeDuration";
public static final String PROPERTY_REPEAT_INTERVAL = "repeatInterval";
public static final String PROPERTY_REPEAT_COUNT = "repeatCount";
public static final String PROPERTY_THROTTLE = "throttleOn";
public static final String PROPERTY_USERNAMER = "userName";
public static final String PROPERTY_DOMAINNAME = "domainName";
public static final String PROPERTY_FILEPROVIDER_BATCH_SIZE = "batchSize";
public static final String PROPERTY_FILEPROVIDER_WAIT_TIME = "waitTime";
public static final String PROPERTY_EXCLUDE_FILE_PATTERN = "excludeFilePattern";
public static final String PROPERTY_INCLUDE_FILE_PATTERN = "excludeFilePattern";
public static final String PROPERTY_FILEPROVIDER_RESULT_FOLDER_NAME = "resultFolderName";
public static final String PROPERTY_FILEPROVIDER_PRESERVE_FOLDER_NAME = "preserveFolderName";
public static final String PROPERTY_FILEPROVIDER_FAILURE_FOLDER_NAME = "failureFolderName";
public static final String PROPERTY_FILEPROVIDER_PRESERVE_ON_FAILURE = "preserveOnFailure";
public static final String PROPERTY_FILEPROVIDER_OVERWRITE_DUPLICATE_FILENAME = "overwriteDuplicateFilename";
}
AEM Forms Java API를 사용하여 프로그래밍 방식으로 서비스에 이메일 엔드포인트를 추가할 수 있습니다. 전자 메일 끝점을 추가하면 사용자가 하나 이상의 파일 첨부 파일이 있는 전자 메일 메시지를 지정된 전자 메일 계정에 보낼 수 있습니다. 그런 다음 서비스 구성 작업이 호출되어 파일을 조작합니다. 서비스는 지정된 작업을 수행하면 수정된 파일을 첨부 파일로 보낸 사람에게 전자 메일 메시지를 보냅니다.
서비스에 이메일 엔드포인트를 프로그래밍 방식으로 추가할 목적으로는 다음 단기 프로세스를 고려하십시오. MyApplication\EncryptDocument. 단기 프로세스에 대한 자세한 내용은 AEM Forms 프로세스 이해.
이 프로세스는 비보안 PDF 문서를 입력 값으로 수락한 다음 비보안 PDF 문서를 암호화 서비스의 EncryptPDFUsingPassword
작업. 이 프로세스는 암호로 PDF 문서를 암호화하고 암호로 암호화된 PDF 문서를 출력 값으로 반환합니다. 입력 값의 이름(비보안 PDF 문서)은 InDoc
그리고 데이터 유형은 다음과 같습니다. com.adobe.idp.Document
. 출력 값의 이름(암호로 암호화된 PDF 문서)은 SecuredDoc
그리고 데이터 유형은 다음과 같습니다. com.adobe.idp.Document
.
웹 서비스를 사용하여 전자 메일 끝점을 추가할 수 없습니다.
서비스에 전자 메일 끝점을 추가하려면 다음 작업을 수행합니다.
EndpointRegistryClient
개체.프로젝트 파일 포함
개발 프로젝트에 필요한 파일을 포함하십시오. Java를 사용하여 클라이언트 응용 프로그램을 만드는 경우 필요한 JAR 파일을 포함하십시오. 웹 서비스를 사용하는 경우 프록시 파일을 포함해야 합니다.
프로젝트의 클래스 경로에 다음 JAR 파일을 추가해야 합니다.
이러한 JAR 파일의 위치에 대한 자세한 내용은 AEM Forms Java 라이브러리 파일 포함.
EndpointRegistry 클라이언트 개체 만들기
프로그래밍 방식으로 이메일 엔드포인트를 추가하려면 먼저 EndpointRegistryClient
개체.
전자 메일 끝점 특성 설정
서비스에 대한 이메일 끝점을 만들려면 다음 값을 지정합니다.
Email
.EncryptDocument
.invoke
.구성 값 지정
서비스에 이메일 끝점을 프로그래밍 방식으로 추가할 때 이메일 끝점에 대한 구성 값을 지정해야 합니다. 이러한 구성 값은 관리 콘솔을 사용하여 전자 메일 종단점이 추가된 경우 관리자가 지정합니다.
모니터링되는 전자 메일 계정은 전자 메일 끝점에만 사용되는 특수 계정입니다. 이 계정은 일반 사용자의 이메일 계정이 아닙니다. 이메일 공급자가 메시지를 완료하고 나면 받은 편지함에서 이메일 메시지를 삭제하므로 일반 사용자의 이메일 계정을 이메일 공급자가 사용하는 계정으로 구성할 수 없습니다.
서비스에 이메일 끝점을 프로그래밍 방식으로 추가할 때 다음 구성 값이 설정됩니다.
SuperAdmin
입니다.DefaultDom
입니다.adobe.com
를 사용하면 adobe.com의 이메일만 처리되고 다른 도메인의 이메일은 무시됩니다.*
입니다.sender
: 이메일 결과가 발신자에게 전송됩니다. 최대 100명의 수신자가 지원됩니다. 각각 쉼표로 구분된 이메일 주소를 사용하는 추가 수신자를 지정합니다. 이 옵션을 끄려면 이 값을 비워 둡니다. 경우에 따라 프로세스를 트리거하고 결과에 대한 이메일 알림을 원하지 않을 수 있습니다. 기본값은 sender
입니다.sender
: 이메일 결과가 발신자에게 전송됩니다. 최대 100명의 수신자가 지원됩니다. 각각 쉼표로 구분된 이메일 주소를 사용하는 추가 수신자를 지정합니다. 이 옵션을 끄려면 이 값을 비워 둡니다. 기본값은 sender
입니다.IMAP
또는 POP3
. 받은 편지함 호스트 메일 서버는 이러한 프로토콜을 지원해야 합니다.UTF-8
입니다.입력 매개 변수 값 정의
전자 메일 끝점을 만들 때 입력 매개 변수 값을 정의해야 합니다. 즉, 전자 메일 종단점에 의해 호출되는 작업에 전달되는 입력 값을 설명해야 합니다. 예를 들어 이 주제에 도입된 프로세스를 생각해 보십시오. 여기에는 이름이 인 입력 값이 한 개 있습니다 InDoc
및 해당 데이터 유형이 com.adobe.idp.Document
. 이 프로세스에 대한 전자 메일 끝점을 만들 때(프로세스가 활성화되면 서비스가 됨) 입력 매개 변수 값을 정의해야 합니다.
전자 메일 종단점에 필요한 입력 매개 변수 값을 정의하려면 다음 값을 지정합니다.
입력 매개 변수 이름: 입력 매개 변수의 이름입니다. 입력 값의 이름은 프로세스에 대해 워크벤치에서 지정됩니다. 입력 값이 서비스 작업(Workbench에서 만든 프로세스가 아닌 Forms 서비스)에 속하는 경우 입력 이름이 component.xml 파일에 지정됩니다. 예를 들어 이 섹션에 도입된 프로세스의 입력 매개 변수 이름은 다음과 같습니다 InDoc
.
매핑 유형: 서비스 작업을 호출하는 데 필요한 입력 값을 구성하는 데 사용됩니다. 두 가지 유형의 매핑 유형은 다음과 같습니다.
Literal
: 이메일 종단점은 필드에 입력한 값이 표시되는 대로 사용됩니다. 모든 기본 Java 유형이 지원됩니다. 예를 들어 API가 String, long, int 및 Boolean과 같은 입력을 사용하는 경우 문자열이 적절한 유형으로 변환되고 서비스가 호출됩니다.Variable
: 입력한 값은 전자 메일 끝점이 입력을 선택하는 데 사용하는 파일 패턴입니다. 예를 들어, 매핑 유형에 대해 변수를 선택하고 입력 문서가 PDF 파일이어야 하는 경우 *.pdf
를 매핑 값으로 사용하십시오.매핑 값: 매핑 유형의 값을 지정합니다. 예를 들어 변수 매핑 유형을 선택하는 경우 *.pdf
를 파일 패턴으로 사용합니다.
데이터 유형: 입력 값의 데이터 형식을 지정합니다. 예를 들어 이 섹션에 도입된 프로세스의 입력 값의 데이터 유형은 com.adobe.idp.Document입니다.
출력 매개 변수 값 정의
전자 메일 끝점을 만들 때는 출력 매개 변수 값을 정의해야 합니다. 즉, 전자 메일 종단점에 의해 호출되는 서비스에서 반환되는 출력 값을 설명해야 합니다. 예를 들어 이 주제에 도입된 프로세스를 생각해 보십시오. 여기에는 라는 출력 값이 있습니다 SecuredDoc
및 해당 데이터 유형이 com.adobe.idp.Document
. 이 프로세스에 대한 전자 메일 끝점을 만들 때(프로세스가 활성화되면 서비스가 됨) 출력 매개 변수 값을 정의해야 합니다.
전자 메일 종단점에 필요한 출력 매개 변수 값을 정의하려면 다음 값을 지정합니다.
출력 매개 변수 이름: 출력 매개 변수의 이름입니다. 프로세스 출력 값의 이름은 Workbench에 지정됩니다. 출력 값이 서비스 작업(Workbench에서 생성된 프로세스가 아닌 서비스)에 속하는 경우 출력 이름이 component.xml 파일에 지정됩니다. 예를 들어 이 섹션에 도입된 프로세스의 출력 매개 변수의 이름은 다음과 같습니다 SecuredDoc
.
매핑 유형: 서비스 및 작업의 출력을 구성하는 데 사용됩니다. 다음 옵션을 사용할 수 있습니다.
%F.pdf
소스 대상은 sourcefilename.pdf입니다. 예를 들어 이 섹션에 도입된 프로세스는 단일 문서를 반환합니다. 따라서 매핑 유형은 %F.pdf
( %F
은(는) 지정된 파일 이름을 사용함을 의미합니다.) 패턴 %E
입력 문서의 확장자를 지정합니다.Result\%F\
및 소스 대상은 Result\sourcefilename\source1 (output 1) 및 Result\sourcefilename\source2 (output 2)입니다.Result\%F\
및 소스 대상은 Result\sourcefilename\file1 및 Result\sourcefilename\file2입니다. 맵에 두 개 이상의 개체가 있는 경우 패턴은 Result\%F.pdf
소스 대상은 Result\sourcefilename1.pdf (출력 1), Result\sourcefilenam2.pdf (출력 2) 등입니다.데이터 유형: 반환 값의 데이터 형식을 지정합니다. 예를 들어 이 섹션에 도입된 프로세스의 반환 값의 데이터 유형은 다음과 같습니다 com.adobe.idp.Document
.
전자 메일 끝점 만들기
전자 메일 끝점 특성 및 구성 값을 설정하고 입력 및 출력 매개 변수 값을 정의한 후에는 전자 메일 끝점을 만들어야 합니다.
엔드포인트 활성화
이메일 종단점을 만든 후 활성화해야 합니다. 엔드포인트가 활성화되면 서비스를 호출하는 데 사용할 수 있습니다. 끝점을 활성화하면 관리 콘솔 내에서 볼 수 있습니다.
추가 참조
Java API를 사용하여 이메일 엔드포인트 추가:
프로젝트 파일을 포함합니다.
Java 프로젝트의 클래스 경로에 adobe-livecycle-client.jar와 같은 클라이언트 JAR 파일을 포함합니다.
EndpointRegistry 클라이언트 개체를 만듭니다.
ServiceClientFactory
연결 속성을 포함하는 객체입니다.EndpointRegistryClient
생성자를 사용하여 객체를 전달하고 ServiceClientFactory
개체.전자 메일 끝점 특성을 설정합니다.
CreateEndpointInfo
생성자를 사용하여 개체를 작성합니다.CreateEndpointInfo
개체 setConnectorId
메서드 및 문자열 값 전달 Email
.CreateEndpointInfo
개체 setDescription
메서드를 사용하여 끝점을 설명하는 문자열 값을 전달합니다.CreateEndpointInfo
개체 setName
메서드를 사용하여 이름을 지정하는 문자열 값을 전달합니다.CreateEndpointInfo
개체 setServiceId
메서드를 사용하여 서비스 이름을 지정하는 문자열 값을 전달합니다.CreateEndpointInfo
개체 setOperationName
메서드 및 작업 이름을 지정하는 문자열 값 전달 일반적으로 Workbench에서 만든 프로세스에서 시작된 서비스에 대한 이메일 끝점을 만들 때 작업 이름이 호출됩니다.구성 값을 지정합니다.
전자 메일 종단점에 대해 설정할 각 구성 값에 대해 CreateEndpointInfo
개체 setConfigParameterAsText
메서드를 사용합니다. 예를 들어 smtpHost
구성 값, 호출 CreateEndpointInfo
개체 setConfigParameterAsText
메서드를 사용하여 다음 값을 전달합니다.
smtpHost
구성 값, 지정 smtpHost
.smtpHost
구성 값, SMTP 서버의 이름을 지정하는 문자열 값을 지정합니다.이 섹션에 도입된 EncryptDocument 서비스에 대해 설정된 모든 구성 값을 보려면 빠른 시작: Java API를 사용하여 이메일 엔드포인트 추가.
입력 매개 변수 값을 정의합니다.
를 호출하여 입력 매개 변수 값을 정의합니다 CreateEndpointInfo
개체 setInputParameterMapping
메서드를 사용하여 다음 값을 전달합니다.
InDoc
.InDoc
입력 매개 변수 com.adobe.idp.Document
.variable
.를 호출합니다 setInputParameterMapping
정의할 각 입력 매개 변수 값에 대한 메서드입니다. EncryptDocument 프로세스에는 입력 매개 변수가 하나만 있으므로 이 메서드를 한 번 호출해야 합니다.
출력 매개 변수 값을 정의합니다.
를 호출하여 출력 매개 변수 값을 정의합니다 CreateEndpointInfo
개체 setOutputParameterMapping
메서드 및 다음 값 전달:
SecuredDoc
.SecuredDoc
출력 매개 변수 com.adobe.idp.Document
.%F.pdf
.전자 메일 끝점을 만듭니다.
를 호출하여 끝점을 만듭니다 EndpointRegistryClient
개체 createEndpoint
메서드 및 전달 CreateEndpointInfo
개체. 이 메서드는 Endpoint
전자 메일 끝점을 나타내는 개체입니다.
끝점을 활성화합니다.
를 호출하여 끝점을 활성화합니다 EndpointRegistryClient
개체 enable
메서드 및 전달 Endpoint
반환되는 개체 createEndpoint
메서드를 사용합니다.
추가 참조
빠른 시작: Java API를 사용하여 감시 폴더 엔드포인트 추가
다음 빠른 시작: Java API를 사용하여 이메일 엔드포인트 추가 는 빠른 시작을 컴파일하기 위해 Java 프로젝트에 포함되어야 하는 상수 파일을 사용합니다. 이 상수 파일은 전자 메일 끝점을 추가할 때 설정해야 하는 구성 값을 나타냅니다. 다음 Java 코드는 상수 파일을 나타냅니다.
/**
* This class contains constants that can be used when setting email endpoint
* configuration values
*/
public class EmailEndpointConfigConstants {
public static final String PROPERTY_EMAILPROVIDER_CRON_EXPRESSION = "cronExpression";
public static final String PROPERTY_EMAILPROVIDER_REPREAT_COUNT = "repeatCount";
public static final String PROPERTY_EMAILPROVIDER_REPREAT_INTERVAL = "repeatInterval";
public static final String PROPERTY_EMAILPROVIDER_START_DELAY = "startDelay";
public static final String PROPERTY_EMAILPROVIDER_BATCH_SIZE = "batchSize";
public static final String PROPERTY_EMAILPROVIDER_USERNAME = "userName";
public static final String PROPERTY_EMAILPROVIDER_DOMAINNAME = "domainName";
public static final String PROPERTY_EMAILPROVIDER_DOMAINPATTERN = "domainPattern";
public static final String PROPERTY_EMAILPROVIDER_FILEPATTERN = "filePattern";
public static final String PROPERTY_EMAILPROVIDER_RECIPIENT_SUCCESSFUL_JOB = "recipientSuccessfulJob";
public static final String PROPERTY_EMAILPROVIDER_RECIPIENT_FAILED_JOB = "recipientFailedJob";
public static final String PROPERTY_EMAILPROVIDER_INBOX_HOST = "inboxHost";
public static final String PROPERTY_EMAILPROVIDER_INBOX_PORT = "inboxPort";
public static final String PROPERTY_EMAILPROVIDER_PROTOCOL = "inboxProtocol";
public static final String PROPERTY_EMAILPROVIDER_INBOX_TIMEOUT = "inboxTimeOut";
public static final String PROPERTY_EMAILPROVIDER_INBOX_USER = "inboxUser";
public static final String PROPERTY_EMAILPROVIDER_INBOX_PASSWORD = "inboxPassword";
public static final String PROPERTY_EMAILPROVIDER_INBOX_SSL = "inboxSSLEnabled";
public static final String PROPERTY_EMAILPROVIDER_SMTP_HOST = "smtpHost";
public static final String PROPERTY_EMAILPROVIDER_SMTP_PORT = "smtpPort";
public static final String PROPERTY_EMAILPROVIDER_SMTP_USER = "smtpUser";
public static final String PROPERTY_EMAILPROVIDER_SMTP_PASSWORD = "smtpPassword";
public static final String PROPERTY_EMAILPROVIDER_CHARSET = "charSet";
public static final String PROPERTY_EMAILPROVIDER_SMTP_SSL = "smtpSSLEnabled";
public static final String PROPERTY_EMAILPROVIDER_FAILED_FOLDER = "failedJobFolder";
public static final String PROPERTY_EMAILPROVIDER_ASYNCHRONOUS = "asynchronous";
}
JEE의 AEM Forms용 LiveCycle Remoting API는 더 이상 사용되지 않습니다.
AEM Forms Java API를 사용하여 프로그래밍 방식으로 서비스에 원격 끝점을 추가할 수 있습니다. 원격 끝점을 추가하면 Flex 응용 프로그램이 원격을 사용하여 서비스를 호출하는 것을 활성화합니다. (자세한 내용은 AEM Forms Remoting을 사용하여 AEM Forms 호출(AEM Forms에서 더 이상 사용되지 않음))
Remoting 끝점을 서비스에 프로그래밍 방식으로 추가하려면 이름이 짧은 다음 프로세스를 고려하십시오. EncryptDocument.
이 프로세스는 비보안 PDF 문서를 입력 값으로 수락한 다음 비보안 PDF 문서를 암호화 서비스의 EncryptPDFUsingPassword
작업. PDF 문서는 암호로 암호화되며, 암호로 암호화된 PDF 문서는 이 프로세스의 출력 값입니다. 입력 값의 이름(비보안 PDF 문서)은 InDoc
그리고 데이터 유형은 다음과 같습니다. com.adobe.idp.Document
. 출력 값의 이름(암호로 암호화된 PDF 문서)은 SecuredDoc
그리고 데이터 유형은 다음과 같습니다. com.adobe.idp.Document
.
원격 끝점을 서비스에 추가하는 방법을 보여주기 위해 이 섹션은 EncryptDocument라는 서비스에 원격 끝점을 추가합니다.
웹 서비스를 사용하여 원격 끝점을 추가할 수 없습니다.
서비스에서 끝점을 제거하려면 다음 작업을 수행합니다.
EndpointRegistryClient
개체.프로젝트 파일 포함
개발 프로젝트에 필요한 파일을 포함하십시오. Java를 사용하여 클라이언트 응용 프로그램을 만드는 경우 필요한 JAR 파일을 포함하십시오. 웹 서비스를 사용하는 경우 프록시 파일을 포함해야 합니다.
프로젝트의 클래스 경로에 다음 JAR 파일을 추가해야 합니다.
이러한 JAR 파일의 위치에 대한 자세한 내용은 AEM Forms Java 라이브러리 파일 포함.
EndpointRegistry 클라이언트 개체 만들기
원격 끝점을 프로그래밍 방식으로 추가하려면 EndpointRegistryClient
개체.
원격 끝점 특성 설정
서비스에 대한 원격 끝점을 만들려면 다음 값을 지정하십시오.
Remoting
.EncryptDocument
.원격 끝점 만들기
원격 끝점 특성을 설정한 후 서비스에 대한 원격 끝점을 만들 수 있습니다.
엔드포인트 활성화
새 끝점을 만든 후 활성화해야 합니다. 원격 끝점이 활성화되어 있으면 Flex 클라이언트가 서비스를 호출할 수 있습니다.
추가 참조
Java API를 사용하여 원격 끝점을 추가합니다.
프로젝트 파일을 포함합니다.
Java 프로젝트의 클래스 경로에 adobe-livecycle-client.jar와 같은 클라이언트 JAR 파일을 포함합니다.
EndpointRegistry 클라이언트 개체를 만듭니다.
ServiceClientFactory
연결 속성을 포함하는 객체입니다.EndpointRegistryClient
생성자를 사용하여 객체를 전달하고 ServiceClientFactory
개체.원격 끝점 특성을 설정합니다.
CreateEndpointInfo
생성자를 사용하여 개체를 작성합니다.CreateEndpointInfo
개체 setConnectorId
메서드 및 문자열 값 전달 Remoting
.CreateEndpointInfo
개체 setDescription
메서드를 사용하여 끝점을 설명하는 문자열 값을 전달합니다.CreateEndpointInfo
개체 setName
메서드를 사용하여 이름을 지정하는 문자열 값을 전달합니다.CreateEndpointInfo
개체 setServiceId
메서드를 사용하여 서비스 이름을 지정하는 문자열 값을 전달합니다.CreateEndpointInfo
개체 setOperationName
메서드 및 작업 이름을 지정하는 문자열 값 전달 원격 끝점의 경우 와일드카드 문자(*)를 지정하십시오.원격 끝점을 만듭니다.
를 호출하여 끝점을 만듭니다 EndpointRegistryClient
개체 createEndpoint
메서드 및 전달 CreateEndpointInfo
개체. 이 메서드는 Endpoint
새 원격 끝점을 나타내는 개체입니다.
끝점을 활성화합니다.
를 호출하여 끝점을 활성화합니다 EndpointRegistryClient
개체 enable
메서드 및 전달 Endpoint
반환되는 개체 createEndpoint
메서드를 사용합니다.
추가 참조
빠른 시작: Java API를 사용하여 원격 끝점 추가
AEM Forms Java API를 사용하여 프로그래밍 방식으로 TaskManager 종단점을 서비스에 추가할 수 있습니다. TaskManager 끝점을 서비스에 추가하면 Workspace 사용자가 서비스를 호출하도록 할 수 있습니다. 즉, Workspace에서 작업하는 사용자는 해당 TaskManager 종단점이 있는 프로세스를 호출할 수 있습니다.
웹 서비스를 사용하여 TaskManager 끝점을 추가할 수 없습니다.
서비스에 TaskManager 끝점을 추가하려면 다음 작업을 수행합니다.
EndpointRegistryClient
개체.프로젝트 파일 포함
개발 프로젝트에 필요한 파일을 포함하십시오. Java를 사용하여 클라이언트 응용 프로그램을 만드는 경우 필요한 JAR 파일을 포함하십시오. 웹 서비스를 사용하는 경우 프록시 파일을 포함해야 합니다.
프로젝트의 클래스 경로에 다음 JAR 파일을 추가해야 합니다.
이러한 JAR 파일의 위치에 대한 자세한 내용은 AEM Forms Java 라이브러리 파일 포함.
EndpointRegistry 클라이언트 개체 만들기
프로그래밍 방식으로 TaskManager 끝점을 추가하려면 먼저 EndpointRegistryClient
개체.
끝점에 대한 카테고리 만들기
카테고리는 Workspace 내에서 서비스를 구성하는 데 사용됩니다. 즉, Workspace 사용자는 Workspace 내에서 카테고리를 선택하여 TaskManager 종단점이 있는 서비스를 호출할 수 있습니다. TaskManager 끝점을 만들 때 기존 범주를 참조하거나 프로그래밍 방식으로 새 범주를 만들 수 있습니다.
이 섹션에서는 서비스에 TaskManager 끝점을 추가하는 과정의 일부로 새 범주를 만듭니다.
TaskManager 끝점 특성 설정
서비스에 대한 TaskManager 끝점을 만들려면 다음 값을 지정합니다.
TaskManagerConnector
.invoke
.TaskManager 끝점 만들기
TaskManager 끝점 특성을 설정한 후에는 서비스에 대한 TaskManager 끝점을 만들 수 있습니다.
엔드포인트 활성화
새 끝점을 만든 후 활성화해야 합니다. 엔드포인트가 활성화되면 Workspace 내에서 서비스를 호출하는 데 사용할 수 있습니다. 끝점을 활성화하면 관리 콘솔 내에서 볼 수 있습니다.
추가 참조
Java API를 사용하여 TaskManager 종단점 추가
Java API를 사용하여 TaskManager 끝점을 추가합니다.
프로젝트 파일을 포함합니다.
Java 프로젝트의 클래스 경로에 adobe-livecycle-client.jar와 같은 클라이언트 JAR 파일을 포함합니다.
EndpointRegistry 클라이언트 개체를 만듭니다.
ServiceClientFactory
연결 속성을 포함하는 객체입니다.EndpointRegistryClient
생성자를 사용하여 객체를 전달하고 ServiceClientFactory
개체.끝점에 대한 카테고리를 만듭니다.
만들기 CreateEndpointCategoryInfo
생성자를 사용하여 다음 값을 전달하여 객체를 만듭니다.
를 호출하여 카테고리를 만듭니다 EndpointRegistryClient
개체 createEndpointCategory
메서드 및 전달 CreateEndpointCategoryInfo
개체. 이 메서드는 EndpointCategory
새 카테고리를 나타내는 개체입니다.
TaskManager 끝점 특성을 설정합니다.
CreateEndpointInfo
생성자를 사용하여 개체를 작성합니다.CreateEndpointInfo
개체 setConnectorId
메서드 및 문자열 값 전달 TaskManagerConnector
.CreateEndpointInfo
개체 setDescription
메서드를 사용하여 끝점을 설명하는 문자열 값을 전달합니다.CreateEndpointInfo
개체 setName
메서드를 사용하여 이름을 지정하는 문자열 값을 전달합니다.CreateEndpointInfo
개체 setServiceId
메서드를 사용하여 서비스 이름을 지정하는 문자열 값을 전달합니다.CreateEndpointInfo
개체 setCategoryId
카테고리 식별자 값을 지정하는 문자열 값 전달 및 메서드. 를 호출할 수 있습니다 EndpointCategory
개체 getId
이 카테고리의 식별자 값을 가져오는 방법입니다.CreateEndpointInfo
개체 setOperationName
메서드 및 작업 이름을 지정하는 문자열 값 전달 일반적으로 TaskManager
Workbench에서 만든 프로세스에서 시작된 서비스의 종단점, 작업 이름은 invoke
.TaskManager 끝점을 만듭니다.
를 호출하여 끝점을 만듭니다 EndpointRegistryClient
개체 createEndpoint
메서드 및 전달 CreateEndpointInfo
개체. 이 메서드는 Endpoint
새 TaskManager 끝점을 나타내는 개체입니다.
끝점을 활성화합니다.
를 호출하여 끝점을 활성화합니다 EndpointRegistryClient
개체 enable
메서드 및 전달 Endpoint
반환되는 개체 createEndpoint
메서드를 사용합니다.
추가 참조
빠른 시작: Java API를 사용하여 TaskManager 끝점 추가
AEM Forms Java API를 사용하여 기존 엔드포인트를 프로그래밍 방식으로 수정할 수 있습니다. 끝점을 수정하여 종단점의 동작을 변경할 수 있습니다. 감시 폴더로 사용되는 폴더를 지정하는 감시 폴더 엔드포인트 등을 예로 들 수 있습니다. 감시 폴더 끝점에 속하는 구성 값을 프로그래밍 방식으로 수정할 수 있으므로 다른 폴더가 감시 폴더로 작동합니다. 감시 폴더 끝점에 속하는 구성 값에 대한 자세한 내용은 다음을 참조하십시오 감시 폴더 끝점 추가.
끝점을 수정하는 방법을 보여 주기 위해 이 섹션에서는 감시 폴더로 동작하는 폴더를 변경하여 감시 폴더 엔드포인트를 수정합니다.
웹 서비스를 사용하여 끝점을 수정할 수 없습니다.
끝점을 수정하려면 다음 작업을 수행합니다.
EndpointRegistryClient
개체.프로젝트 파일 포함
개발 프로젝트에 필요한 파일을 포함하십시오. Java를 사용하여 클라이언트 응용 프로그램을 만드는 경우 필요한 JAR 파일을 포함하십시오. 웹 서비스를 사용하는 경우 프록시 파일을 포함해야 합니다.
프로젝트의 클래스 경로에 다음 JAR 파일을 추가해야 합니다.
이러한 JAR 파일의 위치에 대한 자세한 내용은 AEM Forms Java 라이브러리 파일 포함.
EndpointRegistry 클라이언트 개체 만들기
끝점을 프로그래밍 방식으로 수정하려면 다음을 만들어야 합니다 EndpointRegistryClient
개체.
수정할 끝점을 검색합니다.
끝점을 수정하려면 먼저 엔드포인트를 검색해야 합니다. 끝점을 검색하려면 엔드포인트에 액세스할 수 있는 사용자로 연결해야 합니다. 관리자로 연결하는 것이 좋습니다. (자세한 내용은 연결 속성 설정).
끝점 목록을 검색하여 끝점을 검색할 수 있습니다. 그런 다음 목록을 반복하여 제거할 특정 끝점을 검색할 수 있습니다. 예를 들어 종단점에 해당하는 서비스와 종단점 유형을 파악하여 종단점을 찾을 수 있습니다. 끝점을 찾으면 이를 수정할 수 있습니다.
새 구성 값 지정
끝점을 수정할 때 새 구성 값을 지정합니다. 예를 들어, 감시 폴더 종단점을 수정하려면 수정할 것만 아니라 모든 감시 폴더 종단점 구성 값을 재설정합니다. 감시 폴더 끝점에 속하는 구성 값에 대한 자세한 내용은 다음을 참조하십시오 감시 폴더 끝점 추가.
전자 메일 종단점에 속하는 구성 값에 대한 자세한 내용은 전자 메일 끝점 추가.
끝점에 의해 호출되는 서비스는 수정할 수 없습니다. 서비스를 수정하려고 하면 예외가 발생합니다. 지정된 끝점과 연결된 서비스를 수정하려면 끝점을 제거하고 새 끝점을 만듭니다. (자세한 내용은 끝점 제거 중)
추가 참조
Java API를 사용하여 엔드포인트를 수정합니다.
프로젝트 파일을 포함합니다.
Java 프로젝트의 클래스 경로에 adobe-livecycle-client.jar와 같은 클라이언트 JAR 파일을 포함합니다.
EndpointRegistry 클라이언트 개체를 만듭니다.
ServiceClientFactory
연결 속성을 포함하는 객체입니다.EndpointRegistryClient
생성자를 사용하여 객체를 전달하고 ServiceClientFactory
개체.수정할 끝점을 검색합니다.
EndpointRegistryClient
개체 getEndpoints
메서드 및 전달 PagingFilter
필터 역할을 하는 개체입니다. 다음 정보를 (PagingFilter)null
모든 끝점을 반환하는 값입니다. 이 메서드는 java.util.List
각 요소가 인 객체 Endpoint
개체. 에 대한 정보 PagingFilter
개체 AEM Forms API 참조.java.util.List
개체에 끝점이 있는지 여부를 확인하는 개체입니다. 끝점이 있으면 각 요소는 EndPoint
인스턴스.EndPoint
개체 getServiceId
메서드를 사용합니다. 이 메서드는 서비스 이름을 지정하는 문자열 값을 반환합니다.EndPoint
개체 getConnectorId
메서드를 사용합니다. 이 메서드는 끝점의 유형을 지정하는 문자열 값을 반환합니다. 예를 들어 종단점이 Observed Folder 종단점이면 이 메서드는 를 반환합니다 WatchedFolder
.새 구성 값을 지정합니다.
만들기 ModifyEndpointInfo
개체를 생성자로 호출하여 개체를 가져옵니다.
설정할 각 구성 값에 대해 ModifyEndpointInfo
개체 setConfigParameterAsText
메서드를 사용합니다. 예를 들어 url 구성 값을 설정하려면 ModifyEndpointInfo
개체 setConfigParameterAsText
메서드를 사용하여 다음 값을 전달합니다.
url
구성 값, 지정 url
.url
구성 값에서 감시 폴더 위치를 지정합니다.를 호출합니다 EndpointRegistryClient
개체 modifyEndpoint
메서드 및 전달 ModifyEndpointInfo
개체.
추가 참조
빠른 시작: Java API를 사용하여 엔드포인트 수정
AEM Forms Java API를 사용하여 서비스에서 종단점을 프로그래밍 방식으로 제거할 수 있습니다. 끝점을 제거하면 끝점이 활성화된 호출 메서드를 사용하여 서비스를 호출할 수 없습니다. 예를 들어 서비스에서 SOAP 종단점을 제거하는 경우 SOAP 모드를 사용하여 서비스를 호출할 수 없습니다.
서비스에서 끝점을 제거하는 방법을 보여 주기 위해 이 섹션은 이름이 지정된 서비스에서 EJB 끝점을 제거합니다 EncryptDocument.
웹 서비스를 사용하여 끝점을 제거할 수 없습니다.
서비스에서 끝점을 제거하려면 다음 작업을 수행합니다.
EndpointRegistryClient
개체.프로젝트 파일 포함
필요한 파일을 개발 프로젝트에 포함합니다. Java를 사용하여 클라이언트 응용 프로그램을 만드는 경우 필요한 JAR 파일을 포함하십시오. 웹 서비스를 사용하는 경우 프록시 파일을 포함해야 합니다.
프로젝트의 클래스 경로에 다음 JAR 파일을 추가해야 합니다.
이러한 JAR 파일의 위치에 대한 자세한 내용은 AEM Forms Java 라이브러리 파일 포함.
EndpointRegistry 클라이언트 개체 만들기
엔드포인트를 프로그래밍 방식으로 제거하려면 EndpointRegistryClient
개체.
제거할 끝점을 검색합니다.
끝점을 제거하려면 먼저 엔드포인트를 검색해야 합니다. 끝점을 검색하려면 엔드포인트에 액세스할 수 있는 사용자로 연결해야 합니다. 관리자로 연결하는 것이 좋습니다. (자세한 내용은 연결 속성 설정).
끝점 목록을 검색하여 끝점을 검색할 수 있습니다. 그런 다음 목록을 반복하여 제거할 특정 끝점을 검색할 수 있습니다. 예를 들어 종단점에 해당하는 서비스와 종단점 유형을 파악하여 종단점을 찾을 수 있습니다. 끝점을 찾으면 제거할 수 있습니다.
끝점 제거
새 끝점을 만든 후 활성화해야 합니다. 엔드포인트가 활성화되면 서비스를 호출하는 데 사용할 수 있습니다. 끝점을 활성화하면 관리 콘솔 내에서 볼 수 있습니다.
추가 참조
Java API를 사용하여 엔드포인트를 제거합니다.
프로젝트 파일을 포함합니다.
Java 프로젝트의 클래스 경로에 adobe-livecycle-client.jar와 같은 클라이언트 JAR 파일을 포함합니다.
EndpointRegistry 클라이언트 개체를 만듭니다.
ServiceClientFactory
연결 속성을 포함하는 객체입니다.EndpointRegistryClient
생성자를 사용하여 객체를 전달하고 ServiceClientFactory
개체.제거할 끝점을 검색합니다.
EndpointRegistryClient
개체 getEndpoints
메서드 및 전달 PagingFilter
필터 역할을 하는 개체입니다. 통과하시면 됩니다 (PagingFilter)null
모든 끝점을 반환하려면 다음을 수행하십시오. 이 메서드는 java.util.List
각 요소가 인 객체 Endpoint
개체.java.util.List
개체에 끝점이 있는지 여부를 확인하는 개체입니다. 끝점이 있으면 각 요소는 EndPoint
인스턴스.EndPoint
개체 getServiceId
메서드를 사용합니다. 이 메서드는 서비스 이름을 지정하는 문자열 값을 반환합니다.EndPoint
개체 getConnectorId
메서드를 사용합니다. 이 메서드는 끝점의 유형을 지정하는 문자열 값을 반환합니다. 예를 들어 종단점이 EJB 종단점이면 이 메서드는 를 반환합니다 EJB
.끝점을 제거합니다.
를 호출하여 끝점을 제거합니다 EndpointRegistryClient
개체 remove
메서드 및 전달 EndPoint
제거할 끝점을 나타내는 개체입니다.
추가 참조
AEM Forms API를 사용하여 엔드포인트 커넥터에 대한 정보를 프로그래밍 방식으로 검색할 수 있습니다. 커넥터를 사용하면 엔드포인트가 다양한 호출 메서드를 사용하여 서비스를 호출할 수 있습니다. 예를 들어 감시 폴더 커넥터를 사용하면 엔드포인트가 감시 폴더를 사용하여 서비스를 호출할 수 있습니다. endpoint connectors에 대한 정보를 프로그래밍 방식으로 검색하면 필요한 구성 값 및 선택 사항 등의 커넥터와 연결된 구성 값을 검색할 수 있습니다.
endpoint connectors에 대한 정보를 검색하는 방법을 보여 주기 위해 이 섹션은 감시 폴더 커넥터에 대한 정보를 검색합니다. (자세한 내용은 감시 폴더 끝점 추가)
웹 서비스를 사용하여 끝점에 대한 정보를 검색할 수 없습니다.
이 항목에서는 ConnectorRegistryClient
엔드포인트 커넥터에 대한 정보를 검색하기 위한 API입니다. (자세한 내용은 AEM Forms API 참조)
끝점 커넥터 정보를 검색하려면 다음 작업을 수행하십시오.
ConnectorRegistryClient
개체.프로젝트 파일 포함
필요한 파일을 개발 프로젝트에 포함합니다. Java를 사용하여 클라이언트 응용 프로그램을 만드는 경우 필요한 JAR 파일을 포함하십시오. 웹 서비스를 사용하는 경우 프록시 파일을 포함해야 합니다.
프로젝트의 클래스 경로에 다음 JAR 파일을 추가해야 합니다.
AEM Forms이 JBoss가 아닌 지원되는 J2EE 애플리케이션 서버에 배포된 경우, adobe-utilities.jar 및 jbossall-client.jar를 AEM Forms이 배포된 J2EE 애플리케이션 서버와 관련된 JAR 파일로 대체합니다. 모든 AEM Forms JAR 파일의 위치에 대한 자세한 내용은 AEM Forms Java 라이브러리 파일 포함.
ConnectorRegistry 클라이언트 개체 만들기
엔드포인트 커넥터 정보를 프로그래밍 방식으로 검색하려면 ConnectorRegistryClient
개체.
커넥터 유형을 지정합니다
정보를 검색할 커넥터의 유형을 지정합니다. 다음 유형의 커넥터가 있습니다.
구성 값 검색
커넥터 유형을 지정한 후 지원되는 구성 값과 같은 커넥터에 대한 정보를 검색할 수 있습니다. 예를 들어, 어떤 커넥터의 경우 필수 구성 값과 선택적 구성 값을 결정할 수 있습니다.
추가 참조
Java API를 사용하여 끝점 커넥터 정보를 검색합니다
Java API를 사용하여 엔드포인트 커넥터 정보를 검색합니다.
프로젝트 파일을 포함합니다. .
Java 프로젝트의 클래스 경로에 adobe-livecycle-client.jar와 같은 클라이언트 JAR 파일을 포함합니다.
ConnectorRegistry 클라이언트 개체를 만듭니다.
ServiceClientFactory
연결 속성을 포함하는 객체입니다.ConnectorRegistryClient
생성자를 사용하여 객체를 전달하고 ServiceClientFactory
개체.커넥터 유형을 지정합니다.
를 호출하여 커넥터 유형을 지정합니다 ConnectorRegistryClient
개체 getEndpointDefinition
메서드 및 커넥터 유형을 지정하는 문자열 값 전달 예를 들어 감시 폴더 커넥터 유형을 지정하려면 문자열 값을 전달합니다 WatchedFolder
. 이 메서드는 Endpoint
커넥터 유형에 해당하는 개체입니다.
구성 값을 검색합니다.
Endpoint
개체 getConfigParameters
메서드를 사용합니다. 이 메서드는 ConfigParameter
개체.ConfigParameter
개체. 예를 들어, ConfigParameter
개체 isRequired
메서드를 사용합니다. 구성 값이 필요한 경우 이 메서드는 를 반환합니다 true
.추가 참조
빠른 시작: Java API를 사용하여 끝점 커넥터 정보 검색