Rolebase Développeurs
Référence API

task_view

Représente une vue personnalisée des tâches dans Rolebase. Les vues de tâches permettent aux utilisateurs d'organiser et de filtrer les tâches de manière flexible, supportant différentes méthodologies de gestion comme Kanban ou Scrum.

Champs

Champ Type Description
id uuid Identifiant unique de la vue de tâche (généré automatiquement)
orgId uuid Référence à l'organisation
key String Clé unique de la vue au sein de l'organisation (ex. : 'backlog', 'sprint')
tasksIds uuid[] Tableau d'identifiants de tâches incluses dans cette vue

Relations

Relations objet

  • org — L’organisation à laquelle cette vue de tâche appartient

Exemples de requêtes

Lister les vues de tâches

query GetTaskViews($orgId: uuid!) {
  task_view(where: { orgId: { _eq: $orgId } }) {
    id
    key
    tasksIds
    org {
      name
    }
  }
}

Obtenir les tâches avec une vue spécifique

query GetTasksWithView(
  $orgId: uuid!
  $filters: [task_bool_exp!]!
  $taskViewKey: String!
) {
  org_by_pk(id: $orgId) {
    tasks(where: { _and: $filters }) {
      id
      title
      status
      dueDate
    }
    task_views(where: { key: { _eq: $taskViewKey } }) {
      id
      key
      tasksIds
    }
  }
}

Exemples de mutations

Créer une vue de tâche

mutation CreateTaskView {
  insert_task_view_one(
    object: {
      orgId: "your-org-id"
      key: "my-custom-view"
      tasksIds: ["task-id-1", "task-id-2"]
    }
  ) {
    id
    key
    tasksIds
  }
}

Mettre à jour une vue de tâche

mutation UpdateTaskView {
  update_task_view(
    where: { orgId: { _eq: "your-org-id" }, key: { _eq: "my-custom-view" } }
    _set: { tasksIds: ["task-id-1", "task-id-2", "task-id-3"] }
  ) {
    returning {
      id
      key
      tasksIds
    }
  }
}

Permissions

L’accès aux vues de tâches est contrôlé en fonction de l’appartenance à l’organisation :

  • Tous les utilisateurs authentifiés peuvent consulter les vues de tâches
  • Les membres de l’organisation avec les rôles Member, Admin ou Owner peuvent créer des vues de tâches
  • Seul le champ tasksIds peut être mis à jour

La combinaison de orgId et key doit être unique. Les identifiants de tâches dans la vue doivent correspondre à des tâches existantes dans l’organisation. Les vues peuvent être partagées entre les membres de l’organisation.