Meetings.AddMeeting - Méthode

Article
05/11/2015

Associe une réunion avec le site d'espace de travail de réunion sur le serveur spécifié exécutant Windows SharePoint Services.

Espace de noms : WebSvcMeetings
Assembly : STSSOAP (dans STSSOAP.dll)

Syntaxe

'Déclaration
<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sharepoint/soap/meetings/AddMeeting", RequestNamespace := "https://schemas.microsoft.com/sharepoint/soap/meetings/",  _
    ResponseNamespace := "https://schemas.microsoft.com/sharepoint/soap/meetings/",  _
    Use := SoapBindingUse.Literal, ParameterStyle := SoapParameterStyle.Wrapped)> _
Public Function AddMeeting ( _
    organizerEmail As String, _
    uid As String, _
    sequence As UInteger, _
    utcDateStamp As DateTime, _
    title As String, _
    location As String, _
    utcDateStart As DateTime, _
    utcDateEnd As DateTime, _
    nonGregorian As Boolean _
) As XmlNode
'Utilisation
Dim instance As Meetings
Dim organizerEmail As String
Dim uid As String
Dim sequence As UInteger
Dim utcDateStamp As DateTime
Dim title As String
Dim location As String
Dim utcDateStart As DateTime
Dim utcDateEnd As DateTime
Dim nonGregorian As Boolean
Dim returnValue As XmlNode

returnValue = instance.AddMeeting(organizerEmail, _
    uid, sequence, utcDateStamp, title, _
    location, utcDateStart, utcDateEnd, _
    nonGregorian)

[SoapDocumentMethodAttribute("https://schemas.microsoft.com/sharepoint/soap/meetings/AddMeeting", RequestNamespace = "https://schemas.microsoft.com/sharepoint/soap/meetings/", 
    ResponseNamespace = "https://schemas.microsoft.com/sharepoint/soap/meetings/", 
    Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)]
public XmlNode AddMeeting(
    string organizerEmail,
    string uid,
    uint sequence,
    DateTime utcDateStamp,
    string title,
    string location,
    DateTime utcDateStart,
    DateTime utcDateEnd,
    bool nonGregorian
)

Paramètres

organizerEmail
Type : System.String

L'adresse de messagerie spécifiée en tant que email_address@domain.ext, pour l'organisateur de la réunion.

uid
Type : System.String

Un GUID permanent pour le composant de calendrier.

sequence
Type : System.UInt32

Entier utilisé pour déterminer l'ordre des mises à jour dans le cas où elles arrivent hors séquence. Mises à jour avec une séquence inférieur à actuel sont ignorées. Si la séquence est la même que la séquence en cours, la dernière mise à jour sera appliquée.

utcDateStamp
Type : System.DateTime

La date et l'heure à laquelle l'instance de l'objet iCalendar a été créé.

title
Type : System.String

Titre (sujet) de la réunion.

location
Type : System.String

L'emplacement de la réunion.

utcDateStart
Type : System.DateTime

La date de début et l'heure de la réunion, exprimée en UTC.

utcDateEnd
Type : System.DateTime

La date de fin et l'heure de la réunion, exprimée en temps universel coordonné (UTC).

nonGregorian
Type : System.Boolean

true si le calendrier est défini dans un format de calendrier grégorien ; dans le cas contraire, false. En définissant ce paramètre à true place le message suivant s'affiche dans les données de synthèse de l'espace de travail de réunion: "cette réunion a été créée à l'aide d'un calendrier et planification de programme qui ne prend en charge les mises à jour de série de l'espace de travail de réunion. Les modifications apportées aux occurrences individuelles des réunions dans ce programme n'apparaissent pas dans l'espace de travail. »

Valeur renvoyée

Type : System.Xml.XmlNode
Un objet Microsoft.SharePoint.SoapServer.SoapXml qui contient les éléments suivants :

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

<AddMeetingResponse 
   xmlns="https://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  URL vers le site d'espace de travail de réunion que vous avez ajouté à la réunion. Il contient une chaîne de requête qui vous donne le InstanceID de la réunion qui a été ajoutée.
InstanceID  Identifie cette instance de réunion dans le site qui contient des réunions d'instance unique. Si le site contient une réunion, périodique ' ?InstanceID =' n'est pas ajouté à l'URL. « AdMode = 1' peut être ajoutée à l'URL sous la forme d'une chaîne de requête si ce site est configuré en mode AdAccountCreation.
HostTitle  Le titre du site parent ; Si le titre du parent est une chaîne vide, il renvoie l'URL du parent.
UniquePermissions  « true » ou « false » indiquant si ce site a été créé avec des autorisations uniques.
MeetingCount  Renvoie le nombre de réunions associées à cet espace de travail. Si cet espace de travail contient une réunion récurrente, elle retourne -1.
AnonymousAccess  true ou false , indiquant si la fonctionnalité d'autoriser l'accès anonyme est activée sur cet espace de travail.
AllowAuthentictedUsers  true ou false , indiquant si la fonctionnalité d'autoriser les utilisateurs authentifiés est activée sur cet espace de travail.

Exceptions

Exception Condition

Exception	Condition
SoapException	Cette méthode fonctionne uniquement avec les sites espace de travail de réunion. Si vous appelez cette méthode sur un site qui n'est pas un site d'espace de travail de réunion, cette méthode génère une exception SOAP qui ressemble à ceci : <?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>

SoapException

Cette méthode fonctionne uniquement avec les sites espace de travail de réunion. Si vous appelez cette méthode sur un site qui n'est pas un site d'espace de travail de réunion, cette méthode génère une exception SOAP qui ressemble à ceci :

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

Remarques

La méthode AddMeeting est en fait la version de la méthode AddMeetingFromICal non iCal. Comme dans la méthode AddMeetingFromICal , le paramètre organizerEmail est utilisé pour indiquer l'organisateur de la réunion lorsque l'organisateur est un délégué.

Vous ne pouvez pas ajouter des participants à l'espace de travail de réunion à l'aide de cette méthode. Aussi, vous ne pouvez pas ajouter une réunion périodique à l'aide de cette méthode.

Pour accéder à ses méthodes et le service Meetings , définissez une référence Web à https://Server_Name/[sites/][Site_Name/]_vti_bin/Meetings.asmx.

Exemples

Le code suivant crée un site d'espace de travail de réunion et lui ajoute une réunion. Le ServerURLTextBox, MeetingSubjectTextBox, MeetingLocationTextBox, DTSTARTTextBox, DTENDTextBox et CreateWorkspaceButton sont tous les éléments de l'interface qui se trouvent sur un formulaire dans le projet Visual Basic 2005.

    Dim ws As New mysts001.Meetings()
    Dim tz As New mysts001.TimeZoneInf()
    Dim myCache As New System.Net.CredentialCache()
    Dim UID As Integer
    Dim Sequence As UInt32

    Private Sub CreateWorkspaceButton_Click(ByVal sender As 
            System.Object, ByVal e As System.EventArgs) Handles 
            CreateWorkspaceButton.Click
        ws.Credentials = myCache.DefaultCredentials()
        ws.Url = ServerURLTextBox.Text
        If (ws.Url.EndsWith("/")) Then
            ws.Url = ws.Url.Remove(ws.Url.Length - 1, 1)
        End If

        ws.Url = ws.Url + "/_vti_bin/meetings.asmx"

        Dim CreateWorkspaceResponse As System.Xml.XmlNode

        If (ws.Url <> "") Then
            CreateWorkspaceResponse = 
                ws.CreateWorkspace(MeetingSubjectTextBox.Text, "MPS#0", 
                System.UInt32.Parse("1033"), tz)
        End If

        Dim OuterXml As String
        OuterXml = CreateWorkspaceResponse.OuterXml()

        Dim MWSURL As String
        Dim Start As Integer
        Dim Finish As Integer

        Start = OuterXml.IndexOf("""")
        Finish = OuterXml.IndexOf("""", Start + 1)
        MWSURL = OuterXml.Substring(Start + 1, Finish - Start - 1)

        Dim MyRand As New System.Random()

        UID = MyRand.Next(100, 10000)
        Sequence.ToString("0")
        ws.Url = MWSURL + "/_vti_bin/meetings.asmx"

        ws.AddMeeting("", UID.ToString, Sequence,             "2003-03-27T15:00:00-08:00", MeetingSubjectTextBox.Text,             MeetingLocationTextBox.Text, DTSTARTTextBox.Text,             DTENDTextBox.Text, False)

        MWSURLLink.Text = MWSURL
    End Sub

Format de la demande SOAP Voici un exemple de demande SOAP. Remplacez les espaces réservés illustrés par des valeurs réelles.

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/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="https://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <AddMeeting xmlns=
        "https://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>

Format de la réponse SOAP Voici un exemple de réponse SOAP. Remplacez les espaces réservés illustrés par des valeurs réelles.

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>
    <AddMeetingResponse xmlns=
        "https://schemas.microsoft.com/sharepoint/soap/meetings/">
      <AddMeetingResult>
        <xsd:schema>schema</xsd:schema>xml</AddMeetingResult>
    </AddMeetingResponse>
  </soap:Body>
</soap:Envelope>

Voir aussi

Référence

Meetings classe

Meetings - Membres

WebSvcMeetings - Espace de noms

Partager via