비동기 작업 상태
게시 날짜: 2017년 1월
적용 대상: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
비동기 작업이 비동기 큐에 추가된 후에는 잘 정의된 상태(state)로 존재합니다. 비동기 작업은 실행 대기 중이거나, 실행 중이거나, 완료될 수 있습니다. 작업이 결국 큐에서 삭제되기 전에 다른 상태(state)도 가능합니다. 상태(state)는 비동기 작업의 수명을 정의합니다.
이 항목의 내용
비동기 작업 상태(State)
AsyncOperation 상태(state) 검색 및 업데이트
비동기 작업 상태(State)
비동기 작업 상태는 다음 세 가지 수단을 통해 변경할 수 있습니다: 규칙적 대기열 처리의 일환으로 플랫폼에 의해, Microsoft Dynamics 365 웹 애플리케이션과 상호작용하는 사용자에 의해, 비동기 작업을 변경하는 웹 서비스 호출에 의해. 개발자로서 액세스 권한이 있는 비동기 작업의 현재 상태(state)를 검색하고 상태(state)도 변경할 수 있습니다.
다음 표에는 AsyncOperation의 상태(state) 및 각 상태(state)의 상태(status)가 나와 있습니다.
시/도 |
상태 |
숫자 상태(status) 값 |
|---|---|---|
Ready |
WaitingForResources |
0 |
Suspended |
Waiting |
10 |
Locked |
InProgress |
20 |
Locked |
Pausing |
21 |
Locked |
Canceling |
22 |
Completed |
Succeeded |
30 |
Completed |
Failed |
31 |
Completed |
Canceled |
32 |
지원되는 상태(state)는 AsyncOperationState 열거형에 정의되어 있습니다. 초기 바인딩 AsyncOperation 클래스에서 상태(state)가 AsyncOperation.StateCode 특성에서 사용할 수 있는 반면 상태(status)는 AsyncOperation.StatusCode 특성에서 사용할 수 있습니다. 자세한 내용은 AsyncOperation 엔터티 메타데이터를 참조하십시오.조직에 대한 엔터티 메타데이터를 보려면 조직에 대한 메타데이터 찾아보기에 설정된 메타데이터 브라우저 솔루션을 설치하십시오. SDK 다운로드의 최상위 폴더에 포함된 EntityMetadata.xlsx라는 Excel 파일에서 사용자 지정되지 않은 조직의 메타데이터를 볼 수도 있습니다.. 상태(statuse)는 Microsoft Dynamics 365 웹 응용 프로그램에서 시스템 작업 표의 상태 설명 필드에 표시됩니다.시스템 작업의 기타 작업 메뉴에서 메뉴 항목을 선택하면 비동기 작업의 상태를 서로 변경할 수 있습니다. 허용되는 작업에는 취소, 다시 시작, 연기, 일시 중지 등이 포함됩니다.
다음 다이어그램은 지원되는 비동기 작업 상태(state) 전환을 보여 줍니다.
.jpeg "AsyncOperation 상태 다이어그램")
비동기 작업은 다이어그램에 표시된 대로 특정 경로와 함께 한 상태에서 다른 상태로만 전환할 수 있습니다. 일부 경로는 Microsoft Dynamics 365 웹 애플리케이션과 상호작용하는 사용자에 의해 개시되지만 기타 경로는 규칙적 비동기 대기열 처리의 일환으로 또는 Microsoft Dynamics 365 플랫폼에 의해 또는 웹 서비스 호출로 인해 개시됩니다. 예를 들어 비동기 작업 작업은 일시 중단 상태 또는 잠금 상태에서 직접 전환할 수 있습니다.
잠금 상태는 AsyncOperation 인스턴스가 비동기 서비스에서 사용되고 있음을 나타냅니다. 잠겨 있는 동안에는 서비스의 다른 인스턴스에서 사용할 수 없습니다. 이렇게 하면 예를 들어 다른 두 비동기 서비스에 의해 인스턴스가 두 번 이상 실행되고 않습니다.
AsyncOperation 상태(state) 검색 및 업데이트
비동기 작업 상태를 모니터링하고 업데이트하는 것은 일반적으로 Microsoft Dynamics 365 웹 응용 프로그램의 시스템 작업을 통해 서로 수행됩니다. 하지만 SDK를 사용하여 이러한 동일한 작업을 수행하는 코드를 작성할 수도 있습니다.
비동기 작업의 상태 읽기
RetrieveMultiple 메서드를 사용하여 이름별로 또는 Retrieve 메서드를 사용하여 ID별로 AsyncOperation을 검색합니다.
AsyncOperation.StateCode 특성을 읽습니다.
상태(state) 코드 변경
검색한 상태 코드 특성을 허용되는 작업 상태에 따라 새 값으로 수정합니다.AsyncOperation.PostponeUntil 특성도 변경할 수 있습니다.
Update를 호출하여 데이터베이스에서 이러한 특성 값을 변경합니다.
이전 작업은 적절한 요청 메시지로 Execute 메서드를 사용하여 수행할 수도 있습니다.AsyncOperation.StateCode 및 AsyncOperation.PostponeUntil가 아닌 AsyncOperation 특성은 읽기 전용으로 간주해야 합니다.
되풀이 시스템 작업
대부분의 시스템 작업은 취소, 일시 중지 또는 다시 시작할 수 없습니다. 이러한 제한된 시스템 작업의 일부를 식별하는 다음 목록을 참조하십시오. 첫 번째 열의 값은 AsyncOperation 엔터티의 OperationType 특성의 값입니다.
비동기 작업 유형(옵션 값) |
작업 설명 |
|---|---|
22 |
조직의 최대 저장소 크기 계산 |
18 |
조직의 저장소 크기 계산 |
19 |
조직 데이터베이스 통계 수집 |
20 |
조직 크기 통계 수집 |
16 |
조직 통계 수집 |
9 |
SQM 데이터 컬렉션 |
25 |
조직의 전체 텍스트 카탈로그 인덱스 |
31 |
저장소 한도 알림 |
24 |
통계 간격 업데이트 |
27 |
계약 상태 업데이트 |
지원되는 비동기 작업 유형에 대한 전체 목록은 AsyncOperation 엔터티 메타데이터를 참조하십시오.조직에 대한 엔터티 메타데이터를 보려면 조직에 대한 메타데이터 찾아보기에 설정된 메타데이터 브라우저 솔루션을 설치하십시오. SDK 다운로드의 최상위 폴더에 포함된 EntityMetadata.xlsx라는 Excel 파일에서 사용자 지정되지 않은 조직의 메타데이터를 볼 수도 있습니다.
참고 항목
Microsoft Dynamics 365의 비동기 서비스
AsyncOperation(시스템 작업) 엔터티
비동기 작업의 종속성 및 실행 순서
Microsoft Dynamics 365
© 2017 Microsoft. All rights reserved. 저작권 정보