Edit Specific Resource Assignment

Introduction

This example explains how to edit a resource assignment within a MS Project file using a resource identifier, with Aspose.Tasks Cloud. Aspose.Tasks Cloud is a REST API which can be used with any language: .NET, Java, PHP, Ruby, Rails, Python, jQuery and many more.

API Information

API	Type	Description	Resource Link
/tasks/{name}/assignments/{assignmentUid}	PUT	Update a Resource in a MS Project file using a identifier	PutAssignment

cURL Example

Request


 curl -v "https://api.aspose.cloud/connect/token" -X POST -d "grant_type=client_credentials&client_id=XXXXX&client_secret=XXXXX" -H "Content-Type: application/x-www-form-urlencoded" -H "Accept: application/json"


curl -X PUT "https://api.aspose.cloud/v3.0/tasks/Home%20move%20plan.mpp/assignments/1?mode=1&recalculate=true" -H "accept: application/json" -H "Content-Type: application/json" -d "{ \"TaskUid\": 0, \"ResourceUid\": 0, \"Uid\": 0, \"PercentWorkComplete\": 0, \"ActualCost\": 0, \"ActualFinish\": \"2019-07-12T22:10:41.984Z\", \"ActualOvertimeCost\": 0, \"ActualOvertimeWork\": \"string\", \"ActualStart\": \"2019-07-12T22:10:41.984Z\", \"ActualWork\": \"string\", \"Acwp\": 0, \"Confirmed\": true, \"Cost\": 0, \"CostVariance\": 0, \"Cv\": 0, \"Delay\": 0, \"Finish\": \"2019-07-12T22:10:41.984Z\", \"FinishVariance\": 0, \"Hyperlink\": \"string\", \"HyperlinkAddress\": \"string\", \"HyperlinkSubAddress\": \"string\", \"WorkVariance\": 0, \"HasFixedRateUnits\": true, \"FixedMaterial\": true, \"LevelingDelay\": 0, \"LinkedFields\": true, \"Milestone\": true, \"Notes\": \"string\", \"Overallocated\": true, \"OvertimeCost\": 0, \"OvertimeWork\": \"string\", \"PeakUnits\": 0, \"RegularWork\": \"string\", \"RemainingCost\": 0, \"RemainingOvertimeCost\": 0, \"RemainingOvertimeWork\": \"string\", \"RemainingWork\": \"string\", \"ResponsePending\": true, \"Start\": \"2019-07-12T22:10:41.984Z\", \"Stop\": \"2019-07-12T22:10:41.984Z\", \"Resume\": \"2019-07-12T22:10:41.984Z\", \"StartVariance\": 0, \"Summary\": true, \"Sv\": 0, \"Units\": 0, \"UpdateNeeded\": true, \"Vac\": 0, \"Work\": \"string\", \"Bcws\": 0, \"Bcwp\": 0, \"ActualWorkProtected\": \"string\", \"ActualOvertimeWorkProtected\": \"string\", \"CreationDate\": \"2019-07-12T22:10:41.984Z\", \"AssnOwner\": \"string\", \"AssnOwnerGuid\": \"string\", \"BudgetCost\": 0, \"BudgetWork\": \"string\", \"Baselines\": [ { \"Work\": \"string\", \"Cost\": 0, \"Bcws\": 0, \"Bcwp\": 0, \"Start\": \"2019-07-12T22:10:41.984Z\", \"Finish\": \"2019-07-12T22:10:41.984Z\" } ], \"ExtendedAttributes\": [ { \"FieldId\": \"string\", \"ValueGuid\": \"string\", \"LookupValueId\": 0, \"DurationValue\": { \"TimeSpan\": \"string\" }, \"NumericValue\": 0, \"DateValue\": \"2019-07-12T22:10:41.984Z\", \"FlagValue\": true, \"TextValue\": \"string\" } ]}"

Response


{
  "code": 0,
  "status": "string",
  "assignment": {
    "taskUid": 0,
    "resourceUid": 0,
    "guid": "string",
    "uid": 0,
    "percentWorkComplete": 0,
    "actualCost": 0,
    "actualFinish": "2020-09-17T14:39:11.957Z",
    "actualOvertimeCost": 0,
    "actualOvertimeWork": "string",
    "actualStart": "2020-09-17T14:39:11.957Z",
    "actualWork": "string",
    "acwp": 0,
    "confirmed": true,
    "cost": 0,
    "costRateTableType": "A",
    "costVariance": 0,
    "cv": 0,
    "delay": 0,
    "finish": "2020-09-17T14:39:11.957Z",
    "finishVariance": 0,
    "hyperlink": "string",
    "hyperlinkAddress": "string",
    "hyperlinkSubAddress": "string",
    "workVariance": 0,
    "hasFixedRateUnits": true,
    "fixedMaterial": true,
    "levelingDelay": 0,
    "levelingDelayFormat": "Minute",
    "linkedFields": true,
    "milestone": true,
    "notes": "string",
    "overallocated": true,
    "overtimeCost": 0,
    "overtimeWork": "string",
    "peakUnits": 0,
    "regularWork": "string",
    "remainingCost": 0,
    "remainingOvertimeCost": 0,
    "remainingOvertimeWork": "string",
    "remainingWork": "string",
    "responsePending": true,
    "start": "2020-09-17T14:39:11.957Z",
    "stop": "2020-09-17T14:39:11.957Z",
    "resume": "2020-09-17T14:39:11.957Z",
    "startVariance": 0,
    "summary": true,
    "sv": 0,
    "units": 0,
    "updateNeeded": true,
    "vac": 0,
    "work": "string",
    "workContour": "Flat",
    "bcws": 0,
    "bcwp": 0,
    "bookingType": "Committed",
    "actualWorkProtected": "string",
    "actualOvertimeWorkProtected": "string",
    "creationDate": "2020-09-17T14:39:11.957Z",
    "assnOwner": "string",
    "assnOwnerGuid": "string",
    "budgetCost": 0,
    "budgetWork": "string",
    "rateScale": "Undefined",
    "baselines": [
      {
        "baselineNumber": "Baseline",
        "work": "string",
        "cost": 0,
        "bcws": 0,
        "bcwp": 0,
        "start": "2020-09-17T14:39:11.957Z",
        "finish": "2020-09-17T14:39:11.957Z"
      }
    ],
    "extendedAttributes": [
      {
        "fieldId": "string",
        "attributeType": "Null",
        "valueGuid": "string",
        "lookupValueId": 0,
        "durationValue": {
          "timeSpan": "string",
          "timeUnit": "Minute"
        },
        "numericValue": 0,
        "dateValue": "2020-09-17T14:39:11.957Z",
        "flagValue": true,
        "textValue": "string"
      }
    ],
    "timephasedData": [
      {
        "uid": 0,
        "start": "2020-09-17T14:39:11.957Z",
        "finish": "2020-09-17T14:39:11.957Z",
        "unit": "Minute",
        "value": "string",
        "timephasedDataType": "AssignmentRemainingWork"
      }
    ]
  }
}

SDKs

The Aspose.Tasks Cloud SDKs can be downloaded from the following page: Available SDKs

SDK Examples

	// For complete examples and data files, please go to https://github.com/aspose-tasks-cloud/aspose-tasks-cloud-dotnet/
	var remoteName = await UploadFileToStorageAsync("NewProductDev.mpp");

	var response = await TasksApi.PostAssignmentAsync(new PostAssignmentRequest
	{
	ResourceUid = 1,
	Units = 0.5D,
	TaskUid = 0,
	Name = remoteName,
	Folder = this.DataFolder
	});

	Assert.AreEqual((int)HttpStatusCode.OK, response.Code);
	Assert.IsNotNull(response.AssignmentItem);

view raw Examples-PostAssignment.cs hosted with ❤ by GitHub

PHP

	<?
	// For complete examples and data files, please go to https://github.com/aspose-tasks-cloud/aspose-tasks-cloud-php/
	$remoteName = "EditAssignment.mpp";
	$folder = $this->uploadFile("NewProductDev.mpp", $remoteName, '');

	$response = $this->tasks->getAssignment(new Requests\GetAssignmentRequest($remoteName, 63, self::$storageName, $folder));

	Assert::assertEquals(200, $response->getCode());
	Assert::assertNotNull($response->getAssignment());
	Assert::assertEquals(34, $response->getAssignment()->getTaskUid());

	$assignment = $response->getAssignment();
	$assignment->setTaskUid(0);

	$putResponse = $this->tasks->putAssignment(new Requests\PutAssignmentRequest($remoteName, 63, $assignment, CalculationMode::AUTOMATIC, true, self::$storageName, $folder, null));

	Assert::assertEquals(200, $putResponse->getCode());

	$response = $this->tasks->getAssignment(new Requests\GetAssignmentRequest($remoteName, 63, self::$storageName, $folder));

	Assert::assertEquals(200, $response->getCode());
	Assert::assertNotNull($response->getAssignment());
	Assert::assertEquals(0, $response->getAssignment()->getTaskUid());

view raw Example-PutAssignment.php hosted with ❤ by GitHub

Python

	# For complete examples and data files, please go to https://github.com/aspose-tasks-cloud/aspose-tasks-cloud-python
	filename = 'NewProductDev.mpp'
	self.upload_file(filename)
	assignment_response = self.tasks_api.get_assignment(GetAssignmentRequest(filename, 63))
	assignment = assignment_response.assignment
	assignment.task_uid = 0
	put_response = self.tasks_api.put_assignment(
	PutAssignmentRequest(filename, 63, assignment, CalculationMode.AUTOMATIC, True))
	self.assertIsInstance(put_response, AssignmentResponse)
	self.assertIsNotNone(put_response.assignment)

	assignment_response = self.tasks_api.get_assignment(GetAssignmentRequest(filename, 63))
	self.assertIsInstance(assignment_response, AssignmentResponse)
	self.assertIsNotNone(assignment_response.assignment)
	self.assertEqual(0, assignment_response.assignment.task_uid)

view raw put_assignment.py hosted with ❤ by GitHub

Node.js

	// For complete examples and data files, please go to https://github.com/aspose-tasks-cloud/aspose-tasks-cloud-node

	const fileName = "NewProductDev.mpp";
	const localPath = "./Data/" + fileName;
	const remotePath = "Temp/Data";
	const remoteFullPath = remotePath + "/" + fileName;

	await tasksApi.uploadFileToStorage(remoteFullPath, localPath);

	const request = new GetAssignmentRequest();
	request.assignmentUid = 63;
	request.name = fileName;
	request.folder = remotePath;

	const result = await tasksApi.getAssignment(request);

	expect(result.response.statusCode).to.equal(200);
	expect(result.body.assignment).not.undefined.and.not.null;

	result.body.assignment.taskUid = 0;

	const request2 = new PutAssignmentRequest();
	request2.mode = CalculationMode.Automatic;
	request2.recalculate = true;
	request2.assignmentUid = 63;
	request2.assignment = result.body.assignment;
	request2.name = fileName;
	request2.folder = remotePath;

	const result2 = await tasksApi.putAssignment(request2);

	expect(result2.response.statusCode).to.equal(200);

view raw putAssignment.ts hosted with ❤ by GitHub

	// For complete examples and data files, please go to https://github.com/aspose-tasks-cloud/aspose-tasks-cloud-go/
	client, ctx := UploadTestFileToStorage(t, localFileName, remoteBaseTestDataFolder+"/"+remoteFileName)

	postAssignmentOpts := &requests.PostAssignmentOpts{
	ResourceUid: 1,
	Units: optional.NewFloat64(0.5),
	TaskUid: 0,
	Name: remoteFileName,
	Folder: optional.NewString(remoteBaseTestDataFolder),
	}
	result, _, err := client.TasksApi.PostAssignment(ctx, postAssignmentOpts)
	if err != nil {
	t.Error(err)
	}
	assert.Equal(t, int32(200), result.Code)
	assert.NotNil(t, result.AssignmentItem)

view raw Examples-PostAssignment.go hosted with ❤ by GitHub

Java

	// For complete examples and data files, please go to https://github.com/aspose-tasks-cloud/aspose-tasks-cloud-java/
	String localFileName = "NewProductDev.mpp";
	String remoteFileName = TestInitializer.UploadFile(localFileName);

	PostAssignmentRequest request1 = new PostAssignmentRequest(remoteFileName, 0, 1, 0.5, null, null, null, null);
	AssignmentItemResponse result1 = TestInitializer.tasksApi.postAssignment(request1);
	assertNotNull(result1);
	assertEquals(200, (int) result1.getCode());
	assertNotNull(result1.getAssignmentItem());

view raw Examples-PostAssignment.java hosted with ❤ by GitHub

Add Assignment to Project With Cost Delete an Assignment from a Project