다음을 통해 공유


formContext.data.process(클라이언트 API 참조)

폼의 비즈니스 프로세스 흐름 데이터와 상호 작용하는 이벤트, 메서드 및 개체를 제공합니다. 양식에서 비즈니스 프로세스 흐름 제어와 상호 작용하는 방법은 formContext.ui.process(클라이언트 API 참조) 를 참조하세요.

프로세스 이벤트 및 이벤트 처리기 메서드

다음 이벤트 및 이벤트 처리기 메서드를 사용하여 비즈니스 프로세스 흐름에 대한 스크립트를 작성합니다.

Event 이벤트 처리기 메서드
OnPreProcessStatusChange addOnPreProcessStatusChange
removeOnPreProcessStatusChange
OnProcessStatusChange addOnProcessStatusChange
removeOnProcessStatusChange
OnPreStageChange addOnPreStageChange
removeOnPreStageChange
OnStageChange addOnStageChange
removeOnStageChange
OnStageSelected addOnStageSelected
removeOnStageSelected

활성 프로세스 메서드

이러한 메서드를 사용하여 활성 프로세스에 대한 정보를 검색하고 다른 프로세스를 활성 프로세스로 설정합니다.

이름 Description
getActiveProcess 활성 프로세스를 나타내는 Process 개체를 반환합니다.
setActiveProcess 프로세스를 활성 프로세스로 설정합니다.

프로세스 메서드

프로세스에는 비즈니스 프로세스 흐름에 대한 데이터가 포함됩니다. 메서드를 사용하여 프로세스의 속성에 액세스합니다.

이름 Description
getId 프로세스의 고유 식별자를 반환합니다.
getName 프로세스의 이름을 반환합니다.
getStages 프로세스의 단계 컬렉션을 반환합니다.
isRendered 프로세스가 렌더링되는지 여부를 나타내는 부울 값을 반환합니다.

ProcessInstance 메서드

이러한 메서드를 사용하여 레코드의 모든 프로세스 인스턴스에 대한 정보를 검색하고 프로세스 인스턴스를 활성 인스턴스로 설정합니다.

이름 Description
getProcessInstances 호출하는 사용자가 액세스할 수 있는 테이블 레코드의 모든 프로세스 인스턴스를 반환합니다.
setActiveProcessInstance 프로세스 인스턴스를 활성 인스턴스로 설정합니다.

인스턴스 메서드

프로세스 인스턴스에는 비즈니스 프로세스 흐름 인스턴스에 대한 데이터가 포함됩니다. 메서드를 사용하여 프로세스 인스턴스의 속성에 액세스합니다.

이름 Description
getInstanceId 프로세스 인스턴스의 고유 식별자를 반환합니다.
getInstanceName 프로세스 인스턴스의 이름을 반환합니다.
getStatus 프로세스 인스턴스의 현재 상태를 반환합니다.
setStatus 활성 프로세스 인스턴스의 현재 상태를 설정합니다.

활성 단계 메서드

이러한 메서드를 사용하여 활성 단계에 대한 정보를 검색하고 다른 스테이지를 활성 스테이지로 설정합니다.

이름 Description
getActiveStage 활성 스테이지를 나타내는 Stage 개체를 반환합니다.
setActiveStage 완료된 스테이지를 활성 스테이지로 설정합니다.

Stage 메서드

스테이지에는 비즈니스 프로세스 흐름의 스테이지에 대한 데이터가 포함됩니다. 메서드를 사용하여 스테이지의 속성에 액세스합니다.

이름 Description
getCategory 비즈니스 프로세스 흐름 범주의 정수 값을 반환하는 getValue 메서드를 사용하여 개체를 반환합니다.
getEntityName 스테이지와 연결된 테이블의 논리적 이름을 반환합니다.
getId 스테이지의 고유 식별자를 반환합니다.
getName 스테이지의 이름을 반환합니다.
getNavigationBehavior 사용자가 테이블 간 비즈니스 프로세스 흐름 탐색 시나리오에서 다른 테이블 레코드를 만들 수 있도록 만들기 단추를 사용할 수 있는지 여부를 정의하는 데 사용할 수 있는 단계에 대한 탐색 동작 개체를 반환합니다.
getStatus 스테이지의 상태를 반환합니다.
getSteps 단계의 단계 컬렉션을 반환합니다.

단계 메서드

단계에는 비즈니스 프로세스 흐름의 단계에서 단계에 대한 데이터가 포함됩니다. 메서드를 사용하여 단계의 속성에 액세스합니다.

이름 Description
getAttribute 단계에 연결된 열의 논리적 이름을 반환합니다.
getName 단계의 이름을 반환합니다.
getProgress 작업 단계의 진행률을 반환합니다.
isRequired 비즈니스 프로세스 흐름에서 단계가 필요한지 여부를 나타내는 부울 값을 반환합니다.
setProgress 작업 단계의 진행률을 업데이트합니다.

다음 단계와 이전 단계로 이동하려면 이러한 메서드를 사용합니다. 두 방법 모두 OnStageChange 이벤트가 발생합니다.

이름 Description
moveNext 다음 단계로 진행합니다.
movePrevious 이전 단계로 이동합니다.

기타 유용한 방법

이러한 메서드를 사용하여 활성 경로, 활성화된 프로세스 및 선택한 스테이지의 단계에 대한 정보를 찾을 수 있습니다.

이름 Description
getActivePath 비즈니스 프로세스 흐름 제어에 표시된 스테이지와 상호 작용하는 메서드를 사용하여 현재 활성 경로에 있는 스테이지 컬렉션을 가져옵니다.
getEnabledProcesses 현재 사용자가 전환할 수 있는 테이블에 대해 사용하도록 설정된 비즈니스 프로세스 흐름을 비동기적으로 검색합니다.
getSelectedStage 현재 선택된 스테이지를 가져옵니다.

formContext.ui.process(클라이언트 API 참조)
Xrm 개체 모델 이해
컨트롤(클라이언트 API 참조)