Appointment entities

Applies to Dynamics 365 (online), version 9.x

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 BookRequest message or the 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 theIOrganizationService.Create method or 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.

In This Section

Schedule and appointment entities

Schedules in Dynamics 365

Appointment Entity

ServiceAppointment Entity