Edit

Use custom IoT providers

  • Article

The Dynamics 365 Field Service IoT provider feature allows seamless integration with IoT (Internet of Things) devices from any IoT vendor. It integrates IoT alerts from different vendors in a unified list regardless of their origin. When users interact with an IoT device, Field Service identifies the device's provider and routes the command to the corresponding IoT system.

In Field Service, the out-of-box deployment experience integrates with Azure IoT Hub. Developers, partners, and independent software vendors (ISVs) can build custom IoT solutions on this framework and even publish them in the Microsoft AppSource marketplace.

In this article, you'll learn about the IoT provider data model and get an overview of the connection methods you can use.

Prerequisites

  • Experience developing model-driven apps that connect to Dynamics 365 and Microsoft Dataverse
  • Programming experience with C#, .NET, and Visual Studio
  • Familiarity with the REST/OData API

Field Service data model

All the methods to integrate external IoT services with Field Service must fit the Field Service IoT provider data model, which consists of three related tables (IoT Provider, IoT Provider Instance, and IoT Device) and a table of IoT settings.

Diagram of the Field Service IoT provider data model.

IoT Provider table

The IoT Provider table identifies your organization's IoT providers and the actions they support.

Screenshot of an IoT provider record.

IoT Provider Instance table

A 1:many relationship exists between the IoT Provider table and the IoT Provider Instance table. For example, if your organization is connected to two different Azure IoT Hubs, you have one IoT provider record for Azure IoT Hub and two IoT provider instance records, one for each of your IoT Hubs. You can view the list of IoT provider instances in Field Service Settings > IoT > Providers.

Screenshot of an IoT provider instance record.

  • Provider Instance Id identifies the instance in your source IoT system.
  • URL could be one that's used in your provider code or the user experience; for example, an API endpoint or a link to the Azure resource group of the deployment.

IoT Device table

A 1:many relationship exists between the IoT Provider Instance table and the IoT Device table, which maps each device to an IoT provider instance.

  • Account identifies the customer account in Field Service that's associated with the device.
  • Category is the device category.
  • Time Zone is the time zone in which the device is located.
  • Device Id is used to register the device with the IoT provider.
  • Simulated is used in development and testing.

Connection methods and development tools

Connection methods for custom IoT solutions come with both advantages and risks. The following table describes them.

Method Advantages Risks
Dataverse API - Allows direct communication between Connected Field Service and external services.
- Robust protocol for building software applications.
- External services must be able to integrate with APIs.
- Requires strong understanding of Connected Field Service API capabilities.
Webhooks Sends real-time updates to an external service when specific actions are taken in Connected Field Service. External service needs to be able to receive and process webhook messages.
Connectors Provides a seamless integration experience and acts as a bridge between Connected Field Service and the external service. Requires more robust technical knowledge and development resources.
Custom code Highly tailored and effective integration. Requires high level of technical expertise; may involve more risk than other methods.

Commonly used development tools to build custom solutions for Connected Field Service:

  • Microsoft Power Apps is a low-code development platform that allows makers and pro developers to create custom business applications quickly and easily.

  • Microsoft Azure Functions is a service that allows developers to run code on demand without dedicated servers.

  • Microsoft .NET Framework is a software development framework for building and running applications on Windows.

  • Microsoft Visual Studio is a popular integrated development environment that supports a wide range of programming languages and frameworks, including .NET, JavaScript, and Python.

  • JavaScript is a widely used programming language that's often used with other tools and frameworks, such as Node.js and React.

  • REST APIs provide a standardized way for applications to communicate with each other over the web. Connected Field Service provides many REST APIs that can be used to integrate with external services and build custom solutions.

Next steps