Azure Logic Apps에서 범위를 사용하여 그룹 상태에 따라 작업 실행
적용 대상: Azure Logic Apps(소비)
다른 작업 그룹이 성공하거나 실패한 후에만 작업을 실행하려면 해당 작업을 범위 내에 그룹화합니다. 이 구조는 작업을 논리 그룹으로 구성하고, 해당 그룹의 상태를 평가하고, 범위의 상태에 따라 작업을 수행하려는 경우에 유용합니다. 범위 내 모든 작업의 실행이 완료되면 범위에서 자체의 상태도 가져옵니다. 예를 들어 예외 및 오류 처리를 구현하려는 경우 범위를 사용할 수 있습니다.
범위의 상태를 확인하려면 성공, 실패, 취소됨 등과 같이 논리 앱의 실행 상태를 결정하는 데 사용하는 것과 동일한 기준을 사용할 수 있습니다. 기본적으로 범위의 모든 작업이 성공하면 범위 상태가 성공으로 표시됩니다. 그러나 범위의 모든 작업이 실패하거나 취소되면 범위의 상태가 실패로 표시됩니다. 범위에 대한 제한은 제한 및 구성을 참조하세요.
예를 들어 특정 작업을 실행하는 범위 및 범위의 상태를 확인하는 조건을 사용하는 상위 수준의 논리 앱이 있습니다. 범위의 작업이 예기치 않게 실패하거나 종료되면, 범위가 각각 실패 또는 중단됨으로 표시되고, 논리 앱에서 “범위 실패” 메시지를 보냅니다. 범위가 지정된 모든 작업이 성공하면 논리 앱에서 "범위 성공" 메시지를 보냅니다.
필수 조건
이 문서의 예를 수행하려면 다음 항목이 필요합니다.
Azure 구독 구독이 없는 경우 Azure 체험 계정에 등록합니다.
Logic Apps에서 지원하는 모든 이메일 공급자의 이메일 계정입니다. 이 예에서는 Outlook.com을 사용합니다. 다른 공급자를 사용하는 경우 일반 흐름은 동일하게 유지되지만 UI는 다르게 표시됩니다.
Bing 지도 키입니다. 이 키를 가져오려면 Bing 지도 키 가져오기를 참조하세요.
논리 앱에 대한 기본 지식
샘플 논리 앱 만들기
나중에 범위를 추가할 수 있도록 먼저 다음과 같은 샘플 논리 앱을 만듭니다.
- 지정한 간격으로 Bing 지도 서비스를 확인하는 일정 - 되풀이 트리거
- 두 위치 사이의 이동 시간을 확인하는 Bing 지도 - 경로 가져오기 작업
- 이동 시간이 지정된 이동 시간을 초과하는지 확인하는 조건 작업
- 현재 이동 시간이 지정한 시간을 초과했다는 이메일을 보내는 작업
논리 앱은 언제든지 저장할 수 있으므로 작업을 자주 저장합니다.
Azure Portal에 로그인합니다(아직 로그인하지 않은 경우). 빈 논리 앱을 만듭니다.
간격 = "1" 및 빈도 = "분" 설정이 있는 일정 - 되풀이 트리거를 추가합니다.
팁
시각적으로 보기를 간소화하고 디자이너에서 각 작업의 세부 정보를 숨기려면 이러한 단계를 진행하면서 각 작업의 셰이프를 축소하세요.
Bing 지도 - 경로 가져오기 작업을 추가합니다.
아직 Bing 지도 연결이 아직 없으면 연결을 만들도록 요청하는 메시지가 표시됩니다.
설정 값 Description 연결 이름 BingMapsConnection 연결 이름을 입력합니다. API 키 <your-Bing-Maps-key> 이전에 받은 Bing 지도 키를 입력합니다. 다음 이미지 아래의 표와 같은 경로 가져오기 작업을 설정합니다.
이러한 매개 변수에 대한 자세한 내용은 경로 계산을 참조하세요.
설정 값 설명 Waypoint 1 <start> 경로의 출발지를 입력합니다. Waypoint 2 <end> 경로의 도착지를 입력합니다. 방지 없음 고속도로, 톨게이트 등 경로에서 피해야 하는 항목을 입력합니다. 가능한 값은 경로 계산을 참조하세요. Optimize timeWithTraffic 거리, 현재 교통 정보와 관련된 시간 등 경로를 최적화하기 위한 매개 변수를 선택합니다. 이 예에서는 "timeWithTraffic" 값을 사용합니다. Distance unit <원하는 단위> 경로를 계산하기 위한 거리 단위를 입력합니다. 이 예에서는 "마일" 값을 사용합니다. Travel mode Driving 경로에 대한 이동 모드를 입력합니다. 이 예에서는 "운전" 값을 사용합니다. Transit Date-Time 없음 대중교통 모드에만 적용됩니다. Transit Date-Type Type 없음 대중교통 모드에만 적용됩니다.
운행과 관련된 현재 이동 시간이 지정된 시간을 초과하는지 확인하는 조건을 추가합니다. 이 예제에서는 다음 단계를 따릅니다.
운행 시간이 지정된 시간을 초과하는 경우라는 설명이 포함되도록 조건 이름을 바꿉니다.
가장 왼쪽 열에서 값 선택 상자 내부를 선택하면 동적 콘텐츠 목록이 표시됩니다. 이 목록에서 초 단위의 운행 기간 트래픽 필드를 선택합니다.
가운데 상자에서 보다 큼 연산자를 선택합니다.
맨 오른쪽 열에서 다음 비교 값을 입력합니다. 이 값은 초 단위이며 10분과 동일합니다. 600
여기까지 마쳤으면 조건이 다음 예제와 비슷하게 표시됩니다.
True 분기에서 이메일 공급자에 대한 "이메일 보내기" 작업을 추가합니다. 이 이미지 아래의 단계에 따라 이 작업을 설정합니다.
받는 사람 필드에 테스트 용도의 이메일 주소를 입력합니다.
제목 필드에 다음 텍스트를 입력합니다.
Time to leave: Traffic more than 10 minutes- 본문 필드에 후행 공백이 있는 다음 텍스트를 입력합니다.
Travel time:커서가 본문 필드에 있는 동안 동적 콘텐츠 목록이 열려 있으므로 이 시점에서 사용할 수 있는 매개 변수를 선택할 수 있습니다.
동적 콘텐츠 목록에서 식을 선택합니다.
div() 함수를 찾아서 선택합니다. 함수의 괄호 내부에 커서를 놓습니다.
커서를 함수의 괄호 안에 놓은 상태에서 동적 콘텐츠를 선택하여 동적 콘텐츠 목록을 표시합니다.
경로 가져오기 섹션에서 운행 기간 트래픽 필드를 선택합니다.
필드가 JSON 형식으로 확인되면 운행 기간 트래픽의 값을 초 단위에서 분 단위로 변환할 수 있도록 쉼표(
,) 뒤에 숫자(60)를 추가합니다.div(body('Get_route')?['travelDurationTraffic'],60)이제 식이 다음 예와 같습니다.
완료되면 확인을 선택합니다.
식이 확인되면 선행 공백이 있는
minutes텍스트를 추가합니다.이제 본문 필드가 다음 예와 같습니다.
논리 앱을 저장합니다.
다음으로, 특정 작업을 그룹화하고 해당 상태를 평가할 수 있도록 범위를 추가합니다.
범위 추가
아직 열지 않았다면 워크플로 디자이너에서 논리 앱을 엽니다.
원하는 워크플로 위치에 범위를 추가합니다. 예를 들어 논리 앱 워크플로의 기존 단계 사이에 범위를 추가하려면 다음 단계를 수행합니다.
범위를 추가하려는 화살표 위로 포인터를 이동합니다. 더하기 기호(+) >작업 추가를 선택합니다.
검색 상자에서 필터로 "범위"를 입력합니다. 범위 작업을 선택합니다.
범위에 단계 추가
이제 단계를 추가하거나 범위 내에서 실행하려는 기존 단계를 끕니다. 이 예에서는 다음 작업을 범위로 끕니다.
- 경로 가져오기
- 운행 시간이 지정된 시간을 초과하는 경우(true 및 false 분기를 모두 포함)
이제 논리 앱은 다음 예와 같습니다.
범위 아래에서 범위의 상태를 확인하는 조건을 추가합니다. 범위가 실패한 경우라는 설명이 포함되도록 조건 이름을 바꿉니다.
조건에서, 범위 상태가 "실패함"인지 또는 "중단됨"인지 확인하는 다음 식을 추가합니다.
다른 행을 추가하려면 추가를 선택합니다.
각 행에서 왼쪽 상자 내부를 선택하면 동적 콘텐츠 목록이 나타납니다. 동적 콘텐츠 목록에서 식을 선택합니다. 편집 상자에 다음 식을 입력한 후 확인을 선택합니다.
action('Scope')
두 행 모두에서 다음과 같음 연산자를 선택합니다.
비교 값의 경우 첫 번째 행에
Failed를 입력합니다. 두 번째 행에Aborted를 입력합니다.여기까지 마쳤으면 조건이 다음 예제와 비슷하게 표시됩니다.
조건이 범위 상태를 확인하고 이후 단계에서 정의할 매칭 작업을 실행하도록 조건의
runAfter속성을 설정합니다.범위가 실패한 경우 조건에서 줄임표(...) 단추를 선택한 다음, 실행 조건 구성을 선택합니다.
성공함, 실패함, 건너뜀, 시간이 초과됨 범위 상태를 모두 선택합니다.
완료되면 완료를 선택합니다. 이제 조건에 "정보" 아이콘이 표시됩니다.
True 분기 및 False 분기에서, 각 범위 상태에 따라 수행하려는 작업(예: 이메일 또는 메시지 보내기)을 추가합니다.
논리 앱을 저장합니다.
완성된 논리 앱은 이 예제와 비슷합니다.
작업 테스트
디자이너 도구 모음에서 실행>실행을 선택합니다. 범위가 지정된 모든 작업이 성공하면 "범위 성공" 메시지가 표시됩니다. 범위가 지정된 작업이 성공하지 못하면 "범위 실패" 메시지가 표시됩니다.
JSON 정의
코드 뷰에서 작업하는 경우 논리 앱의 JSON 정의에서 범위 구조를 대신 정의할 수 있습니다. 예를 들어 이전 논리 앱의 트리거 및 작업에 대한 JSON 정의는 다음과 같습니다.
"triggers": {
"Recurrence": {
"type": "Recurrence",
"recurrence": {
"frequency": "Minute",
"interval": 1
}
}
}
"actions": {
"If_scope_failed": {
"type": "If",
"actions": {
"Scope_failed": {
"type": "ApiConnection",
"inputs": {
"body": {
"Body": "Scope failed. Scope status: @{action('Scope')}",
"Subject": "Scope failed",
"To": "<your-email@domain.com>"
},
"host": {
"connection": {
"name": "@parameters('$connections')['outlook']['connectionId']"
}
},
"method": "post",
"path": "/Mail"
},
"runAfter": {}
}
},
"else": {
"actions": {
"Scope_succeeded": {
"type": "ApiConnection",
"inputs": {
"body": {
"Body": "Scope succeeded. Scope status: @{action('Scope')}",
"Subject": "Scope succeeded",
"To": "<your-email@domain.com>"
},
"host": {
"connection": {
"name": "@parameters('$connections')['outlook']['connectionId']"
}
},
"method": "post",
"path": "/Mail"
},
"runAfter": {}
}
}
},
"expression": {
"or": [
{
"equals": [
"@action('Scope')",
"Failed"
]
},
{
"equals": [
"@action('Scope')",
"Aborted"
]
}
]
},
"runAfter": {
"Scope": [
"Failed",
"Skipped",
"Succeeded",
"TimedOut"
]
}
},
"Scope": {
"type": "Scope",
"actions": {
"Get_route": {
"type": "ApiConnection",
"inputs": {
"host": {
"connection": {
"name": "@parameters('$connections')['bingmaps']['connectionId']"
}
},
"method": "get",
"path": "/REST/V1/Routes/Driving",
"queries": {
"distanceUnit": "Mile",
"optimize": "timeWithTraffic",
"travelMode": "Driving",
"wp.0": "<start>",
"wp.1": "<end>"
}
},
"runAfter": {}
},
"If_traffic_time_is_more_than_specified_time": {
"type": "If",
"actions": {
"Send_mail_when_traffic_exceeds_10_minutes": {
"type": "ApiConnection",
"inputs": {
"body": {
"Body": "Travel time:@{div(body('Get_route')?['travelDurationTraffic'],60)} minutes",
"Subject": "Time to leave: Traffic more than 10 minutes",
"To": "<your-email@domain.com>"
},
"host": {
"connection": {
"name": "@parameters('$connections')['outlook']['connectionId']"
}
},
"method": "post",
"path": "/Mail"
},
"runAfter": {}
}
},
"expression": {
"and" : [
{
"greater": [
"@body('Get_route')?['travelDurationTraffic']",
600
]
}
]
},
"runAfter": {
"Get_route": [
"Succeeded"
]
}
}
},
"runAfter": {}
}
},