andy
9f22b522df
Move Saxonite’s projects into a dedicated `Workspace` folder and align the solution with .NET 10 and the current Common workspace. Update encryption integration, test project structure and coverage, and repository guidance and upgrade notes. - Relocate application and library projects while retaining Git rename history. - Split tests into Admin, Online, and Shared projects; add representative behavioral and serialization tests. - Update Common integration, application version, and repository documentation. Application version: 1.3.0 Reviewed-on: #1 Co-authored-by: andy <andy@sarand.com>
315 lines
13 KiB
C#
315 lines
13 KiB
C#
using Sarand.Net.Standard.Base.App;
|
|
using Sarand.Net.Standard.Base.Bus;
|
|
using Sarand.Net.Standard.Base.Core;
|
|
using Sarand.Net.Standard.Base.Dbas;
|
|
using Sarand.Net.Standard.Base.Helpers;
|
|
using Sarand.Net.Standard.Base.Utils;
|
|
using Saxonite.Base.App;
|
|
using Saxonite.Net.Standard.Base.Bus;
|
|
using System;
|
|
using System.Collections.Generic;
|
|
using System.Globalization;
|
|
using System.Linq;
|
|
using System.Text;
|
|
|
|
namespace Saxonite.Net.Standard.Base.Mgr
|
|
{
|
|
//=======================================================================
|
|
partial class SaxAccountMgr
|
|
{
|
|
//*******************************************************************
|
|
// Account Mgr - User Account
|
|
//*******************************************************************
|
|
// Utilities.
|
|
|
|
//-------------------------------------------------------------------
|
|
// Create item.
|
|
public abstract SaxUserAccount CreateUserAccount();
|
|
|
|
//-------------------------------------------------------------------
|
|
// Item exists.
|
|
public bool UserAccountExistsById(SysId id)
|
|
{
|
|
ClearErrorState();
|
|
if (!SysId.IsValid(id)) return false;
|
|
SaxUserAccount.Params prmUserAccount = new SaxUserAccount.Params();
|
|
prmUserAccount.IdsIncluded.Add(id);
|
|
prmUserAccount.StatusCat = SaxUserAccount.StatusCat.Any;
|
|
return GetUserAccountCount(prmUserAccount) == 1;
|
|
}
|
|
public bool UserAccountExistsByEmailAddress(string emailAddress)
|
|
{
|
|
ClearErrorState();
|
|
if (StringUtil.IsEmpty(emailAddress)) return false;
|
|
SaxUserAccount.Params prmUserAccount = new SaxUserAccount.Params();
|
|
prmUserAccount.EmailAddress = emailAddress;
|
|
prmUserAccount.StatusCat = SaxUserAccount.StatusCat.Any;
|
|
return GetUserAccountCount(prmUserAccount) == 1;
|
|
}
|
|
|
|
//-------------------------------------------------------------------
|
|
// Retrieve individual items.
|
|
public abstract SaxUserAccount GetUserAccount(SaxUserAccount.Params prmUserAccount);
|
|
public SaxUserAccount GetUserAccountById(SysId id)
|
|
{
|
|
ClearErrorState();
|
|
if (!SysId.IsValid(id)) return null;
|
|
SaxUserAccount.Params prmUserAccount = new SaxUserAccount.Params();
|
|
prmUserAccount.IdsIncluded.Add(id);
|
|
prmUserAccount.StatusCat = SaxUserAccount.StatusCat.Any;
|
|
return GetUserAccount(prmUserAccount);
|
|
}
|
|
public SaxUserAccount GetUserAccountByEmailAddress(string emailAddress)
|
|
{
|
|
ClearErrorState();
|
|
if (StringUtil.IsEmpty(emailAddress)) return null;
|
|
SaxUserAccount.Params prmUserAccount = new SaxUserAccount.Params();
|
|
prmUserAccount.EmailAddress = emailAddress;
|
|
prmUserAccount.StatusCat = SaxUserAccount.StatusCat.Any;
|
|
return GetUserAccount(prmUserAccount);
|
|
}
|
|
|
|
//-------------------------------------------------------------------
|
|
// Validate item data.
|
|
public bool IsValidUserAccount(SaxUserAccount userAccount)
|
|
{
|
|
ClearErrorState();
|
|
if (userAccount == null) return SetErrorState(ErrorMessage.ItemNotSpecified);
|
|
return IsValidUserAccountData(userAccount.GetData(), new SaxUserAccount.ErrField());
|
|
}
|
|
public virtual bool IsValidUserAccountData(SaxUserAccount.Data data, SaxUserAccount.ErrField errField)
|
|
{
|
|
ClearErrorState();
|
|
|
|
// Email address.
|
|
if (errField.EmailAddress != SacsHierarchyItem.ValidValue.Ignore)
|
|
{
|
|
if (!IsValidValue(data.EmailAddress, "email", (long)SaxDbDfn_Core.GetColTextLen(SaxDbDfn_Core.ColumnIdx.UserAccount_EmailAddress), true))
|
|
{
|
|
errField.EmailAddress = SacsHierarchyItem.ValidValue.Invalid;
|
|
return false;
|
|
}
|
|
if (!SacsDataValidationHelper.IsValidEmailAddress(data.EmailAddress))
|
|
{
|
|
errField.EmailAddress = SacsHierarchyItem.ValidValue.Invalid;
|
|
return SetErrorState("Invalid email address");
|
|
}
|
|
}
|
|
// Title.
|
|
if (errField.Title != SacsHierarchyItem.ValidValue.Ignore && !IsValidValue(data.Title, "Title", (long)SaxDbDfn_Core.GetColTextLen(SaxDbDfn_Core.ColumnIdx.UserAccount_Title)))
|
|
{
|
|
errField.Title = SacsHierarchyItem.ValidValue.Invalid;
|
|
return false;
|
|
}
|
|
// First name.
|
|
if (errField.FirstName != SacsHierarchyItem.ValidValue.Ignore && !IsValidValue(data.FirstName, "first name", (long)SaxDbDfn_Core.GetColTextLen(SaxDbDfn_Core.ColumnIdx.UserAccount_FirstName)))
|
|
{
|
|
errField.FirstName = SacsHierarchyItem.ValidValue.Invalid;
|
|
return false;
|
|
}
|
|
// Initials.
|
|
if (errField.Initials != SacsHierarchyItem.ValidValue.Ignore && !IsValidValue(data.Initials, "initials", (long)SaxDbDfn_Core.GetColTextLen(SaxDbDfn_Core.ColumnIdx.UserAccount_Initials)))
|
|
{
|
|
errField.Initials = SacsHierarchyItem.ValidValue.Invalid;
|
|
return false;
|
|
}
|
|
// Last name.
|
|
if (errField.LastName != SacsHierarchyItem.ValidValue.Ignore && !IsValidValue(data.LastName, "last name", (long)SaxDbDfn_Core.GetColTextLen(SaxDbDfn_Core.ColumnIdx.UserAccount_LastName), true))
|
|
{
|
|
errField.LastName = SacsHierarchyItem.ValidValue.Invalid;
|
|
return false;
|
|
}
|
|
// About.
|
|
if (errField.About != SacsHierarchyItem.ValidValue.Ignore && !IsValidValue(data.About, "about", (long)SaxDbDfn_Core.GetColTextLen(SaxDbDfn_Core.ColumnIdx.UserAccount_About)))
|
|
{
|
|
errField.About = SacsHierarchyItem.ValidValue.Invalid;
|
|
return false;
|
|
}
|
|
// Phone - main.
|
|
if (errField.PhoneMain != SacsHierarchyItem.ValidValue.Ignore && !IsValidValue(data.PhoneMain, "phone", (long)SaxDbDfn_Core.GetColTextLen(SaxDbDfn_Core.ColumnIdx.UserAccount_PhoneMain)))
|
|
{
|
|
errField.PhoneMain = SacsHierarchyItem.ValidValue.Invalid;
|
|
return false;
|
|
}
|
|
// Phone - mobile.
|
|
if (errField.PhoneMobile != SacsHierarchyItem.ValidValue.Ignore && !IsValidValue(data.PhoneMobile, "mobile", (long)SaxDbDfn_Core.GetColTextLen(SaxDbDfn_Core.ColumnIdx.UserAccount_PhoneMobile)))
|
|
{
|
|
errField.PhoneMobile = SacsHierarchyItem.ValidValue.Invalid;
|
|
return false;
|
|
}
|
|
// Gender other.
|
|
if (errField.GenderOther != SacsHierarchyItem.ValidValue.Ignore && !IsValidValue(data.GenderOther, "gender", (long)SaxDbDfn_Core.GetColTextLen(SaxDbDfn_Core.ColumnIdx.UserAccount_GenderOther)))
|
|
{
|
|
errField.GenderOther = SacsHierarchyItem.ValidValue.Invalid;
|
|
return false;
|
|
}
|
|
// Date of birth year.
|
|
if (errField.DateOfBirthYear != SacsHierarchyItem.ValidValue.Ignore && data.DateOfBirthYear > DateTime.Today.Year)
|
|
{
|
|
errField.PhoneMobile = SacsHierarchyItem.ValidValue.Invalid;
|
|
return SetErrorState("Date of birth year must not be in the future");
|
|
}
|
|
|
|
//---------------------------------------------------------------
|
|
// Regions.
|
|
if (errField.RegionIdCountry != SacsHierarchyItem.ValidValue.Ignore)
|
|
{
|
|
}
|
|
if (errField.RegionIdProvince != SacsHierarchyItem.ValidValue.Ignore)
|
|
{
|
|
}
|
|
|
|
//---------------------------------------------------------------
|
|
// Security.
|
|
// Password token.
|
|
if (errField.PasswordToken != SacsHierarchyItem.ValidValue.Ignore && !IsValidValue(data.PasswordToken, "password token", (long)SaxDbDfn_Core.GetColTextLen(SaxDbDfn_Core.ColumnIdx.UserAccount_PasswordToken)))
|
|
{
|
|
errField.PasswordToken = SacsHierarchyItem.ValidValue.Invalid;
|
|
return false;
|
|
}
|
|
|
|
//---------------------------------------------------------------
|
|
// Common properties.
|
|
if (errField.Notes != SacsHierarchyItem.ValidValue.Ignore && !IsValidValue(data.Notes, "notes", (long)SaxDbDfn_Core.GetColTextLen(SaxDbDfn_Core.ColumnIdx.UserAccount_Notes)))
|
|
{
|
|
errField.Notes = SacsHierarchyItem.ValidValue.Invalid;
|
|
return false;
|
|
}
|
|
if (errField.Status != SacsHierarchyItem.ValidValue.Ignore)
|
|
{
|
|
if (!IsValidValue(data.StatusCode, "status", (long)SaxDbDfn_Core.GetColTextLen(SaxDbDfn_Core.ColumnIdx.UserAccount_Status), true, true))
|
|
{
|
|
errField.Status = SacsHierarchyItem.ValidValue.Invalid;
|
|
return false;
|
|
}
|
|
if (!SaxUserAccount.ValidStatuses.Contains(data.Status))
|
|
{
|
|
errField.Status = SacsHierarchyItem.ValidValue.Invalid;
|
|
return SetErrorState(ErrorMessage.InvalidStatus);
|
|
}
|
|
}
|
|
|
|
// Email Address must be unique.
|
|
if (errField.EmailAddress != SacsHierarchyItem.ValidValue.Ignore)
|
|
{
|
|
SaxUserAccount.Params prmUserAccount = new SaxUserAccount.Params();
|
|
if (SysId.IsValid(data.Id))
|
|
prmUserAccount.IdsExcluded.Add(data.Id);
|
|
prmUserAccount.EmailAddress = data.EmailAddress;
|
|
prmUserAccount.StatusCat = SaxUserAccount.StatusCat.Any;
|
|
if (GetUserAccountCount(prmUserAccount) > 0)
|
|
{
|
|
errField.EmailAddress = SacsHierarchyItem.ValidValue.Invalid;
|
|
return SetErrorState("Email must unique");
|
|
}
|
|
}
|
|
|
|
//---------------------------------------------------------------
|
|
// Associated data - ignore for deleted items.
|
|
if (!data.IsStatusDeleted)
|
|
{
|
|
// Regions.
|
|
if (errField.RegionIdCountry != SacsHierarchyItem.ValidValue.Ignore || errField.RegionIdProvince != SacsHierarchyItem.ValidValue.Ignore)
|
|
{
|
|
List<SaxRegion.Data> regions = Internals.GetRegions(new List<SysId>() { data.RegionIdCountry, data.RegionIdProvince });
|
|
SaxRegion.Data regionCountry = regions.Find(item => item.Id.Equals(data.RegionIdCountry));
|
|
SaxRegion.Data regionProvince = regions.Find(item => item.Id.Equals(data.RegionIdProvince));
|
|
if (errField.RegionIdCountry != SacsHierarchyItem.ValidValue.Ignore)
|
|
{
|
|
if (SysId.IsValid(data.RegionIdCountry) && regionCountry == null)
|
|
return SetErrorState("Invalid country specified");
|
|
}
|
|
if (errField.RegionIdCountry != SacsHierarchyItem.ValidValue.Ignore)
|
|
{
|
|
if (SysId.IsValid(data.RegionIdCountry) && regionCountry == null)
|
|
return SetErrorState("Invalid country specified");
|
|
}
|
|
}
|
|
}
|
|
|
|
//---------------------------------------------------------------
|
|
return true;
|
|
}
|
|
|
|
//-------------------------------------------------------------------
|
|
// Item database interface.
|
|
public abstract bool InsertUserAccount(SaxUserAccount userAccount, DbUpdateInfo dbUpdateInfo);
|
|
public abstract bool UpdateUserAccount(SaxUserAccount userAccount, DbUpdateInfo dbUpdateInfo);
|
|
public virtual bool UserAccountCanBeDeleted(SaxUserAccount userAccount)
|
|
{
|
|
ClearErrorState();
|
|
return true;
|
|
}
|
|
public abstract bool DeleteUserAccount(SaxUserAccount userAccount, DbUpdateInfo dbUpdateInfo);
|
|
|
|
//-------------------------------------------------------------------
|
|
// Item list.
|
|
public abstract ColumnDfn GetUserAccountColumnDfn(SaxUserAccount.Column columnId, String caption = "", int width = 0);
|
|
public abstract List<String> GetUserAccountQueryFilter(SaxUserAccount.Params prmUserAccount);
|
|
public abstract long GetUserAccountCount(SaxUserAccount.Params prmUserAccount);
|
|
public abstract List<SaxUserAccount> GetUserAccountList(SaxUserAccount.Params prmUserAccount);
|
|
public abstract DbResultSet ExecuteUserAccountQuery(List<ColumnDfn> columns, SaxUserAccount.Params prmUserAccount);
|
|
|
|
//-------------------------------------------------------------------
|
|
/// <summary>
|
|
/// Extract and format result set data value where specific handling is required.
|
|
/// <para>Where response is an invalid data value, format value using column.FormatValue(values).</para>
|
|
/// </summary>
|
|
public virtual DataValue GetUserAccountDataValue(ColumnDfn column, NamedValue.Map values, CultureInfo cultureInfo = null)
|
|
{
|
|
DataValue value = new DataValue();
|
|
switch ((SaxUserAccount.Column)column.Id)
|
|
{
|
|
//-----------------------------------------------------------
|
|
case SaxUserAccount.Column.DateOfBirth:
|
|
{
|
|
byte dobDay = (byte)values.GetValue(GetUserAccountColumnDfn(SaxUserAccount.Column.DateOfBirthDay).DataName).AsLong();
|
|
byte dobMonth = (byte)values.GetValue(GetUserAccountColumnDfn(SaxUserAccount.Column.DateOfBirthMonth).DataName).AsLong();
|
|
short dobYear = (short)values.GetValue(GetUserAccountColumnDfn(SaxUserAccount.Column.DateOfBirthYear).DataName).AsLong();
|
|
List<String> dobParts = new List<string>();
|
|
if (dobYear > 0)
|
|
{
|
|
if (dobMonth > 0)
|
|
{
|
|
if (dobDay > 0)
|
|
dobParts.Add(dobDay.ToString());
|
|
// Format date with month to extract name.
|
|
DateTime monthDate = new DateTime(DateTime.Today.Year, dobMonth, 1);
|
|
dobParts.Add(DateUtil.Format(monthDate, "MMM", cultureInfo));
|
|
}
|
|
dobParts.Add(dobYear.ToString());
|
|
}
|
|
value = new DataValue(dobParts.Concat("-"));
|
|
}
|
|
break;
|
|
|
|
//-----------------------------------------------------------
|
|
// Notes.
|
|
case SaxUserAccount.Column.Notes:
|
|
value = new DataValue(SacsHierarchyItem.FormatForDisplay(values.GetValue(column.DataName).ToString(), 200));
|
|
break;
|
|
|
|
//-----------------------------------------------------------
|
|
// Status.
|
|
case SaxUserAccount.Column.Status_Desc:
|
|
case SaxUserAccount.Column.Status_Ind:
|
|
{
|
|
String statusCode = values.GetValue(column.DataName).ToString();
|
|
SaStatus status = SacsSystem.GetStatusForCode(statusCode);
|
|
if (column.Id == (int)SaxUserAccount.Column.Status_Desc)
|
|
value = new DataValue(SacsSystem.GetStatusDesc(status));
|
|
else if (column.Id == (int)SaxUserAccount.Column.Status_Ind)
|
|
value = new DataValue(SaxUserAccount.GetStatusTriState(status));
|
|
}
|
|
break;
|
|
|
|
//-----------------------------------------------------------
|
|
}
|
|
return value;
|
|
}
|
|
|
|
//-------------------------------------------------------------------
|
|
}
|
|
//=======================================================================
|
|
}
|