@memberjunction/ng-entity-permissions

Angular components for displaying and editing entity-level CRUD permissions in MemberJunction. Provides a grid-based interface for managing Read, Create, Update, and Delete permissions per role or per entity.

Overview

This package provides two main components for permission management: EntityPermissionsGridComponent displays a grid of permission checkboxes (filterable by entity or role), and EntitySelectorWithGridComponent combines an entity dropdown with the permissions grid for a complete permission management interface.

graph TD
    ESWG["EntitySelectorWithGridComponent"] --> DD["Entity Dropdown\n(Kendo DropDown)"]
    ESWG --> EPG["EntityPermissionsGridComponent"]
    EPG --> KG["Kendo Grid"]
    EPG --> EP["EntityPermissionEntity[]"]

    style ESWG fill:#7c5295,stroke:#563a6b,color:#fff
    style DD fill:#2d8659,stroke:#1a5c3a,color:#fff
    style EPG fill:#2d6a9f,stroke:#1a4971,color:#fff
    style KG fill:#2d8659,stroke:#1a5c3a,color:#fff
    style EP fill:#b8762f,stroke:#8a5722,color:#fff

Features

• Dual mode: View permissions by Entity (all roles for an entity) or by Role (all entities for a role)
• Interactive grid: Toggle CRUD permissions with checkboxes
• Permission change events: Emits EntityPermissionChangedEvent with cancel support
• Entity selector: Combined dropdown + grid for complete permission management
• Auto-refresh: Automatically reloads when entity or role changes

Installation

npm install @memberjunction/ng-entity-permissions

Key Dependencies

Dependency	Purpose
@memberjunction/core	Metadata, RunView
@memberjunction/core-entities	EntityPermissionEntity
@progress/kendo-angular-grid	Permissions grid
@progress/kendo-angular-dropdowns	Entity/role selector

Usage

Entity Mode (All Roles for an Entity)

<mj-entity-permissions-grid
  [Mode]="'Entity'"
  [EntityName]="'Contacts'"
  (PermissionChanged)="onPermissionChanged($event)">
</mj-entity-permissions-grid>

Role Mode (All Entities for a Role)

<mj-entity-permissions-grid
  [Mode]="'Role'"
  [RoleName]="'Admin'"
  (PermissionChanged)="onPermissionChanged($event)">
</mj-entity-permissions-grid>

Combined Selector + Grid

<mj-entity-selector-with-grid
  (PermissionChanged)="onPermissionChanged($event)">
</mj-entity-selector-with-grid>

Permission Change Event

onPermissionChanged(event: EntityPermissionChangedEvent) {
  // event.EntityName, event.RoleID
  // event.PermissionTypeChanged: 'Read' | 'Create' | 'Update' | 'Delete'
  // event.Value: boolean
  // Set event.Cancel = true to prevent the change
}

Exported API

Export	Type	Description
EntityPermissionsGridComponent	Component	CRUD permissions grid
EntitySelectorWithGridComponent	Component	Entity dropdown + permissions grid
EntityPermissionChangedEvent	Type	Permission change event shape
EntityPermissionsModule	NgModule	Module declaration

Build

cd packages/Angular/Explorer/entity-permissions && npm run build

License

ISC