IoT 공급자 작업 설정

아티클
09/04/2024

IoT(사물 인터넷) 공급자를 설정한 후 조직의 IoT 장치에서 수집된 데이터를 기반으로 트리거할 일련의 작업을 지정할 수 있습니다. 5개의 사전 정의된 작업과 함께 공급자와 연결된 사용자 지정 작업을 생성하여 Connected Field Service 운영의 다양한 측면을 자동화할 수 있습니다.

Connected Field Service에는 다음 작업이 제공됩니다.

장치 데이터 끌어오기
장치 등록
집계된 장치 판독값
장치 판독값 쿼리
장치 이벤트 가져오기

장치 데이터 끌어오기

장치 데이터 가져오기 작업은 IoT 공급자로부터 하나의 장치 또는 장치 모음에 대한 최신 데이터를 가져옵니다. 장치 데이터 기록 탭에 표시됩니다.

데이터는 여러 장치에서 가져올 수 있으므로 장치 데이터 가져오기 작업에는 입력으로 EntityCollection이 필요합니다. 다음 표에서는 EntityCollection의 매개 변수를 설명합니다.

매개 변수	Type	세부 사항
msdyn_iotdeviceid	string	문자열로 변환된 Connected Field Service의 GUID 장치 ID(msdyn_iotdevice)
msdyn_name	string	장치의 이름
@odata.type	string	엔터티의 OData 유형

샘플 입력:

{
  "EntityCollection":[
      {
    "msdyn_iotdeviceid":"B25B5E21-326E-4C36-9296-C195286DGEC9",
    "msdyn_name":" HVAC 32443",
    "@odata.type":"Microsoft.Dynamics.CRM.msdyn_iotdevice"
      },
      {
    "msdyn_iotdeviceid":"B25B5E21-326E-4C36-9296-C195286DGEE9",
    "msdyn_name":" HVAC 92232",
    "@odata.type":"Microsoft.Dynamics.CRM.msdyn_iotdevice"
      }
  ]
}

장치 데이터 가져오기 작업은 가져온 데이터를 직렬화된 JSON 형식으로 반환합니다. 다음 표에서는 PullDeviceDataResultsJSON 출력의 매개 변수를 설명합니다.

JSON 속성	Type	세부 사항
ID	string	문자열로 변환된 Connected Field Service의 GUID 장치 ID(msdyn_iotdevice)
ConnectionState	boolean	장치가 연결 해제되었는지(false) 또는 연결되었는지(true) 여부
ConnectionStateUpdatedTime	datetime	IoT 공급자의 마지막 연결 상태 업데이트 타임스탬프
DeviceReportedProperties	string	JSON 문자열로 형식화된 장치의 보고된 속성
LastActivityTime	datetime	기기에서 마지막으로 보고된 활동의 타임스탬프

샘플 출력:

{
  "PullDeviceDataResultsJSON":[
     {
    "Id":"B25B5E21-326E-4C36-9296-C195286DGEC9",
    "ConnectionState":true,
    "ConnectionStateUpdatedTime":"2019-08-2911:00:00",
    "DeviceReportedProperties":{
      "temperature":65.6366305680316,
      "humidity":21.3333366666
      },
    "LastActivityTime": "2019-08-2011:00:00"
    },
    {
    "Id":"B25B5E21-326E-4C36-9296-C195286DGEE9",
    "ConnectionState":true,
    "ConnectionStateUpdatedTime":"2019-08-2911:00:00",
    "DeviceReportedProperties":{
      "temperature":62.8366305680316,
      "humidity":19.5333366666
    },
    "LastActivityTime": "2019-08-2011:00:00"
     }
  ]
}

장치 등록

장치 등록 작업은 장치 또는 장치 컬렉션과 IoT 공급자 간의 연결을 생성합니다. 기술자가 교체한 새로운 장치와 장치 또는 구성 요소를 등록할 수 있습니다. 장치를 등록하면 IoT 장치 레코드의 등록 기록 탭에 나타납니다.

한 번에 여러 장치를 등록할 수 있으므로 장치 등록 작업에는 EntityCollection이 입력으로 필요합니다. 다음 표에서는 EntityCollection의 매개 변수를 설명합니다.

매개 변수	Type	세부 사항
msdyn_iotdeviceid	string	문자열로 변환된 Connected Field Service의 GUID 장치 ID(msdyn_iotdevice)
msdyn_name	string	장치의 이름
@odata.type	string	엔터티의 OData 유형

샘플 입력:

{
  "EntityCollection": [
    {
      "msdyn_iotdeviceid": "5754578D-1F9A-4720-BC21-3C3042C05B2F",
      "msdyn_name": "Coffee maker 1",
      "@odata.type": "Microsoft.Dynamics.CRM.msdyn_iotdevice"
    },
    {
      "msdyn_iotdeviceid": "5754578D-1F9A-4720-BC21-3C3042C06C5F",
      "msdyn_name": "Coffee maker 2",
      "@odata.type": "Microsoft.Dynamics.CRM.msdyn_iotdevice"
    }
  ]
}

장치 등록 작업은 등록 결과를 직렬화된 JSON 형식으로 반환합니다. 다음 표에서는 RegistrationResultsJSON 출력의 매개 변수를 설명합니다.

JSON 속성	Type	세부 사항
ID	string	문자열로 변환된 Connected Field Service의 GUID 장치 ID(msdyn_iotdevice)
등록 상태	OptionSetValue	IoT 공급자의 Connected Field Service 등록 상태 값 및 레이블: - 192350000: 알 수 없음 - 192350001: 등록 취소됨 - 192350002: 진행 중 - 192350003: 등록됨 - 192350004: 오류 참고: OptionSet은 드롭다운 목록 컨트롤과 같이 레이블-값 매핑이 포함된 옵션 목록입니다.
DeviceId	string	IoT 공급자 시스템의 장치 ID
메시지	string	등록과 관련하여 Connected Field Service 사용자에게 보내는 자세한 메시지

샘플 출력:

{
   "RegistrationResultsJSON":[
      {
         "Id":"5754578D-1F9A-4720-BC21-3C3042C05B2F",
         "RegistrationStatus":{"Value":192350003},
         "DeviceId":"DeviceIdFromThirdPartyOrUserDefined",
         "Message":"Registration info/warning/error message"   
      },
      {
         "Id":"5754578D-1F9A-4720-BC21-3C3042C06C5F",
         "RegistrationStatus":{"Value":192350003},
         "DeviceId":"DeviceIdFromThirdPartyOrUserDefined",
         "Message":"Registration info/warning/error message"   
      }   
  ]
}

집계된 장치 판독값

집계된 장치 판독값 작업은 IoT 공급자로부터 집계된 장치 데이터를 가져옵니다. 집계 데이터는 Connected Field Service의 요약 타일에 장치 상태에 대한 빠른 스냅샷을 제공합니다.

집계 판독을 보여주는 Field Service의 IoT 장치 화면 스크린 샷.

다음 표에서는 집계된 장치 판독값 작업의 입력 매개 변수를 설명합니다.

매개 변수	Type	세부 사항
deviceId	string	문자열로 변환된 Connected Field Service의 GUID 장치 ID(msdyn_iotdevice)
측정값	string	JSON 형식의 측정 목록입니다. 예제는 다음 코드 조각을 참조하세요.

샘플 입력:

[
    {
        "Measure":"Humidity",
        "Aggregate":"Min",
        "TimeRangeType":"Days",
        "TimeRangeValue":7
    },
    {
        "Measure":"Temperature",
        "Aggregate":"Avg",
        "TimeRangeType":"Days",
        "TimeRangeValue":14
    }
]

집계된 장치 판독값 작업은 직렬화된 JSON 형식으로 측정값을 반환합니다. 다음 표에는 출력 매개 변수가 표시되어 있습니다.

JSON 속성	Type	세부 사항
measureOutput	string	JSON 형식으로 반환된 측정 값입니다. 예제는 다음 코드 조각을 참조하세요.

샘플 출력:

[
    {
        "Name":"Humidity",
        "Aggregate":"Min",
        "Unit":"F",
        "TimeRangeValue":7,
        "TimeRangeType":"Days",
        "Position":1,
        "Value":"39.13334"
    },
    {
        "Name":"Temperature",
        "Aggregate":"Avg",
        "Unit":"F",
        "TimeRangeValue":14,
        "TimeRangeType":"Days",
        "Position":2,
        "Value":"65.13334"
    }
]

집계된 장치 판독값 작업을 사용하지 않는 경우 집계된 장치 판독값은 장치 데이터 기록 엔터티를 기반으로 합니다.

장치 판독값 쿼리

장치 판독값 쿼리 작업은 IoT 공급자로부터 온도 및 습도와 같은 과거 장치 데이터를 가져와 시계열 차트로 표시합니다.

시간 경과에 따른 장치 온도 및 습도의 스크린샷.

다음 표에서는 장치 판독값 쿼리 작업의 입력 매개 변수를 설명합니다.

매개 변수	Type	세부 사항
From	datetime	ISO 형식의 판독(측정) 시작 시간. 예: "2020-04-10T13:51:55.781Z"
To	datetime	ISO 형식의 판독(측정) 종료 시간
IoTDeviceId	string	문자열로 변환된 Connected Field Service의 GUID 장치 ID(msdyn_iotdevice)
간격	string	ISO-8601 기간 형식에 지정된 플롯 포인트의 간격 크기. 예: 1분은 "PT1M", 1밀리초는 "PT0.001S"입니다. 모든 간격이 동일한 크기입니다. 1개월은 항상 30일로 변환되고 1년은 항상 365 일입니다.

샘플 입력:

{
    "From":"2023-04-01T18:05:37.661Z", 

    "To":"2023-05-31T18:05:37.661Z", 

    "IotDeviceId":"50fce36f-9e3e-ed11-bba3-000d3a8b1de9", 

    "Interval":"P1D"
}

장치 판독값 쿼리 작업은 직렬화된 JSON 형식으로 데이터를 반환합니다. 다음 표에는 출력 매개 변수가 표시되어 있습니다.

JSON 속성	Type	세부 사항
AggregatedDeviceReadings	String	JSON 형식으로 반환된 측정 값입니다. 예제는 다음 코드 조각을 참조하세요.

샘플 출력:

{
  "HVAC Unit 123": {
    "Temperature": {
      "2017-04-01T06:00:00Z": {
        "min": -29,
        "max": 62.59,
        "avg": 16.89,
        "sum": 4054.14,
        "count": 240
      },
      "2017-04-01T08:00:00Z": {
        "min": -29,
        "max": 62.59,
        "avg": 16.89,
        "sum": 4054.14,
        "count": 480
      }
    },
    "Humidity": {
      "2017-04-01T06:00:00Z": {
        "min": 10,
        "max": 48.3,
        "avg": 29.25,
        "sum": 7020.62,
        "count": 240
      },
      "2017-04-01T08:00:00Z": {
        "min": 10,
        "max": 48.3,
        "avg": 29.25,
        "sum": 7020.62,
        "count": 480
      }
    }
  }
}

장치 이벤트 가져오기

장치 이벤트 가져오기 작업은 장치 서비스 기록에서 이벤트를 가져와 장치 판독값 쿼리 작업으로 생성된 차트 하단에 핀으로 표시합니다. 자산 업그레이드를 마지막으로 수행한 시간 등 사용자 지정 엔터티를 포함할 수 있습니다.

시간 차트에 따른 장치 온도 및 습도 아래에 핀으로 표시된 이벤트의 스크린샷.

노트

새 작업을 만들지 않아도 됩니다. msdyn_IoTGetDeviceEvents 작업에 사용자 지정 플러그 인(예: 이벤트 만들기를 위한 플러그 인)을 등록합니다.

다음 표에서는 장치 이벤트 가져오기 작업의 입력 매개 변수를 설명합니다.

JSON 속성	Type	세부 사항
From	datetime	ISO 형식의 판독(측정) 시작 시간. 예: "2020-04-10T13:51:55.781Z"
To	datetime	ISO 형식의 판독(측정) 종료 시간
IoTDeviceId	string	문자열로 변환된 Connected Field Service의 GUID 장치 ID(msdyn_iotdevice)

샘플 입력:

{ 
    "IotDeviceId": "50fce36f-9e3e-ed11-bba3-000d3a8b1de9", 
    "From": "2023-06-12T18:57:54.864Z", 
    "To": "2023-06-12T19:57:54.864Z" 
}

장치 이벤트 가져오기 작업은 직렬화된 JSON 형식으로 데이터를 반환합니다. 다음 표에는 출력 매개 변수가 표시되어 있습니다.

JSON 속성	Type	세부 사항
이벤트 이름	string	이벤트 범주에 대한 간단한 설명 해당 범주의 모든 이벤트를 표시하거나 숨기려면 이를 사용하십시오.
타임스탬프	string	ISO 형식의 문자열로 형식화된 이벤트의 타임스탬프입니다. 이벤트 핀의 x축 타임스탬프
색상	string	16진수 코드 문자열로 제공되는 이벤트 핀의 색상입니다.
Description	string	사용자가 핀 위로 마우스를 가져가거나 핀을 선택하여 세부 정보를 볼 때 표시되는 이벤트에 대한 간단한 설명
ID	string	이벤트 ID입니다. 이름이거나 작업 주문 번호나 예약 확인 코드와 같이 사용자에게 친숙한 다른 값일 수 있습니다.
Entity	string	이벤트와 관련된 Dataverse 엔터티 이름입니다. 예: "msdyn_workorder"
URL	string	작업 주문 양식 링크와 같은 이벤트 세부 정보 페이지의 URL 엔티티 및 GUID를 전달하면 시스템이 자동으로 하이퍼링크를 생성합니다.
GUID	string	Dataverse에 있는 엔터티 레코드의 문자열로 변환된 GUID

샘플 출력:

{
  "Service History": {
    "2019-08-07T19:14:53Z": {
      "color": "#FF6300",
      "description": "Work Order Created",
      "id": "00001",
      "entity": "msdyn_workorder",
      "url": "",
      "guid": "952a7592-8818-ea11-a811-000d3a5466d7"
    },
    "2019-08-08T19:14:53Z": {
      "color": "#ECC5AC",
      "description": "Work Order Created",
      "id": "00002",
      "entity": "msdyn_workorder",
      "url": "",
      "guid": "952a7592-8818-ea11-a811-000d3a5466d9"
    },
    "2019-09-21T09:34:53Z": {
      "color": "#ECC5AC",
      "description": "Case Created",
      "id": "000121",
      "entity": "msdyn_incident",
      "url": "",
      "guid": "952a7592-8818-ea11-a811-000d3a5466d0"
    }
  },
  "Asset History": {
    "2019-08-07T19:14:53Z": {
      "color": "#FF6400",
      "description": "Asset Model Upgraded",
      "id": "001223",
      "entity": "new_assetupgraded",
      "url": "",
      "guid": "952a7592-8818-ea11-a811-000d3a5466d7"
    }
  }
}

다음을 통해 공유

IoT 공급자 작업 설정

장치 데이터 끌어오기

장치 등록

집계된 장치 판독값

장치 판독값 쿼리

장치 이벤트 가져오기

다음 단계

피드백

추가 리소스