UpdateMeetingFromICal Method

Article
03/25/2009

The UpdateMeetingFromICal method of the Meetings service updates meeting information stored in Internet Calendar (iCal) format.

Parameters

icalText The iCal representation of the updated meeting.

ignoreAttendees true if you want to skip processing of attendee information in the iCal; otherwise, false.

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>
<UpdateMeetingFromICalResponse xmlns="http://schemas.microsoft.com/sharepoint/soap/meetings/">
<UpdateMeetingFromICalResult>
<UpdateMeetingFromICal>
<AttendeeUpdateStatus Code="0" Detail="" ManageUserPage="" />
</UpdateMeetingFromICal></UpdateMeetingFromICalResult>
</UpdateMeetingFromICalResponse>
</soap:Body></soap:Envelope>

If attendees are processed in this call and there are issues during the attendee processing, this method will return additional information. In particular, it will detect when all the users could not be resolved and when the quota limit is exceeded.

If all the users could not be resolved, the error code of the error returned will be 12, and the Manage User Page will point to aclinv.aspx, together with a list of the users that could not be resolved, as shown in the XML response below.

<?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><UpdateMeetingFromICalResponse xmlns="http://schemas.microsoft.com/sharepoint/soap/meetings/">
<UpdateMeetingFromICalResult>
<UpdateMeetingFromICal>
<AttendeeUpdateStatus Code="12" Detail="Some users could not automatically be granted permissions to the workspace." ManageUserPage="http://myServer/Test Meeting/_layouts/1033/aclinv.aspx?users=bademail1@bad.com,bademail2@bad.com&;rights=Contributor" /></UpdateMeetingFromICal>
</UpdateMeetingFromICalResult>
</UpdateMeetingFromICalResponse>
</soap:Body>
</soap:Envelope>

If the quota limit is exceeded, the error code of the error returned will be 11, and the Manage User Page will point to user.aspx (for example, to "http://myserver/Test Meeting/_layouts/1033/user.aspx").

Exceptions

This method will only work with Meeting Workspace sites. If you try to call this method against a non-Meeting Workspace site, this method will generate a SOAP exception. The exception will look like this:

<?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>

The method will return the exception above if an empty iCal string is passed in the iCalText parameter. The error code will be 0x00000005, and the error string will read as follows: "Your attempt to update the Meeting Workspace site could not be completed. There was no information to send to the workspace."

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/UpdateMeetingFromICal"

<?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>
    <UpdateMeetingFromICal xmlns="http://schemas.microsoft.com/sharepoint/soap/meetings/">
      <icalText>string</icalText>
      <ignoreAttendees>boolean</ignoreAttendees>
    </UpdateMeetingFromICal>
  </soap:Body>
</soap:Envelope>

SOAP Response Format

The following is a sample SOAP response. 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>
    <UpdateMeetingFromICalResponse xmlns="http://schemas.microsoft.com/sharepoint/soap/meetings/">
      <UpdateMeetingFromICalResult>
        <xsd:schema>schema</xsd:schema>xml</UpdateMeetingFromICalResult>
    </UpdateMeetingFromICalResponse>
  </soap:Body>
</soap:Envelope>

Requirements

Platforms: Microsoft Windows Server 2003

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

Share via