DCManager - グローバル

DCManager API を使用すると、データをタイプ別にグループ化できます。

この API を使用すると、次のことができます。

• 既存の辞書エントリにデータ分類を割り当てます。
• 特定の辞書エントリのデータ分類を検索します。
• 特定の辞書エントリに関連付けられているすべてのデータ分類を削除します。
• 現在のドメインで利用可能なすべてのデータ分類のリストを取得します。

この API にはデータ分類 [com.glide.data_classification] プラグインが必要です。

詳細については、「 データ分類」を参照してください。

DCManager - classify(String dictEntries, String dataClasses)

事前定義またはユーザー定義のデータ分類を既存の辞書エントリに割り当てます。

admin または data_classification_admin ロールが必要です。

表 : 1. パラメーター

名前	タイプ	説明
dictエントリ	文字列	分類するレコードのSys_ids。文字列で囲まれたカンマ区切りリストとして入力します。 テーブル:辞書 [sys_dictionary] テーブル
データクラス	文字列	アサインするデータ分類のSys_ids。文字列で囲まれたカンマ区切りリストとして入力します。 テーブル:データ分類 [data_classification]

表 : 2. 返される内容

タイプ	説明
文字列	操作の結果を説明するメッセージ。

この例では、社会保障番号を含むレコードを検索し、そのレコードを機密として分類します。

var dcm = new SNC.DCManager();
var confidentialClass = {};
var ssnFields = [];
var dataClasses = JSON.parse(dcm.getAllDataClasses());

// Get the Confidential data class record
dataClasses.forEach(function (dataClass) {
  if (dataClass.name == "Confidential")
    confidentialClass = dataClass;
});

// Find fields that seem to be strong social security numbers
var dictionaryGR = new GlideRecord("sys_dictionary");
dictionaryGR.addQuery("element", "ssn").addOrCondition("element", "social_security_number");
dictionaryGR.query();
while (dictionaryGR.next())
  ssnFields.push(dictionaryGR.getUniqueValue());

// Classify any found entries as Confidential
if (ssnFields.length > 0)
  dcm.classify(ssnFields.join(), confidentialClass.sys_id);

出力：

"Successfully stored the data classification configurations"

DCManager:clearClassification(文字列 dictEntries)

指定された辞書エントリのすべてのデータ分類を削除します。

admin または data_classification_admin ロールが必要です。

表 : 3. パラメーター

名前	タイプ	説明
dictエントリ	文字列	分類を削除するレコードのSys_ids。文字列で囲まれたカンマ区切りリストとして入力します。 テーブル:辞書 [sys_dictionary]

表 : 4. 返される内容

タイプ	説明
文字列	操作の結果を説明するメッセージ。

この例では、辞書エントリのデータ分類を削除します。

var dcm = new SNC.DCManager();
gs.info(dcm.clearClassification("445de0a6dba30300efc57416bf9619b0"));

出力：

"Classifications removed for the specified dictionary entries"

DCManager:getAllDataClasses()

現在のドメインで利用可能なすべてのデータ分類のリストを返します。

admin、data_classification_admin、または data_classification_auditor ロールが必要です。

表 : 5. パラメーター

名前	タイプ	説明
なし

表 : 6. 返される内容

タイプ	説明
<アレイ>	要求の結果です。利用可能な各データ分類のsys_idと名前を返します。データ分類がない場合は、空のアレイが返されます。 データ分類は、親子関係に編成できます。親データ分類がある場合、それらは結果で識別されます。 データタイプ：アレイ [ { "parent": {Object}, "sys_id": "String", "name": "String" } ]
<Array>.parent	親データ分類のエントリ。 データタイプ: オブジェクト "parent": { "sys_id": "String", "name": "String" }
<アレイ>.parent.sys_id	データ分類 [data_classification] テーブルからの親データ分類のSys_id。 データタイプ：文字列
<Array>.parent.name	親データ分類の名前。 データタイプ：文字列
<アレイ>.sys_id	データ分類 [data_classification] テーブルからのデータ分類のSys_id。 データタイプ：文字列
<Array>.name	データ分類名。 データタイプ：文字列

この例では、使用可能なすべてのデータ分類のリストを取得します。

var dcm = new SNC.DCManager();
gs.info(dcm.getAllDataClasses());

出力：

[
  {
    "parent": {
      "sys_id": "a9670fc773fc1010ae8dd21efaf6a735",
      "name": "Confidential"
    },
    "sys_id": "348107b951d71010f877f3f178e7dd0d",
    "name": "Personally identifiable information"
  },
  {
    "sys_id": "a9670fc773fc1010ae8dd21efaf6a735",
    "name": "Confidential"
  },
  {
    "sys_id": "59b7070b73fc1010ae8dd21efaf6a764",
    "name": "Restricted"
  },
  {
    "sys_id": "11d60fc773fc1010ae8dd21efaf6a744",
    "name": "Internal"
  },
  {
    "sys_id": "f5b4cf4773fc1010ae8dd21efaf6a766",
    "name": "Public"
  }
]

DCManager:getClassification(文字列 dictEntries)

指定された辞書エントリのすべてのデータ分類を取得します。

表 : 7. パラメーター

名前	タイプ	説明
dictエントリ	文字列	分類を取得するレコードのSys_ids。文字列で囲まれたカンマ区切りリストとして入力します。 テーブル:辞書 [sys_dictionary]

表 : 8. 返される内容

タイプ	説明
<Object>	各辞書エントリのsys_idとそれに関連するデータクラスのアレイを含む JSON オブジェクト。関連するデータ分類がない場合は、操作の結果を説明するメッセージを返します。 データ分類は、親子関係に編成できます。親データ分類がある場合、それらは結果で識別されます。 データタイプ: オブジェクト { <sys_dictionary_sys_id>: [ { "parent": {Object}, "sys_id": "String", "name": "String" } ] }
<Object>.parent	親データ分類のエントリ。 データタイプ: オブジェクト "parent": { "sys_id": "String", "name": "String" }
<Object>.parent.sys_id	データ分類 [data_classification] テーブルからの親データ分類のSys_id。 データタイプ：文字列
<Object>.parent.name	親データ分類の名前。 データタイプ：文字列
<Object>.sys_id	データ分類 [data_classification] テーブルからのデータ分類のSys_id。 データタイプ：文字列
<Object>.name	データ分類名。 データタイプ：文字列

この例では、辞書エントリのデータ分類を取得します。

var dcm = new SNC.DCManager();
gs.info(dcm.getClassification("445de0a6dba30300efc57416bf9619b0"));

出力：

{
  "445de0a6dba30300efc57416bf9619b0": [
    {
      "parent": {
        "sys_id": "a9670fc773fc1010ae8dd21efaf6a735",
        "name": "Confidential"
      },
      "sys_id": "348107b951d71010f877f3f178e7dd0d",
      "name": "Personally identifiable information"
    }
  ]
}