DCManager - グローバル

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

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

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

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

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

DCManager - classify(文字列 dictEntries, 文字列 dataClasses)

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

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

表 : 1. パラメーター

名前	タイプ	説明
dictEntries	文字列	分類するレコードの sys_id。sys_id はディクショナリ [sys_dictionary] テーブルからのものです。文字列で囲まれたカンマ区切りリストとして入力します。
dataClasses	文字列	割り当てるデータ分類の sys_id。sys_id は、データ分類 [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. パラメーター

名前	タイプ	説明
dictEntries	文字列	分類を削除するレコードの sys_id。sys_id はディクショナリ [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. 返される内容

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

名前	タイプ	説明
dictEntries	文字列	分類を取得するレコードの sys_id。sys_id はディクショナリ [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"
    }
  ]
}