Tabela _ach w bazie danych SQL Server

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

Do czego służy tabela [dbo].[_ach]

Pojedynczy znak w kolumnie ACH decyduje o tym, czy dokument jest jeszcze roboczy, czy wszedł już do obiegu. Ten sam mechanizm powtarza się w dokumentach magazynowych, kartotekach, lokalizacjach i zleceniach — dzięki czemu jedna reguła filtrowania działa w całym systemie. Tabela [dbo].[_ach] nadaje tym znakom znaczenie: przechowuje opis kodu oraz wskazanie pliku z kolorem, którym ma być prezentowany.

Rozdzielenie kodu i jego opisu ma praktyczny skutek: zmiana nazwy statusu albo jego koloru nie wymaga ruszania danych operacyjnych ani przebudowy raportów. Wystarczy poprawić jeden wiersz słownika, a wszystkie widoki odwołujące się do niego zmienią się natychmiast.

Typowy zestaw kodów obejmuje 0 — bufor (dokument czeka na zatwierdzenie, kolor szary), 1 — zatwierdzony (dokument wszedł do obiegu, kolor zielony), 2 — w trakcie (operacja rozpoczęta, kolor pomarańczowy) oraz X — usunięty (rekord wycofany, kolor czerwony). Lokalizacje magazynowe używają własnego zestawu, w którym pojawia się m.in. status I oznaczający trwającą inwentaryzację.

Zapis roboczyNowy dokument dostaje ACH = 0 i jest widoczny tylko dla autora

→

ZatwierdzenieOperator akceptuje dokument, system ustawia ACH = 1

→

PrezentacjaInterfejs pobiera z _ach opis i kolor przypisany do kodu

→

WycofanieZamiast kasować wiersz system nadaje mu status X

Rekordy nie są usuwane fizycznie — zmiana statusu na X zachowuje historię i pozwala odtworzyć stan sprzed operacji.

Budowa tabeli — wykaz kolumn

Tabela jest niewielka, ale każda kolumna pełni w niej wyraźnie określoną rolę. Poniższe zestawienie opisuje pełną strukturę wraz z typami danych i informacją o tym, czy wartość jest wymagana.

Kolumna KOLOR nie przechowuje wartości szesnastkowej, lecz wskazanie pliku lub klasy stylu użytej do prezentacji kodu w tabelach interfejsu.

Standardowe kody statusów w instalacji podstawowej

Zestaw kodów dostarczany razem z systemem obejmuje statusy wspólne dla dokumentów oraz odrębny zestaw przeznaczony dla lokalizacji magazynowych. Ten drugi jest bardziej szczegółowy, bo lokalizacja bywa czasowo niedostępna z powodów, które nie występują przy dokumentach — na przykład na czas liczenia towaru.

Ten sam znak oznacza co innego w zależności od symbolu PRX, dlatego złączenie ze słownikiem zawsze wymaga obu kolumn.

Kolory pełnią funkcję informacyjną, nie decyzyjną — pozwalają objąć wzrokiem stan całej listy, zanim operator zacznie czytać poszczególne wiersze. W instalacjach, w których lista dokumentów liczy setki pozycji dziennie, to jedyny praktyczny sposób szybkiego wyłapania zapisów, które utknęły w buforze.

Jak korzystać z tabeli w praktyce

Słownik statusów jest odczytywany przy niemal każdym wyświetleniu listy, dlatego w praktyce pracuje się z nim tak:

• Filtruj listy warunkiem ACH = '1', aby widzieć wyłącznie dokumenty zatwierdzone i pominąć zapisy robocze.
• Nie usuwaj wierszy poleceniem DELETE — nadanie statusu X zachowuje ślad operacji i nie psuje powiązań z innymi tabelami.
• Definiując nowy moduł, nadaj mu własny symbol PRX i dopisz komplet statusów, zamiast rozbudowywać zestaw wspólny.
• Przed edycją sprawdź znacznik SYSTEMOWE — wiersze oznaczone jako systemowe zostaną nadpisane przy ponownej instalacji bazy wzorcowej.
• Kolumna LOGIN rejestruje, kto dopisał wiersz słownika, co bywa pomocne przy ustalaniu, skąd wziął się nietypowy kod.
• Do raportów podłączaj słownik złączeniem, zamiast zapisywać opisy statusów na sztywno w zapytaniu.

Poniższe zapytanie pokazuje typowe złączenie tabeli operacyjnej ze słownikiem statusów, dzięki któremu raport prezentuje opis zamiast surowego kodu:

SELECT  d.NUMERDOK,
        d.DDOWOD,
        a.OPIS   AS STATUS,
        a.KOLOR
FROM    dbo.dokumenty AS d
        LEFT JOIN dbo._ach AS a
               ON a.ACH = d.ACH
              AND a.PRX = d.PRX
WHERE   d.DDOWOD >= DATEADD(DAY, -30, GETDATE())
ORDER BY d.DDOWOD DESC;

Złączenie po dwóch kolumnach — ACH i PRX — jest tu istotne. Bez warunku na PRX dokument magazynowy mógłby otrzymać opis statusu przeznaczonego dla lokalizacji.

Choć tabela zawiera zwykle kilkanaście wierszy, jej poprawna zawartość przekłada się na czytelność całego systemu. Braki w słowniku objawiają się pustymi lub surowymi kodami w kolumnie statusu na listach i w raportach.

Powiązane tabele i dokumentacja

Statusy z tej tabeli pojawiają się w większości struktur StudioSystem. Poniżej dokumentacja tabel, które najczęściej się do nich odwołują: