MLSolutionResult : global (déconseillé)

L’API MLSolutionResult 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épréciée et devrait être supprimée dans une version ultérieure. Reportez-vous à la section 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
Aucun

MLSolutionResult : findActiveSolution(String solutionName)

Renvoie l’objet de la solution.

Cette méthode renvoie uniquement les solutions 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 les autres cas.

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 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 au sein d’une solution de mise en grappe. Par défaut : renvoyer les appartenances à 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 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, y compris : segmentation : nom de champ par lequel regrouper les données cluster_num : numéro de grappe unique dans une solution de grappes (c’est-à-dire une é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’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, options de l’objet)

Renvoie toutes les informations sur les résultats d’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 au sein d’une solution de mise en grappe. Par défaut : renvoyer les appartenances à 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 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 clustering.
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, y compris : segmentation : nom de champ par lequel regrouper les données cluster_num : numéro de grappe unique dans une solution de grappes (c’est-à-dire une étiquette) total_members : nombre d’enregistrements dans la grappe (c’est-à-dire la taille) cluster_quality : la 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);
}