리소스 가용성 API 검색

현장 서비스 조직은 종종 고객이 직접 서비스 에이전트를 통해 작업을 예약해야 합니다. 예약은 일반적으로 회사에서 사용할 수 있는 리소스와 작업 요구 사항에 따라 만들어집니다.

작업 일정 Dynamics 365 Field Service v8.8.43.51과 Universal Resource Scheduling v3.12.46.21을 사용할 때, msdyn_SearchResourceAvailability API를 사용해 작업에 필요한 모든 적격 자원을 가져와 효율적으로 작업을 일정화하세요. 작성 시점에서 v3는 최신 버전 msdyn_SearchResourceAvailability 이며 웹 API 호출을 지원합니다.

입력 매개 변수

설정 엔터티

설정 엔터티는 Dataverse에 존재하는 엔터티가 아닙니다. 그러나 일정 도우미 API가 결과를 필터링하는 데 도움이 되는 것은 다음과 같은 모든 특성의 모음입니다. 따라서 이 엔터티의 @odata.type는 Microsoft.Dynamics.CRM.expando가 되어야 합니다.

리소스 사양 엔터티

제약 조건

이 엔터티에서 속성을 통해 추가 제약 조건을 지정하세요. 엔터티의 유형은 중요하지 않습니다. 모든 엔터티 논리적 이름을 지정할 수 있습니다.

일정 게시판 설정에서 검색 리소스 쿼리를 검토하여 적용할 수 있는 제약 조건을 식별합니다. 기본적으로 다음이 포함됩니다.

출력 매개 변수

가장 높은 수준에서 출력에는 다음 네 가지 매개변수가 있습니다. 결과는 엔터티 컬렉션 및 엔터티에 표시됩니다. 응답에는 null 값으로 설명된 모든 특성이 포함되지 않거나 응답에서 NA 값이 생략되지 않을 수 있습니다. 액세스를 시도하기 전에 항상 특성이 있는지 확인하십시오.

시간 슬롯 엔터티

시간 슬롯 리소스

예시

이 예시에서는 웹 API 호출을 지원하는 스케줄 어시스턴트 API 버전 3을 60분 동안 요구하는 요구사항을 사용합니다. 속성을 사용하면 settings 결과를 필터링할 수 있습니다. 최종 결과로 두 가지 자원 유형을 고려합니다: 1과 2(즉, 일반과 접촉).

{
    "Version": "4",
    "IsWebApi": true,
    "Requirement": {
        "msdyn_fromdate": "2021-07-14T00:00:00Z",
        "msdyn_todate": "2021-07-15T23:59:00Z",
        "msdyn_remainingduration": 60,
        "msdyn_duration": 60,
        "msdyn_TimeGroup@odata.bind": "/msdyn_timegroups(c3dc79ea-d12f-ee11-9cc9-000d3a745a58)",
        "@odata.type": "Microsoft.Dynamics.CRM.msdyn_resourcerequirement"
    },
    "Settings": {
        "ConsiderSlotsWithProposedBookings": false,
        "MovePastStartDateToCurrentDate": true,
        "@odata.type": "Microsoft.Dynamics.CRM.expando"
    },
    "ResourceSpecification": {
        "@odata.type": "Microsoft.Dynamics.CRM.expando",
        "ResourceTypes@odata.type": "Collection(Microsoft.Dynamics.CRM.expando)",
        "ResourceTypes": [
            {
                "@odata.type": "Microsoft.Dynamics.CRM.expando",
                "value": "1"
            },
            {
                "@odata.type": "Microsoft.Dynamics.CRM.expando",
                "value": "2"
            }
        ],
        "Constraints": {
            "@odata.type": "Microsoft.Dynamics.CRM.expando",
            "Characteristics@odata.type": "Collection(Microsoft.Dynamics.CRM.expando)",
            "Characteristics": [
                {
                    "@odata.type": "Microsoft.Dynamics.CRM.expando",
                    "characteristic": {
                        "@odata.type": "Microsoft.Dynamics.CRM.expando",
                        "value": "67387f9f-12e2-ec11-bb43-000d3aed25f7"
                    },
                    "ratingvalue": {
                        "@odata.type": "Microsoft.Dynamics.CRM.expando",
                        "value": "a1b2c3d4-5678-90ab-cdef-1234567890ab"
                    }
                }
            ],
            "Territories@odata.type": "Collection(Microsoft.Dynamics.CRM.expando)",
            "Territories": [
                {
                    "@odata.type": "Microsoft.Dynamics.CRM.expando",
                    "value": "cc19f004-4483-ee11-8178-000d3a5c32c3"
                }
            ],
            "Roles@odata.type": "Collection(Microsoft.Dynamics.CRM.expando)",
            "Roles": [
                {
                    "@odata.type": "Microsoft.Dynamics.CRM.expando",
                    "value": "76998e42-744c-f011-877d-6045bdfb899e"
                }
            ]
        }
    }
}

다음 예에서는 엔터티 컬렉션의 올바른 사용법을 보여줍니다. 이 경우 는 를 명시한다 MustChooseFromResources.

{
    "Version": "4",
    "IsWebApi": true,
    "Requirement": {
        "msdyn_fromdate": "2021-07-14T00:00:00Z",
        "msdyn_todate": "2021-07-15T23:59:00Z",
        "msdyn_remainingduration": 60,
        "msdyn_duration": 60,
        "msdyn_latitude": 47.64807,
        "msdyn_longitude": -122.41249,
        "msdyn_worklocation": 690970000,
        "msdyn_TimeGroup@odata.bind": "/msdyn_timegroups(c3dc79ea-d12f-ee11-9cc9-000d3a745a58)",
        "@odata.type": "Microsoft.Dynamics.CRM.msdyn_resourcerequirement"
    },
    "Settings": {
        "ConsiderSlotsWithProposedBookings": false,
        "MovePastStartDateToCurrentDate": true,
        "MaxNumberOfResourcesToEvaluate":500,
        "ConsiderTravelTime": true,
        "MaxResourceTravelRadius": {
            "Value": 20,
            "Unit" : 192350000,
            "@odata.type": "Microsoft.Dynamics.CRM.expando"
        },
        "@odata.type": "Microsoft.Dynamics.CRM.expando"
    },
    "ResourceSpecification": {
        "@odata.type": "Microsoft.Dynamics.CRM.expando",
        "ResourceTypes@odata.type": "Collection(Microsoft.Dynamics.CRM.expando)",
        "ResourceTypes": [
            {
                "@odata.type": "Microsoft.Dynamics.CRM.expando",
                "value": "1"
            },
            {
                "@odata.type": "Microsoft.Dynamics.CRM.expando",
                "value": "2"
            }
        ],
        "MustChooseFromResources@odata.type": "Collection(Microsoft.Dynamics.CRM.expando)",
        "MustChooseFromResources": [
            {
                "@odata.type": "Microsoft.Dynamics.CRM.expando",
                "value": "2145a982-f718-ed11-b83e-0022482d79c8"
            }
        ],
        "Constraints": {
            "@odata.type": "Microsoft.Dynamics.CRM.expando",
            "Characteristics@odata.type": "Collection(Microsoft.Dynamics.CRM.expando)",
            "Characteristics": [
                {
                    "@odata.type": "Microsoft.Dynamics.CRM.expando",
                    "characteristic": {
                        "@odata.type": "Microsoft.Dynamics.CRM.expando",
                        "value": "67387f9f-12e2-ec11-bb43-000d3aed25f7"
                    },
                    "ratingvalue": {
                        "@odata.type": "Microsoft.Dynamics.CRM.expando",
                        "value": "a1b2c3d4-5678-90ab-cdef-1234567890ab"
                    }
                }
            ],
            "Territories@odata.type": "Collection(Microsoft.Dynamics.CRM.expando)",
            "Territories": [
                {
                    "@odata.type": "Microsoft.Dynamics.CRM.expando",
                    "value": "cc19f004-4483-ee11-8178-000d3a5c32c3"
                }
            ]
        }
    }
}