Azure Logic Apps의 트리거 및 작업 형식에 대한 스키마 참조 가이드

이 참조는 워크플로 정의 언어에서 설명하고 유효성을 검사하는 논리 앱의 기본 워크플로 정의에서 트리거 및 작업을 식별하는 데 사용되는 일반적인 형식에 대해 설명합니다. To find specific connector triggers and actions that you can use in your logic apps, see the list under the Connectors overview.

Triggers overview

모든 워크플로에는 워크플로를 인스턴스화하고 시작하는 호출을 정의하는 트리거가 포함됩니다. 일반 트리거 범주는 다음과 같습니다.

• A polling trigger, which checks a service's endpoint at regular intervals

• A push trigger, which creates a subscription to an endpoint and provides a callback URL so the endpoint can notify the trigger when the specified event happens or data is available. 그러면 트리거는 발생하기 전에 엔드포인트의 응답을 기다립니다.

트리거에는 다음과 같은 최상위 요소가 있지만 일부는 선택 사항입니다.

"<trigger-name>": {
   "type": "<trigger-type>",
   "inputs": { "<trigger-inputs>" },
   "recurrence": { 
      "frequency": "<time-unit>",
      "interval": <number-of-time-units>
   },
   "conditions": [ "<array-with-conditions>" ],
   "runtimeConfiguration": { "<runtime-config-options>" },
   "splitOn": "<splitOn-expression>",
   "operationOptions": "<operation-option>"
},

Required

Optional

트리거 형식 목록

각 트리거 형식에는 트리거의 동작을 정의하는 다른 인터페이스와 입력이 있습니다.

Built-in triggers

관리되는 API 트리거

트리거 - 자세한 참조

APIConnection trigger

This trigger checks or polls an endpoint by using Microsoft-managed APIs or "connectors" so the parameters for this trigger can differ based on the endpoint. 이 트리거 정의의 많은 섹션은 선택 사항입니다. 트리거의 동작은 섹션이 포함되는지 여부에 따라 달라집니다.

"<APIConnection_trigger_name>": {
   "type": "ApiConnection",
   "inputs": {
      "host": {
         "connection": {
            "name": "@parameters('$connections')['<connection-name>']['connectionId']"
         }
      },
      "method": "<method-type>",
      "path": "/<api-operation>",
      "retryPolicy": { "<retry-behavior>" },
      "queries": { "<query-parameters>" }
   },
   "recurrence": { 
      "frequency": "<time-unit>",
      "interval": <number-of-time-units>
   },
   "runtimeConfiguration": {
      "concurrency": {
         "runs": <max-runs>,
         "maximumWaitingRuns": <max-runs-queue>
      }
   },
   "splitOn": "<splitOn-expression>",
   "operationOptions": "<operation-option>"
}

Required

Optional

Outputs

Example

이 트리거 정의는 회사 또는 학교 계정의 받은 편지함 내에서 매일 전자 메일을 확인합니다.

"When_a_new_email_arrives": {
   "type": "ApiConnection",
   "inputs": {
      "host": {
         "connection": {
            "name": "@parameters('$connections')['office365']['connectionId']"
         }
      },
      "method": "get",
      "path": "/Mail/OnNewEmail",
      "queries": {
          "fetchOnlyWithAttachment": false,
          "folderPath": "Inbox",
          "importance": "Any",
          "includeAttachments": false
      }
   },
   "recurrence": {
      "frequency": "Day",
      "interval": 1
   }
}

ApiConnectionWebhook trigger

This trigger sends a subscription request to an endpoint by using a Microsoft-managed API, provides a callback URL to where the endpoint can send a response, and waits for the endpoint to respond. For more information, see Endpoint subscriptions.

"<ApiConnectionWebhook_trigger_name>": {
   "type": "ApiConnectionWebhook",
   "inputs": {
      "body": {
          "NotificationUrl": "@{listCallbackUrl()}"
      },
      "host": {
         "connection": {
            "name": "@parameters('$connections')['<connection-name>']['connectionId']"
         }
      },
      "retryPolicy": { "<retry-behavior>" },
      "queries": "<query-parameters>"
   },
   "runTimeConfiguration": {
      "concurrency": {
         "runs": <max-runs>,
         "maximumWaitingRuns": <max-run-queue>
      }
   },
   "splitOn": "<splitOn-expression>",
   "operationOptions": "<operation-option>"
}

Required

Optional

Example

이 트리거 정의는 Office 365 Outlook API를 구독하고, API 엔드포인트에 대한 콜백 URL을 제공하고, 새 이메일이 도착할 때 엔드포인트이 응답할 때까지 기다립니다.

"When_a_new_email_arrives_(webhook)": {
   "type": "ApiConnectionWebhook",
   "inputs": {
      "body": {
         "NotificationUrl": "@{listCallbackUrl()}" 
      },
      "host": {
         "connection": {
            "name": "@parameters('$connections')['office365']['connectionId']"
         }
      },
      "path": "/MailSubscription/$subscriptions",
      "queries": {
          "folderPath": "Inbox",
          "hasAttachment": "Any",
          "importance": "Any"
      }
   },
   "splitOn": "@triggerBody()?['value']"
}

HTTP trigger

이 트리거는 지정된 되풀이 일정에 따라 지정된 HTTP 또는 HTTPS 엔드포인트에 요청을 보냅니다. 그런 다음, 트리거에서 응답을 확인하여 워크플로가 실행되는지 여부를 결정합니다. 자세한 내용은 Azure Logic Apps에서 HTTP 또는 HTTPS를 통해 서비스 엔드포인트 호출을 참조 하세요.

"HTTP": {
   "type": "Http",
   "inputs": {
      "method": "<method-type>",
      "uri": "<HTTP-or-HTTPS-endpoint-URL>",
      "headers": { "<header-content>" },
      "queries": "<query-parameters>",
      "body": "<body-content>",
      "authentication": { "<authentication-type-and-property-values>" },
      "retryPolicy": {
         "type": "<retry-behavior>"
      }
   },
   "recurrence": {
      "frequency": "<time-unit>",
      "interval": <number-of-time-units>
   },
   "runtimeConfiguration": {
      "concurrency": {
         "runs": <max-runs>,
         "maximumWaitingRuns": <max-runs-queue>
      }
   },
   "operationOptions": "<operation-option>"
}

Required

Optional

Outputs

들어오는 요청에 대한 요구 사항

논리 앱에서 제대로 작동하려면 엔드포인트에서 특정 트리거 패턴 또는 계약을 준수하고, 다음 응답 속성을 인식해야 합니다.

다른 요청에 대한 예제 동작

HTTPWebhook trigger

이 트리거를 사용하면 지정된 엔드포인트 URL을 호출하여 구독을 등록할 수 있는 엔드포인트를 만들어 논리 앱을 호출할 수 있습니다. 워크플로에서 이 트리거를 만들면 나가는 요청이 구독 등록을 호출합니다. 이렇게 하면 트리거가 이벤트 수신 대기를 시작할 수 있습니다. 작업으로 인해 이 트리거가 유효하지 않으면 나가는 요청이 자동으로 호출하여 구독을 취소합니다. For more information, see Endpoint subscriptions.

You can also specify asynchronous limits on an HTTPWebhook trigger. 트리거의 동작은 사용하거나 생략하는 섹션에 따라 달라집니다.

"HTTP_Webhook": {
   "type": "HttpWebhook",
   "inputs": {
      "subscribe": {
         "method": "<method-type>",
         "uri": "<endpoint-subscribe-URL>",
         "headers": { "<header-content>" },
         "body": "<body-content>",
         "authentication": { "<authentication-type>" },
         "retryPolicy": { "<retry-behavior>" }
      },
      "unsubscribe": {
         "method": "<method-type>",
         "url": "<endpoint-unsubscribe-URL>",
         "headers": { "<header-content>" },
         "body": "<body-content>",
         "authentication": { "<authentication-type>" }
      }
   },
   "runTimeConfiguration": {
      "concurrency": {
         "runs": <max-runs>,
         "maximumWaitingRuns": <max-runs-queue>
      }
   },
   "operationOptions": "<operation-option>"
}

Some values, such as <method-type>, are available for both the "subscribe" and "unsubscribe" objects.

Required

Optional

Outputs

Example

이 트리거는 지정된 엔드포인트에 대한 구독을 만들고, 고유한 콜백 URL을 제공하고, 새로 게시된 기술 문서를 기다립니다.

"HTTP_Webhook": {
   "type": "HttpWebhook",
   "inputs": {
      "subscribe": {
         "method": "POST",
         "uri": "https://pubsubhubbub.appspot.com/subscribe",
         "body": {
            "hub.callback": "@{listCallbackUrl()}",
            "hub.mode": "subscribe",
            "hub.topic": "https://pubsubhubbub.appspot.com/articleCategories/technology"
         },
      },
      "unsubscribe": {
         "method": "POST",
         "url": "https://pubsubhubbub.appspot.com/subscribe",
         "body": {
            "hub.callback": "@{workflow().endpoint}@{listCallbackUrl()}",
            "hub.mode": "unsubscribe",
            "hub.topic": "https://pubsubhubbub.appspot.com/articleCategories/technology"
         }
      }
   }
}

Recurrence trigger

이 트리거는 지정된 되풀이 일정에 따라 실행되며 정기적으로 실행되는 워크플로를 만드는 쉬운 방법을 제공합니다.

"Recurrence": {
   "type": "Recurrence",
   "recurrence": {
      "frequency": "<time-unit>",
      "interval": <number-of-time-units>,
      "startTime": "<start-date-time-with-format-YYYY-MM-DDThh:mm:ss>",
      "timeZone": "<time-zone>",
      "schedule": {
         // Applies only when frequency is Day or Week. Separate values with commas.
         "hours": [ <one-or-more-hour-marks> ], 
         // Applies only when frequency is Day or Week. Separate values with commas.
         "minutes": [ <one-or-more-minute-marks> ], 
         // Applies only when frequency is Week. Separate values with commas.
         "weekDays": [ "Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday" ] 
      }
   },
   "runtimeConfiguration": {
      "concurrency": {
         "runs": <max-runs>,
         "maximumWaitingRuns": <max-runs-queue>
      }
   },
   "operationOptions": "<operation-option>"
}

Required

Optional

Example 1

이 기본 되풀이 트리거가 매일 실행됩니다.

"Recurrence": {
   "type": "Recurrence",
   "recurrence": {
      "frequency": "Day",
      "interval": 1
   }
}

Example 2

트리거를 실행하기 위한 시작 날짜 및 시간을 지정할 수 있습니다. 이 되풀이 트리거는 지정된 날짜에 시작하여 매일 발생합니다.

"Recurrence": {
   "type": "Recurrence",
   "recurrence": {
      "frequency": "Day",
      "interval": 1,
      "startTime": "2017-09-18T00:00:00Z"
   }
}

Example 3

이 되풀이 트리거는 2017년 9월 9일 오후 2:00에 시작되며 매주 월요일 오전 10:30, 오후 12:30 및 오후 2:30 태평양 표준시에 발생합니다.

"Recurrence": {
   "type": "Recurrence",
   "recurrence": {
      "frequency": "Week",
      "interval": 1,
      "schedule": {
         "hours": [ 10, 12, 14 ],
         "minutes": [ 30 ],
         "weekDays": [ "Monday" ]
      },
      "startTime": "2017-09-07T14:00:00",
      "timeZone": "Pacific Standard Time"
   }
}

이 트리거에 대한 예제에 대한 자세한 내용은 만들기 및 정기적으로 실행 중인 작업 예약을 참조 하세요.

Request trigger

이 트리거를 사용하면 들어오는 요청을 수락할 수 있는 엔드포인트를 만들어 논리 앱을 호출할 수 있습니다. 이 트리거의 경우 들어오는 요청에서 트리거가 수신하는 페이로드 또는 입력을 설명하고 유효성을 검사하는 JSON 스키마를 제공합니다. 또한 스키마를 사용하면 워크플로의 이후 작업에서 트리거 속성을 더 쉽게 참조할 수 있습니다.

이 트리거를 호출하려면 워크플로 서비스 REST API에 설명된 APIlistCallbackUrl사용해야 합니다. 이 트리거를 HTTP 엔드포인트로 사용하는 방법을 알아보려면 HTTP 엔드포인트를 사용하여 워크플로 호출, 트리거 또는 중첩을 참조 하세요.

"Request": {
   "type": "Request",
   "kind": "Http",
   "inputs": {
      "method": "<method-type>",
      "relativePath": "<relative-path-for-accepted-parameter>",
      "schema": {
         "type": "object",
         "properties": { 
            "<property-name>": {
               "type": "<property-type>"
            }
         },
         "required": [ "<required-properties>" ]
      }
   },
   "runTimeConfiguration": {
      "concurrency": {
         "runs": <max-runs>,
         "maximumWaitingRuns": <max-run-queue>
      },
   },
   "operationOptions": "<operation-option>"
}

Required

Optional

Example

이 트리거는 들어오는 요청이 HTTP POST 메서드를 사용하여 트리거를 호출하도록 지정하고 들어오는 요청의 입력 유효성을 검사하는 스키마를 포함합니다.

"Request": {
   "type": "Request",
   "kind": "Http",
   "inputs": {
      "method": "POST",
      "schema": {
         "type": "object",
         "properties": {
            "customerName": {
               "type": "String"
            },
            "customerAddress": { 
               "type": "Object",
               "properties": {
                  "streetAddress": {
                     "type": "string"
                  },
                  "city": {
                     "type": "string"
                  }
               }
            }
         }
      }
   }
}

Trigger conditions

트리거 및 트리거에 대해서만 워크플로를 실행할지 여부를 결정하는 조건에 대해 하나 이상의 식을 포함하는 배열을 포함할 수 있습니다. 워크플로의 conditions 트리거에 속성을 추가하려면 코드 뷰 편집기에서 논리 앱을 엽니다.

예를 들어 웹 사이트가 속성에서 트리거의 상태 코드를 conditions 참조하여 내부 서버 오류를 반환하는 경우에만 트리거가 발생되도록 지정할 수 있습니다.

"Recurrence": {
   "type": "Recurrence",
   "recurrence": {
      "frequency": "Hour",
      "interval": 1
   },
   "conditions": [ {
      "expression": "@equals(triggers().code, 'InternalServerError')"
   } ]
}

기본적으로 트리거는 "200 정상" 응답을 받은 경우에만 트리거됩니다. 식에서 트리거의 상태 코드를 참조하는 경우 트리거의 기본 동작이 바뀝니다. 따라서 트리거가 "200" 및 "201" 상태 코드와 같은 둘 이상의 상태 코드에 대해 실행되도록 하려면 이 식을 조건으로 포함해야 합니다.

@or(equals(triggers().code, 200),equals(triggers().code, 201))

배열에서 여러 실행 트리거

트리거에서 워크플로가 처리할 배열을 받는 경우, "for each" 루프에서 각 배열 항목을 처리하는 데 너무 오래 걸리는 경우가 있습니다. Instead, you can use the SplitOn property in your trigger to debatch the array. 분리 처리는 배열 항목을 분할하고, 각 배열 항목에 대해 실행되는 새 워크플로 인스턴스를 시작합니다. 이 방법은 예를 들어 폴링 간격 사이에 여러 개의 새 항목을 반환할 수 있는 엔드포인트를 폴링하려는 경우에 유용합니다.

If your trigger's Swagger file describes a payload that's an array, the SplitOn property is automatically added to your trigger. 그렇지 않으면 분리하려는 배열이 있는 응답 페이로드 내에 이 속성을 추가합니다.

SplitOn 기능을 사용하기 전에 다음 고려 사항을 검토합니다.

• If trigger concurrency is enabled, the SplitOn limit is significantly reduced. 항목 수가 이 제한을 초과하면 SplitOn 기능이 사용하지 않도록 설정됩니다.

• 동기 응답 패턴에는 SplitOn 기능을 사용할 수 없습니다. Any workflow that uses the SplitOn property and includes a response action runs asynchronously and immediately sends a 202 ACCEPTED response.

• For the maximum number of array items that SplitOn can process in a single workflow run, see Limits and configuration.

Example

API를 호출하고 이 응답을 수신하는 HTTP 트리거가 있다고 가정합니다.

{
   "Status": "Succeeded",
   "Rows": [ 
      { 
         "id": 938109380,
         "name": "customer-name-one"
      },
      {
         "id": 938109381,
         "name": "customer-name-two"
      }
   ]
}

워크플로에는 Rows의 배열 콘텐츠만 필요하므로 다음 예제와 같은 트리거를 만들 수 있습니다.

"HTTP_Debatch": {
   "type": "Http",
    "inputs": {
        "uri": "https://mydomain.com/myAPI",
        "method": "GET"
    },
   "recurrence": {
      "frequency": "Second",
      "interval": 1
    },
    "splitOn": "@triggerBody()?.Rows"
}

이제 워크플로 정의에서 @triggerBody().name을 사용하여 첫 번째 실행에서 name, 두 번째 실행에서 "customer-name-one"에 해당하는 "customer-name-two" 값을 가져올 수 있습니다. 따라서 트리거 출력은 다음 예제와 같습니다.

{
   "body": {
      "id": 938109380,
      "name": "customer-name-one"
   }
}

{
   "body": {
      "id": 938109381,
      "name": "customer-name-two"
   }
}

Actions overview

Azure Logic Apps는 각각이 작업의 고유한 동작을 정의하는 다른 입력을 받는 다양한 작업 형식을 제공합니다. 작업에는 다음과 같은 상위 수준 요소가 있지만 일부는 선택 사항입니다.

"<action-name>": {
   "type": "<action-type>",
   "inputs": { 
      "<input-name>": { "<input-value>" },
      "retryPolicy": "<retry-behavior>" 
   },
   "runAfter": { "<previous-trigger-or-action-status>" },
   "runtimeConfiguration": { "<runtime-config-options>" },
   "operationOptions": "<operation-option>"
},

Required

Optional

작업 유형 목록

다음은 일반적으로 사용되는 몇 가지 작업 유형입니다.

• 기본 제공 작업 유형(다음 예제 참조)

  • HTTP for calling endpoints over HTTP or HTTPS

  • Response for responding to requests

  • JavaScript 코드 조각을 실행하기 위한 JavaScript 코드 실행

  • Function for calling Azure Functions

  • Data operation actions such as Join, Compose, Table, Select, and others that create or transform data from various inputs

  • Workflow for calling another logic app workflow

• Microsoft에서 관리하는 다양한 커넥터 및 API를 호출하는 ApiConnection 및 ApiConnectionWebHook과 같은 관리되는 API 작업 유형(예: Azure Service Bus, Office 365 Outlook, Power BI, Azure Blob Storage, OneDrive, GitHub 등)

• 다른 작업을 포함하고 워크플로 실행을 구성하는 데 도움이 되는 If, Foreach, Switch, Scope 및 Until과 같은 워크플로 작업 유형을 제어합니다.

Built-in actions

관리되는 API 작업

워크플로 작업 제어

이러한 작업은 워크플로 실행을 제어하고 다른 작업을 포함하는 데 도움이 됩니다. 제어 워크플로 작업 외부에서 해당 컨트롤 워크플로 작업 내에서 작업을 직접 참조할 수 있습니다. 예를 들어 범위 내에 작업이 있는 Http 경우 워크플로의 @body('Http') 어디에서나 식을 참조할 수 있습니다. 그러나 컨트롤 워크플로 작업 내에 있는 작업은 동일한 컨트롤 워크플로 구조에 있는 다른 작업만 "실행"할 수 있습니다.

작업 - 자세한 참조

APIConnection action

This action sends an HTTP request to a Microsoft-managed API and requires information about the API and parameters plus a reference to a valid connection.

"<action-name>": {
   "type": "ApiConnection",
   "inputs": {
      "host": {
         "connection": {
            "name": "@parameters('$connections')['<api-name>']['connectionId']"
         },
         "<other-action-specific-input-properties>"        
      },
      "method": "<method-type>",
      "path": "/<api-operation>",
      "retryPolicy": "<retry-behavior>",
      "queries": { "<query-parameters>" },
      "<other-action-specific-properties>"
    },
    "runAfter": {}
}

Required

Optional

Example

이 정의는 Microsoft 관리 API인 Office 365 Outlook 커넥터에 대한 전자 메일 보내기 작업을 설명합니다.

"Send_an_email": {
   "type": "ApiConnection",
   "inputs": {
      "body": {
         "Body": "Thank you for your membership!",
         "Subject": "Hello and welcome!",
         "To": "Sophie.Owen@contoso.com"
      },
      "host": {
         "connection": {
            "name": "@parameters('$connections')['office365']['connectionId']"
         }
      },
      "method": "POST",
      "path": "/Mail"
    },
    "runAfter": {}
}

APIConnectionWebhook action

This action sends a subscription request over HTTP to an endpoint by using a Microsoft-managed API, provides a callback URL to where the endpoint can send a response, and waits for the endpoint to respond. For more information, see Endpoint subscriptions.

"<action-name>": {
   "type": "ApiConnectionWebhook",
   "inputs": {
      "subscribe": {
         "method": "<method-type>",
         "uri": "<api-subscribe-URL>",
         "headers": { "<header-content>" },
         "body": "<body-content>",
         "authentication": { "<authentication-type>" },
         "retryPolicy": "<retry-behavior>",
         "queries": { "<query-parameters>" },
         "<other-action-specific-input-properties>"
      },
      "unsubscribe": {
         "method": "<method-type>",
         "uri": "<api-unsubscribe-URL>",
         "headers": { "<header-content>" },
         "body": "<body-content>",
         "authentication": { "<authentication-type>" },
         "<other-action-specific-properties>"
      },
   },
   "runAfter": {}
}

Some values, such as <method-type>, are available for both the "subscribe" and "unsubscribe" objects.

Required

Optional

You can also specify limits on an ApiConnectionWebhook action in the same way as HTTP asynchronous limits.

Compose action

이 작업은 식을 포함하여 여러 입력에서 단일 출력을 만듭니다. 출력 및 입력 둘 다 배열, JSON 개체, XML 및 이진 파일 등 Azure Logic Apps에서 기본적으로 지원하는 어떤 형식도 될 수 있습니다. 그런 후, 다른 작업에서 해당 작업의 출력을 사용할 수 있습니다.

"Compose": {
   "type": "Compose",
   "inputs": "<inputs-to-compose>",
   "runAfter": {}
},

Required

Example 1

이 작업 정의는 abcdefg 후행 공백 및 값 1234과 병합됩니다.

"Compose": {
   "type": "Compose",
   "inputs": "abcdefg 1234",
   "runAfter": {}
},

이 작업이 만드는 출력은 다음과 같습니다.

abcdefg 1234

Example 2

이 작업 정의는 다음을 포함하는 abcdefg 문자열 변수와 다음을 포함하는 정수 변수를 병합합니다.1234

"Compose": {
   "type": "Compose",
   "inputs": "@{variables('myString')}@{variables('myInteger')}",
   "runAfter": {}
},

이 작업이 만드는 출력은 다음과 같습니다.

"abcdefg1234"

Execute JavaScript Code 작업

이 작업은 JavaScript 코드 조각을 실행하고, 워크플로의 후속 작업에서 참조할 수 있는 토큰을 통해 결과를 반환합니다.

"Execute_JavaScript_Code": {
   "type": "JavaScriptCode",
   "inputs": {
      "code": "<JavaScript-code-snippet>",
      "explicitDependencies": {
         "actions": [ <preceding-actions> ],
         "includeTrigger": true
      }
   },
   "runAfter": {}
}

Required

경우에 따라 필요

이 특성은 explicitDependencies 트리거, 이전 작업 또는 둘 다의 결과를 코드 조각에 대한 종속성으로 명시적으로 포함하도록 지정합니다. 이러한 종속성을 추가하는 방법에 대한 자세한 내용은 인라인 코드 작업에 매개 변수로 종속성 추가를 참조하세요.

includeTrigger 특성의 경우 true 또는 false 값을 지정할 수 있습니다.

Example 1

이 작업은 논리 앱 워크플로의 이름을 가져오고 “Hello world from <logic-app-name>” 텍스트를 결과로 반환하는 코드를 실행합니다. 이 예제에서 코드는 읽기 전용 workflowContext.workflow.name 개체를 통해 속성에 workflowContext 액세스하여 워크플로의 이름을 참조합니다. 개체 사용에 대한 자세한 내용은 코드에서 workflowContext 참조 트리거 및 작업 결과를 참조하세요.

"Execute_JavaScript_Code": {
   "type": "JavaScriptCode",
   "inputs": {
      "code": "var text = \"Hello world from \" + workflowContext.workflow.name;\r\n\r\nreturn text;"
   },
   "runAfter": {}
}

Example 2

이 작업은 새 이메일이 Outlook 계정에 도착할 때 트리거되는 논리 앱 워크플로에서 코드를 실행합니다. 또한 워크플로는 승인 요청과 함께 받은 이메일의 콘텐츠를 전달하는 Office 365 Outlook 승인 이메일 보내기 작업을 사용합니다.

코드는 이메일 메시지의 Body 속성에서 이메일 주소를 추출하고, 승인 작업에서 SelectedOption 속성 값과 함께 주소를 반환합니다. 이 작업에는 개체 내의 actions 개체의 종속성으로 explicitDependencies 작업이 명시적으로 포함됩니다.

"Execute_JavaScript_Code": {
   "type": "JavaScriptCode",
   "inputs": {
      "code": "var myResult = /(([^<>()\\[\\]\\\\.,;:\\s@\"]+(\\.[^<>()\\[\\]\\\\.,;:\\s@\"]+)*)|(\".+\"))@((\\[[0-9]{1,3}\\.[0-9]{1,3}\\.[0-9]{1,3}\\.[0-9]{1,3}])|(([a-zA-Z\\-0-9]+\\.)+[a-zA-Z]{2,}))/g;\r\n\r\nvar email = workflowContext.trigger.outputs.body.Body;\r\n\r\nvar reply = workflowContext.actions.Send_approval_email.outputs.body.SelectedOption;\r\n\r\nreturn email.match(myResult) + \" - \" + reply;\r\n;",
      "explicitDependencies": {
         "actions": [
            "Send_approval_email"
         ]
      }
   },
   "runAfter": {}
}

Function action

This action calls a previously created Azure function.

"<Azure-function-name>": {
   "type": "Function",
   "inputs": {
     "function": {
        "id": "<Azure-function-ID>"
      },
      "method": "<method-type>",
      "headers": { "<header-content>" },
      "body": { "<body-content>" },
      "queries": { "<query-parameters>" } 
   },
   "runAfter": {}
}

Required

Optional

논리 앱을 저장하면 Azure Logic Apps는 참조된 함수에 대해 다음 검사를 수행합니다.

• 워크플로에 함수에 대한 액세스 권한이 있어야 합니다.

• 워크플로는 표준 HTTP 트리거 또는 일반 JSON 웹후크 트리거만 사용할 수 있습니다.

  Azure Logic Apps는 런타임에 사용되는 트리거의 URL을 가져오고 캐시합니다. However, if any operation invalidates the cached URL, the Function action fails at runtime. 이 문제를 해결하려면 논리 앱이 트리거 URL을 다시 가져오고 캐시할 수 있도록 논리 앱을 다시 저장합니다.

• 함수는 정의된 경로를 가질 수 없습니다.

• "function" 및 "anonymous" 권한 부여 수준만 허용됩니다.

Example

이 작업 정의는 이전에 만든 "GetProductID" 함수를 호출합니다.

"GetProductID": {
   "type": "Function",
   "inputs": {
     "function": {
        "id": "/subscriptions/<XXXXXXXXXXXXXXXXXXXX>/resourceGroups/myLogicAppResourceGroup/providers/Microsoft.Web/sites/InventoryChecker/functions/GetProductID"
      },
      "method": "POST",
      "headers": { 
          "x-ms-date": "@utcnow()"
       },
      "body": { 
          "Product_ID": "@variables('ProductID')"
      }
   },
   "runAfter": {}
}

HTTP action

이 작업은 지정된 HTTP 또는 HTTPS 엔드포인트에 요청을 보내고 응답을 확인하여 워크플로가 실행되는지 여부를 확인합니다. 자세한 내용은 Azure Logic Apps에서 HTTP 또는 HTTPS를 통해 서비스 엔드포인트 호출을 참조 하세요.

"HTTP": {
   "type": "Http",
   "inputs": {
      "method": "<method-type>",
      "uri": "<HTTP-or-HTTPS-endpoint-URL>",
      "headers": { "<header-content>" },
      "queries": { "<query-parameters>" },
      "body": "<body-content>",
      "authentication": { "<authentication-type-and-property-values>" },
      "retryPolicy": {
         "type": "<retry-behavior>"
      },
   },
   "runAfter": {}
}

Required

Optional

Example

이 작업 정의는 지정된 엔드포인트에 요청을 전송하여 최신 뉴스를 가져옵니다.

"HTTP": {
   "type": "Http",
   "inputs": {
      "method": "GET",
      "uri": "https://mynews.example.com/latest"
   }
}

Join action

이 작업은 배열의 모든 항목에서 문자열을 만들고 지정된 구분 기호 문자로 해당 항목을 구분합니다.

"Join": {
   "type": "Join",
   "inputs": {
      "from": <array>,
      "joinWith": "<delimiter>"
   },
   "runAfter": {}
}

Required

Example

이 정수 배열을 포함하는 이전에 만든 "myIntegerArray" 변수가 있다고 가정해 보겠습니다.

[1,2,3,4]

이 작업 정의는 식의 함수를 사용하여 variables() 변수에서 값을 가져오고 쉼표로 구분되는 값으로 이 문자열을 만듭니다. "1,2,3,4"

"Join": {
   "type": "Join",
   "inputs": {
      "from": "@variables('myIntegerArray')",
      "joinWith": ","
   },
   "runAfter": {}
}

JSON 구문 분석 작업

This action creates user-friendly fields or tokens from the properties in JSON content. 그런 다음 토큰을 대신 사용하여 논리 앱에서 이러한 속성에 액세스할 수 있습니다. 예를 들어 Azure Service Bus 및 Azure Cosmos DB와 같은 서비스의 JSON 출력을 사용하려는 경우 해당 출력의 데이터를 보다 쉽게 참조할 수 있도록 논리 앱에 이 작업을 포함할 수 있습니다.

"Parse_JSON": {
   "type": "ParseJson",
   "inputs": {
      "content": "<JSON-source>",
         "schema": { "<JSON-schema>" }
      },
      "runAfter": {}
},

Required

Example

This action definition creates these tokens that you can use in your workflow but only in actions that run following the Parse JSON action:

FirstName, LastName 및 Email

"Parse_JSON": {
   "type": "ParseJson",
   "inputs": {
      "content": {
         "Member": {
            "Email": "Sophie.Owen@contoso.com",
            "FirstName": "Sophie",
            "LastName": "Owen"
         }
      },
      "schema": {
         "type": "object",
         "properties": {
            "Member": {
               "type": "object",
               "properties": {
                  "Email": {
                     "type": "string"
                  },
                  "FirstName": {
                     "type": "string"
                  },
                  "LastName": {
                     "type": "string"
                  }
               }
            }
         }
      }
   },
   "runAfter": { }
},

이 예제에서 "content" 속성은 구문 분석할 작업에 대한 JSON 콘텐츠를 지정합니다. 스키마를 생성하기 위한 샘플 페이로드로 이 JSON 콘텐츠를 제공할 수도 있습니다.

"content": {
   "Member": { 
      "FirstName": "Sophie",
      "LastName": "Owen",
      "Email": "Sophie.Owen@contoso.com"
   }
},

"스키마" 속성은 JSON 콘텐츠를 설명하는 데 사용되는 JSON 스키마를 지정합니다.

"schema": {
   "type": "object",
   "properties": {
      "Member": {
         "type": "object",
         "properties": {
            "FirstName": {
               "type": "string"
            },
            "LastName": {
               "type": "string"
            },
            "Email": {
               "type": "string"
            }
         }
      }
   }
}

Query action

이 작업은 지정된 조건 또는 필터를 기반으로 다른 배열의 항목에서 배열을 만듭니다.

"Filter_array": {
   "type": "Query",
   "inputs": {
      "from": <array>,
      "where": "<condition-or-filter>"
   },
   "runAfter": {}
}

Required

Example

이 작업 정의는 지정된 값(2)보다 더 큰 값을 갖는 배열을 만듭니다.

"Filter_array": {
   "type": "Query",
   "inputs": {
      "from": [ 1, 3, 0, 5, 4, 2 ],
      "where": "@greater(item(), 2)"
   }
}

Response action

이 작업은 HTTP 요청에 대한 응답에 대한 페이로드를 만듭니다.

"Response" {
    "type": "Response",
    "kind": "http",
    "inputs": {
        "statusCode": 200,
        "headers": { <response-headers> },
        "body": { <response-body> }
    },
    "runAfter": {}
},

Required

Optional

Example

이 작업 정의는 지정된 상태 코드, 메시지 본문 및 메시지 헤더를 사용하여 HTTP 요청에 대한 응답을 만듭니다.

"Response": {
   "type": "Response",
   "inputs": {
      "statusCode": 200,
      "body": {
         "ProductID": 0,
         "Description": "Organic Apples"
      },
      "headers": {
         "x-ms-date": "@utcnow()",
         "content-type": "application/json"
      }
   },
   "runAfter": {}
}

Restrictions

Unlike other actions, the Response action has special restrictions:

• Your workflow can use the Response action only when the workflow starts with an HTTP request trigger, meaning your workflow must be triggered by an HTTP request.

• Your workflow can use the Response action anywhere except inside Foreach loops, Until loops, including sequential loops, and parallel branches.

• The original request gets your workflow's response only when all actions required by the Response action are finished within the HTTP timeout limit.

  그러나 워크플로가 다른 논리 앱을 중첩된 워크플로로 호출할 경우, 중첩된 워크플로가 완료되기 전에 얼마나 오랜 시간이 경과되는지에 관계없이 부모 워크플로는 중첩된 워크플로가 완료될 때까지 기다립니다.

• When your workflow uses the Response action and a synchronous response pattern, the workflow can't also use the splitOn command in the trigger definition because that command creates multiple runs. PUT 메서드가 사용되는 경우 이 경우를 확인하고 true이면 "잘못된 요청" 응답을 반환합니다.

  Otherwise, if your workflow uses the splitOn command and a Response action, the workflow runs asynchronously and immediately returns a "202 ACCEPTED" response.

• When your workflow's execution reaches the Response action, but the incoming request has already received a response, the Response action is marked as "Failed" due to the conflict. 따라서 논리 앱 실행도 "실패" 상태로 표시됩니다.

Select action

이 작업은 지정된 맵을 기준으로 다른 배열의 항목을 변형하여 JSON 개체를 포함하는 배열을 만듭니다. 출력 배열과 원본 배열은 항상 동일한 수의 항목을 갖습니다. 출력 배열의 개체 수는 변경할 수 없지만 해당 개체에서 속성 및 해당 값을 추가하거나 제거할 수 있습니다. 이 속성은 select 원본 배열의 항목을 변환하기 위한 맵을 정의하는 하나 이상의 키-값 쌍을 지정합니다. 키-값 쌍은 출력 배열의 모든 개체에서 속성과 해당 값을 나타냅니다.

"Select": {
   "type": "Select",
   "inputs": {
      "from": <array>,
      "select": { 
          "<key-name>": "<expression>",
          "<key-name>": "<expression>"        
      }
   },
   "runAfter": {}
},

Required

The Select action creates an array as output, so any action that wants to use this output must either accept an array, or you must convert the array into the type that the consumer action accepts. For example, to convert the output array to a string, you can pass that array to the Compose action, and then reference the output from the Compose action in your other actions.

Example

이 작업 정의는 정수 배열에서 JSON 개체 배열을 만듭니다. 이 작업은 원본 배열을 반복하고 식을 사용하여 @item() 각 정수 값을 가져오며 각 JSON 개체의 "number" 속성에 각 값을 할당합니다.

"Select": {
   "type": "Select",
   "inputs": {
      "from": [ 1, 2, 3 ],
      "select": { 
         "number": "@item()" 
      }
   },
   "runAfter": {}
},

이 작업이 만드는 배열은 다음과 같습니다.

[ { "number": 1 }, { "number": 2 }, { "number": 3 } ]

To use this array output in other actions, pass this output into a Compose action:

"Compose": {
   "type": "Compose",
   "inputs": "@body('Select')",
   "runAfter": {
      "Select": [ "Succeeded" ]
   }
},

You can then use the output from the Compose action in your other actions, for example, the Office 365 Outlook - Send an email action:

"Send_an_email": {
   "type": "ApiConnection",
   "inputs": {
      "body": {
         "Body": "@{outputs('Compose')}",
         "Subject": "Output array from Select and Compose actions",
         "To": "<your-email@___domain>"
      },
      "host": {
         "connection": {
            "name": "@parameters('$connections')['office365']['connectionId']"
         }
      },
      "method": "post",
      "path": "/Mail"
   },
   "runAfter": {
      "Compose": [ "Succeeded" ]
   }
},

Table action

이 작업은 배열에서 CSV 또는 HTML 테이블을 만듭니다. JSON 개체가 있는 배열의 경우, 이 작업은 개체의 속성 이름에서 열 머리글을 자동으로 만듭니다. 기타 데이터 형식을 갖는 배열의 경우 열 머리글과 값을 지정해야 합니다. 예를 들어 이 배열에는 이 작업이 열 머리글 이름에 사용할 수 있는 "ID" 및 "Product_Name" 속성이 포함됩니다.

[ {"ID": 0, "Product_Name": "Apples"}, {"ID": 1, "Product_Name": "Oranges"} ]

"Create_<CSV | HTML>_table": {
   "type": "Table",
   "inputs": {
      "format": "<CSV | HTML>",
      "from": <array>,
      "columns": [ 
         {
            "header": "<column-name>",
            "value": "<column-value>"
         },
         {
            "header": "<column-name>",
            "value": "<column-value>"
         } 
      ]
   },
   "runAfter": {}
}

Required

Optional

열 머리글 및 값을 지정하거나 사용자 지정하려면 배열을 columns 사용합니다. 쌍의 헤더 이름이 같으면 header-value 해당 값이 해당 헤더 이름 아래의 동일한 열에 표시됩니다. 그렇지 않으면 각 고유 헤더는 고유한 열을 정의합니다.

Example 1

현재 이 배열이 포함된 이전에 만든 "myItemArray" 변수가 있다고 가정합니다.

[ {"ID": 0, "Product_Name": "Apples"}, {"ID": 1, "Product_Name": "Oranges"} ]

이 작업 정의는 "myItemArray" 변수에서 CSV 테이블을 만듭니다. 속성에서 from 사용하는 식은 함수를 사용하여 "myItemArray"에서 배열을 variables() 가져옵니다.

"Create_CSV_table": {
   "type": "Table",
   "inputs": {
      "format": "CSV",
      "from": "@variables('myItemArray')"
   },
   "runAfter": {}
}

이 작업이 만드는 CSV 테이블은 다음과 같습니다.

ID,Product_Name 
0,Apples 
1,Oranges 

Example 2

이 작업 정의는 "myItemArray" 변수에서 HTML 테이블을 만듭니다. 속성에서 from 사용하는 식은 함수를 사용하여 "myItemArray"에서 배열을 variables() 가져옵니다.

"Create_HTML_table": {
   "type": "Table",
   "inputs": {
      "format": "HTML",
      "from": "@variables('myItemArray')"
   },
   "runAfter": {}
}

이 작업이 만드는 HTML 테이블은 다음과 같습니다.

Example 3

이 작업 정의는 "myItemArray" 변수에서 HTML 테이블을 만듭니다. 그러나 이 예제에서는 기본 열 머리글 이름을 "Stock_ID" 및 "Description"으로 재정의하고 "Description" 열의 값에 "Organic"이라는 단어를 추가합니다.

"Create_HTML_table": {
   "type": "Table",
   "inputs": {
      "format": "HTML",
      "from": "@variables('myItemArray')",
      "columns": [ 
         {
            "header": "Stock_ID",
            "value": "@item().ID"
         },
         {
            "header": "Description",
            "value": "@concat('Organic ', item().Product_Name)"
         }
      ]
    },
   "runAfter": {}
},

이 작업이 만드는 HTML 테이블은 다음과 같습니다.

Terminate action

이 작업은 워크플로 인스턴스에 대한 실행을 중지하고, 진행 중인 작업을 취소하고, 나머지 작업을 건너뛰고, 지정된 상태를 반환합니다. For example, you can use the Terminate action when your logic app must exit completely from an error state. This action doesn't affect already completed actions and can't appear inside Foreach and Until loops, including sequential loops.

"Terminate": {
   "type": "Terminate",
   "inputs": {
       "runStatus": "<status>",
       "runError": {
            "code": "<error-code-or-name>",
            "message": "<error-message>"
       }
   },
   "runAfter": {}
}

Required

Optional

"runError" 개체의 속성은 "runStatus" 속성이 "Failed" 상태로 설정된 경우에만 적용됩니다.

Example

이 작업 정의는 워크플로 실행을 중지하고, 실행 상태를 "실패"로 설정하고, 상태, 오류 코드 및 오류 메시지를 반환합니다.

"Terminate": {
    "type": "Terminate",
    "inputs": {
        "runStatus": "Failed",
        "runError": {
            "code": "Unexpected response",
            "message": "The service received an unexpected response. Please try again."
        }
   },
   "runAfter": {}
}

Wait action

이 작업은 지정된 간격 또는 지정된 시간까지 워크플로 실행을 일시 중지하지만 둘 다 일시 중지하지는 않습니다.

Specified interval

"Delay": {
   "type": "Wait",
   "inputs": {
      "interval": {
         "count": <number-of-units>,
         "unit": "<interval>"
      }
   },
   "runAfter": {}
},

Specified time

"Delay_until": {
   "type": "Wait",
   "inputs": {
      "until": {
         "timestamp": "<date-time-stamp>"
      }
   },
   "runAfter": {}
},

Required

Example 1

이 작업 정의는 워크플로를 15분 동안 일시 중지합니다.

"Delay": {
   "type": "Wait",
   "inputs": {
      "interval": {
         "count": 15,
         "unit": "Minute"
      }
   },
   "runAfter": {}
},

Example 2

이 작업 정의는 지정된 시간까지 워크플로를 일시 중지합니다.

"Delay_until": {
   "type": "Wait",
   "inputs": {
      "until": {
         "timestamp": "2017-10-01T00:00:00Z"
      }
   },
   "runAfter": {}
},

Workflow action

이 작업은 이전에 만든 다른 논리 앱을 호출합니다. 즉, 다른 논리 앱 워크플로를 포함하고 다시 사용할 수 있습니다. You can also use the outputs from the child or nested logic app in actions that follow the nested logic app, provided that the child logic app returns a response.

Azure Logic Apps는 호출하려는 트리거에 대한 액세스를 확인하므로 해당 트리거에 액세스할 수 있는지 확인합니다. 또한 중첩된 논리 앱은 다음 조건을 충족해야 합니다.

• A trigger makes the nested logic app callable, such as a Request or HTTP trigger

• 부모 논리 앱과 동일한 Azure 구독

• To use the outputs from the nested logic app in your parent logic app, the nested logic app must have a Response action

"<nested-logic-app-name>": {
   "type": "Workflow",
   "inputs": {
      "body": { "<body-content" },
      "headers": { "<header-content>" },
      "host": {
         "triggerName": "<trigger-name>",
         "workflow": {
            "id": "/subscriptions/<Azure-subscription-ID>/resourceGroups/<Azure-resource-group>/providers/Microsoft.Logic/<nested-logic-app-name>"
         }
      }
   },
   "runAfter": {}
}

Required

Optional

Outputs

이 작업의 출력은 중첩된 논리 앱의 응답 작업에 따라 달라집니다. 중첩된 논리 앱에 응답 작업이 포함되지 않으면 출력이 비어 있습니다.

Example

"Start_search" 작업이 성공적으로 완료되면 이 워크플로 작업 정의는 지정된 입력을 전달하는 "Get_product_information"이라는 다른 논리 앱을 호출합니다.

"actions": {
   "Start_search": { <action-definition> },
   "Get_product_information": {
      "type": "Workflow",
      "inputs": {
         "body": {
            "ProductID": "24601",
         },
         "host": {
            "id": "/subscriptions/XXXXXXXXXXXXXXXXXXXXXXXXXX/resourceGroups/InventoryManager-RG/providers/Microsoft.Logic/Get_product_information",
            "triggerName": "Find_product"
         },
         "headers": {
            "content-type": "application/json"
         }
      },
      "runAfter": { 
         "Start_search": [ "Succeeded" ]
      }
   }
},

워크플로 작업 세부 정보 제어

Foreach action

이 반복 작업은 배열을 반복하고 각 배열 항목에 대해 작업을 수행합니다. 기본적으로 "for each" 루프는 최대 루프 수까지 병렬로 실행됩니다. 이 최대값은 제한 및 구성을 참조 하세요. "for each" 루프를 만드는 방법을 알아봅니 다.

"For_each": {
   "type": "Foreach",
   "actions": { 
      "<action-1>": { "<action-definition-1>" },
      "<action-2>": { "<action-definition-2>" }
   },
   "foreach": "<for-each-expression>",
   "runAfter": {},
   "runtimeConfiguration": {
      "concurrency": {
         "repetitions": <count>
      }
    },
    "operationOptions": "<operation-option>"
}

Required

Optional

Example

이 "for each" 루프는 들어오는 전자 메일의 첨부 파일이 포함된 배열의 각 항목에 대한 전자 메일을 보냅니다. 루프는 첨부 파일을 포함하는 이메일을 첨부 파일을 검토하는 사람에게 전송합니다.

"For_each": {
   "type": "Foreach",
   "actions": {
      "Send_an_email": {
         "type": "ApiConnection",
         "inputs": {
            "body": {
               "Body": "@base64ToString(items('For_each')?['Content'])",
               "Subject": "Review attachment",
               "To": "Sophie.Owen@contoso.com"
                },
            "host": {
               "connection": {
                  "id": "@parameters('$connections')['office365']['connectionId']"
               }
            },
            "method": "post",
            "path": "/Mail"
         },
         "runAfter": {}
      }
   },
   "foreach": "@triggerBody()?['Attachments']",
   "runAfter": {}
}

To specify only an array that is passed as output from the trigger, this expression gets the <array-name> array from the trigger body. 배열이 없는 경우 오류를 방지하기 위해 식은 연산자를 ? 사용합니다.

@triggerBody()?['<array-name>']

If action

This action, which is a conditional statement, evaluates an expression that represents a condition and runs a different branch based on whether the condition is true or false. 조건이 true이면 해당 조건은 “Succeeded” 상태로 표시됩니다. 조건문을 만드는 방법을 알아봅니 다.

"Condition": {
   "type": "If",
   "expression": { "<condition>" },
   "actions": {
      "<action-1>": { "<action-definition>" }
   },
   "else": {
      "actions": {
        "<action-2>": { "<action-definition" }
      }
   },
   "runAfter": {}
}

또는 actions 개체의 else 작업은 다음 상태를 가져옵니다.

• "성공" - 성공적으로 실행되는 경우
• 실행 및 실패 시 "실패"
• 해당 분기가 실행되지 않는 경우 "건너뛰기"

Example

이 조건은 정수 변수의 값이 0보다 큰 경우 워크플로가 웹 사이트를 확인한다고 지정합니다. 변수가 0 이하이면 워크플로는 다른 웹 사이트를 확인합니다.

"Condition": {
   "type": "If",
   "expression": {
      "and": [ {
         "greater": [ "@variables('myIntegerVariable')", 0 ] 
      } ]
   },
   "actions": { 
      "HTTP - Check this website": {
         "type": "Http",
         "inputs": {
         "method": "GET",
            "uri": "http://this-url"
         },
         "runAfter": {}
      }
   },
   "else": {
      "actions": {
         "HTTP - Check this other website": {
            "type": "Http",
            "inputs": {
               "method": "GET",
               "uri": "http://this-other-url"
            },
            "runAfter": {}
         }
      }
   },
   "runAfter": {}
}

조건이 식을 사용하는 방법

다음은 조건에서 식을 사용하는 방법을 보여 주는 몇 가지 예입니다.

Scope action

This action logically groups actions into scopes, which get their own status after the actions in that scope finish running. 그런 후에는 범위의 상태를 사용하여 다른 작업의 실행 여부를 확인할 수 있습니다. 범위를 만드는 방법을 알아봅니 다.

"Scope": {
   "type": "Scope",
   "actions": {
      "<inner-action-1>": {
         "type": "<action-type>",
         "inputs": { "<action-inputs>" },
         "runAfter": {}
      },
      "<inner-action-2>": {
         "type": "<action-type>",
         "inputs": { "<action-inputs>" },
         "runAfter": {}
      }
   }
}

Required

Switch action

This action, also known as a switch statement, organizes other actions into cases, and assigns a value to each case, except for the default case if one exists. When your workflow runs, the Switch action compares the value from an expression, object, or token against the values specified for each case. If the Switch action finds a matching case, your workflow runs only the actions for that case. Each time the Switch action runs, either only one matching case exists or no matches exist. If no matches exist, the Switch action runs the default actions. switch 문을 만드는 방법을 알아봅니 다.

"Switch": {
   "type": "Switch",
   "expression": "<expression-object-or-token>",
   "cases": {
      "Case": {
         "actions": {
           "<action-name>": { "<action-definition>" }
         },
         "case": "<matching-value>"
      },
      "Case_2": {
         "actions": {
           "<action-name>": { "<action-definition>" }
         },
         "case": "<matching-value>"
      }
   },
   "default": {
      "actions": {
         "<default-action-name>": { "<default-action-definition>" }
      }
   },
   "runAfter": {}
}

Required

Optional

Example

이 작업 정의는 승인 요청 이메일에 응답하는 사람이 "승인" 옵션 또는 "거부" 옵션을 선택했는지 여부를 평가합니다. Based on this choice, the Switch action runs the actions for the matching case, which is to send another email to the responder but with different wording in each case.

"Switch": {
   "type": "Switch",
   "expression": "@body('Send_approval_email')?['SelectedOption']",
   "cases": {
      "Case": {
         "actions": {
            "Send_an_email": { 
               "type": "ApiConnection",
               "inputs": {
                  "Body": "Thank you for your approval.",
                  "Subject": "Response received", 
                  "To": "Sophie.Owen@contoso.com"
               },
               "host": {
                  "connection": {
                     "name": "@parameters('$connections')['office365']['connectionId']"
                  }
               },
               "method": "post",
               "path": "/Mail"
            },
            "runAfter": {}
         },
         "case": "Approve"
      },
      "Case_2": {
         "actions": {
            "Send_an_email_2": { 
               "type": "ApiConnection",
               "inputs": {
                  "Body": "Thank you for your response.",
                  "Subject": "Response received", 
                  "To": "Sophie.Owen@contoso.com"
               },
               "host": {
                  "connection": {
                     "name": "@parameters('$connections')['office365']['connectionId']"
                  }
               },
               "method": "post",
               "path": "/Mail"
            },
            "runAfter": {}     
         },
         "case": "Reject"
      }
   },
   "default": {
      "actions": { 
         "Send_an_email_3": { 
            "type": "ApiConnection",
            "inputs": {
               "Body": "Please respond with either 'Approve' or 'Reject'.",
               "Subject": "Please respond", 
               "To": "Sophie.Owen@contoso.com"
            },
            "host": {
               "connection": {
                  "name": "@parameters('$connections')['office365']['connectionId']"
               }
            },
            "method": "post",
            "path": "/Mail"
         },
         "runAfter": {} 
      }
   },
   "runAfter": {
      "Send_approval_email": [ 
         "Succeeded"
      ]
   }
}

Until action

이 루프 작업은 지정된 조건이 충족될 때까지 실행되는 작업을 포함합니다. 이 루프는 다른 모든 작업이 실행된 후에 마지막 단계로서 해당 조건을 확인합니다. 개체에 "actions" 둘 이상의 작업을 포함할 수 있으며 작업은 하나 이상의 제한을 정의해야 합니다. "until" 루프를 만드는 방법을 알아봅니 다.

 "Until": {
   "type": "Until",
   "actions": {
      "<action-name>": {
         "type": "<action-type>",
         "inputs": { "<action-inputs>" },
         "runAfter": {}
      },
      "<action-name>": {
         "type": "<action-type>",
         "inputs": { "<action-inputs>" },
         "runAfter": {}
      }
   },
   "expression": "<condition>",
   "limit": {
      "count": <loop-count>,
      "timeout": "<loop-timeout>"
   },
   "runAfter": {}
}

Example

이 루프 작업 정의는 다음 조건 중 하나가 충족될 때까지 지정된 URL에 HTTP 요청을 보냅니다.

• 요청은 "200 OK" 상태 코드가 포함된 응답을 가져옵니다.
• 루프가 60번 실행되었습니다.
• 루프가 1시간 동안 실행되었습니다.

 "Run_until_loop_succeeds_or_expires": {
    "type": "Until",
    "actions": {
        "HTTP": {
            "type": "Http",
            "inputs": {
                "method": "GET",
                "uri": "http://myurl"
            },
            "runAfter": {}
        }
    },
    "expression": "@equals(outputs('HTTP')['statusCode'], 200)",
    "limit": {
        "count": 60,
        "timeout": "PT1H"
    },
    "runAfter": {}
}

웹후크 및 구독

웹후크 기반 트리거 및 작업은 엔드포인트을 주기적으로 검사하지 않지만, 대신 해당 엔드포인트의 특정 이벤트 또는 데이터를 기다립니다. These triggers and actions subscribe to the endpoints by providing a callback URL where the endpoint can send responses.

subscribe 호출은 워크플로가 어떤 방식으로든 변경될 때(예: 자격 증명이 갱신되거나 트리거 또는 작업의 입력 매개 변수가 변경될 때) 발생합니다. 이 호출은 표준 HTTP 작업과 동일한 매개 변수를 사용합니다.

unsubscribe 예를 들어 작업이 트리거 또는 작업을 유효하지 않은 경우 호출이 자동으로 수행됩니다.

• 트리거를 삭제하거나 사용하지 않도록 설정
• 워크플로를 삭제하거나 사용하지 않도록 설정
• 구독을 삭제하거나 사용하지 않도록 설정

이러한 호출을 지원하기 위해 식은 @listCallbackUrl() 트리거 또는 작업에 대한 고유한 "콜백 URL"을 반환합니다. 이 URL은 서비스의 REST API를 사용하는 엔드포인트에 대한 고유 식별자를 나타냅니다. 이 함수의 매개 변수는 웹후크 트리거 또는 작업과 동일합니다.

비동기 기간 변경

트리거와 작업 모두에 대해 속성을 추가하여 limit.timeout 비동기 패턴의 기간을 특정 시간 간격으로 제한할 수 있습니다. 이렇게 하면 간격이 경과할 때 작업이 완료되지 않은 경우 작업의 상태가 코드와 함께 CancelledActionTimedOut 표시됩니다. 이 속성은 timeout ISO 8601 형식을 사용합니다.

"<trigger-or-action-name>": {
   "type": "Workflow | Webhook | Http | ApiConnectionWebhook | ApiConnection",
   "inputs": {},
   "limit": {
      "timeout": "PT10S"
   },
   "runAfter": {}
}

런타임 구성 설정

트리거 또는 작업 정의에 이러한 runtimeConfiguration 속성을 추가하여 트리거 및 작업에 대한 기본 런타임 동작을 변경할 수 있습니다.

Operation options

트리거 또는 작업 정의에서 속성을 사용하여 트리거 및 작업에 대한 기본 동작을 operationOptions 변경할 수 있습니다.

트리거 동시성 변경경

기본적으로 논리 앱 워크플로 인스턴스는 모두 동시에(동시 또는 병렬로) 실행됩니다. 이 동작은 이전에 활성 상태였던 워크플로 인스턴스의 실행이 완료되기 전에 각 트리거 인스턴스가 발생한다는 것을 의미합니다. However, the number of concurrently running instances has a default limit. 동시에 실행되는 워크플로 인스턴스의 수가 이 제한에 도달하면 다른 새 인스턴스가 실행될 때까지 기다려야 합니다. 이 제한은 백 엔드 시스템에서 수신하는 요청 수를 제한하는 데 도움이 됩니다.

When you turn on the trigger's concurrency control, trigger instances run in parallel up to the default limit. 이 기본 동시성 제한을 변경하려면 디자이너를 통해 동시성 설정을 변경하면 기본 트리거 정의에서 속성을 추가하거나 업데이트 runtimeConfiguration.concurrency.runs 하고 그 반대의 경우도 마찬가지이므로 코드 뷰 편집기 또는 워크플로 디자이너를 사용할 수 있습니다. 이 속성은 병렬로 실행할 수 있는 새 워크플로 인스턴스의 최대 수를 제어합니다.

트리거에서 동시성을 사용하도록 설정하기 전에 다음 고려 사항을 검토합니다.

• 동시성 제어를 사용하도록 설정한 후에는 동시성을 사용하지 않도록 설정할 수 없습니다.

• 최대 동시 트리거 실행 수가 최대 병렬 처리 정도에 도달하면 후속 트리거 실행에서 제한 또는 "429 - 너무 많은 요청" 오류가 발생할 수 있습니다. 429 오류를 처리하는 재시도 정책을 설정하는 경우 트리거에서 새 트리거 요청 처리에 긴 지연을 초래하는 재시도 및 제한 동작의 주기가 발생할 수 있습니다.

• When concurrency is enabled, the SplitOn limit is significantly reduced for debatching arrays. 항목 수가 이 제한을 초과하면 SplitOn 기능이 사용하지 않도록 설정됩니다.

• 동시성이 사용하도록 설정되면 장기 실행 논리 앱 인스턴스로 인해 새 논리 앱 인스턴스가 대기 중 상태로 전환될 수 있습니다. 이 상태는 Azure Logic Apps가 새 인스턴스를 만들지 못하게 하며 동시 실행 수가 지정된 최대 동시 실행 수보다 작은 경우에도 발생합니다.

  • To interrupt this state, cancel the earliest instances that are still running.

    1. On your logic app's menu, select Overview.

    2. In the Runs history section, select the earliest instance that is still running, for example:

       

       Tip

       To view only instances that are still running, open the All list, and select Running.

    3. 논리 앱 실행에서 실행 취소를 선택합니다.

       

  • 이 가능성을 해결하려면 이러한 실행을 보류할 수 있는 모든 작업에 시간 제한을 추가합니다. 코드 편집기에서 작업하는 경우 비동기 기간 변경을 참조하세요. 그렇지 않은 경우 디자이너를 사용하는 경우 다음 단계를 수행합니다.

    1. 논리 앱 워크플로에서 시간 제한을 추가할 작업을 선택합니다. In the action's upper-right corner, select the ellipses (...) button, and then select Settings.

       

    2. Under Timeout, specify the timeout duration in ISO 8601 format.

       

• 논리 앱을 순차적으로 실행하려면 코드 뷰 편집기 또는 디자이너를 1 사용하여 트리거의 동시성을 설정합니다. 또한 코드 뷰 편집기에서 트리거의 operationOptions 속성을 SingleInstance 설정하지 않았는지 확인합니다. 그렇지 않으면 유효성 검사 오류가 발생합니다. 자세한 내용은 트리거 인스턴스를 순차적으로 참조 하세요.

코드 보기에서 편집

기본 트리거 정의에서 속성을 추가하고 runtimeConfiguration.concurrency.runs 트리거 동시성 제한에 따라 값을 설정합니다. 워크플로를 순차적으로 실행하려면 속성 값을 1.로 설정합니다.

이 예제에서는 동시 실행을 10개의 인스턴스로 제한합니다.

"<trigger-name>": {
   "type": "<trigger-name>",
   "recurrence": {
      "frequency": "<time-unit>",
      "interval": <number-of-time-units>,
   },
   "runtimeConfiguration": {
      "concurrency": {
         "runs": 10
      }
   }
}

자세한 내용은 런타임 구성 설정을 참조 하세요.

워크플로 디자이너에서 편집

1. In the trigger's upper-right corner, select the ellipses (...) button, and then select Settings.

2. Under Concurrency Control, set Limit to On.

3. 병렬 처리 수준 슬라이더를 원하는 값으로 끌어옵니다. To run your logic app sequentially, drag the slider value to 1.

"for each" 동시성 변경

기본적으로 "for each" 루프 반복은 모두 동시에(동시 또는 병렬로) 실행됩니다. 이 동작은 이전 반복 실행이 완료되기 전에 각 반복이 실행되기 시작한다는 것을 의미합니다. However, the number of concurrently running iterations has a default limit. 동시에 실행 중인 반복 수가 이 제한에 도달하면 다른 모든 반복이 실행되기를 기다려야 합니다.

기본 제한을 변경하려면 디자이너를 통해 동시성 설정을 변경하면 기본 "for each" 작업 정의의 속성이 추가되거나 업데이트 runtimeConfiguration.concurrency.repetitions 되고 그 반대의 경우도 마찬가지이므로 코드 뷰 편집기 또는 워크플로 디자이너를 사용할 수 있습니다. 이 속성은 병렬로 실행할 수 있는 최대 반복 수를 제어합니다.

코드 보기에서 편집

기본 "for each" 정의에서 runtimeConfiguration.concurrency.repetitions~1 범위의 값일 수 있는 50 속성을 추가하거나 업데이트합니다.

동시 실행 수를 10번 반복으로 제한하는 예제는 다음과 같습니다.

"For_each" {
   "type": "Foreach",
   "actions": { "<actions-to-run>" },
   "foreach": "<for-each-expression>",
   "runAfter": {},
   "runtimeConfiguration": {
      "concurrency": {
         "repetitions": 10
      }
   }
}

자세한 내용은 런타임 구성 설정을 참조 하세요.

워크플로 디자이너에서 편집

1. In the For each action, from the upper-right corner, select the ellipses (...) button, and then select Settings.

2. Under Concurrency Control, set Concurrency Control to On.

3. 병렬 처리 수준 슬라이더를 원하는 값으로 끌어옵니다. To run your logic app sequentially, drag the slider value to 1.

실행 대기 제한 변경

기본적으로 논리 앱 워크플로 인스턴스는 모두 동시에(동시 또는 병렬로) 실행됩니다. 이 동작은 이전에 활성 상태였던 워크플로 인스턴스의 실행이 완료되기 전에 각 트리거 인스턴스가 발생한다는 것을 의미합니다. However, a default limit exists on the number of concurrently running workflow instances. 동시 실행 수가 이 제한에 도달하면 다른 모든 새 워크플로 인스턴스가 실행되기를 기다려야 합니다. A default limit also exists on the number of waiting workflow instances. 대기 중인 인스턴스 수가 이 제한에 도달하면 Azure Logic Apps는 더 이상 실행할 새 워크플로 인스턴스를 허용하지 않습니다. 요청 및 웹후크 트리거는 429를 반환 합니다. 요청 오류가 너무 많고 되풀이 트리거가 폴링 시도를 건너뛰기 시작합니다.

트리거 동시성에 대한 기본 제한과 대기 중인 실행에 대한 기본 제한을 변경할 수 있습니다. 그러나 이러한 변경은 주로 동시성으로 인한 압력을 완화하기 위해 트리거를 느리게 합니다. 예를 들어 폴링 트리거가 있고 진행 중인 실행으로 인해 대기 중인 실행 큐가 가득 차면 Azure Logic Apps에서 폴링을 중지합니다. 워크플로에서 요청 기반 트리거를 사용하고 대기 중인 실행 큐가 가득 차면 Azure Logic Apps에서 429 오류를 반환하기 시작합니다. Azure Logic Apps가 오류를 발생시키지 않고 트리거를 폴링에서 중지할 수 없고 호출 실행에 실패하지 않고 대기 중인 실행 큐에 이러한 실행을 추가하도록 선택하는 일부 시나리오가 있습니다.

기본 트리거 정의에서 범위가 runtimeConfiguration.concurrency.maximumWaitingRuns 되는 값을 가질 수 있는 속성을 추가합니다 1100.

"<trigger-name>": {
   "type": "<trigger-name>",
   "recurrence": {
      "frequency": "<time-unit>",
      "interval": <number-of-time-units>,
   },
   "runtimeConfiguration": {
      "concurrency": {
         "maximumWaitingRuns": 50
      }
   }
}

자세한 내용은 런타임 구성 설정을 참조 하세요.

인스턴스를 순차적으로 트리거

이전 인스턴스의 실행이 완료된 후에만 각 논리 앱 워크플로 인스턴스를 실행하려면 순차적으로 실행되도록 트리거를 설정합니다. 디자이너를 통해 동시성 설정을 변경하면 기본 트리거 정의의 속성도 추가 또는 업데이트 runtimeConfiguration.concurrency.runs 되고 그 반대의 경우도 마찬가지이므로 코드 뷰 편집기 또는 워크플로 디자이너를 사용할 수 있습니다.

코드 보기에서 편집

트리거 정의에서 이러한 속성 중 하나를 설정하지만 둘 다 설정하지는 않습니다.

속성을 다음으로 runtimeConfiguration.concurrency.runs1설정합니다.

"<trigger-name>": {
   "type": "<trigger-name>",
   "recurrence": {
      "frequency": "<time-unit>",
      "interval": <number-of-time-units>,
   },
   "runtimeConfiguration": {
      "concurrency": {
         "runs": 1
      }
   }
}

-or-

속성을 다음으로 operationOptionsSingleInstance설정합니다.

"<trigger-name>": {
   "type": "<trigger-name>",
   "recurrence": {
      "frequency": "<time-unit>",
      "interval": <number-of-time-units>,
   },
   "operationOptions": "SingleInstance"
}

자세한 내용은 런타임 구성 설정 및 작업 옵션을 참조하세요.

워크플로 디자이너에서 편집

1. In the trigger's upper-right corner, select the ellipses (...) button, and then select Settings.

2. Under Concurrency Control, set Limit to On.

3. 병렬 처리 수준 슬라이더를 숫자1로 끕다.

"for each" 루프를 순차적으로 실행

이전 반복 실행이 완료된 후에만 "for each" 루프 반복을 실행하려면 "for each" 작업을 순차적으로 실행하도록 설정합니다. 디자이너를 통해 작업의 동시성을 변경하면 기본 작업 정의에서 속성을 추가하거나 업데이트 runtimeConfiguration.concurrency.repetitions 하고 그 반대의 경우도 마찬가지이므로 코드 뷰 편집기 또는 워크플로 디자이너를 사용할 수 있습니다.

코드 보기에서 편집

작업 정의에서 다음 속성 중 하나만 설정합니다.

속성을 다음으로 runtimeConfiguration.concurrency.repetitions1설정합니다.

"For_each" {
   "type": "Foreach",
   "actions": { "<actions-to-run>" },
   "foreach": "<for-each-expression>",
   "runAfter": {},
   "runtimeConfiguration": {
      "concurrency": {
         "repetitions": 1
      }
   }
}

-or-

속성을 다음으로 operationOptionsSequential설정합니다.

"For_each" {
   "type": "Foreach",
   "actions": { "<actions-to-run>" },
   "foreach": "<for-each-expression>",
   "runAfter": {},
   "operationOptions": "Sequential"
}

자세한 내용은 런타임 구성 설정 및 작업 옵션을 참조하세요.

워크플로 디자이너에서 편집

1. In the For each action's upper-right corner, select the ellipses (...) button, and then select Settings.

2. Under Concurrency Control, set Concurrency Control to On.

3. 병렬 처리 수준 슬라이더를 숫자1로 끕다.

동기 작업 패턴에서 작업 실행

기본적으로 Azure Logic Apps의 HTTP 작업 및 APIConnection 작업은 표준 비동기 작업 패턴을 따르는 반면 응답 작업은 동기 작업 패턴을 따릅니다. The asynchronous pattern specifies that after an action calls or sends a request to the specified endpoint, service, system, or API, the receiver immediately returns a "202 ACCEPTED" response. 이 코드는 수신기에서 요청을 수락했지만 처리가 완료되지 않았음을 확인합니다. The response can include a ___location header that specifies the URL and a refresh ID that the caller can use to continually poll or check the status for the asynchronous request until the receiver stops processing and returns a "200 OK" success response or other non-202 response. 자세한 내용은 비동기 마이크로서비스 통합에 마이크로서비스 자율성 적용을 참조하세요.

• In the Logic App Designer, the HTTP action, APIConnection actions, and Response action have the Asynchronous Pattern setting. 이 설정이 사용하도록 설정되면 호출자에서 처리가 완료될 때까지 기다리지 않고 다음 작업으로 이동할 수 있지만 처리가 중지될 때까지 상태를 계속 확인하도록 지정합니다. 이 설정이 사용하지 않도록 설정되면 호출자에서 처리가 완료될 때까지 기다린 후에 다음 작업으로 이동하도록 지정합니다. 이 설정을 찾으려면 다음 단계를 수행합니다.

  1. On the HTTP action's title bar, select the ellipses (...) button, which opens the action's settings.

  2. Find the Asynchronous Pattern setting.

     

• 작업의 기본 JSON(JavaScript Object Notation) 정의에서 HTTP 작업 및 APIConnection 작업은 비동기 작업 패턴을 암시적으로 따릅니다.

일부 시나리오에서는 대신 동작이 동기 패턴을 따르도록 할 수 있습니다. 예를 들어 HTTP 작업을 사용하는 경우 다음을 수행할 수 있습니다.

• 장기 실행 작업에 대한 HTTP 시간 제한 방지
• 위치 헤더 확인을 사용하지 않도록 설정

이러한 경우 다음 옵션을 사용하여 작업을 동기적으로 실행할 수 있습니다.

• 사용 가능한 경우 해당 작업의 폴링 버전을 웹후크 버전으로 바꿉니다.

• 다음 옵션 중 하나를 수행하여 작업의 비동기 동작을 사용하지 않도록 설정합니다.

  • Logic Apps 디자이너에서 비동기 패턴 설정을 해제합니다.

  • 작업의 기본 JSON 정의"DisableAsyncPattern" 추가 합니다.

Turn off Asynchronous Pattern setting

1. In the Logic App Designer, on the action's title bar, select the ellipses (...) button, which opens the action's settings.

2. Find the Asynchronous Pattern setting, turn the setting to Off if enabled, and select Done.

   

작업의 JSON 정의에서 비동기 패턴을 사용하지 않도록 설정

In the action's underlying JSON definition, add and set the "operationOptions" property to "DisableAsyncPattern" under the action's "inputs" section, for example:

"<some-long-running-action>": {
   "type": "Http",
   "inputs": { "<action-inputs>" },
   "operationOptions": "DisableAsyncPattern",
   "runAfter": {}
}

트리거 및 작업 인증

HTTP 및 HTTPS 엔드포인트는 다양한 종류의 인증을 지원합니다. 이러한 엔드포인트에 액세스하기 위해 아웃바운드 호출 또는 요청을 수행하는 데 사용하는 트리거 또는 작업에 따라 다양한 인증 유형 중에서 선택할 수 있습니다. 자세한 내용은 아웃바운드 호출에 인증 추가를 참조하세요.

Next steps

• 워크플로 정의 언어에 대한 자세한 정보