j_skorowidze.aspx

Autor: Adam Siemiątkowski, SoftwareStudio Group Sp. z o.o.

Moduł j_skorowidze to dynamiczny komponent zarządzania danymi konfiguracyjnymi w systemie, oparty na technologiach ASP.NET i JavaScript. Jego głównym zadaniem jest umożliwienie administrowania różnymi typami rekordów poprzez interfejs gridu z możliwością CRUD (Create, Read, Update, Delete)

j_skorowidze.aspx - Funkcjonalność i Przeznaczenie

Przeznaczenie

Plik j_skorowidze.aspx oraz powiązane komponenty, takie jak j_skorowidze.js, służą do zarządzania skorowidzami (słownikami) w systemie StudioSystem. Transakcja ta umożliwia administratorom i użytkownikom końcowym dodawanie, edycję, usuwanie oraz podgląd danych skorowidzowych. Skorowidze są istotne dla zapewnienia spójności danych w systemie, szczególnie w kontekście wartości referencyjnych wykorzystywanych w innych modułach.

Interfejs użytkownika

Interfejs użytkownika jest dynamicznie generowany za pomocą JavaScript i zawiera siatkę danych (grid), umożliwiającą użytkownikom przeglądanie, filtrowanie i sortowanie rekordów. Komponenty takie jak toolbar pozwalają na szybki dostęp do funkcji dodawania, edycji, usuwania oraz podglądu rekordów. Przyciski te są konfigurowalne w zależności od uprawnień użytkownika i parametrów systemowych. W przypadku braku aktywnego wyboru wiersza użytkownik otrzymuje odpowiedni komunikat informacyjny, co zapobiega błędnym operacjom.

Logika kliencka

Skrypt j_skorowidze.js zarządza działaniem siatki danych oraz powiązanych funkcji. istotne elementy to:

• Funkcja UstawGrida, która generuje dynamiczne zapytanie SQL w celu załadowania danych do siatki.
• Obsługa zdarzeń użytkownika, takich jak kliknięcia na przyciskach toolbaru, edycja danych w siatce, czy zamykanie okien dialogowych.
• Mechanizmy walidacji danych wprowadzanych przez użytkownika, co zapewnia zgodność z wymaganiami systemowymi.

Obsługa operacji CRUD

System wspiera pełen zakres operacji CRUD (Create, Read, Update, Delete):

1. Dodawanie rekordów:
   • Poprzez funkcję addPosition użytkownik może otworzyć okno dialogowe w celu wprowadzenia nowych danych do skorowidza.
   • Dane są walidowane przed zapisaniem ich do bazy danych.
2. Edycja rekordów:
   • Wybrany rekord może być edytowany za pomocą funkcji editPosition, która ładuje szczegóły rekordu do formularza edycji.
   • Zmiany są aktualizowane w bazie danych po ich zatwierdzeniu przez użytkownika.
3. Usuwanie rekordów:
   • Funkcja deleteRowConfirm umożliwia użytkownikowi potwierdzenie usunięcia rekordu, zanim zostanie on fizycznie usunięty z bazy danych.
4. Podgląd danych:
   • Poprzez funkcję viewToolbar, użytkownicy mogą przeglądać szczegóły rekordu w trybie tylko do odczytu, co zapobiega przypadkowym modyfikacjom.

Zastosowanie w praktyce

Transakcja j_skorowidze.aspx jest istotna w kontekście zarządzania danymi referencyjnymi, które są wykorzystywane w różnych modułach systemu, takich jak obsługa użytkowników, konfiguracja procesów czy raportowanie. Dzięki intuicyjnemu interfejsowi użytkownicy mogą łatwo zarządzać skorowidzami, co poprawia efektywność pracy i zmniejsza ryzyko błędów.

Podsumowanie

j_skorowidze.aspx to zaawansowane narzędzie do zarządzania danymi referencyjnymi w systemie StudioSystem. Dzięki swojej funkcjonalności i automatyzacji procesów, zapewnia spójność danych i elastyczność w ich zarządzaniu.

Transakcja role_adm/j_skorowidze.aspx przyjmuje 2 parametry

• PRX - na podstawie tego parametru dobierany jest odpowiedni układ kolumn grida
• MODE - odpowiada za sposób edycji pozycji grida
• KOD - przekazanie parametru KOD przy wywołaniu transakcji j_skorowidze powoduje dodatkowe odfiltrowanie rekordów po polu x_skorowidze.KOD oraz przy dopisaniu nowego rekordu automatyczne podstawienie do pola KOD przekazanej wartości
• KOD1 - działanie analogiczne do parametru KOD, z tym, że dla pola KOD1

Parametr kod i kod1

Parametr mode

Wartości parametru mode:

• 1 - edycja i dopisanie za pomocą wiersza edycji
  
• 2 - edycja oraz usunięcie odbywa się za pomocą przycisków przy każdym wierszu grida, dopisanie nowej pozycji umieszczone jest na pasku toolbar grida
  
• brak parametru lub wszystkie pozostałe wartości (tzn. różne od 1 i różne od 2) - dopisanie, edycja oraz usunięcie odbywa się za pomocą przycisków na pasku toolbar grida
  

Usuwanie wierszy

Usuwanie wierszy może się odbywać za pomocą naduszenia odpowiednich przycisków (czerwony X) lub po przez zaznaczenie wiersza i naciśnięciu klawisza DELETE na klawiaturze.

j_skorowidze, a tabela _dziennik

Informacja o każdej zmianie (tzn. dodanie, edycja lub usunięcie rekordu) zapisywana jest w tabeli _dziennik.

Podsumowując, platforma StudioSystem oferuje zaawansowaną obsługę indeksów i słowników, co czyni ją idealnym wyborem dla firm pragnących zoptymalizować swoje systemy przechowywania i wyszukiwania danych. Dzięki potężnemu i wszechstronnemu pakietowi oprogramowania programiści mogą łatwo i szybko tworzyć i wdrażać zaawansowane projekty obejmujące przechowywanie i pobieranie danych.

istotne funkcjonalności

1. Konfigurowalne Gridy
   Moduł dynamicznie generuje kolumny w zależności od parametru prx, który określa typ konfiguracji (np. CSV, SEL, DRZ). Dla każdego typu definiowane są specyficzne kolumny, takie jak:
   • Pola tekstowe (np. Kod, Opis)
   • Checkboxy (np. Aktywne, Systemowe)
   • Pola numeryczne (np. Kolejność)
   • Specjalne formaty (np. daty, waluty).
2. Integracja z Bazą Danych
   • Operacje na danych realizowane są poprzez WebMethods w C# (DeleteRow, UpdateRow, InsertRow).
   • Wykorzystuje zapytania SQL do modyfikacji tabeli x_skorowidze oraz logowania zdarzeń w _dziennik.
3. Mechanizm Uprawnień
   • System uwzględnia role użytkowników (ROLASYS) oraz parametr SUPERVISOR dla uprzywilejowanych operacji.
   • Kontrola dostępu do funkcji edycji/usuwania poprzez parametry edit i del.
4. Logowanie Aktywności
   Wszystkie zmiany są rejestrowane w dzienniku z informacjami o:
   • Typie operacji (np. „Usunięcie rekordu”)
   • Użytkowniku
   • Identyfikatorze rekordu.

Przykłady zastosowań

• Konfiguracja E-maili (prx=EML)
  Definiowanie szablonów wiadomości z polami: Temat, Treść, Parametry.
• Zarządzanie Magazynami (prx=MAG)
  Konfiguracja oddziałów, komórek magazynowych i powiązanych parametrów.
• Konfiguracja Cech Produktów (prx=CEC)
  Tworzenie cech produktów z polami dla grupy, typu danych i wartości domyślnych