Create Document Property

Introduction

This example explains how to create document property, 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}/documentproperties/{propertyName}	POST	Create a property in a MS Project File	PostDocumentProperty

cURL Example

Request


curl -X POST "https://api.aspose.cloud/v3.0/tasks/Home_move_plan.mpp/documentproperties/Title" -H "accept: application/json" -H "Content-Type: application/json" -H "x-aspose-client: Containerize.Swagger" -d "{ \"link\": { \"href\": \"string\", \"rel\": \"string\", \"type\": \"string\", \"title\": \"string\" }, \"name\": \"Title\", \"value\": \"New title value\"}"

Response


 {
  "code": 0,
  "status": "string",
  "property": {
    "link": {
      "href": "string",
      "rel": "string",
      "type": "string",
      "title": "string"
    },
    "name": "string",
    "value": "string"
  }
}

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("Home move plan.mpp");

	var putResponse = await TasksApi.PostDocumentPropertyAsync(new PostDocumentPropertyRequest
	{
	Name = remoteName,
	Folder = this.DataFolder,
	PropertyName = "Title",
	Property = new DocumentProperty
	{
	Name = "Title",
	Value = "New title value"
	}
	});

	var response = await TasksApi.GetDocumentPropertiesAsync(new GetDocumentPropertiesRequest
	{
	Name = remoteName,
	Folder = this.DataFolder
	});

	Assert.AreEqual((int)HttpStatusCode.OK, response.Code);
	Assert.AreEqual(52, response.Properties.List.Count);
	Assert.AreEqual("Title", response.Properties.List[0].Name);
	Assert.AreEqual("New title value", response.Properties.List[0].Value);

view raw Examples-PostDocumentProperty.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 = "DocumentProperty.mpp";
	$folder = $this->uploadFile("Home move plan.mpp", $remoteName, '');

	$property = new DocumentProperty();
	$property->setName("Title");
	$property->setValue("New title value");

	$response = $this->tasks->postDocumentProperty(new Requests\PostDocumentPropertyRequest($remoteName, "Title", $property, self::$storageName, $folder, null));
	Assert::assertEquals(200, $response->getCode());

	$response = $this->tasks->getDocumentProperties(new Requests\GetDocumentPropertiesRequest($remoteName, self::$storageName, $folder));
	Assert::assertEquals(200, $response->getCode());
	Assert::assertEquals(52, count($response->getProperties()->getList()));

	foreach($response->getProperties()->getList() as $p)
	{
	if($p->getName() == "Title")
	{
	$found = true;
	Assert::assertEquals("New title value", $p->getValue());
	break;
	}
	}

	Assert::isTrue($found);

view raw Example-postDocumentProperty.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 = 'Home_move_plan.mpp'
	self.upload_file(filename)
	_property = DocumentProperty('Title', 'New title value')
	put_request = PutDocumentPropertyRequest(filename, 'Title', _property)
	self.tasks_api.put_document_property(put_request)
	get_request = GetDocumentPropertyRequest(filename, 'Title')
	result = self.tasks_api.get_document_property(get_request)
	self.assertIsNotNone(result)
	self.assertIsInstance(result, DocumentPropertyResponse)
	self.assertIsNotNone(result._property)
	self.assertEqual('Title', result._property.name)
	self.assertEqual('New title value', result._property.value)

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

	await tasksApi.uploadFileToStorage(remoteFullPath, localPath);

	const property = new DocumentProperty();
	property.name = "Title";
	property.value = "New title value";
	const request = new PostDocumentPropertyRequest();
	request.name = fileName;
	request.folder = remotePath;
	request.propertyName = "Title";
	request.property = property;

	await tasksApi.postDocumentProperty(request);

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

	postOptions := &requests.PostDocumentPropertyOpts{
	Name: remoteFileName,
	Folder: optional.NewString(remoteBaseTestDataFolder),
	PropertyName: "Title",
	Property: models.DocumentProperty{
	Name: "Title",
	Value: "New title value",
	},
	}
	postResult, _, err := client.TasksApi.PostDocumentProperty(ctx, postOptions)
	if err != nil {
	t.Error(err)
	}
	assert.Equal(t, int32(200), postResult.Code)
	assert.NotNil(t, postResult.Property)
	assert.Equal(t, "Title", postResult.Property.Name)
	assert.Equal(t, "New title value", postResult.Property.Value)

view raw Examples-PostDocumentProperty.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 = "Home_move_plan.mpp";
	String remoteFileName = TestInitializer.UploadFile(localFileName);

	DocumentProperty property = new DocumentProperty();
	property.setName("Title");
	property.setValue("New title value");
	PostDocumentPropertyRequest request1 = new PostDocumentPropertyRequest(remoteFileName, property.getName(), property, null, null, null);
	DocumentPropertyResponse result1 = TestInitializer.tasksApi.postDocumentProperty(request1);
	assertNotNull(result1);
	assertEquals(200, (int) result1.getCode());

	GetDocumentPropertyRequest request2 = new GetDocumentPropertyRequest(remoteFileName, property.getName(), null, null);
	DocumentPropertyResponse result2 = TestInitializer.tasksApi.getDocumentProperty(request2);
	assertEquals(property.getValue(), result2.getProperty().getValue());

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

Get a Document Property by Name Edit Document Property