Azure Logic Apps 및 Power Automate의 워크플로 식 함수에 대한 참조 가이드

아티클
07/31/2024

적용 대상: Azure Logic Apps(사용량 + 표준)

Azure Logic Apps 및 Power Automate의 워크플로 정의의 경우 일부 식은 워크플로 실행을 시작할 때 아직 존재하지 않을 수 있는 런타임 작업에서 해당 값을 가져옵니다. 이러한 식의 값을 참조하거나 처리하려면 워크플로 정의 언어에서 제공하는 식 함수를 사용하면 됩니다.

참고 항목

이 참조 페이지는 Azure Logic Apps 및 Power Automate에 모두 적용되지만, Azure Logic Apps 설명서에 표시됩니다. 이 페이지는 특히 논리 앱 워크플로를 참조하지만 이러한 함수는 흐름 및 논리 앱 워크플로 모두에서 작동합니다. Power Automate의 함수와 식에 대한 자세한 내용은 조건에 식 사용을 검토하세요.

예를 들어 정수 또는 부동 소수점에서 합계를 구하려는 경우 add() 함수와 같은 수학 함수를 사용하여 값을 계산할 수 있습니다. 다음은 함수로 수행할 수 있는 다른 작업의 예입니다.

작업	함수 구문	결과
문자열을 소문자 형식으로 반환합니다.	toLower('<text>') 예를 들어: toLower('Hello')	"hello"
GUID(Globally Unique Identifier)를 반환합니다.	guid()	"c2ecc88d-88c8-4096-912c-d6f2e2b138ce"

범용에 따라 함수를 찾으려면 다음 표를 검토합니다. 또는 각 함수에 대한 자세한 내용은 사전순 목록을 참조하세요.

식의 함수

식에서 함수를 사용하는 방법을 보여주기 위해, 이 예제는 식에서 parameters() 함수를 사용하여 customerName 매개 변수에서 값을 가져와 해당 값을 accountName 속성에 할당할 수 있는 방법을 보여줍니다.

"accountName": "@parameters('customerName')"

식에서 함수를 사용할 수 있는 몇 가지 다른 일반적인 방법은 다음과 같습니다.

작업	식에서 함수 구문
해당 항목을 함수에 전달하여 항목 작업을 수행합니다.	"@<functionName>(<item>)"
1. 중첩 `parameters()` 된 함수를 사용하여 parameterName 값을 가져옵니다. 2. 해당 값을 functionName에 전달하여 결과 작업을 수행합니다.	"@<functionName>(parameters('<parameterName>'))"
1. 중첩된 내부 함수 Name에서 결과를 가져옵니다. 2. 결과를 외부 함수 functionName2에 전달합니다.	"@<functionName2>(<functionName>(<item>))"
1. functionName에서 결과를 가져옵니다. 2. 결과가 propertyName이 있는 개체인 경우 해당 속성의 값을 가져옵니다.	"@<functionName>(<item>).<propertyName>"

예를 들어 concat() 함수는 두 개 이상의 문자열 값을 매개 변수로 사용할 수 있습니다. 이 함수는 이러한 문자열을 하나의 문자열로 결합합니다. "Sophia" 및 "Owen"과 같은 문자열 리터럴을 전달하여 결합된 문자열 "SophiaOwen"을 가져올 수 있습니다.

"customerName": "@concat('Sophia', 'Owen')"

또는 매개 변수에서 문자열 값을 가져올 수 있습니다. 이 예제에서는 각 concat() 매개 변수 및 매개 변수의 함수를 lastName firstName 사용합니다parameters(). 그런 다음 결과 문자열을 함수에 concat() 전달하여 결합된 문자열(예: "SophiaOwen")을 가져옵니다.

"customerName": "@concat(parameters('firstName'), parameters('lastName'))"

두 예제 중 어느 경우든 결과를 customerName 속성에 할당합니다.

함수 사용에 대한 고려 사항

디자이너는 디자인 타임에 함수 매개 변수로 사용되는 런타임 식을 평가하지 않습니다. 디자이너에서는 디자인 타임에 모든 식을 완전히 평가할 수 있어야 합니다.
함수 매개 변수는 왼쪽에서 오른쪽으로 평가됩니다.
매개 변수 정의 구문에서 매개 변수 후에 나타나는 물음표(?)는 매개 변수가 선택 사항임을 의미합니다. 예를 들어 getFutureTime()을 참조하세요.
일반 텍스트를 사용해 인라인으로 표시되는 함수 식이 식의 보간된 형식을 대신 사용하려면 중괄호({})로 묶어야 합니다. 이 형식은 구문 분석 문제를 방지하는 데 도움이 됩니다. 함수 식이 일반 텍스트를 사용해 인라인으로 표시되지 않으면 중괄호가 필요하지 않습니다.

다음 예제에는 올바른 구문과 잘못된 구문이 나와 있습니다.

옳음: "<text>/@{<function-name>('<parameter-name>')}/<text>"

틀림: "<text>/@<function-name>('<parameter-name>')/<text>"

정상: "@<function-name>('<parameter-name>')"

다음 섹션에는 일반 용도를 기준으로 함수가 정렬되어 있으며, 이러한 함수를 사전순으로 찾아볼 수도 있습니다.

문자열 함수

문자열로 작업하려면 이러한 문자열 함수 및 일부 컬렉션 함수도 사용할 수 있습니다. 문자열 함수는 문자열에서만 작동합니다.

string 함수	작업
chunk	문자열 또는 컬렉션을 같은 길이의 청크로 분할합니다.
concat	둘 이상의 문자열을 결합하고 결합된 문자열을 반환합니다.
endsWith	문자열이 지정된 하위 문자열로 끝나는지 여부를 확인합니다.
formatNumber	지정된 형식에 따라 숫자를 문자열로 반환합니다.
guid	전역적으로 고유한 식별자(GUID)를 문자열로 생성합니다.
indexOf	하위 문자열에 대한 시작 위치를 반환합니다.
isFloat	문자열이 부동 소수점 숫자인지 여부를 나타내는 부울을 반환합니다.
isInt	문자열이 정수인지 여부를 나타내는 부울을 반환합니다.
lastIndexOf	마지막으로 나오는 부분 문자열의 시작 위치를 반환합니다.
length	문자열 또는 배열에서 항목 수를 반환합니다.
nthIndexOf	문자열에서 substring의 n번째 발생이 나타나는 시작 위치 또는 인덱스 값을 반환합니다.
replace	하위 문자열을 지정된 문자열로 바꾸고 업데이트된 문자열을 반환합니다.
slice	시작/끝 위치나 값을 지정하여 substring을 반환합니다. substring도 참조하세요.
split	원래 문자열에 지정된 구분 기호 문자를 기준으로 하여 더 큰 문자열의 하위 문자열을 포함하는 배열(쉼표로 구분됨)을 반환합니다.
startsWith	문자열이 특정 하위 문자열로 시작하는지 검사합니다.
substring	지정된 위치에서 시작하여 문자열에서 문자를 반환합니다. slice도 참조하세요.
toLower	문자열을 소문자 형식으로 반환합니다.
toUpper	문자열을 대문자 형식으로 반환합니다.
trim	문자열에서 선행 및 후행 공백을 제거하고 업데이트된 문자열을 반환합니다.

컬렉션 기능

컬렉션, 일반적으로 배열, 문자열 및 경우에 따라 사전으로 작업하려면 이러한 컬렉션 함수를 사용할 수 있습니다.

컬렉션 함수	작업
chunk	문자열 또는 컬렉션을 같은 길이의 청크로 분할합니다.
contains	컬렉션에 특정 항목이 있는지 검사합니다.
empty	컬렉션이 비어 있는지 검사합니다.
first	컬렉션에서 첫 번째 항목을 반환합니다.
intersection	지정한 컬렉션에서 공통 항목만 있는 컬렉션을 반환합니다.
항목	이 함수가 배열에서 반복되는 동작 내에 나타나는 경우 현재 동작을 반복하는 중에 배열의 현재 항목을 반환합니다.
join	지정된 문자로 구분되는 배열에서 모든 항목이 들어 있는 문자열을 반환합니다.
last	컬렉션에서 마지막 항목을 반환합니다.
length	문자열 또는 배열에서 항목 수를 반환합니다.
reverse	배열에 있는 항목의 순서를 역방향으로 표시합니다.
skip	컬렉션 앞의 항목을 제거하고 다른 모든 항목을 반환합니다.
sort	컬렉션의 항목을 정렬합니다.
take	컬렉션 앞에서 항목을 반환합니다.
union	지정한 컬렉션에서 모든 항목이 있는 컬렉션을 반환합니다.

논리적 비교 기능

조건을 사용하거나, 값과 식 결과를 비교하거나, 다양한 종류의 논리를 평가하려면 이러한 논리 비교 함수를 사용할 수 있습니다. 각 함수에 대한 전체 참조는 사전순 목록을 참조하세요.

참고 항목

논리 함수 또는 조건을 사용하여 값을 비교하는 경우 Null 값은 빈 문자열("") 값으로 변환됩니다. 조건의 동작은 null 값 대신 빈 문자열과 비교할 때 다릅니다. 자세한 내용은 string() 함수를 참조하세요.

논리 비교 함수	작업
and	모든 식이 true인지 확인합니다.
equals	두 값이 동일한지 확인합니다.
greater	첫 번째 값이 두 번째 값보다 큰지 검사합니다.
greaterOrEquals	첫 번째 값이 두 번째 값보다 크거나 같은지 검사합니다.
if	식이 true인지 또는 false인지 검사합니다. 결과에 기반해 지정한 값을 반환합니다.
isFloat	문자열이 부동 소수점 숫자인지 여부를 나타내는 부울을 반환합니다.
isInt	문자열이 정수인지 여부를 나타내는 부울을 반환합니다.
less	첫 번째 값이 두 번째 값보다 작은지 검사합니다.
lessOrEquals	첫 번째 값이 두 번째 값보다 작거나 같은지 검사합니다.
not	식이 false인지 검사합니다.
or	최소 하나의 식이 true인지 검사합니다.

변환 함수

값의 유형 또는 형식을 변경하려면 이러한 변환 함수를 사용할 수 있습니다. 예를 들어 값을 부울에서 정수로 변경할 수 있습니다. 변환하는 동안 Azure Logic Apps가 콘텐츠 형식을 처리하는 방법에 대한 자세한 내용은 콘텐츠 형식 처리를 참조하세요. 각 함수에 대한 전체 참조는 사전순 목록을 참조하세요.

참고 항목

Azure Logic Apps는 자동으로 또는 암시적으로 base64 인코딩 또는 디코딩을 수행하므로 사용자가 인코딩 및 디코딩 함수를 사용하여 이러한 변환을 수동으로 수행할 필요가 없습니다. 그러나 디자이너에서 이러한 함수를 사용하는 경우 디자이너에서 예기치 않은 렌더링 동작이 발생할 수 있습니다. 이러한 동작은 함수의 매개 변수 값을 편집하여 코드에서 함수와 해당 효과를 제거하지 않는 한 함수의 표시 유형에만 영향을 줍니다. 자세한 내용은 암시적 데이터 형식 변환을 참조 하세요.

변환 함수	작업
array	단일 지정 입력에서 배열을 반환합니다. 여러 입력의 경우 createArray를 참조합니다.
base64	문자열에 대한 base64로 인코딩된 버전을 반환합니다.
base64ToBinary	Base64로 인코딩된 문자열에 대한 이진 버전을 반환합니다.
base64ToString	Base64로 인코딩된 문자열에 대한 문자열 버전을 반환합니다.
binary	입력 값에 대한 이진 버전을 반환합니다.
부울	입력 값에 대한 부울 버전을 반환합니다.
createArray	여러 입력에서 배열을 반환합니다.
dataUri	입력 값에 대한 데이터 URI를 반환합니다.
dataUriToBinary	데이터 URI에 대한 이진 버전을 반환합니다.
dataUriToString	데이터 URI에 대한 문자열 버전을 반환합니다.
decimal	10진수 문자열의 10진수를 반환합니다.
decodeBase64	Base64로 인코딩된 문자열에 대한 문자열 버전을 반환합니다.
decodeDataUri	데이터 URI에 대한 이진 버전을 반환합니다.
decodeUriComponent	디코딩된 버전으로 이스케이프 문자를 바꾸는 문자열을 반환합니다.
encodeUriComponent	URL 안전하지 않은 문자를 이스케이프 문자로 대체하는 문자열을 반환합니다.
float	입력 값에 대해 부동 소수점 숫자를 반환합니다.
int	문자열에 대한 정수 버전을 반환합니다.
json	JSON(JavaScript Object Notation) 형식 값 또는 문자열이나 XML에 대한 개체를 반환합니다.
string	입력 값에 대한 문자열 버전을 반환합니다.
uriComponent	이스케이프 문자로 URL 안전하지 않은 문자를 대체하여 입력 값에 대한 URI로 인코딩된 버전을 반환합니다.
uriComponentToBinary	URI로 인코딩된 문자열에 대한 이진 버전을 반환합니다.
uriComponentToString	URI로 인코딩된 문자열에 대한 문자열 버전을 반환합니다.
xml	문자열에 대한 XML 버전을 반환합니다.

암시적 데이터 유형 변환

Azure Logic Apps는 일부 데이터 형식 간에 자동으로 또는 암시적으로 변환되므로 이러한 변환을 수동으로 수행할 필요가 없습니다. 예를 들어 입력으로 문자열이 필요한 비문자열 값을 사용하는 경우 Azure Logic Apps는 비문자열 값을 문자열로 자동 변환합니다.

트리거가 숫자 값을 출력으로 반환한다고 가정해 봅시다.

triggerBody()?['123']

URL처럼 문자열 입력이 필요한 이 숫자 출력을 사용하는 경우 Azure Logic Apps는 중괄호({}) 표기법을 이용해 값을 문자열로 자동 변환합니다.

@{triggerBody()?['123']}

Base64 인코딩 및 디코딩

Azure Logic Apps는 base64 인코딩 또는 디코딩을 자동으로 혹은 암시적으로 수행하므로 해당 함수를 사용하여 이러한 변환을 수동으로 수행할 필요가 없습니다.

base64(<value>)
base64ToBinary(<value>)
base64ToString(<value>)
base64(decodeDataUri(<value>))
concat('data:;base64,',<value>)
concat('data:,',encodeUriComponent(<value>))
decodeDataUri(<value>)

참고 항목

디자이너를 사용하는 동안 트리거나 동작에 직접 또는 식 편집기를 사용하여 이러한 함수를 수동으로 추가하고 디자이너에서 다른 곳으로 이동한 다음 디자이너로 돌아오면, 함수가 디자이너에서 사라지고 매개 변수 값만 뒤에 남게 됩니다. 이 동작은 함수의 매개 변수 값을 편집하지 않고 이 함수를 사용하는 트리거 또는 작업을 선택하는 경우에도 발생합니다. 이 결과는 함수의 표시 유형에만 영향을 주고 효과에는 영향을 주지 않습니다. 코드 보기에서 함수는 영향을 받지 않습니다. 그러나 함수의 매개 변수 값을 편집하는 경우 함수와 해당 효과는 모두 코드 뷰에서 제거되고 함수의 매개 변수 값만 남게 됩니다.

수식 함수

정수 및 부동 소수점수로 작업하려면 이러한 수학 함수를 사용할 수 있습니다. 각 함수에 대한 전체 참조는 사전순 목록을 참조하세요.

수식 함수	작업
add	두 숫자를 더한 결과를 반환합니다.
div	두 숫자를 나눈 결과를 반환합니다.
max	숫자 또는 배열 집합에서 가장 높은 값을 반환합니다.
min	숫자 또는 배열 집합에서 가장 낮은 값을 반환합니다.
mod	두 숫자를 나눈 나머지를 반환합니다.
mul	두 숫자를 곱한 결과를 반환합니다.
rand	지정된 범위에서 임의의 정수를 반환합니다.
range	지정한 정수에서 시작하는 정수 배열을 반환합니다.
sub	첫 번째 숫자에서 두 번째 숫자를 뺀 결과를 반환합니다.

날짜 및 시간 함수

날짜 및 시간을 사용하려면 이러한 날짜 및 시간 함수를 사용할 수 있습니다. 각 함수에 대한 전체 참조는 사전순 목록을 참조하세요.

날짜 또는 시간 함수	작업
addDays	타임스탬프에 일을 추가합니다.
addHours	타임스탬프에 시간을 추가합니다.
addMinutes	타임스탬프에 분을 추가합니다.
addSeconds	타임스탬프에 초를 추가합니다.
addToTime	타임스탬프에 지정된 시간 단위를 추가합니다. getFutureTime도 참조합니다.
convertFromUtc	UTC(Universal Time Coordinated)의 타임스탬프를 대상 표준 시간대로 변환합니다.
convertTimeZone	원본 표준 시간대의 타임스탬프를 대상 표준 시간대로 변환합니다.
convertToUtc	원본 표준 시간대의 타임스탬프를 UTC(Universal Time Coordinated)로 변환합니다.
dateDifference	두 날짜의 차이를 시간 범위로 반환합니다.
dayOfMonth	타임 스탬프에서 월 구성 요소인 날짜를 반환합니다.
dayOfWeek	타임 스탬프에서 주 구성 요소인 날짜를 반환합니다.
dayOfYear	타임 스탬프에서 연 구성 요소인 날짜를 반환합니다.
formatDateTime	타임 스탬프에서 날짜를 반환합니다.
getFutureTime	지정한 시간 단위를 더한 현재 타임스탬프를 반환합니다. addToTime도 참조합니다.
getPastTime	지정한 시간 단위를 뺀 현재 타임스탬프를 반환합니다. subtractFromTime도 참조합니다.
parseDateTime	타임스탬프가 포함된 문자열에서 타임스탬프를 반환합니다.
startOfDay	타임스탬프에 대한 날의 시작을 반환합니다.
startOfHour	타임스탬프에 대한 시간의 시작을 반환합니다.
startOfMonth	타임스탬프에 대한 월의 시작을 반환합니다.
subtractFromTime	타임스탬프에서 시간 단위 수를 뺍니다. getPastTime도 함께 참조하세요.
ticks	지정한 타임스탬프에 대한 `ticks` 속성 값을 반환합니다.
utcNow	현재 타임스탬프를 문자열로 반환합니다.

워크플로 기능

이러한 워크플로 함수를 통해 다음을 수행할 수 있습니다.

런타임에 워크플로 인스턴스에 대한 세부 정보를 가져옵니다.
논리 앱 또는 흐름을 인스턴스화하는 데 사용되는 입력을 사용합니다.
트리거 및 작업의 출력을 참조합니다.

예를 들어 한 동작에서 출력을 참조하고 이후 작업에서 해당 데이터를 사용할 수 있습니다. 각 함수에 대한 전체 참조는 사전순 목록을 참조하세요.

워크플로 함수	작업
작업	런타임에 현재 작업의 출력 또는 다른 JSON 이름 및 값 쌍의 값을 반환합니다. 작업도 참조하세요.
actions	런타임에 작업의 출력 또는 다른 JSON 이름 및 값 쌍의 값을 반환합니다. 작업도 참조하세요.
body	런타임 시 작업의 `body` 출력을 반환합니다.
formDataMultiValues	폼 데이터 또는 폼으로 인코딩된* 작업 출력의* 키 이름과 일치하는 값을 사용하여 배열을 만듭니다.
formDataValue	동작의 양식 데이터 또는 폼 인코딩 출력의 키 이름과 일치하는 단일 값을 반환합니다.
항목	이 함수가 배열에서 반복되는 동작 내에 나타나는 경우 현재 동작을 반복하는 중에 배열의 현재 항목을 반환합니다.
항목	이 함수가 Foreach 또는 Until 루프 내에 나타나는 경우 지정된 루프에서 현재 항목을 반환합니다.
iterationIndexes	이 함수가 Until 루프 내에 나타나면 현재 반복의 인덱스 값을 반환합니다. 중첩된 Until 루프 내에서 이 함수를 사용할 수 있습니다.
listCallbackUrl	트리거 또는 작업을 호출하는 "콜백 URL"을 반환합니다.
multipartBody	여러 부분이 있는 작업 출력의 특정 부분에 대한 본문을 반환합니다.
출력	런타임 시 작업의 출력을 반환합니다.
parameters	워크플로 정의에 설명된 매개 변수의 값을 반환합니다.
result	지정된 범위가 지정된 작업(예: `For_eachUntil`, 및 )의 최상위 작업에서 입력 및 `Scope`출력을 반환합니다.
trigger	런타임 시 또는 다른 JSON 이름-값 쌍에서 트리거 출력을 반환합니다. triggerOutputs 및 triggerBody도 참조하세요.
triggerBody	런타임에 트리거의 `body` 출력을 반환합니다. 트리거를 참조하세요.
triggerFormDataValue	form-data 또는 form-encoded 트리거 출력에서 키 이름과 일치하는 단일 값을 반환합니다.
triggerMultipartBody	Trigger의 다중 부분 출력에서 특정 부분에 대한 본문을 반환합니다.
triggerFormDataMultiValues	form-data 또는 form-encoded 트리거 출력에서 키 이름이 일치하는 값의 배열을 만듭니다.
triggerOutputs	런타임에 트리거의 출력 또는 다른 JSON 이름 및 값 쌍의 값을 반환합니다. 트리거를 참조하세요.
variables	지정한 변수에 대한 값을 반환합니다.
workflow	런타임 동안 워크플로 자체에 대한 모든 세부 정보를 반환합니다.

URI 구문 분석 함수

URI(Uniform Resource Identifier)를 사용하고 이러한 URI에 대한 다양한 속성 값을 얻으려면 이러한 URI 구문 분석 함수를 사용할 수 있습니다. 각 함수에 대한 전체 참조는 사전순 목록을 참조하세요.

URI 구문 분석 함수	작업
uriHost	`host` URI(Uniform Resource Identifier)에 대한 값을 반환합니다.
uriPath	`path` URI(Uniform Resource Identifier)에 대한 값을 반환합니다.
uriPathAndQuery	URI(Uniform Resource Identifier)에 대한 `path` 및 `query` 값을 반환합니다.
uriPort	`port` URI(Uniform Resource Identifier)에 대한 값을 반환합니다.
uriQuery	`query` URI(Uniform Resource Identifier)에 대한 값을 반환합니다.
uriScheme	`scheme` URI(Uniform Resource Identifier)에 대한 값을 반환합니다.

조작 함수: JSON 및 XML

JSON 개체 및 XML 노드를 사용하려면 이러한 조작 함수를 사용할 수 있습니다. 각 함수에 대한 전체 참조는 사전순 목록을 참조하세요.

조작 함수	작업
addProperty	JSON 개체에 속성 및 해당 값 또는 이름-값 쌍을 추가하고 업데이트된 개체를 반환합니다.
coalesce	하나 이상의 매개 변수에서 Null이 아닌 첫 번째 값을 반환합니다.
removeProperty	JSON 개체에서 속성을 제거하고 업데이트된 개체를 반환합니다.
setProperty	JSON 개체의 속성 값을 설정하고 업데이트된 개체를 반환합니다.
xpath	XPath(XML 경로 언어) 식과 일치하는 노드 또는 값에 대한 XML을 확인하고 일치하는 노드 또는 값을 반환합니다.

---------------------------------

모든 함수 - 사전순 목록

이 섹션에서는 사용 가능한 모든 함수가 알파벳 순서로 나열됩니다.

A

작업

런타임 시 현재 작업의 출력 또는 식에 할당할 수 있는 다른 JSON 이름과 값 쌍을 반환합니다. 기본적으로 이 함수는 전체 작업 개체를 참조하지만, 선택적으로 해당 값을 원하는 속성을 지정할 수 있습니다. 또한 actions()를 참조하세요.

다음 위치에서만 함수를 사용할 action() 수 있습니다.

unsubscribe 원래 subscribe 요청의 결과에 액세스할 수 있도록 웹후크 작업에 대한 속성입니다.
trackedProperties 작업에 대한 속성입니다.
do-until 작업에 대한 루프 조건

action()
action().outputs.body.<property>

매개 변수	필수	Type	설명
<속성>	아니요	문자열	해당 값을 원하는 작업 개체의 속성에 대한 이름: name, startTime, endTime, inputs, outputs, status, code, trackingId 및 clientTrackingId. Azure Portal에서 특정 실행 기록의 세부 정보를 검토하여 이러한 속성을 찾을 수 있습니다. 자세한 내용은 REST API - 워크플로 실행 작업을 참조 하세요.

반환 값	Type	설명
<action-output>	문자열	현재 작업 또는 속성의 출력

actions

런타임에 작업의 출력 또는 식에 할당할 수 있는 다른 JSON 이름 및 값 쌍의 값을 반환합니다. 기본적으로 이 함수는 전체 작업 개체를 참조하지만, 선택적으로 해당 값을 원하는 속성을 지정할 수 있습니다. 약식 버전은 body()를 참조하세요. 현재 작업에 대해서는 action()을 참조하세요.

팁

함수는 actions() 출력을 문자열로 반환합니다. 반환된 값을 JSON 개체로 사용해야 하는 경우 먼저 문자열 값을 변환해야 합니다. JSON 구문 분석 작업을 사용하여 문자열 값을 JSON 개체로 변환할 수 있습니다.

참고 항목

이전에는 다른 작업의 출력에 actions() 따라 작업이 실행되도록 지정할 때 함수 또는 conditions 요소를 사용할 수 있습니다. 그러나 작업 간에 명시적으로 종속성을 선언하려면 이제 종속 작업의 runAfter 속성을 사용해야 합니다. runAfter 속성에 대해 자세히 알아보려면 runAfter 속성으로 실패 파악 및 처리를 참조하세요.

actions('<actionName>')
actions('<actionName>').outputs.body.<property>

매개 변수	필수	Type	설명
<actionName>	예	문자열	출력을 원하는 작업 개체의 이름입니다.
<속성>	아니요	문자열	해당 값을 원하는 작업 개체의 속성에 대한 이름: name, startTime, endTime, inputs, outputs, status, code, trackingId 및 clientTrackingId. Azure Portal에서 특정 실행 기록의 세부 정보를 검토하여 이러한 속성을 찾을 수 있습니다. 자세한 내용은 REST API - 워크플로 실행 작업을 참조 하세요.

반환 값	Type	설명
<action-output>	문자열	지정된 작업 또는 속성의 출력

예제

이 예제에서는 런타임 시 status X 작업 Get user 에서 속성 값을 가져옵니다.

actions('Get_user').outputs.body.status

그리고 다음 결과를 반환합니다. "Succeeded"

추가

두 숫자를 더한 결과를 반환합니다.

add(<summand_1>, <summand_2>)

매개 변수	필수	Type	설명
<summand_1>, <summand_2>	예	정수, 부동 소수점 수 또는 혼합	더할 값

반환 값	Type	설명
<result-sum>	정수 또는 부동 소수점 수	지정한 숫자들을 더한 결과

예제

이 예제는 지정한 숫자들을 더합니다.

add(1, 1.5)

그리고 다음 결과를 반환합니다. 2.5

addDays

타임스탬프에 일을 추가합니다.

addDays('<timestamp>', <days>, '<format>'?)

매개 변수	필수	Type	설명
<timestamp>	예	문자열	타임스탬프를 포함하는 문자열
<일>	예	정수	더할 양수 또는 음수 일 수
<format>	아니요	문자열	단일 형식 지정자 또는 사용자 지정 형식 패턴인 숫자 서식 문자열입니다. 타임스탬프의 기본 형식은 "o"(yyyy-MM-ddTHH:mm:ss.fffffffK)입니다. 이 형식은 ISO 8601을 준수하며 표준 시간대 정보를 보존합니다. 형식이 유효한 값이 아니면 오류가 생성됩니다.

반환 값	Type	설명
<updated-timestamp>	문자열	타임스탬프 + 지정한 일 수

예제 1

이 예제는 지정한 타임스탬프에 10일을 더합니다.

addDays('2018-03-15T00:00:00Z', 10)

그리고 다음 결과를 반환합니다. "2018-03-25T00:00:00.0000000Z"

예제 2

이 예제는 지정한 타임스탬프에서 5일을 뺍니다.

addDays('2018-03-15T00:00:00Z', -5)

그리고 다음 결과를 반환합니다. "2018-03-10T00:00:00.0000000Z"

addHours

타임스탬프에 시간을 추가합니다.

addHours('<timestamp>', <hours>, '<format>'?)

매개 변수	필수	Type	설명
<timestamp>	예	문자열	타임스탬프를 포함하는 문자열
<시간>	예	정수	더할 양수 또는 음수 시간 수
<format>	아니요	문자열	단일 형식 지정자 또는 사용자 지정 형식 패턴인 숫자 서식 문자열입니다. 타임스탬프의 기본 형식은 "o"(yyyy-MM-ddTHH:mm:ss.fffffffK)입니다. 이 형식은 ISO 8601을 준수하며 표준 시간대 정보를 보존합니다. 형식이 유효한 값이 아니면 오류가 생성됩니다.

반환 값	Type	설명
<updated-timestamp>	문자열	타임스탬프 + 지정한 시간 수

예제 1

이 예제는 지정한 타임스탬프에 10시간을 더합니다.

addHours('2018-03-15T00:00:00Z', 10)

그리고 다음 결과를 반환합니다. "2018-03-15T10:00:00.0000000Z"

예제 2

이 예제는 지정한 타임스탬프에서 5시간을 뺍니다.

addHours('2018-03-15T15:00:00Z', -5)

그리고 다음 결과를 반환합니다. "2018-03-15T10:00:00.0000000Z"

addMinutes

타임스탬프에 분을 추가합니다.

addMinutes('<timestamp>', <minutes>, '<format>'?)

매개 변수	필수	Type	설명
<timestamp>	예	문자열	타임스탬프를 포함하는 문자열
<minutes>	예	정수	더할 양수 또는 음수 분 수
<format>	아니요	문자열	단일 형식 지정자 또는 사용자 지정 형식 패턴인 숫자 서식 문자열입니다. 타임스탬프의 기본 형식은 "o"(yyyy-MM-ddTHH:mm:ss.fffffffK)입니다. 이 형식은 ISO 8601을 준수하며 표준 시간대 정보를 보존합니다. 형식이 유효한 값이 아니면 오류가 생성됩니다.

반환 값	Type	설명
<updated-timestamp>	문자열	타임스탬프 + 지정한 분 수

예제 1

이 예제는 지정한 타임스탬프에 10분을 더합니다.

addMinutes('2018-03-15T00:10:00Z', 10)

그리고 다음 결과를 반환합니다. "2018-03-15T00:20:00.0000000Z"

예제 2

이 예제는 지정한 타임스탬프에서 5분을 뺍니다.

addMinutes('2018-03-15T00:20:00Z', -5)

그리고 다음 결과를 반환합니다. "2018-03-15T00:15:00.0000000Z"

addProperty

JSON 개체에 속성 및 해당 값 또는 이름-값 쌍을 추가하고 업데이트된 개체를 반환합니다. 런타임에 속성이 이미 있는 경우 함수가 실패하고 오류가 throw됩니다.

addProperty(<object>, '<property>', <value>)

매개 변수	필수	Type	설명
<object>	예	Object	속성을 추가할 JSON 개체입니다.
<속성>	예	문자열	추가할 속성의 이름입니다.
<value>	예	모두	속성의 값

반환 값	Type	설명
<updated-object>	Object	지정한 속성으로 업데이트된 JSON 개체

기존 속성에 부모 속성을 추가하려면 addProperty() 함수가 아닌 setProperty() 함수를 사용합니다. 그렇지 않으면 함수는 자식 개체만 출력으로 반환합니다.

setProperty(<object>, '<parent-property>', addProperty(<object>['<parent-property>'], '<child-property>', <value>)

매개 변수	필수	Type	설명
<object>	예	Object	속성을 추가할 JSON 개체입니다.
<parent-property>	예	문자열	자식 속성을 추가하려는 부모 속성의 이름입니다.
<child-property>	예	문자열	추가할 자식 속성의 이름입니다.
<value>	예	모두	지정된 속성에 대해 설정할 값입니다.

반환 값	Type	설명
<updated-object>	Object	설정한 속성이 있는 업데이트된 JSON 개체

예제 1

다음은 JSON() 함수를 사용하여 문자열에서 JSON으로 변환되는 JSON 개체에 속성을 추가하는 middleName 예제입니다. 개체에는 이미 firstName 및 surName 속성이 포함되어 있습니다. 함수는 지정된 값을 새 속성에 할당하고 업데이트된 개체를 반환합니다.

addProperty(json('{ "firstName": "Sophia", "lastName": "Owen" }'), 'middleName', 'Anne')

현재 JSON 개체는 다음과 같습니다.

{
   "firstName": "Sophia",
   "surName": "Owen"
}

다음은 업데이트된 JSON 개체입니다.

{
   "firstName": "Sophia",
   "middleName": "Anne",
   "surName": "Owen"
}

예제 2

이 예제에서는 middleName 자식 속성을 JSON 개체의 customerName 속성에 추가합니다. 이 속성은 JSON() 함수를 사용하여 문자열에서 JSON으로 변환됩니다. 함수는 지정된 값을 새 속성에 할당하고 업데이트된 개체를 반환합니다.

setProperty(json('{ "customerName": { "firstName": "Sophia", "surName": "Owen" } }'), 'customerName', addProperty(json('{ "customerName": { "firstName": "Sophia", "surName": "Owen" } }')['customerName'], 'middleName', 'Anne'))

현재 JSON 개체는 다음과 같습니다.

{
   "customerName": {
      "firstName": "Sophia",
      "surName": "Owen"
   }
}

다음은 업데이트된 JSON 개체입니다.

{
   "customerName": {
      "firstName": "Sophia",
      "middleName": "Anne",
      "surName": "Owen"
   }
}

addSeconds

타임스탬프에 초를 추가합니다.

addSeconds('<timestamp>', <seconds>, '<format>'?)

매개 변수	필수	Type	설명
<timestamp>	예	문자열	타임스탬프를 포함하는 문자열
<초>	예	정수	더할 양수 또는 음수 초 수
<format>	아니요	문자열	단일 형식 지정자 또는 사용자 지정 형식 패턴인 숫자 서식 문자열입니다. 타임스탬프의 기본 형식은 "o"(yyyy-MM-ddTHH:mm:ss.fffffffK)입니다. 이 형식은 ISO 8601을 준수하며 표준 시간대 정보를 보존합니다. 형식이 유효한 값이 아니면 오류가 생성됩니다.

반환 값	Type	설명
<updated-timestamp>	문자열	타임스탬프 + 지정한 초 수

예제 1

이 예제는 지정한 타임스탬프에 10초를 더합니다.

addSeconds('2018-03-15T00:00:00Z', 10)

그리고 다음 결과를 반환합니다. "2018-03-15T00:00:10.0000000Z"

예제 2

이 예제는 지정한 타임스탬프에서 5초를 뺍니다.

addSeconds('2018-03-15T00:00:30Z', -5)

그리고 다음 결과를 반환합니다. "2018-03-15T00:00:25.0000000Z"

addToTime

타임스탬프에 지정된 시간 단위를 추가합니다. getFutureTime()도 함께 참조하세요.

addToTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?)

매개 변수	필수	Type	설명
<timestamp>	예	문자열	타임스탬프를 포함하는 문자열
<interval>	예	정수	더할 지정한 시간 단위 수
<timeUnit>	예	문자열	interval과 함께 사용할 시간 단위: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
<format>	아니요	문자열	단일 형식 지정자 또는 사용자 지정 형식 패턴인 숫자 서식 문자열입니다. 타임스탬프의 기본 형식은 "o"(yyyy-MM-ddTHH:mm:ss.fffffffK)입니다. 이 형식은 ISO 8601을 준수하며 표준 시간대 정보를 보존합니다. 형식이 유효한 값이 아니면 오류가 생성됩니다.

반환 값	Type	설명
<updated-timestamp>	문자열	타임스탬프 + 지정한 시간 단위 수

예제 1

이 예제는 지정한 타임스탬프에 1일을 더합니다.

addToTime('2018-01-01T00:00:00Z', 1, 'Day')

그리고 다음 결과를 반환합니다. "2018-01-02T00:00:00.0000000Z"

예제 2

이 예제는 지정한 타임스탬프에 1일을 더합니다.

addToTime('2018-01-01T00:00:00Z', 1, 'Day', 'D')

그리고 선택적 "D"를 사용하여 다음 결과를 반환합니다. "Tuesday, January 2, 2018"

및

모든 식이 true인지 확인합니다. 모든 식이 true이면 true를 반환하거나 하나 이상의 식이 false이면 false를 반환합니다.

and(<expression1>, <expression2>, ...)

매개 변수	필수	Type	설명
<expression1>, <expression2>, ...	예	부울	검사할 식

반환 값	Type	설명
true 또는 false	부울	모든 식이 true이면 true를 반환합니다. 식 중의 적어도 한 개가 false이면 false를 반환합니다.

예제 1

다음 예제에서는 지정된 부울 값이 모두 true인지 확인합니다.

and(true, true)
and(false, true)
and(false, false)

그리고 다음 결과를 반환합니다.

첫 번째 예제: 두 식이 모두 true이므로 true를 반환합니다.
두 번째 예제: 식 한 개가 false이므로 false를 반환합니다.
세 번째 예제: 두 식이 모두 false이므로 false를 반환합니다.

예제 2

다음 예제에서는 지정된 식이 모두 true인지 확인합니다.

and(equals(1, 1), equals(2, 2))
and(equals(1, 1), equals(1, 2))
and(equals(1, 2), equals(1, 3))

그리고 다음 결과를 반환합니다.

첫 번째 예제: 두 식이 모두 true이므로 true를 반환합니다.
두 번째 예제: 식 한 개가 false이므로 false를 반환합니다.
세 번째 예제: 두 식이 모두 false이므로 false를 반환합니다.

array

단일 지정 입력에서 배열을 반환합니다. 여러 입력의 경우 createArray()를 참조하세요.

array('<value>')

매개 변수	필수	Type	설명
<value>	예	문자열	배열을 만드는 문자열

반환 값	Type	설명
[<value>]	배열	단일 지정 입력을 포함하는 배열

예제

이 예제는 "hello" 문자열에서 배열을 만듭니다.

array('hello')

그리고 다음 결과를 반환합니다. ["hello"]

B

base64

문자열에 대한 base64로 인코딩된 버전을 반환합니다.

참고 항목

Azure Logic Apps는 자동으로 또는 암시적으로 base64 인코딩 또는 디코딩을 수행하므로 사용자가 인코딩 및 디코딩 함수를 사용하여 이러한 변환을 수동으로 수행할 필요가 없습니다. 그러나 이러한 함수를 사용하는 경우 디자이너에서 예기치 않은 렌더링 동작이 발생할 수 있습니다. 이러한 동작은 함수의 매개 변수 값을 편집하여 코드에서 함수와 해당 효과를 제거하지 않는 한 함수의 표시 유형에만 영향을 줍니다. 자세한 내용은 Base64 인코딩 및 디코딩을 참조하세요.

base64('<value>')

매개 변수	필수	Type	설명
<value>	예	문자열	입력 문자열

반환 값	Type	설명
<base64-string>	문자열	문자열에 대한 base64로 인코딩된 버전

예제

이 예제는 "hello" 문자열을 base64로 인코딩된 문자열로 변환합니다.

base64('hello')

그리고 다음 결과를 반환합니다. "aGVsbG8="

base64ToBinary

Base64로 인코딩된 문자열에 대한 이진 버전을 반환합니다.

참고 항목

base64ToBinary('<value>')

매개 변수	필수	Type	설명
<value>	예	문자열	변환할 base64로 인코딩된 문자열

반환 값	Type	설명
<binary-for-base64-string>	문자열	Base64로 인코딩된 문자열에 대한 이진 버전

예제

이 예제는 base64로 인코딩된 문자열 "aGVsbG8="을 이진 문자열로 변환합니다.

base64ToBinary('aGVsbG8=')

예를 들어 HTTP 동작을 사용하여 요청을 보낸다고 가정해 보겠습니다. base64ToBinary()를 사용해 base64 인코딩 문자열을 이진 데이터로 변환하고 요청의 application/octet-stream 콘텐츠 형식으로 해당 데이터를 보낼 수 있습니다.

base64ToString

base64로 인코딩된 문자열에 대한 문자열 버전을 반환하며, 결과적으로 base64 문자열을 디코딩합니다. 사용되지 않는 DecodeBase64()가 아닌 이 함수를 사용합니다.

참고 항목

base64ToString('<value>')

매개 변수	필수	Type	설명
<value>	예	문자열	디코딩할 base64로 인코딩된 문자열

반환 값	Type	설명
<decoded-base64-string>	문자열	Base64로 인코딩된 문자열에 대한 문자열 버전

예제

이 예제는 base64로 인코딩된 문자열 "aGVsbG8="을 단순한 문자열로 변환합니다.

base64ToString('aGVsbG8=')

그리고 다음 결과를 반환합니다. "hello"

binary

base64로 인코딩된 이진 버전의 문자열을 반환합니다.

binary('<value>')

매개 변수	필수	Type	설명
<value>	예	문자열	변환할 문자열

반환 값	Type	설명
<binary-for-input-value>	문자열	지정된 문자열에 대한 base64로 인코딩된 이진 버전

예제

예를 들어 이미지 또는 비디오 파일을 반환하는 HTTP 작업을 사용합니다. 값을 base-64로 인코딩된 콘텐츠 봉투 모델로 변환하는 데 사용할 binary() 수 있습니다. 그런 다음 Compose와 같은 다른 작업에서 콘텐츠 봉투를 다시 사용할 수 있습니다. 이 함수 식을 사용해 요청의 application/octet-stream 콘텐츠 형식으로 문자열 바이트를 보낼 수 있습니다.

본문

런타임 시 작업의 body 출력을 반환합니다. 의 약식입니다 actions('<actionName>').outputs.body. 작업()을 참조하세요.

body('<actionName>')

매개 변수	필수	Type	설명
<actionName>	예	문자열	원하는 작업 출력의 이름입니다 `body` .

반환 값	Type	설명
<action-body-output>	문자열	`body` 지정된 작업의 출력

예제

이 예제는 X 작업에서 출력을 Get user 가져옵니다body.

body('Get_user')

그리고 다음 결과를 반환합니다.

"body": {
    "FullName": "Contoso Corporation",
    "Location": "Generic Town, USA",
    "Id": 283541717,
    "UserName": "ContosoInc",
    "FollowersCount": 172,
    "Description": "Leading the way in transforming the digital workplace.",
    "StatusesCount": 93,
    "FriendsCount": 126,
    "FavouritesCount": 46,
    "ProfileImageUrl": "https://pbs.twimg.com/profile_images/908820389907722240/gG9zaHcd_400x400.jpg"
}

bool

값의 부울 버전을 반환합니다.

bool(<value>)

매개 변수	필수	Type	설명
<value>	예	모두	부울로 변환할 값입니다.

bool()을 개체와 함께 사용하는 경우 개체의 값은 부울로 변환할 수 있는 문자열 또는 정수여야 합니다.

반환 값	Type	설명
`true` 또는 `false`	Boolean	지정된 값의 부울 버전입니다.

Outputs

다음 예제에서는 다음과 같이 지원되는 다양한 유형의 입력을 보여 줍니다.bool()

입력 값	Type	반환 값
`bool(1)`	정수	`true`
`bool(0)`	정수	`false`
`bool(-1)`	정수	`true`
`bool('true')`	문자열	`true`
`bool('false')`	문자열	`false`

C

chunk

문자열 또는 배열을 같은 길이의 청크로 분할합니다.

chunk('<collection>', '<length>')
chunk([<collection>], '<length>')

매개 변수	필수	Type	설명
<컬렉션>	예	문자열 또는 배열	분할할 컬렉션
<length>	예	각 청크의 길이

반환 값	Type	설명
<컬렉션>	배열	지정된 길이의 청크 배열

예제 1

다음 예제에서는 문자열을 길이 10의 청크로 분할합니다.

chunk('abcdefghijklmnopqrstuvwxyz', 10)

그리고 다음 결과를 반환합니다. ['abcdefghij', 'klmnopqrst', 'uvwxyz']

예제 2

다음 예제에서는 배열을 길이 5의 청크로 분할합니다.

chunk(createArray(1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12), 5)

그리고 다음 결과를 반환합니다. [ [1,2,3,4,5], [6,7,8,9,10], [11,12] ]

coalesce

하나 이상의 매개 변수에서 Null이 아닌 첫 번째 값을 반환합니다. 빈 문자열, 빈 배열, 빈 개체는 null이 아닙니다.

coalesce(<object_1>, <object_2>, ...)

매개 변수	필수	Type	설명
<object_1>, <object_2>, ...	예	Any, 형식을 혼합할 수 있음	Null인지 검사할 하나 이상의 항목

반환 값	Type	설명
<first-non-null-item>	모두	Null이 아닌 첫 번째 항목 또는 값입니다. 모든 매개 변수가 Null이면 이 함수는 Null을 반환합니다.

예제

아래 예제는 지정한 값에서 Null이 아닌 첫 번째 값 또는 모든 값이 Null인 경우 Null을 반환합니다.

coalesce(null, true, false)
coalesce(null, 'hello', 'world')
coalesce(null, null, null)

그리고 다음 결과를 반환합니다.

첫 번째 예제: true
두 번째 예제: "hello"
세 번째 예제: null

concat

둘 이상의 문자열을 결합하고 결합된 문자열을 반환합니다.

concat('<text1>', '<text2>', ...)

매개 변수	필수	Type	설명
<text1>, <text2>, ...	예	문자열	결합할 적어도 두 개의 문자열

반환 값	Type	설명
<text1text2...>	문자열	결합된 입력 문자열에서 만든 문자열 참고: 결과의 길이는 104,857,600자를 초과하면 안됩니다.

참고 항목

Azure Logic Apps는 base64 인코딩 및 디코딩을 자동으로 또는 암시적으로 수행하므로 인코딩 또는 디코딩이 필요한 데이터와 함께 함수를 사용할 concat() 때 이러한 변환을 수동으로 수행할 필요가 없습니다.

concat('data:;base64,',<value>)
concat('data:,',encodeUriComponent(<value>))

그러나 디자이너에서 이 함수를 사용하는 경우 디자이너에서 예기치 않은 렌더링 동작이 발생할 수 있습니다. 이러한 동작은 함수의 매개 변수 값을 편집하지 않는 한 함수의 표시 유형에만 영향을 미치며 코드에서 함수와 효과를 제거합니다. 자세한 내용은 Base64 인코딩 및 디코딩을 검토하세요.

예제

이 예제는 문자열 "Hello"와 "World"를 결합합니다.

concat('Hello', 'World')

그리고 다음 결과를 반환합니다. "HelloWorld"

contains

컬렉션에 특정 항목이 있는지 검사합니다. 항목이 발견되면 true를 반환하거나 발견되지 않으면 false를 반환합니다. 이 함수는 대/소문자를 구분합니다.

contains('<collection>', '<value>')
contains([<collection>], '<value>')

특히 이 함수는 아래 컬렉션 형식에서 작동합니다.

부분 문자열을 찾기 위한 문자열
값을 찾기 위한 배열
키를 찾기 위한 사전

매개 변수	필수	Type	설명
<컬렉션>	예	문자열, 배열 또는 사전	검사할 컬렉션
<value>	예	각각 문자열, 배열 또는 사전	찾을 항목

반환 값	Type	설명
true 또는 false	부울	항목이 발견되면 true를 반환합니다. 발견되지 않으면 false를 반환합니다.

예제 1

이 예제는 부분 문자열 "world"에 대한 문자열 "hello world"를 검사하고 true를 반환합니다.

contains('hello world', 'world')

예제 2

이 예제는 부분 문자열 "universe"에 대한 문자열 "hello world"를 검사하고 false를 반환합니다.

contains('hello world', 'universe')

convertFromUtc

UTC(Universal Time Coordinated)의 타임스탬프를 대상 표준 시간대로 변환합니다.

convertFromUtc('<timestamp>', '<destinationTimeZone>', '<format>'?)

매개 변수	필수	Type	설명
<timestamp>	예	문자열	타임스탬프를 포함하는 문자열
<destinationTimeZone>	예	문자열	대상 표준 시간대의 이름입니다. 표준 시간대 이름은 Microsoft Windows 기본 표준 시간대를 검토합니다.
<format>	아니요	문자열	단일 형식 지정자 또는 사용자 지정 형식 패턴인 숫자 서식 문자열입니다. 타임스탬프의 기본 형식은 "o"(yyyy-MM-ddTHH:mm:ss.fffffffK)입니다. 이 형식은 ISO 8601을 준수하며 표준 시간대 정보를 보존합니다. 형식이 유효한 값이 아니면 오류가 생성됩니다.

반환 값	Type	설명
<converted-timestamp>	문자열	표준 시간대 UTC 오프셋 없이 대상 표준 시간대로 변환된 타임스탬프입니다.

예제 1

이 예제는 타임스탬프를 지정한 표준 시간대로 변환합니다.

convertFromUtc('2018-01-01T08:00:00.0000000Z', 'Pacific Standard Time')

그리고 다음 결과를 반환합니다. "2018-01-01T00:00:00.0000000"

예제 2

이 예제는 타임스탬프를 지정한 표준 시간대 및 형식으로 변환합니다.

convertFromUtc('2018-01-01T08:00:00.0000000Z', 'Pacific Standard Time', 'D')

그리고 다음 결과를 반환합니다. "Monday, January 1, 2018"

convertTimeZone

원본 표준 시간대의 타임스탬프를 대상 표준 시간대로 변환합니다.

convertTimeZone('<timestamp>', '<sourceTimeZone>', '<destinationTimeZone>', '<format>'?)

매개 변수	필수	Type	설명
<timestamp>	예	문자열	타임스탬프를 포함하는 문자열
<sourceTimeZone>	예	문자열	원본 표준 시간대의 이름입니다. 표준 시간대 이름은 Microsoft Windows 기본 표준 시간대를 참조하세요. 하지만 표준 시간대 이름에서 문장 부호를 제거해야 할 수도 있습니다.
<destinationTimeZone>	예	문자열	대상 표준 시간대의 이름입니다. 표준 시간대 이름은 Microsoft Windows 기본 표준 시간대를 참조하세요. 하지만 표준 시간대 이름에서 문장 부호를 제거해야 할 수도 있습니다.
<format>	아니요	문자열	단일 형식 지정자 또는 사용자 지정 형식 패턴인 숫자 서식 문자열입니다. 타임스탬프의 기본 형식은 "o"(yyyy-MM-ddTHH:mm:ss.fffffffK)입니다. 이 형식은 ISO 8601을 준수하며 표준 시간대 정보를 보존합니다. 형식이 유효한 값이 아니면 오류가 생성됩니다.

반환 값	Type	설명
<converted-timestamp>	문자열	대상 표준 시간대로 변환된 타임스탬프

예제 1

이 예제는 원본 표준 시간대를 대상 표준 시간대로 변환합니다.

convertTimeZone('2018-01-01T08:00:00.0000000Z', 'UTC', 'Pacific Standard Time')

그리고 다음 결과를 반환합니다. "2018-01-01T00:00:00.0000000"

예제 2

이 예제는 표준 시간대를 지정한 표준 시간대 및 형식으로 변환합니다.

convertTimeZone('2018-01-01T80:00:00.0000000Z', 'UTC', 'Pacific Standard Time', 'D')

그리고 다음 결과를 반환합니다. "Monday, January 1, 2018"

convertToUtc

원본 표준 시간대의 타임스탬프를 UTC(Universal Time Coordinated)로 변환합니다.

convertToUtc('<timestamp>', '<sourceTimeZone>', '<format>'?)

매개 변수	필수	Type	설명
<timestamp>	예	문자열	타임스탬프를 포함하는 문자열
<sourceTimeZone>	예	문자열	원본 표준 시간대의 이름입니다. 표준 시간대 이름은 Microsoft Windows 기본 표준 시간대를 참조하세요. 하지만 표준 시간대 이름에서 문장 부호를 제거해야 할 수도 있습니다.
<format>	아니요	문자열	단일 형식 지정자 또는 사용자 지정 형식 패턴인 숫자 서식 문자열입니다. 타임스탬프의 기본 형식은 "o"(yyyy-MM-ddTHH:mm:ss.fffffffK)입니다. 이 형식은 ISO 8601을 준수하며 표준 시간대 정보를 보존합니다. 형식이 유효한 값이 아니면 오류가 생성됩니다.

반환 값	Type	설명
<converted-timestamp>	문자열	UTC로 변환된 타임스탬프

예제 1

이 예제는 타임스탬프를 UTC로 변환합니다.

convertToUtc('01/01/2018 00:00:00', 'Pacific Standard Time')

그리고 다음 결과를 반환합니다. "2018-01-01T08:00:00.0000000Z"

예제 2

이 예제는 타임스탬프를 UTC로 변환합니다.

convertToUtc('01/01/2018 00:00:00', 'Pacific Standard Time', 'D')

그리고 다음 결과를 반환합니다. "Monday, January 1, 2018"

createArray

여러 입력에서 배열을 반환합니다. 단일 입력 배열의 경우 array()를 참조하세요.

createArray('<object1>', '<object2>', ...)

매개 변수	필수	Type	설명
<object1>, <object2>, ...	예	모두, 그러나 혼합은 안 됨	배열을 만들 적어도 두 개의 항목

반환 값	Type	설명
[<object1>, <object2>, ...]	배열	모든 입력 항목에서 만든 배열

예제

이 예제는 다음 입력에서 배열을 만듭니다.

createArray('h', 'e', 'l', 'l', 'o')

그리고 다음 결과를 반환합니다. ["h", "e", "l", "l", "o"]

D

dataUri

문자열에 대한 데이터 URI(Uniform Resource Identifier)를 반환합니다.

dataUri('<value>')

매개 변수	필수	Type	설명
<value>	예	문자열	변환할 문자열

반환 값	Type	설명
<data-uri>	문자열	입력 문자열에 대한 데이터 URI

예제

이 예제는 "hello" 문자열에 대한 데이터 URI를 만듭니다.

dataUri('hello')

그리고 다음 결과를 반환합니다. "data:text/plain;charset=utf-8;base64,aGVsbG8="

dataUriToBinary

데이터 URI(Uniform Resource Identifier)에 대한 이진 버전을 반환합니다. decodeDataUri() 대신에 이 함수를 사용합니다. 두 함수 모두 같은 방법으로 작동하지만 dataUriBinary()를 사용하는 것이 좋습니다.

dataUriToBinary('<value>')

매개 변수	필수	Type	설명
<value>	예	문자열	변환할 데이터 URI

반환 값	Type	설명
<binary-for-data-uri>	문자열	데이터 URI에 대한 이진 버전

예제

이 예제는 이 데이터 URI에 대한 이진 버전을 만듭니다.

dataUriToBinary('data:text/plain;charset=utf-8;base64,aGVsbG8=')

그리고 다음 결과를 반환합니다.

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

dataUriToString

데이터 URI(Uniform Resource Identifier)에 대한 문자열 버전을 반환합니다.

dataUriToString('<value>')

매개 변수	필수	Type	설명
<value>	예	문자열	변환할 데이터 URI

반환 값	Type	설명
<string-for-data-uri>	문자열	데이터 URI에 대한 문자열 버전

예제

이 예제는 이 데이터 URI에 대한 문자열을 만듭니다.

dataUriToString('data:text/plain;charset=utf-8;base64,aGVsbG8=')

그리고 다음 결과를 반환합니다. "hello"

dateDifference

두 타임스탬프의 차이를 시간 범위로 반환합니다. 이 함수는 endDate에서 startDate를 빼고 결과를 문자열 형식의 타임스탬프로 반환합니다.

dateDifference('<startDate>', '<endDate>')

매개 변수	필수	Type	설명
<startDate>	예	문자열	타임스탬프를 포함하는 문자열
<endDate>	예	문자열	타임스탬프를 포함하는 문자열

반환 값	Type	설명
<timespan>	문자열	문자열 형식의 타임스탬프인 두 타임스탬프의 차이입니다. `startDate`가 `endDate`보다 더 최근인 경우 결과는 음수 값입니다.

예제

이 예제에서는 두 번째 값에서 첫 번째 값을 뺍니다.

dateDifference('2015-02-08', '2018-07-30')

그리고 다음 결과를 반환합니다. "1268.00:00:00"

dayOfMonth

타임스탬프에서 월의 날짜를 반환합니다.

dayOfMonth('<timestamp>')

매개 변수	필수	Type	설명
<timestamp>	예	문자열	타임스탬프를 포함하는 문자열

반환 값	Type	설명
<day-of-month>	정수	지정한 타임스탬프의 월의 날짜

예제

이 예제는 이 타임스탬프에서 월의 날짜에 대한 숫자를 반환합니다.

dayOfMonth('2018-03-15T13:27:36Z')

그리고 다음 결과를 반환합니다. 15

dayOfWeek

타임스탬프에서 요일을 반환합니다.

dayOfWeek('<timestamp>')

매개 변수	필수	Type	설명
<timestamp>	예	문자열	타임스탬프를 포함하는 문자열

반환 값	Type	설명
<day-of-week>	정수	일요일이 0, 월요일이 1이라는 식으로 지정한 타임스탬프의 요일

예제

이 예제는 이 타임스탬프에서 요일에 대한 숫자를 반환합니다.

dayOfWeek('2018-03-15T13:27:36Z')

그리고 다음 결과를 반환합니다. 4

dayOfYear

타임스탬프에서 년의 날짜를 반환합니다.

dayOfYear('<timestamp>')

매개 변수	필수	Type	설명
<timestamp>	예	문자열	타임스탬프를 포함하는 문자열

반환 값	Type	설명
<day-of-year>	정수	지정한 타임스탬프의 년의 날짜

예제

이 예제는 이 타임스탬프에서 년의 날짜인 숫자를 반환합니다.

dayOfYear('2018-03-15T13:27:36Z')

그리고 다음 결과를 반환합니다. 74

decimal

문자열의 10진수를 10진수로 반환합니다. 이 함수는 소수 자릿수가 필요한 데이터로 작업할 때 그리고 논리 비교 함수와 수학 함수에 대한 입력으로 사용할 수 있습니다. decimal() 함수의 결과를 사용할 때 전체 자릿수를 캡처하고 유지하려면 10진수 출력을 문자열 함수로 래핑합니다. 이 사용법은 소수 결과를 숫자로 사용하면 전체 자릿수를 잃을 수 있는 경우에 대한 아래의 예제에 나와 있습니다.

참고 항목

이 함수 및 Azure Logic Apps 런타임의 컨텍스트에서 설명하는 소수 자릿수는 .NET 소수 자릿수와 동일합니다.

decimal('<value>')

매개 변수	필수	Type	설명
<value>	예	문자열	문자열의 10진수입니다.

반환 값	Type	설명
<decimal>	10진수	입력 문자열의 10진수입니다.

예제 1

이 예제에서는 숫자로 사용되는 10진수를 만듭니다.

decimal('1.2345678912312131') // Returns 1.234567891231213.

예제 2

이 예제에서는 10진수를 만든 다음 전체 자릿수를 유지하기 위해 결과를 문자열로 변환합니다.

string(decimal('1.2345678912312131')) // Returns "1.2345678912312131".

예 3

이 예제에서는 10진수 두 개에 수학 함수를 사용하고 그 결과를 숫자로 사용합니다.

add(decimal('1.2345678912312131'), decimal('1.2345678912312131')) // Returns 2.469135782462426.

예제 4

이 예제에서는 10진수 두 개에 수학 함수를 사용하고 전체 자릿수를 유지하기 위해 결과를 문자열로 변환합니다.

string(add(decimal('1.2345678912312131'), decimal('1.2345678912312131'))) // Returns "2.4691357824624262".

decodeBase64(사용되지 않음)

이 함수는 더 이상 사용되지 않으므로 base64ToString()를 대신 사용합니다.

decodeDataUri

데이터 URI(Uniform Resource Identifier)에 대한 이진 버전을 반환합니다. decodeDataUri() 대신에 dataUriToBinary()의 사용을 검토해 보세요. 두 함수 모두 같은 방법으로 작동하지만 dataUriToBinary()를 사용하는 것이 좋습니다.

참고 항목

decodeDataUri('<value>')

매개 변수	필수	Type	설명
<value>	예	문자열	디코딩할 데이터 URI 문자열

반환 값	Type	설명
<binary-for-data-uri>	문자열	데이터 URI 문자열에 대한 이진 버전

예제

이 예제는 이 데이터 URI에 대한 이진 버전을 반환합니다.

decodeDataUri('data:text/plain;charset=utf-8;base64,aGVsbG8=')

그리고 다음 결과를 반환합니다.

decodeUriComponent

디코딩된 버전으로 이스케이프 문자를 바꾸는 문자열을 반환합니다.

decodeUriComponent('<value>')

매개 변수	필수	Type	설명
<value>	예	문자열	디코딩할 이스케이프 문자를 포함한 문자열

반환 값	Type	설명
<decoded-uri>	문자열	디코딩된 이스케이프 문자로 업데이트된 문자열

예제

이 예제는 이 문자열의 이스케이프 문자를 디코딩된 버전으로 바꿉니다.

decodeUriComponent('https%3A%2F%2Fcontoso.com')

그리고 다음 결과를 반환합니다. "https://contoso.com"

div

두 숫자를 나눈 결과를 반환합니다. 나머지 결과를 얻으려면 mod()를 참조하세요.

div(<dividend>, <divisor>)

매개 변수	필수	Type	설명
<dividend>	예	정수 또는 부동 소수점 수	제수로 나눌 숫자
<divisor>	예	정수 또는 부동 소수점 수	피제수를 분할하는 숫자이지만 0일 수는 없습니다.

반환 값	Type	설명
<quotient-result>	정수 또는 부동 소수점 수	첫 번째 숫자를 두 번째 숫자로 나눈 결과입니다. 배당 또는 제수에 Float 형식이 있으면 결과에 Float 형식이 있습니다. 참고: 부동 소수점 결과를 정수로 변환하려면 논리 앱에서 Azure에서 함수를 만들고 호출합니다.

예제 1

두 예제 모두 Integer 형식의 값 2를 반환합니다.

div(10,5)
div(11,5)

예제 2

두 예제 모두 Integer 형식의 값 2.2를 반환합니다.

div(11,5.0)
div(11.0,5)

E

encodeUriComponent

URL 안전하지 않은 문자를 이스케이프 문자로 바꾸어 문자열에 대한 URI(Uniform Resource Identifier) 인코딩된 버전을 반환합니다. encodeUriComponent() 대신에 uriComponent()의 사용을 검토해 보세요. 두 함수 모두 같은 방법으로 작동하지만 uriComponent()를 사용하는 것이 좋습니다.

참고 항목

encodeUriComponent('<value>')

매개 변수	필수	Type	설명
<value>	예	문자열	URI 인코딩된 형식으로 변환할 문자열

반환 값	Type	설명
<encoded-uri>	문자열	이스케이프 문자로 URI 인코딩된 문자열

예제

이 예제는 이 문자열에 대한 URI 인코딩된 버전을 만듭니다.

encodeUriComponent('https://contoso.com')

그리고 다음 결과를 반환합니다. "https%3A%2F%2Fcontoso.com"

empty

컬렉션이 비어 있는지 검사합니다. 컬렉션이 비어 있으면 true를 반환하거나 비어 있지 않으면 false를 반환합니다.

empty('<collection>')
empty([<collection>])

매개 변수	필수	Type	설명
<컬렉션>	예	문자열, 배열 또는 개체	검사할 컬렉션

반환 값	Type	설명
true 또는 false	부울	컬렉션이 비어 있으면 true를 반환합니다. 비어 있지 않으면 false를 반환합니다.

예제

아래 예제는 지정한 컬렉션이 비어 있는지 검사합니다.

empty('')
empty('abc')

그리고 다음 결과를 반환합니다.

첫 번째 예제: 비어 있는 문자열을 전달하므로 함수는 true를 반환합니다.
두 번째 예제: 문자열 "abc"를 전달하므로 함수는 false를 반환합니다.

endsWith

문자열이 특정 하위 문자열로 종료하는지 검사합니다. 하위 문자열이 발견되면 true를 반환하거나 발견되지 않으면 false를 반환합니다. 이 함수는 대/소문자를 구분하지 않습니다.

endsWith('<text>', '<searchText>')

매개 변수	필수	Type	설명
<text>	예	문자열	검사할 문자열
<searchText>	예	문자열	찾을 끝나는 하위 문자열

반환 값	Type	설명
true 또는 false	부울	끝나는 하위 문자열이 발견되면 true를 반환합니다. 발견되지 않으면 false를 반환합니다.

예제 1

이 예제는 "hellow world" 문자열이 "world" 문자열로 끝나는지 검사합니다.

endsWith('hello world', 'world')

그리고 다음 결과를 반환합니다. true

예제 2

이 예제는 "hellow world" 문자열이 "universe" 문자열로 끝나는지 검사합니다.

endsWith('hello world', 'universe')

그리고 다음 결과를 반환합니다. false

같음

두 값, 식 또는 개체가 모두 같은지 검사합니다. 둘이 다 같으면 true를 반환하거나 같지 않으면 false를 반환합니다.

equals('<object1>', '<object2>')

매개 변수	필수	Type	설명
<object1>, <object2>	예	다양한	비교할 값, 식 또는 개체

반환 값	Type	설명
true 또는 false	부울	둘이 같으면 true를 반환합니다. 같지 않으면 false를 반환합니다.

예제

아래 예제는 지정한 입력들이 같은지 검사합니다.

equals(true, 1)
equals('abc', 'abcd')

그리고 다음 결과를 반환합니다.

첫 번째 예제: 두 값이 모두 같으므로 함수는 true를 반환합니다.
두 번째 예제: 두 값이 같지 않으므로 함수는 false를 반환합니다.

F

첫째

문자열 또는 배열에서 첫 번째 항목을 반환합니다.

first('<collection>')
first([<collection>])

매개 변수	필수	Type	설명
<컬렉션>	예	문자열 또는 배열	첫 번째 항목을 찾을 컬렉션

반환 값	Type	설명
<first-collection-item>	모두	컬렉션의 첫 번째 항목

예제

아래 예제는 이러한 컬렉션의 첫 번째 항목을 찾습니다.

first('hello')
first(createArray(0, 1, 2))

그리고 다음 결과를 반환합니다.

첫 번째 예제: "h"
두 번째 예제: 0

float

부동 소수점 수에 대한 문자열 버전을 실제 부동 소수점 수로 변환합니다. 이 함수는 논리 앱 워크플로 또는 Power Automate 흐름 등의 앱에 사용자 지정 매개 변수를 전달할 때만 사용할 수 있습니다. 로캘별 형식으로 표현되는 부동 소수점 문자열을 변환하기 위해 필요에 따라 RFC 4646 로캘 코드를 지정할 수 있습니다.

float('<value>', '<locale>'?)

매개 변수	필수	Type	설명
<value>	예	문자열	변환할 유효한 부동 소수점 숫자가 있는 문자열입니다. 최솟값과 최댓값은 부동 데이터 형식의 제한과 동일합니다.
<로캘>	아니요	문자열	사용할 RFC 4646 로캘 코드입니다. 지정하지 않으면 기본 로캘이 사용됩니다. 로캘이 유효한 값이 아니면 제공된 로캘이 유효하지 않거나 연결된 로캘이 없다는 오류가 생성됩니다.

반환 값	Type	설명
<float-value>	Float	지정된 문자열에 대한 부동 소수점 숫자입니다. 최솟값과 최댓값은 부동 데이터 형식의 제한과 동일합니다.

예제 1

이 예제는 이 부동 소수점 수에 대한 문자열 버전을 만듭니다.

float('10,000.333')

그리고 다음 결과를 반환합니다. 10000.333

예제 2

이 예제에서는 이 독일어 스타일 부동 소수점 숫자에 대한 문자열 버전을 만듭니다.

float('10.000,333', 'de-DE')

그리고 다음 결과를 반환합니다. 10000.333

formatDateTime

지정한 형식의 타임스탬프를 반환합니다.

formatDateTime('<timestamp>', '<format>'?, '<locale>'?)

매개 변수	필수	Type	설명
<timestamp>	예	문자열	타임스탬프를 포함하는 문자열
<format>	아니요	문자열	단일 형식 지정자 또는 사용자 지정 형식 패턴인 숫자 서식 문자열입니다. 타임스탬프의 기본 형식은 "o"(yyyy-MM-ddTHH:mm:ss.fffffffK)입니다. 이 형식은 ISO 8601을 준수하며 표준 시간대 정보를 보존합니다.
<로캘>	아니요	문자열	사용할 로캘입니다. 지정하지 않으면 값은 `en-us`입니다. 로캘이 유효한 값이 아니면 오류가 생성됩니다.

반환 값	Type	설명
<reformatted-timestamp>	문자열	지정된 경우, 지정된 형식과 로캘로 업데이트된 타임스탬프입니다.

예제

formatDateTime('03/15/2018') // Returns '2018-03-15T00:00:00.0000000'.
formatDateTime('03/15/2018 12:00:00', 'yyyy-MM-ddTHH:mm:ss') // Returns '2018-03-15T12:00:00'.
formatDateTime('01/31/2016', 'dddd MMMM d') // Returns 'Sunday January 31'.
formatDateTime('01/31/2016', 'dddd MMMM d', 'fr-fr') // Returns 'dimanche janvier 31'.
formatDateTime('01/31/2016', 'dddd MMMM d', 'fr-FR') // Returns 'dimanche janvier 31'.
formatDateTime('01/31/2016', 'dddd MMMM d', 'es-es') // Returns 'domingo enero 31'.

formDataMultiValues

작업의 양식 데이터 또는 양식 인코딩된 출력의 키 이름과 일치하는 값을 가진 배열을 반환합니다.

formDataMultiValues('<actionName>', '<key>')

매개 변수	필수	Type	설명
<actionName>	예	문자열	해당 출력이 원하는 키를 가진 작업
<key>	예	문자열	값을 원하는 키의 이름입니다.

반환 값	Type	설명
[<array-with-key-values>]	배열	지정된 키와 일치하는 모든 값이 있는 배열

예제

이 예제는 지정한 작업의 양식 데이터 또는 양식 인코딩된 출력의 "제목" 키의 값에서 배열을 만듭니다.

formDataMultiValues('Send_an_email', 'Subject')

배열에서 제목 텍스트를 반환합니다. 예를 들면 다음과 같습니다. ["Hello world"]

formDataValue

동작의 양식 데이터 또는 폼 인코딩 출력의 키 이름과 일치하는 단일 값을 반환합니다. 함수가 일치하는 항목을 두 개 이상 찾으면 함수에서 오류가 발생합니다.

formDataValue('<actionName>', '<key>')

매개 변수	필수	Type	설명
<actionName>	예	문자열	해당 출력이 원하는 키를 가진 작업
<key>	예	문자열	값을 원하는 키의 이름입니다.

반환 값	Type	설명
<키-값>	문자열	지정된 키의 값입니다.

예제

다음은 지정된 작업의 양식 데이터 또는 폼 인코딩 출력에 "Subject" 키 값에서 문자열을 만드는 예제입니다.

formDataValue('Send_an_email', 'Subject')

그리고 제목 텍스트를 문자열로 반환, 예: "Hello world"

formatNumber

숫자를 지정된 형식을 기반으로 하는 문자열로 반환합니다.

formatNumber(<number>, <format>, <locale>?)

매개 변수	필수	Type	설명
<number>	예	정수 또는 이중	서식을 지정할 값입니다.
<format>	예	문자열	사용할 형식을 지정하는 복합 형식 문자열입니다. 지원되는 숫자 형식 문자열은 .에서 지원하는 `number.ToString(<format>, <locale>)`표준 숫자 형식 문자열을 참조하세요.
<로캘>	아니요	문자열	에서 지원하는 `number.ToString(<format>, <locale>)`대로 사용할 로캘입니다. 지정하지 않으면 값은 `en-us`입니다. 로캘이 유효한 값이 아니면 오류가 생성됩니다.

반환 값	Type	설명
<formatted-number>	문자열	지정한 형식의 문자열로 지정된 숫자입니다. 이 반환 값을 또는 `int` `float`.로 캐스팅할 수 있습니다.

예제 1

숫자 1234567890의 서식을 지정하려고 한다고 가정하겠습니다. 이 예제에서는 해당 숫자를 문자열 "1,234,567,890.00"으로 서식을 지정합니다.

formatNumber(1234567890, '0,0.00', 'en-us')

*예제 2"

숫자 1234567890의 서식을 지정하려고 한다고 가정하겠습니다. 다음은 숫자의 서식을 "1.234.567.890,00" 문자열로 지정하는 예제입니다.

formatNumber(1234567890, '0,0.00', 'is-is')

예 3

숫자 17.35의 서식을 지정하려고 한다고 가정하겠습니다. 다음은 숫자의 서식을 "$17.35" 문자열로 지정하는 예제입니다.

formatNumber(17.35, 'C2')

예제 4

숫자 17.35의 서식을 지정하려고 한다고 가정하겠습니다. 다음은 숫자 형식을 문자열 "17,35 kr"로 지정하는 예제입니다.

formatNumber(17.35, 'C2', 'is-is')

G

getFutureTime

지정한 시간 단위를 더한 현재 타임스탬프를 반환합니다.

getFutureTime(<interval>, <timeUnit>, <format>?)

매개 변수	필수	Type	설명
<interval>	예	정수	추가할 시간 단위 수
<timeUnit>	예	문자열	interval과 함께 사용할 시간 단위: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
<format>	아니요	문자열	단일 형식 지정자 또는 사용자 지정 형식 패턴입니다. 타임스탬프의 기본 형식은 "o"(yyyy-MM-ddTHH:mm:ss.fffffffK)입니다. 이 형식은 ISO 8601을 준수하며 표준 시간대 정보를 보존합니다. 형식이 유효한 값이 아니면 제공된 형식이 유효하지 않고 숫자 형식 문자열이어야 한다는 오류가 생성됩니다.

반환 값	Type	설명
<updated-timestamp>	문자열	현재 타임스탬프 + 지정한 시간 단위 수

예제 1

현재 타임스탬프가 "2018-03-01T00:00:00.0000000Z"라고 가정합니다. 이 예제는 해당 타임스탬프에 5일을 더합니다.

getFutureTime(5, 'Day')

그리고 다음 결과를 반환합니다. "2018-03-06T00:00:00.0000000Z"

예제 2

현재 타임스탬프가 "2018-03-01T00:00:00.0000000Z"라고 가정합니다. 이 예제는 5일을 더하고 결과를 "D" 형식으로 변환합니다.

getFutureTime(5, 'Day', 'D')

그리고 다음 결과를 반환합니다. "Tuesday, March 6, 2018"

getPastTime

지정한 시간 단위를 뺀 현재 타임스탬프를 반환합니다.

getPastTime(<interval>, <timeUnit>, <format>?)

매개 변수	필수	Type	설명
<interval>	예	정수	뺄 지정한 시간 단위 수
<timeUnit>	예	문자열	interval과 함께 사용할 시간 단위: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
<format>	아니요	문자열	단일 형식 지정자 또는 사용자 지정 형식 패턴입니다. 타임스탬프의 기본 형식은 "o"(yyyy-MM-ddTHH:mm:ss.fffffffK)입니다. 이 형식은 ISO 8601을 준수하며 표준 시간대 정보를 보존합니다. 형식이 유효한 값이 아니면 제공된 형식이 유효하지 않고 숫자 형식 문자열이어야 한다는 오류가 생성됩니다.

반환 값	Type	설명
<updated-timestamp>	문자열	현재 타임스탬프 - 지정한 시간 단위 수

예제 1

현재 타임스탬프가 "2018-02-01T00:00:00.0000000Z"라고 가정합니다. 이 예제는 해당 타임스탬프에서 5일을 뺍니다.

getPastTime(5, 'Day')

그리고 다음 결과를 반환합니다. "2018-01-27T00:00:00.0000000Z"

예제 2

현재 타임스탬프가 "2018-02-01T00:00:00.0000000Z"라고 가정합니다. 이 예제는 5일을 빼고 결과를 "D" 형식으로 변환합니다.

getPastTime(5, 'Day', 'D')

그리고 다음 결과를 반환합니다. "Saturday, January 27, 2018"

greater

첫 번째 값이 두 번째 값보다 큰지 검사합니다. 첫 번째 값이 더 크면 true를 반환하거나 더 작으면 false를 반환합니다.

greater(<value>, <compareTo>)
greater('<value>', '<compareTo>')

매개 변수	필수	Type	설명
<value>	예	정수, 부동 소수점 수 또는 문자열	두 번째 값보다 큰지 검사할 첫 번째 값
<compareTo>	예	각각 정수, 부동 소수점 수 또는 문자열	비교 값

반환 값	Type	설명
true 또는 false	부울	첫 번째 값이 두 번째 값보다 크면 true를 반환합니다. 첫 번째 값이 두 번째 값보다 작거나 같으면 false를 반환합니다.

예제

아래 예제는 첫 번째 값이 두 번째 값보다 큰지 검사합니다.

greater(10, 5)
greater('apple', 'banana')

그리고 다음 결과를 반환합니다.

첫 번째 예제: true
두 번째 예제: false

greaterOrEquals

첫 번째 값이 두 번째 값보다 크거나 같은지 검사합니다. 첫 번째 값이 두 번째 값보다 크거나 같으면 true를 반환하거나 첫 번째 값이 더 작으면 false를 반환합니다.

greaterOrEquals(<value>, <compareTo>)
greaterOrEquals('<value>', '<compareTo>')

매개 변수	필수	Type	설명
<value>	예	정수, 부동 소수점 수 또는 문자열	두 번째 값보다 크거나 같은지 검사할 첫 번째 값
<compareTo>	예	각각 정수, 부동 소수점 수 또는 문자열	비교 값

반환 값	Type	설명
true 또는 false	부울	첫 번째 값이 두 번째 값보다 크거나 같으면 true를 반환합니다. 첫 번째 값이 두 번째 값보다 작으면 false를 반환합니다.

예제

아래 예제는 첫 번째 값이 두 번째 값보다 크거나 같은지 검사합니다.

greaterOrEquals(5, 5)
greaterOrEquals('apple', 'banana')

그리고 다음 결과를 반환합니다.

첫 번째 예제: true
두 번째 예제: false

guid

GUID(전역적으로 고유한 식별자)를 문자열로 생성합니다. 예, "c2ecc88d-88c8-4096-912c-d6f2e2b138ce":

guid()

또한 GUID에 대해 하이픈으로 구분된 32자리인 기본 형식 "D" 이외의 다른 형식을 지정할 수 있습니다.

guid('<format>')

매개 변수	필수	Type	설명
<format>	아니요	문자열	반환되는 GUID에 대한 단일 형식 지정자입니다. 기본적으로 형식은 "D"이지만 "N", "D", "B", "P" 또는 "X"를 사용할 수 있습니다.

반환 값	Type	설명
<GUID-value>	문자열	임의로 생성된 GUID

예제

이 예제는 같은 GUID를 생성하되, 하이픈으로 구분되고 소괄호로 둘러싼 32자리로 생성합니다.

guid('P')

그리고 다음 결과를 반환합니다. "(c2ecc88d-88c8-4096-912c-d6f2e2b138ce)"

I

if

식이 true인지 또는 false인지 검사합니다. 결과에 기반해 지정한 값을 반환합니다. 매개 변수는 왼쪽에서 오른쪽으로 평가됩니다.

if(<expression>, <valueIfTrue>, <valueIfFalse>)

매개 변수	필수	Type	설명
<expression>	예	부울	검사할 식
<valueIfTrue>	예	모두	식이 true이면 반환할 값
<valueIfFalse>	예	모두	식이 false이면 반환할 값

반환 값	Type	설명
<specified-return-value>	모두	식이 true인지 또는 false인지에 기반해 반환하는 지정한 값

예제

이 예제는 지정한 식이 true를 반환하므로 "yes"를 반환합니다. 그렇지 않으면 이 예제는 "no"를 반환합니다.

if(equals(1, 1), 'yes', 'no')

indexOf

하위 문자열에 대한 시작 위치 또는 인덱스 값을 반환합니다. 이 함수는 대/소문자를 구분하지 않으며 인덱스는 숫자 0으로 시작합니다.

indexOf('<text>', '<searchText>')

매개 변수	필수	Type	설명
<text>	예	문자열	찾을 하위 문자열을 가진 문자열
<searchText>	예	문자열	찾을 하위 문자열

반환 값	Type	설명
<index-value>	정수	지정한 하위 문자열에 대한 시작 위치 또는 인덱스 값 문자열을 찾을 수 없는 경우 숫자 -1을 반환합니다.

예제

이 예제는 "hello world" 문자열의 "world" 하위 문자열에 대한 시작 인덱스 값을 찾습니다.

indexOf('hello world', 'world')

그리고 다음 결과를 반환합니다. 6

int

정수의 문자열 버전을 실제 정수로 변환합니다.

int('<value>')

매개 변수	필수	Type	설명
<value>	예	문자열	변환할 정수의 문자열 버전입니다. 최솟값과 최댓값은 정수 데이터 형식의 제한과 동일합니다.

반환 값	Type	설명
<integer-result>	정수	지정된 문자열에 대한 정수 버전입니다. 최솟값과 최댓값은 정수 데이터 형식의 제한과 동일합니다.

예제

이 예제는 문자열 "10"에 대한 정수 버전을 만듭니다.

int('10')

그리고 다음 결과를 반환합니다. 10

isFloat

문자열이 부동 소수점 숫자인지 여부를 나타내는 부울을 반환합니다. 기본적으로 이 함수는 부동 소수점 형식에 대한 고정 문화권을 사용합니다. 다른 로캘별 형식으로 표현되는 부동 소수점 숫자를 식별하기 위해 필요에 따라 RFC 4646 로캘 코드를 지정할 수 있습니다.

isFloat('<string>', '<locale>'?)

매개 변수	필수	Type	설명
<value>	예	문자열	검사할 문자열
<로캘>	아니요	문자열	사용할 RFC 4646 로캘 코드

반환 값	Type	설명
<부울 결과>	Boolean	문자열이 부동 소수점 숫자인지 여부를 나타내는 부울

예제 1

다음 예제에서는 문자열이 고정 문화권의 부동 소수점 숫자인지 여부를 확인합니다.

isFloat('10,000.00')

그리고 다음 결과를 반환합니다. true

예제 2

다음 예제에서는 문자열이 독일어 로캘의 부동 소수점 숫자인지 여부를 확인합니다.

isFloat('10.000,00', 'de-DE')

그리고 다음 결과를 반환합니다. true

isInt

문자열이 정수인지 여부를 나타내는 부울을 반환합니다.

isInt('<string>')

매개 변수	필수	Type	설명
<string>	예	문자열	검사할 문자열

반환 값	Type	설명
<부울 결과>	Boolean	문자열이 정수인지 여부를 나타내는 부울

예제

다음 예제에서는 문자열이 정수인지 여부를 확인합니다.

isInt('10')

그리고 다음 결과를 반환합니다. true

item

배열에 대해 반복 작업 내에서 사용하는 경우 작업의 현재 반복 중에 배열의 현재 항목을 반환합니다. 해당 항목의 속성에서 값을 가져올 수도 있습니다.

item()

반환 값	Type	설명
<current-array-item>	모두	작업의 현재 반복에 대한 배열의 현재 항목

예제

이 예제에서는 for-each 루프의 현재 반복 내에서 "Send_an_email" 작업에 대한 현재 메시지에서 요소를 가져옵니다 body .

item().body

항목

for-each 루프의 각 주기에서 현재 항목을 반환합니다. for-each 루프 내에서 이 함수를 사용합니다.

items('<loopName>')

매개 변수	필수	Type	설명
<loopName>	예	문자열	for-each 루프의 이름

반환 값	Type	설명
<항목>	모두	지정된 for-each 루프의 현재 주기 항목

예제

이 예제는 지정한 for-each 루프에서 현재 항목을 가져옵니다.

items('myForEachLoopName')

iterationIndexes

Until 루프 내에서 현재 반복의 인덱스 값을 반환합니다. 중첩된 Until 루프 내에서 이 함수를 사용할 수 있습니다.

iterationIndexes('<loopName>')

매개 변수	필수	Type	설명
<loopName>	예	문자열	Until 루프의 이름입니다.

반환 값	Type	설명
<인덱스>	정수	지정된 Until 루프 내의 현재 반복에 대한 인덱스 값입니다.

예제

이 예제에서는 카운터 변수를 만들고 카운터 값이 5에 도달할 때까지 Until 루프에서 각 반복 중에 해당 변수를 하나씩 증분합니다. 이 예제에서는 각 반복에 대한 현재 인덱스도 추적하는 변수를 만듭니다. Until 루프에서 각 반복마다 예제에서는 카운터 값을 증가시키고 카운터 값을 현재 인덱스 값에 할당한 다음, 카운터 값을 증가시킵니다. 루프에 있는 동안 이 예제에서는 함수를 사용하여 현재 반복 인덱스를 참조합니다 iterationIndexes .

iterationIndexes('Until_Max_Increment')

{
   "actions": {
      "Create_counter_variable": {
         "type": "InitializeVariable",
         "inputs": {
            "variables": [ 
               {
                  "name": "myCounter",
                  "type": "Integer",
                  "value": 0
               }
            ]
         },
         "runAfter": {}
      },
      "Create_current_index_variable": {
         "type": "InitializeVariable",
         "inputs": {
            "variables": [
               {
                  "name": "myCurrentLoopIndex",
                  "type": "Integer",
                  "value": 0
               }
            ]
         },
         "runAfter": {
            "Create_counter_variable": [ "Succeeded" ]
         }
      },
      "Until_Max_Increment": {
         "type": "Until",
         "actions": {
            "Assign_current_index_to_counter": {
               "type": "SetVariable",
               "inputs": {
                  "name": "myCurrentLoopIndex",
                  "value": "@variables('myCounter')"
               },
               "runAfter": {
                  "Increment_variable": [ "Succeeded" ]
               }
            },
            "Compose": {
               "inputs": "'Current index: ' @{iterationIndexes('Until_Max_Increment')}",
               "runAfter": {
                  "Assign_current_index_to_counter": [
                     "Succeeded"
                    ]
                },
                "type": "Compose"
            },           
            "Increment_variable": {
               "type": "IncrementVariable",
               "inputs": {
                  "name": "myCounter",
                  "value": 1
               },
               "runAfter": {}
            }
         },
         "expression": "@equals(variables('myCounter'), 5)",
         "limit": {
            "count": 60,
            "timeout": "PT1H"
         },
         "runAfter": {
            "Create_current_index_variable": [ "Succeeded" ]
         }
      }
   }
}

J

json

문자열 또는 XML에 대한 JSON(JavaScript Object Notation) 형식 값, 개체 또는 개체 배열을 반환합니다.

json('<value>')
json(xml('value'))

Important

출력의 구조를 정의하는 XML 스키마가 없으면 함수는 입력에 따라 구조체가 예상 형식과 크게 다른 결과를 반환할 수 있습니다.

이 동작으로 인해 출력이 중요한 비즈니스 시스템 또는 솔루션과 같이 잘 정의된 계약을 준수해야 하는 시나리오에는 이 함수를 적합하지 않습니다.

매개 변수	필수	Type	설명
<value>	예	문자열 또는 XML	변환할 문자열 또는 XML

반환 값	Type	설명
<JSON-result>	JSON 네이티브 형식, 개체 또는 배열	입력 문자열 또는 XML의 JSON 네이티브 형식 값, 개체 또는 개체 배열입니다. - 루트 요소에 단일 자식 요소가 있는 XML을 전달하는 경우 함수는 해당 자식 요소에 대한 단일 JSON 개체를 반환합니다. - 루트 요소에 여러 자식 요소가 있는 XML을 전달하는 경우 함수는 해당 자식 요소에 대한 JSON 개체가 포함된 배열을 반환합니다. - 문자열이 null이면 함수는 빈 개체를 반환합니다.

예제 1

이 예제에서는 이 문자열을 JSON 값으로 변환합니다.

json('[1, 2, 3]')

그리고 다음 결과를 반환합니다. [1, 2, 3]

예제 2

이 예제에서는 이 문자열을 JSON으로 변환합니다.

json('{"fullName": "Sophia Owen"}')

그리고 다음 결과를 반환합니다.

{
  "fullName": "Sophia Owen"
}

예 3

이 예제에서는 함수 및 xml() 함수를 사용하여 json() 루트 요소에 단일 자식 요소가 있는 XML을 해당 자식 요소의 이름이 지정된 person JSON 개체로 변환합니다.

json(xml('<?xml version="1.0"?> <root> <person id="1"> <name>Sophia Owen</name> <occupation>Engineer</occupation> </person> </root>'))

그리고 다음 결과를 반환합니다.

{
   "?xml": { 
      "@version": "1.0" 
   },
   "root": {
      "person": {
         "@id": "1",
         "name": "Sophia Owen",
         "occupation": "Engineer"
      }
   }
}

예제 4

이 예제에서는 함수와 xml() 함수를 사용하여 json() 루트 요소에 여러 자식 요소가 있는 XML을 해당 자식 요소에 대한 JSON 개체가 포함된 배열 person 로 변환합니다.

json(xml('<?xml version="1.0"?> <root> <person id="1"> <name>Sophia Owen</name> <occupation>Engineer</occupation> </person> <person id="2"> <name>John Doe</name> <occupation>Engineer</occupation> </person> </root>'))

그리고 다음 결과를 반환합니다.

{
   "?xml": {
      "@version": "1.0"
   },
   "root": {
      "person": [
         {
            "@id": "1",
            "name": "Sophia Owen",
            "occupation": "Engineer"
         },
         {
            "@id": "2",
            "name": "John Doe",
            "occupation": "Engineer"
         }
      ]
   }
}

intersection

지정한 컬렉션에서 공통 항목만 있는 컬렉션을 반환합니다. 결과에 나타내려면 항목이 이 함수에 전달된 모든 컬렉션에 나타나야 합니다. 같은 이름을 가진 항목이 한 개 이상이면 해당 이름의 마지막 항목이 결과에 나타납니다.

intersection([<collection1>], [<collection2>], ...)
intersection('<collection1>', '<collection2>', ...)

매개 변수	필수	Type	설명
<collection1>, <collection2>, ...	예	배열 또는 개체, 그러나 둘 다는 아님	공통 항목만 원하는 컬렉션

반환 값	Type	설명
<common-items>	각각 배열 또는 개체	지정한 컬렉션에 대해 공통 항목만 있는 컬렉션

예제

이 예제는 이러한 배열에 대한 공통 항목을 찾습니다.

intersection(createArray(1, 2, 3), createArray(101, 2, 1, 10), createArray(6, 8, 1, 2))

그리고 다음 항목만 가진 배열을 반환합니다. [1, 2]

join

배열의 모든 항목을 포함하고 각 문자가 구분 기호로 구분된 문자열을 반환합니다.

join([<collection>], '<delimiter>')

매개 변수	필수	Type	설명
<컬렉션>	예	배열	조인할 항목이 있는 배열
<delimiter>	예	문자열	결과 문자열의 각 문자 사이에 나타나는 구분 기호

반환 값	Type	설명
<char1><delimiter><char2><delimiter>...	문자열	지정된 배열의 모든 항목에서 만든 결과 문자열입니다. 참고: 결과의 길이는 104,857,600자를 초과하면 안됩니다.

예제

이 예제는 지정한 문자를 구분 기호로 하여 이 배열의 모든 항목에서 문자열을 만듭니다.

join(createArray('a', 'b', 'c'), '.')

그리고 다음 결과를 반환합니다. "a.b.c"

L

last

컬렉션에서 마지막 항목을 반환합니다.

last('<collection>')
last([<collection>])

매개 변수	필수	Type	설명
<컬렉션>	예	문자열 또는 배열	마지막 항목을 찾을 컬렉션

반환 값	Type	설명
<last-collection-item>	각각 문자열 또는 배열	컬렉션의 마지막 항목

예제

아래 예제는 이러한 컬렉션의 마지막 항목을 찾습니다.

last('abcd')
last(createArray(0, 1, 2, 3))

그리고 다음 결과를 반환합니다.

첫 번째 예제: "d"
두 번째 예제: 3

lastIndexOf

마지막으로 나오는 부분 문자열의 시작 위치 또는 인덱스 값을 반환합니다. 이 함수는 대/소문자를 구분하지 않으며 인덱스는 숫자 0으로 시작합니다.

lastIndexOf('<text>', '<searchText>')

매개 변수	필수	Type	설명
<text>	예	문자열	찾을 하위 문자열을 가진 문자열
<searchText>	예	문자열	찾을 하위 문자열

반환 값	Type	설명
<ending-index-value>	정수	마지막으로 나오는 지정된 부분 문자열의 시작 위치 또는 인덱스 값입니다.

문자열 또는 부분 문자열 값이 비어 있으면 다음 동작이 발생합니다.

문자열 값만 비어 있으면 함수가 반환됩니다 -1.
문자열 및 부분 문자열 값이 모두 비어 있으면 함수가 반환됩니다 0.
부분 문자열 값만 비어 있으면 함수는 문자열 길이에서 1을 뺀 값을 반환합니다.

예제

이 예제에서는 문자열hello world hello world에서 부분 문자열 부분 문자열 world 의 마지막 발생에 대한 시작 인덱스 값을 찾습니다. 반환된 결과는 다음과 같습니다.18

lastIndexOf('hello world hello world', 'world')

이 예제에서는 부분 문자열 매개 변수가 누락되었으며 입력 문자열(23)의 22 값에서 1을 뺀 값이 0보다 크므로 값을 반환합니다.

lastIndexOf('hello world hello world', '')

length

컬렉션의 항목 수를 반환합니다.

length('<collection>')
length([<collection>])

매개 변수	필수	Type	설명
<컬렉션>	예	문자열 또는 배열	개수를 셀 항목을 포함하는 컬렉션

반환 값	Type	설명
<length-or-count>	정수	컬렉션의 항목 수입니다.

예제

아래 예제는 이러한 컬렉션의 항목 수를 셉니다.

length('abcd')
length(createArray(0, 1, 2, 3))

그리고 다음 결과를 반환합니다. 4

less

첫 번째 값이 두 번째 값보다 작은지 검사합니다. 첫 번째 값이 두 번째 값보다 작으면 true를 반환하거나 첫 번째 값이 더 크면 false를 반환합니다.

less(<value>, <compareTo>)
less('<value>', '<compareTo>')

매개 변수	필수	Type	설명
<value>	예	정수, 부동 소수점 수 또는 문자열	두 번째 값보다 작은지 검사할 첫 번째 값
<compareTo>	예	각각 정수, 부동 소수점 수 또는 문자열	비교 항목

반환 값	Type	설명
true 또는 false	부울	첫 번째 값이 두 번째 값보다 작으면 true를 반환합니다. 첫 번째 값이 두 번째 값보다 크거나 같으면 false를 반환합니다.

예제

아래 예제는 첫 번째 값이 두 번째 값보다 작은지 검사합니다.

less(5, 10)
less('banana', 'apple')

그리고 다음 결과를 반환합니다.

첫 번째 예제: true
두 번째 예제: false

lessOrEquals

첫 번째 값이 두 번째 값보다 작거나 같은지 검사합니다. 첫 번째 값이 두 번째 값보다 작으면 true를 반환하거나 첫 번째 값이 더 크면 false를 반환합니다.

lessOrEquals(<value>, <compareTo>)
lessOrEquals('<value>', '<compareTo>')

매개 변수	필수	Type	설명
<value>	예	정수, 부동 소수점 수 또는 문자열	두 번째 값보다 작거나 같은지 검사할 첫 번째 값
<compareTo>	예	각각 정수, 부동 소수점 수 또는 문자열	비교 항목

반환 값	Type	설명
true 또는 false	부울	첫 번째 값이 두 번째 값보다 작거나 같으면 true를 반환합니다. 첫 번째 값이 두 번째 값보다 크면 false를 반환합니다.

예제

아래 예제는 첫 번째 값이 두 번째 값보다 작거나 같은지 검사합니다.

lessOrEquals(10, 10)
lessOrEquals('apply', 'apple')

그리고 다음 결과를 반환합니다.

첫 번째 예제: true
두 번째 예제: false

listCallbackUrl

트리거 또는 작업을 호출하는 "콜백 URL"을 반환합니다. 이 함수는 HttpWebhook 및 ApiConnectionWebhook 커넥터 형식에 대한 트리거 및 작업에서만 작동하지만 수동, 되풀이, HTTP 및 APIConnection 형식은 작동하지 않습니다.

listCallbackUrl()

반환 값	Type	설명
<callback-URL>	문자열	트리거 또는 작업에 대한 콜백 URL

예제

이 예제는 이 함수가 반환할 수 있는 샘플 콜백 URL을 보여 줍니다.

"https://prod-01.westus.logic.azure.com:443/workflows/<*workflow-ID*>/triggers/manual/run?api-version=2016-10-01&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=<*signature-ID*>"

M

max

양끝이 포함된 숫자를 가진 목록 또는 배열에서 가장 높은 값을 반환합니다.

max(<number1>, <number2>, ...)
max([<number1>, <number2>, ...])

매개 변수	필수	Type	설명
<number1>, <number2>, ...	예	정수, 부동 소수점 수 또는 둘 다	가장 높은 값을 원하는 숫자의 집합
[<number1>, <number2>, ...]	예	배열 - 정수, 부동 소수점 수 또는 둘 다	가장 높은 값을 원하는 숫자의 배열

반환 값	Type	설명
<max-value>	정수 또는 부동 소수점 수	지정한 배열 또는 숫자 집합의 가장 높은 값

예제

아래 예제는 숫자 집합 및 배열에서 가장 높은 값을 가져옵니다.

max(1, 2, 3)
max(createArray(1, 2, 3))

그리고 다음 결과를 반환합니다. 3

min

숫자 또는 배열 집합에서 가장 낮은 값을 반환합니다.

min(<number1>, <number2>, ...)
min([<number1>, <number2>, ...])

매개 변수	필수	Type	설명
<number1>, <number2>, ...	예	정수, 부동 소수점 수 또는 둘 다	가장 낮은 값을 원하는 숫자의 집합
[<number1>, <number2>, ...]	예	배열 - 정수, 부동 소수점 수 또는 둘 다	가장 낮은 값을 원하는 숫자의 배열

반환 값	Type	설명
<min-value>	정수 또는 부동 소수점 수	지정한 숫자 집합 또는 지정한 배열의 가장 낮은 값

예제

아래 예제는 숫자 집합 및 배열에서 가장 낮은 값을 가져옵니다.

min(1, 2, 3)
min(createArray(1, 2, 3))

그리고 다음 결과를 반환합니다. 1

mod

두 숫자를 나눈 나머지를 반환합니다. 정수 결과를 가져오는 방법은 div()를 참조하세요.

mod(<dividend>, <divisor>)

매개 변수	필수	Type	설명
<dividend>	예	정수 또는 부동 소수점 수	제수로 나눌 숫자
<divisor>	예	정수 또는 부동 소수점 수	피제수를 분할하는 숫자이지만 0일 수는 없습니다.

반환 값	Type	설명
<modulo-result>	정수 또는 부동 소수점 수	첫 번째 숫자를 두 번째 숫자로 나눈 나머지

예제 1

이 예제는 첫 번째 숫자를 두 번째 숫자로 나눕니다.

mod(3, 2)

그리고 다음 결과를 반환합니다. 1

예제 2

이 예제는 한 개 또는 두 개의 값이 모두 음수이면 결과가 피제수 부호와 일치함을 보여 줍니다.

mod(-5, 2)
mod(4, -3)

이 예제에서는 다음 결과를 반환합니다.

첫 번째 예제: -1
두 번째 예제: 1

mul

두 숫자를 곱한 결과를 반환합니다.

mul(<multiplicand1>, <multiplicand2>)

매개 변수	필수	Type	설명
<multiplicand1>	예	정수 또는 부동 소수점 수	multiplicand2로 곱할 숫자
<multiplicand2>	예	정수 또는 부동 소수점 수	multiplicand1를 곱하는 숫자

반환 값	Type	설명
<product-result>	정수 또는 부동 소수점 수	첫 번째 숫자를 두 번째 숫자로 곱한 결과

예제

아래 예제는 첫 번째 숫자를 두 번째 숫자로 곱합니다.

mul(1, 2)
mul(1.5, 2)

그리고 다음 결과를 반환합니다.

첫 번째 예제: 2
두 번째 예제 3

multipartBody

여러 부분이 있는 작업 출력의 특정 부분에 대한 본문을 반환합니다.

multipartBody('<actionName>', <index>)

매개 변수	필수	Type	설명
<actionName>	예	문자열	여러 부분으로 출력되는 작업의 이름입니다.
<인덱스>	예	정수	원하는 파트의 인덱스 값입니다.

반환 값	Type	설명
<body>	문자열	지정된 부분의 본문입니다.

N

not

식이 false인지 검사합니다. 식이 false이면 true를 반환하거나 true이면 false를 반환합니다.

not(<expression>)

매개 변수	필수	Type	설명
<expression>	예	부울	검사할 식

반환 값	Type	설명
true 또는 false	부울	식이 false이면 true를 반환합니다. 식이 true이면 false를 반환합니다.

예제 1

아래 예제는 지정한 식이 모두 false인지 검사합니다.

not(false)
not(true)

그리고 다음 결과를 반환합니다.

첫 번째 예제: 식이 false이므로 함수는 true를 반환합니다.
두 번째 예제: 식이 true이므로 함수는 false를 반환합니다.

예제 2

아래 예제는 지정한 식이 모두 false인지 검사합니다.

not(equals(1, 2))
not(equals(1, 1))

그리고 다음 결과를 반환합니다.

첫 번째 예제: 식이 false이므로 함수는 true를 반환합니다.
두 번째 예제: 식이 true이므로 함수는 false를 반환합니다.

nthIndexOf

문자열에서 substring의 n번째 발생이 나타나는 시작 위치 또는 인덱스 값을 반환합니다.

nthIndexOf('<text>', '<searchText>', <occurrence>)

매개 변수	필수	Type	설명
<text>	예	문자열	찾을 substring이 포함된 문자열입니다.
<searchText>	예	문자열	찾을 하위 문자열
<occurrence>	예	정수	찾을 substring의 n번째 발생을 지정하는 숫자입니다. 발생 빈도가 음수이면 끝에서 검색을 시작합니다.

반환 값	Type	설명
<index-value>	정수	지정된 substring의 n번째 발생에 대한 시작 위치 또는 인덱스 값입니다. substring을 찾을 수 없거나 substring이 n개 미만으로 반생하면 `-1`을 반환합니다.

예제

nthIndexOf('123456789123465789', '1', 1) // Returns `0`.
nthIndexOf('123456789123465789', '1', 2) // Returns `9`.
nthIndexOf('123456789123465789', '12', 2) // Returns `9`.
nthIndexOf('123456789123465789', '6', 4) // Returns `-1`.

O

또는

최소 하나의 식이 true인지 검사합니다. 최소 하나의 식이 true이면 true를 반환하거나 모든 식이 false이면 false를 반환합니다.

or(<expression1>, <expression2>, ...)

매개 변수	필수	Type	설명
<expression1>, <expression2>, ...	예	부울	검사할 식

반환 값	Type	설명
true 또는 false	부울	최소 하나의 식이 true이면 true를 반환합니다. 모든 식이 false이면 false를 반환합니다.

예제 1

아래 예제는 최소 하나의 식이 true인지 검사합니다.

or(true, false)
or(false, false)

그리고 다음 결과를 반환합니다.

첫 번째 예제: 최소 하나의 식이 true이므로 함수는 true를 반환합니다.
두 번째 예제: 두 식이 모두 false이므로 함수는 false를 반환합니다.

예제 2

아래 예제는 최소 하나의 식이 true인지 검사합니다.

or(equals(1, 1), equals(1, 2))
or(equals(1, 2), equals(1, 3))

그리고 다음 결과를 반환합니다.

첫 번째 예제: 최소 하나의 식이 true이므로 함수는 true를 반환합니다.
두 번째 예제: 두 식이 모두 false이므로 함수는 false를 반환합니다.

outputs

런타임에 작업의 출력을 반환합니다.

outputs('<actionName>')

매개 변수	필수	Type	설명
<actionName>	예	문자열	원하는 작업 출력의 이름입니다.

반환 값	Type	설명
<출력>	문자열	지정한 작업의 출력

예제

이 예제는 X 작업 Get user에서 출력을 가져옵니다.

outputs('Get_user')

그리고 다음 결과를 반환합니다.

{
  "statusCode": 200,
  "headers": {
    "Pragma": "no-cache",
    "Vary": "Accept-Encoding",
    "x-ms-request-id": "a916ec8f52211265d98159adde2efe0b",
    "X-Content-Type-Options": "nosniff",
    "Timing-Allow-Origin": "*",
    "Cache-Control": "no-cache",
    "Date": "Mon, 09 Apr 2018 18:47:12 GMT",
    "Set-Cookie": "ARRAffinity=b9400932367ab5e3b6802e3d6158afffb12fcde8666715f5a5fbd4142d0f0b7d;Path=/;HttpOnly;Domain=twitter-wus.azconn-wus.p.azurewebsites.net",
    "X-AspNet-Version": "4.0.30319",
    "X-Powered-By": "ASP.NET",
    "Content-Type": "application/json; charset=utf-8",
    "Expires": "-1",
    "Content-Length": "339"
  },
  "body": {
    "FullName": "Contoso Corporation",
    "Location": "Generic Town, USA",
    "Id": 283541717,
    "UserName": "ContosoInc",
    "FollowersCount": 172,
    "Description": "Leading the way in transforming the digital workplace.",
    "StatusesCount": 93,
    "FriendsCount": 126,
    "FavouritesCount": 46,
    "ProfileImageUrl": "https://pbs.twimg.com/profile_images/908820389907722240/gG9zaHcd_400x400.jpg"
  }
}

P

매개 변수

워크플로 정의에 설명된 매개 변수의 값을 반환합니다.

parameters('<parameterName>')

매개 변수	필수	Type	설명
<parameterName>	예	문자열	값을 원하는 매개 변수의 이름입니다.

반환 값	Type	설명
<parameter-value>	모두	지정한 매개 변수의 값

예제

이 JSON 값이 있다고 가정합니다.

{
  "fullName": "Sophia Owen"
}

이 예제는 지정한 매개 변수의 값을 가져옵니다.

parameters('fullName')

그리고 다음 결과를 반환합니다. "Sophia Owen"

parseDateTime

타임스탬프가 포함된 문자열에서 타임스탬프를 반환합니다.

parseDateTime('<timestamp>', '<locale>'?, '<format>'?)

매개 변수	필수	Type	설명
<timestamp>	예	문자열	타임스탬프를 포함하는 문자열
<로캘>	아니요	문자열	사용할 로캘입니다. 지정하지 않으면 기본 로캘은 `en-us`입니다. 로캘이 유효한 값이 아니면 오류가 생성됩니다.
<format>	아니요	문자열	단일 형식 지정자 또는 사용자 지정 형식 패턴인 숫자 서식 문자열입니다. 타임스탬프의 기본 형식은 "o"(yyyy-MM-ddTHH:mm:ss.fffffffK)입니다. 이 형식은 ISO 8601을 준수하며 표준 시간대 정보를 보존합니다. 형식이 지정되지 않은 경우 제공된 로캘과 호환되는 여러 형식으로 구문 분석을 시도합니다. 형식이 유효한 값이 아니면 오류가 생성됩니다.

반환 값	Type	설명
<parsed-timestamp>	문자열	"o"(yyyy-MM-ddTHH:mm:ss.fffffffK) 형식으로 구문 분석된 타임스탬프로, 이는 ISO 8601을 준수하며 표준 시간대 정보를 보존합니다.

예제

parseDateTime('20/10/2014', 'fr-fr') // Returns '2014-10-20T00:00:00.0000000'.
parseDateTime('20 octobre 2010', 'fr-FR') // Returns '2010-10-20T00:00:00.0000000'.
parseDateTime('martes 20 octubre 2020', 'es-es') // Returns '2020-10-20T00:00:00.0000000'.
parseDateTime('21052019', 'fr-fr', 'ddMMyyyy') // Returns '2019-05-21T00:00:00.0000000'.
parseDateTime('10/20/2014 15h', 'en-US', 'MM/dd/yyyy HH\h') // Returns '2014-10-20T15:00:00.0000000'.

R

rand

시작 끝만 포함하는 지정한 범위에서 임의의 정수를 반환합니다.

rand(<minValue>, <maxValue>)

매개 변수	필수	Type	설명
<minValue>	예	정수	범위의 가장 작은 정수
<maxValue>	예	정수	함수가 반환할 수 있는 범위에서 가장 높은 정수 다음에 오는 정수

반환 값	Type	설명
<random-result>	정수	지정한 범위에서 반환된 임의의 정수

예제

이 예제는 최댓값을 제외하고 지정한 범위에서 임의의 정수를 가져옵니다.

rand(1, 5)

그리고 다음 숫자 중 하나를 결과로 반환합니다. 1, 2, 3 또는 4

range

지정한 정수에서 시작하는 정수 배열을 반환합니다.

range(<startIndex>, <count>)

매개 변수	필수	Type	설명
<startIndex>	예	정수	배열을 첫 번째 항목으로 시작하는 정수 값
<count>	예	정수	배열에 있는 정수의 수입니다. 매개 변수 값은 `count` 100,000을 초과하지 않는 양의 정수여야 합니다. 참고: `startIndex` 값과 `count` 값의 합계는 2,147,483,647을 초과하면 안 됩니다.

반환 값	Type	설명
[<range-result>]	배열	지정한 인덱스에서 시작하는 정수를 포함하는 배열

예제

이 예제는 지정한 인덱스에서 시작하고 지정한 수의 정수를 가진 정수 배열을 만듭니다.

range(1, 4)

그리고 다음 결과를 반환합니다. [1, 2, 3, 4]

removeProperty

개체에서 속성을 제거하고 업데이트된 개체를 반환합니다. 제거하려는 속성이 없으면 함수가 원래 개체를 반환합니다.

removeProperty(<object>, '<property>')

매개 변수	필수	Type	설명
<object>	예	Object	속성을 제거할 JSON 개체
<속성>	예	문자열	제거할 속성의 이름

반환 값	Type	설명
<updated-object>	Object	지정된 속성이 없는 업데이트된 JSON 개체

기존 속성에서 자식 속성을 제거하려면 다음 구문을 사용합니다.

removeProperty(<object>['<parent-property>'], '<child-property>')

매개 변수	필수	Type	설명
<object>	예	Object	속성을 제거하려는 JSON 개체
<parent-property>	예	문자열	자식 속성을 제거하려는 부모 속성의 이름
<child-property>	예	문자열	제거할 자식 속성의 이름입니다.

반환 값	Type	설명
<updated-object>	Object	자식 속성을 제거한 업데이트된 JSON 개체

예제 1

다음은 JSON() 함수를 middleName 사용하여 문자열에서 JSON으로 변환되는 JSON 개체에서 속성을 제거하고 업데이트된 개체를 반환하는 예제입니다.

removeProperty(json('{ "firstName": "Sophia", "middleName": "Anne", "surName": "Owen" }'), 'middleName')

현재 JSON 개체는 다음과 같습니다.

{
   "firstName": "Sophia",
   "middleName": "Anne",
   "surName": "Owen"
}

다음은 업데이트된 JSON 개체입니다.

{
   "firstName": "Sophia",
   "surName": "Owen"
}

예제 2

다음은 JSON() 함수를 middleName 사용하여 문자열에서 customerName JSON으로 변환되는 JSON 개체의 부모 속성에서 자식 속성을 제거하고 업데이트된 개체를 반환하는 예제입니다.

removeProperty(json('{ "customerName": { "firstName": "Sophia", "middleName": "Anne", "surName": "Owen" } }')['customerName'], 'middleName')

현재 JSON 개체는 다음과 같습니다.

{
   "customerName": {
      "firstName": "Sophia",
      "middleName": "Anne",
      "surName": "Owen"
   }
}

다음은 업데이트된 JSON 개체입니다.

{
   "customerName": {
      "firstName": "Sophia",
      "surName": "Owen"
   }
}

replace

하위 문자열을 지정한 문자열로 바꾸고 결과 문자열을 반환합니다. 이 함수는 대/소문자를 구분합니다.

replace('<text>', '<oldText>', '<newText>')

매개 변수	필수	Type	설명
<text>	예	문자열	바꿀 하위 문자열을 가진 문자열
<oldText>	예	문자열	바꿀 하위 문자열
<newText>	예	문자열	대체 문자열

반환 값	Type	설명
<updated-text>	문자열	하위 문자열을 바꾼 후 업데이트된 문자열 substring이 발견되지 않으면 원래 문자열을 반환합니다.

예제

이 예제는 "the old string"의 "old" 하위 문자열을 찾고 "old"를 "new"로 바꿉니다.

replace('the old string', 'old', 'new')

그리고 다음 결과를 반환합니다. "the new string"

result

지정된 범위가 지정된 작업(예: For_eachUntil, 또는 Scope 작업)의 최상위 작업에서 결과를 반환합니다. 이 함수는 result() 범위의 이름인 단일 매개 변수를 허용하고 해당 범위의 첫 번째 수준 작업의 정보를 포함하는 배열을 반환합니다. 이러한 작업 개체는 actions() 함수로 인하여 반환된 해당 작업의 시작 시간, 종료 시간, 상태, 입력, 상관 관계 ID, 출력 등의 특성을 포함합니다.

참고 항목

이 함수는 범위가 지정된 작업의 첫 번째 수준 작업에서만 정보를 반환하고 스위치 또는 조건 작업과 같은 더 깊은 중첩된 작업에서 정보를 반환하지 않습니다.

예를 들어 이 함수를 사용하여 실패한 작업의 결과를 가져와서 예외를 진단하고 처리할 수 있습니다. 자세한 내용은 오류에 대한 컨텍스트 및 결과 가져오기를 참조 하세요.

result('<scopedActionName>')

매개 변수	필수	Type	설명
<scopedActionName>	예	문자열	범위 내 최상위 작업의 입력 및 출력을 원하는 범위가 지정된 작업의 이름입니다.

반환 값	Type	설명
<array-object>	Array 개체	지정된 범위 내에서 각 최상위 작업의 입력 및 출력 배열을 포함하는 배열

예제

이 예제에서는 작업의 함수를 사용하여 result() 루프에 있는 HTTP 작업의 각 반복에서 For_each 입력 및 출력을 Compose 반환합니다.

{
   "actions": {
      "Compose": {
         "inputs": "@result('For_each')",
         "runAfter": {
            "For_each": [
               "Succeeded"
            ]
         },
         "type": "compose"
      },
      "For_each": {
         "actions": {
            "HTTP": {
               "inputs": {
                  "method": "GET",
                  "uri": "https://httpstat.us/200"
               },
               "runAfter": {},
               "type": "Http"
            }
         },
         "foreach": "@triggerBody()",
         "runAfter": {},
         "type": "Foreach"
      }
   }
}

다음은 반환된 배열 예제에서 외부 outputs 개체가 작업 내 For_each 의 각 작업 반복에서 입력 및 출력을 포함하는 위치를 확인할 수 있는 방법입니다.

[
   {
      "name": "HTTP",
      "outputs": [
         {
            "name": "HTTP",
            "inputs": {
               "uri": "https://httpstat.us/200",
               "method": "GET"
            },
            "outputs": {
               "statusCode": 200,
               "headers": {
                   "X-AspNetMvc-Version": "5.1",
                   "Access-Control-Allow-Origin": "*",
                   "Cache-Control": "private",
                   "Date": "Tue, 20 Aug 2019 22:15:37 GMT",
                   "Set-Cookie": "ARRAffinity=0285cfbea9f2ee7",
                   "Server": "Microsoft-IIS/10.0",
                   "X-AspNet-Version": "4.0.30319",
                   "X-Powered-By": "ASP.NET",
                   "Content-Length": "0"
               },
               "startTime": "2019-08-20T22:15:37.6919631Z",
               "endTime": "2019-08-20T22:15:37.95762Z",
               "trackingId": "6bad3015-0444-4ccd-a971-cbb0c99a7.....",
               "clientTrackingId": "085863526764.....",
               "code": "OK",
               "status": "Succeeded"
            }
         },
         {
            "name": "HTTP",
            "inputs": {
               "uri": "https://httpstat.us/200",
               "method": "GET"
            },
            "outputs": {
            "statusCode": 200,
               "headers": {
                   "X-AspNetMvc-Version": "5.1",
                   "Access-Control-Allow-Origin": "*",
                   "Cache-Control": "private",
                   "Date": "Tue, 20 Aug 2019 22:15:37 GMT",
                   "Set-Cookie": "ARRAffinity=0285cfbea9f2ee7",
                   "Server": "Microsoft-IIS/10.0",
                   "X-AspNet-Version": "4.0.30319",
                   "X-Powered-By": "ASP.NET",
                   "Content-Length": "0"
               },
               "startTime": "2019-08-20T22:15:37.6919631Z",
               "endTime": "2019-08-20T22:15:37.95762Z",
               "trackingId": "9987e889-981b-41c5-aa27-f3e0e59bf69.....",
               "clientTrackingId": "085863526764.....",
               "code": "OK",
               "status": "Succeeded"
            }
         }
      ]
   }
]

reverse

컬렉션에 있는 항목의 순서를 역방향으로 표시합니다. sort()와 함께 이 함수를 사용하는 경우 컬렉션을 내림차순으로 정렬할 수 있습니다.

reverse([<collection>])

매개 변수	필수	Type	설명
<컬렉션>	예	배열	역방향으로 표시할 컬렉션

반환 값	Type	설명
[<updated-collection>]	배열	역방향 컬렉션

예제

다음 예제에서는 정수 배열을 역방향으로 표시합니다.

reverse(createArray(0, 1, 2, 3))

그리고 [3,2,1,0] 배열을 반환합니다.

S

setProperty

JSON 개체의 속성 값을 설정하고 업데이트된 개체를 반환합니다. 설정하려는 속성이 없으면 개체에 속성이 추가됩니다. 새 속성을 추가하려면 addProperty() 함수를 사용합니다.

setProperty(<object>, '<property>', <value>)

매개 변수	필수	Type	설명
<object>	예	Object	설정할 속성이 있는 JSON 개체입니다.
<속성>	예	문자열	설정할 기존 또는 새 속성의 이름입니다.
<value>	예	모두	지정된 속성에 대해 설정할 값입니다.

자식 개체에서 자식 속성을 설정하려면 대신 중첩된 호출을 setProperty() 사용합니다. 그렇지 않으면 함수는 자식 개체만 출력으로 반환합니다.

setProperty(<object>, '<parent-property>', setProperty(<object>['parentProperty'], '<child-property>', <value>))

매개 변수	필수	Type	설명
<object>	예	Object	설정할 속성이 있는 JSON 개체입니다.
<parent-property>	예	문자열	설정할 자식 속성이 있는 부모 속성의 이름입니다.
<child-property>	예	문자열	설정할 자식 속성의 이름입니다.
<value>	예	모두	지정된 속성에 대해 설정할 값입니다.

반환 값	Type	설명
<updated-object>	Object	설정한 속성이 있는 업데이트된 JSON 개체

예제 1

이 예제에서는 JSON 개체의 surName 속성을 설정합니다. 이 속성은 JSON() 함수를 사용하여 문자열에서 JSON으로 변환됩니다. 함수는 지정된 값을 속성에 할당하고 업데이트된 개체를 반환합니다.

setProperty(json('{ "firstName": "Sophia", "surName": "Owen" }'), 'surName', 'Hartnett')

현재 JSON 개체는 다음과 같습니다.

{
   "firstName": "Sophia",
   "surName": "Owen"
}

다음은 업데이트된 JSON 개체입니다.

{
   "firstName": "Sophia",
   "surName": "Hartnett"
}

예제 2

다음은 JSON() 함수를 사용하여 문자열에서 JSON으로 변환되는 JSON 개체의 부모 속성에 대한 customerName 자식 속성을 설정하는 surName 예제입니다. 함수는 지정된 값을 속성에 할당하고 업데이트된 개체를 반환합니다.

setProperty(json('{ "customerName": { "firstName": "Sophia", "surName": "Owen" } }'), 'customerName', setProperty(json('{ "customerName": { "firstName": "Sophia", "surName": "Owen" } }')['customerName'], 'surName', 'Hartnett'))

현재 JSON 개체는 다음과 같습니다.

{
   "customerName": {
      "firstName": "Sophie",
      "surName": "Owen"
   }
}

다음은 업데이트된 JSON 개체입니다.

{
   "customerName": {
      "firstName": "Sophie",
      "surName": "Hartnett"
   }
}

skip

컬렉션 앞의 항목을 제거하고 다른 모든 항목을 반환합니다.

skip([<collection>], <count>)

매개 변수	필수	Type	설명
<컬렉션>	예	배열	해당 항목을 제거할 컬렉션
<count>	예	정수	앞에서 제거할 항목 수에 대한 양수 정수

반환 값	Type	설명
[<updated-collection>]	배열	지정한 항목을 제거한 후 업데이트된 컬렉션

예제

이 예제는 지정한 배열 앞에서 항목 한 개, 숫자 0을 제거합니다.

skip(createArray(0, 1, 2, 3), 1)

그리고 남은 항목을 포함하는 다음 배열을 반환합니다. [1,2,3]

slice

시작/끝 위치나 값을 지정하여 substring을 반환합니다. substring()도 참조하세요.

slice('<text>', <startIndex>, <endIndex>?)

매개 변수	필수	Type	설명
<text>	예	문자열	찾을 substring이 포함된 문자열입니다.
<startIndex>	예	정수	부분 문자열 검색을 시작할 위치에 대한 0부터 시작하는 위치 또는 값입니다. - startIndex가 문자열 길이보다 크면 빈 문자열을 반환합니다. - startIndex가 음수이면 문자열 길이와 startIndex의 합계인 인덱스 값에서 검색을 시작합니다.
<endIndex>	아니요	정수	substring 검색을 종료할, 종료 위치 또는 값(0부터 시작)입니다. 종료 인덱스 값에 있는 문자는 검색에 포함되지 않습니다. - endIndex가 지정되지 않았거나 문자열 길이보다 크면 문자열의 끝 부분까지 검색합니다. - endIndex가 음수이면 문자열 길이와 endIndex의 합계인 인덱스 값에서 검색을 종료합니다.

반환 값	Type	설명
<slice-result>	문자열	찾은 substring을 포함하는 새 문자열입니다.

예제

slice('Hello World', 2) // Returns 'llo World'.
slice('Hello World', 30) // Returns ''.
slice('Hello World', 10, 2) // Returns ''.
slice('Hello World', 0) // Returns 'Hello World'.
slice('Hello World', 2, 5) // Returns 'llo'.
slice('Hello World', 6, 20) // Returns 'World'.
slice('Hello World', -2) // Returns 'ld'.
slice('Hello World', 3, -1) // Returns 'lo Worl'.
slice('Hello World', 3, 3) // Returns ''.

sort

컬렉션의 항목을 정렬합니다. 단순 형식이 포함된 키를 사용하여 컬렉션 개체를 정렬할 수 있습니다.

sort([<collection>], <sortBy>?)

매개 변수	필수	Type	설명
<컬렉션>	예	배열	정렬할 항목을 포함하는 컬렉션
<sortBy>	아니요	문자열	컬렉션 개체를 정렬하는 데 사용할 키

반환 값	Type	설명
[<updated-collection>]	배열	정렬된 컬렉션

예제 1

다음 예제에서는 정수 배열을 정렬합니다.

sort(createArray(2, 1, 0, 3))

그리고 [0,1,2,3] 배열을 반환합니다.

예제 2

다음 예제에서는 키별로 개체 배열을 정렬합니다.

sort(createArray(json('{ "first": "Amalie", "last": "Rose" }'), json('{ "first": "Elise", "last": "Renee" }')), 'last')

그리고 [{ "first": "Elise", "last": "Renee" }, {"first": "Amalie", "last": "Rose" }')] 배열을 반환합니다.

split

원래 스트링에 지정된 구분 기호 문자를 기준으로 하여 하위 스트링을 포함하는 배열(쉼표로 구분됨)을 반환합니다.

split('<text>', '<delimiter>')

매개 변수	필수	Type	설명
<text>	예	문자열	원본 스트링에서 지정된 구분 기호를 기준으로 하위 스트링로 구분할 스트링입니다.
<delimiter>	예	문자열	구분 기호로 사용할 원래 문자열의 문자입니다.

반환 값	Type	설명
[<substring1>,<substring2>,...]	배열	쉼표로 구분된 원본 스트링의 하위 스트링을 포함하는 배열

예제 1

이 예제에서는 지정된 문자(구분 기호)를 기준으로 하여 지정한 문자열의 하위 문자열이 포함된 배열을 만듭니다.

split('a_b_c', '_')

그리고 결과로 ["a","b","c"] 배열을 반환합니다.

예제 2

이 예제에서는 문자열에 구분 기호가 없는 경우 단일 요소를 사용하여 배열을 만듭니다.

split('a_b_c', ' ')

그리고 결과로 ["a_b_c"] 배열을 반환합니다.

startOfDay

타임스탬프에 대한 날의 시작을 반환합니다.

startOfDay('<timestamp>', '<format>'?)

매개 변수	필수	Type	설명
<timestamp>	예	문자열	타임스탬프를 포함하는 문자열
<format>	아니요	문자열	단일 형식 지정자 또는 사용자 지정 형식 패턴인 숫자 서식 문자열입니다. 타임스탬프의 기본 형식은 "o"(yyyy-MM-ddTHH:mm:ss.fffffffK)입니다. 이 형식은 ISO 8601을 준수하며 표준 시간대 정보를 보존합니다. 형식이 유효한 값이 아니면 오류가 생성됩니다.

반환 값	Type	설명
<updated-timestamp>	문자열	지정한 타임스탬프이지만 해당 날짜의 0시 마크에서 시작

예제

이 예제는 이 타임스탬프에 대한 날의 시작을 찾습니다.

startOfDay('2018-03-15T13:30:30Z')

그리고 다음 결과를 반환합니다. "2018-03-15T00:00:00.0000000Z"

startOfHour

타임스탬프에 대한 시간의 시작을 반환합니다.

startOfHour('<timestamp>', '<format>'?)

매개 변수	필수	Type	설명
<timestamp>	예	문자열	타임스탬프를 포함하는 문자열
<format>	아니요	문자열	단일 형식 지정자 또는 사용자 지정 형식 패턴인 숫자 서식 문자열입니다. 타임스탬프의 기본 형식은 "o"(yyyy-MM-ddTHH:mm:ss.fffffffK)입니다. 이 형식은 ISO 8601을 준수하며 표준 시간대 정보를 보존합니다. 형식이 유효한 값이 아니면 오류가 생성됩니다.

반환 값	Type	설명
<updated-timestamp>	문자열	지정한 타임스탬프이지만 시에 대한 0분 마크에서 시작

예제

이 예제는 이 타임스탬프에 대한 시의 시작을 찾습니다.

startOfHour('2018-03-15T13:30:30Z')

그리고 다음 결과를 반환합니다. "2018-03-15T13:00:00.0000000Z"

startOfMonth

타임스탬프에 대한 월의 시작을 반환합니다.

startOfMonth('<timestamp>', '<format>'?)

매개 변수	필수	Type	설명
<timestamp>	예	문자열	타임스탬프를 포함하는 문자열
<format>	아니요	문자열	단일 형식 지정자 또는 사용자 지정 형식 패턴인 숫자 서식 문자열입니다. 타임스탬프의 기본 형식은 "o"(yyyy-MM-ddTHH:mm:ss.fffffffK)입니다. 이 형식은 ISO 8601을 준수하며 표준 시간대 정보를 보존합니다. 형식이 유효한 값이 아니면 오류가 생성됩니다.

반환 값	Type	설명
<updated-timestamp>	문자열	지정한 타임스탬프이지만 0시 마크에 있는 월의 첫 번째 날에 시작

예제 1

이 예제는 이 타임스탬프에 대한 월의 시작을 반환합니다.

startOfMonth('2018-03-15T13:30:30Z')

그리고 다음 결과를 반환합니다. "2018-03-01T00:00:00.0000000Z"

예제 2

이 예제에서는 이 타임스탬프에 대해 지정된 형식으로 월의 시작을 반환합니다.

startOfMonth('2018-03-15T13:30:30Z', 'yyyy-MM-dd')

그리고 다음 결과를 반환합니다. "2018-03-01"

startsWith

문자열이 특정 하위 문자열로 시작하는지 검사합니다. 하위 문자열이 발견되면 true를 반환하거나 발견되지 않으면 false를 반환합니다. 이 함수는 대/소문자를 구분하지 않습니다.

startsWith('<text>', '<searchText>')

매개 변수	필수	Type	설명
<text>	예	문자열	검사할 문자열
<searchText>	예	문자열	찾을 시작 문자열

반환 값	Type	설명
true 또는 false	부울	시작 하위 문자열이 발견되면 true를 반환합니다. 발견되지 않으면 false를 반환합니다.

예제 1

이 예제는 "hello world" 문자열이 "hello" 하위 문자열로 시작하는지 검사합니다.

startsWith('hello world', 'hello')

그리고 다음 결과를 반환합니다. true

예제 2

이 예제는 "hello world" 문자열이 "greetings" 하위 문자열로 시작하는지 검사합니다.

startsWith('hello world', 'greetings')

그리고 다음 결과를 반환합니다. false

string

값에 대한 문자열 버전을 반환합니다.

string(<value>)

매개 변수	필수	Type	설명
<value>	예	모두	변환할 값입니다. 이 값이 null이거나 null로 계산되면 값이 빈 문자열(`""`) 값으로 변환됩니다. 예를 들어 연산자를 사용하여 액세스할 수 있는 존재하지 않는 속성에 문자열 변수를 `?` 할당하면 null 값이 빈 문자열로 변환됩니다. 그러나 null 값을 비교하는 것은 빈 문자열을 비교하는 것과 다릅니다.

반환 값	Type	설명
<string-value>	문자열	지정된 값의 문자열 버전입니다. 값 매개 변수가 null이거나 null로 평가되면 이 값은 빈 문자열(`""`) 값으로 반환됩니다.

예제 1

이 예제는 이 숫자에 대한 문자열 버전을 만듭니다.

string(10)

그리고 다음 결과를 반환합니다. "10"

예제 2

이 예제는 지정한 JSON 개체에 대한 문자열을 만들고 백슬래시 문자(\)를 따옴표(")에 대한 이스케이프 문자로 사용합니다.

string( { "name": "Sophie Owen" } )

그리고 다음 결과를 반환합니다. "{ \\"name\\": \\"Sophie Owen\\" }"

sub

첫 번째 숫자에서 두 번째 숫자를 뺀 결과를 반환합니다.

sub(<minuend>, <subtrahend>)

매개 변수	필수	Type	설명
<minuend>	예	정수 또는 부동 소수점 수	감수를 뺄 수
<subtrahend>	예	정수 또는 부동 소수점 수	피감수에서 뺄 수

반환 값	Type	Description
<result>	정수 또는 부동 소수점 수	첫 번째 숫자에서 두 번째 숫자를 뺀 결과

예제

이 예제는 첫 번째 숫자에서 두 번째 숫자를 뺍니다.

sub(10.3, .3)

그리고 다음 결과를 반환합니다. 10

substring

지정한 위치 또는 인덱스에서 시작하여 문자열에서 문자를 반환합니다. 인덱스 값은 숫자 0으로 시작합니다. slice()도 참조하세요.

substring('<text>', <startIndex>, <length>)

매개 변수	필수	Type	설명
<text>	예	문자열	해당 문자를 원하는 문자열
<startIndex>	예	정수	시작 위치 또는 인덱스 값으로 사용하려는 0 이상의 양수
<length>	아니요	정수	하위 문자열에 원하는 문자의 양수

참고 항목

startIndex 및 길이 매개 변수 값을 추가하는 합계가 텍스트 매개 변수에 제공하는 문자열의 길이보다 작은지 확인합니다. 그렇지 않으면 결과가 startIndex에서 문자열의 끝까지 부분 문자열인 다른 언어의 유사한 함수와 달리 오류가 발생합니다. length 매개 변수는 선택 사항이며 제공되지 않은 경우 substring() 함수는 startIndex부터 문자열 끝까지 모든 문자를 사용합니다.

반환 값	Type	설명
<substring-result>	문자열	원본 문자열의 지정한 인덱스 위치에서 시작하는 지정한 수의 문자를 포함하는 하위 문자열

예제

이 예제는 인덱스 값 6에서 시작하여 지정한 문자열에서 문자 하위 문자열 5개를 만듭니다.

substring('hello world', 6, 5)

그리고 다음 결과를 반환합니다. "world"

subtractFromTime

타임스탬프에서 시간 단위 수를 뺍니다. getPastTime도 함께 참조하세요.

subtractFromTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?)

매개 변수	필수	Type	설명
<timestamp>	예	문자열	타임스탬프를 포함하는 문자열
<interval>	예	정수	뺄 지정한 시간 단위 수
<timeUnit>	예	문자열	interval과 함께 사용할 시간 단위: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
<format>	아니요	문자열	단일 형식 지정자 또는 사용자 지정 형식 패턴인 숫자 서식 문자열입니다. 타임스탬프의 기본 형식은 "o"(yyyy-MM-ddTHH:mm:ss.fffffffK)입니다. 이 형식은 ISO 8601을 준수하며 표준 시간대 정보를 보존합니다. 형식이 유효한 값이 아니면 오류가 생성됩니다.

반환 값	Type	설명
<updated-timestamp>	문자열	타임스탬프 - 지정한 시간 단위 수

예제 1

이 예제는 이 타임스탬프에서 1일을 뺍니다.

subtractFromTime('2018-01-02T00:00:00Z', 1, 'Day')

그리고 다음 결과를 반환합니다. "2018-01-01T00:00:00.0000000Z"

예제 2

이 예제는 이 타임스탬프에서 1일을 뺍니다.

subtractFromTime('2018-01-02T00:00:00Z', 1, 'Day', 'D')

그리고 선택적 "D" 형식을 사용하여 다음 결과를 반환합니다. "Monday, January, 1, 2018"

T

take

컬렉션 앞에서 항목을 반환합니다.

take('<collection>', <count>)
take([<collection>], <count>)

매개 변수	필수	Type	설명
<컬렉션>	예	문자열 또는 배열	해당 항목을 원하는 컬렉션
<count>	예	정수	앞에서 제거할 항목 수에 대한 양수 정수

반환 값	Type	설명
<subset> 또는 [<subset>]	각각 문자열 또는 배열	원본 컬렉션의 앞에서 가져온 지정한 수의 항목을 포함하는 문자열 또는 배열

예제

아래 예제는 이 컬렉션의 앞에서 지정한 수의 항목을 가져옵니다.

take('abcde', 3)
take(createArray(0, 1, 2, 3, 4), 3)

그리고 다음 결과를 반환합니다.

첫 번째 예제: "abc"
두 번째 예제: [0, 1, 2]

ticks

0001년 1월 1일 12:00:00 자정(또는 C#의 DateTime.Ticks)부터 지정된 타임스탬프까지 100나노초 간격인 틱 수를 반환합니다. 자세한 내용은 다음 항목을 참조하세요. DateTime.Ticks 속성(시스템).

ticks('<timestamp>')

매개 변수	필수	Type	설명
<timestamp>	예	문자열	타임스탬프에 대한 문자열

반환 값	Type	설명
<ticks-number>	정수	지정한 타임스탬프 이후 틱 수

toLower

문자열을 소문자 형식으로 반환합니다. 문자열의 문자에 소문자 버전이 없으면 반환된 문자열에 해당 문자가 변경되지 않고 포함됩니다.

toLower('<text>')

매개 변수	필수	Type	설명
<text>	예	문자열	소문자 형식으로 반환할 문자열

반환 값	Type	설명
<lowercase-text>	문자열	소문자 형식의 원래 문자열

예제

이 예제는 이 문자열을 소문자로 변환합니다.

toLower('Hello World')

그리고 다음 결과를 반환합니다. "hello world"

toUpper

문자열을 대문자 형식으로 반환합니다. 문자열의 문자에 대문자 버전이 없으면 반환된 문자열에 해당 문자가 변경되지 않고 포함됩니다.

toUpper('<text>')

매개 변수	필수	Type	설명
<text>	예	문자열	대문자 형식으로 반환할 문자열

반환 값	Type	설명
<uppercase-text>	문자열	대문자 형식의 원래 문자열

예제

이 예제는 이 문자열을 대문자로 변환합니다.

toUpper('Hello World')

그리고 다음 결과를 반환합니다. "HELLO WORLD"

트리거

런타임에 트리거의 출력 또는 식에 할당할 수 있는 다른 JSON 이름 및 값 쌍의 값을 반환합니다.

트리거의 입력 내에서 이 함수는 이전 실행의 출력을 반환합니다.
트리거의 조건 내부에서 이 함수는 현재 실행의 출력을 반환합니다.

기본적으로 함수는 전체 트리거 개체를 참조하지만 원하는 값을 가진 속성을 선택적으로 지정할 수 있습니다. 또한 이 함수에는 사용 가능한 약식 버전이 있습니다. triggerOutputs() 및 triggerBody()를 참조하세요.

trigger()

반환 값	Type	설명
<trigger-output>	문자열	런타임 시 트리거의 출력

triggerBody

런타임에 트리거의 body 출력을 반환합니다. 의 약식입니다 trigger().outputs.body. trigger()를 참조하세요.

triggerBody()

반환 값	Type	설명
<trigger-body-output>	문자열	`body` 트리거의 출력

triggerFormDataMultiValues

트리거의 폼 데이터 또는 폼 인코딩 출력의 키 이름과 일치하는 값이 있는 배열을 반환합니다.

triggerFormDataMultiValues('<key>')

매개 변수	필수	Type	설명
<key>	예	문자열	값을 원하는 키의 이름입니다.

반환 값	Type	설명
[<array-with-key-values>]	배열	지정된 키와 일치하는 모든 값이 있는 배열

예제

이 예제에서는 RSS 트리거의 양식 데이터 또는 폼 인코딩 출력에 "feedUrl" 키 값에서 배열을 만듭니다.

triggerFormDataMultiValues('feedUrl')

그리고 예제 결과로 이 배열을 반환합니다. ["https://feeds.a.dj.com/rss/RSSMarketsMain.xml"]

triggerFormDataValue

트리거의 양식 데이터 또는 양식 인코딩된 출력의 키 이름과 일치하는 단일 값을 가진 문자열을 반환합니다. 함수가 일치하는 항목을 두 개 이상 찾으면 함수에서 오류가 발생합니다.

triggerFormDataValue('<key>')

매개 변수	필수	Type	설명
<key>	예	문자열	값을 원하는 키의 이름입니다.

반환 값	Type	설명
<키-값>	문자열	지정된 키의 값입니다.

예제

이 예제에서는 RSS 트리거의 양식 데이터 또는 폼 인코딩 출력에 "feedUrl" 키 값에서 문자열을 만듭니다.

triggerFormDataValue('feedUrl')

그리고 이 문자열을 예제 결과로 반환합니다. "https://feeds.a.dj.com/rss/RSSMarketsMain.xml"

triggerMultipartBody

여러 부분이 있는 트리거 출력의 특정 부분에 대한 본문을 반환합니다.

triggerMultipartBody(<index>)

매개 변수	필수	Type	설명
<인덱스>	예	정수	원하는 파트의 인덱스 값입니다.

반환 값	Type	설명
<body>	문자열	트리거의 다중 부분 출력에서 지정한 부분에 대한 본문

triggerOutputs

런타임에 트리거의 출력 또는 다른 JSON 이름 및 값 쌍의 값을 반환합니다. 의 약식입니다 trigger().outputs. trigger()를 참조하세요.

triggerOutputs()

반환 값	Type	설명
<trigger-output>	문자열	런타임 시 트리거의 출력

trim

문자열에서 선행 및 후행 공백을 제거하고 업데이트된 문자열을 반환합니다.

trim('<text>')

매개 변수	필수	Type	설명
<text>	예	문자열	제거할 선행 및 후행 공백이 있는 문자열

반환 값	Type	설명
<updatedText>	문자열	선행 또는 후행 공백이 없는 원래 문자열에 대한 업데이트된 버전

예제

다음 예제에서는 문자열 ‘ Hello World ’에서 선행/후행 공백을 제거합니다.

trim(' Hello World  ')

그리고 다음 결과를 반환합니다. "Hello World"

U

union

지정한 컬렉션에서 모든 항목이 있는 컬렉션을 반환합니다. 결과에 나타내기 위해 항목이 이 함수에 전달된 모든 컬렉션에 나타날 수 있습니다. 같은 이름을 가진 항목이 한 개 이상이면 해당 이름의 마지막 항목이 결과에 나타납니다.

union('<collection1>', '<collection2>', ...)
union([<collection1>], [<collection2>], ...)

매개 변수	필수	Type	설명
<collection1>, <collection2>, ...	예	배열 또는 개체, 그러나 둘 다는 아님	모든 항목을 원하는 컬렉션

반환 값	Type	설명
<updatedCollection>	각각 배열 또는 개체	지정한 컬렉션의 모든 항목을 포함하는 컬렉션 - 중복 없음

예제

이 예제는 다음 컬렉션에서 모든 항목을 가져옵니다.

union(createArray(1, 2, 3), createArray(1, 2, 10, 101))

그리고 다음 결과를 반환합니다. [1, 2, 3, 10, 101]

uriComponent

URL 안전하지 않은 문자를 이스케이프 문자로 바꾸어 문자열에 대한 URI(Uniform Resource Identifier) 인코딩된 버전을 반환합니다. encodeUriComponent() 대신에 이 함수를 사용합니다. 두 함수 모두 같은 방법으로 작동하지만 uriComponent()를 사용하는 것이 좋습니다.

uriComponent('<value>')

매개 변수	필수	Type	설명
<value>	예	문자열	URI 인코딩된 형식으로 변환할 문자열

반환 값	Type	설명
<encoded-uri>	문자열	이스케이프 문자로 URI 인코딩된 문자열

예제

이 예제는 이 문자열에 대한 URI 인코딩된 버전을 만듭니다.

uriComponent('https://contoso.com')

그리고 다음 결과를 반환합니다. "https%3A%2F%2Fcontoso.com"

uriComponentToBinary

URI(Uniform Resource Identifier) 구성 요소에 대한 이진 버전을 반환합니다.

uriComponentToBinary('<value>')

매개 변수	필수	Type	설명
<value>	예	문자열	변환할 URI 인코딩된 문자열

반환 값	Type	설명
<binary-for-encoded-uri>	문자열	URI 인코딩된 문자열에 대한 이진 버전 이진 콘텐츠는 base64로 인코딩되며 `$content`에 의해 표시됩니다.

예제

이 예제는 이 URI 인코딩된 문자열에 대한 이진 버전을 만듭니다.

uriComponentToBinary('https%3A%2F%2Fcontoso.com')

그리고 다음 결과를 반환합니다.

"001000100110100001110100011101000111000000100101001100 11010000010010010100110010010001100010010100110010010001 10011000110110111101101110011101000110111101110011011011 110010111001100011011011110110110100100010"

uriComponentToString

URI(Uniform Resource Identifier) 인코딩된 문자열에 대한 문자열 버전을 반환하며, 결과적으로 URI 인코딩된 문자열을 디코딩합니다.

uriComponentToString('<value>')

매개 변수	필수	Type	설명
<value>	예	문자열	디코딩할 URI 인코딩된 문자열

반환 값	Type	설명
<decoded-uri>	문자열	URI 인코딩된 문자열에 대한 디코딩된 버전

예제

이 예제는 이 URI 인코딩된 문자열에 대한 디코딩된 버전을 만듭니다.

uriComponentToString('https%3A%2F%2Fcontoso.com')

그리고 다음 결과를 반환합니다. "https://contoso.com"

uriHost

host URI(Uniform Resource Identifier)에 대한 값을 반환합니다.

uriHost('<uri>')

매개 변수	필수	Type	설명
<uri>	예	문자열	값을 원하는 URI `host`

반환 값	Type	설명
<host-value>	문자열	`host` 지정된 URI의 값입니다.

예제

이 예제에서는 이 URI의 host 값을 찾습니다.

uriHost('https://www.localhost.com:8080')

그리고 다음 결과를 반환합니다. "www.localhost.com"

uriPath

path URI(Uniform Resource Identifier)에 대한 값을 반환합니다.

uriPath('<uri>')

매개 변수	필수	Type	설명
<uri>	예	문자열	값을 원하는 URI `path`

반환 값	Type	설명
<path-value>	문자열	`path` 지정된 URI의 값입니다. 값이 없으면 `path` "/" 문자를 반환합니다.

예제

이 예제에서는 이 URI의 path 값을 찾습니다.

uriPath('https://www.contoso.com/catalog/shownew.htm?date=today')

그리고 다음 결과를 반환합니다. "/catalog/shownew.htm"

uriPathAndQuery

URI(Uniform Resource Identifier)에 대한 path 및 query 값을 반환합니다.

uriPathAndQuery('<uri>')

매개 변수	필수	Type	설명
<uri>	예	문자열	원하는 URI `path` 및 `query` 값

반환 값	Type	설명
<path-query-value>	문자열	`path` 지정된 URI의 값 및 `query` 값입니다. `path`에 값을 지정하지 않은 경우 "/" 문자를 반환합니다.

예제

이 예제는 이 URI에 대한 path 및 query값을 찾습니다.

uriPathAndQuery('https://www.contoso.com/catalog/shownew.htm?date=today')

그리고 다음 결과를 반환합니다. "/catalog/shownew.htm?date=today"

uriPort

port URI(Uniform Resource Identifier)에 대한 값을 반환합니다.

uriPort('<uri>')

매개 변수	필수	Type	설명
<uri>	예	문자열	값을 원하는 URI `port`

반환 값	Type	설명
<port-value>	정수	`port` 지정된 URI의 값입니다. `port`에 값을 지정하지 않은 경우 프로토콜에 대한 기본 포트를 반환합니다.

예제

이 예제에서는 이 URI의 port 값을 반환합니다.

uriPort('https://www.localhost:8080')

그리고 다음 결과를 반환합니다. 8080

uriQuery

query URI(Uniform Resource Identifier)에 대한 값을 반환합니다.

uriQuery('<uri>')

매개 변수	필수	Type	설명
<uri>	예	문자열	값을 원하는 URI `query`

반환 값	Type	설명
<query-value>	문자열	`query` 지정된 URI의 값입니다.

예제

이 예제에서는 이 URI의 query 값을 반환합니다.

uriQuery('https://www.contoso.com/catalog/shownew.htm?date=today')

그리고 다음 결과를 반환합니다. "?date=today"

uriScheme

scheme URI(Uniform Resource Identifier)에 대한 값을 반환합니다.

uriScheme('<uri>')

매개 변수	필수	Type	설명
<uri>	예	문자열	값을 원하는 URI `scheme`

반환 값	Type	설명
<scheme-value>	문자열	`scheme` 지정된 URI의 값입니다.

예제

이 예제에서는 이 URI의 scheme 값을 반환합니다.

uriScheme('https://www.contoso.com/catalog/shownew.htm?date=today')

그리고 다음 결과를 반환합니다. "http"

utcNow

현재 타임스탬프를 반환합니다.

utcNow('<format>')

선택적으로 <format> 매개 변수를 사용하여 다른 형식을 지정할 수 있습니다.

매개 변수	필수	Type	설명
<format>	아니요	문자열	단일 형식 지정자 또는 사용자 지정 형식 패턴인 숫자 서식 문자열입니다. 타임스탬프의 기본 형식은 "o"(yyyy-MM-ddTHH:mm:ss.fffffffK)입니다. 이 형식은 ISO 8601을 준수하며 표준 시간대 정보를 보존합니다. 형식이 유효한 값이 아니면 오류가 생성됩니다.

반환 값	Type	설명
<current-timestamp>	문자열	현재 날짜 및 시간

예제 1

오늘이 2018년 4월 15일 오후 1시 00분 00초라고 가정합니다. 이 예제는 현재 타임스탬프를 가져옵니다.

utcNow()

그리고 다음 결과를 반환합니다. "2018-04-15T13:00:00.0000000Z"

예제 2

오늘이 2018년 4월 15일 오후 1시 00분 00초라고 가정합니다. 이 예제는 선택적 "D" 형식을 사용하여 현재 타임스탬프를 가져옵니다.

utcNow('D')

그리고 다음 결과를 반환합니다. "Sunday, April 15, 2018"

V

variables

지정한 변수에 대한 값을 반환합니다.

variables('<variableName>')

매개 변수	필수	Type	설명
<variableName>	예	문자열	값을 원하는 변수의 이름입니다.

반환 값	Type	설명
<variable-value>	모두	지정된 변수의 값입니다.

예제

"numItems" 변수의 현재 값이 20이라고 가정합니다. 이 예제에서는 이 변수의 정수 값을 가져옵니다.

variables('numItems')

그리고 다음 결과를 반환합니다. 20

수

workflow

런타임 동안 워크플로 자체에 대한 모든 세부 정보를 반환합니다.

workflow().<property>

매개 변수	필수	Type	설명
<속성>	아니요	문자열	값을 원하는 워크플로 속성의 이름입니다. 기본적으로 워크플로 개체에는 다음과 같은 속성이 `runtagstypelocationid`있습니다. `name` - 속성 값은 `run` 다음 속성을 포함하는 JSON 개체입니다. `nametypeid` - `tags` 속성은 Azure Logic Apps의 논리 앱 또는 Power Automate의 흐름과 연결된 태그와 해당 태그의 값을 포함하는 JSON 개체입니다. Azure 리소스의 태그에 대한 자세한 내용은 Azure의 논리 조직에 대한 태그 리소스, 리소스 그룹 및 구독을 검토하세요. 참고: 기본적으로 논리 앱에는 태그가 없지만 Power Automate 흐름에는 태그와 `environmentName` 태그가 `flowDisplayName` 있습니다.

예제 1

이 예제에서는 워크플로의 현재 실행에 대한 이름을 반환합니다.

workflow().run.name

예제 2

Power Automate를 사용하는 경우 tags 출력 속성을 사용하여 흐름의 flowDisplayName 또는 environmentName속성에서 값을 가져오는 @workflow() 식을 만들 수 있습니다.

예를 들어 흐름 자체에서 흐름으로 다시 연결되는 사용자 지정 메일 알림 보낼 수 있습니다. 이러한 알림에는 전자 메일 제목에 흐름의 표시 이름을 포함하고 다음 구문을 따르는 HTML 링크가 포함될 수 있습니다.

<a href=https://flow.microsoft.com/manage/environments/@{workflow()['tags']['environmentName']}/flows/@{workflow()['name']}/details>Open flow @{workflow()['tags']['flowDisplayName']}</a>

X

Xml

JSON 개체를 포함하는 문자열에 대한 XML 버전을 반환합니다.

xml('<value>')

매개 변수	필수	Type	설명
<value>	예	문자열	변환할 JSON 개체를 가진 문자열 JSON 개체는 배열일 수 없는 루트 속성 한 개만 가져야 합니다. 백슬래시 문자(\)를 따옴표(")에 대한 이스케이프 문자로 사용합니다.

반환 값	Type	설명
<xml-version>	Object	지정한 문자열 또는 JSON 개체에 대한 인코딩된 XML

예제 1

이 예제에서는 문자열을 XML로 변환합니다.

xml('<name>Sophia Owen</name>')

그리고 다음 결과 XML을 반환합니다.

<name>Sophia Owen</name>

예제 2

이 예제는 이 문자열에 대한 XML 버전을 만들며, 이 문자열은 JSON 개체를 포함합니다.

xml(json('{ "name": "Sophia Owen" }'))

그리고 다음 결과 XML을 반환합니다.

<name>Sophia Owen</name>

예 3

이 JSON 개체가 있다고 가정합니다.

{
  "person": {
    "name": "Sophia Owen",
    "city": "Seattle"
  }
}

이 예제는 이 JSON 개체를 포함하는 문자열에 대한 XML을 만듭니다.

xml(json('{"person": {"name": "Sophia Owen", "city": "Seattle"}}'))

그리고 다음 결과 XML을 반환합니다.

<person>
  <name>Sophia Owen</name>
  <city>Seattle</city>
<person>

xpath

XPath(XML 경로 언어) 식과 일치하는 노드 또는 값에 대한 XML을 확인하고 일치하는 노드 또는 값을 반환합니다. XPath 식 또는 단순히 "XPath"는 XML 콘텐츠에서 노드를 선택하고 값을 계산할 수 있도록 XML 문서 구조를 탐색하는 데 도움이 됩니다.

참고 항목

소비 및 표준 논리 앱에서 모든 함수 식은 .NET XPath 라이브러리를 사용합니다. XPath 식은 기본 .NET 라이브러리와 호환되며 기본 .NET 라이브러리에서 지원하는 식만 지원합니다.

xpath('<xml>', '<xpath>')

매개 변수	필수	Type	설명
<xml>	예	모두	XPath 식 값과 일치하는 노드 또는 값을 검색하기 위한 XML 문자열
<xpath>	예	모두	일치하는 XML 노드 또는 값을 찾는 데 사용한 XPath 식

반환 값	Type	설명
<xml-node>	XML	단일 노드만이 지정한 XPath 식과 일치하는 경우 XML 노드
<value>	모두	단일 값만이 지정한 XPath 식과 일치하는 경우 XML 노드의 값
[<xml-node1>, <xml-node2>, ...] -or- [<value1>, <value2>, ...]	배열	지정한 XPath 식과 일치하는 XML 노드 또는 값을 가진 배열

예제 1

이 'items' XML 문자열을 갖고 있다고 가정합니다.

<?xml version="1.0"?>
<produce>
  <item>
    <name>Gala</name>
    <type>apple</type>
    <count>20</count>
  </item>
  <item>
    <name>Honeycrisp</name>
    <type>apple</type>
    <count>10</count>
  </item>
</produce>

이 예제에서는 XPath 식을 '/produce/item/name/text()'전달하여 XML 문자열의 노드와 일치하는 <name></name> 노드를 'items' 찾고 해당 노드 값이 있는 배열을 반환합니다.

xpath(xml(parameters('items')), '/produce/item/name/text()')

또한 이 예제는 parameters() 함수를 사용하여 'items'에서 XML 문자열을 가져오고 xml() 함수를 사용하여 문자열을 XML 형식으로 변환합니다.

일치하는 노드의 값으로 채워진 결과 배열은 다음과 같습니다.<name></name>

[ Gala, Honeycrisp ]

예제 2

예제 1 다음에 이 예제는 XPath 식 '/produce/item/name[1]'을 전달하여 item 요소의 자식인 첫 번째 name 요소를 찾습니다.

xpath(xml(parameters('items')), '/produce/item/name[1]')

결과: Gala

예 3

예제 1에 이어 이 예제에서는 XPath 식을 '/produce/item/name[last()]'전달하여 요소의 item 자식인 마지막 name 요소를 찾습니다.

xpath(xml(parameters('items')), '/produce/item/name[last()]')

결과: Honeycrisp

예제 4

이 예제에서는 XML 문자열에도 특성이 포함되어 있다고 가정 items 하고 expired='false'다음 expired='true' 을 수행합니다.

<?xml version="1.0"?>
<produce>
  <item>
    <name expired='true'>Gala</name>
    <type>apple</type>
    <count>20</count>
  </item>
  <item>
    <name expired='false'>Honeycrisp</name>
    <type>apple</type>
    <count>10</count>
  </item>
</produce>

이 예제는 XPath 식 '//name[@expired]'를 전달하여 expired 특성이 있는 모든 name 요소를 찾습니다.

xpath(xml(parameters('items')), '//name[@expired]')

결과: [ Gala, Honeycrisp ]

예제 5

이 예제에서는 XML 문자열에 이 특성만 포함되어 있다고 가정 items 합니다. expired = 'true'

<?xml version="1.0"?>
<produce>
  <item>
    <name expired='true'>Gala</name>
    <type>apple</type>
    <count>20</count>
  </item>
  <item>
    <name>Honeycrisp</name>
    <type>apple</type>
    <count>10</count>
  </item>
</produce>

이 예제에서는 XPath 식을 '//name[@expired = 'true']'전달하여 특성expired = 'true'이 있는 모든 name 요소를 찾습니다.

xpath(xml(parameters('items')), '//name[@expired = 'true']')

결과: [ Gala ]

예제 6

이 예제에서는 XML 문자열에도 다음과 같은 특성이 포함되어 있다고 가정합니다 items .

expired='true' price='12'
expired='false' price='40'

<?xml version="1.0"?>
<produce>
  <item>
    <name expired='true' price='12'>Gala</name>
    <type>apple</type>
    <count>20</count>
  </item>
  <item>
    <name expired='false' price='40'>Honeycrisp</name>
    <type>apple</type>
    <count>10</count>
  </item>
</produce>

이 예제는 XPath 식 '//name[@price>35]'를 전달하여 price > 35가 있는 모든 name 요소를 찾습니다.

xpath(xml(parameters('items')), '//name[@price>35]')

결과: Honeycrisp

예제 7

이 예제는 items XML 문자열이 예제 1과 같다고 가정합니다.

<?xml version="1.0"?>
<produce>
  <item>
    <name>Gala</name>
    <type>apple</type>
    <count>20</count>
  </item>
  <item>
    <name>Honeycrisp</name>
    <type>apple</type>
    <count>10</count>
  </item>
</produce>

이 예제에서는 노드와 일치하는 노드를 <count></count> 찾고 해당 노드 값을 함수에 sum() 추가합니다.

xpath(xml(parameters('items')), 'sum(/produce/item/count)')

결과: 30

예제 8

이 예제에서는 XML 문서 네임스페이스를 포함하는 이 XML 문자열이 있다고 가정합니다 xmlns="https://contoso.com".

<?xml version="1.0"?><file xmlns="https://contoso.com"><location>Paris</location></file>

이러한 식은 XPath 식인 /*[name()="file"]/*[name()="location"] 또는 /*[local-name()="file" and namespace-uri()="https://contoso.com"]/*[local-name()="location"]을 사용하여 <location></location> 노드와 일치하는 노드를 찾습니다. 다음 예제에서는 디자이너 또는 식 편집기에서 사용하는 구문을 보여 줍니다.

xpath(xml(body('Http')), '/*[name()="file"]/*[name()="location"]')
xpath(xml(body('Http')), '/*[local-name()="file" and namespace-uri()="https://contoso.com"]/*[local-name()="location"]')

<location></location> 노드와 일치하는 결과 노드는 다음과 같습니다.

<location xmlns="https://contoso.com">Paris</location>

Important

코드 보기에서 작업하는 경우 백슬래시 문자(\)를 사용하여 큰따옴표(")를 이스케이프합니다. 예를 들어 식을 JSON 문자열로 직렬화할 때에는 이스케이프 문자를 사용해야 합니다. 그러나 디자이너 또는 식 편집기에서 작업하는 경우 백슬래시 문자가 기본 정의에 자동으로 추가되므로 큰따옴표를 이스케이프할 필요가 없습니다. 예를 들면 다음과 같습니다.

코드 보기: xpath(xml(body('Http')), '/*[name()=\"file\"]/*[name()=\"location\"]')
식 편집기: xpath(xml(body('Http')), '/*[name()="file"]/*[name()="location"]')

예제 9

예제 8에 이어 이 예제에서는 XPath 식을 'string(/*[name()="file"]/*[name()="location"])'사용하여 노드에서 값을 찾습니다 <location></location> .

xpath(xml(body('Http')), 'string(/*[name()="file"]/*[name()="location"])')

결과: Paris

다음 단계

워크플로 정의 언어에 대해 알아보기

다음을 통해 공유

Azure Logic Apps 및 Power Automate의 워크플로 식 함수에 대한 참조 가이드

식의 함수

함수 사용에 대한 고려 사항

문자열 함수

컬렉션 기능

논리적 비교 기능

변환 함수

암시적 데이터 유형 변환

Base64 인코딩 및 디코딩

수식 함수

날짜 및 시간 함수

워크플로 기능

URI 구문 분석 함수

조작 함수: JSON 및 XML

---------------------------------

모든 함수 - 사전순 목록

A

작업

actions

추가

addDays

addHours

addMinutes

addProperty

addSeconds

addToTime

및

array

B

base64

base64ToBinary

base64ToString

binary

본문

bool

C

chunk

coalesce

concat

contains

convertFromUtc

convertTimeZone

convertToUtc

createArray

D

dataUri

dataUriToBinary

dataUriToString

dateDifference

dayOfMonth

dayOfWeek

dayOfYear

decimal

decodeBase64(사용되지 않음)

decodeDataUri

decodeUriComponent

div

E

encodeUriComponent

empty

endsWith

같음

F

첫째

float

formatDateTime

formDataMultiValues

formDataValue

formatNumber

G

getFutureTime

getPastTime

greater

greaterOrEquals

guid

I

if

indexOf

int