작업 큐 작업
Power Automate의 작업 큐는 프로세스 관련 데이터를 저장하고 복잡한 프로세스와 자동화를 분리하는 방법을 제공하여 비동기식으로 통신할 수 있도록 하는 데 사용할 수 있습니다.
작업 큐는 자동화의 효율성, 확장성 및 복원력을 개선하고 작업 우선 순위를 지정하는 데 중요한 역할을 할 수 있습니다. 작업 큐를 사용하면 디지털 작업자, 인간 작업자 또는 통합을 통해 처리되는지 여부에 관계없이 우선 순위가 가장 높은 항목을 먼저 완료할 수 있습니다.
노트
- 첫 번째 작업 큐 관련 작업 세트에 대한 프로덕션 수준 지원을 위해서는 Power Automate 데스크톱 버전 2.37 이상이 필요합니다.
- 데스크톱용 Power Automate의 작업 큐 작업은 Power Automate 구독이 필요한 프리미엄 기능입니다.
- 현재는 작업 큐 항목 처리 및 작업 큐 항목 업데이트 작업만 DLP(데이터 손실 방지) 정책을 통해 분류 및 허용 또는 제한할 수 있으며, 다른 작업도 곧 제공될 예정입니다. 작업 큐의 클라우드 흐름 기반 사용은 DLP 정책으로 제한할 수 없습니다.
작업 큐 항목 처리
작업 큐 항목 처리 작업은 컴퓨터가 하나 이상의 작업 큐 항목을 처리할 준비가 되었음을 큐 오케스트레이터에 나타냅니다. 새 항목을 요청하는 사용자 컨텍스트는 작업 큐를 처리하기 위해 작업 큐 및 작업 큐 항목 테이블에 대한 충분한 권한이 있어야 합니다.
이전 작업에서 참조된 작업 큐는 큐 조정자가 해당 작업 큐의 큐에서 대기 중 상태에 있는 사용 가능한 다음 항목을 결정하는 데 사용됩니다. 데스크톱 흐름이 이 작업이 렌더링하는 작업 큐 항목 처리 루프 내의 작업을 단계별로 진행함에 따라 .Value 속성을 사용하여 작업에 대해 지정한 변수를 활용하여 값을 호출할 수 있습니다. 이 경우 %WorkQueueItem.Value% 변수를 사용하여 작업 큐 항목의 값을 호출할 수 있습니다
중요
"행 필터링" 필드에 FetchXML 식을 제공하면 큐 항목에 대한 기본 작업 큐 오케스트레이터의 FIFO 논리를 우회할 수 있습니다. 이렇게 하면 사용자 지정 큐 제거 순서를 설정하고 항목 만료 날짜 및 필터 식이 제공되지 않을 때 자동으로 적용되는 기타 설정을 무시할 수 있습니다.
Processworkqueueitemaction
작업 큐 항목 작업 처리 작업에는 다음 인수가 필요합니다.
입력 매개 변수
| 인수 | 선택 항목 | 수락 | 기본값 | Description |
|---|---|---|---|---|
| 작업 큐 | 아니요 | 문자 | 처리할 항목이 포함된 작업 큐의 작업 큐 ID. | |
| 행 필터 | 네 | 문자 | FetchXML 쿼리 식은 작업 큐에서 항목을 검색하는 데 사용됩니다. | |
| 작업 큐 자동 재시도 구성 덮어쓰기 | 네 | 부울 | False | 이 기능을 활성화하면 IT Exceptions에 대한 최대 재시도 횟수를 설정하거나 덮어쓸 수 있는 필드가 나타납니다. |
| 최대 재시도 횟수 | 없음 | 텍스트 값, 숫자 값 | 덮어쓰지 않으면 작업 큐 레코드에 정의된 기본 최대 재시도 횟수가 사용됩니다. | IT Exceptions에 허용되는 최대 재시도 횟수입니다. 이 매개 변수를 사용하면 재시도 횟수를 더 높거나 낮은 값으로 조정하거나 횟수를 0으로 설정하여 재시도 메커니즘을 사용하지 않도록 설정할 수도 있습니다. |
변수 생성됨
| 인수 | Type | Description |
|---|---|---|
| WorkQueueItem | 아니요 | 처리 중인 작업 큐 항목에 저장된 정보 |
예외
| 예외 | 설명 |
|---|---|
| 작업 큐를 찾을 수 없음 | 작업 큐 매개 변수에 입력한 값이 잘못되었습니다. |
| 작업 큐가 일시 중지 또는 중지됨 | 작업 큐가 일시 중지되거나 중지되어 항목을 처리할 때 유효한 상태가 아닙니다. |
| 유효하지 않은 FetchXML | 유효하지 않은 FetchXML 식이 제공되었습니다. |
| 작업 큐를 처리하지 못함 | 잘못된 요청 - 쿼리 구문 오류. |
FetchXML 쿼리란?
Microsoft Dataverse FetchXML은 Dataverse 데이터베이스에서 데이터를 검색하는 데 사용되는 언어입니다. 쉽게 만들고, 사용하고, 이해할 수 있도록 설계되었습니다. 예를 들어 오케스트레이터에 FIFO(선입선출)와 다른 순서로 특정 만료 기간 내에 항목을 처리하도록 요청할 수 있습니다.
FetchXML 쿼리 지원을 작업 큐 항목 처리로 제한하기 위해 제한된 FetchXML 용어 및 식 집합이 지원됩니다. 이러한 용어에는 필터, 조건 및 순서 지정 식이 포함되며 모두 작업 큐 항목 테이블(workqueueitem)로 제한됩니다. Queued 상태에 있는 항목만 반환됩니다.
예제 FetchXML 쿼리
다음은 name으로 필터링하고 먼저 만료되는 레코드를 기준으로 결과를 정렬하는 방법(FEFO)에 대한 예제 쿼리 식입니다.
<filter type="and">
<condition attribute="expirydate" operator="on-or-before" value="2024-10-18" />
<condition attribute="name" operator="eq" value="MyNonUniqueNameString" />
</filter>
<order attribute="expirydate" descending="false" />
지원 세부 정보 및 참조 데이터 쿼리
- 사용 가능한 쿼리 연산자 목록입니다. 여기에는 on-or-before, between, last-month 등의 연산자가 포함됩니다.
- 작업 큐 항목 테이블에서 사용할 수 있는 속성 목록입니다.
작업 큐 항목 업데이트
작업 큐 항목 업데이트 작업을 통해 사용자는 선택한 작업 큐 항목의 상태 및 처리 결과를 변경할 수 있습니다.
Updateworkqueueitemaction
작업 큐 항목 작업 업데이트 작업에는 다음 인수가 필요합니다.
| 인수 | 선택 항목 | 수락 | 기본값 | 설명 |
|---|---|---|---|---|
| 작업 큐 항목 | 아니요 | 문자 | 큐 오케스트레이터가 이전에 반환한 작업 큐 항목 변수 | |
| 실행 상태 | 아니요 | 처리됨, 일반 예외 | 처리됨 | 옵션 목록의 상태를 사용하여 처리 중인 작업 큐 항목을 업데이트합니다. |
| 처리 중인 메모 | 네 | 문자 | 처리 중인 큐 항목에 추가할 사용자 지정 처리 메모 또는 값입니다. | |
| 처리 메모 삭제 | 네 | 부울 | False | 활성화하면 이 화면에서 처리 메모 필드를 숨기거나 지우고 이 항목에 대해 이전에 캡처된 모든 처리 메모를 데이터베이스에서 제거합니다. |
예외
| 인수 | Description |
|---|---|
| 작업 큐 항목을 찾을 수 없음 | 처리 중인 작업 큐 항목이 삭제되었거나 더 이상 호출된 큐에 속하지 않습니다. |
| 작업 큐 항목 보류 중 | 처리 중인 작업 큐 항목은 큐 오케스트레이터에서 on hold 상태를 포함하며 더 이상 업데이트할 수 없습니다. |
| 작업 큐 항목을 업데이트하지 못함 | 업데이트 중인 작업 큐 항목에 예기치 않은 오류가 발생했습니다. 자세한 내용은 오류 메시지를 확인하십시오. |
작업 큐 항목 추가
작업 큐 항목 추가 작업을 사용하면 사용자는 흐름 포털에 설정된 작업 큐에 작업 큐 항목을 채울 수 있습니다.
Enqueueworkqueueitemaction
작업 큐 항목 추가 작업에는 다음 인수가 필요합니다.
입력 매개 변수
| 인수 | 선택 항목 | 수락 | 기본값 | Description |
|---|---|---|---|---|
| 작업 큐 | 아니요 | 텍스트 값 | 항목을 추가할 작업 큐 항목 | |
| 우선 순위 | 아니요 | 높음, 보통, 낮음 | 일반 | 작업 큐 항목을 설정할 우선 순위 |
| 입력 | 아니요 | 텍스트 값, 숫자 값 | 새 작업 큐 항목의 사용자 지정 이름 또는 ID | |
| 입력 | 없음 | 텍스트 값, 숫자 값 | 처리할 값 열에 속하는 데이터 | |
| 만료 | 네 | Datetime | 큐 항목을 만료하도록 설정된 날짜/시간 값, 그렇지 않으면 큐에 설정된 경우 기본값을 채택합니다 | |
| 처리 중인 메모 | 네 | 텍스트 값, 숫자 값 | 새 큐 항목에 추가할 사용자 지정 처리 메모 | |
| 고유 ID 또는 참조가 있습니다. | 네 | 텍스트 값, 숫자 값 | 활성화되면 이 큐 내에서 고유한 값을 제공해야 합니다. 비워 두면 system-<GUID> 형식의 고유 값이 시스템에서 자동으로 제공됩니다 |
변수 생성됨
| 인수 | Type | Description |
|---|---|---|
| WorkQueueItem | 아니요 | 추가 중인 작업 큐 항목에 대해 저장된 정보 |
예외
| 인수 | 설명 |
|---|---|
| 작업 큐를 찾을 수 없음 | 작업 큐 매개 변수에 입력한 값이 잘못되었습니다 |
| 작업 큐에 항목을 추가하지 못함 | 작업 큐 항목을 작업 큐에 추가할 수 없습니다. 잘못된 요청 - 쿼리 구문 오류 |
여러 작업 큐 항목 추가
여러 작업 큐 항목 추가 작업을 통해 사용자는 작업 큐 항목 데이터 테이블로 제공된 데이터를 기반으로 작업 큐에 하나 이상의 작업 큐 항목을 추가할 수 있습니다.
이 작업을 수행하려면 하나 이상의 작업 큐 항목을 보유하는 사용자 지정 데이터 테이블이 필요합니다. 데이터 테이블에는 8개의 열이 있어야 하며 다음 스키마를 준수해야 합니다.
| 열 이름 | Description | 필수 | 허용되는 값 |
|---|---|---|---|
| 입력 | 항목의 이름입니다. | 없음 | 모든 영숫자 문자열 |
| 입력 | 항목의 세부 정보 또는 데이터를 입력합니다. | 네 | 모든 영숫자 문자열 |
| 만료 기한 | 항목이 만료될 때까지의 기간을 지정합니다. | 없음 | 날짜 및 시간 값 |
| 처리 중인 메모 | 항목과 관련된 처리 메모입니다. | 없음 | 모든 영숫자 문자열 |
| 우선 순위 | 항목의 우선 순위 수준입니다. | 네 | 100(높음), 200(보통), 300(낮음)의 숫자 값 |
| 고유 참조 | 항목의 고유 식별자 또는 참조 값입니다. | 없음 | 고유한 영숫자 문자열 또는 참조 |
| Status | 수집 중인 항목의 상태입니다. | 네 | 0(대기 중), 1(보류 중)의 숫자 값입니다. |
| 다음 기간까지 지연 | 처리를 위해 작업 큐 항목을 무시할 때까지의 날짜 및 시간을 지정합니다. | 없음 | 날짜 및 시간 값 |
데이터 테이블을 만들기 위한 Robin 코드 조각
다음 예제는 Power Automate 데스크톱 디자이너 창에 직접 복사하여 붙여넣을 수 있는 로빈 코드(기존 흐름에서 사용됨) 코드 조각입니다. 이 코드 조각은 예상되는 필드 집합을 흐름에 포함하는 새 데이터 테이블 만들기 작업을 추가합니다.
Variables.CreateNewDatatable InputTable: { ^['Name', 'Input', 'Expires in', 'Processing notes', 'Priority', 'Unique reference', 'Status', 'Delay until'], [$'''''', $'''''', $'''''', $'''''', $'''''', $'''''', $'''''', $''''''] } DataTable=> DataTable
데이터 테이블을 만들기 위한 PowerFx 코드 조각
다음 예제는 Power Automate 데스크톱 디자이너 창에 직접 복사하여 붙여넣을 수 있는 PowerFx 코드 조각입니다. 이 코드 조각은 예상되는 필드 집합을 흐름에 포함하는 새 데이터 테이블 만들기 작업을 추가합니다.
Variables.CreateNewDatatable InputTable: { ^['Name', 'Input', 'Expires in', 'Processing notes', 'Priority', 'Unique reference', 'Status', 'Delay until'], [$fx'', $fx'', $fx'', $fx'', $fx'', $fx'', $fx'', $fx''] } DataTable=> DataTable
Batchenqueueworkqueueitemsaction
여러 작업 큐 항목 추가 작업에는 다음 인수가 필요합니다.
입력 매개 변수
| 인수 | 선택 항목 | 수락 | 기본값 | Description |
|---|---|---|---|---|
| 작업 큐 | 없음 | 텍스트 값 | 항목을 추가할 작업 큐 항목 | |
| 작업 큐 항목 데이터 | 네 | 데이터 테이블 | 작업 큐에 추가할 작업 큐 항목을 보관하는 사용자 지정 데이터 테이블 |
변수 생성됨
| 인수 | Type | 기본값 | Description |
|---|---|---|---|
| FailedWorkQueueItems | 없음 | 사용 설정됨 | 오류가 있는 경우 이 개체는 오류 코드와 함께 삽입하지 못한 항목의 인덱스를 보유합니다. 반환된 인덱스는 여러 작업 큐 항목 추가 작업의 제공된 작업 큐 데이터 테이블에 있는 항목의 위치(인덱스)입니다. |
| HasFailedItems | 없음 | 사용 설정됨 | 작업 큐 항목 데이터 문제로 인해 작업에 수집 오류가 발생했는지 여부를 나타내는 표시기입니다. |
| SuccessfulWorkQueueItems | 사용 중지됨 | 없음 | 작업 큐에 성공적으로 추가된 인덱스 및 작업 큐 항목을 보관하는 사용자 지정 개체입니다. |
예외
| 인수 | Description |
|---|---|
| 작업 큐를 찾을 수 없음 | 작업 큐 매개 변수에 입력한 값이 잘못되었습니다 |
| 작업 큐가 일시 중지 또는 중지됨 | 작업 큐가 일시 중지되었거나 중지되었기 때문에 작업 큐 항목을 작업 큐에 추가할 수 없습니다. |
| 작업 큐 항목 목록을 일괄적으로 큐에 넣지 못함 | 요청 또는 통신 오류로 인해 작업 큐 항목을 작업 큐에 추가할 수 없습니다. |
지연이 있는 항목 다시 대기
지연된 항목 다시 큐에 넣기 작업을 통해 사용자는 데스크톱 흐름에서 처리 중인 큐 항목을 원래 큐에 다시 추가할 수 있습니다. 또한 대기 중인 항목은 정의된 시간까지 보류 및 해제될 수 있습니다.
Requeueworkqueueitemaction
지연된 항목 다시 큐에 추가 작업에는 다음 인수가 필요합니다.
입력 매개 변수
| 인수 | 선택 항목 | 수락 | 기본값 | Description |
|---|---|---|---|---|
| 작업 큐 항목 | 아니요 | 작업 큐 항목 | 항목을 추가할 작업 큐 항목 | |
| 다음 기간까지 지연 | 아니요 | 날짜/시간 값 | 일반 | 큐 항목을 지연하기 위해 적용되는 날짜 시간 값 |
| 만료 | 네 | 날짜/시간 값 | 다시 큐에 추가되는 항목의 사용자 지정 만료 시간 | |
| 처리 중인 메모 | 네 | 텍스트 값, 숫자 값 | 새 큐 항목에 추가할 사용자 지정 처리 메모 | |
| 처리 메모 삭제 | 네 | 부울 | False | 활성화하면 이 화면에서 처리 메모 필드를 숨기거나 지우고 이 항목에 대해 이전에 캡처된 모든 처리 메모를 데이터베이스에서 제거합니다. |
예외
| 인수 | Description |
|---|---|
| 작업 큐를 찾을 수 없음 | 작업 큐 매개 변수에 입력한 값이 잘못되었습니다 |
| 작업 큐 항목을 찾을 수 없음 | 큐 항목 값이 잘못되었습니다 |
| 작업 큐 항목을 다시 대기 처리하지 못함 | 작업 큐 항목을 작업 큐에 추가할 수 없습니다. 잘못된 요청 - 쿼리 구문 오류 |
작업 큐 항목 처리 메모 업데이트
작업 큐 항목 처리 메모 업데이트 작업을 통해 사용자는 상태나 기타 속성을 변경하지 않고 선택한 작업 큐 항목의 처리 메모를 업데이트하거나 지울 수 있습니다.
updateprocessingnotesaction
작업 큐 항목 처리 메모 업데이트 작업에는 다음 인수가 필요합니다.
| 인수 | 선택 항목 | 수락 | 기본값 | Description |
|---|---|---|---|---|
| 작업 큐 항목 | 없음 | 문자 | 작업 큐 이전에 큐 오케스트레이터에 의해 반환된 항목 변수 | |
| 처리 중인 메모 | 네 | 문자 | 처리된 큐 항목에 추가할 사용자 지정 처리 결과 또는 값 | |
| 처리 메모 삭제 | 네 | 부울 | False | 활성화하면 이 화면에서 처리 메모 필드를 숨기거나 지우고 이 항목에 대해 이전에 캡처된 모든 처리 메모가 데이터베이스에서 삭제됩니다. |
예외
| 인수 | Description |
|---|---|
| 작업 큐를 찾을 수 없음 | 항목과 연결된 작업 큐가 삭제되었거나 더 이상 액세스할 수 없습니다. |
| 작업 큐 항목을 찾을 수 없음 | 작업 큐 항목이 유효하지 않음 |
| 처리 결과를 추가하지 못했습니다. | 업데이트 중인 작업 큐 항목에 예기치 않은 오류가 발생했습니다. 자세한 내용은 오류 메시지를 확인하십시오. |
필터를 기준으로 작업 큐 항목 가져오기
필터로 작업 큐 항목 가져오기 작업을 통해 사용자는 FetchXML 필터 식을 기반으로 하나 이상의 작업 큐 항목을 검색할 수 있습니다.
Getworkqueueitemsaction
필터로 작업 큐 항목 가져오기 작업에는 다음 인수가 필요합니다.
입력 매개 변수
| 인수 | 선택 항목 | 수락 | 기본값 | Description |
|---|---|---|---|---|
| 작업 큐 | 없음 | 문자 | 항목을 검색할 작업 큐 | |
| 행 필터 | 없음 | 문자 | FetchXML 쿼리 식은 작업 큐에서 항목을 검색하는 데 사용됩니다 | |
| 반환할 행 | 없음 | 숫자 | 5000 | 오케스트레이터에서 반환되는 최대 작업 큐 항목 수입니다 |
변수 생성됨
| 인수 | Type | 기본값 | Description |
|---|---|---|---|
| WorkQueueItems | 없음 | 사용 설정됨 | 필터 식과 일치하는 작업 큐 항목 목록입니다. |
예외
| 인수 | Description |
|---|---|
| 작업 큐 | 항목을 검색할 작업 큐입니다. |
| 행 필터 | FetchXML 쿼리 식은 작업 큐에서 항목을 검색하는 데 사용됩니다. |
| 반환할 행 | 오케스트레이터에서 반환되는 최대 작업 큐 항목 수입니다(기본값은 5000). |
FetchXML 쿼리란?
Microsoft Dataverse FetchXML은 Dataverse 데이터베이스에서 데이터를 검색하는 데 사용되는 언어입니다. 쉽게 만들고, 사용하고, 이해할 수 있도록 설계되었습니다. 예를 들어, Dataverse에 IT Exception 상태에 있는 모든 작업 큐 항목 목록을 제공하도록 요청할 수 있습니다.
FetchXml 쿼리 지원을 작업 큐 항목 검색으로 제한하기 위해 제한된 FetchXml 용어 및 식 집합만 지원합니다. 이러한 용어 및 식에는 속성, 필터, 조건 및 순서 지정 식이 포함되며 모두 작업 큐 항목 테이블(workqueueitem)로 제한됩니다. 작업 큐 항목 테이블에서 반환할 속성과 원하는 정렬 순서를 명시적으로 지정해야 합니다.
예제 FetchXML 쿼리
다음 예제는 여러 속성을 가져오고, IT Exceptions로 표시된 잘못된 항목을 필터링하고, 먼저 만료되는 레코드(FEFO)를 기준으로 결과를 정렬하는 방법에 대한 쿼리 식입니다.
<attribute name="statecode" />
<attribute name="uniqueidbyqueue" />
<attribute name="createdon" />
<attribute name="completedon" />
<attribute name="workqueueitemid" />
<attribute name="executioncontext" />
<attribute name="name" />
<attribute name="expirydate" />
<attribute name="processingresult" />
<attribute name="priority" />
<attribute name="statuscode" />
<attribute name="modifiedon" />
<attribute name="processingstarttime" />
<attribute name="retrycount" />
<attribute name="requeuecount" />
<attribute name="input" />
<attribute name="delayuntil" />
<filter type="and">
<condition attribute="statecode" operator="eq" value="4" />
<condition attribute="statuscode" operator="eq" value="5" />
<condition attribute="expirydate" operator="on-or-before" value="2024-10-18" />
</filter>
<order attribute="expirydate" descending="false" />
지원 세부 정보 및 참조 데이터 쿼리
- 사용 가능한 쿼리 연산자 목록입니다. 여기에는 on-or-before, between, last-month 등의 연산자가 포함됩니다.
- 작업 큐 항목 테이블에서 사용할 수 있는 속성 목록입니다.
상태(statecode)
| Status | 코드 | Description |
|---|---|---|
| 대기 중 | 12 | 항목이 대기 중임 |
| 처리 | 6 | 항목이 처리 중임 |
| 처리됨 | 2 | 항목이 처리됨 |
| 보류 중 | 3 | 항목이 보류 중임 |
| Error | 4 | 항목에 오류가 발생했음 |
상태 설명(statuscode)
| 상태 이유 | 코드 | Description |
|---|---|---|
| 대기 중 | 12 | 항목이 대기 중임 |
| 처리 | 6 | 항목이 처리 중임 |
| 처리됨 | 2 | 항목이 처리됨 |
| OnHold(일시 중지됨) | 3 | 항목이 보류 중임(일시 중지됨) |
| 일반 예외 | 4 | 항목에서 일반 예외가 발생했음 |
| IT 예외 | 5 | 항목에서 IT 예외가 발생했음 |
| 비즈니스 예외 | 6 | 항목에서 비즈니스 예외가 발생했음 |
| 배달 불능 편지 | 7 | 항목이 보류 상태임 |
| ProcessingTimeout | 8 | 항목 처리 시간이 초과됨 |