BookRequest 클래스

아티클
07/17/2015

Contains the data that is needed to schedule or “book” an appointment, recurring appointment, or service appointment (service activity).

네임스페이스: Microsoft.Crm.Sdk.Messages
어셈블리: Microsoft.Crm.Sdk.Proxy(Microsoft.Crm.Sdk.Proxy.dll에 있음)

구문

‘선언
<DataContractAttribute(Namespace:="https://schemas.microsoft.com/crm/2011/Contracts")> _
Public NotInheritable Class BookRequest
    Inherits OrganizationRequest

[DataContractAttribute(Namespace="https://schemas.microsoft.com/crm/2011/Contracts")] 
public sealed class BookRequest : OrganizationRequest

예제

The following example shows how to use this message. For this sample to work correctly, you must be connected to the server to get an IOrganizationService interface. For the complete sample, see the link later in this topic.


// Get the current user information
WhoAmIRequest userRequest = new WhoAmIRequest();
WhoAmIResponse userResponse = (WhoAmIResponse)_serviceProxy.Execute(userRequest);

// Create the ActivityParty instance.
ActivityParty party = new ActivityParty
{
    PartyId = new EntityReference(SystemUser.EntityLogicalName, userResponse.UserId)
};

// Create the appointment instance.
Appointment appointment = new Appointment
{
    Subject = "Test Appointment",
    Description = "Test Appointment created using the BookRequest Message.",
    ScheduledStart = DateTime.Now.AddHours(1),
    ScheduledEnd = DateTime.Now.AddHours(2),
    Location = "Office",
    RequiredAttendees = new ActivityParty[] { party },
    Organizer = new ActivityParty[] { party }                        
};                    

// Use the Book request message.
BookRequest book = new BookRequest
{
    Target = appointment
};
BookResponse booked = (BookResponse)_serviceProxy.Execute(book);
_appointmentId = booked.ValidationResult.ActivityId;

// Verify that the appointment has been scheduled.
if (_appointmentId != Guid.Empty)
{
    Console.WriteLine("Succesfully booked {0}.", appointment.Subject) ;
}

설명

Message Availability

이 메시지가 작동하려면 호출자가 서버에 연결되어야 합니다.

Usage

Pass an instance of this class to the Execute method, which returns an instance of the BookResponse class.

Privileges and Access Rights

To perform this action, the caller must have privileges on the specified entity in the Target property and access rights on the specified record in the Target property. For a complete list of the required privileges, see Book Privileges.

Supported Entities

다음 표에서는 이 메시지를 지원하는 기본 엔터티를 보여 줍니다. 나열된 엔터티에 대해 이 메시지를 사용할 수 있으려면 호출자가 서버에 연결되어야 합니다.

Entity	Availability
appointment	Server
recurringappointmentmaster	Server
serviceappointment	Server

상속 계층

System.Object
Microsoft.Xrm.Sdk.OrganizationRequest
Microsoft.Crm.Sdk.Messages.BookRequest

스레드 보안

이 형식의 공용 정적(Visual Basic에서는 Shared) 구성원은 스레드로부터 안전합니다. 인스턴스 구성원은 스레드로부터 안전하지 않을 수 있습니다.

플랫폼

Development Platforms

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

Target Platforms

Windows Server 2008,Windows Server 2012,Windows 7

Change History

참고 항목

참조

BookRequest 구성원
Microsoft.Crm.Sdk.Messages 네임스페이스
Create a Recurring Appointment Series
BookResponse

기타 리소스

Schedule and Appointment Entities
Sample: Book an Appointment

다음을 통해 공유