projectmanager-sdk
Version:
Software development kit for the ProjectManager.com API. for TypeScript
138 lines • 7.48 kB
JavaScript
/**
* ProjectManager API for TypeScript
*
* (c) ProjectManager.com, Inc.
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*
* @author ProjectManager.com <support@projectmanager.com>
* @copyright ProjectManager.com, Inc.
* @link https://github.com/projectmgr/projectmanager-sdk-typescript
*/
export class TaskRecurrencyClient {
client;
/**
* Internal constructor for this client library
*/
constructor(client) {
this.client = client;
}
/**
* Changes an existing Task into a Recurring Task, so that it will recur regularly given the specified rules.
*
* A Recurring Task is one that must be completed on a specific regular frequency, such as Daily, Weekly, Monthly,
* or Yearly. To create a Recurring Task, you must first create a regular Task with the necessary information,
* then call one of the Create Recurring Task APIs. To remove an instance of a Recurring Task, call Delete
* Recurring Task and specify one or more instances of the Recurring Task.
*
* @param taskId The unique identifier of the Task
* @param body The weekly recurring settings
*/
createWeeklyRecurringTasks(taskId, body) {
const url = `/api/data/tasks/${taskId}/recurring/weekly`;
return this.client.request("post", url, null, body);
}
/**
* Changes an existing Task into a Recurring Task, so that it will recur regularly given the specified rules.
*
* A Recurring Task is one that must be completed on a specific regular frequency, such as Daily, Weekly, Monthly,
* or Yearly. To create a Recurring Task, you must first create a regular Task with the necessary information,
* then call one of the Create Recurring Task APIs. To remove an instance of a Recurring Task, call Delete
* Recurring Task and specify one or more instances of the Recurring Task.
*
* @param taskId The unique identifier of the Task
* @param body The monthly recurring settings
*/
createMonthlyRecurringTasks(taskId, body) {
const url = `/api/data/tasks/${taskId}/recurring/monthly`;
return this.client.request("post", url, null, body);
}
/**
* Changes an existing Task into a Recurring Task, so that it will recur regularly given the specified rules.
*
* A Recurring Task is one that must be completed on a specific regular frequency, such as Daily, Weekly, Monthly,
* or Yearly. To create a Recurring Task, you must first create a regular Task with the necessary information,
* then call one of the Create Recurring Task APIs. To remove an instance of a Recurring Task, call Delete
* Recurring Task and specify one or more instances of the Recurring Task.
*
* @param taskId The unique identifier of the Task
* @param body The daily recurring settings
*/
createDailyRecurringTasks(taskId, body) {
const url = `/api/data/tasks/${taskId}/recurring/daily`;
return this.client.request("post", url, null, body);
}
/**
* Changes an existing Task into a Recurring Task, so that it will recur regularly given the specified rules.
*
* A Recurring Task is one that must be completed on a specific regular frequency, such as Daily, Weekly, Monthly,
* or Yearly. To create a Recurring Task, you must first create a regular Task with the necessary information,
* then call one of the Create Recurring Task APIs. To remove an instance of a Recurring Task, call Delete
* Recurring Task and specify one or more instances of the Recurring Task.
*
* @param taskId The unique identifier of the Task
* @param body The yearly recurring settings
*/
createYearlyRecurringTasks(taskId, body) {
const url = `/api/data/tasks/${taskId}/recurring/yearly`;
return this.client.request("post", url, null, body);
}
/**
* Removes one or more instances of a Recurring Task based on the `option` you specify: `this` means to remove
* a single instance, `all` means to remove all instances, or `future` means to remove all future instances of
* the Recurring Task.
*
* A Recurring Task is one that must be completed on a specific regular frequency, such as Daily, Weekly, Monthly,
* or Yearly. To create a Recurring Task, you must first create a regular Task with the necessary information,
* then call one of the Create Recurring Task APIs. To remove an instance of a Recurring Task, call Delete
* Recurring Task and specify one or more instances of the Recurring Task.
*
* @param taskId The unique identifier of the Task
* @param option Specify `this`, `all`, or `future` to indicate which task recurrnces to delete.
*/
deleteRecurringTasks(taskId, option) {
const url = `/api/data/tasks/${taskId}/recurring/${option}`;
return this.client.request("delete", url, null, null);
}
/**
* Reviews potential updates to a Recurring Task and report back on the list of changes that would occur if this
* Recurring Task was updated with these settings.
*
* When making changes to a Recurring Task, you may want to investigate the consequences of your changes first
* before finalizing the changes. You can use the Validate Recurring Tasks API to examine these changes. When
* you are happy with the changes, call Update Recurring Tasks to complete them.
*
* A Recurring Task is one that must be completed on a specific regular frequency, such as Daily, Weekly, Monthly,
* or Yearly. To create a Recurring Task, you must first create a regular Task with the necessary information,
* then call one of the Create Recurring Task APIs. To remove an instance of a Recurring Task, call Delete
* Recurring Task and specify one or more instances of the Recurring Task.
*
* @param taskId The unique identifier of the Task
* @param body The new settings
*/
validateRecurringTasks(taskId, body) {
const url = `/api/data/tasks/${taskId}/recurring/settings/validate`;
return this.client.request("post", url, null, body);
}
/**
* Updates the settings for a Recurring Task and re-generates occurrences of the Recurring Task from the new rules.
*
* When making changes to a Recurring Task, you may want to investigate the consequences of your changes first
* before finalizing the changes. You can use the Validate Recurring Tasks API to examine these changes. When
* you are happy with the changes, call Update Recurring Tasks to complete them.
*
* A Recurring Task is one that must be completed on a specific regular frequency, such as Daily, Weekly, Monthly,
* or Yearly. To create a Recurring Task, you must first create a regular Task with the necessary information,
* then call one of the Create Recurring Task APIs. To remove an instance of a Recurring Task, call Delete
* Recurring Task and specify one or more instances of the Recurring Task.
*
* @param taskId The unique identifier of the Task
* @param body The new settings
*/
updateRecurringTasks(taskId, body) {
const url = `/api/data/tasks/${taskId}/recurring/settings`;
return this.client.request("put", url, null, body);
}
}
//# sourceMappingURL=TaskRecurrencyClient.js.map