Rolebase Développeurs

task_view

Vue de tâche, 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

ChampTypeDescription
iduuidIdentifiant unique de la vue de tâche (généré automatiquement)
orgIduuidRéférence à l'organisation
keyStringClé unique de la vue au sein de l'organisation (ex. : 'backlog', 'sprint')
tasksIdsuuid[]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.