> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Accéder aux résultats archivés des tournois
> Accédez aux instantanés archivés des classements de tournois PlayFab après une réinitialisation manuelle ou planifiée, et récupérez les classements et les statistiques des joueurs de la version précédente.
Ce tutoriel montre comment accéder aux états archivés des classements.
Chaque classement peut être réinitialisé manuellement ou automatiquement, ce qui signifie que les valeurs de statistiques seront supprimées pour tous les joueurs, menant à un état *vierge*, et que la version du classement sera incrémentée.
Avant que cela se produise, toutefois, PlayFab crée un instantané de toutes les valeurs de statistiques du classement pour chaque joueur. Cela vous permet d'accéder à cette version *archivée* du classement.
Tous les titres vous permettent d'accéder à la version archivée la plus récente d'un classement, ce qui vous donne la version actuelle et la version précédente. Par exemple, si la version actuelle de votre classement est **3**, vous pouvez accéder uniquement à la version **3** et à la version archivée **2**.
## Configuration initiale
Avant d'utiliser ce guide, assurez-vous d'avoir déjà quelques joueurs inscrits pour le titre. La capture d'écran suivante montre 5 joueurs inscrits artificiellement à l'aide de l'appel d'API [LoginWithCustomID](xref:titleid.playfabapi.com.client.authentication.loginwithcustomid).
## Définir et simuler un classement
Dans cette étape, nous allons créer un classement à des fins de test. Nous simulerons ensuite le processus d'itération du classement en le remplissant et en le réinitialisant à plusieurs reprises.
Ouvrez Game Manager :
1. Accédez à la section **Leaderboards**.
2. Sélectionnez le bouton **New Leaderboard**, comme illustré ci-dessous.
Pour configurer le nouveau classement :
1. Définissez le nom de **Statistic** à **TestScore**.
2. Conservez la valeur **Manually** pour **Reset Frequency**.
3. Laissez la méthode **Aggregation** par défaut.
4. Soumettez en sélectionnant **Save Leaderboard**.
Vous arriverez sur la nouvelle page **Leaderboards**, qui affichera des données vides (voir ci-dessous).
## Début de la section de test
La section suivante est un exemple de la façon de remplir des données de test aux fins de cet exemple. Votre *vrai* jeu remplira ces données de manière plus naturelle.
Notre prochaine étape consiste à simuler des données pour notre classement. La façon la plus rapide de le faire est de créer un gestionnaire CloudScript, qui définira des statistiques aléatoires pour un joueur donné. Nous invoquerons ce gestionnaire pour chaque joueur du segment All Players.
Ainsi, chaque joueur obtiendra une valeur de statistique aléatoire, ce qui constitue une approximation *suffisamment bonne* d'un scénario réel.
Commençons par définir notre CloudScript (consultez les commentaires du code pour plus d'information).
```javascript theme={null}
// Should be invoked from a task that runs over certain segment
handlers.PopulateLeaderboard = (args,ctx) => {
// When handler is executed as a task over the segment
// we can extract individual player id using the next line:
let playerId = ctx.playerProfile.PlayerId;
// Use player id and update player statistics as follows:
server.UpdatePlayerStatistics({
PlayFabId : playerId,
Statistics : [
{
"StatisticName": "TestScore",
"Value": getRandomInRange(100,1000)
}
]
});
}
// Utility method to generate random number
let getRandomInRange = (min, max) => {
return Math.round(Math.random() * (max - min) + min);
}
```
Téléversons le CloudScript. À l'aide de Game Manager :
1. Accédez à l'onglet **Automation**.
2. Accédez ensuite au sous-onglet **CloudScript**.
3. Insérez le code **CloudScript**.
4. Sélectionnez **Save as Revision**.
5. Enfin, sélectionnez **Deploy Revision**.
Ensuite, nous devons définir une tâche pour exécuter notre CloudScript sur un segment précis :
1. Accédez à l'onglet **Players**.
2. Accédez ensuite au sous-onglet **Segments**.
Par défaut, **PlayFab** génère un segment **All Players** pour vous. Ce segment est particulièrement utile lorsque vous avez besoin de tous les joueurs inscrits dans votre titre (ce qui est exactement notre cas).
3. Sélectionnez le segment **All Players**.
4. Enfin, sélectionnez **Run Task...**.
Si aucun segment All Players ne figure dans la liste, consultez notre démarrage rapide sur la [segmentation des joueurs](/fr-CA/services/playfab/live-service-management/game-configuration/segmentation/segmentation-quickstart) pour en créer un.
Pour configurer la tâche :
1. Définissez le **Name**.
2. Assurez-vous que le type de tâche est défini à **Run actions on each Player in a Segment**.
* Vérifiez également que **All Players** est sélectionné sous **Segment**.
3. Ajoutez une nouvelle **Action**.
4. Sélectionnez **Execute CloudScript** sous **Type**.
5. Sélectionnez ensuite le gestionnaire **PopulateLeaderboard** sous **CloudScript Function**.
6. Enfin, sélectionnez le bouton **Save and Run**.
* Assurez-vous que le résultat de l'exécution est **Successful**.
## Fin de la section de test
### Remplir les données de test
1. Accédez de nouveau à l'onglet **Leaderboards**.
2. Sélectionnez notre **Leaderboard**.
1. Vous verrez que votre **Leaderboard** a été rempli de valeurs aléatoires.
2. Réinitialisez le **Leaderboard**.
Cela créera un instantané de toutes les données dont nous disposons actuellement, puis *annulera* les valeurs de statistiques de chaque joueur et incrémentera la version.
* Une fois votre classement réinitialisé, exécutez de nouveau la tâche CloudScript.
* Répétez cette opération 2 ou 3 fois, puis réinitialisez et remplissez de nouveau.
Vous obtiendrez plusieurs versions du **Leaderboard** **(1)** :
* Les **données de la version actuelle** seront affichées dans le tableau de gauche **(3)**.
* Les **données archivées** seront disponibles pour les versions précédentes **(2)**.
* Seule la dernière version sera disponible. Cela s'applique à tous les titres.
### Accéder aux données archivées à l'aide de Game Manager
Vous pouvez accéder aux résultats archivés directement à partir de la page **Leaderboard** :
1. Accédez à l'onglet **Leaderboards**.
2. Sélectionnez le **Leaderboard** dont vous avez besoin.
1. Si votre **Leaderboard** contient des révisions archivées, vous pourrez télécharger les données **JSON** à l'aide du lien de téléchargement illustré dans la capture d'écran ci-dessous.
### Accéder aux données archivées à l'aide de l'API
Le code suivant vous permet d'extraire la dernière version (actuelle) du classement.
```csharp theme={null}
PlayFabClientAPI.GetLeaderboard(new GetLeaderboardRequest()
{
StatisticName = "TestScore",
}, result =>
{
Debug.Log("Leaderboard version: "+result.Version);
foreach (var entry in result.Leaderboard)
{
Debug.Log(entry.PlayFabId+" "+entry.StatValue);
}
}, FailureCallback);
```
Le résultat ressemblera à l'exemple ci-dessous.
Vous pouvez également spécifier la version du classement que vous souhaitez charger.
```csharp theme={null}
PlayFabClientAPI.GetLeaderboard(new GetLeaderboardRequest()
{
StatisticName = "TestScore",
Version = 1
}, result =>
{
Debug.Log("Leaderboard version: "+result.Version);
foreach (var entry in result.Leaderboard)
{
Debug.Log(entry.PlayFabId+" "+entry.StatValue);
}
}, FailureCallback);
```
Le résultat ressemblera à l'exemple ci-dessous.
Tous les titres vous permettent d'accéder à la *dernière* version archivée du classement. Toute tentative d'extraire une version plus ancienne entraînera une erreur (voir ci-dessous).
Les mêmes règles s'appliquent à toutes les requêtes de classement.
* [GetLeaderboard](xref:titleid.playfabapi.com.client.playerdatamanagement.getleaderboard)
* [GetLeaderboardAroundPlayer](xref:titleid.playfabapi.com.client.playerdatamanagement.getleaderboardaroundplayer)
* [GetFriendLeaderboardAroundPlayer](xref:titleid.playfabapi.com.client.playerdatamanagement.getfriendleaderboardaroundplayer)
* [GetFriendLeaderboard](xref:titleid.playfabapi.com.client.playerdatamanagement.getfriendleaderboard)
Consultez la documentation de l'objet [GetLeaderboardResult](xref:titleid.playfabapi.com.client.playerdatamanagement.getleaderboard#getleaderboardresult) pour en savoir plus sur les propriétés utiles que vous pouvez obtenir avec les données du classement.
## Related topics
- [Utilisation du profil pour des classements avancés](/fr-CA/services/playfab/community/leaderboards/tournaments-leaderboards/using-the-profile-for-advanced-leaderboards.md)
- [Démarrage rapide des notifications push](/fr-CA/services/playfab/live-service-management/game-configuration/title-communications/push-notifications/quickstart.md)
- [Tournois et classements](/fr-CA/services/playfab/community/leaderboards/tournaments-leaderboards/index.md)
- [Accéder aux ressources et aux téléchargements du GDK](/fr-CA/home/onboarding-access/access-resources.md)
- [Démarrage rapide : tournois et classements](/fr-CA/services/playfab/community/leaderboards/tournaments-leaderboards/quickstart.md)