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éconseillée et est destinée à être supprimée dans une version ultérieure. Reportez-vous à la section Utilisation des API ML pour 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 solution.

Cette méthode ne renvoie les solutions que si la définition et la solution ml_solution sont actives (c’est-à-dire entraîné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 UtiliserGrouper 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ésultats, y compris : segmentation : nom de champ selon lequel 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 cluster est basée rec_display_id : nom de l’enregistrement associé au sys_id d’enregistrement.

L’exemple suivant montre comment renvoyer tous les membres d’une grappe 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 d’une grappe 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 objet)

Renvoie toutes les informations sur le résultat 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 UtiliserGrouper 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ésultats, y compris : segmentation : nom de champ selon lequel 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 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);
}