Informacje ogólne

W lewej części okna definicji obiegu dokumentów prezentowane są kontrolki konfigurowanego typu obiegu.

Okno podglądu karty obiegu – przykład

Pierwszym krokiem tworzenia nowego typu obiegu jest dodanie kontrolek służących do wprowadzania danych.

Kontrolki dostępne w aplikacji Comarch DMS możemy podzielić na trzy typy:

  • Kontrolki proste (Liczba całkowita, Liczba rzeczywista, Liczba stałoprzecinkowa, Data i godzina, Tekst, Lista, Wartość logiczna).
  • Kontrolki elektroniczne (Dokument elektroniczny, Kontrahent, Towar, Dane tabelaryczne) – umożliwiają wiązanie dokumentów, kontrahenta lub towaru z programu Comarch ERP Optima do aplikacji Comarch DMS.
  • Kontrolki pozostałe (Załącznik, Właściciel, Własna akcja, Separator, Etykieta)

Aby dodać kontrolkę do listy należy kliknąć przycisk [Dodaj] w panelu „Kontrolki”. Pojawi się formatka, na której z rozwijalnej listy należy wybrać typ kontrolki oraz wprowadzić nazwę. W panelu „Podgląd karty obiegu” pojawi się podgląd kontrolki.

Panel „Kontrolki” na definicji obiegu dokumentu

Lista typów kontrolek jest predefiniowana i nie można jej modyfikować. Zawiera następujące elementy:

  • Dane tabelaryczne
  • Data i godzina
  • Dokument elektroniczny
  • Dokument w obiegu
  • Etykieta
  • Komunikat
  • Kontrahent
  • Liczba całkowita
  • Liczba rzeczywista
  • Liczba stałoprzecinkowa
  • Lista
  • Separator
  • Tekst
  • Towar
  • URL
  • Wartość logiczna
  • Własna akcja
  • Właściciel
  • Załącznik

Lista zdefiniowanych kontrolek

Pełna lista właściwości kontrolek składa się z następujących elementów:

  • 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.
  • Inicjowanie – w zależności od typu kontrolki przyjmuje wartość Brak, SQL OD, SQL ERP, C# lub Słownik.
  • Dokument – pole występujące na kontrolkach prostych. W tym polu można wybrać dokument z kontrolki „Dokument elektroniczny”. Kontrolka będzie prezentować wartość z dokumentu z bazy Comarch ERP Optima.
  • Kontrahent – przyjmuje wartość Brak lub nazwę kontrolki typu Kontrahent z karty obiegu do mapowania wartości.
  • Płatnik – przyjmuje wartość Brak lub nazwę kontrolki typu Kontrahent z karty obiegu do mapowania wartości.
  • Wartość netto – przyjmuje wartość Brak lub nazwę kontrolki z karty obiegu do mapowania wartości dokumentu. Istnieje możliwość przypisania kontrolki typu liczba całkowita, liczba rzeczywista, liczba stałoprzecinkowa.
  • Waluta – przyjmuje wartość Brak lub nazwę kontrolki z karty obiegu do mapowania wartości dokumentu. Istnieje możliwość przypisania kontrolki typu tekst i lista.
  • Opis – przyjmuje wartość Brak lub nazwę kontrolki z karty obiegu do mapowania wartości. Istnieje możliwość przypisania kontrolki typu tekst i lista.
  • Załączniki – przyjmuje wartość Brak lub nazwę kontrolki z karty obiegu typu załącznik.
  • Lista zdefiniowanych kontrolek – wybranie wartości Tak wyświetli kolumnę z nazwą kontrolki i wartościami kontrolek z poszczególnych dokumentów na liście dokumentów.
  • Czas – wybranie opcji Tak umożliwia wprowadzanie godzin, minut i sekund na kontrolce typu Data i godzina.
  • Wartości – właściwość kontrolki typu Lista. Umożliwia zdefiniowanie słownika pozycji danej kontrolki. Wprowadzenie wartości następuje po kliknięciu klawisza Enter.
  • Typ – lista dostępnych typów dokumentów z programu Comarch ERP Optima, które zostaną wczytane do aplikacji Comarch DMS: Faktura sprzedaży (FA).
  • Max długość – właściwość kontrolki typu Tekst. Określa maksymalną długość wprowadzanego tekstu – max 900 znaków.
  • Tekst wielolinijkowy – właściwość kontrolki typu Tekst. Określa liczbę wierszy wyświetlanego pola tekstowego. Dopuszczalna liczba to 100 linijek.
  • Tryb pracy – właściwość kontrolki typu Lista. Przyjmuje wartości: Lista i Wyszukiwanie.
  • Dokumenty – właściwość kontrolki typu Dokumenty w obiegu. Przyjmuje wartości: Wszystkie lub Aktywne.
  • Plik wykonywalny – właściwość kontrolki typu Własna akcja, w której należy podać nazwę pliku wykonywalnego.
  • Procedura – właściwość kontrolki typu Własna akcja, w której należy podać nazwę procedury znajdującej się w bazie Comarch DMS.
  • Procedura ERP – właściwość kontrolki typu Własna akcja, w której należy wprowadzić nazwę procedury z bazy Comarch ERP Optima.
  • Kontrolki powiązane – kontrolka prezentująca listę kontrolek powiązanych (w tym kontrolka typu „Lista”) na podstawie, których wyliczana jest wartość kontrolki wynikowej. Kontrolka wynikowa to kontrolka, na której zostało zdefiniowane wyrażenie np. arytmetyczne z użyciem kontrolek powiązanych.
  • Wzór na wartość – formatka, na której zdefiniowane zostało wyrażenie, na podstawie którego zostanie wyliczona wartość kontrolki wynikowej przy użyciu kontrolek powiązanych. Lista rozwijalna prezentuje wartości: Wyrażenie, SQL OD, SQL ERP lub C#.
  • Wersjonowanie pliku – właściwość kontrolki typu Załącznik. Umożliwia podpięcie na dokumencie kilku wersji tego samego pliku, z zaznaczeniem kolejności wersji.
  • Prezentuj na całej szerokości – właściwość każdego typu kontrolki. Umożliwia zaprezentowanie kontrolki na całej szerokości karty obiegu na szczegółach dokumentu.
  • Tytuł – właściwość kontrolki typu Komunikat. Wprowadzona wartość zostanie zaprezentowana jako tytuł na oknie wyświetlonego komunikatu.
  • Nazwa Spółki – właściwość kontrolek elektronicznych dostępna tylko podczas pracy z funkcjonalnością Wielofirmowość. Prezentuje listę zdefiniowanych spółek na zakładce Połączenia ERP Optima.
  • Pogrubione pola we właściwościach kontrolek są polami wymaganymi i muszą zostać uzupełnione w celu zapisania typu obiegu.



Dane tabelaryczne


Kontrolka dane tabelaryczne jest wielokolumnową kontrolką z możliwością wprowadzenia nieograniczonej liczbie wierszy.

Istnieje możliwość zdefiniowania do 10 kolumn, każda z kolumn może posiadać następujący typ:

  • Dokument elektroniczny
  • Kontrahent
  • Liczba całkowita
  • Liczba rzeczywista
  • Liczba stałoprzecinkowa
  • Lista
  • Tekst
  • Towar
  • Wartość logiczna
  • Dokumenty w obiegu

Przykład kontrolki Dane tabelaryczne

Konfiguracja kontrolki Dane tabelaryczne – właściwości:

Zakładka Ogólne

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 – oznaczenie 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ą. 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”.

Liczba prezentowanych wierszy – liczba widocznych wierszy, po przekroczeniu zadanej ilości wierszy z prawej strony kontrolki pojawi się pasek przewijania.

Dodaj – możliwość definicji kolejnych kolumn kontrolki (maks. 10)

Typy kolumn:

Data i godzina

Właściwości:

      • Nazwa kolumny – jest to pole, którego zawartość będzie widoczna w nagłówku kolumny w kontrolce tabelarycznej na karcie obiegu, wartość pola nie musi być unikalna, dzięki temu możliwe jest dodanie kilku kolumn tego samego typu dla których wyświetlana jest taka sama nazwa.
      • Identyfikator kolumny – 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.
      • Czas – wartości Tak/Nie, określenie czy kontrolki data mają posiadać tylko datę czy datę i godzinę.
Dokumenty w obiegu

Właściwości:

      • Nazwa kolumny – jest to pole, którego zawartość będzie widoczna w nagłówku kolumny w kontrolce tabelarycznej na karcie obiegu, wartość pola nie musi być unikalna, dzięki temu możliwe jest dodanie kilku kolumn tego samego typu dla których wyświetlana jest taka sama nazwa.
      • Identyfikator kolumny – 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.
      • Po zapisie nie zamykaj dokumentu w kontrolce – parametr odpowiedzialny za zachowanie dokumentu wygenerowanego lub dowiązanego w ramach kolumny. Gdy parametr „Po zapisie nie zamykaj dokumentu w kontrolce” został zaznaczony, dokument podniesiony do podglądu lub dodany w ramach kontrolki / kolumny typu dokumenty w obiegu po kliknięciu w ikonę ‚Zapisz’ pozostaje wyświetlony, dopóki operator nie wycofa się z jego edycji za pomocą ikony ‚Nawiguj wstecz’ lub ‚Zamknij’  . Gdy parametr „Po zapisie nie zamykaj dokumentu w kontrolce” jest odznaczony, dokument podniesiony do podglądu lub dodany w ramach kontrolki / kolumny typu dokumenty w obiegu po kliknięciu w ikonę ‚Zapisz’ jest zamykany.
      • Dokument – przyjmuje wartości ‘Aktywne’ i ‘Wszystkie’, związany jest z możliwością podpięcia do tabeli tylko dokumentów przypisanych do pracownika (Aktywne) lub wszystkich dokumentów.
      • Typ obiegu – za pomocą przycisku ‚Dodaj’ należy określić typy obiegów dokumentów, w których można będzie tworzyć nowe i podpinać istniejące dokumenty z poziomu kontrolki Dane tabelaryczne. Jeżeli nie zostanie wskazany żaden typ obiegu, wówczas możliwe będzie podpięcie dowolnego istniejącego dokumentu. Dodanie nowego dokumentu wymaga wskazania typu obiegu, w którym dokument zostanie utworzony.
Dokument elektroniczny – umożliwia zdefiniowanie kolumny typu dokument elektroniczny z  możliwością podpinania dokumentów z systemu ERP Optima.

Właściwości:

      • Nazwa kolumny – jest to pole, którego zawartość będzie widoczna w nagłówku kolumny w kontrolce tabelarycznej na karcie obiegu, wartość pola nie musi być unikalna, dzięki temu możliwe jest dodanie kilku kolumn tego samego typu dla których wyświetlana jest taka sama nazwa.
      • Identyfikator kolumny – 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.
      • Nazwa spółki – pole dostępne w wielofirmowym trybie pracy, umożliwia wybór spółki dla której będą podpinane dokumenty.
      • Typ – Określenie typu dokumentu z systemu ERP Optima, który można podpiąć do kolumny. Wybór typu nie jest obowiązkowy. Jeżeli typ nie zostanie określony w kolumnie można podpinać każdy oprogramowany w aplikacji typ dokumentu.
Kontrahent – umożliwia zdefiniowanie kolumny z możliwością dowiązywanie kontrahentów z systemu ERP Optima

Właściwości:

      • Nazwa kolumny – jest to pole, którego zawartość będzie widoczna w nagłówku kolumny w kontrolce tabelarycznej na karcie obiegu, wartość pola nie musi być unikalna, dzięki temu możliwe jest dodanie kilku kolumn tego samego typu dla których wyświetlana jest taka sama nazwa.
      • Identyfikator kolumny – 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.
      • Nazwa spółki – pole dostępne w wielofirmowym trybie pracy, umożliwia wybór spółki z której będą podpinani kontrahenci.
Liczba całkowita

Właściwości:

      • Nazwa kolumny – jest to pole, którego zawartość będzie widoczna w nagłówku kolumny w kontrolce tabelarycznej na karcie obiegu, wartość pola nie musi być unikalna, dzięki temu możliwe jest dodanie kilku kolumn tego samego typu dla których wyświetlana jest taka sama nazwa.
      • Identyfikator kolumny – 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.
Liczba rzeczywista

Właściwości:

      • Nazwa kolumny – jest to pole, którego zawartość będzie widoczna w nagłówku kolumny w kontrolce tabelarycznej na karcie obiegu, wartość pola nie musi być unikalna, dzięki temu możliwe jest dodanie kilku kolumn tego samego typu dla których wyświetlana jest taka sama nazwa.
      • Identyfikator kolumny – 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.
Liczba stałoprzecinkowa

Właściwości:

      • Nazwa kolumny – jest to pole, którego zawartość będzie widoczna w nagłówku kolumny w kontrolce tabelarycznej na karcie obiegu, wartość pola nie musi być unikalna, dzięki temu możliwe jest dodanie kilku kolumn tego samego typu dla których wyświetlana jest taka sama nazwa.
      • Identyfikator kolumny – 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.

Kontrolka typu Dane tabelaryczne, kolumna Wartosc w trybie tylko do podglądu.

Lista

Właściwości:

      • Nazwa kolumny – jest to pole, którego zawartość będzie widoczna w nagłówku kolumny w kontrolce tabelarycznej na karcie obiegu, wartość pola nie musi być unikalna, dzięki temu możliwe jest dodanie kilku kolumn tego samego typu dla których wyświetlana jest taka sama nazwa.
      • Identyfikator kolumny – 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.
      • Listy – słownik nazw list zdefiniowanych na zakładce „Listy”.
Tekst

Właściwości:

      • Nazwa kolumny – jest to pole, którego zawartość będzie widoczna w nagłówku kolumny w kontrolce tabelarycznej na karcie obiegu, wartość pola nie musi być unikalna, dzięki temu możliwe jest dodanie kilku kolumn tego samego typu dla których wyświetlana jest taka sama nazwa.
      • Identyfikator kolumny – 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.
Towar – umożliwia zdefiniowanie kolumny z możliwością dowiązywanie towarów z systemu ERP Optima

Właściwości:

      • Nazwa kolumny – jest to pole, którego zawartość będzie widoczna w nagłówku kolumny w kontrolce tabelarycznej na karcie obiegu, wartość pola nie musi być unikalna, dzięki temu możliwe jest dodanie kilku kolumn tego samego typu dla których wyświetlana jest taka sama nazwa.
      • Identyfikator kolumny – 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.
      • Nazwa spółki – pole dostępne w wielofirmowym trybie pracy, umożliwia wybór spółki z której będą podpinane towary.
Wartość logiczna

Właściwości:

      • Nazwa kolumny – jest to pole, którego zawartość będzie widoczna w nagłówku kolumny w kontrolce tabelarycznej na karcie obiegu, wartość pola nie musi być unikalna, dzięki temu możliwe jest dodanie kilku kolumn tego samego typu dla których wyświetlana jest taka sama nazwa.
      • Identyfikator kolumny – 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.

Zakładka Listy

Dodaj – możliwość definicji słowików list na potrzeby kolumn typu „Lista”

Właściwości słownika list:

  • Nazwa – nazwa słownika listy.
  • Inicjowanie – sposób inicjowania listy: Słownik, SQL OD, SQL ERP, C# Script.
  • Rodzaj identyfikatora – pole umożliwia operatorowi określenie rodzaju identyfikatorów kolejnych pozycji na liście.   Przyjmuje wartości:
    • Int - gdy identyfikatory kolejnych pozycji na liście określone są liczbą. Dla metody inicjowania listy słownikiem,  rodzaj identyfikatora to zawsze int.
    • Text - gdy identyfikatory kolejnych pozycji na liście określone są wartością tekstową (np. GUID).

W przypadku, gdy w kontrolce lista określono rodzaj identyfikatora jako int, w edytorze zapytań SQL w mechanizmach inicjowania i obserwowania wyświetlane będą parametry:

    • <identyfikator_kontrolki_typu_lista>_Id
    • <identyfikator_kontrolki_typu_lista>_Text

W przypadku, gdy w kontrolce lista określono rodzaj identyfikatora jako text, w edytorze zapytań SQL w mechanizmach inicjowania i obserwowania wyświetlane będą parametry:

    • <identyfikator_kontrolki_typu_lista>_IdText
    • <identyfikator_kontrolki_typu_lista>_Text
  • Tryb pracy – wartości: Lista, Wyszukiwanie – w kolumnie typu lista umożliwiono wyszukiwanie wartości po dowolnym ciągu znaków. Możliwość takiego wyszukiwania uzależniona jest od wartości parametru ‘Szukaj po dowolnym ciągu znaków’. Parametr znajduje się we właściwościach definiowanej listy, po wskazaniu trybu pracy ‘Wyszukiwanie’.

Zakładka Inicjowanie wartości

Inicjowanie – wartość „SQL OD”, inicjowanie kontrolki zapytaniem SQL z bazy obiegu.

Przykład – właściwości kontrolki dane tabelaryczne

Zakładka Ograniczenie edycji

Na zakładce dostępna jest tabela, w której można określić tryb pracy poszczególnych kolumn kontrolki tabelarycznej na każdym etapie procesu.

Tabela zbudowana jest w ten sposób, że pierwsze dwie kolumny zawierają parametry dotyczące blokady dodawania i usuwania wierszy, które dotychczas były prezentowane we właściwościach kolumny na zakładce Ogólne. Pozostałe kolumny to kolejne kolumny zdefiniowanej kontrolki typu Dane tabelaryczne. Wiersze tabeli stanowią wszystkie etapy procesu.

Zaznaczenie parametru w kolumnach zablokuj usuwanie/dodawanie wierszy skutkuje brakiem możliwości usunięcia/dodania wiersza, gdy dokument przebywa w danym etapie. Zaznaczenie parametru w pozostałych kolumnach oznacza, że na danym etapie kolumna przejdzie w tryb do odczytu.

Właściwości kontrolki typu Dane tabelaryczne, nowa zakładka Ograniczenie edycji

Dodawanie istniejącego dokumentu oraz tworzenie nowego w kolumnie typu ‘Dokumenty w obiegu’

Wskazanie typu kolumny ‘Dokumentu w obiegu’ pozwala na dodawanie istniejącego lub utworzenie nowego dokumentu Comarch DMS.

Konfiguracja kontrolki Dane tabelaryczne, kolumna typu Dokument w obiegu

Aby w kontrolce Dane tabelaryczne utworzyć nowy dokument należy użyć przycisku który wywoła listę dostępnych typów obiegu w ramach, których możliwe jest utworzenie nowego dokumentu.

Kontrolka Dane tabelaryczne – wybór typu obiegu, w którym zostanie utworzony nowy dokument

Po wybraniu typu obiegu wyświetlona zostaje karta obiegu.

Karta obiegu wywołana z kontrolki Dane tabelaryczne na karcie obiegu w ramach innego typu obiegu

Aby w kolumnie typu „Dokumenty w obiegu” dodać istniejący dokument należy wpisać kilka znaków numeru dokumentu, który ma być podpięty w kontrolce. Po wpisaniu frazy, Comarch DMS wyświetli listę dokumentów, które zawierają wpisany ciąg znaków.

Kontrolka Dane tabelaryczne – wskazanie dokumentu Comarch DMS

Inicjowanie kontrolki tabelarycznej zapytaniem SQL

Istnieje możliwość inicjowania kontrolki tabelaryczne zapytaniem SQL. Możliwe jest uruchomienie zapytania wyłącznie na bazie obiegu. Poniżej zostały opisane zasady tworzenia zapytania SQL w zależności od zdefiniowanej ilości i typów kolumn kontrolki.

Tworząc zapytanie które zainicjuje kontrolkę należy kierować się przykładem zamieszczanym na formatce definicji zapytania „Zapytanie SQL”. Składania zapytania oraz przykład jest tworzony dynamicznie w zależności od ilości i typu zdefiniowanych kolumn.

Na poniższym rysunku zostały oznaczone dynamiczne elementy składni i przykładu.

Formatka Zapytanie SQL

Format zapytania SQL

Inicjowanie kontrolki tabelarycznej zapytaniem SQL odbywa się poprzez SELECT w którym podajemy tyle parametrów i w takiej kolejności w jakiej występują kolumny zdefiniowane w kontrolce.

Kolumny ze składni select przekładają się 1:1 do kolumn zdefiniowanych w kontrolce tabelarycznej poza jednym wyjątkiem. Tym wyjątkiem jest kolumna typu dokument elektroniczny, w którym konieczne jest określenie dwóch składowych GidTyp i Id dokumentu. Ostatnią kolumną jest zawsze tryb wprowadzania wartości instrukcją select : 1 – nadpisz (usuń istniejące wartości i zastąp nowymi), 2 – dodaj (do istniejących wartości dodaj nowe).

Zestawienie typów kolumn instrukcji SELECT:

Typ kolumny kontrolkiTyp kolumny SELECTPrzykład
Tekstvarchar (900)'Uwagi do płatności'
Data i godzinadatetime'20170926' - format 'YYYYMMDD'
Liczba całkowitaint123
Liczba stałoprzecinkowadecimal (22,4)1000.55
Liczba rzeczywstareal2000.55
Listaint1 - id pozycji
Kontrahentint751 - KntNumer
Towarint438 - TwrNumer
Wartość logicznaint0 - Nie
1 - Tak
Dokument elektronicznyint302 - GidTyp dokumentu
112 - Id dokumentu

Przyklad

Jeżeli w kontrolce dane tabelaryczne zostały zdefiniowane 4 kolumny typu:
1) dokument elektroniczny
2) liczba stałoprzecinkowa
3) lista
4) data i godzina
zapytanie select może wyglądać następująco:

<p style="text-align: center;
vertical-align: middle; font-weight: bold;
font-weight: 700;
font-weight: lighter; margin: 0 auto">Kolumny

<p style="text-align: center;
vertical-align: middle; font-weight: bold;
font-weight: 700;
font-weight: lighter; margin: 0 auto">1

<p style="text-align: center;
vertical-align: middle; font-weight: bold;
font-weight: 700;
font-weight: lighter; margin: 0 auto">4

<p style="text-align: center;
vertical-align: middle; font-weight: bold;
font-weight: 700;
font-weight: lighter; margin: 0 auto">2

<p style="text-align: center;
vertical-align: middle; font-weight: bold;
font-weight: 700;
font-weight: lighter; margin: 0 auto">3

<p style="text-align: center;
vertical-align: middle; margin: 0 auto">Tekst

<p style="text-align: center;
vertical-align: middle; margin: 0 auto">Data

<p style="text-align: center;
vertical-align: middle; margin: 0 auto">Liczba stałoprzecinkowa

<p style="text-align: center;
vertical-align: middle; margin: 0 auto">Id listy

<p style="text-align: center;
vertical-align: middle; margin: 0 auto">Tryb

<p style="text-align: center;
vertical-align: middle; margin: 0 auto">SELECT

<p style="text-align: center;
vertical-align: middle; margin: 0 auto">Monitor 23”,

<p style="text-align: center;
vertical-align: middle; margin: 0 auto">20170923,

<p style="text-align: center;
vertical-align: middle; margin: 0 auto">123.50,

<p style="text-align: center;
vertical-align: middle; margin: 0 auto">3,

<p style="text-align: center;
vertical-align: middle; margin: 0 auto">2

<p style="text-align: center;
vertical-align: middle; margin: 0 auto">UNION

<p style="text-align: center;
vertical-align: middle; margin: 0 auto">SELECT

<p style="text-align: center;
vertical-align: middle; margin: 0 auto">Klawiatura QWERTY,

<p style="text-align: center;
vertical-align: middle;
margin: 0 auto">20170508,

<p style="text-align: center;
vertical-align: middle; margin: 0 auto">348.00,

<p style="text-align: center;
vertical-align: middle; margin: 0 auto">2,

<p style="text-align: center;
vertical-align: middle; margin: 0 auto">2

Kolumny dla powyższego przykładu zostały zdefiniowane w następujący sposób:

Kolumny zdefiniowane w kontrolce tabelarycznej

Zmiana wartości kontrolki na podstawie zmiany wartości innej kontrolki (Obserwator)

Od wersji Comarch DMS 2018.2.1 została zmieniona funkcjonalność odświeżania zawartości kontrolki dane tabelaryczne instrukcją SQL: select * from @Nazwa kontrolki@. We wcześniejszych wersjach Comarch DMS wywołanie zapytania select * from @Nazwa kontrolki@ było obowiązkowe dla każdego zdarzenia. Brak instrukcji powodował usunięcie informacji z kontrolki dane tabelaryczne. Aktualnie brak tego zapytania nie spowoduje usunięcia zawartości kontrolki. Zmiana została wprowadzona po to, aby nieobsłużone zdarzenia nie powodowały wielokrotnego odświeżania kontrolki.

Do wersji 2018.2.1 zalecanym schematem pisania zapytań SQL w obsłudze zdarzeń kontrolki dane tabelaryczne był schemat, w którym zapytanie select * from @Nazwa kontrolki@ znajdowało się na końcu kodu SQL:

Przyklad

Przykład warunku:

If warunek 1

Begin

… Obsługa warunku 1

End

If warunek 2

Begin

… Obsługa warunku 2

End

select * from @Nazwa kontrolki@

Aktualnie zalecanym schematem jest:

Przyklad

Przykład warunku:

If warunek 1

Begin

… Obsługa warunku 1

select * from @Nazwa kontrolki@

End

If warunek 2

Begin

… Obsługa warunku 2

select * from @Nazwa kontrolki@

End

W przypadku wykorzystania nowego schematu warunku, brak obsługi zdarzenia nie spowoduje żadnej akcji w kontrolce dane tabelaryczne.

Uwaga
Nową zasadę można stosować gdy korzystamy z serwera MS SQL 2012 lub wyższego. W przypadku serwera MS SQL 2008 należy stosować dotychczasowe zasady!

Odświeżanie wartości w kontrolce dane tabelaryczne na żądanie

Funkcjonalność można włączyć w:
menu "Definicje typów obiegów" → zakładka "Schemat obiegu" → wybrany etap → zakładka "Kontrolki" → parametr "Odświeżanie tabeli na żądanie"

Parametr "Odświeżanie tabeli na żądanie"

Po włączeniu opcji na karcie obiegu pojawi się przycisk, który po kliknięciu będzie odświeżał wartości w tabeli.

Przycisk pozwalający na odświeżanie tabeli

W edytorze wyrażeń SQL dostępna jest obsługa zdarzenia kliknięcia w przycisk "Odśwież" w kontrolce typu dane tabelaryczne. Zdarzenia można wskazać w parametrach @^SenderControlName@ oraz @^InitSenderControlName@ poprzez wpisanie frazy złożonej z identyfikatora kontrolki tabelarycznej, następnie znaku "_" i dodatkowo słowa "Refresh". Np. dla kontrolki o identyfikatorze "Multiline1" zdarzenie kliknięcia będzie określane jako "Multiline1_Refresh".

Przyklad

Zdefiniowano kontrolkę typu dane tabelaryczne "Elementy", w której po dodaniu towaru i uzupełnieniu ilości jednostki miary i ceny wyliczana jest wartość netto wszystkich pozycji tabeli. Zdefiniowano również kontrolkę typu liczba stałoprzecinkowa "Łączna wartość netto dokumentu", w której wyliczana jest suma wartości netto z tabeli.

W kontrolce typu dane tabelaryczne zastosowano mechanizm obserwowania zmiany wartości przez samą siebie, przy czym w parametrze @^SenderControlName@ wskazano zdarzenie kliknięcia w przycisk "Odśwież" w kontrolce typu dane tabelaryczne.

W kontrolce liczbowej "Łączna wartość netto dokumentu" zastosowano mechanizm obserwowania wartości w kontrolce tabelarycznej. W zapytaniu obserwatora w parametrze @^SenderControlName@ wskazano zdarzenie kliknięcia w przycisk "Odśwież" w kontrolce "Elementy". We właściwościach etapu zaznaczono, że kontrolka typu dane tabelaryczne będzie pracować w trybie odświeżanie na żądanie.

Na dokumencie DMS po uzupełnieniu kolumn "Towar", "Ilość", "JM" i "Cena" wartości w kolumnie "Wartość netto" i w kontrolce "Łączna wartość netto dokumentu" nie są wyliczane pomimo ustawienia mechanizmu obserwacji.

Dopiero po kliknięciu w ikonę "Odśwież" wartości zostaną wyliczone i zaprezentowane w kolumnie "Wartość netto" oraz w kontrolce "Łączna wartość netto dokumentu".




Data i godzina

Kontrolka przechowuje informacje o dacie lub dacie i godzinie. 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ą. 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”.
  • Czas – parametr odpowiadający za to czy w kontrolce będzie prezentowana godzina, ustawienie wartości parametru na „Tak”, skutkuje wyświetlaniem daty i godziny, ustawienie wartości parametru na „Nie”, skutkuje wyświetlaniem tylko daty.
  • 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.

Pole Inicjowanie może przyjąć wartość: Brak, SQL OD lub C# Script.

  • Gdy wybrana jest wartość „Brak”, właściwości kontrolki nie ulegają zmianie, działanie samej kontrolki nie zmienia się, kontrolka działa jak dotychczas.
  • W przypadku wartości „SQL OD” pojawia się możliwość zdefiniowania zapytania SQL, za pomocą którego będą zaczytywane wartości do kontrolki na karcie obiegu w dokumencie oraz wyświetlany jest parametr „Inicjuj przy każdym otwarciu dokumentu”.

Kontrolka Data i godzina, parametr „Inicjuj przy każdym otwarciu dokumentu”

  • Dla wartości „C# Script” możliwe jest inicjowanie kontrolki za pomocą kodu w języku C#.

  • Zaznaczenie parametru „Inicjuj przy każdym otwarciu” powoduje, że wartości wyświetlane w kontrolce będą inicjowane każdorazowo, gdy dokument zostanie otwarty w etapie, w którego właściwościach włączono inicjowanie SQL lub C#. Odznaczenie parametru oznacza, że działanie aplikacji w zakresie inicjowania będzie odbywało się jak dotąd, czyli wartość zostanie zainicjowana raz.

Kontrolka typu „Data i godzina” może być wykorzystywana, jako kontrolka, w której użytkownik wprowadza na karcie obiegu na szczegółach dokumentu np. datę wpływu dokumentu. Jeżeli w konfiguracji tej kontrolki wprowadzone jest zapytanie SQL-owe, można na jego podstawie z bazy pobrać konkretną wartość, którą aplikacja automatycznie wprowadzi do pola kontrolki.

Kontrolka Data i godzina i jej właściwości

Wskazówka
Przykład zapytania SQL dla kontrolki typu “Data i godzina”: select GetDate()




Dokument elektroniczny

Kontrolka typu „Dokument elektroniczny” służy do prezentowania podglądu szczegółów dokumentów z programu Comarch ERP Optima. Po zaczytaniu dokumentu system prezentuje numer systemowy dokumentu.

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.
  • Nazwa spółki – wyświetlane, gdy DMS pracuje w trybie wielospółkowym.
  • Typ – parametr służący określeniu typu dokumentu Comarch ERP Optima, który będzie możliwy do podpięcia w kontrolce.
  • 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ą. 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”.
  • 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.

Kontrolka może być wykorzystywana do wiązania dokumentów z systemu Comarch ERP Optima. Wiązanie jest możliwe jedynie w aplikacji stacjonarnej. Odbywa się poprzez otwarcie formatki z listą dokumentów zdefiniowanego typu i wskazanie dokumentu. Funkcjonalność działa w oparciu o uprawnienia operatora Comarch ERP Optima, w kontekście którego wykonywane jest wiązanie.

Kontrolka Dokument elektroniczny i jej właściwości

Aplikacja Comarch DMS umożliwia powiązanie kontrolek prostych z kontrolkami elektronicznymi. Dzięki tej funkcjonalności możliwe jest zaprezentowanie wartości pobranej z kontrolki elektronicznej (ze wskazanego pola bazy danych) w kontrolce prostej.

W kontrolce elektronicznej należy określić typ dokumentu („Typ”). W kontrolce prostej należy wypełnić pole „Dokument” poprzez wybór nazwy wcześniej zdefiniowanej kontrolki elektronicznej oraz wskazać na liście („Pole”) kolumnę z bazy danych.

Inicjowanie wartości

Pole Inicjowanie może przyjąć wartość: Brak, SQL OD lub C# Script.

  • Gdy wybrana jest wartość „Brak”, właściwości kontrolki nie ulegają zmianie, działanie samej kontrolki nie zmienia się, kontrolka działa jak dotychczas.
  • W przypadku wartości „SQL OD” pojawia się możliwość zdefiniowania zapytania SQL za pomocą, którego będą zaczytywane wartości do kontrolki na karcie obiegu w dokumencie oraz wyświetlany jest parametr „Inicjuj przy każdym otwarciu dokumentu”.

Parametr „Inicjuj przy każdym otwarciu dokumentu”

  • Dla wartości „C# Script” możliwe jest inicjowanie kontrolki za pomocą kodu w języku C#.

  • Zaznaczenie parametru powoduje, że wartości wyświetlane w kontrolce będą inicjowane każdorazowo, gdy dokument zostanie otwarty w etapie, w którego właściwościach włączono inicjowanie SQL lub C#. Odznaczenie parametru oznacza, że działanie aplikacji w zakresie inicjowania będzie odbywało się jak dotąd, czyli wartość zostanie zainicjowana raz.



Dokumenty w obiegu

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ę 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.

Kontrolka „Dokumenty w obiegu”
z podpiętymi dokumentami

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ą. 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.
  • Dokumenty – 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.

Na dokumencie Comarch DMS, kontrolka ta umożliwia wyszukiwanie dokumentów w oparciu o wpisaną frazę.

Możliwe jest usunięcie wybranego dokumentu po kliknięciu na ikonę kosza.

Kontrolka Dokumenty w obiegu i jej właściwości




Etykieta

Kontrolka typu „Etykieta” umożliwia prezentowanie danych, które nie podlegają zmianie i wprowadzone zostały podczas tworzenia typu obiegu. 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ą. 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”.

Kontrolka może być wykorzystywana do określenia np. nazwy/typu obiegu w ramach, którego wystawiany jest bieżący dokument.

Kontrolka Etykieta i jej właściwości




Komunikat

Kontrolka typu komunikat służy do wyświetlania komunikatów na karcie obiegu pod wpływem danego zdarzenia.

Na definicji kontrolki dostępne są następujące pola:

  • Nazwa wyświetlana – nazwa kontrolki widoczna wyłącznie na liście kontrolek na definicji obiegu.
  • 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.
  • Tytuł – treść wyświetlana na belce nagłówkowej komunikatu.
  • Kontrolki powiązane – pole, w którym należy wskazać kontrolkę, której zachowanie będzie obserwowane przez kontrolkę typu ‘Komunikat’.
  • Wzór na wartość – możliwe wartości: SQL OD, SQL ERP, C# Script. Określa czy komunikat zostanie zdefiniowany za pomocą zapytania SQL czy kodu w języku C#.
  • Ustaw – wyświetla okno edytora, do którego należy wprowadzić zapytanie lub kod definiujący komunikat.

Kontrolka typu Komunikat i jej właściwości

Mechanizm umożliwia wyświetlenie komunikatu podczas następujących zdarzeń:

  • Po wprowadzeniu tekstu, wyborze dokumentu elektronicznego dla mechanizmu obserwatora kontrolek typu: tekst, data i godzina, liczba całkowita, liczba rzeczywista, liczba stałoprzecinkowa, dokument elektroniczny, kontrahent, towar. Mechanizm jest aktywowany dla każdego etapu, dla którego została zaznaczona widoczność kontrolki.
  • Po otworzeniu dokumentu.

Wskazówka

Składnia definiowania komunikatu zapytaniem SQL:

Select Top 1 ‘Komunikat’, 1

  • Pierwszy parametr typu varchar(max) to tekst wyświetlany w komunikacie („Komunikat”)
  • Drugi parametr typu int umożliwia zablokowanie przekazania dokumentu do kolejnego etapu („1”).

Wartości:

  • 0 – można przekazać dokument do kolejnego etapu,
  • 1 – zablokowana możliwość przekazania dokumentu do kolejnego etapu. Jest to parametr opcjonalny, domyślnie ustawiony na 0.

Przykład definicji zapytania prezentuje poniższy rysunek. W przykładzie komunikat został zapięty na mechanizm obserwatora kontrolki typu tekst o nazwie „Numer zgłoszenia”.

Poniższy rysunek prezentuje przykład działania komunikatu i blokady przekazania dokumentu do kolejnego etapu.

Komunikat z treścią określoną w zapytaniu inicjującym, wyświetlony podczas pracy z aplikacją.




Kontrahent

Kontrolka typu „Kontrahent” umożliwia wczytywanie kontrahenta z listy kontrahentów zdefiniowanych w programie Comarch ERP Optima.

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ą. 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”.
  • Nazwa spółki – określa spółkę, z której będzie można wskazać kontrahenta.
  • 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.

Inicjowanie wartości

Pole Inicjowanie może przyjąć wartość: Brak, SQL OD lub C# Script.

  • Gdy wybrana jest wartość „Brak”, właściwości kontrolki nie ulegają zmianie, działanie samej kontrolki nie zmienia się, kontrolka działa jak dotychczas.
  • W przypadku wartości „SQL OD” pojawia się możliwość zdefiniowania zapytania SQL za pomocą, którego będą zaczytywane wartości do kontrolki na karcie obiegu w dokumencie oraz wyświetlany jest parametr „Inicjuj przy każdym otwarciu dokumentu”.

Parametr „Inicjuj przy każdym otwarciu dokumentu”

  • Dla wartości „C# Script” możliwe jest inicjowanie kontrolki za pomocą kodu w języku C#.

  • Zaznaczenie parametru „Inicjuj przy każdym otwarciu dokumentu” powoduje, że wartości wyświetlane w kontrolce będą inicjowane każdorazowo, gdy dokument zostanie otwarty w etapie, w którego właściwościach włączono inicjowanie SQL lub C#. Odznaczenie parametru oznacza, że działanie aplikacji w zakresie inicjowania będzie odbywało się jak dotąd, czyli wartość zostanie zainicjowana raz.

W sekcji „Podgląd karty obiegu” po dodaniu tej kontrolki, prezentowany jest przycisk , który otwiera listę kontrahentów z programu Comarch ERP Optima.

Kontrolka Kontrahent i jej właściwości

– w kontrolce prezentowane są przyciski [Zmień] wywołujący listę kontrahentów z Comarch ERP Optima oraz [Odepnij] który usunie wskazanie na kontrahenta.




Liczba całkowita

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ą. 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”.
  • 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.

Kontrolka Liczba całkowita i jej właściwości

Inicjowanie wartości

Pole Inicjowanie może przyjąć wartość: Brak, SQL OD lub C# Script

  • Gdy wybrana jest wartość „Brak”, właściwości kontrolki nie ulegają zmianie, działanie samej kontrolki nie zmienia się, kontrolka działa jak dotychczas.
  • W przypadku wartości „SQL OD” pojawia się możliwość zdefiniowania zapytania SQL za pomocą, którego będą inicjowane wartości w kontrolce na karcie obiegu.

Parametr „Inicjuj przy każdym otwarciu dokumentu”

  • W przypadku wartości „C# Script” możliwe jest zdefiniowanie kodu C#, który będzie inicjował wartości w kontrolce.
  • Parametr „Inicjuj przy każdym otwarciu dokumentu” (dostępny, gdy wybrano inicjowanie SQLOD lub C# Script). Zaznaczenie parametru powoduje, że wartości wyświetlane w kontrolce będą inicjowane każdorazowo, gdy dokument zostanie otwarty w etapie, w którego właściwościach włączono inicjalizację SQL/C#. Odznaczenie parametru oznacza, że wartość zostanie zainicjowana raz.



Liczba rzeczywista

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ą. 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”.
  • 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.

Kontrolka Liczba rzeczywista i jej właściwości

Inicjowanie wartości

Pole Inicjowanie może przyjąć wartość: Brak, SQL OD lub C# Script.

  • Gdy wybrana jest wartość „Brak”, właściwości kontrolki nie ulegają zmianie, działanie samej kontrolki nie zmienia się, kontrolka działa jak dotychczas.
  • W przypadku wartości „SQL OD” pojawia się możliwość zdefiniowania zapytania SQL za pomocą, którego będą zaczytywane wartości do kontrolki na karcie obiegu w dokumencie.

Parametr „Inicjuj przy każdym otwarciu dokumentu”

  • W przypadku wartości „C# Script” możliwe jest zdefiniowanie kodu C#, który będzie inicjował wartości w kontrolce.
  • Parametr „Inicjuj przy każdym otwarciu dokumentu” (dostępny, gdy wybrano inicjowanie SQLOD lub C# Script). Zaznaczenie parametru powoduje, że wartości wyświetlane w kontrolce będą inicjowane każdorazowo, gdy dokument zostanie otwarty w etapie, w którego właściwościach włączono inicjalizację SQL/C#. Odznaczenie parametru oznacza, że wartość zostanie zainicjowana raz.

Formatka Zapytanie SQL wspólna dla wszystkich kontrolek opartych o zapytanie SQL