Migrácia .NET knižnice na verziu 6

Integrujem cez

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

Kam ďalej

Esc

↑↓ výberEnter otvoriťEsc zavrieť

Chýba vám niečo v dokumentácii?

Napíšte nám, s čím potrebujete pomôcť. Ozveme sa do pár hodín.

Údaje použijeme len na odpoveď. Viac v ochrane osobných údajov.