Resumen

Las etiquetas son una forma poderosa de categorizar y organizar registros en Blue. El sistema de etiquetas proporciona una funcionalidad integral para crear, gestionar y filtrar etiquetas, con soporte para operaciones en masa y filtrado avanzado.

Listar Etiquetas

Recuperar etiquetas de proyectos con opciones de filtrado y ordenamiento flexibles.

Ejemplo Básico

query ListTags {
  tagList(
    filter: { 
      projectIds: ["project-123"] 
      excludeArchivedProjects: false 
    }
    first: 50
    orderBy: title_ASC
  ) {
    items {
      id
      uid
      title
      color
      project {
        id
        name
      }
      createdAt
      updatedAt
    }
    pageInfo {
      totalPages
      totalItems
      page
      perPage
      hasNextPage
      hasPreviousPage
    }
    totalCount
  }
}

Ejemplo de Filtrado Avanzado

query FilterTags {
  tagList(
    filter: {
      projectIds: ["project-123", "project-456"]
      search: "urgent"
      colors: ["#ff0000", "#ffaa00"]
      excludeArchivedProjects: true
    }
    orderBy: createdAt_DESC
    first: 20
  ) {
    items {
      id
      title
      color
      todos {
        id
        title
      }
    }
    totalCount
  }
}

Crear Etiquetas

Crear nuevas etiquetas dentro de un proyecto.

mutation CreateTag {
  createTag(
    input: {
      title: "High Priority"
      color: "#ff0000"
    }
  ) {
    id
    uid
    title
    color
    project {
      id
      name
    }
    createdAt
  }
}

Actualizar Etiquetas

Modificar propiedades de etiquetas existentes.

mutation UpdateTag {
  editTag(
    input: {
      id: "tag-123"
      title: "Critical Priority"
      color: "#cc0000"
    }
  ) {
    id
    title
    color
    updatedAt
  }
}

Eliminar Etiquetas

Eliminar etiquetas del sistema. Esto también eliminará la etiqueta de todos los registros asociados.

mutation DeleteTag {
  deleteTag(id: "tag-123")
}

Etiquetar Registros

Asociar etiquetas con registros (todos) utilizando etiquetas existentes o crear nuevas.

Usando Etiquetas Existentes

mutation TagRecord {
  setTodoTags(
    input: {
      todoId: "todo-123"
      tagIds: ["tag-456", "tag-789"]
    }
  )
}

Crear Etiquetas Mientras Etiquetas

Puedes crear nuevas etiquetas sobre la marcha proporcionando títulos de etiquetas:

mutation TagRecordWithNewTags {
  setTodoTags(
    input: {
      todoId: "todo-123"
      tagIds: ["existing-tag-id"]
      tagTitles: ["New Tag", "Another New Tag"]
    }
  )
}

Sugerencias de Etiquetas AI

Obtener sugerencias de etiquetas impulsadas por IA para un registro:

mutation GetTagSuggestions {
  aiTag(
    input: {
      todoId: "todo-123"
      suggestionsCount: 5
    }
  ) {
    suggestions {
      title
      confidence
      color
    }
  }
}

Parámetros de Entrada

Filtro de Lista de Etiquetas

Entrada para Crear Etiqueta

Entrada para Editar Etiqueta

Entrada para Establecer Etiquetas de Tarea

Valores de Entrada para Ordenar Etiquetas

Campos de Respuesta

Tipo de Etiqueta

Respuesta de Paginación de Etiquetas

Campos de Información de Página

Permisos Requeridos

Gestión de Etiquetas

Visibilidad de Etiquetas

Las etiquetas son visibles para todos los usuarios que tienen acceso al proyecto donde se creó la etiqueta. Puede aplicarse filtrado basado en roles para ciertas operaciones.

Respuestas de Error

Etiqueta No Encontrada

{
  "errors": [{
    "message": "Tag not found",
    "extensions": {
      "code": "NOT_FOUND"
    }
  }]
}

Formato de Color Inválido

{
  "errors": [{
    "message": "Color must be in hex format (e.g., #ff0000)",
    "extensions": {
      "code": "BAD_USER_INPUT"
    }
  }]
}

Permiso Denegado

{
  "errors": [{
    "message": "You do not have permission to modify tags in this project",
    "extensions": {
      "code": "FORBIDDEN"
    }
  }]
}

Registro No Encontrado

{
  "errors": [{
    "message": "Todo not found",
    "extensions": {
      "code": "NOT_FOUND"
    }
  }]
}

Mejores Prácticas

1. Usar Colores Consistentes: Establecer un sistema de codificación de colores para tu equipo
2. Títulos Descriptivos: Usar nombres de etiquetas claros y descriptivos que los miembros del equipo entenderán
3. Operaciones por Lotes: Usar setTodoTags para aplicar múltiples etiquetas a la vez
4. Buscar y Filtrar: Usar la funcionalidad de búsqueda para encontrar etiquetas existentes antes de crear nuevas
5. Gestión de Etiquetas: Revisar y limpiar regularmente etiquetas no utilizadas
6. Convenciones de Color: Considerar usar colores estándar para tipos de etiquetas comunes (rojo para urgente, verde para completado, etc.)

Características Avanzadas

Valores Predeterminados para la Creación de Etiquetas

• Las nuevas etiquetas creadas a través de setTodoTags con tagTitles predeterminan al color #4a9fff
• Las etiquetas sin colores especificados recurren a #00a0d2
• Los títulos de las etiquetas se recortan automáticamente de espacios en blanco

Integración de Automatización

Las etiquetas pueden ser:

• Aplicadas automáticamente por reglas de automatización
• Usadas como desencadenantes para flujos de trabajo de automatización
• Modificadas a través de acciones de automatización

Actualizaciones en Tiempo Real

Los cambios en las etiquetas se transmiten a través de suscripciones de GraphQL, permitiendo actualizaciones en tiempo real en los clientes conectados.

Notas Importantes

• Eliminar una etiqueta la quita de todos los registros asociados
• Las etiquetas son específicas del proyecto y no se pueden compartir entre proyectos
• Los valores de color deben ser códigos hex válidos (por ejemplo, "#ff0000", "#00aa00")
• Los títulos de las etiquetas son sensibles a mayúsculas y minúsculas
• Se pueden aplicar un máximo de 100 etiquetas a un solo registro
• Las etiquetas admiten búsqueda de texto completo en los títulos