MLSolutionResult : global (déconseillé)

L’API MLSolutionResult fournit des méthodes pour gérer les informations de grappe et les membres d’une solution de mise en grappe. Vous pouvez incorporer 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 : MLSolutionResult()

Instancie un nouvel objet MLSolutionResult.

Tableau 1. Paramètres

Nom	Type	Description
Néant

MLSolutionResult : findActiveSolution(String solutionName)

Renvoie l’objet de la solution.

Cette méthode ne renvoie les solutions que 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 2. Paramètres

Nom	Type	Description
solutionName	Chaîne	Nom de l’enregistrement de ml_solution de mise en grappe.

Tableau 3. Renvoie

Type	Description
Objet	Objet de solution de mise en grappe pour le solutionName spécifié si la définition et la solution de 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, Object options)

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

Tableau 4. 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 dans une solution de mise en grappe. Par défaut : renvoie les appartenances à toutes les grappes.
options.segmentation_field	Chaîne	Facultatif. Identifie le champ de segmentation pour lequel récupérer les appartenances à des grappes, par exemple, le groupe d’affectation. Ce champ fournit le même regroupement que les options fournies via la case à cocher Utiliser le groupe 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. Le 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 5. Renvoie

Type	Description
Tableau	Tableau d’objets de résultat, notamment : segmentation : nom de champ utilisé pour regrouper des données cluster_num : numéro de grappe unique dans une solution de grappes (c.-à-d. étiquette) 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’enregistrement sys_id.

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 de la grappe pour un seul 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 sur les résultats pour une solution de mise en grappe.

Tableau 6. 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 dans une solution de mise en grappe. Par défaut : renvoie les appartenances à toutes les grappes.
options.segmentation_field	Chaîne	Facultatif. Identifie le champ de segmentation pour lequel récupérer les appartenances à des grappes, par exemple, le groupe d’affectation. Ce champ fournit le même regroupement que les options fournies via la case à cocher Utiliser le groupe 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 mise en grappe.
options.cluster_id	Chaîne	Facultatif. Le sys_id de la table ml_cluster_summary.

Tableau 7. Renvoie

Type	Description
Tableau	Tableau d’objets de résultat, notamment : segmentation : nom de champ utilisé pour regrouper des données cluster_num : numéro de grappe unique dans une solution de grappes (c.-à-d. étiquette) total_members – Nombre d’enregistrements dans la grappe (c.-à-d. 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);
}