Statusing.CreateNewAssignmentWithWork Method

Creates an assignment that includes planned work to be performed.

Namespace:  [Statusing Web service]
Service reference: http://ServerName:32843/[Project Service Application GUID]/PSI/Statusing.svc
Web service reference: http://ServerName/ProjectServerName/_vti_bin/PSI/Statusing.asmx?wsdl

Syntax

'Declaration
<SoapDocumentMethodAttribute("http://schemas.microsoft.com/office/project/server/webservices/Statusing/CreateNewAssignmentWithWork", RequestNamespace := "http://schemas.microsoft.com/office/project/server/webservices/Statusing/",  _
    ResponseNamespace := "http://schemas.microsoft.com/office/project/server/webservices/Statusing/",  _
    Use := SoapBindingUse.Literal, ParameterStyle := SoapParameterStyle.Wrapped)> _
Public Sub CreateNewAssignmentWithWork ( _
    sName As String, _
    projGuid As Guid, _
    taskGuid As Guid, _
    assnGuid As Guid, _
    sumTaskGuid As Guid, _
    dtStart As DateTime, _
    dtFinish As DateTime, _
    actWork As Double, _
    fMilestone As Boolean, _
    fAddToTimesheet As Boolean, _
    fSubmit As Boolean, _
    sComment As String _
)
'Usage
Dim instance As Statusing
Dim sName As String
Dim projGuid As Guid
Dim taskGuid As Guid
Dim assnGuid As Guid
Dim sumTaskGuid As Guid
Dim dtStart As DateTime
Dim dtFinish As DateTime
Dim actWork As Double
Dim fMilestone As Boolean
Dim fAddToTimesheet As Boolean
Dim fSubmit As Boolean
Dim sComment As String

instance.CreateNewAssignmentWithWork(sName, _
    projGuid, taskGuid, assnGuid, sumTaskGuid, _
    dtStart, dtFinish, actWork, fMilestone, _
    fAddToTimesheet, fSubmit, sComment)
[SoapDocumentMethodAttribute("http://schemas.microsoft.com/office/project/server/webservices/Statusing/CreateNewAssignmentWithWork", RequestNamespace = "http://schemas.microsoft.com/office/project/server/webservices/Statusing/", 
    ResponseNamespace = "http://schemas.microsoft.com/office/project/server/webservices/Statusing/", 
    Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)]
public void CreateNewAssignmentWithWork(
    string sName,
    Guid projGuid,
    Guid taskGuid,
    Guid assnGuid,
    Guid sumTaskGuid,
    DateTime dtStart,
    DateTime dtFinish,
    double actWork,
    bool fMilestone,
    bool fAddToTimesheet,
    bool fSubmit,
    string sComment
)

Parameters

  • taskGuid
    Type: System.Guid
    GUID of the task to which the assignment is linked. Use Guid.Empty to create a new task.
  • assnGuid
    Type: System.Guid
    GUID for the new assignment.
  • sumTaskGuid
    Type: System.Guid
    GUID for the summary task under which the new task will be created. If you are not creating a new task, use Guid.Empty.
  • dtFinish
    Type: System.DateTime
    Finish date for the new assignment. If dtFinish is not specified and actWork = 0, a 1-day task is created that starts on the dtStart date.
  • actWork
    Type: System.Double
    Total amount of planned work. For a manual task, used to calculate the finish date.
  • fAddToTimesheet
    Type: System.Boolean
    Automatically add this assignment to the time sheet for the resource.
  • fSubmit
    Type: System.Boolean
    Automatically submit the task for approval.
  • sComment
    Type: System.String
    Comments to be sent to the status manager when approving the new request.

Remarks

Creating an assignment follows one of two scenarios: adding a resource to a current work task, or creating a task under a summary task. The following parameter list indicates which parameters are used in each scenario.

Parameter

Create New Task

Add to Existing Task

sName

Yes

No

projGuid

Yes

Yes

taskGuid

No

Yes

assnGuid

Yes

Yes

sumTaskGuid

Yes

No

dtStart

Yes

Yes

dtFinish

Yes

Yes

fAddToTimesheet

Yes

Yes

fSubmit

Yes

Yes

sComment

Yes

Yes

CreateNewAssignment submits multiple jobs to the Project Server Queuing Service. The jobs can include Timesheet queue jobs, in which case the CorrelationGUID property is equal to the TS_UID property.

CreateNewAssignment submits multiple jobs to the Project Server Queuing Service. The jobs can include Timesheet queue jobs, in which case the CorrelationGUID property is equal to the TS_UID property.

Project Server Permissions

Permission

Description

CreateNewTaskOrAssignment

Allows a user to create a new task or assignment. Category permission.

See Also

Reference

Statusing Class

Statusing Members

Statusing Web Service