title

description

ms.custom

ms.date

ms.reviewer

ms.suite

ms.tgt_pltfrm

ms.topic

applies_to

ms.assetid

author

ms.author

search.audienceType

Appointment entities (Developer Guide for Dynamics 365 Customer Engagement) | MicrosoftDocs

Overview of the appointment entity, which represents a commitment over a time interval with start and end times and a duration.

10/31/2017

pehecke

article

Dynamics 365 Customer Engagement (on-premises)

0e1254fa-d7a1-42a5-840c-cd26162c1f48

JimDaly

jdaly

developer

Appointment entities

An appointment is a commitment that represents a time interval with start and end times and duration. The schema name for this entity is Appointment. A service appointment represents an appointment for service. The schema name for this entity is ServiceAppointment. A service appointment can be customized independently from other activities to accommodate the customer's business requirements for service delivery. Service appointments can block the availability of required resources and participate in resource availability searches and scheduling. A service appointment must have a corresponding service. It can be already bound with a set of resources specified by an activity party (ActivityParty) list.

To create an appointment by making sure that the constraints are met, use the xref:Microsoft.Crm.Sdk.Messages.BookRequest message or the xref:Microsoft.Crm.Sdk.Messages.RescheduleRequest message. The scheduling engine stores the booked appointment and adjusts the free/busy information for the resource. You can create an appointment at a specific time for a specific service that uses a specific set of resources, ignoring all constraints, by using thexref:Microsoft.Xrm.Sdk.IOrganizationService.xref:Microsoft.Xrm.Sdk.IOrganizationService.Create* method or xref:Microsoft.Xrm.Sdk.Messages.CreateRequest message.

Appointments can block the availability of the required resources. Appointments can be blocking, specified as part of the service definition or per appointment instance, for other appointments at the same interval.