MLSolutionResult : global (déconseillé)

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 3 minutes de lecture
  • Fournit des méthodes de gestion des informations de grappe et des membres d’une solution de mise en grappe. Vous pouvez intégrer les résultats dans la logique métier.

    Remarque :
    Cette API a été déconseillée et est destinée à être supprimée dans une version ultérieure. Consultez Utilisation des API ML pour connaître les directives les plus récentes.

    MLSolutionResult : findActiveSolution(String solutionName)

    Renvoie l’objet solution.

    Cette méthode renvoie les solutions uniquement si la définition et la solution ml_solution sont actives (c’est-à-dire formées). (pour en savoir plus, consultez Créer et former une solution de mise en grappe ) ;

    Tableau 1. Paramètres
    Nom Type Description
    solutionName Chaîne Nom de l’enregistrement de ml_solution de mise en grappe.
    Tableau 2. Renvoie
    Type Description
    Objet Objet de solution de mise en grappe pour le solutionName spécifié si la définition et la solution ml_solution sont actives ; null dans le cas contraire.
    var solutionName = 'ml_incident_assignment';
      var MLS = new MLSolutionResult();
      var solution = MLS.findActiveSolution(solutionName);
      gs.print(solution);
            

    MLSolutionResult : getClusterAssignments(String, solutionName, options de l’objet)

    Renvoie tous les membres d’une solution de mise en grappe.

    Tableau 3. Paramètres
    Nom Type Description
    solutionName Chaîne Nom de la solution de grappe active.
    options Objet Facultatif. Réduit les résultats renvoyés par groupe et par niveau au sein d’une solution de mise en grappe.

    Par défaut : renvoie les appartenances à des grappes pour toutes les grappes.

    options.segmentation_field Chaîne Facultatif. Identifie le champ de segmentation pour lequel récupérer les appartenances à la grappe, par exemple, le groupe d’affectation.

    Ce champ fournit le même regroupement que les options fournies via la case à cocher Utiliser regrouper par dans la table Définitions de solutions de mise en grappe . Les informations fournies varient selon la table sélectionnée dans le champ Table . (pour en savoir plus, consultez Créer et former une solution de mise en grappe ) ;

    options.cluster_id Chaîne Facultatif. La sys_id de la table ml_cluster_summary.
    options.rec_sys_id Chaîne Facultatif. Le sys_id de l’enregistrement de table sur lequel la solution de grappe est basée.
    Tableau 4. Renvoie
    Type Description
    Tableau Tableau d’objets de résultat, incluant :
    • segmentation : nom de champ par lequel regrouper les données
    • cluster_num Numéro de cluster unique au sein d’une solution de clusters (c’est-à-dire label)
    • rec_sys_id sys_id de l’enregistrement de table sur lequel la solution de grappe est basée
    • rec_display_id : nom de l’enregistrement associé à l’sys_id d’enregistrement.

    L’exemple suivant montre comment renvoyer tous les membres du cluster pour une solution sans définir de valeurs pour l’objet options.

    var solutionName = "<Name_of_Active_Cluster_Solution>";
    var solutionResult = new MLSolutionResult();
    var outcome_array = solutionResult.getClusterAssignments(solutionName);
    for (var i = 0; i < outcome_array.length; i++) {
       gs.print(outcome_array [i].segmentation + ' ' + outcome_array [i].cluster_num + ' ' + outcome_array [i].rec_sys_id + ' ' + outcome_array [i].rec_display_id);
    }

    L’exemple suivant montre comment renvoyer tous les membres du cluster pour un enregistrement à l’aide de options.rec_sys_id.

    var now_GR = new GlideRecord('incident');
    now_GR.get('sys_id');
    
    var solutionName = "solution_example";
    var solutionResult = new MLSolutionResult();
    var options = { "rec_sys_id": now_GR.getUniqueValue() };
    var outcome_array = solutionResult.getClusterAssignments(solutionName, options);
    for (var i = 0; i < outcome_array.length; i++) {
       gs.print(outcome_array [i].segmentation + ' ' + outcome_array [i].cluster_num + ' ' + outcome_array [i].rec_sys_id + ' ' + outcome_array [i].rec_display_id);
    }

    MLSolutionResult : getClusterInfo(String, solutionName, Object options)

    Renvoie toutes les informations de résultat pour une solution de mise en grappe.

    Tableau 5. Paramètres
    Nom Type Description
    solutionName Chaîne Nom de la solution de grappe active.
    options Objet Facultatif. Réduit les résultats renvoyés par groupe et par niveau au sein d’une solution de mise en grappe.

    Par défaut : renvoie les appartenances à des grappes pour toutes les grappes.

    options.segmentation_field Chaîne Facultatif. Identifie le champ de segmentation pour lequel récupérer les appartenances à la grappe, par exemple, le groupe d’affectation.

    Ce champ fournit le même regroupement que les options fournies via la case à cocher Utiliser regrouper par dans la table Définitions de solutions de mise en grappe . Les informations fournies varient selon la table sélectionnée dans le champ Table . Pour plus d’informations, consultez Créer et former une solution de clustering.

    options.cluster_id Chaîne Facultatif. La sys_id de la table ml_cluster_summary.
    Tableau 6. Renvoie
    Type Description
    Tableau Tableau d’objets de résultat, incluant :
    • segmentation : nom de champ par lequel regrouper les données
    • cluster_num Numéro de cluster unique au sein d’une solution de clusters (c’est-à-dire label)
    • total_members : nombre d’enregistrements dans la grappe (c’est-à-dire, taille)
    • cluster_quality – Valeur centile de la qualité de la grappe
    var solutionName = "solution_example";
    var solutionResult = new MLSolutionResult();
    var outcome_array = solutionResult.getClusterInfo(solutionName);
    for (var i = 0; i < outcome_array.length; i++) {
    gs.print(outcome_array[i].segmentation + ' ' + outcome_array[i].cluster_num + ' ' + outcome_array[i].total_members + ' ' + outcome_array[i].cluster_quality);
    }

    MLSolutionResult : MLSolutionResult()

    Instancie un nouvel objet MLSolutionResult.

    Tableau 7. Paramètres
    Nom Type Description
    Néant