CreateWorkspace Method

Article
04/07/2009

The CreateWorkspace method of the Meetings service creates a new Meeting Workspace subsite on the specified Microsoft Windows SharePoint Services server.

Parameters

title The title for the Meeting Workspace site that will be created.

templateName The name of the template you want to use when the site is created. See Windows SharePoint Services template naming guidelines for specifying a configuration within a template.

lcid The LCID (locale identifier) that you want to use when the site is created.

timeZoneInformation The time zone information that you want to use when the site is created.

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>

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

<CreateWorkspaceResult>

<CreateWorkspace Url="http://server_name/test/myworkspace" />

</CreateWorkspaceResult>

</CreateWorkspaceResponse>

</soap:Body>

</soap:Envelope>

Url The URL of the subsite that was created. If the server is an ADMode server, the query string is appended to the URL, so the URL would look like http://spserver1/test/myworkspace?AdMode=1.

Remarks

The CreateWorkspace method creates a subsite that is used to manage meetings, on the site the request is posted to.

The subsite that is created is always given a unique name, and the title parameter may be truncated to fit within the limitations of maximum Web URL (236 characters). If the title provided in the call is an empty string, the title will be substituted with the localized version of the string "Untitled". The string is localized based on the site you have posted to. For example, if you post to http://spserver1/test and "test" is a German subsite, the title of the new subsite will be the German string for "Untitled".

If no template is provided, the MPS template is used as the default; if the LCID is specified as 0 (zero), the LCID of the site you have posted the request to is used for the new subsite.

If the title parameter is not specified, the name of the site and the title are set to "Untitled". If a Meeting Workspace site already exists with the same name that is specified for this parameter, the title you specify is appended with (1), (2), and so on.

Example

The following Microsoft Visual Basic .NET code creates a Meeting Workspace site and adds a meeting to it. Note that 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/CreateWorkspace"

<?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>
    <CreateWorkspace xmlns="http://schemas.microsoft.com/sharepoint/soap/meetings/">
      <title>string</title>
      <templateName>string</templateName>
      <lcid>unsignedInt</lcid>
      <timeZoneInformation>
        <bias>int</bias>
        <standardDate>
          <year>unsignedShort</year>
          <month>unsignedShort</month>
          <dayOfWeek>unsignedShort</dayOfWeek>
          <day>unsignedShort</day>
          <hour>unsignedShort</hour>
          <minute>unsignedShort</minute>
          <second>unsignedShort</second>
          <milliseconds>unsignedShort</milliseconds>
        </standardDate>
        <standardBias>int</standardBias>
        <daylightDate>
          <year>unsignedShort</year>
          <month>unsignedShort</month>
          <dayOfWeek>unsignedShort</dayOfWeek>
          <day>unsignedShort</day>
          <hour>unsignedShort</hour>
          <minute>unsignedShort</minute>
          <second>unsignedShort</second>
          <milliseconds>unsignedShort</milliseconds>
        </daylightDate>
        <daylightBias>int</daylightBias>
      </timeZoneInformation>
    </CreateWorkspace>
  </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>
    <CreateWorkspaceResponse xmlns="http://schemas.microsoft.com/sharepoint/soap/meetings/">
      <CreateWorkspaceResult>
        <xsd:schema>schema</xsd:schema>xml</CreateWorkspaceResult>
    </CreateWorkspaceResponse>
  </soap:Body>
</soap:Envelope>

Requirements

Platforms: Microsoft Windows Server 2003

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

Share via