Meetings.UpdateMeetingFromICal Method

Artigo
07/24/2014

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

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."

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>

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>

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

Partilhar via