Merge pull request #1812 from Xeevis/localization-cs

Update Czech translations

docs/cs/Best-Practices/PostgreSQL-Integration.md

@@ -0,0 +1,35 @@
+## Entity Framework Core PostgreSQL integrace
+
+> Podívejte se na [Entity Framework Core integrační dokument](../Entity-Framework-Core.md) pro základy integrace EF Core.
+
+### Aktualizace projektu EntityFrameworkCore
+
+- V projektu `Acme.BookStore.EntityFrameworkCore` nahraďte balík `Volo.Abp.EntityFrameworkCore.SqlServer` za `Volo.Abp.EntityFrameworkCore.PostgreSql` 
+- Aktualizace pro použití PostgreSQL v `BookStoreEntityFrameworkCoreModule`
+  - Nahraďte `AbpEntityFrameworkCoreSqlServerModule` za `AbpEntityFrameworkCorePostgreSqlModule`
+  - Nahraďte `options.UseSqlServer()` za `options.UsePostgreSql()`
+- V jiných projektech aktualizujte PostgreSQL connection string v nezbytných `appsettings.json` souborech
+
+#### Odstranění stávajících migrací
+
+Smažte všechny stavající migrační soubory (včetně `DbContextModelSnapshot`)
+
+![postgresql-delete-initial-migrations](images/postgresql-delete-initial-migrations.png)
+
+#### Znovu vygenerujte počáteční migraci & aktualizujte databázi
+
+Nastavte správný spouštěcí projekt (obvykle web projekt),
+Otevřete **Package Manager Console** (Tools -> Nuget Package Manager -> Package Manager Console), zvolte `Acme.BookStore.EntityFrameworkCore.DbMigrations` jako **Default project** a proveďte následující příkaz:
+
+Proveďte příkaz `Add-Migration`:
+````
+PM> Add-Migration Initial
+````
+
+Poté proveďte příkaz `Update-Database` k aktualizaci schématu databáze:
+
+````
+PM> Update-Database
+````
+
+![postgresql-update-database](images/postgresql-update-database.png)

docs/cs/Dapper.md

@@ -0,0 +1,61 @@
+# Dapper integrace
+
+Jelikož myšlenka Dapper je taková, že sql příkaz má přednost, tak hlavně poskytuje metody rozšíření pro `IDbConnection` rozhraní.
+
+Abp nezapouzdřuje přílíš mnoho funkcí pro Dapper. Abp Dapper poskytuje základní třídu `DapperRepository<TDbContext>` založenou na Abp EntityFrameworkCore, který poskytuje vlastnosti `IDbConnection` a `IDbTransaction` vyžadované v Dapper.
+
+Tyto dvě vlastnosti fungují dobře s [jednotkou práce](Unit-Of-Work.md).
+
+## Instalace
+
+Nainstalujte a nakonfigurujte EF Core podle [EF Core integrační dokumentace](Entity-Framework-Core.md).
+
+`Volo.Abp.Dapper` je hlavní NuGet balík pro Dapper integraci. Nainstalujte jej proto do vašeho projektu (pro strukturovanou aplikaci do datové/infrastrukturní vrstvy):
+
+```shell
+Install-Package Volo.Abp.Dapper
+```
+
+Poté přidejte závislost na `AbpDapperModule` modulu (atribut `DependsOn`) do Vašeho [modulu](Module-Development-Basics.md):
+
+````C#
+using Volo.Abp.Dapper;
+using Volo.Abp.Modularity;
+
+namespace MyCompany.MyProject
+{
+    [DependsOn(typeof(AbpDapperModule))]
+    public class MyModule : AbpModule
+    {
+        //...
+    }
+}
+````
+
+## Implementace Dapper repozitáře
+
+Následující kód implementuje repozitář `Person`, který vyžaduje `DbContext` z EF Core (MyAppDbContext). Můžete vložit `PersonDapperRepository` k volání jeho metod.
+
+`DbConnection` a `DbTransaction` jsou ze základní třídy `DapperRepository`.
+
+```C#
+public class PersonDapperRepository : DapperRepository<MyAppDbContext>, ITransientDependency
+{
+    public PersonDapperRepository(IDbContextProvider<MyAppDbContext> dbContextProvider)
+        : base(dbContextProvider)
+    {
+    }
+
+    public virtual async Task<List<string>> GetAllPersonNames()
+    {
+        return (await DbConnection.QueryAsync<string>("select Name from People", transaction: DbTransaction))
+            .ToList();
+    }
+
+    public virtual async Task<int> UpdatePersonNames(string name)
+    {
+        return await DbConnection.ExecuteAsync("update People set Name = @NewName", new { NewName = name },
+            DbTransaction);
+    }
+}
+```

docs/cs/Getting-Started-Angular-Template.md

@@ -0,0 +1,126 @@
+## Začínáme s Angular aplikační šablonou
+
+Tento tutoriál vysvětluje, jak vytvořit novou Angular aplikaci pomocí spouštěcí šablony, jak ji nakonfigurovat a spustit.
+
+### Tvorba nového projektu
+
+Tento tutorial používá k vytvoření nového projektu **ABP CLI**. Podívejte se na stránku [začínáme](https://abp.io/get-started) pro více možností.
+
+Pokud jste tak dosud neučinili, nainstalujte ABP CLI pomocí okna příkazového řádku:
+
+````bash
+dotnet tool install -g Volo.Abp.Cli
+````
+
+Použíjte příkaz `abp new` v prázdné složce k vytvoření Vašeho projektu:
+
+````bash
+abp new Acme.BookStore -u angular
+````
+
+> Můžete použít různé úrovně jmenných prostorů; např. BookStore, Acme.BookStore nebo Acme.Retail.BookStore.
+
+`-u angular` volba specifikuje Angular jako UI framework. Výchozí poskytovatel databáze je EF Core. Podívejte se na [CLI dokumentaci](CLI.md) pro všechny dostupné možnosti.
+
+#### Předběžné požadavky
+
+Vytvořené řešení vyžaduje;
+
+* [Visual Studio 2017 (v15.9.0+)](https://visualstudio.microsoft.com/tr/downloads/)
+* [.NET Core 2.2+](https://www.microsoft.com/net/download/dotnet-core/)
+* [Node v10.16+](https://nodejs.org)
+* [Yarn v1.17+](https://yarnpkg.com/)
+
+### Struktura řešení
+
+Otevřete řešení ve **Visual Studio**:
+
+![bookstore-visual-studio-solution](images/bookstore-visual-studio-solution-for-spa.png)
+
+Řešení má vrstvenou strukturu (založenou na [domain driven designu](Domain-Driven-Design.md)) a obsahuje projekty testů jednotek a integrace správně nakonfigurované pro práci s **EF Core** & **SQLite in-memory** databází.
+
+> Podívejte se na [dokument šablony aplikace](Startup-Templates/Application.md) k detailnímu pochopení struktury řešení.
+
+### Databázový connection string
+
+Zkontrolujte **connection string** v souboru `appsettings.json` u projektu `.HttpApi.Host`:
+
+````json
+{
+  "ConnectionStrings": {
+    "Default": "Server=localhost;Database=BookStore;Trusted_Connection=True"
+  }
+}
+````
+
+Řešení je nakonfigurováno pro použití **Entity Framework Core** s **MS SQL Server**. EF Core podporuje [různé](https://docs.microsoft.com/en-us/ef/core/providers/) poskytovatele databáze, takže pokud chcete můžete použít jiný DBMS. V případě potřeby změňte connection string.
+
+### Tvorba databáze & aplikace migrací databáze
+
+K vytvoření databáze máte dvě možnosti.
+
+#### Použití aplikace DbMigrator
+
+Řešení obsahuje konzolovou aplikaci (v tomto příkladu nazvanou `Acme.BookStore.DbMigrator`), která dokáže vytvořit databázi, aplikovat migrace a vložit počáteční data. Ta je užitečná jak pro vývojové tak pro produkční prostředí.
+
+> `.DbMigrator` má vlastní `appsettings.json`. Pokud jste změnili connection string výše, měli byste změnit i tento.
+
+Klikněte pravým na projekt `.DbMigrator` zvolte **Set as StartUp Project**:
+
+![set-as-startup-project](images/set-as-startup-project.png)
+
+Zmáčkněte F5 (nebo Ctrl+F5) ke spuštění aplikace. Výstup by měl být podobný vyobrazení níže:
+
+![set-as-startup-project](images/db-migrator-app.png)
+
+#### Použití příkazu EF Core Update-Database
+
+Ef Core máš příkaz `Update-Database`, který v případě potřeby vytvoří databázi a aplikuje čekající migrace. Klikněte pravým na projekt `.Web` a zvolte **Set as StartUp Project**:
+
+![set-as-startup-project](images/set-as-startup-project.png)
+
+Otevřete **Package Manager Console**, zvolte `.EntityFrameworkCore.DbMigrations` jako **Default Project** a proveďte příkaz `Update-Database`:
+
+![pcm-update-database](images/pcm-update-database-v2.png)
+
+Tímto vytvoříte novou databáze podle nakonfigurovaného connection string.
+
+> Je doporučeno užití nástroje `.DbMigrator`, protože zároveň vloží i počáteční data ke správnému běhu webové aplikace.
+
+### Spuštění aplikace
+
+#### Spuštění API Host (na straně serveru)
+
+Ujistěte se že je projekt `.HttpApi.Host` nastaven jako startovací a spusťte aplikaci což otevře Swagger UI:
+
+![bookstore-homepage](images/bookstore-swagger-ui-host.png)
+
+Tady můžete vidět API aplikace a zároveň je i otestovat. Získejte [více informací](https://swagger.io/tools/swagger-ui/) o Swagger UI.
+
+##### Autorizace pro Swagger UI
+
+Vetšina API aplikace vyžaduje autentizaci & autorizaci. Pokud chcete otestovat autorizované API, manuálně přejděte na stránku `/Account/Login`, vložte `admin` jako uživatelské jméno a `1q2w3E*` jako heslo k příhlášení do aplikace. Poté budete moci provádět autorizované požadavky API.
+
+#### Spuštění Angular aplikace (na straně klienta)
+
+Přejděte do složky `angular`, otevřete terminál příkazového řádku, proveďte příkaz `yarn` (doporučujeme používat správce balíků [yarn](https://yarnpkg.com), npm install bude v mnoha případech také fungovat):
+
+````bash
+yarn
+````
+
+Jakmile jsou načteny všechny node moduly, proveďte příkaz `yarn start` nebo `npm start`:
+
+````bash
+yarn start
+````
+
+Otevřete Váš oblíbený prohlížeč a přejděte na adresu `localhost:4200`. Počáteční uživatelské jméno je `admin` a heslo `1q2w3E*`.
+
+Startovací šablona obsahuje moduly **správa identit** a **správa tenantů**. Jakmile se přihlásíte, zprístupní se administrační menu kde můžete spravovat **tenanty**, **role**, **uživatele** a jejich **oprávnění**.
+
+> Doporučujeme [Visual Studio Code](https://code.visualstudio.com/) jako editor pro Angular projekt, ale klidně použijte Váš oblíbený editor.
+
+### Co dále?
+
+* [Tutoriál vývoje aplikace](Tutorials/Angular/Part-I.md)

docs/cs/docs-nav.json

@@ -202,7 +202,7 @@
       "items": [
         {
           "text": "API",
-          "items": [            
+          "items": [
             {
               "text": "Automatické API řadiče",
               "path": "AspNetCore/Auto-API-Controllers.md"
@@ -245,11 +245,21 @@
       "items": [
         {
           "text": "Entity Framework Core integrace",
-          "path": "Entity-Framework-Core.md"
+          "path": "Entity-Framework-Core.md",
+          "items": [
+            {
+              "text": "PostgreSQL integrace",
+              "path": "Best-Practices/PostgreSQL-Integration.md"
+            }
+          ]
         },
         {
           "text": "MongoDB integrace",
           "path": "MongoDB.md"
+        },
+        {
+          "text": "Dapper integrace",
+          "path": "Dapper.md"
         }
       ]
     },

docs/en/Getting-Started-Angular-Template.md

@@ -85,13 +85,13 @@ Open the **Package Manager Console**, select `.EntityFrameworkCore.DbMigrations`
 
 This will create a new database based on the configured connection string.
 
-> Using the `.Migrator` tool is the suggested way, because it also seeds the initial data to be able to properly run the web application.
+> Using the `.DbMigrator` tool is the suggested way, because it also seeds the initial data to be able to properly run the web application.
 
 ### Running the Application
 
 #### Run the API Host (Server Side)
 
-Ensure that the `.HttpApi.Host` project is the startup project and un the application which will open a Swagger UI:
+Ensure that the `.HttpApi.Host` project is the startup project and run the application which will open a Swagger UI:
 
 ![bookstore-homepage](images/bookstore-swagger-ui-host.png)