Évaluation historique

Appliquez la mesure actuelle aux événements enregistrés, choisissez de conserver ou de remplacer les réponses antérieures et tenez compte des éléments indisponibles et de la fin du traitement asynchrone.

L’évaluation historique applique une mesure aux événements déjà collectés dans votre organisation. Utilisez-la pour appliquer un nouveau critère à des traductions antérieures, mesurer des événements importés depuis l’historique d’un fournisseur ou examiner une période délimitée selon une définition révisée. Sur la page de détail de la mesure, vous la trouverez dans l’onglet Remplissage rétroactif.

Pour les contenus plus anciens d’un fournisseur, commencez par importer l’historique GitHub ou Zendesk, puis vérifiez que les événements souhaités apparaissent dans Radar → Journaux. La progression de l’importation comptabilise les éléments du fournisseur mis en file d’attente pour la collecte ; le mappage et le stockage peuvent se terminer plus tard. L’évaluation historique lit les données stockées des événements. L’historique importé nécessite un remplissage rétroactif de la mesure, car ces événements sont collectés sans être mesurés à leur arrivée.

Consulter les événements déjà mesurés #

La section Mesurés indique combien d’événements des types traités par la mesure disposent d’une réponse, y compris N/A, sur l’ensemble de l’historique enregistré — par exemple, « 1 204 événements mesurés sur 8 154 ». Elle comptabilise les événements dont les données sont stockées et inclut les types d’événements de la mesure, que celle-ci soit activée ou non. Ce total reste inchangé lorsque vous modifiez les dates de Remplissage rétroactif. Sous le total, chaque origine — dépôt GitHub, centre d’aide Zendesk, projet Crowdin ou Lingo.dev — indique combien de ses événements sont mesurés, par exemple « acme/web 1 180 sur 7 600 ». La mention Origine inconnue désigne les événements dont l’enregistrement ne précise aucune origine. GET /v2/organizations/:orgId/measurements/:measurementId/period-counts avec les valeurs ISO from (inclusive) et to (exclusive) renvoie les mêmes events, measured et origins pour tout intervalle.

Choisir la définition et la période #

Activez la mesure avant de commencer : Démarrer le remplissage rétroactif reste indisponible tant qu’elle est désactivée. Les types d’événements activés pour cette mesure déterminent quels événements anciens sont pris en compte. Chaque événement est ensuite vérifié selon les langues, les moteurs et l’échantillon actuellement définis dans sa condition. Un événement qui ne correspond pas à ces critères reçoit une réponse N/A, comme lors de l’évaluation en direct.

Sous Du et Au, l’onglet comptabilise les événements de la période par provenance : chaque dépôt GitHub, centre d’aide Zendesk, projet Crowdin et Lingo.dev. La mention Origine inconnue désigne les événements dont l’enregistrement ne précise aucune origine. Ce décompte porte sur les événements que lit un remplissage rétroactif : ceux des types activés pour la mesure dont les données sont stockées, avant que les conditions ne restreignent la sélection. Un événement qui ne correspond pas aux langues, aux moteurs ou aux origines d’une condition est inclus dans ce décompte et reçoit une réponse N/A. Le décompte ne s’affiche pas lorsque la mesure est désactivée.

Choisissez une courte période dont vous pouvez examiner les événements. Vérifiez que leurs données contiennent la source, la cible, le brouillon ou le contexte requis par le critère. Pour le respect du glossaire et des règles, conservez également les consignes actuelles pertinentes du moteur de localisation : ces vérifications lisent les termes et les règles associés au moment de l’évaluation, sans recréer le contexte de génération.

L’intervalle sélectionne les valeurs eventAt enregistrées. Une approbation Crowdin utilise l’horodatage de création de la suggestion, qui peut être antérieur au jour de l’approbation. Examinez l’horodatage de l’événement lorsque vous choisissez une période ; si vous ne sélectionnez que le jour de réception de l’approbation, cet événement risque d’être exclu.

Conserver ou remplacer les réponses antérieures #

L’option Uniquement les événements non encore mesurés est activée par défaut. Elle conserve les réponses déjà présentes sur la période et ne mesure que les événements sans réponse ; un événement ayant reçu une réponse N/A est considéré comme mesuré, et sa réponse est conservée.

Désactivez cette option pour mesurer à nouveau toute la période selon la définition actuelle. Au démarrage, une confirmation vous demande Mesurer à nouveau la période ?, car les réponses antérieures de la mesure sur cette période sont d’abord supprimées, puis réécrites à mesure que les événements sont mesurés.

Sauvegardez les réponses antérieures avant de les remplacer

Lorsque l’option Uniquement les événements non encore mesurés est désactivée, la suppression porte sur les réponses de la mesure dans tout l’intervalle sélectionné, y compris pour les types d’événements ou les langues qui ne sont plus sélectionnés. Sauvegardez d’abord la définition antérieure et les résultats nécessaires à la comparaison. Si des données sont ignorées ou qu’un remplacement échoue, une réponse qui existait auparavant peut rester manquante.

Démarrer une évaluation sur une période délimitée #

  1. Ouvrez l’onglet Remplissage rétroactif de la mesure.
  2. Renseignez les champs Du et Au. Les sélecteurs de date incluent les deux jours UTC choisis et ne permettent pas de sélectionner une date après aujourd’hui ; choisir le même jour dans les deux champs permet d’évaluer cette seule journée.
  3. Décidez si l’option Uniquement les événements non encore mesurés doit rester activée.
  4. Sélectionnez Démarrer le remplissage rétroactif, puis confirmez si vous remplacez des réponses.
  5. Suivez la ligne de progression — Remplissage rétroactif en cours, puis Remplissage rétroactif terminé ou Échec du remplissage rétroactif — qui indique le nombre d’événements mesurés. Le remplissage rétroactif figure aussi dans le panneau des tâches en arrière-plan, dans le coin de chaque page ; sélectionnez la ligne ou l’entrée du panneau pour afficher sa progression.

Le contrat de l’appel de démarrage sous-jacent est POST /v2/organizations/:orgId/measurements/:measurementId/backfill, avec des horodatages ISO, from inclusif et to exclusif ; il exige from < to et unmeasuredOnly. Via l’API, unmeasuredOnly vaut par défaut false, ce qui remplace les réponses ; envoyez true pour les conserver. Pour une journée UTC, l’intervalle va de minuit ce jour-là à minuit le lendemain ; l’interface convertit la date de fin inclusive en cette borne du lendemain. La réponse HTTP 202 contient un id d’exécution asynchrone. Un second remplissage rétroactif pour la même mesure est refusé tant qu’un premier est en cours. GET /v2/organizations/:orgId/backfills répertorie les exécutions récentes ; status=running&startedBy=me limite la liste aux exécutions en cours que vous avez démarrées.

Rapprocher les nouvelles réponses #

Le traitement lit les événements par pages et ne met les mesures en file d’attente que lorsque les données stockées sont disponibles. Un remplissage rétroactif terminé signifie que ses événements ont été mesurés, mais chaque réponse consigne son propre résultat. Les exécutions rétroactives sont comptabilisées comme les exécutions en direct, à l’exception des réponses ignorées en raison d’une condition. Les réponses issues du remplissage rétroactif ne génèrent pas de suggestions du moteur de localisation.

Examinez les événements et les résultats sélectionnés. L’historique des résultats n’affiche pas l’identifiant de l’exécution du remplissage rétroactif : faites donc correspondre l’identifiant de l’événement, celui de la mesure, l’intervalle des événements et l’heure de calcul. Incluez dans le rapprochement les événements attendus dont les réponses sont manquantes, plutôt que de déduire la fin du traitement des seules lignes renvoyées.

Consultez le motif de chaque nouvelle réponse N/A. Il peut s’expliquer par la sélection définie dans une condition, des éléments manquants, l’absence de consignes applicables ou l’incapacité d’un évaluateur à fournir une réponse concluante. Un échec d’exécution nécessite une procédure de reprise différente de celle d’une traduction admissible dont la source est manquante.

Conserver une comparaison en dehors de l’historique des remplacements #

Si vous cherchez à savoir si un critère révisé détecte les erreurs de manière plus fiable, conservez les anciennes et les nouvelles définitions, ainsi que des exemples évalués séparément et leurs résultats. Si vous cherchez à savoir si les traductions se sont améliorées, conservez les deux versions des traductions dans des conditions comparables.

Le remplissage rétroactif ne dispose d’aucune opération établie d’annulation ou de restauration des réponses. Pour rechercher un résultat manquant, évitez de lancer des réexécutions qui se chevauchent : identifiez d’abord les événements sélectionnés, les données manquantes et les réponses renvoyées. Comparer les modèles de traduction explique comment conserver des essais reproductibles sans dépendre d’un historique modifiable.