Aviso de caducidad de la API GraphQL de Quest

Estamos dejando obsoletos varios tipos, campos y filtros de entrada GraphQL relacionados con Quest como parte de nuestra migración a un sistema de informes Quest mejorado (reportV2 y findQuests). Estos cambios agilizan la recuperación de datos de Quest y proporcionan un mejor soporte para múltiples selecciones de Quest.

• Elementos obsoletos
• Guía de Migración
• Diferencias Clave
• Compatibilidad con versiones anteriores
• Acción Requerida

Elementos obsoletos

• Estado: Obsoleto
• Sustitución: Utilice findQuests y/o reportV2 en su lugar
• Motivo: Se está sustituyendo por una implementación más eficiente que permite consultar varias búsquedas simultáneamente
   

• Estado: Obsoleto
• Sustitución: Utilice reportV2 en lugar de
• Razón: El nuevo reportV2 proporciona capacidades de filtrado mejoradas y una mejor agregación de datos

• Sustitución: Usar questSourceIds: [ (plural) en QuestFilterInputV2
• Nota: El nuevo campo acepta múltiples Quest IDs, permitiendo informes multi-Quest
   

• Reemplazo: Ninguno - reportV2 siempre devuelve los datos de la última revisión de la búsqueda
• Nota: El seguimiento de la revisión se gestiona ahora automáticamente
   

• Sustitución: Utilice las opciones de filtrado en reportV2
• Nota: El filtrado por etiquetas sigue siendo soportado pero a través de la nueva estructura de entrada
   

• Sustitución: Utilice las opciones de filtrado en reportV2
• Nota: El filtrado por equipos sigue siendo posible pero a través de la nueva estructura de entrada

• details: QuestDetails! → Utilice reportV2.quests
• objectiveCompletion(...) → Utilice reportV2.objectiveCompletion
• objectiveAccuracy(...) → Utilice reportV2.objectiveAccuracy
• securityConceptObjectiveCompletion(...) → Utilice reportV2.securityConceptObjectiveCompletion
• learners: QuestLearners → Utilizar reportV2.learners

Guía de Migración

Antes (obsoleto - búsqueda única)
 

query {
  quests {
    report(filter: {
      questSourceId: "quest-123"
      questRevisionNumber: 5
      tags: ["engineering"]
      teamIds: ["team-1", "team-2"]
    }) {
      details {
        name
        status
      }
      objectiveCompletion(first: 10) {
        edges {
          node {
            category
            completionRate
          }
        }
      }
      learners {
        objectiveAssignedLearners(first: 20) {
          edges {
            node {
              name
              email
            }
          }
        }
      }
    }
  }
}

query {
  quests {
    reportV2(filter: {
      questSourceIds: ["quest-123", "quest-456"]
      tags: ["engineering"]
      teamIds: ["team-1", "team-2"]
    }) {
      quests {
        edges {
          node {
            name
            status
          }
        }
      }
      objectiveCompletion(first: 10) {
        edges {
          node {
            category
            allLearnersCompletedRate
          }
        }
      }
      learners {
        objectiveAssignedLearners(first: 20) {
          edges {
            node {
              name
              email
            }
          }
        }
      }
    }
  }
}

Key Differences
 

1. Multiple Quests: reportV2 accepts multiple Quest IDs via questSourceIds (plural)
2. Automatic Latest Revision: No es necesario especificar questRevisionNumber - siempre se utiliza la última revisión
3. Campos mejorados: Se ha cambiado el nombre de algunos campos de finalización (por ejemplo, completionRate → allLearnersCompletedRate)
4. Filtrado: El filtrado de etiquetas y equipos se gestiona a través de la nueva estructura de filtros de reportV2

Compatibilidad con versiones anteriores

Los campos y tipos obsoletos seguirán funcionando hasta 1 de noviembre de 2025. Sin embargo, recomendamos encarecidamente migrar a reportV2 y findQuests lo antes posible para:
 

• Aprovechar las ventajas de los informes multiQuest
• Garantizar un servicio ininterrumpido después de la fecha de eliminación
• Beneficiarse de un mejor rendimiento y precisión de los datos

Acción Requerida

• findQuests para recuperar detalles Quest
• reportV2 con QuestFilterInputV2 para datos de informes Quest