참고
Microsoft Purview 데이터 카탈로그(클래식) 및 Data Health Insights(클래식)는 더 이상 새 고객을 이용하지 않으며 이러한 서비스(이전의 Azure Purview)는 이제 고객 지원 모드에 있습니다.
중요
이 기능은 현재 미리 보기로 제공됩니다. Microsoft Azure Preview에 대한 추가 사용 약관에는 베타, 미리 보기 또는 아직 일반 공급으로 릴리스되지 않은 Azure 기능에 적용되는 추가 법적 조건이 포함됩니다.
Microsoft Purview 워크플로 내에서 동적 콘텐츠를 사용하여 워크플로의 특정 변수를 연결하거나 이러한 값을 처리하는 다른 식을 추가할 수 있습니다.
워크플로에 동적 콘텐츠를 추가할 때 워크플로에서 정보를 참조하고 처리하는 제공된 구성 요소에서 식을 작성하여 필요한 값을 실시간으로 가져올 수 있습니다.
동적 콘텐츠 메뉴에서 현재 사용 가능한 옵션은 다음과 같습니다.
기본 제공 변수
현재 Microsoft Purview의 워크플로 커넥터에 사용할 수 있는 변수는 다음과 같습니다.
| 필수 구성 요소 커넥터 | 기본 제공 변수 | 기능 | 유형 | 사용 가능한 값 |
|---|---|---|---|---|
| 데이터 액세스 요청이 제출되는 경우 자산 업데이트 요청이 제출되는 경우 |
Workflow.Requestor | 워크플로 요청자의 ID입니다. | 문자열 | |
| Asset.Name | 자산의 이름 | 문자열 | ||
| Asset.Description | 자산에 대한 설명 | string 또는 null | ||
| Asset.Type | 자산의 형식 | 문자열 | ||
| Asset.정규화된 이름 | 자산의 정규화된 이름 | 문자열 | ||
| Asset.Owner | 자산의 데이터 소유자 ID | 문자열의 배열 | ||
| Asset.Classification | 자산 분류의 표시 이름 | 문자열의 배열 | ||
| Asset.Schema.Classification | 자산 스키마의 열에 적용된 분류의 표시 이름 | 문자열의 배열 | ||
| Asset.Is 인증됨 | 자산이 organization 품질 표준을 충족하고 신뢰할 수 있는 것으로 간주될 수 있는지 여부를 나타내는 지표입니다. | 부울 |
true 또는 false |
|
| 데이터 액세스 요청이 제출되는 경우 | Workflow.Request Recipient | 워크플로의 요청 받는 사람의 ID입니다. | 문자열 | |
| 승인 시작 및 대기 | Approval.Outcome | 승인 결과 | 문자열 |
'Approved' 또는 'Rejected' |
| Approval.Assigned To | 승인자의 ID | 문자열의 배열 | ||
| Approval.Comments | 승인자의 이름 및 해당 의견 | 문자열 | ||
| 데이터 사용 거버넌스에 대한 데이터 원본 등록 확인 | 데이터 사용 거버넌스 | 데이터 사용 거버넌스 검사 결과 | 부울 |
true 또는 false |
| 용어 만들기 요청이 제출되는 경우 | Workflow.Requestor | 워크플로 요청자의 ID입니다. | 문자열 | |
| Term.Name | 용어의 이름 | 문자열 | ||
| Term.Formal 이름 | 용어의 정식 이름입니다. | 문자열 | ||
| Term.Definition | 용어의 정의 | 문자열 | ||
| Term.Experts | 용어 전문가의 ID | 문자열의 배열 | ||
| Term.Stewards | 용어의 청지기의 ID | 문자열의 배열 | ||
| Term.Parent.Name | 있는 경우 부모 용어의 이름입니다. | 문자열 | ||
| Term.Parent.Formal 이름 | 부모 용어의 정식 이름(있는 경우) | 문자열 | ||
| 용어 업데이트 요청이 제출되는 경우 용어 삭제 요청이 제출되는 경우 |
Workflow.Requestor | 워크플로의 요청자 | 문자열 | |
| Term.Name | 용어의 이름 | 문자열 | ||
| Term.Formal 이름 | 용어의 정식 이름입니다. | 문자열 | ||
| Term.Definition | 용어의 정의 | string 또는 null | ||
| Term.Experts | 용어 전문가의 ID | 문자열의 배열 | ||
| Term.Stewards | 용어의 청지기의 ID | 문자열의 배열 | ||
| Term.Parent.Name | 있는 경우 부모 용어의 이름입니다. | 문자열 | ||
| Term.Parent.Formal 이름 | 부모 용어의 정식 이름(있는 경우) | 문자열 | ||
| Term.Created By | 용어 작성자의 ID입니다. | 문자열 | ||
| Term.Last Updated By | 용어의 마지막 업데이트자의 ID입니다. | 문자열 | ||
| 용어 가져오기 요청이 제출되는 경우 | Workflow.Requestor | 워크플로 요청자의 ID입니다. | 문자열 | |
| 가져오기 File.Name | 가져올 파일의 이름 | 문자열 | ||
| Http(Http) | Http.Body | HTTP 응답 본문 | 개체 또는 문자열 | |
| Http.Headers | HTTP 응답 헤더 | 개체 | ||
| Http.Status 코드 | HTTP 상태 코드 | 문자열 | ||
| 각각에 적용 | 항목 | 각 작업에 적용 작업의 현재 항목 | 모두 | |
| 까지 | 색인 | Until 작업의 현재 반복 인덱스 | integer | |
| 레코드 만들기 레코드 삭제 레코드 가져오기 레코드 업데이트 |
결과 | ServiceNow 작업의 결과 | 개체 | |
| 레코드 형식 가져오기 레코드 나열 |
결과 | ServiceNow 작업의 결과 | 개체의 배열 |
식
Microsoft Purview의 워크플로 정의를 사용하면 식의 함수를 사용하여 워크플로의 값을 처리할 수 있습니다.
범용에 따라 함수를 찾으려면 다음 표를 검토합니다. 또는 각 함수에 대한 자세한 내용은 사전순 목록을 참조하세요.
워크플로를 빌드하고 식에 함수를 추가하려는 경우 다음 단계를 수행합니다.
- 편집할 값을 선택합니다.
- 텍스트 상자 아래에 표시되는 동적 콘텐츠 추가 단추를 선택합니다.
- 동적 콘텐츠 창에서 식 탭을 선택하고 스크롤하여 값을 선택합니다.
- 식을 업데이트하고 확인을 선택하여 추가합니다.
고려 사항
함수 매개 변수는 왼쪽에서 오른쪽으로 평가됩니다.
일반 텍스트로 인라인으로 표시되는 함수는 식의 보간된 형식을 대신 사용하려면 중괄호({})를 묶어야 합니다. 이 형식은 구문 분석 문제를 방지하는 데 도움이 됩니다. 함수 식이 일반 텍스트로 인라인으로 표시되지 않으면 중괄호가 필요하지 않습니다.
다음 예제에서는 올바른 구문과 잘못된 구문을 보여줍니다.
정답입니다.
"<text>/@{<function-name>('<parameter-name>')}/<text>"틀렸습니다.
"<text>/@<function-name>('<parameter-name>')/<text>"함수에 오버로드가 있을 수 있습니다. 이 오버로드는 사용자가 제공하는 입력에 따라 이름이 같지만 작업을 수행하는 다양한 방법을 가진 함수의 여러 버전입니다.
다음 섹션에서는 범용에 따라 함수를 구성하거나 이러한 함수를 사전순으로 찾아볼 수 있습니다.
문자열 함수
문자열을 사용하려면 이러한 문자열 함수와 일부 컬렉션 함수를 사용할 수 있습니다. 문자열 함수는 문자열에서만 작동합니다.
| String 함수 | 작업 |
|---|---|
| endsWith | 문자열이 지정된 부분 문자열로 끝나는지 확인합니다. |
| startsWith | 문자열이 특정 부분 문자열로 시작하는지 확인합니다. |
컬렉션 함수
컬렉션, 일반적으로 배열, 문자열 및 경우에 따라 사전을 사용하려면 이러한 컬렉션 함수를 사용할 수 있습니다.
| 컬렉션 함수 | 작업 |
|---|---|
| 포함 | 컬렉션에 특정 항목이 있는지 확인합니다. |
| 길이 | 컬렉션의 항목 수 또는 문자열의 길이를 반환합니다. |
논리 비교 함수
조건을 사용하거나, 값과 식 결과를 비교하거나, 다양한 종류의 논리를 평가하려면 이러한 논리 비교 함수를 사용할 수 있습니다. 각 함수에 대한 전체 참조는 사전순 목록을 참조하세요.
| 논리 비교 함수 | 작업 |
|---|---|
| 아님 | 식이 false인지 확인합니다. 식이 false이면 true를 반환하거나 true이면 false를 반환합니다. |
| 및 | 모든 식이 true인지 확인합니다. 모든 식이 true이면 true를 반환하거나, 하나 이상의 식이 false이면 false를 반환합니다. |
| 또는 | 하나 이상의 식이 true인지 확인합니다. 하나 이상의 식이 true이면 true를 반환하거나, 모두 false이면 false를 반환합니다. |
| 같음 | 두 값이 동일한지 확인합니다. |
| 큰 | 첫 번째 값이 두 번째 값보다 큰지 확인합니다. |
| greaterOrEquals | 첫 번째 값이 두 번째 값보다 크거나 같은지 확인합니다. |
| 덜 | 첫 번째 값이 두 번째 값보다 작은지 확인합니다. |
| lessOrEquals | 첫 번째 값이 두 번째 값보다 작거나 같은지 확인합니다. |
사용자 함수
사용자, 다른 사용자 및 그룹과의 관계, 메일, 일정, 파일, 관리 역할, 그룹 멤버 자격 등 사용자가 액세스하는 리소스와 함께 작업합니다. 각 함수에 대한 전체 참조는 사전순 목록을 참조하세요.
| 사용자 함수 | 작업 |
|---|---|
| getUserName | 사용자의 이름을 가져옵니다. |
| getManager | 사용자 관리자의 ID를 가져옵니다. |
| memberOfGroup | 사용자가 그룹의 구성원인지 확인합니다. |
변환 함수
값의 형식 또는 형식을 변경하려면 이러한 변환 함수를 사용할 수 있습니다. 각 함수에 대한 전체 참조는 사전순 목록을 참조하세요.
| 변환 함수 | 작업 |
|---|---|
| createArray | 입력 수에서 배열을 반환합니다. |
| createObject | 빈 개체를 반환합니다. |
| 문자열 | 값에 대한 문자열 버전을 반환합니다. |
| int | 입력 값을 정수로 변환해 보세요. |
| 뜨다 | 입력 값을 float 숫자로 변환해 보세요. |
| bool | 입력 값을 부울 값으로 변환해 보세요. |
| 개체 | 입력 값을 개체로 변환해 보세요. |
| array | 입력 값을 배열로 변환해 보세요. |
| nullOrElse | nullable 값에 기본값을 지정합니다. |
모든 함수 - 사전순 목록
및
모든 식이 true인지 확인합니다. 모든 식이 true이면 true를 반환하거나, 하나 이상의 식이 false이면 false를 반환합니다.
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| 값 | 부울 | 검사 첫 번째 식 |
| 값... | 부울 | 검사 나머지 식 |
| 반환 값 형식 | 설명 |
|---|---|
| 부울 | 모든 식이 true이면 true를 반환합니다. 하나 이상의 식이 false이면 false를 반환합니다. |
예
다음 예제에서는 지정된 식이 false인지 여부를 검사.
and(equals(1, 1), equals(2, 2))
and(equals(1, 1), equals(1, 2))
and(equals(1, 2))
그리고 다음 결과를 반환합니다.
- 첫 번째 예제: 두 식 모두 true이므로 를 반환합니다
true. - 두 번째 예제: 한 식은 false이므로 를 반환합니다
false. - 세 번째 예제: 식은 false이므로 를 반환합니다
false.
array
이 함수는 입력 값을 배열로 변환하려고 합니다. 더 넓은 형식에서 배열로 값을 캐스팅하는 데 사용됩니다. 항목에서 배열을 만들려면 createArray를 참조하세요.
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| 값 | 모두 | 변환할 값 |
| 반환 값 형식 | 설명 |
|---|---|
| array | 변환된 배열 값 |
예
이 예제에서는 배열 형식이 되도록 "각각에 적용" 작업의 항목을 어설션합니다.
array(items('Appy to each'))
bool
이 함수는 입력 값을 부울 값으로 변환하려고 합니다. 더 넓은 형식에서 부울로 값을 캐스팅하는 데 사용됩니다.
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| 값 | 모두 | 변환할 값 |
| 반환 값 형식 | 설명 |
|---|---|
| 부울 | 변환된 부울 값 |
예
이 예제에서는 부울 형식이 되도록 "각각에 적용" 작업의 항목을 어설션합니다.
bool(items('Appy to each'))
포함
컬렉션에 특정 항목이 있는지 확인합니다. 항목이 발견되면 true를 반환하거나, 찾을 수 없는 경우 false를 반환합니다.
오버로드 1: 부분 문자열을 찾는 문자열
이 오버로드는 대/소문자를 구분합니다.
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| 수집 | 문자열 | 검사 문자열 |
| 값 | 문자열 | 찾을 부분 문자열 |
| 반환 값 형식 | 설명 |
|---|---|
| 부울 | 부분 문자열이 발견되면 true를 반환합니다. 찾을 수 없는 경우 false를 반환합니다. |
오버로드 2: 값을 찾는 배열
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| 수집 | array | 검사 컬렉션 |
| 값 | 모두 | 찾을 항목 |
| 반환 값 형식 | 설명 |
|---|---|
| 부울 | 항목이 발견되면 true를 반환합니다. 찾을 수 없는 경우 false를 반환합니다. |
예 1
다음은 하위 문자열 "world"에 대한 문자열 "hello world"를 확인하고 를 반환 true하는 예제입니다.
contains('hello world', 'world')
예 2
이 예제에서는 변수 Asset.Owner 에서 Workflow.Requestor 변수와 동일한 항목에 대해 확인합니다.
contains(runInput()['asset']['dataOwner'], runInput()['requestor'])
createArray
입력 수에서 배열을 반환합니다. 이 함수는 입력 값이 동일한 형식일 필요가 없습니다.
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| 값... | 모두 | 배열을 만들 값입니다. |
| 반환 값 형식 | 설명 |
|---|---|
| array | 모든 입력 항목에서 만든 배열 |
예
다음 예제는 입력에서 배열을 만듭니다.
createArray('h', 'e', 'l', 'l', 'o')
createArray(true, null)
createArray()
createObject
빈 개체를 반환합니다.
| 반환 값 형식 | 설명 |
|---|---|
| 개체 | 빈 개체 |
예
이 예제에서는 입력에서 배열을 만들고 를 반환합니다 {}.
createObject()
endsWith
문자열이 특정 부분 문자열로 끝나는지 확인합니다. 부분 문자열이 발견되면 true를 반환하거나, 찾을 수 없는 경우 false를 반환합니다. 이 함수는 대/소문자를 구분합니다.
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| 문자 메시지 | 문자열 | 검사 문자열 |
| searchText | 문자열 | 찾을 끝 부분 문자열 |
| 반환 값 형식 | 설명 |
|---|---|
| 부울 | 끝 부분 문자열이 발견되면 true를 반환합니다. 찾을 수 없는 경우 false를 반환합니다. |
예 1
이 예제에서는 "hello world" 문자열이 "world" 문자열로 끝나는지 확인합니다.
endsWith('hello world', 'world')
그리고 이 결과를 반환합니다. true
예 2
이 예제에서는 "hello world" 문자열이 "universe" 문자열로 끝나는지 확인합니다.
endsWith('hello world', 'universe')
그리고 이 결과를 반환합니다. false
같음
값, 식 또는 개체가 모두 동일한지 확인합니다. 둘 다 동일할 때 true를 반환하거나 동일하지 않은 경우 false를 반환합니다.
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| 값 | 모두 | 비교할 값, 식 또는 개체 |
| compareTo | 모두 | 비교 값, 식 또는 개체 |
| 반환 값 형식 | 설명 |
|---|---|
| 부울 | 둘 다 동일한 경우 true를 반환합니다. 동일하지 않은 경우 false를 반환합니다. |
예
이러한 예제는 지정된 입력이 동일한지 여부를 검사.
equals(true, 1)
equals('abc', 'abcd')
그리고 다음 결과를 반환합니다.
- 첫 번째 예제: 두 값 모두 동일하므로 함수는 를 반환합니다
true. - 두 번째 예: 두 값 모두 동일하지 않으므로 함수는 를 반환합니다
false.
뜨다
이 함수는 입력 값을 float 숫자로 변환하려고 합니다. 더 넓은 형식에서 float로 값을 캐스팅하는 데 사용됩니다.
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| 값 | 모두 | 변환할 값 |
| 반환 값 형식 | 설명 |
|---|---|
| 뜨다 | 변환된 float 값 |
예
다음은 "각각에 적용" 작업의 항목을float 형식으로 어설션하는 예제입니다.
float(items('Appy to each'))
getManager
Microsoft Entra ID 사용자 관리자의 ID를 가져옵니다.
오버로드 1: 단일 사용자에 대한 가져오기
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| userId | 문자열 | 입력 사용자의 ID |
| 반환 값 형식 | 설명 |
|---|---|
| string 또는 null | 입력 사용자 관리자의 ID이거나 존재하지 않는 경우 null입니다. |
오버로드 2: 여러 사용자에 대한 가져오기
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| userId | array | 입력 사용자의 ID |
| 반환 값 형식 | 설명 |
|---|---|
| array | 입력 사용자 관리자의 ID 조합 |
예
다음 예제에서는 입력 사용자의 관리자를 가져옵니다.
getManager(runInput()['requestor'])
getManager(runInput()['term']['stewards'])
- 첫 번째 예제: 입력 매개 변수는 문자열이므로 Workflow.Requestor 관리자의 ID를 반환합니다.
- 두 번째 예: 입력 매개 변수는 배열이므로 Term.Stewards 관리자의 ID 공용 구조 집합을 반환합니다.
getUserName
Microsoft Entra ID 사용자의 이름을 가져옵니다.
오버로드 1: 단일 사용자에 대한 가져오기
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| userId | 문자열 | 입력 사용자의 ID |
| 반환 값 형식 | 설명 |
|---|---|
| 문자열 | 입력 사용자의 이름 |
오버로드 2: 여러 사용자에 대한 가져오기
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| userId | array | 입력 사용자의 ID |
| 반환 값 형식 | 설명 |
|---|---|
| array | 입력 사용자의 이름 |
예
다음 예제에서는 입력 사용자의 이름을 가져옵니다.
getUserName(runInput()['requestor'])
getUserName(runInput()['term']['stewards'])
- 첫 번째 예: 입력 매개 변수는 문자열이므로 Workflow.Requestor의 이름을 반환합니다.
- 두 번째 예: 입력 매개 변수는 배열이므로 Term.Stewards의 이름 배열을 반환합니다.
큰
첫 번째 값이 두 번째 값보다 큰지 확인합니다. 첫 번째 값이 더 많으면 true를 반환하거나, 값이 적을 경우 false를 반환합니다.
오버로드 1: 숫자 비교
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| 값 | 정수 또는 부동 소수점 | 두 번째 값보다 큰지 여부를 검사 첫 번째 값입니다. |
| compareTo | 정수 또는 부동 소수점 | 비교 값 |
| 반환 값 형식 | 설명 |
|---|---|
| 부울 | 첫 번째 값이 두 번째 값보다 크면 true를 반환합니다. 첫 번째 값이 두 번째 값과 같거나 작으면 false를 반환합니다. |
오버로드 2: 문자열 비교
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| 값 | 문자열 | 두 번째 값보다 큰지 여부를 검사 첫 번째 값입니다. |
| compareTo | 문자열 | 비교 값 |
| 반환 값 형식 | 설명 |
|---|---|
| 부울 | 첫 번째 값이 두 번째 값보다 크면 true를 반환합니다. 첫 번째 값이 두 번째 값과 같거나 작으면 false를 반환합니다. |
예
다음 예제에서는 첫 번째 값이 두 번째 값보다 큰지 여부를 검사.
greater(10, 5)
greater('apple', 'banana')
그리고 다음 결과를 반환합니다.
- 첫 번째 예제:
true - 두 번째 예제:
false
greaterOrEquals
첫 번째 값이 두 번째 값보다 크거나 같은지 확인합니다. 첫 번째 값이 크거나 같으면 true를 반환하거나 첫 번째 값이 작을 때 false를 반환합니다.
오버로드 1: 숫자 비교
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| 값 | 정수 또는 부동 소수점 | 두 번째 값보다 크거나 같은지 검사 첫 번째 값입니다. |
| compareTo | 정수 또는 부동 소수점 | 비교 값 |
| 반환 값 형식 | 설명 |
|---|---|
| 부울 | 첫 번째 값이 두 번째 값보다 크거나 같으면 true를 반환합니다. 첫 번째 값이 두 번째 값보다 작으면 false를 반환합니다. |
오버로드 2: 문자열 비교
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| 값 | 문자열 | 두 번째 값보다 크거나 같은지 검사 첫 번째 값입니다. |
| compareTo | 문자열 | 비교 값 |
| 반환 값 형식 | 설명 |
|---|---|
| 부울 | 첫 번째 값이 두 번째 값보다 크거나 같으면 true를 반환합니다. 첫 번째 값이 두 번째 값보다 작으면 false를 반환합니다. |
예
다음 예제에서는 첫 번째 값이 두 번째 값보다 크거나 같은지 검사.
greaterOrEquals(5, 5)
greaterOrEquals('apple', 'banana')
그리고 다음 결과를 반환합니다.
- 첫 번째 예제:
true - 두 번째 예제:
false
int
이 함수는 입력 값을 정수로 변환하려고 합니다. 더 넓은 형식에서 정수로 값을 캐스팅하는 데 사용됩니다.
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| 값 | 모두 | 변환할 값 |
| 반환 값 형식 | 설명 |
|---|---|
| integer | 변환된 정수 값 |
예
다음은 "각각에 적용" 작업의 항목을정수 형식으로 어설션하는 예제입니다.
int(items('Appy to each'))
길이
컬렉션의 항목 수 또는 문자열의 길이를 반환합니다.
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| 값 | 문자열 또는 배열 | 계산할 항목이 있는 문자열 또는 컬렉션 |
| 반환 값 형식 | 설명 |
|---|---|
| 부울 | 컬렉션의 항목 수 또는 문자열의 길이 |
예
이러한 예제는 다음 컬렉션의 항목 수를 계산합니다.
length('abcd')
length(createArray(0, 1, 2, 3))
그리고 둘 다 이 결과를 반환합니다. 4
덜
첫 번째 값이 두 번째 값보다 작은지 확인합니다. 첫 번째 값이 작으면 true를 반환하거나 첫 번째 값이 더 많으면 false를 반환합니다.
오버로드 1: 숫자 비교
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| 값 | 정수 또는 부동 소수점 | 두 번째 값보다 작은지 여부를 검사 첫 번째 값입니다. |
| compareTo | 정수 또는 부동 소수점 | 비교 값 |
| 반환 값 형식 | 설명 |
|---|---|
| 부울 | 첫 번째 값이 두 번째 값보다 작으면 true를 반환합니다. 첫 번째 값이 두 번째 값과 같거나 큰 경우 false를 반환합니다. |
오버로드 2: 문자열 비교
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| 값 | 문자열 | 두 번째 값보다 큰지 여부를 검사 첫 번째 값입니다. |
| compareTo | 문자열 | 비교 값 |
| 반환 값 형식 | 설명 |
|---|---|
| 부울 | 첫 번째 값이 두 번째 값보다 작으면 true를 반환합니다. 첫 번째 값이 두 번째 값과 같거나 큰 경우 false를 반환합니다. |
예
이러한 예제에서는 첫 번째 값이 두 번째 값보다 작은지 여부를 검사.
less(5, 10)
less('banana', 'apple')
그리고 다음 결과를 반환합니다.
- 첫 번째 예제:
true - 두 번째 예제:
false
lessOrEquals
첫 번째 값이 두 번째 값보다 작거나 같은지 확인합니다. 첫 번째 값이 보다 작거나 같으면 true를 반환하거나 첫 번째 값이 더 많으면 false를 반환합니다.
오버로드 1: 숫자 비교
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| 값 | 정수 또는 부동 소수점 | 두 번째 값보다 작거나 같은지 검사 첫 번째 값입니다. |
| compareTo | 정수 또는 부동 소수점 | 비교 값 |
| 반환 값 형식 | 설명 |
|---|---|
| 부울 | 첫 번째 값이 두 번째 값보다 작거나 같으면 true를 반환합니다. 첫 번째 값이 두 번째 값보다 크면 false를 반환합니다. |
오버로드 2: 문자열 비교
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| 값 | 문자열 | 두 번째 값보다 작거나 같은지 검사 첫 번째 값입니다. |
| compareTo | 문자열 | 비교 값 |
| 반환 값 형식 | 설명 |
|---|---|
| 부울 | 첫 번째 값이 두 번째 값보다 작거나 같으면 true를 반환합니다. 첫 번째 값이 두 번째 값보다 크면 false를 반환합니다. |
예
이러한 예제에서는 첫 번째 값이 두 번째 값보다 작거나 같은지 여부를 검사.
lessOrEquals(10, 10)
lessOrEquals('apply', 'apple')
그리고 다음 결과를 반환합니다.
- 첫 번째 예제:
true - 두 번째 예제:
false
memberOfGroup
사용자가 Microsoft Entra ID 그룹의 구성원인지 확인합니다. 그룹 ID는 Microsoft Entra 그룹 관리 페이지에서 찾을 수 있습니다.
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| userId | 문자열 | 입력 사용자의 ID |
| groupId | 문자열 | 검사 그룹의 ID입니다. |
| 반환 값 형식 | 설명 |
|---|---|
| 부울 | 사용자가 그룹의 구성원이면 true를 반환합니다. 사용자가 그룹의 구성원이 아니거나 그룹이 없는 경우 false를 반환합니다. |
예
이 예제에서는 Workflow.Requestor가 지정된 그룹의 구성원인지 여부를 검사.
memberOfGroup(runInput()['requestor'], '00000000-0000-0000-0000-111111111111')
아님
식이 false인지 확인합니다. 식이 false이면 true를 반환하거나 true이면 false를 반환합니다.
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| 값 | 부울 | 검사 식 |
| 반환 값 형식 | 설명 |
|---|---|
| 부울 | 식이 false이면 true를 반환합니다. 식이 true이면 false를 반환합니다. |
예
다음 예제에서는 지정된 식이 false인지 여부를 검사.
not(equals(1, 2))
not(equals(1, 1))
그리고 다음 결과를 반환합니다.
- 첫 번째 예제: 식은 false이므로 함수는 를 반환합니다
true. - 두 번째 예제: 식은 true이므로 함수는 를 반환합니다
false.
nullOrElse
nullable 값에 기본값을 지정합니다. nullable이 아닌 값을 반환합니다.
오버로드 1: 문자열 버전
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| 값 | string 또는 null | nullable 값 |
| defaultValue | 문자열 | 대체 값 |
| 반환 값 형식 | 설명 |
|---|---|
| 문자열 | null이 아닌 경우 입력 값을 반환합니다. 입력 값이 null이면 기본값을 반환합니다. |
오버로드 2: 정수 버전
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| 값 | 정수 또는 null | nullable 값 |
| defaultValue | integer | 대체 값 |
| 반환 값 형식 | 설명 |
|---|---|
| integer | null이 아닌 경우 입력 값을 반환합니다. 입력 값이 null이면 기본값을 반환합니다. |
오버로드 3: Float 버전
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| 값 | float 또는 null | nullable 값 |
| defaultValue | 뜨다 | 대체 값 |
| 반환 값 형식 | 설명 |
|---|---|
| 뜨다 | null이 아닌 경우 입력 값을 반환합니다. 입력 값이 null이면 기본값을 반환합니다. |
오버로드 4: 부울 버전
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| 값 | 부울 또는 null | nullable 값 |
| defaultValue | 부울 | 대체 값 |
| 반환 값 형식 | 설명 |
|---|---|
| 부울 | null이 아닌 경우 입력 값을 반환합니다. 입력 값이 null이면 기본값을 반환합니다. |
오버로드 5: 배열 버전
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| 값 | array 또는 null | nullable 값 |
| defaultValue | array | 대체 값 |
| 반환 값 형식 | 설명 |
|---|---|
| array | null이 아닌 경우 입력 값을 반환합니다. 입력 값이 null이면 기본값을 반환합니다. |
오버로드 6: 개체 버전
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| 값 | 개체 또는 null | nullable 값 |
| defaultValue | 개체 | 대체 값 |
| 반환 값 형식 | 설명 |
|---|---|
| 개체 | null이 아닌 경우 입력 값을 반환합니다. 입력 값이 null이면 기본값을 반환합니다. |
예
이 예제에서는 nullable 변수 Term.Definition 에 기본값 'Empty'을 제공합니다.
nullOrElse(runInput()['term']['definition'], 'Empty')
개체
이 함수는 입력 값을 개체 값으로 변환하려고 합니다. 더 넓은 형식에서 개체로 값을 캐스팅하는 데 사용됩니다.
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| 값 | 모두 | 변환할 값 |
| 반환 값 형식 | 설명 |
|---|---|
| 부울 | 변환된 개체 값 |
예
이 예제에서는 개체 형식이 되도록 "각각에 적용" 작업의 항목을 어설션합니다.
object(items('Appy to each'))
또는
하나 이상의 식이 true인지 확인합니다. 하나 이상의 식이 true이면 true를 반환하거나, 모두 false이면 false를 반환합니다.
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| 값 | 부울 | 검사 첫 번째 식 |
| 값... | 부울 | 검사 나머지 식 |
| 반환 값 형식 | 설명 |
|---|---|
| 부울 | 하나 이상의 식이 true이면 true를 반환합니다. 모든 식이 false이면 false를 반환합니다. |
예
다음 예제에서는 하나 이상의 식이 true인지 여부를 검사.
or(equals(1, 1), equals(1, 2))
or(equals(1, 2), equals(1, 3))
or(equals(1, 2))
그리고 다음 결과를 반환합니다.
- 첫 번째 예제: 하나 이상의 식이 true이므로 함수는 를 반환합니다
true. - 두 번째 예제: 두 식 모두 false이므로 함수는 를 반환합니다
false. - 세 번째 예제: 식은 false이므로 함수는 를 반환합니다
false.
startsWith
문자열이 특정 부분 문자열로 시작하는지 확인합니다. 부분 문자열이 발견되면 true를 반환하거나, 찾을 수 없는 경우 false를 반환합니다. 이 함수는 대/소문자를 구분합니다.
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| 문자 메시지 | 문자열 | 검사 문자열 |
| searchText | 문자열 | 찾을 시작 부분 문자열 |
| 반환 값 형식 | 설명 |
|---|---|
| 부울 | 시작 부분 문자열이 발견되면 true를 반환합니다. 찾을 수 없는 경우 false를 반환합니다. |
예 1
이 예제에서는 "hello world" 문자열이 "hello" 부분 문자열로 시작하는지 여부를 확인합니다.
startsWith('hello world', 'hello')
그리고 이 결과를 반환합니다. true
예 2
이 예제에서는 "hello world" 문자열이 "greetings" 하위 문자열로 시작하는지 여부를 확인합니다.
startsWith('hello world', 'greetings')
그리고 이 결과를 반환합니다. false
문자열
이 함수는 값의 문자열 버전을 반환합니다.
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| 값 | 모두 | 변환할 값 |
| 반환 값 형식 | 설명 |
|---|---|
| 문자열 | 지정된 값의 문자열 버전입니다. value 매개 변수가 null이면 이 값은 빈 문자열("") 값으로 반환됩니다. |
예
다음 예제에서는 입력 값을 문자열로 변환합니다.
string('abc')
string(true)
string(createArray())
그리고 다음 결과를 반환합니다.
- 첫 번째 예제: 입력 값은 문자열이므로 ID 값
'abc'을 반환합니다. - 두 번째 예: 부울 값의 문자열 버전은 대문자로 표시되므로 함수는 를 반환합니다
'True'. - 세 번째 예: 배열 또는 개체는 JSON 형식으로 변환되므로 함수는 를 반환합니다
'[]'.
다음 단계
워크플로에 대한 자세한 내용은 다음 문서를 참조하세요.