projectal.entities.task_template

 1from projectal import api
 2from projectal.entity import Entity
 3from projectal.linkers import *
 4
 5
 6class TaskTemplate(Entity, ResourceLinker, SkillLinker, FileLinker, StaffLinker, RebateLinker,
 7                   NoteLinker, TagLinker):
 8    """
 9    Implementation of the
10    [Task Template](https://projectal.com/docs/latest/#tag/Task-Template) API.
11    """
12    _path = 'template/task'
13    _name = 'task_template'
14    _links = [ResourceLinker, SkillLinker, FileLinker, StaffLinker, RebateLinker,
15              NoteLinker, TagLinker]
16
17    def clone(self, holder, entity):
18        url = '/api/template/task/clone?holder={}&reference={}'\
19            .format(holder['uuId'], self['uuId'])
20        response = api.post(url, entity)
21        return response['jobClue']['uuId']
22
23    @classmethod
24    def create(cls, holder, entity):
25        """Create a Task Template
26
27        `holder`: `uuId` of the owner
28
29        `entity`: The fields of the entity to be created
30        """
31        holder = holder['uuId'] if isinstance(holder, dict) else holder
32        params = "?holder=" + holder
33        return super().create(entity, params)
34
35    @classmethod
36    def link_predecessor_task(cls, task, predecessor_task):
37        return cls.__plan(task, predecessor_task, 'add')
38
39    @classmethod
40    def relink_predecessor_task(cls, task, predecessor_task):
41        return cls.__plan(task, predecessor_task, 'update')
42
43    @classmethod
44    def unlink_predecessor_task(cls, task, predecessor_task):
45        return cls.__plan(task, predecessor_task, 'delete')
46
47    @classmethod
48    def __plan(cls, from_task, to_task, operation):
49        url = '/api/template/task/plan/task/{}'.format(operation)
50        payload = {
51            'uuId': from_task['uuId'],
52            'taskList': [to_task]
53        }
54        api.post(url, payload=payload)
55        return True