Project.CreateOperationsWorkFromWssList Method

  • Article
  • 3 minutes to read

Creates a proposal project consisting of tasks from a SharePoint list.

Namespace:  WebSvcProject
Assembly:  ProjectServerWebServices (in ProjectServerWebServices.dll)

Syntax

'Declaration
<SoapDocumentMethodAttribute("http://schemas.microsoft.com/office/project/server/webservices/Project/CreateOperationsWorkFromWssList", RequestNamespace := "http://schemas.microsoft.com/office/project/server/webservices/Project/",  _
    ResponseNamespace := "http://schemas.microsoft.com/office/project/server/webservices/Project/",  _
    Use := SoapBindingUse.Literal, ParameterStyle := SoapParameterStyle.Wrapped)> _
Public Function CreateOperationsWorkFromWssList ( _
    sessionUid As Guid, _
    listDataXml As String, _
    priorityMappingsXml As String, _
    projectName As String, _
    projectDescription As String, _
    titleFieldName As String, _
    startDateFieldName As String, _
    finishDateFieldName As String, _
    taskPriorityFieldName As String, _
    percentCompleteFieldName As String, _
    resourceFieldName As String, _
    includeWorkflow As Boolean _
) As Guid

'Usage
Dim instance As Project
Dim sessionUid As Guid
Dim listDataXml As String
Dim priorityMappingsXml As String
Dim projectName As String
Dim projectDescription As String
Dim titleFieldName As String
Dim startDateFieldName As String
Dim finishDateFieldName As String
Dim taskPriorityFieldName As String
Dim percentCompleteFieldName As String
Dim resourceFieldName As String
Dim includeWorkflow As Boolean
Dim returnValue As Guid

returnValue = instance.CreateOperationsWorkFromWssList(sessionUid, _
    listDataXml, priorityMappingsXml, _
    projectName, projectDescription, _
    titleFieldName, startDateFieldName, _
    finishDateFieldName, taskPriorityFieldName, _
    percentCompleteFieldName, resourceFieldName, _
    includeWorkflow)

[SoapDocumentMethodAttribute("http://schemas.microsoft.com/office/project/server/webservices/Project/CreateOperationsWorkFromWssList", RequestNamespace = "http://schemas.microsoft.com/office/project/server/webservices/Project/", 
    ResponseNamespace = "http://schemas.microsoft.com/office/project/server/webservices/Project/", 
    Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)]
public Guid CreateOperationsWorkFromWssList(
    Guid sessionUid,
    string listDataXml,
    string priorityMappingsXml,
    string projectName,
    string projectDescription,
    string titleFieldName,
    string startDateFieldName,
    string finishDateFieldName,
    string taskPriorityFieldName,
    string percentCompleteFieldName,
    string resourceFieldName,
    bool includeWorkflow
)

Parameters

  • sessionUid
    Type: System.Guid
    GUID of the session in which the queue job is submitted.
  • listDataXml
    Type: System.String
    List data XML from the SharePoint list.
  • priorityMappingsXml
    Type: System.String
    An XML file mapping the SharePoint priority filed to the Microsoft Office Project value. See the Remarks section in this topic.
  • projectName
    Type: System.String
    Name of the new proposal project.
  • projectDescription
    Type: System.String
    Description of the proposal project.
  • titleFieldName
    Type: System.String
    Specifies the name of the field that holds the title of the task.
  • startDateFieldName
    Type: System.String
    Specifies the name of the field that holds the start date of the task.
  • finishDateFieldName
    Type: System.String
    Specifies the name of the field that holds the finish date of the task.
  • taskPriorityFieldName
    Type: System.String
    Specifies the name of the field that holds the priority of the task.
  • percentCompleteFieldName
    Type: System.String
    Specifies the name of the field that holds the completion percentage of the task.
  • resourceFieldName
    Type: System.String
    Specifies the name of the field that holds the resources for the task.
  • includeWorkflow
    Type: System.Boolean
    Specifies whether to include workflow.

Return Value

Type: System.Guid
The project GUID of the new proposal project.

Remarks

Conflicts in user assignments can occur when importing a Windows SharePoint Services 3.0 task list. When an application such as Project Web Access calls the SharePoint Lists.GetListItems method, the return value is XML data for the list items and assignments. The assignment data includes a SharePoint index (the ows_ prefix on field names) and a display name for SharePoint users, but does not show the user's domain or even whether the user is a Windows user.

CreateOperationsWorkFromWssList has no indication of where the list data came from. When you create a project from a SharePoint list, all interaction with the SharePoint server is done by the client. For the kinds of possible assignment conflicts, see "Limitations for Using SharePoint Data" in Windows SharePoint Services Infrastructure for Project Server.

Note

CreateOperationsWorkFromWssList returns a ProjectExceededLWPTaskLimit error if more than 100 tasks are created. A list item produces a task for each assigned resource.

A sample priorityMappingsXML parameter using the Project Server 2007 default values is as follows:

<PriorityMappings>

<Map fieldValue=\"(1) High\" mappedValue=\"600\"/>

<Map fieldValue=\"(2) Normal\" mappedValue=\"500\"/>

<Map fieldValue=\"(1) Low\" mappedValue=\"400\"/>

</PriorityMappings>

Project Server Permissions

Permission

Description

CreateNewProposalOrActivity

Create a new proposal. Global permission.

See Also

Reference

Project Class

Project Members

WebSvcProject Namespace

Other Resources

Windows SharePoint Services Infrastructure for Project Server

Lists.GetListItems Method