Project.CreateOperationsWorkFromWssList method

  • Article

Creates a project from a SharePoint task list, but does not maintain synchronization data.

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

Syntax

'Declaration
<SoapDocumentMethodAttribute("https://schemas.microsoft.com/office/project/server/webservices/Project/CreateOperationsWorkFromWssList", RequestNamespace := "https://schemas.microsoft.com/office/project/server/webservices/Project/",  _
    ResponseNamespace := "https://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("https://schemas.microsoft.com/office/project/server/webservices/Project/CreateOperationsWorkFromWssList", RequestNamespace = "https://schemas.microsoft.com/office/project/server/webservices/Project/", 
    ResponseNamespace = "https://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

    The GUID of the session in which the queue job is submitted.

  • listDataXml
    Type: System.String

    The list data XML from the SharePoint list.

  • priorityMappingsXml
    Type: System.String

    An XML file that maps the SharePoint priority field to the Project Server value. For more information,sSee the Remarks section in this topic.

  • projectDescription
    Type: System.String

    The description of the 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 GUID of the new project.

Remarks

To import a SharePoint task list and maintain field mappings for future synchronization, see CreateWssListSyncedProject.

Conflicts in user assignments can occur when importing a SharePoint task list. When an application such as Project Web App calls the SharePoint 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 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 information about the kinds of possible assignment conflicts, see "Limitations for Using SharePoint Data" in SharePoint 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 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

NewProject

Allows a user to create a project. Global permission.

See also

Reference

Project class

Project members

WebSvcProject namespace

GetListItems(String, String, XmlNode, XmlNode, String, XmlNode, String)

Other resources

SharePoint Infrastructure for Project Server