Sous-groupes pour les sources de répartition

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 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 les enregistrements de sous-groupe [pa_bucket_groups] et les compartiments dans les enregistrements de sous-catégorie [pa_buckets]. Chaque enregistrement de catégorie [pa_buckets] contient un champ de 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 créée à partir de 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é en catégories.

    Regroupement des 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é à des catégories.

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

    Tri des valeurs booléennes dans les compartiments

    Une installation de base Analyse des performances inclut la répartition Actif dans la vue d’ensemble de l’utilisation d’Analytics. 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 pour job.active sont classées dans le compartiment Actif, tandis que les valeurs fausses sont classées dans le compartiment Inactif. 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 égales à un et au-dessus.

    Formulaire de sous-groupe affichant les sous-groupes Inactifs et Actifs et leurs plages

    Regroupement des résultats de script en 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 catégories distinctes.

    Une fois le sous-groupe créé, vous créez une source de répartition basée sur ce sous-groupe. Ensuite, vous créez une répartition qui utilise cette source de répartition. Lorsque vous créez le mappage de répartition pour le 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 avant de pouvoir 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 groupe de catégories.

    Créer un sous-groupe

    Spécifiez un groupe de catégories dans lesquelles vous souhaitez reclasser 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’âge en jours.
    4. Double-cliquez sur Insérer une nouvelle ligne pour ajouter une nouvelle catégorie.
    5. Saisissez 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 saisir les valeurs de début et de fin de la plage.
      Les enregistrements qui correspondent à la valeur de fin 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 comme identique. Les enregistrements qui correspondent exactement à cette valeur sont triés dans la catégorie dont la valeur de départ est la suivante :
      Avertissement :
      Si la valeur de fin d’une catégorie ne correspond pas à la valeur de début de la catégorie suivante, vous obtenez un « trou » où 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 des catégories.
    7. Cliquez sur Soumettre une fois que toutes les plages de compartiments ont été définies.

    Sous-groupe des tranches d’âges des incidents

    Prenons 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 nouveau sous-groupe nommé Tranches d’âges d’incidents (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

    Ce compartiment contient des incidents âgés de 6 jours précisément à 30 jours, 23 heures, 59 minutes et 59 secondes.

    À la fin, vous disposez d’un sous-groupe de cinq compartiments correspondant aux tranches d’âge dans lesquelles vous souhaitez répartir 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 de 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éé>]. Ensuite, créez une répartition qui utilise cette source de répartition et utilise le script approprié pour le mappage de répartition.