# Migrácia na verziu 6

> HTTP API je vo verzii 6 spätne kompatibilné. Zmeny v .NET knižnici: zjednotené menné priestory, premenované a interné triedy, NuGet balíky.

Zdroj: https://ekasa.ninedigit.sk/docs/migration/v6

**HTTP API** je vo verzii 6 úplne spätne kompatibilné s verziou 5, váš softvér meniť netreba. Zmeny nižšie sa týkajú
len **.NET knižnice**.

Článok je pre integrátorov, ktorí eKasu používajú ako **.NET knižnicu** a prechádzajú z verzie 5 na verziu 6.
Verzia 6 priniesla nekompatibilné zmeny: zjednotila menné priestory, premenovala niektoré triedy a metódy, triedy
neurčené na verejné použitie zmenila na interné a upravila zloženie NuGet balíkov.

## Prehľad zmien

- [Premenované triedy a menné priestory](#zmeny-názvov-a-menných-priestorov): 38 zmien: zlúčené menné priestory, nové názvy tried, metód a výnimiek.
- [Interné triedy](#interné-triedy): 55 tried a metód už nie je verejných (internal).
- [Zloženie NuGet balíkov](#zloženie-nuget-balíkov): Samostatné balíky pre CHDÚ, jedna DLL namiesto dvoch.

## Čo upraviť

Pri prechode na verziu 6 upravte vo svojom kóde:

| Čo upraviť | Verzia 5 | Verzia 6 |
|---|---|---|
| príkazy `using` | `NineDigit.eKasa.Core.*`, `NineDigit.eKasa.Core.Data` | jediný menný priestor `NineDigit.eKasa` |
| trieda tokenu | `NineDigit.eKasa.Core.Printing.Models.Token` | `NineDigit.eKasa.PrintToken` |
| trieda ciest | `NineDigit.eKasa.Helpers.EKasaPathHelper` | `NineDigit.eKasa.EKasaPath` |
| vytvorenie certifikátu | `CertificateHelper.Create` | `Certificate.FromXml` |
| vytvorenie identity | `IdentityHelper.Create` | `Identity.FromXml` |

Ostatné premenované triedy a metódy nájdete v tabuľkách nižšie.

## Zmeny názvov a menných priestorov

Všetky menné priestory sú zjednotené do `NineDigit.eKasa`, takže už nepotrebujete viac príkazov `using`.
Všetky premenované triedy a zmenené menné priestory sú v tabuľkách nižšie, rozdelené podľa druhu zmeny.
Názvy zodpovedajú stavu vo verzii 6.

### Zlúčené menné priestory

Celé menné priestory sa presunuli do `NineDigit.eKasa`, prípadne do jeho podpriestoru.

| Pôvodný menný priestor (v5) | Nový menný priestor (v6) |
|---|---|
| `NineDigit.eKasa.Core.Constants.PPEKK.*` | `NineDigit.eKasa.Constants.PPEKK.*` |
| `NineDigit.eKasa.Core.Data.*` | `NineDigit.eKasa` |
| `NineDigit.eKasa.Core.Data.Queries.*` | `NineDigit.eKasa.*` |
| `NineDigit.eKasa.Core.Data.Records.*` | `NineDigit.eKasa.*` |
| `NineDigit.eKasa.Core.Data.Validation.*` | `NineDigit.eKasa.Validation.*` |
| `NineDigit.eKasa.Core.Exceptions.*` | `NineDigit.eKasa.*` |
| `NineDigit.eKasa.Core.Extensions.*` | `NineDigit.eKasa.*` |
| `NineDigit.eKasa.Core.Printing.*` | `NineDigit.eKasa.*` |
| `NineDigit.eKasa.Core.Services.*` | `NineDigit.eKasa.*` |
| `NineDigit.eKasa.Core.Validation.*` | `NineDigit.eKasa.Validation.*` |

### Premenované a presunuté triedy

Tieto triedy majú nový názov alebo vlastný nový menný priestor.

| Pôvodný názov (v5) | Nový názov (v6) |
|---|---|
| `NineDigit.eKasa.Core.Data.Helpers.TimeZoneHelper` | `NineDigit.eKasa.TimeZoneHelper` |
| `NineDigit.eKasa.Core.Data.ORPCodeEqualityComparer` | `NineDigit.eKasa.ORPCode.EqualityComparer` |
| `NineDigit.eKasa.Core.Helpers.DecimalHelper` | `NineDigit.eKasa.DecimalExtensions` |
| `NineDigit.eKasa.Core.Helpers.IAsyncLock` | `NineDigit.eKasa.Threading.IAsyncLock` |
| `NineDigit.eKasa.Core.Helpers.SecureStringHelper` | `NineDigit.eKasa.SecureStringHelper` |
| `NineDigit.eKasa.Core.Helpers.ValidationHelper` | `NineDigit.eKasa.Validation.ValidationHelper` |
| `NineDigit.eKasa.Core.Helpers.WaitHandleHelper` | `NineDigit.eKasa.Threading.WaitHandleHelper` |
| `NineDigit.eKasa.Core.Printing.Models.Token` | `NineDigit.eKasa.PrintToken` |
| `NineDigit.eKasa.Core.Printing.PrinterNameEqualityComparer` | `NineDigit.eKasa.Printing.PrinterName.EqualityComparer` |
| `NineDigit.eKasa.Core.Resources.ValidationMessages` | `NineDigit.eKasa.Resources.ValidationMessages` |
| `NineDigit.eKasa.Core.Services.IStorageEnumerator` | `NineDigit.eKasa.Storage.IStorageEnumerator` |
| `NineDigit.eKasa.Core.Validation.Extensions.IValidatorExtensions` | `NineDigit.eKasa.Validation.IValidatorExtensions` |
| `NineDigit.eKasa.Core.Validation.Helpers.Validator` | `NineDigit.eKasa.Validation.Validator` |
| `NineDigit.eKasa.Helpers.EKasaPathHelper` | `NineDigit.eKasa.EKasaPath` |

### Nahradené metódy

Metódy na prácu so zabezpečeným reťazcom (`SecureString`) a na vytvorenie certifikátu a identity majú nový názov.

| Pôvodná metóda (v5) | Nová metóda (v6) |
|---|---|
| `NineDigit.eKasa.Core.Helpers.SecureStringHelper.Create(string)` | `NineDigit.eKasa.SecureStringHelper.FromString(string)` |
| `NineDigit.eKasa.Core.Helpers.SecureStringHelper.Decrypt(SecureString)` | `NineDigit.eKasa.SecureStringHelper.ToString(SecureString)` |
| `NineDigit.eKasa.Factories.CertificateHelper.Create(Stream, SecureString)` | `NineDigit.eKasa.Certificate.FromXml(Stream, SecureString)` |
| `NineDigit.eKasa.Factories.CertificateHelper.Create(string, SecureString)` | `NineDigit.eKasa.Certificate.FromXml(string, SecureString)` |
| `NineDigit.eKasa.Factories.IdentityHelper.Create(Stream, bool)` | `NineDigit.eKasa.Identity.FromXml(Stream, bool)` |
| `NineDigit.eKasa.Factories.IdentityHelper.Create(string, bool)` | `NineDigit.eKasa.Identity.FromXml(string, bool)` |

### Výnimky

Tieto výnimky majú nový menný priestor.

| Pôvodný názov (v5) | Nový názov (v6) |
|---|---|
| `Microsoft.EntityFrameworkCore.ForeignKeyConstraintException` | `NineDigit.eKasa.ForeignKeyConstraintException` |
| `Microsoft.EntityFrameworkCore.UniqueConstraintException` | `NineDigit.eKasa.UniqueConstraintException` |
| `NineDigit.eKasa.Infrastructure.Storage.Verification.Exceptions.StorageVerificationException` | `NineDigit.eKasa.Storage.Verification.StorageVerificationException` |
| `NineDigit.eKasa.Storage.Indexing.Exceptions.IndexTableIntegrityException` | `NineDigit.eKasa.Storage.Indexing.IndexTableIntegrityException` |
| `NineDigit.eKasaClient.Exceptions.EKasaFaultException` | `NineDigit.eKasaClient.EKasaFaultException` |
| `NineDigit.eKasaClient.Exceptions.EKasaRegistrationException` | `NineDigit.eKasaClient.EKasaRegistrationException` |

### Typy z menného priestoru `System`

| Pôvodný názov (v5) | Nový názov (v6) |
|---|---|
| `System.IDeepCloneable` | `NineDigit.eKasa.IDeepCloneable` |
| `System.IDeepCloneable<T>` | `NineDigit.eKasa.IDeepCloneable<T>` |

## Interné triedy

Triedy, ktoré nie sú určené na verejné použitie, majú modifikátor prístupu `internal`. Dotknuté triedy a metódy
sú nižšie, rozdelené podľa pôvodného menného priestoru.

### `NineDigit.eKasa.Core.Services`

| Trieda alebo rozhranie (v5) |
|---|
| `NineDigit.eKasa.Core.Services.DateTimeProvider` |
| `NineDigit.eKasa.Core.Services.EuropeBratislavaDateTimeProvider` |
| `NineDigit.eKasa.Core.Services.ICashDrawerService` |
| `NineDigit.eKasa.Core.Services.ICertificateRecordRepository` |
| `NineDigit.eKasa.Core.Services.IDateTimeProvider` |
| `NineDigit.eKasa.Core.Services.IIdentityRecordRepository` |
| `NineDigit.eKasa.Core.Services.IMemoryFileStreamer` |
| `NineDigit.eKasa.Core.Services.IPrinterStatusProvider` |
| `NineDigit.eKasa.Core.Services.IProductInfoProvider` |
| `NineDigit.eKasa.Core.Services.IReceiptNumberProvider` |
| `NineDigit.eKasa.Core.Services.IRecordRepository` |
| `NineDigit.eKasa.Core.Services.IRecordRepositoryConnection` |
| `NineDigit.eKasa.Core.Services.IRegisterTokenQueueProcessor` |
| `NineDigit.eKasa.Core.Services.ISwIdProvider` |
| `NineDigit.eKasa.Core.Services.MemoryRecordRepository` |
| `NineDigit.eKasa.Core.Services.OffsetStopwatch` |

### `NineDigit.eKasa.Core`

| Trieda, rozhranie alebo metóda (v5) |
|---|
| `NineDigit.eKasa.Core.IEKasaClient` |
| `NineDigit.eKasa.Core.IEKasaClientRequest` |
| `NineDigit.eKasa.Core.IEKasaClientRequest<TResult>` |
| `NineDigit.eKasa.Core.IEKasaClientResponse` |
| `NineDigit.eKasa.Core.IEKasaClientResponse<TResult>` |
| `NineDigit.eKasa.Core.IEKasaClientResponseExtensions` |
| `NineDigit.eKasa.Core.IEKasaClientResponseExtensions.EnsureIsSuccessful(this IEKasaClientResponse)` |
| `NineDigit.eKasa.Core.IEKasaMessage` |
| `NineDigit.eKasa.Core.RegisterStateExtensions` |
| `NineDigit.eKasa.Core.X509Certificate2Extensions` |

### `NineDigit.eKasa.Core.Printing`

| Trieda alebo rozhranie (v5) |
|---|
| `NineDigit.eKasa.Core.Printing.IPrinter` |
| `NineDigit.eKasa.Core.Printing.IPrinterProvider` |
| `NineDigit.eKasa.Core.Printing.NonfiscalReceiptPrintContext` |
| `NineDigit.eKasa.Core.Printing.ReceiptCopyPrintContext` |
| `NineDigit.eKasa.Core.Printing.ReceiptPrintContext` |
| `NineDigit.eKasa.Core.Printing.RequestsPrintContext` |

### `NineDigit.eKasa.Core.Helpers`

| Trieda alebo metóda (v5) |
|---|
| `NineDigit.eKasa.Core.Helpers.CryptoHelper` |
| `NineDigit.eKasa.Core.Helpers.DateTimeHelper` |
| `NineDigit.eKasa.Core.Helpers.DateTimeOffsetHelper` |
| `NineDigit.eKasa.Core.Helpers.SecureStringHelper.Decrypt(SecureString, Action<string>)` |
| `NineDigit.eKasa.Core.Helpers.SecureStringHelper.Decrypt<T>(SecureString, Action<string, T>)` |
| `NineDigit.eKasa.Core.Helpers.TimeoutHelper` |

### `NineDigit.eKasa.Core.Data` a `NineDigit.eKasa.Core.Extensions`

| Trieda alebo metóda (v5) |
|---|
| `NineDigit.eKasa.Core.Data.Comparers.ReferenceEqualityComparer` |
| `NineDigit.eKasa.Core.Data.Comparers.RegistrationRequestDataEqualityComparer` |
| `NineDigit.eKasa.Core.Data.RegisterReceiptResult.Create(ReceiptRegistrationRequest, IEKasaClientResponse<ReceiptRegistrationResult>)` |
| `NineDigit.eKasa.Core.Data.SubmitAsyncHandler(RegistrationRequest, CancellationToken)` |
| `NineDigit.eKasa.Core.Data.SubmitAsyncHandler<TRequest, TResult>(TRequest, CancellationToken)` |
| `NineDigit.eKasa.Core.Extensions.IInternetConnectivityMonitorExtensions` |
| `NineDigit.eKasa.Core.Extensions.ReceiptRegistrationRequestReceiptExtensions` |
| `NineDigit.eKasa.Core.Extensions.RegisterRequestStateExtensions` |

### Ostatné menné priestory

| Trieda, rozhranie alebo metóda (v5) |
|---|
| `NineDigit.eKasa.Application.Domain.IReadOnlyRegisterTokenQueue` |
| `NineDigit.eKasa.Helpers.EKasaPathHelper.GetAbsoluteFilePath(string)` |
| `NineDigit.Validation.Extensions.IValidatableObjectExtensions` |
| `System.Net.WebRequestExtensions` |
| `System.ObjectExtensions` |
| `System.ObjectExtensions.ToInvariantString(this IFormattable, string)` |
| `System.Security.Cryptography.X509Certificates.X500DistinguishedNameExtensions` |
| `System.Security.Cryptography.X509Certificates.X509CertificateCollectionExtensions` |
| `System.TimeSpanExtensions` |

## Zloženie NuGet balíkov

| Čo | Zmena vo verzii 6 |
|---|---|
| Knižnice na prístup k úložiskám CHDÚ | `NineDigit.ChduTech` a `NineDigit.ChduLite` sú samostatné NuGet balíky. |
| `NineDigit.eKasa.Core.dll` | Je zlúčená s `NineDigit.eKasa.dll`. NuGet balík `NineDigit.eKasa` už neobsahuje dva súbory DLL. |

## Kam ďalej

- [Návody na migráciu](https://ekasa.ninedigit.sk/docs/migration): Prehľad zmien medzi verziami eKasy.
- [.NET knižnica](https://ekasa.ninedigit.sk/docs/dotnet): Požiadavky, NuGet balíky a vytvorenie klienta.
