tsai
/
abp
mirror of https://github.com/abpframework/abp.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
Browse Source

Updated part-5 for abp 4.0 blazor UI.

pull/6241/head
Halil İbrahim Kalkan 6 years ago
parent
39dbaf5f6e
commit
3acdef8fb5
1 changed files with 55 additions and 71 deletions
Whitespace
Show all changes Ignore whitespace when comparing lines Ignore changes in amount of whitespace Ignore changes in whitespace at EOL
Unified View
Diff Options
Show Stats Download Patch File Download Diff File
  1. 126
      docs/en/Tutorials/Part-5.md

126
docs/en/Tutorials/Part-5.md
View File

@ -70,7 +70,7 @@ namespace Acme.BookStore.Permissions
} }
```` ````
This is a hierarchical way of defining permission names. For example, "create book" permission name was defined as `BookStore.Books.Create`. This is a hierarchical way of defining permission names. For example, "create book" permission name was defined as `BookStore.Books.Create`. ABP doesn't force you to a structure, but we find this way useful.
### Permission Definitions ### Permission Definitions
@ -476,29 +476,29 @@ Adding this attribute prevents to enter this page if the current hasn't logged i
The book management page has a *New Book* button and *Edit* and *Delete* actions for each book. We should hide these buttons/actions if the current user has not granted for the related permissions. The book management page has a *New Book* button and *Edit* and *Delete* actions for each book. We should hide these buttons/actions if the current user has not granted for the related permissions.
#### Get the Permissions On Initialization The base `AbpCrudPageBase` class already has the necessary functionality for these kind of operations.
#### Set the Policy (Permission) Names
Add the following code block to the end of the `Books.razor` file: Add the following code block to the end of the `Books.razor` file:
````csharp ````csharp
@code @code
{ {
bool canCreateBook; public Books() // Constructor
bool canEditBook;
bool canDeleteBook;
protected async override Task OnInitializedAsync()
{ {
await base.OnInitializedAsync(); CreatePolicyName = BookStorePermissions.Books.Create;
UpdatePolicyName = BookStorePermissions.Books.Edit;
canCreateBook =await AuthorizationService.IsGrantedAsync(BookStorePermissions.Books.Create); DeletePolicyName = BookStorePermissions.Books.Delete;
canEditBook = await AuthorizationService.IsGrantedAsync(BookStorePermissions.Books.Edit);
canDeleteBook = await AuthorizationService.IsGrantedAsync(BookStorePermissions.Books.Delete);
} }
} }
```` ````
We will use these `bool` fields to check the permissions. `AuthorizationService` comes from the base class as an injected property. The base `AbpCrudPageBase` class automatically checks these permissions on the related operations. It also defines the given properties for us if we need to check them manually:
* `HasCreatePermission`: True, if the current user has permission to create the entity.
* `HasUpdatePermission`: True, if the current user has permission to edit/update the entity.
* `HasDeletePermission`: True, if the current user has permission to delete the entity.
> **Blazor Tip**: While adding the C# code into a `@code` block is fine for small code parts, it is suggested to use the code behind approach to develop a more maintainable code base when the code block becomes longer. We will use this approach for the authors part. > **Blazor Tip**: While adding the C# code into a `@code` block is fine for small code parts, it is suggested to use the code behind approach to develop a more maintainable code base when the code block becomes longer. We will use this approach for the authors part.
@ -507,32 +507,31 @@ We will use these `bool` fields to check the permissions. `AuthorizationService`
Wrap the *New Book* button by an `if` block as shown below: Wrap the *New Book* button by an `if` block as shown below:
````xml ````xml
@if (canCreateBook) @if (HasCreatePermission)
{ {
<Button Color="Color.Primary" <Button Color="Color.Primary"
Clicked="OpenCreateModalAsync"> Clicked="OpenCreateModalAsync">@L["NewBook"]</Button>
@L["NewBook"]
</Button>
} }
```` ````
#### Hide the Edit/Delete Actions #### Hide the Edit/Delete Actions
As similar to the *New Book* button, we can use `if` blocks to conditionally show/hide the *Edit* and *Delete* actions: `EntityAction` component defines `RequiredPolicy` attribute (parameter) to conditionally show the action based on the user permissions.
Update the `EntityActions` section as shown below:
````xml ````xml
@if (canEditBook) <EntityActions TItem="BookDto" EntityActionsColumn="@EntityActionsColumn">
{ <EntityAction TItem="BookDto"
<DropdownItem Clicked="() => OpenEditModalAsync(context)"> Text="@L["Edit"]"
@L["Edit"] RequiredPolicy="@UpdatePolicyName"
</DropdownItem> Clicked="() => OpenEditModalAsync(context)" />
} <EntityAction TItem="BookDto"
@if (canDeleteBook) Text="@L["Delete"]"
{ RequiredPolicy="@DeletePolicyName"
<DropdownItem Clicked="() => DeleteEntityAsync(context)"> Clicked="() => DeleteEntityAsync(context)"
@L["Delete"] ConfirmationMessage="()=>GetDeleteConfirmationMessage(context)" />
</DropdownItem> </EntityActions>
}
```` ````
#### About the Permission Caching #### About the Permission Caching
@ -587,54 +586,39 @@ if (await context.IsGrantedAsync(BookStorePermissions.Books.Default))
} }
```` ````
You also need to add `async` keyword to the `ConfigureMenuAsync` method and re-arrange the return values. The final `BookStoreMenuContributor` class should be the following: You also need to add `async` keyword to the `ConfigureMenuAsync` method and re-arrange the return value. The final `ConfigureMainMenuAsync` method should be the following:
````csharp ````csharp
using System.Threading.Tasks; private async Task ConfigureMainMenuAsync(MenuConfigurationContext context)
using Acme.BookStore.Localization;
using Acme.BookStore.Permissions;
using Volo.Abp.UI.Navigation;
namespace Acme.BookStore.Blazor
{ {
public class BookStoreMenuContributor : IMenuContributor var l = context.GetLocalizer<BookStoreResource>();
{
public async Task ConfigureMenuAsync(MenuConfigurationContext context)
{
if(context.Menu.DisplayName != StandardMenus.Main)
{
return;
}
var l = context.GetLocalizer<BookStoreResource>(); context.Menu.Items.Insert(
0,
context.Menu.Items.Insert( new ApplicationMenuItem(
0, "BookStore.Home",
new ApplicationMenuItem( l["Menu:Home"],
"BookStore.Home", "/",
l["Menu:Home"], icon: "fas fa-home"
"/", )
icon: "fas fa-home" );
)
);
var bookStoreMenu = new ApplicationMenuItem( var bookStoreMenu = new ApplicationMenuItem(
"BooksStore", "BooksStore",
l["Menu:BookStore"], l["Menu:BookStore"],
icon: "fa fa-book" icon: "fa fa-book"
); );
context.Menu.AddItem(bookStoreMenu); context.Menu.AddItem(bookStoreMenu);
if (await context.IsGrantedAsync(BookStorePermissions.Books.Default)) //CHECK the PERMISSION
{ if (await context.IsGrantedAsync(BookStorePermissions.Books.Default))
bookStoreMenu.AddItem(new ApplicationMenuItem( {
"BooksStore.Books", bookStoreMenu.AddItem(new ApplicationMenuItem(
l["Menu:Books"], "BooksStore.Books",
url: "/books" l["Menu:Books"],
)); url: "/books"
} ));
}
} }
} }
```` ````

Write Preview
Loading…
Cancel
Save