흐름 내 표현 지원

이 표현식은 플로우 인스턴스 런타임 내에서 속성에 접근하는 데 사용할 수 있습니다.

개요

‘실행(Execution)’ URL 을 사용하여 플로우가 트리거되면, 일련의 기본 또는 내장 속성이 해당 플로우 인스턴스에 설정됩니다. 또한, 일부 속성에는 해당 플로우 내에서 사용되는 작업들이 할당됩니다.

이 문서는 식에서 사용되는 다양한 함수나 조건 연산자들을 보여줍니다.

사용자는 특정 플로우의 작업 및 결정 지점에서 표현식을 선언할 때 정해진 구문을 따라야 합니다. @표현은 로 @context 시작하고 로 끝나야 합니다. 예를 들어, @context.__tenantid@입니다.

참고: 이 문서에서 속성 설명에 사용된 예시는 여기 에서 확인할 수 있습니다.

플로우 인스턴스 속성에 액세스하기

각 플로우 인스턴스 속성에는 고유한 유형이 있습니다. 따라서 속성 값에 접근하는 방식은 해당 속성의 유형에 따라 달라집니다. 지원되는 속성 유형은 'String', 'Number', 'Boolean', 'JSON' 및 'Array'입니다. 각기 다른 부동산 유형을 어떻게 활용할 수 있는지 알아보려면 아래에 제공된 자세한 내용을 참고하시기 바랍니다.

  • @context.propertyName@문자열, 부울 값 또는 숫자는.로 접근할 수 있습니다. 예를 들면 다음과 같습니다.
    • 상태 - @context.status@
    • __tenantid - @context.__tenantid@
    • __locale - @context.__locale@
  • .중첩된 JSON 속성은 '' 구분을 사용하거나 대괄호를 사용하여 [] 접근할 수 있습니다. 예를 들면 다음과 같습니다.
    • userName 사용자 속성에서 - @context.user.id@
    • messageId 오류 속성에서 - @context.error.messageId@
    • 사용자 속성의 ID - @context.user['id']@
    참고:
    • 중괄호는 [] 하위 속성에만 접근할 때 사용해야 합니다.
    • .'' 구두점이 포함된 중첩 속성은 반드시 대괄호 안에 [] 포함되어야 합니다.
  • 배열 속성은 괄호 [] 안에 필요한 인덱스를 넣어 접근할 수 있습니다. 예를 들면 다음과 같습니다.
    • 사용자 속성의 이메일 - @context.user.emails[0].value@ 또는 @context.user['emails'][0].value@
    • 사용자 속성에서 가져온 사용자 정의 속성 이름 - @context.user['urn:ietf:params:scim:schemas:extension:ibm:2.0:User'].customAttributes[0].name@

입력 매개변수에서의 표현식 사용

이 표현식을 사용하면 태스크의 입력 매개변수 내 인스턴스 속성에 접근할 수 있습니다. 입력 매개변수는 연산자와 함께 표현식도 지원합니다. 입력 매개변수에서는 이항 연산자와 삼항 연산자를 식과 함께 사용할 수 있습니다. 다음 예시를 참고하십시오

  • 속성 열기 - @context.themeId@
  • 이항 연산자 -를 사용하여 @context.user.userName@ == "Jessica Hill"
  • 삼항 연산자 사용 - @context.user['urn:ietf:params:scim:schemas:extension:ibm:2.0:User'].userCategory@ == "regular" ? @context.basicLdapUrl@ : @context.federatedUrl@
참고: 신호 입력 매개변수는 수식을 지원하지 않습니다. 제공된 모든 콘텐츠는 문자열로 처리됩니다.

조건 빌더

조건점 결정 경로는 조건 생성기를 기반으로 구축됩니다. 조건 지점의 나가는 시퀀스 흐름에서 조건 생성기를 사용할 수 있습니다. 조건 생성기는 'if' 조건 집합으로 시작하며, 'or' 조건 집합을 0개 이상 포함할 수 있습니다. 각 조건 집합에는 여러 조건이 포함될 수 있습니다. 각 조건은 속성, 연산자, 의 세 부분으로 나뉩니다.

‘속성’ 섹션에서 사용자는 미리 정의된 속성 드롭다운 목록에서 속성을 선택하거나 사용자 정의 플로우 인스턴스 속성을 직접 입력할 수 있습니다.
@참고: 사용자 정의 플로우 인스턴스 속성은 로 @context 시작하고 로 끝나야 합니다. @context.responseCode@예를 들어, 라는 responseCode 사용자 정의 속성에 접근하려면 사용자는 - 를 입력하면 됩니다.

'값' 섹션은 문자열, 숫자, 부울 값 및 흐름 표현식을 입력으로 지원합니다.

참고: 기본 플로우 인스턴스 속성 목록과 해당 데이터 유형은 여기 에서 확인할 수 있습니다.
조건 생성기는 조건을 구성할 수 있도록 미리 정의된 연산자 목록을 제공합니다. 이 표는 조건 생성기에서 지원하는 연산자 목록을 보여줍니다.
연산자 지원되는 데이터 유형 설명 예제
equal to 문자열, 숫자 및 부울 비교 대상인 속성과 값은 서로 동일합니다. @context.status@ 실패한 것과 다름없다.
not equal to 문자열, 숫자 및 부울 비교 대상인 속성과 값의 값이 일치하지 않습니다. @context.themeId@ 기본 값과 다릅니다.
less than 숫자 비교 대상 속성의 값이 해당 값보다 작습니다. @context.numericProperty@ (현재 컨텍스트에 ` numericProperty `라는 변수가 있다고 가정할 때) 2 0보다 작다.
less than or equal to 숫자 비교 대상 속성은 해당 값보다 작거나 같습니다. @context.numericProperty@ 20 이하.
greater than 숫자 비교 대상 속성의 값이 해당 값보다 큽니다. @context.numericProperty@ 2 0보다 크다.
greater than or equal to 숫자 비교 대상 속성의 값이 해당 값보다 크거나 같습니다. @context.numericProperty@ 20 이상.
is true 부울 속성 값은 true로 평가됩니다. @context.booleanProperty@ (현재 컨텍스트에 ` booleanProperty `라는 변수가 있다고 가정할 때) 참이다.
is false 부울 속성 값은 false로 평가됩니다. @context.booleanProperty@ 는 거짓이다.
has property _ 이 속성에는 value에 언급된 속성이 포함되어 있습니다. @context.user.name@ givenName 속성을 가집니다
is not null 문자열, 숫자 및 부울 이 속성은 null이 아닙니다. @context.user.name.givenName@ null이 아닙니다.
is not empty 문자열 속성이 비어 있지 않습니다. @context.user.name.givenName@ 비어 있지 않습니다.
참고:
  • is true, is false, is not null, 및 is not empty 연산자는 ‘값’ 섹션이 필요하지 않습니다.
  • 복잡한 조건을 계산하려면 사용자는 ‘함수’ 태스크를 사용해야 합니다. 예를 들어, 특정 속성을 기준으로 사용자 목록에서 특정 사용자를 필터링하는 경우입니다. 필터링된 사용자는 해당 표현식을 사용하여 조회할 수 있습니다.
  • 데이터 유형을 "" 안에 넣으면 String으로 변환할 수 있습니다. 예를 들어, 숫자 10은 "10"이라는 문자열로 변환될 수 있으며, 부울 값 true는 "true"라는 문자열로 변환될 수 있습니다.