Kontrolka typu „Dokumenty w obiegu” służy do prezentacji numerów dokumentów z aplikacji Comarch DMS oraz do podglądu dokumentów.
Do kontrolki można podpiąć dowolną liczbę numerów dokumentów.
W kontrolce dostępny jest każdy zapisany na liście aktywny dokument.
Numery wyświetlane są po wpisaniu do kontrolki frazy – dowolnej części numeru.
Możliwe jest usunięcie wybranego dokumentu po kliknięciu na ikonę 
.
Na definicji kontrolki dostępne są następujące pola:
- Nazwa wyświetlana – jest to pole, którego zawartość będzie widoczna na karcie obiegu, wartość pola nie musi być unikalna, dzięki temu możliwe jest dodanie kilku kontrolek, dla których wyświetlana jest taka sama nazwa.
- Nazwa (identyfikator) – jest to pole, którego wartość widoczna jest wyłącznie we właściwościach kontrolki. Wartość tego pola musi być unikalna w ramach karty obiegu.
- Prezentuj na całej szerokości – zaznaczenie tej właściwości spowoduje wyświetlenie kontrolki na całej szerokości okna „Karta obiegu”.
- Ustaw kontrolkę na początku wiersza – parametr odpowiada za ustawienie kontrolki na początku nowego wiersza karty obiegu, bez konieczności dodawania separatorów pomiędzy kontrolką bieżącą, a kontrolką poprzednią.
Uwaga
Możliwość użycia parametru „Ustaw kontrolkę na początku wiersza” uzależniona jest od wartości parametru „Prezentuj na całej szerokości”. Gdy zaznaczono parametr „Prezentuj na całej szerokości”, nie ma możliwości użycia parametru „Ustaw kontrolkę na początku wiersza”. Gdy parametr „Ustaw kontrolkę na początku wiersza” jest zaznaczony, parametr „Prezentuj na całej szerokości” jest dostępny, jego zaznaczenie spowoduje wyłączenie i dezaktywację parametru „Ustaw kontrolkę na początku wiersza”.
- Po zapisie nie zamykaj dokumentu w kontrolce – parametr odpowiadający za zachowanie dokumentu wygenerowanego lub dowiązanego w ramach kontrolki, lub kolumny w kontrolce tabelarycznej.
- Dokument – przyjmuje wartości „Wszystkie” i „Aktywne”. Wartość „Wszystkie” odnosi się do wszystkich utworzonych w aplikacji dokumentów, natomiast wartość „Aktywne” tylko do tych, które są w stanie innym niż zakończone.
- Typ obiegu – parametr, w którym można wskazać typ obiegu, z którego dokumenty będą mogły być podpinane w kontrolce, wartość parametru może pozostać pusta, wówczas możliwe będzie podpięcie dokumentu każdego typu.
- Pokaż na liście – parametr odpowiedzialny za to, czy na liście dokumentów zawężonej do typu obiegu, na którym dodano kontrolkę, będzie wyświetlana kolumna z wartościami kontrolki.
- Kontrolki powiązane – możliwy jest wybór kontrolek, których wartości będą obserwowane przez kontrolkę typu „Dokumenty w obiegu”.
- Wzór na wartość – należy wprowadzić wyrażenie lub zapytanie SQL inicjujące kontrolkę typu „Dokumenty w obiegu”.
Uwaga
Aby parametr „Pokaż na liście” działał poprawnie, zarówno w przypadku starego jak i nowego trybu uprawnień należy przestrzegać następujących zaleceń:
- nie można używać nawiasów kwadratowych
- nazwa wyświetlana kontrolek może mieć maksymalnie 128 znaków (dotyczy kontrolek, które mają być wyświetlane na liście)
Przyklad
Na dokumencie Comarch DMS kontrolka ta umożliwia wyszukiwanie dokumentów w oparciu o wpisaną frazę – dowolną część numeru dokumentu.
