Share via


Meetings.UpdateMeetingFromICal Method

Updates meeting information stored in Internet Calendar (iCal) format.

Namespace:  [Meetings Web service]
Web service reference: http://Site/_vti_bin/Meetings.asmx

Syntax

'Declaration
<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sharepoint/soap/meetings/UpdateMeetingFromICal", RequestNamespace := "https://schemas.microsoft.com/sharepoint/soap/meetings/",  _
    ResponseNamespace := "https://schemas.microsoft.com/sharepoint/soap/meetings/",  _
    Use := SoapBindingUse.Literal, ParameterStyle := SoapParameterStyle.Wrapped)> _
Public Function UpdateMeetingFromICal ( _
    icalText As String, _
    ignoreAttendees As Boolean _
) As XmlNode
'Usage
Dim instance As Meetings
Dim icalText As String
Dim ignoreAttendees As Boolean
Dim returnValue As XmlNode

returnValue = instance.UpdateMeetingFromICal(icalText, _
    ignoreAttendees)
[SoapDocumentMethodAttribute("https://schemas.microsoft.com/sharepoint/soap/meetings/UpdateMeetingFromICal", RequestNamespace = "https://schemas.microsoft.com/sharepoint/soap/meetings/", 
    ResponseNamespace = "https://schemas.microsoft.com/sharepoint/soap/meetings/", 
    Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)]
public XmlNode UpdateMeetingFromICal(
    string icalText,
    bool ignoreAttendees
)

Parameters

  • icalText
    Type: System.String

    The iCal representation of the updated meeting.

  • ignoreAttendees
    Type: System.Boolean

    true to skip processing of attendee information in the iCal; otherwise, false.

Return Value

Type: System.Xml.XmlNode
A Microsoft.SharePoint.SoapServer.SoapXml object that contains the following:

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="https://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=
    "https://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 returns additional information. In particular, it detects when all the users cannot be resolved and when the quota limit is exceeded.
If all the users cannot be resolved, the error code of the error returned is 12, and the Manage User Page points to aclinv.aspx, together with a list of the users that cannot be resolved, as shown in the following XML response.

<?xml version="1.0" encoding="utf-8"?><soap:Envelope
xmlns:soap="https://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="https://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 is 11, and the Manage User Page points to user.aspx (for example, to "http://myserver/Test Meeting/_layouts/1033/user.aspx").

Exceptions

Exception Condition
SoapException

This method works only with Meeting Workspace sites. If you call this method against a non-Meeting Workspace site, this method generates a SOAP exception that looks like the following:

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

<soap:Envelope xmlns:soap="https://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= "https://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="https://schemas.microsoft.com/sharepoint/soap/">0x00000006</errorcode>

</detail>

</soap:Fault>

</soap:Body>

</soap:Envelope>

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

Remarks

To access the Meetings service and its methods, set a Web reference to https://Server_Name/[sites/][Site_Name/]_vti_bin/Meetings.asmx.

Examples

SOAP Request Format   Following is a sample SOAP request. Replace the placeholders shown 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: "https://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="https://schemas.xmlsoap.org/soap/envelope/">

<soap:Body>

<UpdateMeetingFromICal xmlns=

"https://schemas.microsoft.com/sharepoint/soap/meetings/">

<icalText>string</icalText>

<ignoreAttendees>boolean</ignoreAttendees>

</UpdateMeetingFromICal>

</soap:Body>

</soap:Envelope>

SOAP Response Format   Following is a sample SOAP response. Replace the placeholders shown 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="https://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <UpdateMeetingFromICalResponse xmlns=
        "https://schemas.microsoft.com/sharepoint/soap/meetings/">
      <UpdateMeetingFromICalResult>
        <xsd:schema>schema</xsd:schema>xml
      </UpdateMeetingFromICalResult>
    </UpdateMeetingFromICalResponse>
  </soap:Body>
</soap:Envelope>

See Also

Reference

Meetings Class

Meetings Members

Meetings Web Service