Get a Specific Task of a Project

Introduction

This example explains how to retrieve a project task of a specified UID, using 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}/tasks/{taskUid}	GET	Read a specific task of a project	GetTask

cURL Example

Request


curl -X GET "https://api.aspose.cloud/v3.0/tasks/Home%20move%20plan.mpp/tasks/0" -H "accept: application/json"

Response


{
  "code": 0,
  "status": "string",
  "task": {
    "uid": 0,
    "id": 0,
    "name": "string",
    "durationText": "string",
    "duration": "string",
    "start": "2020-09-18T07:38:29.309Z",
    "finish": "2020-09-18T07:38:29.309Z",
    "startText": "string",
    "finishText": "string",
    "percentComplete": 0,
    "percentWorkComplete": 0,
    "isActive": true,
    "actualCost": 0,
    "actualDuration": "string",
    "actualFinish": "2020-09-18T07:38:29.309Z",
    "actualOvertimeCost": 0,
    "actualOvertimeWork": "string",
    "actualWorkProtected": "string",
    "actualOvertimeWorkProtected": "string",
    "actualStart": "2020-09-18T07:38:29.309Z",
    "budgetWork": "string",
    "budgetCost": 0,
    "constraintDate": "2020-09-18T07:38:29.309Z",
    "constraintType": "AsSoonAsPossible",
    "contact": "string",
    "cost": 0,
    "cv": 0,
    "deadline": "2020-09-18T07:38:29.309Z",
    "durationVariance": "string",
    "earlyFinish": "2020-09-18T07:38:29.309Z",
    "earlyStart": "2020-09-18T07:38:29.309Z",
    "isEffortDriven": true,
    "isExternalTask": true,
    "externalTaskProject": "string",
    "externalId": 0,
    "finishSlack": 0,
    "finishVariance": 0,
    "fixedCost": 0,
    "fixedCostAccrual": "Start",
    "freeSlack": 0,
    "guid": "string",
    "hideBar": true,
    "ignoreResourceCalendar": true,
    "lateFinish": "2020-09-18T07:38:29.309Z",
    "lateStart": "2020-09-18T07:38:29.309Z",
    "isLevelAssignments": true,
    "canLevelingSplit": true,
    "levelingDelay": 0,
    "isMarked": true,
    "isMilestone": true,
    "isCritical": true,
    "isSubproject": true,
    "isSubprojectReadOnly": true,
    "subprojectName": "string",
    "isSummary": true,
    "subtasksUids": [
      0
    ],
    "outlineLevel": 0,
    "isOverAllocated": true,
    "isEstimated": true,
    "overtimeCost": 0,
    "overtimeWork": "string",
    "physicalPercentComplete": 0,
    "preLeveledFinish": "2020-09-18T07:38:29.309Z",
    "preLeveledStart": "2020-09-18T07:38:29.309Z",
    "isRecurring": true,
    "regularWork": "string",
    "remainingCost": 0,
    "remainingDuration": "string",
    "remainingOvertimeCost": 0,
    "remainingOvertimeWork": "string",
    "remainingWork": "string",
    "resume": "2020-09-18T07:38:29.309Z",
    "isResumeValid": true,
    "stop": "2020-09-18T07:38:29.309Z",
    "isRollup": true,
    "startSlack": 0,
    "startVariance": 0,
    "calendarUid": 0,
    "isManual": true,
    "manualStart": "2020-09-18T07:38:29.309Z",
    "manualFinish": "2020-09-18T07:38:29.309Z",
    "manualDuration": "string",
    "totalSlack": 0,
    "type": "FixedUnits",
    "wbs": "string",
    "priority": 0,
    "work": "string",
    "workVariance": 0,
    "notesText": "string",
    "notesRTF": "string",
    "acwp": 0,
    "bcws": 0,
    "bcwp": 0,
    "levelingDelayFormat": "Minute",
    "predecessors": "string",
    "successors": "string",
    "ignoreWarnings": false,
    "isExpanded": true,
    "displayOnTimeline": true,
    "displayAsSummary": true,
    "hyperlink": "string",
    "hyperlinkAddress": "string",
    "hyperlinkSubAddress": "string",
    "earnedValueMethod": "PercentComplete",
    "isPublished": true,
    "statusManager": "string",
    "commitmentStart": "2020-09-18T07:38:29.309Z",
    "commitmentFinish": "2020-09-18T07:38:29.309Z",
    "commitmentType": 0,
    "baselines": [
      {
        "baselineNumber": "Baseline",
        "work": "string",
        "cost": 0,
        "bcws": 0,
        "bcwp": 0,
        "start": "2020-09-18T07:38:29.309Z",
        "finish": "2020-09-18T07:38:29.309Z",
        "duration": "string",
        "fixedCost": 0,
        "durationFormat": "Minute",
        "estimatedDuration": true
      }
    ],
    "extendedAttributes": [
      {
        "fieldId": "string",
        "attributeType": "Null",
        "valueGuid": "string",
        "lookupValueId": 0,
        "durationValue": {
          "timeSpan": "string",
          "timeUnit": "Minute"
        },
        "numericValue": 0,
        "dateValue": "2020-09-18T07:38:29.309Z",
        "flagValue": true,
        "textValue": "string"
      }
    ],
    "outlineCodes": [
      {
        "fieldId": "string",
        "valueId": 0,
        "valueGuid": "string"
      }
    ],
    "warning": false
  }
}

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("Project2016.mpp");

	var tasksResponse = await TasksApi.GetTaskAsync(new GetTaskRequest
	{
	TaskUid = 5,
	Name = remoteName,
	Folder = this.DataFolder
	});

	Assert.AreEqual((int)HttpStatusCode.OK, tasksResponse.Code);
	Assert.IsNotNull(tasksResponse.Task);
	Assert.AreEqual(5, tasksResponse.Task.Uid);
	CollectionAssert.AreEquivalent(new[] { 1, 2, 3, 4 }, tasksResponse.Task.SubtasksUids);
	Assert.AreEqual(new DateTime(2015, 8, 3, 8, 0, 0), tasksResponse.Task.Start);
	Assert.AreEqual(new DateTime(2015, 8, 6, 17, 0, 0), tasksResponse.Task.Finish);
	Assert.AreEqual(new TimeSpan(1, 8, 0, 0, 0), tasksResponse.Task.RemainingWork);
	Assert.AreEqual(1920, tasksResponse.Task.WorkVariance);

view raw Examples-GetTask.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 = "GetTaskByUid.mpp";
	$folder = $this->uploadFile("Project2016.mpp", $remoteName, '');

	$response = $this->tasks->getTask(new Requests\GetTaskRequest($remoteName, 5, self::$storageName, $folder));
	Assert::assertEquals(200, $response->getCode());
	Assert::assertNotNull($response->getTask());
	Assert::assertEquals(5, $response->getTask()->getUid());
	Assert::assertTrue(array(1, 2, 3, 4) == $response->getTask()->getSubtasksUids());

	Assert::assertEquals("2015-08-03T08:00:00", $response->getTask()->getStart()->format("Y-m-d\\TH:i:s"));
	Assert::assertEquals("2015-08-06T17:00:00", $response->getTask()->getFinish()->format("Y-m-d\\TH:i:s"));
	Assert::assertEquals(1920, $response->getTask()->getWorkVariance());
	Assert::assertEquals("1.08:00:00", $response->getTask()->getRemainingWork());

view raw Example-getTask.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 = 'Project2016.mpp'
	self.upload_file(filename)
	get_request = GetTaskRequest(filename, 5)
	get_result = self.tasks_api.get_task(get_request)
	self.assertIsNotNone(get_result)
	self.assertIsInstance(get_result, TaskResponse)
	self.assertIsNotNone(get_result.task)
	self.assertEqual(5, get_result.task.uid)
	self.assertEqual([1, 2, 3, 4], get_result.task.subtasks_uids)
	self.assertEqual('Summary Task 1', get_result.task.name)
	self.assertEqual(datetime(2015, 8, 3, 8, 0, 0), get_result.task.start)
	self.assertEqual(datetime(2015, 8, 6, 17, 0, 0), get_result.task.finish)
	self.assertEqual('1.08:00:00', get_result.task.remaining_work)
	self.assertEqual(1920, get_result.task.work_variance)

view raw get_task.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 = "Project2016.mpp";
	const localPath = "./Data/" + fileName;
	const remotePath = "Temp/Data";
	const remoteFullPath = remotePath + "/" + fileName;

	await tasksApi.uploadFileToStorage(remoteFullPath, localPath);

	const request = new GetTaskRequest();
	request.name = fileName;
	request.folder = remotePath;
	request.taskUid = 5;

	const result = await tasksApi.getTask(request);

	expect(result.response.statusCode).to.equal(200);
	expect(result.body.task).is.not.undefined.and.not.null;
	expect(result.body.task.uid).to.equal(5);

view raw getTask.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)

	opts := &requests.GetTaskOpts{
	TaskUid: 5,
	Name: remoteFileName,
	Folder: optional.NewString(remoteBaseTestDataFolder),
	}
	result, _, err := client.TasksApi.GetTask(ctx, opts)
	if err != nil {
	t.Error(err)
	}
	assert.Equal(t, int32(200), result.Code)
	assert.NotNil(t, result.Task)
	assert.Equal(t, int32(5), result.Task.Uid)
	assert.Equal(t, []int32{1, 2, 3, 4}, result.Task.SubtasksUids)
	assert.Equal(t, "Summary Task 1", result.Task.Name)
	assert.Equal(t, CreateTime(2015, 8, 3, 8, 0, 0), result.Task.Start)
	assert.Equal(t, CreateTime(2015, 8, 6, 17, 0, 0), result.Task.Finish)
	assert.Equal(t, "1.08:00:00", *result.Task.RemainingWork)
	assert.Equal(t, float64(1920), result.Task.WorkVariance)

view raw Examples-GetTask.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 = "Project2016.mpp";
	String remoteFileName = TestInitializer.UploadFile(localFileName);
	GetTaskRequest request = new GetTaskRequest(remoteFileName, 5, null,null);
	TaskResponse result = TestInitializer.tasksApi.getTask(request);
	assertNotNull(result);
	assertEquals(Integer.valueOf(200), result.getCode());
	assertNotNull(result.getTask());
	assertEquals(Integer.valueOf(5), result.getTask().getUid());
	assertEquals(Arrays.asList(1, 2, 3, 4), result.getTask().getSubtasksUids());
	assertEquals("Summary Task 1", result.getTask().getName());
	assertEquals(OffsetDateTime.of(2015, 8, 3, 8, 0, 0, 0, ZoneOffset.UTC), result.getTask().getStart());
	assertEquals(OffsetDateTime.of(2015, 8, 6, 17, 0, 0, 0, ZoneOffset.UTC), result.getTask().getFinish());
	assertEquals("1.08:00:00", result.getTask().getRegularWork());
	assertEquals(1920.0, result.getTask().getWorkVariance());

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

Get all Tasks of a Project Delete a Task from Project