BusinessFlowManagerService 인터페이스

BusinessFlowManagerService 인터페이스는 클라이언트 응용프로그램에 피호출되는 비즈니스 프로세스 기능을 표시합니다.

BusinessFlowManagerService 인터페이스에서 호출할 수 있는 메소드는 프로세스 상태 또는 해당 메소드를 포함하는 응용프로그램을 사용하는 사용자의 활동 및 권한에 따라 다릅니다. 비즈니스 프로세스 오브젝트를 조작하는 기본 메소드는 다음과 같습니다. 이 메소드 및 BusinessFlowManagerService 인터페이스에서 사용할 수 있는 기타 메소드에 대한 자세한 정보는 com.ibm.bpe.api 패키지의 Javadoc을 참조하십시오.

프로세스 템플리트

프로세스 템플리트는 비즈니스 프로세스의 스펙을 포함하는 버전이 지정되고 전개되며 설치된 프로세스 모델입니다. 해당 요청(예: sendMessage())을 발행하여 프로세스 템플리트를 인스턴스화하고 시작할 수 있습니다. 프로세스 인스턴스는 서버에서 자동으로 실행됩니다.

표 1. 프로세스 템플리트의 API 메소드
메소드 설명
getProcessTemplate 지정된 프로세스 템플리트를 검색합니다.
queryProcessTemplate 데이터베이스에 저장되는 프로세스 템플리트를 검색합니다.

프로세스 인스턴스

다음 API 메소드는 프로세스 인스턴스를 시작합니다.

표 2. 프로세스 인스턴스를 시작하기 위한 API 메소드
메소드 설명
call 마이크로플로우를 작성하고 실행합니다.
callWithReplyContext 고유 시작 서비스가 있는 마이크로플로우 또는 지정된 프로세스 템플리트의 고유 시작 서비스가 있는 장기 실행 프로세스를 작성하고 실행합니다. 이 호출은 비동기적으로 결과를 기다립니다.
callWithUISettings 마이크로플로우를 작성 및 실행하고 출력 메시지 및 클라이언트 사용자 인터페이스(UI) 설정을 리턴합니다.
initiate 프로세스 인스턴스를 작성하고 프로세스 인스턴스의 처리를 시작합니다. 장기 실행 프로세스에 이 메소드를 사용하십시오. 또한 해제하거나 잊어버리려는 마이크로플로우에 대해서도 이 메소드를 사용할 수 있습니다.
sendMessage 지정된 메시지를 지정된 활동 서비스 및 프로세스 인스턴스에 전송합니다. 동일한 상관 세트 값을 가진 프로세스 인스턴스가 없는 경우에는 새로 작성됩니다. 프로세스에는 고유하거나 고유하지 않은 시작 서비스가 있을 수 있습니다.
getStartActivities 지정된 프로세스 템플리트에서 프로세스 인스턴스를 시작할 수 있는 활동 정보를 리턴합니다.
getActivityServiceTemplate 지정된 활동 서비스 템플리트를 검색합니다.
표 3. 프로세스 인스턴스의 라이프 사이클을 제어하는 API 메소드
메소드 설명
suspend 실행 중 또는 실패 상태의 장기 실행, 맨 위 레벨 프로세스 인스턴스의 실행을 일시중단합니다.
resume 일시중단 상태의 장기 실행, 맨 위 레벨 프로세스 인스턴스의 실행을 재개합니다.
restart 완료, 실패 또는 종료 상태의 장기 실행, 맨 위 레벨 프로세스 인스턴스를 재시작합니다.
forceTerminate 지정된 맨 위 레벨 프로세스 인스턴스, 하위 자율성이 있는 서브프로세스 및 실행 중이거나 청구되거나 대기 중인 활동을 종료합니다.
delete 지정된 맨 위 레벨 프로세스 인스턴스 및 하위 자율성이 있는 서브프로세스를 삭제합니다.
query 검색 기준에 일치하는 데이터베이스의 특성을 검색합니다.

활동

invoke 활동의 경우 프로세스 모델에서 이 활동이 오류 상태에서 계속되도록 지정할 수 있습니다. continueOnError 플래그가 false로 설정되어 처리되지 않은 오류가 발생한 경우 활동이 중지 상태가 됩니다. 그런 다음 프로세스 관리자가 활동을 복구할 수 있습니다. 예를 들어, continueOnError 플래그 및 연관된 복구 기능은 invoke 활동이 실패하기도 하는 장기 실행 프로세스에 사용될 수 있지만 보상 모델화 및 결함 처리에 너무 많은 노력이 필요합니다.

활동에 대한 작업 및 복구에 다음 메소드를 사용할 수 있습니다.

표 4. 활동 인스턴스의 라이프 사이클 제어용 API 메소드
메소드 설명
claim 사용자가 활동 작업을 할 수 있도록 준비 활동 인스턴스를 청구합니다.
cancelClaim 활동 인스턴스의 청구를 취소합니다.
complete 활동 인스턴스를 완료합니다.
completeAndClaimSuccessor 스태프 활동을 완료하며 로그온한 사용자에 대한 동일한 프로세스 인스턴스의 다음 활동을 청구합니다.
forceComplete 실행 또는 중지 상태의 활동 인스턴스를 강제로 완료합니다.
forceRetry 실행 또는 중지 상태의 활동 인스턴스를 강제 반복합니다.
query 검색 기준에 일치하는 데이터베이스의 특성을 검색합니다.

변수 및 사용자 정의 특성

인터페이스는 변수값 검색 및 설정에 사용되는 get 및 set 메소드를 제공합니다. 이름 지정된 특성을 프로세스 및 활동 인스턴스와 연관시키고 프로세스 및 활동 인스턴스에서 이름 지정된 특성을 검색할 수 있습니다. 사용자 정의 특성 이름 및 값은 java.lang.String 유형이어야 합니다.

표 5. 변수 및 사용자 정의 특성에 대한 API 메소드
메소드 설명
getVariable 지정된 변수를 검색합니다.
setVariable 지정된 변수를 설정합니다.
getCustomProperty 지정된 활동 또는 프로세스 인스턴스의 이름 지정된 사용자 정의 특성을 검색합니다.
getCustomProperties 지정된 활동 또는 프로세스 인스턴스의 사용자 정의 특성을 검색합니다.
getCustomPropertyNames 지정된 활동 또는 프로세스 인스턴스의 사용자 정의 특성 이름을 검색합니다.
setCustomProperty 지정된 활동 또는 프로세스 인스턴스의 사용자 정의 특정 값을 저장합니다.
관련 정보
사용이 권장되지 않는 기능

ⓒ Copyright IBM Corporation 2005, 2006.
이 Information Center는 Eclipse 기술을 기반으로 합니다. (http://www.eclipse.org)