Dataverse Web API를 사용하여 작업 순서 만들기

이 문서에서는 데이타버스 Web API 사용하여 Dynamics 365 Field Service 작업 순서를 만드는 예제를 제공합니다. 예제에서는 msdyn_workorder 엔터티를 사용합니다.

필수 조건

• Web API 엔드포인트가 있는 Dynamics 365 Field Service 환경(예: https://yourorg.api.crm.dynamics.com/api/data/v9.2/).
• OAuth 2.0을 사용하는 인증된 요청입니다. Web API를 사용하여 Dataverse에 인증하는 방법에 대해 자세히 알아봅니다.
• 필요한 조회 필드에 대한 기존 레코드:
  • 서비스 계정(account 엔터티)
  • 작업 지시 유형 (msdyn_workordertype 엔터티)
  • 가격표 (pricelevel 엔터티)

단일 작업 순서 만들기

POST 요청을 msdyn_workorders 엔터티 집합에 보내 작업 오더를 생성합니다. Web API를 사용하여 테이블 행 만들기에 대해 자세히 알아봅니다.

HTTP 요청

POST [Organization URL]/api/data/v9.2/msdyn_workorders
Accept: application/json
Content-Type: application/json
OData-MaxVersion: 4.0
OData-Version: 4.0
Authorization: Bearer <access_token>

{
  "msdyn_serviceaccount@odata.bind": "/accounts(e1a2b3c4-5678-9abc-def0-1234567890ab)",
  "msdyn_workordertype@odata.bind": "/msdyn_workordertypes(a1b2c3d4-5678-9abc-def0-1234567890cd)",
  "msdyn_pricelist@odata.bind": "/pricelevels(f1e2d3c4-5678-9abc-def0-1234567890ef)",
  "msdyn_systemstatus": 690970000,
  "msdyn_taxable": false,
  "msdyn_instructions": "Install new equipment"
}

HTTP 응답

성공한 요청은 새 작업 순서 레코드의 URL을 포함하는 헤더와 함께 HTTP 204 No Content 반환 OData-EntityId 됩니다.

여러 작업 주문 만들기

단일 요청에서 여러 작업 주문을 만들려면 작업을 사용합니다 CreateMultiple . 이는 개별 POST 요청 또는 일괄 처리 작업보다 성능이 더 높습니다. 대량 작업 메시지 사용에 대해 자세히 알아보세요.

HTTP 요청

POST [Organization URL]/api/data/v9.2/msdyn_workorders/Microsoft.Dynamics.CRM.CreateMultiple
Accept: application/json
Content-Type: application/json
OData-MaxVersion: 4.0
OData-Version: 4.0
Authorization: Bearer <access_token>

{
  "Targets": [
    {
      "@odata.type": "Microsoft.Dynamics.CRM.msdyn_workorder",
      "msdyn_serviceaccount@odata.bind": "/accounts(e1a2b3c4-5678-9abc-def0-1234567890ab)",
      "msdyn_workordertype@odata.bind": "/msdyn_workordertypes(a1b2c3d4-5678-9abc-def0-1234567890cd)",
      "msdyn_pricelist@odata.bind": "/pricelevels(f1e2d3c4-5678-9abc-def0-1234567890ef)",
      "msdyn_systemstatus": 690970000,
      "msdyn_taxable": false,
      "msdyn_instructions": "Work order 1 - Install new equipment"
    },
    {
      "@odata.type": "Microsoft.Dynamics.CRM.msdyn_workorder",
      "msdyn_serviceaccount@odata.bind": "/accounts(e1a2b3c4-5678-9abc-def0-1234567890ab)",
      "msdyn_workordertype@odata.bind": "/msdyn_workordertypes(a1b2c3d4-5678-9abc-def0-1234567890cd)",
      "msdyn_pricelist@odata.bind": "/pricelevels(f1e2d3c4-5678-9abc-def0-1234567890ef)",
      "msdyn_systemstatus": 690970000,
      "msdyn_taxable": false,
      "msdyn_instructions": "Work order 2 - Preventive maintenance check"
    }
  ]
}

HTTP 응답

성공한 요청은 만든 레코드의 ID와 함께 반환 HTTP 200 OK 됩니다.

{
  "@odata.context": "[Organization URL]/api/data/v9.2/$metadata#Microsoft.Dynamics.CRM.CreateMultipleResponse",
  "Ids": [
    "c1d2e3f4-5678-9abc-def0-111111111111",
    "c1d2e3f4-5678-9abc-def0-222222222222"
  ]
}

작업 순서 검색

작업 지시서를 만든 후, GET 요청으로 불러옵니다.

GET [Organization URL]/api/data/v9.2/msdyn_workorders(<work-order-id>)?$select=msdyn_name,msdyn_systemstatus,msdyn_address1,msdyn_city
Accept: application/json
OData-MaxVersion: 4.0
OData-Version: 4.0
Authorization: Bearer <access_token>

응답

{
  "@odata.context": "[Organization URL]/api/data/v9.2/$metadata#msdyn_workorders(msdyn_name,msdyn_systemstatus,msdyn_address1,msdyn_city)/$entity",
  "@odata.etag": "W/\"7998533\"",
  "msdyn_workorderid": "d4e5f6a7-1234-5678-9abc-def012345678",
  "msdyn_name": "00051",
  "msdyn_systemstatus": 690970000,
  "msdyn_address1": "205 108th Ave NE",
  "msdyn_city": "Bellevue"
}

오류 처리

작업 주문을 만들 때 발생하는 일반적인 오류 응답:

관련 콘텐츠

• 작업 지시서(msdyn_workorder) 엔터티 참조
• Field Service에서 작업 순서 만들기
• Web API를 사용하여 테이블 행 만들기
• 대량 작업 메시지 사용