W niniejszym artykule dowiedzą się Państwo, jak zaimplementować interfejs FiscalClient przy użyciu pakietu nuget.
Wymagania
- Znajomość programowania w środowisku .NET
- Umiejętność korzystania z pakietów nuget
-
Pobierz pakiety
RetailForce.Fiscalisation - Platforma środowiskowa obsługująca .NET Standard 2.0
Implementacja
Dostawca konfiguracji
Aby zapisać konfigurację, potrzebny jest obiekt FileConfigurationProvider zawierający ścieżkę do pliku konfiguracyjnego oraz moduł rejestrujący:
FileConfigurationProvider fileConfigurationProvider = new FileConfigurationProvider(System.IO.Path.Combine(this.FilesDir.ToString(), "fiscalclient.config.json"), _logger);(Android).
Zarządzanie modułem fiskalnym
Aby utworzyć klientów lub załadować konfigurację z Cloud, potrzebna jest klasa FiscalModuleManagement:
IClientStatusReporter clientStatusReporter = new EmptyClientStatusReporter();
FiscalModuleManagement moduleManagement = new FiscalModuleManagement(_logger, fileConfigurationProvider, clientStatusReporter);Moduł logowania jest pochodną interfejsu Microsoft.Extensions.Logging.ILogger.
Wymagany jest moduł raportowania stanu klienta (IClientStatusReporter). Jeśli nie przetwarza Pan/Pani raportów stanu samodzielnie, proszę użyć klasy EmptyClientStatusReporter.
Wczytanie klienta z Cloud
Aby załadować klienta z Cloud, można użyć polecenia CreateClientByCloud:
uniqueClientId = moduleManagement.CreateClientByCloud(new CompanyIdentification() { Identification = "ATU1234567", Type = CompanyIdentification.IdentificationType.VatNumber }, "T001", "T001", cloudApiKey, cloudApiSecret);Ręczne utworzenie klienta
Klienta można również utworzyć ręcznie (FiscalClient). Po utworzeniu tej klasy klienta można utworzyć za pomocą funkcji CreateClient.
Utworzenie modułu fiskalnego
Moduł fiskalny można utworzyć za pomocą klasy FiscalModuleCreator:
CloudService cloudService = new CloudService(_logger, storageBasePath, uniqueClientId.Value, cloudApiKey, cloudApiSecret);
FiscalModulCreator creator = new FiscalModulCreator(fileConfigurationProvider, _logger, cloudService, null, clientStatusReporter);Spowoduje to utworzenie modułu fiskalnego. CloudService to klasa, która powinna pozostawać w oprogramowaniu przez cały czas działania aplikacji. Odpowiada ona za transfer danych do chmury w tle.
Czwarty parametr (IotService) jest opcjonalny i można go ustawić na wartość null. Klasa FiscalModuleCreator akceptuje również wartość null dla CloudService, jednak wykorzystywany poniżej obiekt LocalMonitoringClient wymaga obecności CloudService.
Tworzenie modułu fiskalnego
Po zainicjowaniu klasy FiscalModuleCreator można utworzyć moduł fiskalny.
Moduł fiskalny przechowuje swoje dane za pośrednictwem dwóch dostawców pamięci masowej: FiscalDataStorageProvider dla danych fiskalnych oraz AuditLogStorageProvider dla dziennika audytowego. W przypadku przechowywania lokalnego należy użyć LocalFiscalDataStorageProvider oraz LocalAuditLogStorageProvider. storageBasePath to katalog bazowy bez identyfikatora klienta (Android: this.GetExternalFilesDir(Android.OS.Environment.DirectoryDocuments).AbsolutePath); ścieżka do dziennika audytowego musi zawierać identyfikator klienta.
IMonitoringClient monitoringClient = new LocalMonitoringClient(cloudService);
FiscalDataStorageProvider storageProvider = new LocalFiscalDataStorageProvider(_logger, uniqueClientId.Value, monitoringClient, storageBasePath);
AuditLogStorageProvider auditLogStorageProvider = new LocalAuditLogStorageProvider(uniqueClientId.Value, _logger, System.IO.Path.Combine(storageBasePath, uniqueClientId.Value.ToString()));
TrustedFiscalModule fiscalModule = creator.CreateFiscalModuleForClient(uniqueClientId.Value, storageProvider, auditLogStorageProvider, cloudApiKey: cloudApiKey, cloudApiSecret: cloudApiSecret);Również w tym przypadku, jeśli obsługa chmury nie jest wymagana, można pominąć elementy zabezpieczeń chmury (cloudApiKey, cloudApiSecret).
WAŻNE: Konfiguracja klienta musi zostać utworzona wcześniej. Można to zrobić poprzez pobranie z Cloud lub za pomocą funkcji CreateClient (patrz wyżej).
Ten artykuł został przetłumaczony automatycznie.
Komentarze
Komentarze: 0
Zaloguj się, aby dodać komentarz.