Dynamic Property System

Dynamic Property System is a system that allows you to add and manage new properties on entity objects at runtime without any code changes. With this system, you can define dynamic propeties on entity objects and perform operations on these objects easily. For example, it can be used for cities, counties, gender, status codes etc.

Check AspNet Boilerplate side of Dynamic Property System

Defining

• Firs of all you need to define input types and entities you want to use with dynamic properties as described here

• Then go to http://localhost:4200/app/admin/dynamic-property

• Add Dynamic Properties that you need

• Assign Dynamic Properties to your entity

• Then you will be able to use dynamic property for the items of your entity.

You can use DynamicEntityPropertyManagerComponent to manager dynamic properties of an entity

*.html

<!--...-->
<li
    *ngIf="
        dynamicEntityPropertyManager.canShow(
            'MyCompanyName.AbpZeroTemplate.Authorization.Users.User'
        )
    "
    role="menuitem"
>
    <a
        href="javascript:;"
        class="dropdown-item"
        (click)="showDynamicProperties(record)"
    >
        {{ 'DynamicProperties' | localize }}
    </a>
</li>
<!--...-->
<dynamic-entity-property-manager #dynamicEntityPropertyManager></dynamic-entity-property-manager>

*.ts

import { DynamicEntityPropertyManagerComponent } from '@app/shared/common/dynamic-entity-property-manager/dynamic-entity-property-manager.component';
@Component({
    templateUrl: './users.component.html',
    encapsulation: ViewEncapsulation.None,
    styleUrls: ['./users.component.less'],
    animations: [appModuleAnimation()],
})
export class UsersComponent extends AppComponentBase implements AfterViewInit {
    @ViewChild('dynamicEntityPropertyManager', { static: true }) dynamicEntityPropertyManager: DynamicEntityPropertyManagerComponent;

    showDynamicProperties(user: UserListDto): void {
        this.dynamicEntityPropertyManager
            .getModal()
            .show('MyCompanyName.AbpZeroTemplate.Authorization.Users.User', user.id.toString());
    }
    //...
}

Mandatory Dynamic Properties

Select Mandatory while adding or editing a dynamic property to require a value for it.

When you manage the dynamic property values of an entity, mandatory properties are marked with * and follow these rules:

• Saving fails when a mandatory value is missing. A warning lists the empty properties and nothing is saved. InsertOrUpdateAllValues applies the same check on the server, so API requests with a missing value are rejected too.

• Values of a mandatory property can't be deleted. The Delete button isn't shown for these properties, and CleanValues rejects the request. You can still replace a value with a new one.

These rules apply only when dynamic property values are saved or deleted. Creating the entity itself doesn't require a value, so a new entity has no value for a mandatory property until one is saved.