Browse Source

Update suite tutorial updates (done)

pull/21887/head
EngincanV 2 years ago
parent
commit
f83400bf42
  1. BIN
      docs/en/tutorials/book-store-with-abp-suite/images/suite-custom-code-result.png
  2. 14
      docs/en/tutorials/book-store-with-abp-suite/part-02.md
  3. 14
      docs/en/tutorials/book-store-with-abp-suite/part-03.md
  4. 26
      docs/en/tutorials/book-store-with-abp-suite/part-04.md
  5. 9
      docs/en/tutorials/book-store-with-abp-suite/part-05.md

BIN
docs/en/tutorials/book-store-with-abp-suite/images/suite-custom-code-result.png

Binary file not shown.

Before

Width:  |  Height:  |  Size: 86 KiB

After

Width:  |  Height:  |  Size: 110 KiB

14
docs/en/tutorials/book-store-with-abp-suite/part-02.md

@ -110,14 +110,22 @@ ABP Suite will generate the necessary code for you. It generates:
It will take some time to complete the process. After the process is completed, you will see a success message, you can click the *Ok* button, and then run the application by clicking the *Start* button (or alternatively, directly clicking the *run* icon) in the *Solution Runner* panel:
{{ if UI === "MVC"}}
{{ if UI == "MVC" }}
![](./images/book-store-studio-run-app-mvc.png)
{{ else if UI === "Angular" }}
{{ else if UI == "Angular" }}
![](./images/book-store-studio-run-app-angular.png)
{{ else if UI === "MAUIBlazor" "}}
{{ else if UI == "MAUIBlazor" }}
![](./images/book-store-studio-run-app-mauiblazor.png)
{{ else }}
![](./images/book-store-studio-run-app-blazor.png)
{{ end }}
After the application is started, you can right-click and *Browse* on the application to open it in the ABP Studio's pre-integrated browser. You can see the Books page in the following figure with a single record:

14
docs/en/tutorials/book-store-with-abp-suite/part-03.md

@ -64,14 +64,22 @@ You can click the **Save and Generate** button to start the code generation proc
ABP Suite will generate the necessary code for you. It will take some time to complete the process. After the process is completed, you will see a success message, you can click the *Ok* button, and then run the application by clicking the *Start* button (or alternatively, directly clicking the *run* icon) in the *Solution Runner* panel:
{{ if UI === "MVC"}}
{{ if UI == "MVC" }}
![](./images/book-store-studio-run-app-mvc.png)
{{ else if UI === "Angular" }}
{{ else if UI == "Angular" }}
![](./images/book-store-studio-run-app-angular.png)
{{ else if UI === "MAUIBlazor" "}}
{{ else if UI == "MAUIBlazor" }}
![](./images/book-store-studio-run-app-mauiblazor.png)
{{ else }}
![](./images/book-store-studio-run-app-blazor.png)
{{ end }}
After the application is started, you can right-click and *Browse* on the application to open it in the ABP Studio's pre-integrated browser and try to add a new author:

26
docs/en/tutorials/book-store-with-abp-suite/part-04.md

@ -59,14 +59,22 @@ After, specifying the metadata, you can click the *Ok* button to close the modal
It will take some time to complete the process. After the process is completed, you will see a success message, you can click the *Ok* button, and then run the application by clicking the *Start* button (or alternatively, directly clicking the *run* icon) in the *Solution Runner* panel:
{{ if UI === "MVC"}}
{{ if UI == "MVC" }}
![](./images/book-store-studio-run-app-mvc.png)
{{ else if UI === "Angular" }}
{{ else if UI == "Angular" }}
![](./images/book-store-studio-run-app-angular.png)
{{ else if UI === "MAUIBlazor" "}}
{{ else if UI == "MAUIBlazor" }}
![](./images/book-store-studio-run-app-mauiblazor.png)
{{ else }}
![](./images/book-store-studio-run-app-blazor.png)
{{ end }}
After the application is started, you can right-click and *Browse* on the application to open it in the ABP Studio's pre-integrated browser. You can first create an author and then create a book with the author for testing:
@ -83,11 +91,11 @@ Since you completed the bookstore application, now we can check the generated te
There are several test projects in the solution (slightly differs based on your _UI_ and _Database_ selection):
{{ if DB === "EF" }}
{{ if DB == "EF" }}
![](./images/abp-suite-solution-test-projects-ef-core.png)
{{ else if DB === "Mongo" }}
{{ else if DB == "Mongo" }}
![](./images/abp-suite-solution-test-projects-mongo.png)
@ -95,11 +103,11 @@ There are several test projects in the solution (slightly differs based on your
ABP Suite generated unit & integration tests, for the `Book` & `Author` entities. If you open the **Test explorer** in your IDE, you will see the following tests are generated:
{{ if DB === "EF" }}
{{ if DB == "EF" }}
![](./images/abp-suite-generated-tests-ef-core.png)
{{ else if DB === "Mongo" }}
{{ else if DB == "Mongo" }}
![](./images/abp-suite-generated-tests-mongo.png)
@ -185,11 +193,11 @@ Since ABP Suite generated the test data seed contributors for each entity, you h
Let's execute all tests, and see the results:
{{ if DB === "EF" }}
{{ if DB == "EF" }}
![](./images/bookstore-test-succeed-ef-core.png)
{{ else if DB === "Mongo" }}
{{ else if DB == "Mongo" }}
![](./images/bookstore-test-succeed-mongo.png)

9
docs/en/tutorials/book-store-with-abp-suite/part-05.md

@ -36,10 +36,11 @@ On the C# side, ABP Suite adds abstract base classes for entities, application s
You can write your custom code in those classes (with the `*.Extended.cs` extension) and next time when you need to re-generate the entity, your custom code will not be overridden (only the base abstract classes will be re-generated and your changes on Suite will be respected):
{{ if DB === "EF" }}
{{ if DB == "EF" }}
![](./images/suite-repository-custom-code-ef-core.png)
{{ else if DB === "Mongo" }}
{{ else if DB == "Mongo" }}
![](./images/suite-repository-custom-code-mongo.png)
@ -49,7 +50,7 @@ You can write your custom code in those classes (with the `*.Extended.cs` extens
On the UI side, ABP Suite provides convenient comment placeholders within pages for MVC, Blazor, and Angular UIs. These comment sections serve as hook points where you can add your custom code.
{{ if UI === "MVC"}}
{{ if UI == "MVC"}}
For example, if you open the *Books/Index.cshtml* file in your IDE, you will see those placeholders like following:
@ -67,7 +68,7 @@ For example, if you open the *Books/Index.cshtml* file in your IDE, you will see
You can write your custom codes between the _**<suite-custom-code-block-n></suite-custom-code-block-n>**_ placeholders and you can also extend these placeholders by customizing the [ABP Suite templates](../../suite/editing-templates.md).
{{ else if UI === "Angular" }}
{{ else if UI == "Angular" }}
Similar to services, there are two types of components:

Loading…
Cancel
Save