플로우 인스턴스 속성
Flow 인스턴스 속성은 서로 다른 태스크와 의사 결정 지점 간의 데이터 교환에 사용되어 원하는 비즈니스 기능을 구현합니다.
소개
‘실행 (Execution)’ URL 는 ‘플로우 디자이너 관리 ’에 설명된 지침에 따라 특정 플로우가 구성 및 게시된 후 시스템에서 공유됩니다. URL 를 클릭할 때마다 해당 플로우의 새로운 인스턴스가 생성됩니다. 이러한 각 인스턴스에 대해 일련의 기본 속성 또는 내장 속성이 설정됩니다. 기본 속성 외에도, 사용 중인 작업에 따라 일련의 사용자 정의 속성을 추가할 수 있습니다.
이러한 속성은 서로 다른 작업 및 의사 결정 지점 간의 데이터 교환에 사용되어 올바른 비즈니스 기능을 구축하는 데 도움을 줍니다.
플로우 인스턴스 속성
각 인스턴스가 트리거될 때마다 초기화되는 기본 속성 목록은 다음을 참조하십시오.
| 속성 이름 | 설명 | 유형 |
|---|---|---|
__tenantid |
사용자가 속한 테넌트의 이름. | 문자열 |
__locale |
사용자 인터페이스에 대한 언어 또는 국가 기반 설정 모음. | 문자열 |
status |
작업의 상태(성공 또는 실패). | 문자열 |
statusDetails |
작업의 상태 설명. | 문자열 |
error |
플로우에서 발생한 오류와 관련된 세부 정보를 조회하는 객체입니다. | JSON |
themeId |
사용자가 해당 플로우에 적용하고자 하는 사용자 지정 테마의 UUID. URL 흐름이 트리거될 때, 이를 쿼리 매개변수로 선언해야 합니다. | 문자열 |
user |
CD에서 가져온 사용자 정보. | scim |
- 작업이 실행되는 동안 특정 작업의 출력 매개변수가 워크플로 컨텍스트에 추가됩니다.
- 각 작업이 시작될 때마다 속성의 상태, 상태 세부 정보 및 오류 정보가 초기화됩니다. Page 의 경우, 해당 값을 사용하여 사용자에게 관련 오류나 상태 정보를 표시할 수 있습니다.
- URL 의 실행 시, 추가 쿼리 매개변수를 사용하여 기본 속성 외에도 새로운 속성을 삽입할 수 있습니다.
- ‘페이지’ 작업에서 구성된 입력 필드도 플로우 인스턴스에 저장됩니다.
<input type="text" name="username"></input>예를 들어, 페이지 작업에 입력 필드가 있는 경우, "username" 속성이 플로우 인스턴스에 저장되며, 이는 입력 필드에 입력된 이름에 해당합니다
| 속성 이름 | 설명 | 유형 |
|---|---|---|
applicationId |
액세스를 요청하는 애플리케이션의 ID. | 문자열 |
requestorId |
액세스를 요청한 사용자의 ID. | 문자열 |
requestId |
승인 작업 시작을 통해 생성된 요청의 ID입니다. | 문자열 |
entitlementId |
접근 권한이 요청된 권한의 ID. | 문자열 |
플로우 인스턴스의 오류 속성
플로우 실행 중에 오류가 발생하면, 해당 플로우 인스턴스에 오류 속성이 생성됩니다. 이 오류는 JSON 유형입니다.
복구 불가능한 오류가 발생하면 흐름이 기본 error_page로 리디렉션되고 인스턴스가 종료됩니다. 복구 가능한 오류의 경우, 다음 조치를 결정하는 것은 사용자의 몫입니다. 결정은 error 속성에 포함된 messageId,, messageDescription, 또는 taskName, 을 기준으로 내릴 수 있습니다.
failed특정 작업에서 오류가 발생하면, 해당 작업의 상태 는.
템플릿 렌더링 중 속성 사용
다른 작업과 마찬가지로, 페이지 작업 수행 중에도 플로우 인스턴스 속성을 사용할 수 있습니다. 이러한 속성을 활용하면 매크로를 대체하고, 다양한 비즈니스 시나리오에 필요한 유용한 오류 페이지나 입력 양식을 생성할 수 있습니다. 이 속성들은 다음과 같이 매크로로 사용할 수 있습니다: @context.propertyName@.
특정 속성이 중첩되어 있는 경우, 매크로는 다음과 같이 구성할 수 있습니다: @context.propertyName.nestedPropertyName@.
오류 속성의 예를 하나 살펴보겠습니다. @context.error@흐름도가 설계되는 동안 해당 속성에 다음과 같이 접근할 수 있습니다. 마찬가지로, 해당 오류에 해당하는 오류 디스패처( messageId )는 다음을 사용하여 확인할 수 있습니다: @context.error.messageId@.
사용자는 속성 이름과 '.'을 지정하여 매크로를 통해 해당 속성 내의 n번째 레벨 노드에 접근할 수 있습니다 구분 기호입니다.