AltOne.AnalizyExcelPlace 2504.1.1-0.15.1.1

This is a prerelease version of AltOne.AnalizyExcelPlace.
dotnet add package AltOne.AnalizyExcelPlace --version 2504.1.1-0.15.1.1
                    
NuGet\Install-Package AltOne.AnalizyExcelPlace -Version 2504.1.1-0.15.1.1
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="AltOne.AnalizyExcelPlace" Version="2504.1.1-0.15.1.1" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="AltOne.AnalizyExcelPlace" Version="2504.1.1-0.15.1.1" />
                    
Directory.Packages.props
<PackageReference Include="AltOne.AnalizyExcelPlace" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add AltOne.AnalizyExcelPlace --version 2504.1.1-0.15.1.1
                    
#r "nuget: AltOne.AnalizyExcelPlace, 2504.1.1-0.15.1.1"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package AltOne.AnalizyExcelPlace@2504.1.1-0.15.1.1
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=AltOne.AnalizyExcelPlace&version=2504.1.1-0.15.1.1&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=AltOne.AnalizyExcelPlace&version=2504.1.1-0.15.1.1&prerelease
                    
Install as a Cake Tool

AltOne.AnalizyExcelPlace

AltOne.AnalizyExcelPlace to licencjonowana biblioteka służąca do tworzenia w Excelu przejrzystych analiz płacowych opartych o tabele przestawne. Rozwiązanie integruje się z modułem kadrowo‑płacowym systemu enova365 i automatyzuje przygotowanie danych analitycznych: eksportuje je do bazy „AnalizyExcelPlace”, generuje skoroszyty Excel z bezpiecznym połączeniem OLE DB oraz tworzy gotowe do użycia tabele przestawne.
Biblioteka umożliwia wielowymiarowy podział kosztów wynagrodzeń wg podzielnika uzupełnionego na pracowniku (np. wydziały, projekty, stanowiska), co ułatwia controllingu rozliczenia kosztów i raportowanie. Integralną częścią rozwiązania jest biblioteka AltOne.WielowymiarowyPodzialPlac.

Najważniejsze funkcje

  • Automatyczne generowanie skoroszytów Excel z tabelą przestawną na podstawie danych z enova365.
  • Wielowymiarowy podział kosztów płac wg podzielnika (wydziały, projekty, stanowiska, własne segmenty).
  • Analizy składników wynagrodzeń (brutto/netto), obciążeń ZUS i podatków oraz kosztów pracodawcy.
  • Gotowe przekroje po pracowniku, okresie, wydziale, stanowisku, elemencie płacowym i segmentach projektu.

Przykładowe zastosowania

  • Controlling i raportowanie kosztów pracy (działy, projekty, MPK).
  • Analizy budżetowe i rozliczenia projektów z alokacją kosztów płac.
  • Szybkie przeglądy kosztów wynagrodzeń i składników dla działów HR/Finanse.

Dokumentacja pakietu

Użycie

Bibliotekę należy wgrać do systemu enova365 oraz poprawnie skonfigurować. Wymagany jest także pakiet MS Office Excel do poprawnej pracy rozwiązania.
AltOne.AnalizyExcelPlace

Wymagania (Excel/sterowniki)

  • Zalecany provider OLE DB: MSOLEDBSQL.1 (Microsoft OLE DB Driver for SQL Server). W razie braku sterownika używany jest fallback SQLOLEDB.1 (starszy).
  • Połączenia wymuszają szyfrowanie: Encrypt=Yes (lub Use Encryption for Data=True dla starszych providerów).

Testy integracyjne

Aktualne wyniki testów dla najnowszych wersji enova365:
latest.md w repozytorium GitHub

Ważne informacje

Wyniki testów integracyjnych mają charakter pomocniczy i nie zwalniają klienta z obowiązku przetestowania biblioteki w środowisku testowym przed wdrożeniem na produkcję.
Automatyczne testy obejmują jedynie podstawowe scenariusze i mogą nie odzwierciedlać specyfiki konkretnego wdrożenia.

Security

Biblioteka jest skanowana w ramach Azure DevOps Advanced Security.

Advanced Security

Aktualnie: brak otwartych alertów dependency. ✅

Po aktualizacji do wersji 2504.1.1-0.15.1.1 (Security · Action required)
  • Zrób jedno z poniższych:
    • Utwórz nowe skoroszyty Excel przy użyciu aktualnego makra, lub
    • zaktualizuj istniejące: usuń stare połączenia OLE DB i dodaj je ponownie kodem z nowego makra.
  • Dlaczego: wprowadzono utwardzenie bezpieczeństwa połączeń (m.in. wymuszenie szyfrowania, Persist Security Info=False, brak sekretów w VBA/plikach).
  • Zweryfikuj w definicji połączenia:
    • Provider=MSOLEDBSQL.1 (w razie braku sterownika dopuszczalny fallback do SQLOLEDB.1),
    • Encrypt=Yes oraz TrustServerCertificate=True (jeśli masz poprawny certyfikat — preferowane TrustServerCertificate=False),
    • Persist Security Info=False,
    • wariant zintegrowany: Integrated Security=SSPI i brak User ID/Password,
    • wariant SQL Auth: tylko User ID=<login> bez Password (hasło nie jest zapisywane).
  • Zachowanie oczekiwane:
    • Excel nie zapisuje haseł (.SavePassword=False); przy SQL Auth poprosi o hasło przy pierwszym odświeżeniu.
    • Połączenie tworzone jako „Polaczenie dla <Użytkownik>”, odświeżanie przy otwarciu może być włączone.
  • Wymagania środowiskowe:
    • Zainstalowany Microsoft OLE DB Driver for SQL Server (MSOLEDBSQL) — najnowsza wersja zalecana.

Historia zmian

Zmiany wersji są publikowane w sekcji Release Notes na NuGet.org.

Zewnętrzne biblioteki używane w projekcie

  • AltOne.WielowymiarowyPodzialPlac — integralna część rozwiązania (więcej informacji w opisie pakietu).
  • EPPlus w wersji 4.5.3.3 — używana do generowania arkuszy Excel.

Informacja o EPPlus:

License

Biblioteka jest licencjonowana. Szczegóły warunków licencji dostępne są w umowie z AltOne.

AltOne.AnalizyExcelPlace — Lista cech używanych w projekcie (Features)

Poniższa tabela zawiera wykaz cech (Features) używanych w kodzie projektu, ich typ, informację czy są opcjonalne, na jakiej tabeli/obiekcie są odczytywane oraz krótki opis ich przeznaczenia.

Nazwa cechy Typ Opcjonalna Tabela Opis cechy
Stanowisko string nie ElementPodzielnika Obsolete - nie używana
Klucz string tak ElementPodzielnika Alternatywna cecha‑klucz w elemencie podzielnika — używana jako źródło klucza podziałowego zamiast segmentów.
Podzielnik z pracownika bool tak Umowa Flaga na umowie: jeśli true, przy braku podzielnika na umowie używa się podzielnika z kartoteki pracownika.
Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
2504.1.1-0.15.1.1 243 10/29/2025
2504.1.1-0.15.0.3 163 10/28/2025
2410.0.0-0.15.0.3 256 5/20/2025
2410.0.0-0.15.0.0 182 1/17/2025
2406.0.0-0.14.0.2-Beta 153 10/8/2024
2406.0.0-0.14.0.0-Beta 119 9/4/2024
2306.0.4-net-0.12.0.6-Beta 128 7/9/2024
2306.0.4-net-0.12.0.5-Beta 136 4/15/2024
2306.0.4-net-0.12.0.4-Beta 158 2/27/2024
2306.0.4-net-0.12.0.3-Beta 185 9/7/2023
2306.0.4-net-0.12.0.2-Beta 152 8/31/2023
2304.3.5-0.12.0.0-Beta 324 8/31/2023

## 2504.1.1-0.15.1.1 z dn. 29.10.2025
- Utwardzenie bezpieczeństwa generowania plików Excel z makrem (VBA) w 'ExcelMacro':
 - brak osadzania sekretów w VBA i w pliku Excela ('.SavePassword=False', 'Persist Security Info=False'),
 - MSOLEDBSQL.1, 'Encrypt=Yes', kontrola 'TrustServerCertificate',
 - wykrywanie 'Integrated Security' i ustawienie 'xlCredentialsMethodIntegrated'.
- Zmiana domyślnego rozszerzenia w dialogu zapisu na '.xlsm'.
- [Security][Action required] Zaktualizuj połączenia OLE DB w istniejących plikach lub utwórz nowe skoroszyty.
## Version 0.15.0.3
- Rozszerzenie loga tworzenia pliku excel z makrem, obsługa problemu z tworzeniem pliku excel
## Version 0.15.0.0
- Przygotowanie do wersji 2410.0.0 net8
## Version 0.14.0.2-Beta
- Poprawa obsługi połączeń szyfrowanych SSL
## Version 0.14.0.0-Beta
- Dostosowanie do wersji NET8
## Version 0.12.0.6-Beta
- Poprawa funkcjonalności okna parametrów
## Version 0.12.0.5-Beta
- Poszerzenie okna parametrów oraz poprawa błędu przy zatwierdzaniu okna parametrów w wersji .net
## Version 0.12.0.4-Beta
- Rozszerzenie długości pól: Pracownik, Wydział oraz Stanowisko
## Version 0.12.0.3-Beta
- Dodanie weryfikatorów wymagalności pól do okna dialogowego
## Version 0.12.0.2-Beta
- Przygotowanie do wersji net6
## Version 0.12.0.0-Beta
- Zmiana nazwy biblioteki z AltOne.AnalizyExcelPlace.UI na AltOne.AnalizyExcelPlace
- Przygotowanie biblioteki do netstandard2.0
- Pozbycie się odwołania do Microsoft.Windows.Forms
- Przebudowa konfiguracji, zapis danych konfiguracyjnych w bazie danych enova365
- Przebudowa okna wywołania parametrów