Codeunit 1756 Data Class. Notification Mgt.

Base Application, Microsoft.Utilities

src/Layers/W1/BaseApp/Utilities/DataClassNotificationMgt.Codeunit.al320 lines, Copyright (c) Microsoft Corporation. MIT

// ------------------------------------------------------------------------------------------------// Copyright (c) Microsoft Corporation. All rights reserved.// Licensed under the MIT License. See License.txt in the project root for license information.// ------------------------------------------------------------------------------------------------namespace Microsoft.Utilities;using Microsoft.CRM.Contact;using Microsoft.Foundation.Address;using Microsoft.Foundation.Company;using Microsoft.HumanResources.Employee;using Microsoft.Projects.Resources.Resource;using Microsoft.Purchases.Vendor;using Microsoft.Sales.Customer;using System.Environment.Configuration;using System.Privacy;codeunit 1756 "Data Class. Notification Mgt."{    trigger OnRun()    begin    end;    var        DataClassificationNotificationActionTxt: Label 'Open Data Classification Guide';        DataClassificationNotificationMsg: Label 'It looks like you are either doing business in the EU or you have EU vendors, customers, contacts, resources or employees. Have you classified your data? We can help you do that.', Comment = '%1=Data Subject';        DontShowAgainTok: Label 'Don''t show me again';        SyncFieldsInFieldTableMsg: Label 'Your fields are %1 days old.', Comment = '%1=Number of days';        SyncAllFieldsTxt: Label 'Synchronize all fields';        UnclassifiedFieldsExistMsg: Label 'You have unclassified fields that require your attention.';        OpenWorksheetActionLbl: Label 'Open worksheet';        SyncFieldsReminderNotificationTxt: Label 'Data Classifications sync reminder';        SyncFieldsReminderNotificationDescriptionTxt: Label 'Remind me to find unclassified fields every 30 days';        UnclassifiedFieldsNotificationTxt: Label 'Data Sensitivities are missing';        UnclassifiedFieldsNotificationDescriptionTxt: Label 'Show a warning when there are fields with missing Data Sensitivity';        ReviewPrivacySettingsNotificationTxt: Label 'Review your privacy settings reminder';        ReviewPrivacySettingsNotificationDescriptionTxt: Label 'Show a warning to review your privacy settings when persons from EU are found in your system';        DataClassificationNotificationIdTxt: Label '23593a8e-947b-4b09-8382-36a8aaf89e01';        SyncFieldsNotificationIdTxt: Label '3bce2004-361a-4e7f-9ae6-2df91f29a195';        UnclassifiedFieldsNotificationIdTxt: Label 'fe7fc3ad-2382-4cbd-93f8-79bcd5b538ae';    [Scope('OnPrem')]    procedure FireDataClassificationNotification()    var        MyNotifications: Record "My Notifications";        Notification: Notification;    begin        if not MyNotifications.IsEnabled(DataClassificationNotificationIdTxt) then            exit;        CreateNotification(Notification, DataClassificationNotificationIdTxt, DataClassificationNotificationMsg);        Notification.AddAction(DataClassificationNotificationActionTxt,          CODEUNIT::"Data Class. Notification Mgt.", 'OpenDataClassificationWizard');        Notification.Send();    end;    [Scope('OnPrem')]    procedure FireSyncFieldsNotification(DaysSinceLastSync: Integer)    var        MyNotifications: Record "My Notifications";        Notification: Notification;        NotificationMessage: Text;    begin        if not MyNotifications.IsEnabled(SyncFieldsNotificationIdTxt) then            exit;        NotificationMessage := StrSubstNo(SyncFieldsInFieldTableMsg, DaysSinceLastSync);        CreateNotification(Notification, SyncFieldsNotificationIdTxt, NotificationMessage);        Notification.AddAction(SyncAllFieldsTxt, CODEUNIT::"Data Class. Notification Mgt.", 'SyncAllFieldsFromNotification');        Notification.Send();    end;    [Scope('OnPrem')]    procedure FireUnclassifiedFieldsNotification()    var        MyNotifications: Record "My Notifications";        Notification: Notification;    begin        if not MyNotifications.IsEnabled(UnclassifiedFieldsNotificationIdTxt) then            exit;        CreateNotification(Notification, UnclassifiedFieldsNotificationIdTxt, UnclassifiedFieldsExistMsg);        Notification.AddAction(OpenWorksheetActionLbl, CODEUNIT::"Data Class. Notification Mgt.", 'OpenClassificationWorksheetPage');        Notification.Send();    end;    local procedure CreateNotification(var Notification: Notification; Id: Text; Message: Text)    begin        Notification.Id := Id;        Notification.Message(Message);        Notification.AddAction(DontShowAgainTok, CODEUNIT::"Data Class. Notification Mgt.", 'DisableNotifications');    end;    procedure ShowNotifications()    var        DataSensitivity: Record "Data Sensitivity";        CountryRegion: Record "Country/Region";        CompanyInformation: Record "Company Information";        CompanyInformationMgt: Codeunit "Company Information Mgt.";        DataClassificationMgt: Codeunit "Data Classification Mgt.";        RecRef: RecordRef;        EURegionFilter: Text;    begin        if not DataSensitivity.WritePermission then            exit;        if CompanyInformation.Get() then;        if CompanyInformation."Demo Company" then            exit;        DataSensitivity.SetRange("Company Name", CompanyName);        if not DataSensitivity.IsEmpty() then            FireNotificationForNonEmptyDataSensitivityTable(DataSensitivity)        else            if CompanyInformationMgt.IsEUCompany(CompanyInformation) and DataClassificationMgt.DataPrivacyEntitiesExist() then                FireDataClassificationNotification()            else begin                CountryRegion.SetFilter("EU Country/Region Code", '<>%1', '');                RecRef.GetTable(CountryRegion);                EURegionFilter := GetFilterTextForFieldValuesInTable(RecRef, CountryRegion.FieldNo(Code));                if EURegionFilter = '' then                    exit;                if CompanyHasVendorsInRegion(EURegionFilter) or CompanyHasCustomersInRegion(EURegionFilter) or                   CompanyHasContactsInRegion(EURegionFilter) or CompanyHasResourcesInRegion(EURegionFilter) or                   CompanyHasEmployeesInRegion(EURegionFilter)                then                    FireDataClassificationNotification();            end;    end;    local procedure FireNotificationForNonEmptyDataSensitivityTable(DataSensitivity: Record "Data Sensitivity")    begin        DataSensitivity.SetRange("Data Sensitivity", DataSensitivity."Data Sensitivity"::Unclassified);        if DataSensitivity.FindFirst() then            FireUnclassifiedFieldsNotification()        else            ShowSyncFieldsNotificationIfThereAreUnsynchedFields();    end;    local procedure CompanyHasVendorsInRegion(RegionFilter: Text): Boolean    var        Vendor: Record Vendor;    begin        Vendor.SetRange("Partner Type", Vendor."Partner Type"::Person);        Vendor.SetFilter("Country/Region Code", RegionFilter);        if Vendor.FindFirst() then            exit(true);        exit(false);    end;    local procedure CompanyHasCustomersInRegion(RegionFilter: Text): Boolean    var        Customer: Record Customer;    begin        Customer.SetRange("Partner Type", Customer."Partner Type"::Person);        Customer.SetFilter("Country/Region Code", RegionFilter);        exit(not Customer.IsEmpty());    end;    local procedure CompanyHasContactsInRegion(RegionFilter: Text): Boolean    var        Contact: Record Contact;    begin        Contact.SetRange(Type, Contact.Type::Person);        Contact.SetFilter("Country/Region Code", RegionFilter);        if Contact.FindFirst() then            exit(true);        exit(false);    end;    local procedure CompanyHasResourcesInRegion(RegionFilter: Text): Boolean    var        Resource: Record Resource;    begin        Resource.SetRange(Type, Resource.Type::Person);        Resource.SetFilter("Country/Region Code", RegionFilter);        if Resource.FindFirst() then            exit(true);        exit(false);    end;    local procedure CompanyHasEmployeesInRegion(RegionFilter: Text): Boolean    var        Employee: Record Employee;    begin        Employee.SetFilter("Country/Region Code", RegionFilter);        if Employee.FindFirst() then            exit(true);        exit(false);    end;    [Scope('OnPrem')]    procedure DisableNotifications(Notification: Notification)    var        MyNotifications: Record "My Notifications";    begin        case Notification.Id of            GetDataClassificationNotificationId():                MyNotifications.InsertDefault(Notification.Id, ReviewPrivacySettingsNotificationTxt,                  ReviewPrivacySettingsNotificationDescriptionTxt, false);            GetSyncFieldsNotificationId():                MyNotifications.InsertDefault(Notification.Id, SyncFieldsReminderNotificationTxt,                  SyncFieldsReminderNotificationDescriptionTxt, false);            GetUnclassifiedFieldsNotificationId():                MyNotifications.InsertDefault(Notification.Id, UnclassifiedFieldsNotificationTxt,                  UnclassifiedFieldsNotificationDescriptionTxt, false);        end;        MyNotifications.Disable(Notification.Id);    end;    procedure ShowSyncFieldsNotificationIfThereAreUnsynchedFields()    var        CompanyInformation: Record "Company Information";        DataClassificationMgt: Codeunit "Data Classification Mgt.";        DaysSinceLastSync: Integer;        LastStatusSyncDateTime: DateTime;    begin        if CompanyInformation.Get() then;        if CompanyInformation."Demo Company" then            exit;        LastStatusSyncDateTime := DataClassificationMgt.GetLastSyncStatusDate();        if LastStatusSyncDateTime <> 0DT then begin            DaysSinceLastSync := Round((CurrentDateTime - LastStatusSyncDateTime) / 1000 / 3600 / 24, 1);            if DaysSinceLastSync > 30 then                FireSyncFieldsNotification(DaysSinceLastSync);        end;    end;    [Scope('OnPrem')]    procedure GetFilterTextForFieldValuesInTable(var RecRef: RecordRef; FieldNo: Integer): Text    var        FilterText: Text;    begin        if RecRef.FindSet() then begin            repeat                FilterText := StrSubstNo('%1|%2', FilterText, RecRef.Field(FieldNo));            until RecRef.Next() = 0;            // remove the first vertical bar from the filter text            FilterText := DelChr(FilterText, '<', '|');        end;        exit(FilterText);    end;    [Scope('OnPrem')]    procedure OpenDataClassificationWizard(Notification: Notification)    begin        PAGE.Run(PAGE::"Data Classification Wizard");    end;    [Scope('OnPrem')]    procedure OpenClassificationWorksheetPage(Notification: Notification)    var        DataSensitivity: Record "Data Sensitivity";    begin        DataSensitivity.SetRange("Company Name", CompanyName);        DataSensitivity.SetRange("Data Sensitivity", DataSensitivity."Data Sensitivity"::Unclassified);        PAGE.Run(PAGE::"Data Classification Worksheet", DataSensitivity);    end;    [Scope('OnPrem')]    procedure GetDataClassificationNotificationId(): Guid    begin        exit(DataClassificationNotificationIdTxt);    end;    [Scope('OnPrem')]    procedure GetSyncFieldsNotificationId(): Guid    begin        exit(SyncFieldsNotificationIdTxt);    end;    [Scope('OnPrem')]    procedure GetUnclassifiedFieldsNotificationId(): Guid    begin        exit(UnclassifiedFieldsNotificationIdTxt);    end;    [Scope('OnPrem')]    procedure SyncAllFieldsFromNotification(Notification: Notification)    var        DataClassificationMgt: Codeunit "Data Classification Mgt.";    begin        DataClassificationMgt.SyncAllFields();        ShowNotificationIfThereAreUnclassifiedFields();    end;    [Scope('OnPrem')]    procedure ShowNotificationIfThereAreUnclassifiedFields()    var        CompanyInformation: Record "Company Information";        DataClassificationMgt: Codeunit "Data Classification Mgt.";    begin        if DataClassificationMgt.AreAllFieldsClassified() then            exit;        if CompanyInformation.Get() then;        if CompanyInformation."Demo Company" then            exit;        FireUnclassifiedFieldsNotification();    end;    [EventSubscriber(ObjectType::Codeunit, Codeunit::"Data Classification Mgt.", 'OnShowSyncFieldsNotification', '', false, false)]    local procedure OnShowSyncFieldsNotificationSubscriber()    begin        ShowSyncFieldsNotificationIfThereAreUnsynchedFields();    end;}