DS.Foundation.WebApp 8.4.0

DS.Foundation.WebApp

Menú principal para aplicaciones ASP.NET Core MVC/Razor:

• Combina los ítems de uno o más orígenes de datos.

• Los filtra según los roles del usuario: los roles generales y, si se configura, los roles que tiene en la aplicación actual.

• Arma el árbol de menú.

• Lo dibuja con el tag helper <ds-main-menu>, con marcado de Bootstrap 5.

• Target framework: net8.0 (Razor class library).

• Dependencias: DS.Foundation.Authentication 8.4.0 (y por ella DS.Foundation) y el framework compartido de ASP.NET Core.

Instalación

<PackageReference Include="DS.Foundation.WebApp" Version="8.4.0" />

Registro

using DS.Foundation.WebApp.MainMenu;

builder.Services.AddControllersWithViews();
builder.Services
    .AddWebAppMainMenu(options => options.ApplicationCode = "CRM") // IMainMenuProvider (scoped), IHttpContextAccessor y MainMenuOptions
    .AddMenuDataSource<MenuPrincipal>();                           // IMenuDataSource (scoped); puede agregar varios

AddWebAppMainMenu() sin parámetros sigue disponible y filtra solo por roles generales.

En Views/_ViewImports.cshtml:

@addTagHelper *, DS.Foundation.WebApp

Configuración

MainMenuOptions

Ítems del menú (Menu)

Cada ítem se define en código:

Roles que se usan para filtrar

1. Roles generales: UserHelper.Roles, es decir un rol por claim ClaimTypes.Role. También acepta el formato anterior a DS.Foundation.Authentication 8.4.0, con varios roles separados por | en un solo claim.
2. Roles de aplicación: si ApplicationCode tiene valor, los roles de la entrada de ApplicationRoles con ese código (UserHelper.GetApplicationRoles).

AllowedRoles se compara contra la unión de ambos.

Uso

using DS.Foundation.WebApp.MainMenu.Models;
using DS.Foundation.WebApp.MainMenu.Services;

public class MenuPrincipal : MenuDataSourceBase
{
    protected override IList<Menu> BuildMenuItems(string route) => new List<Menu>
    {
        new Menu { ID = "ventas", Content = "Ventas", Order = 1 },
        new Menu { ID = "pedidos", ParentID = "ventas", Content = "Pedidos", Url = "/pedidos", Order = 1,
                   SelectedClass = SelectedClass(route, "/pedidos"),
                   AllowedRoles = new List<string> { "SELLER" } },       // rol en la aplicación CRM
        new Menu { ID = "admin", Content = "Administración", Url = "/admin", Order = 2,
                   AllowedRoles = new List<string> { "admin" } },        // rol general
    };
}

En el layout, dentro de un <ul class="navbar-nav">:

<ds-main-menu></ds-main-menu>

Para un origen asincrónico (base de datos, API), implemente IMenuDataSource directamente; recibe los roles ya combinados en userRoles.

Errores frecuentes

Qué no hacer

• No usar el menú como control de acceso: oculta ítems, pero las rutas deben protegerse con [Authorize].
• No depender de SelectedClass ni de OnClick en la vista incluida: hoy no se dibujan.

Cambios

Ver CHANGELOG.md.