Create work order templates with incident types

Incident types act as service templates that allow users to quickly create work orders for the most common types of jobs that your organization performs. Incident types are also used to define specific work order issues and recommended resolutions.

Where work order types define the general category of a work order (for instance: inspection, repair, or maintenance), incident types define the specific request of a work order and effectively add more details to the work order type.

For example, an incident type can be:

  • A specific error code on a machine ("Error code 0048").
  • A common customer complaint or request ("The building temperature is too hot").
  • A specific procedure ("Perform stress test").

Most importantly, adding an incident type to a work order can provide other details like duration, work order service tasks, products, services, and characteristics (skills). This means incident types effectively serve as work order templates that prepopulate information, which can be manually edited as needed.

Organizations benefit from using incident types because they codify issues, procedures, and resolutions, and help standardize processes across geographies and business lines. This ensures all field technicians are performing the same actions to resolve work orders, and if better procedures are discovered, the incident type is updated and implemented across the entire organization.

Using incident types also saves time while creating work orders. Without using incident types, the customer service reps or dispatchers creating work orders would have to manually add details.

Finally, incident types are helpful for reporting because they allow you to see trends for specific issues. Rather than reporting on work order types to understand the number of repair work orders, an incident type lets you report on the number of power failures for a specific asset category, for example.

Other important incident type features include:

  • Multiple incident types can be added to a work order to define multiple issues or procedures that need to be completed.

  • Each incident type can be related to a customer asset to build service history.

  • Relating incident types to requirement group templates allows you to auto-populate multiple requirements for a work order and schedule it to multiple resources.

Prerequisites

  • Incident types are available for all versions of Dynamics 365 Field Service. However, using incident types with requirement group templates for multi-resource scheduling is only available with Field Service v8.0+.

  • Because incident types mostly represent a grouping of service tasks, products, and services, we recommend having these records created in the system before creating an incident type. Each of the following can be created in Field Service > Settings:

    • A service task is a checklist item that field technicians should complete as part of performing an incident type.

    • A product is a part that can be used when completing an incident type and can be billed to the customer and deducted from inventory if necessary. For more information, visit our topic on creating a product or service.

    • A service is labor that can be billed to the customer. Note: There is no Service entity. A service is created by creating a product record with Field Service Type = Service.

      Screenshot of the Field Service side navigation menu, with Products and Service Task Types highlighted

The service tasks, products, and services you create will serve as the building blocks of incident types and can be associated to multiple incident types as needed. For example, if "Put on safety goggles" is a service task that needs to be completed as part of many or all incident types, you simply create this service task once and associate it to the relevant incident types. This means there is one list of unique service tasks that are added to incident types, and this creates Incident Type Service Task records. The same is true for products, services, and characteristics.

Create an incident type

To create an incident type, go to Field Service > Settings > Incident Types > +New.

Enter a Name and a Description.

Screenshot of a new incident type

On the Details tab, see the following fields:

  • Default Work Order Type: The work order type selected here will populate the work order type field on the work order when this incident type is entered as the primary incident type. It will overwrite previously entered work order types. This is convenient because an incident type should be related to a larger category. Entering a work order type will not populate an incident type.

    Note

    A default price list can be added to a work order type. This means you can add a primary incident type that adds a work order type and the work order type will add a price list. This further saves time with automatic data population.

  • Estimated Duration: Enter a duration for this incident type. If you add multiple incidents to a work order, the work order duration will be the total of all incident durations as reflected in the resource requirement related to the work order. Service tasks can also each have a duration, in which case the estimated duration of the incident type will be the sum total of the incident service task durations. The only way you can use the estimated duration field as the duration of the incident type is if you don't add incident type service tasks, or none of the incident type service tasks you add have durations. If this incident type is set as the primary incident type of a work order, this value will populate the primary incident type duration field.

    Screenshot of incident type entity showing the details tab

  • Copy Incident Items to Agreement: This setting is only important for when you use incident types as part of agreements. It dictates if agreement "items" including service tasks, products, services, and characteristics (skills) should be added when this incident is added to the agreement. See the configuration considerations section at the end of this article for more details.

After setting basic details for the incident type, consider also adding:

  • Recommended products and services that field technicians might need to complete the incident type.
  • Service tasks to guide field technicians through a checklist of tasks.
  • Characteristics (skills) that will help schedulers find the right resources to perform work orders that this incident type is added to. When this incident type is added to a work order, the related items will be added as well.

Incident type product

Next, add an incident type product by going to the product tab and selecting +New Incident Type Product.

Select a Product and Unit.

Enter a Quantity. This is the number of work order products that will be added to the work order when this incident is added. It can be manually overridden by the work order creator as needed. However, if, for example, a process or procedure generally requires two units of a part to complete the job, you should enter 2 here.

Screenshot of an incident type product entity

Enter a Name if you want the eventual work order product to have a different name than the product name.

For scenarios where multiple products are added as part of an incident type, Line Order is a numeric value that can be used to define the order in which they appear on the work order product list. This is true for service tasks and service, too.

Because the Description field can be communicated to the customer or even be customized to appear on an invoice, there is also an Internal Description to provide additional details for the field technician.

Incident type service

Similar to incident type products, add incident type services.

Screenshot of a new incident type service entity

The only difference between incident type products and services is that instead of quantity, there is a Duration field to represent the service time because a service represents labor and not a physical part.

Incident type service tasks

Next, go to Service Tasks and select +New Incident Type Service Task.

Select a Task Type or create a new one in the system.

Screenshot of an incident type service task

If the task type you select has a duration, it will populate in the Estimated Duration field of the incident type service task and can be adjusted for this specific incident as needed. As you add incident service tasks, the duration of the incident type will be the sum of the service task durations. If you do not want the incident duration to be derived from service task durations, then you should either set the incident service task duration to 0 minutes or null for all incident service task types, or consider removing durations from the original task type.

The order in which you add service task types is the order in which they'll appear on the work orders when this incident is added. The order of service tasks is generally important for organizations and reflects a process that should be followed. It is common for organizations to have as many as 40 service tasks for a detailed process.

After saving, you can edit the Line Order field as needed to change the order of service tasks where "1" is the service task that will appear first.

After adding multiple service tasks, they will display in the incident service task list. In the following screenshot example, none of the individual service tasks were given an estimated duration because we chose to add an estimated duration at the incident type level instead.

Screenshot of the incident types list

Incident type characteristics

Next, you can associate characteristics (skills) to incident types in order to define the skillset needed to perform the incident type. Characteristics are also added to resources (field technicians) and this helps the system match work order incidents with the best resources who can do the job. This also means when this incident is added to a work order and scheduled, the schedule assistant and resource scheduling optimization will consider the associated characteristics.

Note

If you want to use Requirement Groups with Incident Types for multi-resource scheduling, do not add characteristics (skills) to the incident type. Instead, you should add required characteristics to the requirement group template. See the topic on requirement groups for work orders for more details.

Go to Characteristics and select +New Incident Type Characteristic.

Select a Characteristic from the look-up field or create a new one.

Characteristics are a versatile way to define the resource attributes needed to perform an incident type.

Examples include:

  • Skills, such as "JavaScript and HTML"
  • Language proficiency, such as "Spanish"
  • Certifications, such as "CPR certifications"
  • Security clearance, such as "Building 12 access"

When characteristics are added to a resource, you can define the level of proficiency of the resource. For example, one resource might be excellent at speaking Spanish, but another might be just adequate. Rating Value allows you to set the level of expertise required to perform this incident type. This means a resource must meet or exceed the rating value to be considered when attempting to schedule work orders this incident type will be added to. If left blank, this means all proficiency levels are acceptable given the resource has the matching characteristic. You can define rating values in Resource Scheduling > Settings > Proficiency Models.

Add an incident type to a work order

Now we're ready to use the incident type by adding it to a work order. From our incident type products, services, service tasks, and characteristics, the system will create work order products, services, service tasks, and characteristics.

In the Primary Incident Type field, we will look up and add our newly created incident type.

This populates the following fields:

  • Primary Incident Description
  • Primary Incident Estimated Duration
  • Work Order Type

Screenshot of a work order, with the work order type and incident type highlighted

Not immediately, but after a short time, the related work order products, services, and service tasks will be added. This is the result of a system job called LongJobs_CopyIncidentItemsToWorkOrder number 464.

Screenshot of a work order product tab

The Estimate Quantity of the work order product reflects the incident product quantity we specified.

Screenshot of work order product information, on the estimate information tab

The same is true for Work Order Services and Estimate Duration.

Also, the work order service tasks are added to the work order in the order reflected on the incident type.

Screenshot of a work order, on the service tasks tab

Select the Related tab, and then Characteristics. The incident type characteristics are added as requirement characteristics.

Screenshot of the characteristics tab on a work order

In order to appropriately schedule this work order, the related Resource Requirement has a Duration equal to the incident type duration (2 hours in our example) and the characteristic is passed along as well.

Screenshot of a resource requirement

The requirement record is used for scheduling, so when you select Book from the work order or requirement, the duration and characteristic (with rating value) are used as filters, both of which originated with the incident type.

Screenshot of the schedule board filter view with characteristics populated

Finally, after it's scheduled, the field technician will receive the booked work order along with the incident and related details.

Screenshot of Field Service Mobile work order, with the populated information highlighted

Add multiple incident types to a work order

The primary incident type field is a great way to define the main purpose of a work order. However, you can also add multiple incident types to a work order. For example, perhaps a machine has multiple issues or multiple machines need to be worked on. This implies all incidents should be performed by the dispatched resource. Adding multiple incidents to a work order will add on to the duration and existing service tasks, products, services, and characteristics.

Go to Related > Incidents > +New Incident Type and add another incident.

Screenshot of multiple incidents in the incidents list

Screenshot of a work order incident information form

Though the primary incident estimated duration will not change, the duration of the related resource requirement will be increased by the new incident's duration.

In the following screenshot, we can see the requirement duration was increased to 4.5 hours and another characteristic was added to the work order requirement.

Screenshot of a resource requirement with populated duration

Back on the work order, the second incident's products, services, and service tasks were added as well. It's common for incident types to have overlapping service tasks, and duplicates will be added, so consider if this is right for your business processes.

Screenshot of a work order on the products tab

The order of the service tasks reflects the order in which incidents are added.

When attempting to book a work order with multiple incidents, the schedule assistant and Resource Scheduling Optimization will look for a single resource with time availability to complete all incidents and has all the matching characteristics. In the case of the schedule assistant, these filters can be edited at the time of scheduling as needed.

Screenshot of the scheduling assistant

Use customer assets with incident types

Incident types can also be related to customer assets to tell field technicians which asset needs attention and build a service history. You can have all incidents related to the same asset or even have each incident related to different customer assets as needed.

For the primary incident type, simply populate the Primary Incident Customer Asset field. This field is filtered to only show customer assets related to the work order service account by default.

Screenshot of a work order, showing the Primary Incident Customer Asset field

For other work order incident types, go to the Incident Relates To section and associate a customer asset.

Once a work order incident and customer asset are associated, you will see the work order on the customer asset record, along with all previous work orders related to the asset. This can be displayed on the mobile app for field technicians to better understand the history of the part they are working on.

Screenshot of the customer asset entity with related work orders highlighted

Incidents for multi-resource scheduling

If an incident type should be completed by multiple resources, relate the incident type to a requirement group template. This will add a requirement group to the work order when the incident is added. Scheduling requirement groups for work orders ensures each resource arrives on site at the same time.

There are a few important notes when using incidents with requirement groups:

  • You can't add characteristics to the incident type or directly to the work order. This is because you should add required characteristics in the requirement group template.
  • The work order can only have one incident.

For more information, see the topic on requirement groups for work orders.

Note

Multiple incidents vs. requirement group templates: If you know a work order should be performed by multiple resources, we highly recommended using requirement group templates versus multiple incident types. Let's say you have a work order with two incident types, each requiring different skills. When attempting to book the work order, the system will look for a single resource (including crews) to fulfill the job. The scheduler would need to perform extra steps, like editing filters or selecting Book twice, to schedule it to two different resources to arrive at the same time. However, if you use a requirement group template, the schedule assistant will simultaneously search for both a single resource with both skills or two resources each with one skill to arrive at the same time.

Configuration considerations

  • The Copy Incident Items to Agreement field during the incident type setup is important for two reasons:

    • The incident you would like to add to an agreement might be slightly different than the incident you would add to a single work order that's not part of an agreement. For example, normally the incident would require 1 hour of a service, but for the agreement, you negotiated with the customer 2 hours of a service. Rather than having to create a second incident type just for this agreement, you can set Copy Incident Items to Agreement to No, add the incident to the agreement, then manually add the specific service tasks, product, services, and so on. This way you can use the same incident type, which helps for reporting later on. Set this option to Yes and the incident items will be added to the agreement and you can accept these items or make slight variations from there.

      If set to Yes, agreement items will be created.

      Screenshot of an agreement booking setup record, on the Services tab, with a listed service

      If set to No, they will not.

      Screenshot of an agreement booking setup record, on the Services tab, with no listed services

    • Incidents can be added to agreements for recurring work. This means agreements will generate work orders with predefined work order incidents attached. However, as mentioned earlier in this topic, incidents can be edited as processes and procedures change. But agreements can span multiple months and even years, so should the agreement use the original incident type at the time of agreement creation, or use the latest changes to the incident type? This could result in different work being performed than originally intended at the end of the agreement.

      Set to Yes if the incident should remain the same throughout the agreement life span by copying the incident details to the agreement at the time of agreement activation. Set to No if the work orders generated from the agreement should grab the latest incident type details when the work orders are generated from the agreement, which is generally at an ongoing basis depending on the Generate Work Orders X Days In Advance field on Agreement Booking Setup.

  • There is a Resolution tab on the Work Order Incident to document whether the incident was completed.

  • In the case of adding multiple incident types to a work order, if doing so adds two or more of the same characteristic (skill), the scheduling logic will use the most restrictive of the skills to match resources. For example, if one incident type adds the characteristic "Spanish" with a "Good" rating value, and another incident adds "Spanish" with an "Excellent" rating value, the schedule assistant and resource scheduling optimization will look for resources that are excellent in Spanish, because it has a higher value and is deemed more restrictive.

  • Crews will display in schedule assistant results for work orders with multiple incidents because the system views crews as a single resource. Currently, resource scheduling optimization does not schedule crews.

Screenshot of the filter view on the schedule board, with characteristic rating and resource types fields highlighted

Understanding incident entities

There are multiple entities involved in using incident types, and you should be aware of them when you'd like to write workflows or other plug-ins. First let's consider a simple example with an incident type with one product.

Work order scenario

Incident Type > Incident Product > Work Order Incident > Work Order Incident Product

First an Incident Type is created and a product is added to the incident creating an Incident Product. When the incident type is added to a work order, a Work Order Incident is created along with a Work Order Incident Product.

Agreement scenario

Incident Type > Incident Product > Agreement Incident > Agreement Product > Work Order Incident

When using incidents with Agreements, the incidents and related items are added to agreements first, and then passed along to work orders as they are generated by the agreement.

Additional notes

Only one work order incident can be the primary incident and this is either the first incident added or the one entered in the primary incident type field. There is a Boolean value on the work order incident type called Is Primary that indicates this and can be used for business logic.

Implementing incident types

  • Incidents should be created for issues that are common or for issues that have a specific process. If you'd like better reporting for issues, consider making incidents for them as well.
  • Incidents should be more specific than work order types, but not too specific as to not be reusable.
  • Ask customers if they maintain a list of most common work order issues. Often they do and these can be imported into Dynamics 365 through Excel as a start to configuring incidents.
  • When setting up incident types for the first time, we recommend not to create too many too quickly as customers might end up using incident types differently than intended. For example, a customer might perform a safety test on three different models of a machine. Rather than creating three safety test incidents, one for each model, simply start with one incident type that can be used on work orders for all three models. Then determine at a later date if more are needed.
  • By default, work order service tasks have a field called % Complete that field technicians can use to record their progress completing each service task. It's common to replace this field or add another simple yes-or-no field. It's also common to use custom Offline HTML and JavaScript on Field Service Mobile to prevent field technicians from completing a work order until all work order service tasks are complete.

Maximizing incidents

  • Consider using Azure Machine Learning to improve the estimated durations of incidents types. This means adjusting the duration of incidents as they are completed based on the actual duration of the work order.
  • Correlating incident types with IoT alerts generated from Connected Field Service can streamline issues and resolutions and improve the organization's first-time fix rate.

See also