Jak dodać kolumnę w Comarch XL?

Kolumnę w Comarch ERP XL dodasz, klikając prawym przyciskiem myszy na liście dokumentów i wybierając „Dodaj kolumny”, a następnie definiując zapytanie SQL w kreatorze. Nowa kolumna pojawi się dopiero po ponownym wczytaniu listy, samo odświeżenie F5 nie wystarczy.

Jeśli korzystasz z Comarch ERP XL i chcesz wyświetlić na liście dokumentów dodatkowe dane, których nie ma domyślnie, masz do dyspozycji dwie drogi: metodę interfejsową przez menu kontekstowe albo edycję plików konfiguracyjnych #data# i #layout#. Obie metody dają różne możliwości i wymagają różnej wiedzy. Poniżej znajdziesz opis każdej z nich, a także najczęstsze błędy, przez które kolumna albo się nie pojawia, albo zwraca złe dane.

Dwie metody dodawania kolumn w Comarch ERP XL

Zanim zaczniesz, warto wiedzieć, że w Comarch ERP XL kolumny użytkownika można dodać na dwa sposoby, które różnią się poziomem skomplikowania i zastosowaniem.

Jak dodać kolumnę przez menu kontekstowe?

To najszybsza metoda dla osoby, która chce dołożyć kolumnę do konkretnej listy dokumentów, np. listy zamówień sprzedaży czy towarów.

Zrób to w tej kolejności:

• Kliknij prawym przyciskiem myszy w obrębie nagłówka listy dokumentów, na której chcesz dodać kolumnę.
• Wybierz opcję „Dodaj kolumny” z menu kontekstowego.
• W oknie „Lista dodatkowych zestawów kolumn” kliknij przycisk z zielonym plusem, aby uruchomić kreator.
• Wpisz nazwę kolumny (będzie widoczna w nagłówku listy), zapytanie SQL oraz wskaż operatorów lub centra, dla których kolumna ma być aktywna.
• Zaznacz checkbox „Aktywny”, a następnie zapisz ustawienie przyciskiem dyskietki.

Po zapisaniu nie wystarczy nacisnąć F5. Kolumna pojawi się dopiero po odłączeniu i ponownym dołączeniu listy w oknie systemu, czyli po zamknięciu i otwarciu danego modułu lub listy.

Jak napisać poprawne zapytanie SQL?

To jest miejsce, w którym większość użytkowników popełnia błędy. Zapytanie SQL musi spełniać jeden podstawowy warunek: dla każdego wiersza na liście może zwrócić dokładnie jeden rekord. Jeśli zapytanie zwróci więcej wierszy, złączenie nie zadziała poprawnie i kolumna nie wyświetli danych.

W zapytaniu SQL zawsze musisz użyć zmiennej {filtrsql}, która pozwala systemowi powiązać wynik z konkretnym wierszem listy. Pominięcie jej to najczęstszy powód, dla którego kolumna wyświetla błąd lub puste wartości.

Przykładowe zapytanie dla listy towarów, które pobiera kod CN z kartoteki:

select twr_pcn as [kod CN] from cdn.twrKarty where {filtrsql}

Po wpisaniu zapytania użyj przycisku z ikoną pioruna, aby je przetestować. System pokaże, czy zapytanie zwraca dane i czy złączenie działa prawidłowo. Weryfikację warto wykonać zawsze przed zapisaniem, żeby nie tworzyć kolumny, która zwraca błąd na produkcji.

Jak dodać kolumnę przez pliki #data# i #layout#?

Metoda plikowa jest stosowana głównie wtedy, gdy kolumna ma prezentować dane z atrybutów dokumentu lub gdy układ listy jest zarządzany centralnie przez wdrożeniowca. Wymaga dostępu do plików konfiguracyjnych Comarch ERP XL.

W pliku #data# tworzysz alias dla danych, np. Discount, który odwołuje się do odpowiedniego pola lub atrybutu. W pliku #layout# dodajesz definicję kolumny w odpowiedniej sekcji, podając alias jako wartość pola var. Nazwa w #layout# musi dokładnie odpowiadać aliasowi zdefiniowanemu w #data# – każda różnica w wielkości liter lub nazwie spowoduje, że kolumna będzie pusta.

Jak ustawić widoczność i pozycję kolumny?

Po dodaniu kolumny możesz zarządzać jej pozycją i szerokością tak samo, jak w przypadku standardowych kolumn. W nagłówku listy można kliknąć kolumnę prawym przyciskiem myszy i wybrać opcje dotyczące układu, lub przeciągnąć ją w inne miejsce. Jeśli kolumna nie pojawia się automatycznie w widocznym obszarze listy, sprawdź ustawienia w oknie „Zarządzanie kolumnami” – możliwe, że jest tam, ale ukryta lub przesunięta poza widoczny zakres.

Aby wyświetlić lub ukryć konkretne kolumny, dwukrotnie kliknij wiersz w oknie „Wybór kolumn” albo użyj przycisku [Dodaj] lub [Usuń] w sekcji zarządzania układem. Zmiany w układzie warto zapisać jako profil, żeby nie ustawiać ich od nowa przy każdym logowaniu.

Najczęstsze błędy przy dodawaniu kolumn

Większość problemów z kolumnami użytkownika wynika z kilku powtarzających się błędów. Sprawdź je, zanim zaczniesz szukać przyczyny gdzie indziej:

• Brak {filtrsql} w zapytaniu SQL – kolumna nie może powiązać wyników z wierszami listy, więc zwraca błąd lub nic nie pokazuje.
• Brak zaznaczonego checkboxa „Aktywny” przed zapisem – kolumna jest zapisana, ale niewidoczna.
• Nieprawidłowe centrum lub operator – kolumna jest dostępna tylko dla wybranych operatorów i centrów; jeśli pomylisz przypisanie, inni użytkownicy jej nie zobaczą.
• Niezgodność aliasu między #data# a #layout# przy metodzie plikowej – nawet drobna różnica w nazwie powoduje, że kolumna nie pobiera danych.
• Odświeżenie F5 zamiast ponownego wczytania listy – kolumna pozostaje niewidoczna, bo zmiany wymagają pełnego przeładowania kontekstu listy.

Jeśli kolumna pojawia się na liście, ale jest pusta, pierwszym krokiem do diagnostyki powinno być uruchomienie zapytania SQL bezpośrednio w bazie danych – sprawdź, czy w ogóle zwraca dane dla testowego rekordu.

Co zrobić, gdy kolumna działa błędnie lub chcesz ją usunąć?

Kolumnę użytkownika możesz dezaktywować bez usuwania – wystarczy wejść ponownie w „Dodaj kolumny”, odszukać kolumnę na liście, odznaczyć checkbox „Aktywny” i zapisać. Kolumna pozostanie w konfiguracji, ale nie będzie wyświetlana. To rozwiązanie przydaje się, gdy chcesz ją tymczasowo wyłączyć bez utraty definicji SQL.

Jeśli chcesz ją całkowicie usunąć, wejdź w ten sam kreator, zaznacz kolumnę i użyj opcji usuwania (czerwony minus lub przycisk „Usuń”). Restart systemu nie jest wymagany – wystarczy ponowne wczytanie listy. Przy metodzie plikowej usunięcie polega na cofnięciu zmian w plikach #data# i #layout# i zapisaniu zmodyfikowanych plików konfiguracyjnych.