Method create_task

O365/planner.py:462–540

Creates a Task :param str title: the title of the task :param dict assignments: the dict of users to which tasks are to be assigned. e.g. assignments = { "ca2a1df2-e36b-4987-9f6b-0ea462f4eb47": null, "4e98f8f1-bb03-4015-b8e0-19bb37094

(self, title, assignments=None, **kwargs)

            for task in data.get('value', [])]

    def create_task(self, title, assignments=None, **kwargs):
        """ Creates a Task

        :param str title: the title of the task
        :param dict assignments: the dict of users to which tasks are to be assigned.
            e.g. assignments = {
                  "ca2a1df2-e36b-4987-9f6b-0ea462f4eb47": null,
                  "4e98f8f1-bb03-4015-b8e0-19bb370949d8": {
                      "@odata.type": "microsoft.graph.plannerAssignment",
                      "orderHint": "String"
                    }
                }
            if "user_id": null -> task is unassigned to user. if "user_id": dict -> task is assigned to user
        :param dict kwargs: optional extra parameters to include in the task
        :param int priority: priority of the task. The valid range of values is between 0 and 10,
            1 -> "urgent", 3 -> "important", 5 -> "medium", 9 -> "low" (kwargs)
        :param str order_hint: the order of the bucket. Default is on top (kwargs)
        :param datetime or str start_date_time: the starting date of the task. If str format should be: "%Y-%m-%dT%H:%M:%SZ" (kwargs)
        :param datetime or str due_date_time: the due date of the task. If str format should be: "%Y-%m-%dT%H:%M:%SZ" (kwargs)
        :param str conversation_thread_id: thread ID of the conversation on the task.
            This is the ID of the conversation thread object created in the group (kwargs)
        :param str assignee_priority: hint used to order items of this type in a list view (kwargs)
        :param int percent_complete: percentage of task completion. When set to 100, the task is considered completed (kwargs)
        :param dict applied_categories: The categories (labels) to which the task has been applied.
            Format should be e.g. {"category1": true, "category3": true, "category5": true } should (kwargs)
        :return: newly created task
        :rtype: Task
        """
        if not title:
            raise RuntimeError('Provide a title for the Task')

        if not self.object_id and not self.plan_id:
            return None

        url = self.build_url(
            self._endpoints.get('create_task'))

        if not assignments:
            assignments = {'@odata.type': 'microsoft.graph.plannerAssignments'}

        for k, v in kwargs.items():
            if k in ('start_date_time', 'due_date_time'):
                kwargs[k] = v.strftime('%Y-%m-%dT%H:%M:%SZ') if isinstance(v, (datetime, date)) else v

        kwargs = {self._cc(key): value for key, value in kwargs.items() if
                  key in (
                      'priority'
                      'order_hint'
                      'assignee_priority'
                      'percent_complete'
                      'has_description'
                      'start_date_time'
                      'created_date'
                      'due_date_time'
                      'completed_date'
                      'preview_type'
                      'reference_count'
                      'checklist_item_count'