Č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
Č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. |