Statusing.CreateNewAssignmentWithWork method

Creates an assignment that includes planned work to be performed.

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

Syntax

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

• sName
  Type: System.String

  Name of the task.

• projGuid
  Type: System.Guid

  GUID of the project.

• 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.

• dtStart
  Type: System.DateTime

  Start date for the new assignment.

• dtFinish
  Type: System.DateTime

  Finish date for the new assignment. If dtFinish is set as DateTime.MinValue and actWork = 0, a 1-day task is created that starts on the dtStart date.

• actWork
  Type: System.Double

  Total work planned for the task. For a manual task, used to calculate the finish date.

• fMilestone
  Type: System.Boolean

• 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

WebSvcStatusing namespace