MLSolutionResult :グローバル (非推奨)

MLSolutionResult API は、クラスター情報とクラスタリング ソリューションのメンバを管理するためのメソッドを提供します。結果はビジネスロジックに埋め込むことができます。

注:

この API は廃止されており、今後のリリースで削除される予定です。最新のガイドラインについては、「 ML API の使用 」を参照してください。

MLSolutionResult - MLSolutionResult()

新しい MLSolutionResult オブジェクトをインスタンス化します。

表 : 1. パラメーター

名前	タイプ	説明
なし

MLSolutionResult - findActiveSolution(文字列 solutionName)

ソリューションオブジェクトを返します。

このメソッドは、ml_solution 定義とソリューションがアクティブ (すなわちトレーニング済み) な場合にのみソリューションを返します。詳細については、「 クラスタリングソリューションの作成とトレーニング 」を参照してください。

表 : 2. パラメーター

名前	タイプ	説明
solutionName	文字列	クラスタリング ml_solution レコードの名前。

表 : 3. 返される内容

タイプ	説明
オブジェクト	ml_solution の定義とソリューションがアクティブな場合は指定された solutionName のクラスタリングソリューションオブジェクト、アクティブでない場合は null。

var solutionName = 'ml_incident_assignment';
  var MLS = new MLSolutionResult();
  var solution = MLS.findActiveSolution(solutionName);
  gs.print(solution);
        

MLSolutionResult - getClusterAssignments(文字列 solutionName, オブジェクト options)

クラスタリングソリューションのすべてのメンバーを返します。

表 : 4. パラメーター

名前	タイプ	説明
solutionName	文字列	アクティブなクラスターソリューションの名前。
options	オブジェクト	オプション。返された結果を、クラスタリングソリューション内のグループとレベルで絞り込みます。 デフォルト：すべてのクラスターのクラスターメンバーシップを返します。
options.segmentation_field	文字列	オプション。クラスターメンバーシップ (アサイン先グループなど) を取得するセグメンテーションフィールドを識別します。 このフィールドは、[クラスタリングソリューション定義] テーブルの [グループ化] チェックボックスで提供されるオプションと同じグループ化を提供します。表示される情報は、[テーブル] フィールドで選択したテーブルによって異なります。詳細については、「 クラスタリングソリューションの作成とトレーニング 」を参照してください。
options.cluster_id	文字列	オプション。ml_cluster_summary テーブルの sys_id。
options.rec_sys_id	文字列	オプション。クラスターソリューションの基になるテーブルレコードの sys_id。

表 : 5. 返される内容

タイプ	説明
アレイ	次を含む結果オブジェクトのアレイ segmentation – データをグループ化するためのフィールド名 cluster_num – クラスターのソリューション内の一意のクラスター番号 (ラベル) rec_sys_id – クラスターソリューションの基になるテーブルレコードの sys_id rec_display_id – レコードの sys_id に関連付けられたレコードの名前。

次の例は、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);
}

次の例は、options.rec_sys_id を使用して 1 つのレコードのすべてのクラスターメンバーを返す方法を示しています。

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(文字列 solutionName, オブジェクト options)

クラスタリングソリューションのすべての結果情報を返します。

表 : 6. パラメーター

名前	タイプ	説明
solutionName	文字列	アクティブなクラスターソリューションの名前。
options	オブジェクト	オプション。返された結果を、クラスタリングソリューション内のグループとレベルで絞り込みます。 デフォルト：すべてのクラスターのクラスターメンバーシップを返します。
options.segmentation_field	文字列	オプション。クラスターメンバーシップ (アサイン先グループなど) を取得するセグメンテーションフィールドを識別します。 このフィールドは、[クラスタリングソリューション定義] テーブルの [グループ化] チェックボックスで提供されるオプションと同じグループ化を提供します。表示される情報は、[テーブル] フィールドで選択したテーブルによって異なります。詳細については、「 クラスタリングソリューションの作成とトレーニング」を参照してください。
options.cluster_id	文字列	オプション。ml_cluster_summary テーブルの sys_id。

表 : 7. 返される内容

タイプ	説明
アレイ	次を含む結果オブジェクトのアレイ segmentation – データをグループ化するためのフィールド名 cluster_num – クラスターのソリューション内の一意のクラスター番号 (ラベル) total_members – クラスター内のレコードの数 (サイズ) cluster_quality – クラスター品質のパーセンタイル値

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);
}