- L’événement producteur
- Le nom
- Un opérateur
- Un paramètre
Événement
Chaque règle de statistique est déclenchée par un nom d’événement spécifique journalisé par le titre. Notez que plusieurs règles de statistique peuvent être déclenchées par un seul événement.Exigences de nommage
- Un nom de règle comporte un nom « racine ». Il est éventuellement suivi d’un ou plusieurs « champs ».
- La racine est une chaîne alphanumérique. Elle peut contenir jusqu’à 32 caractères.
- La longueur totale du nom de l’instance de statistique ne doit pas dépasser 128 caractères.
- Le nom doit commencer par une lettre et ne doit contenir que des lettres, des chiffres et le caractère trait d’union (-). Les espaces, virgules, points, traits de soulignement et tout autre caractère spécial ne sont pas autorisés. Voici quelques exemples de noms : “EnemiesDefeated”, “BestScoreUnder2Minutes” et “Total-Collectibles-Jewels”.
- Les champs sont séparés par le caractère point (.).
- Les noms de champs doivent correspondre exactement aux noms de champs qui font partie de l’événement producteur.
Lorsqu’un ou plusieurs champs sont inclus dans le nom de la règle de statistique, cette règle devient un modèle de statistique. Au moment de l’exécution, la valeur réelle des champs de l’événement producteur est insérée dans le nom de l’instance de statistique.
- Voici quelques exemples de noms de modèles valides : “EnemiesDefeated.WeaponID”, “BestScoreUnder2Minutes.TrackId.DifficultyID” et “Total-Collectibles-Jewels.Found”.
- Voici quelques exemples de noms d’instances valides : “EnemiesDefeated.WeaponID.17”, “BestScoreUnder2Minutes.TrackId.40.DifficultyID.Insane” et “Total-Collectibles-Jewels.Found.1”.
Recommandations relatives aux types de données
- Nous vous recommandons d’utiliser le type de données entier pour les champs d’événement qui font partie d’un nom de modèle de statistique.
-
Si le type de données du champ d’événement est booléen, la valeur insérée est “1” pour
trueet “0” pourfalse. - Si le type de données du champ d’événement est une chaîne Unicode, vous devez vous assurer que les valeurs possibles de ce champ ne contiennent que des caractères valides (comme décrit précédemment).
Opérateur
La valeur de l’instance de statistique est calculée au moment de l’exécution, lors du traitement de l’événement producteur. La règle de statistique exécute une opération avec le paramètre spécifié. Les opérations prises en charge sont les suivantes.SUMMAXMINREPLACE
Paramètre
Le paramètre peut être une valeur constante ou un nom de champ de l’événement producteur, comme indiqué dans le tableau suivant.
Le type de données de l’instance de statistique obtenue est déterminé par le type de données du paramètre.
Les types de données Integer, Float et Boolean sont pris en charge par tous les opérateurs.
Le type de données chaîne Unicode n’est pris en charge que par l’opérateur
REPLACE.
Les types de données des statistiques et des paramètres sont indiqués dans le tableau suivant.
| Type de données de la statistique | Type de données du paramètre | Remarques |
| --- | --- |
| Integer | Int32, Int64, UInt32, UInt64, Boolean | La plus grande valeur entière prise en charge est sur 56 bits. Boolean est converti de TRUE en 1 et de FALSE en 0. |
| Float | Float, Double | Float 64 bits. |
| String | UnicodeString, GUID | La longueur maximale de la chaîne est de 50 caractères. |