Optimizely CMS 12中EPiServerProfile替换方案咨询

一、核心思路 #

EPiServerProfile在.NET Core环境下已被弃用，官方推荐的ASP.NET Core Identity是适配.NET Core生态的用户身份与个性化数据管理方案，核心是将原EPiServerProfile中的用户特定数据迁移到Identity的IdentityUser扩展属性或关联表中，替代原有Profile的读写逻辑。

二、分步实施步骤 #

1. 配置ASP.NET Core Identity与Optimizely集成 #

• 引入必备NuGet包：EPiServer.CMS.UI.Identity、Microsoft.AspNetCore.Identity.EntityFrameworkCore
• 在Program.cs中注册Identity服务，关联Optimizely的数据库上下文：

builder.Services.AddDbContext<ApplicationDbContext>(options =>
    options.UseSqlServer(builder.Configuration.GetConnectionString("EPiServerDB")));

builder.Services.AddDefaultIdentity<ApplicationUser>(options => options.SignIn.RequireConfirmedAccount = false)
    .AddEntityFrameworkStores<ApplicationDbContext>()
    .AddEPiServerIdentityStores();

• 创建自定义ApplicationUser类，扩展IdentityUser以容纳原EPiServerProfile中的用户设置字段：

public class ApplicationUser : IdentityUser
{
    // 对应原EPiServerProfile中的属性，示例：
    public string PreferredLanguage { get; set; }
    public bool ReceiveNewsletter { get; set; }
    // 根据实际业务添加更多字段
}

• 创建ApplicationDbContext继承自EPiServer.ApplicationDbContext：

public class ApplicationDbContext : EPiServer.ApplicationDbContext
{
    public ApplicationDbContext(DbContextOptions options) : base(options)
    {
    }

    protected override void OnModelCreating(ModelBuilder builder)
    {
        base.OnModelCreating(builder);
        // 可按需自定义用户表的字段映射或索引规则
    }
}

2. 数据迁移 #

• 生成并执行EF Core迁移，创建扩展后的用户表：

Add-Migration AddCustomUserFields
Update-Database

• 编写SQL脚本，将原dbo.aspnet_Profile表中的数据映射到新的AspNetUsers表对应字段（需根据实际字段调整）：

UPDATE AspNetUsers
SET PreferredLanguage = p.PropertyValuesXml.value('declare namespace p="http://schemas.microsoft.com/2003/10/Serialization/Arrays"; /p:KeyValueOfstringanyType[p:Key="PreferredLanguage"]/p:Value', 'nvarchar(50)'),
    ReceiveNewsletter = CAST(p.PropertyValuesXml.value('declare namespace p="http://schemas.microsoft.com/2003/10/Serialization/Arrays"; /p:KeyValueOfstringanyType[p:Key="ReceiveNewsletter"]/p:Value', 'nvarchar(10)') AS BIT)
FROM AspNetUsers u
JOIN aspnet_Profile p ON u.Id = p.UserId

3. 替换原有EPiServerProfile调用逻辑 #

• 原代码中EPiServerProfile.GetProfile(username)或HttpContext.Current.Profile的调用，替换为通过UserManager<ApplicationUser>获取用户实例：

// 构造函数注入UserManager
private readonly UserManager<ApplicationUser> _userManager;

public UserSettingsService(UserManager<ApplicationUser> userManager)
{
    _userManager = userManager;
}

// 获取用户设置
public async Task<ApplicationUser> GetUserSettings(string userId)
{
    return await _userManager.FindByIdAsync(userId);
}

// 更新用户设置
public async Task UpdateUserSettings(ApplicationUser user)
{
    var result = await _userManager.UpdateAsync(user);
    if (!result.Succeeded)
    {
        // 处理更新失败的业务逻辑
    }
}

• 视图中的Profile.PreferredLanguage这类调用，替换为通过注入的用户服务或身份信息获取：

<!-- 原EPiServerProfile调用 -->
@Profile.PreferredLanguage

<!-- 新实现方式 -->
@inject UserManager<ApplicationUser> UserManager
@{
    var currentUser = await UserManager.GetUserAsync(User);
}
@currentUser.PreferredLanguage

4. 同步用户登录与认证流程 #

• 确保Optimizely的登录流程与ASP.NET Core Identity完全集成，用户登录后能正确读取到扩展的用户属性。
• 若需兼容原有认证逻辑，可在SignInManager的登录事件中同步用户数据。

三、关键注意事项 #

• 若原EPiServerProfile中存储了复杂对象，建议将对象序列化后存储在ApplicationUser的字符串字段中，或创建单独的关联表进行存储。
• 测试阶段需覆盖用户设置的读取、更新、存储全流程，确保数据一致性。
• 多站点场景下，可在ApplicationUser中添加站点ID字段，实现用户设置按站点隔离。

内容的提问来源于stack exchange，提问作者user29301125