- El evento productor
- El nombre
- Un operador
- Un parámetro
Evento
Cada regla de estadística se desencadena mediante un nombre de evento específico que registra el título. Tenga en cuenta que un único evento puede desencadenar varias reglas de estadísticas.Requisitos de nomenclatura
- El nombre de una regla tiene un nombre “raíz”. Opcionalmente, va seguido de uno o varios “campos”.
- La raíz es una cadena alfanumérica. Puede tener hasta 32 caracteres.
- La longitud total del nombre de la instancia de estadística no debe superar los 128 caracteres.
- El nombre debe comenzar con un carácter de letra y debe contener solo letras, números y el carácter de guion (-). No se permiten espacios, comas, puntos, guiones bajos ni ningún otro carácter especial. Algunos ejemplos de nombres son “EnemiesDefeated”, “BestScoreUnder2Minutes” y “Total-Collectibles-Jewels”.
- Los campos se separan con el carácter de punto (.).
- Los nombres de los campos deben coincidir exactamente con los nombres de los campos que forman parte del evento productor.
Cuando uno o varios campos se incluyen como parte del nombre de la regla de estadística, esta regla se convierte en una plantilla de estadística. En tiempo de ejecución, el valor real de los campos del evento productor se inserta en el nombre de la instancia de estadística.
- Algunos ejemplos de nombres de plantilla válidos son “EnemiesDefeated.WeaponID”, “BestScoreUnder2Minutes.TrackId.DifficultyID” y “Total-Collectibles-Jewels.Found”.
- Algunos ejemplos de nombres de instancia válidos son “EnemiesDefeated.WeaponID.17”, “BestScoreUnder2Minutes.TrackId.40.DifficultyID.Insane” y “Total-Collectibles-Jewels.Found.1”.
Recomendaciones sobre tipos de datos
- Se recomienda usar el tipo de datos entero para los campos de evento que formen parte del nombre de una plantilla de estadística.
-
Si el tipo de datos del campo de evento es booleano, el valor insertado es “1” para
truey “0” parafalse. - Si el tipo de datos del campo de evento es cadena Unicode, debe asegurarse de que los valores posibles de ese campo contengan solo caracteres válidos (como se describió anteriormente).
Operador
El valor de la instancia de estadística se calcula en tiempo de ejecución cuando se procesa el evento productor. La regla de estadística ejecuta una operación con el parámetro especificado. Las opciones de operación admitidas son las siguientes.SUMMAXMINREPLACE
Parámetro
El parámetro puede ser un valor constante o un nombre de campo del evento productor, como se muestra en la tabla siguiente.
El tipo de datos de la instancia de estadística resultante viene determinado por el tipo de datos del parámetro.
Los tipos de datos entero, flotante y booleano son compatibles con todos los operadores.
El tipo de datos cadena Unicode solo es compatible con el operador
REPLACE.
Los tipos de datos de estadísticas y parámetros se muestran en la tabla siguiente.
| Tipo de datos de la estadística | Tipo de datos del parámetro | Notas |
| --- | --- |
| Entero | Int32, Int64, UInt32, UInt64, Boolean | El valor entero más grande admitido es de 56 bits. El valor booleano se convierte de TRUE a 1 y de FALSE a 0. |
| Flotante | Float, Double | Flotante de 64 bits. |
| Cadena | UnicodeString, GUID | La longitud máxima de la cadena es de 50 caracteres. |