Sous-groupes pour les sources de répartition

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 4 minutes de lecture
  • Sous-groupes sont utilisés pour recatégoriser les données afin qu’elles puissent être utilisées comme répartition, par exemple en regroupant une plage de valeurs dans des compartiments discrets.

    Dans l’architecture de données, les sous-groupes sont définis dans des enregistrements de sous-groupe [pa_bucket_groups] et les sous-catégories dans les enregistrements de sous-catégories [pa_buckets]. Chaque enregistrement de catégorie [pa_buckets] contient un champ Sous-groupe qui est une référence à un enregistrement de sous-groupe [pa_bucket_groups].

    Pour utiliser un sous-groupe, créez une source de répartition qui utilise le compartiment [pa_buckets] comme table de faits et spécifie le sous-groupe dans une condition. Si une répartition basée sur cette source utilise un mappage de répartition avec un script, la répartition regroupe les valeurs renvoyées par le script dans des catégories. Si le mappage de répartition spécifie un champ au lieu d’utiliser un script, il regroupe les valeurs du champ mappé dans des catégories.

    Regroupement de valeurs de champ dans des catégories

    Vous pouvez utiliser un sous-groupe avec un mappage de répartition qui n’utilise pas de script, pour regrouper les valeurs de n’importe quel champ mappé aux catégories.

    Le cas d’utilisation peut être aussi simple que de traduire les valeurs vrai et faux d’un booléen en deux compartiments avec des étiquettes significatives.

    Tri des valeurs booléennes dans des compartiments

    Une installation de base Analyse des performances inclut la répartition Active dans le cadre de la vue d’ensemble de l’utilisation analytique. Cette répartition utilise un mappage au champ booléen job.active de la table Journal des tâches [pa_jobs_logs]. La source de répartition utilise un sous-groupe où les valeurs vraies de job.active sont triées dans la catégorie Actif, tandis que les valeurs fausses sont triées dans la catégorie Inactive. Notez que les valeurs fausses sont numériquement considérées comme une valeur inférieure à un, tandis que les valeurs vraies sont numériquement égale ou supérieure à un.

    Formulaire de groupe de catégories affichant les catégories inactives et actives et leurs plages

    Regroupement des résultats du script dans des catégories

    Lorsque vous disposez d’un script de mappage de répartition qui collecte une plage de valeurs, vous pouvez définir un sous-groupe pour diviser ces valeurs en compartiments distincts.

    Après avoir créé le sous-groupe, créez une source de répartition basée sur le sous-groupe. Vous créez ensuite une répartition qui utilise cette source de répartition. Lorsque vous créez le mappage de répartition pour la répartition, définissez ou sélectionnez un script pour le mappage. La répartition regroupe les résultats renvoyés par le script dans les compartiments du sous-groupe. Pour obtenir un exemple, reportez-vous à .Exemple : mappage de script

    Vous pouvez écrire un sous-groupe pour un script existant, ou vous pouvez d’abord écrire le sous-groupe, puis écrire le script. Les deux doivent exister pour que vous puissiez créer la répartition.

    Remarque :
    Le même script peut être utilisé avec n’importe quel nombre de sous-groupes. De plus, en principe, tous les scripts qui renvoient le même type de données peuvent être utilisés avec le même sous-groupe.

    Créer un sous-groupe

    Spécifiez un groupe de compartiments dans lequel vous souhaitez recatégoriser les données.

    Avant de commencer

    Rôle requis : pa_data_collector ou admin

    Procédure

    1. Accédez à la Tout > Répartitions > Sous-groupes.
    2. Cliquez sur Nouveau.
    3. Saisissez un nom qui identifie clairement le sous-groupe, comme Tranches d’âges en jours.
    4. Double-cliquez sur Insérer une nouvelle ligne pour ajouter un nouveau compartiment.
    5. Entrez un nom pour la première catégorie, puis appuyez sur Entrée ou cliquez sur l’icône de coche verte.
    6. Double-cliquez dans les colonnes Début et Fin pour entrer les valeurs de début et de fin de la plage.
      Les enregistrements qui correspondent à la valeur finale sont exclus de la catégorie. Par conséquent, définissez la valeur de fin d’une catégorie et la valeur de début de la catégorie suivante pour qu’elles soient identiques. Les enregistrements qui correspondent exactement à cette valeur sont triés dans la catégorie qui a cette valeur comme valeur de départ.
      Avertissement :
      Si la valeur de fin d’une catégorie ne correspond pas à la valeur de début de la catégorie suivante, vous avez un « trou » dans lequel les enregistrements ne sont triés dans aucune catégorie. Par exemple, si vous avez une catégorie qui se termine à 20 et que la catégorie suivante commence à 21, les enregistrements pour lesquels le script renvoie une valeur comprise entre 20,0000~ et 20,9999~ ne sont pas triés dans une catégorie.
    7. Cliquez sur Soumettre une fois que toutes les plages de catégories ont été définies.

    Tranches d’âges d’incidents Sous-groupe

    Considérez le cas où vous souhaitez regrouper les incidents par âge, comme suit :
    • Moins d’un jour
    • 1 à 5 jours
    • 6 à 30 jours
    • 31 à 90 jours
    • Plus de 90 jours
    Entrante Analyse des performances > Scripts, vous avez déjà un script nommé Incident.Age.Days. Ce script dérive l’âge en jours d’un incident à partir de sa date d’ouverture et de la dernière date à laquelle un score a été collecté :
    var diff=function(x,y){return y.dateNumericValue() - x.dateNumericValue();};
    var days=function(x,y){return diff(x,y)/(24*60*60*1000);};
    days(current.opened_at, score_end);
    Vous créez un sous-groupe nommé Tranches d’âges d’incidents (en jours). Dans ce sous-groupe, vous définissez un ensemble de compartiments qui commencent à la date souhaitée et se terminent au début du compartiment suivant. Par exemple, la catégorie de 06 à 30 jours commence à 6 et se termine à 31 :
    La catégorie de 06 à 30 jours

    Cette catégorie contiendra des incidents âgés de 6 jours précisément à 30 jours, 23 heures, 59 minutes et 59 secondes.

    À la fin, vous avez un sous-groupe avec cinq compartiments correspondant aux tranches d’âge dans lesquelles vous souhaitez diviser les incidents.

    Sous-groupes

    L’exemple de mappage de script montre une répartition qui utilise ce sous-groupe et ce script.

    Que faire ensuite

    Créez une source de répartition qui utilise la table des faits Catégorie [pa_buckets], le champ ID système et la condition [Sous-groupe][Est][<le nom du sous-groupe que vous avez créé>]. Créez ensuite une répartition qui utilise cette source de répartition et utilise le script approprié pour le mappage de répartition.