AddMeeting Method

  • Article
  • 3 minutes to read

AddMeeting Method

The AddMeeting method of the Meetings service associates a meeting with the Meeting Workspace site on the specified Microsoft Windows SharePoint Services server.

Parameters

organizerEmail   The e-mail address, specified as email_address@domain.ext, for the meeting organizer.

uid   A persistent GUID for the calendar component.

sequence   An integer used to determine the ordering of updates in case they arrive out of sequence. Updates with a lower-than-current sequence are discarded. If the sequence is the same as the current sequence, the latest update will be applied.

utcDateStamp   The date and time that the instance of the iCalendar object was created.

title   The title (subject) of the meeting.

location   The location of the meeting.

utcDateStart  The start date and time for the meeting, expressed in UTC.

utcDateEnd   The end date and time for the meeting, expressed in Coordinated Universal Time (UTC).

nonGregorian  true if the calendar is set to a format other than Gregorian; otherwise, false. Setting this parameter to true puts the following message in the summary data of the meeting workspace: "This meeting was created using a calendar and scheduling program that only supports series updates to the Meeting Workspace. Changes you make to individual occurrences of meetings in that program will not appear in the workspace."

Return Value

A Microsoft.SharePoint.SoapServer.SoapXml object that contains the following:

<?xml version="1.0" encoding="utf-8"?><soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">

<soap:Body>

<AddMeetingResponse xmlns="http://schemas.microsoft.com/sharepoint/soap/meetings/">

<AddMeetingResult>

<AddMeeting Url="http://server_name/Test?InstanceID=1" HostTitle="Team Web Site" UniquePermissions="true" MeetingCount="1" AnonymousAccess="false" AllowAuthenticatedUsers="false" />

<AttendeeUpdateStatus Code="12" Detail="Some users could not automatically be granted permissions to the workspace." ManageUserPage="http://spserver1/Test/_layouts/1033/user.aspx" />

</AddMeetingResult>

</AddMeetingResponse>

</soap:Body></soap:Envelope>

Url The URL to the Meeting Workspace site that you added the meeting to. It contains a query string that gives you the InstanceID of the meeting added.

InstanceID   Identifies this meeting instance in the site that contains single instance meetings. If the site contains a recurring meeting, '?InstanceID=' is not appended to the URL. 'AdMode=1' may be appended to the URL as a query string if this site is configured in AdAccountCreation mode.

HostTitle   The title of the parent site; if the title of the parent is an empty string, this would return the URL of the parent.

UniquePermissions   'true' or 'false' indicating whether this site was created with unique permissions.

MeetingCount   Returns the number of meetings associated with this workspace. If this workspace contains a recurring meeting, this will return -1.

AnonymousAccess   'true' or 'false' indicating whether the Allow Anonymous Access feature has been enabled on this workspace.

AllowAuthentictedUsers   'true' or 'false' indicating whether the Allow Authenticated Users feature has been enabled on this workspace.

Exceptions

This method only works with Meeting Workspace sites. If you try to call this method against a site that is not a Meeting Workspace site, this method generates a SOAP exception. The exception will look like the following:

<?xml version="1.0" encoding="utf-8"?>

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">

  <soap:Body>

    <soap:Fault>

      <faultcode>soap:Server</faultcode>

      <faultstring>Exception of type Microsoft.SharePoint.SoapServer.SoapServerException was thrown.</faultstring>

      <detail>

        <errorstring xmlns="http://schemas.microsoft.com/sharepoint/soap/">Your attempt to add a meeting to a Meeting Workspace could not be completed. The specified location is not a Meeting Workspace. Specify a different location or contact the Web site administrator.</errorstring>

        <errorcode xmlns="http://schemas.microsoft.com/sharepoint/soap/">0x00000006</errorcode>

      </detail>

    </soap:Fault>

  </soap:Body>

</soap:Envelope>

Remarks

The AddMeeting method is basically the non-iCal version of the AddMeetingFromICal method. As in the AddMeetingFromICal method, the organizerEmail parameter is used to indicate the organizer of the meeting when the organizer is a delegate.

Note that attendees cannot be added to the Meeting Workspace by using this method. Also, you cannot add a recurring meeting by using this method.

Example

The following code creates a Meeting Workspace site and adds a meeting to it. Note that the ServerURLTextBox, MeetingSubjectTextBox, MeetingLocationTextBox, DTSTARTTextBox, DTENDTextBox, and CreateWorkspaceButton are all interface elements that are on a form in the Visual Basic .NET project.

SOAP Request Format

The following is a sample SOAP request. The placeholders shown need to be replaced with actual values.

POST /_vti_bin/meetings.asmx HTTP/1.1
Host: server_name
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://schemas.microsoft.com/sharepoint/soap/meetings/AddMeeting"

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <AddMeeting xmlns="http://schemas.microsoft.com/sharepoint/soap/meetings/">
      <organizerEmail>string</organizerEmail>
      <uid>string</uid>
      <sequence>unsignedInt</sequence>
      <utcDateStamp>dateTime</utcDateStamp>
      <title>string</title>
      <location>string</location>
      <utcDateStart>dateTime</utcDateStart>
      <utcDateEnd>dateTime</utcDateEnd>
      <nonGregorian>boolean</nonGregorian>
    </AddMeeting>
  </soap:Body>
</soap:Envelope>

SOAP Response Format

The following is a sample SOAP request. The placeholders shown will be replaced with actual return values.

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <AddMeetingResponse xmlns="http://schemas.microsoft.com/sharepoint/soap/meetings/">
      <AddMeetingResult>
        <xsd:schema>schema</xsd:schema>xml</AddMeetingResult>
    </AddMeetingResponse>
  </soap:Body>
</soap:Envelope>

Requirements

Platforms: Microsoft Windows Server 2003

Web Reference: http://Server_Name/[sites/][Site_Name/]_vti_bin/Meetings.asmx