Separator

Kontrolka typu „Separator” służy do poprawy przejrzystości karty obiegu.

Dodanie tej kontrolki powoduje wstawienie pustego miejsca na karcie obiegu.

Zaznaczenie wartości prezentowania na całej szerokości umożliwia wprowadzenie odstępu jednego wiersza na karcie obiegu.

Na podglądzie karty obiegu kontrolka typu „Separator” prezentowana jest jako prostokąt obramowany przerywaną linią. Kontrolka nie posiada nazwy i innych właściwości.

 

Kontrolka typu Separator na karcie obiegu

 

We właściwościach kontrolki typu „Separator” możemy wybrać opcję:

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

 

Właściwości kontrolki typu Separator

 

Kontrolki typu Separator na definicji obiegu „Faktury sprzedaży” – gdy te oraz sąsiadujące kontrolki mają zaznaczoną opcję „Ustaw kontrolkę na początku wiersza”

 

Widok dokumentu w ramach obiegu „Faktury sprzedaży” – za pomocą strzałek wskazano miejsca, w których znajdują się separatory

 

Kontrolki typu Separator na definicji obiegu „Faktury zakupu 2” – gdy te oraz sąsiadujące kontrolki nie mają zaznaczonej opcji „Ustaw kontrolkę na początku wiersza”

 

Widok dokumentu w ramach obiegu „Faktury zakupu 2” – za pomocą strzałek wskazano miejsca, w których znajdują się separatory

 

Kontrolki typu Separator na definicji obiegu „Faktury sprzedaży” – gdy mają zaznaczoną opcję „Prezentuj na całej szerokości”

 

Widok dokumentu w ramach obiegu „Faktury sprzedaży” –  separatory oddzielają na szerokość wiersza kontrolki „Numer dokumentu”,  „Data wystawienia” i „Załącznik”



Tekst

Kontrolka typu „Tekst” służy do wprowadzania dowolnych informacji zawartych na dokumencie, jak na przykład sposób dostawy, tytuł faktury, nazwa towaru, a także komentarzy lub uwag do 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.
  • 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”.
  • Max długość – określa maksymalną długość wprowadzanego tekstu – max 900 znaków.
  • Tekst wielolinijkowy – określa liczbę wierszy wyświetlanego pola tekstowego. Dopuszczalna liczba to 100 linijek.
  • 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 typu Tekst i jej właściwości

 

Sekcja Inicjowanie wartości

  • Inicjowanie – pole 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.

Uwaga

Od wersji 2023.1.2 jeżeli operator w ramach pola „Inicjowanie” wybierze wartość  SQL OD, SQL ERP lub C# Script, ale nie kliknie w link „Ustaw” i nie wprowadzi zapytania, wówczas przy próbie zapisu typu obiegu zostanie wyświetlony komunikat, a zmiany nie zostaną zapisane.

W takim przypadku należy zmienić wartość pola „Inicjowanie” na „Brak” albo wprowadzić brakujące zapytanie.

W ramach komunikatu podane są nazwa i identyfikator kontrolki, dla której nie wprowadzono wymaganego zapytania oraz opcja wybrana w polu „Inicjowanie”  tej kontrolki.

Przykładowy komunikat wyświetlany przy próbie zapisania typu obiegu, gdy na definicji kontrolki „Tekst 1” w polu „Inicjowanie” wybrano opcję „SQL OD”, ale nie wprowadzono zapytania

  • Inicjuj przy każdym otwarciu  – parametr widoczny, jeśli w polu „Inicjowanie” wybrano „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.
  • Dokument – pole widoczne, jeśli w polu „Inicjowanie” wybrano „Brak”; w tym polu można wybrać nazwę (identyfikator) wcześniej zdefiniowanej w danym obiegu kontrolki typu Dokument elektroniczny, z której  wartość ma zostać zmapowana do kontrolki typu tekst (zob. Dokument elektroniczny). Pole aktywne tylko dla współpracy z Comarch ERP XL.
  • Pole – pole widoczne, jeśli w polu „Inicjowanie” wybrano „Brak”; w tym polu można wybrać kolumnę z bazy danych Comarch ERP XL, której wartość zostanie zmapowana do kontrolki typu tekst (zob. Dokument elektroniczny). Pole aktywne tylko dla współpracy z Comarch ERP XL.

 

Przyklad

Przykład inicjowania kontrolki typu „Tekst” za pomocą zapytania SQL:

Administrator chce, aby na każdym nowym dokumencie w kontrolce typu tekst o nazwie „Ulica”  domyślnie był wyświetlany tekst „ul.”. W tym celu we właściwościach kontrolki w polu „Inicjowanie” ustawia „SQLOD”, klika „ustaw” i wpisuje następujące zapytanie:

 select 'ul.'

 

Inicjowanie kontrolki typu tekst o nazwie „Ulica” za pomocą zapytania SQL

 

Następnie przechodzi do zakładki „Schemat obiegu”, klika na etap „Rejestracja” i w sekcji „Kontrolki” przy kontrolce „Ulica” zaznacza parametr „Inicjalizacja SQL/C#”. Następnie zapisuje typ obiegu.

 

Zaznaczanie etapu, na którym ma nastąpić inicjalizacja kontrolki „Ulica”

 

Przykład inicjowania kontrolki typu „Tekst” za pomocą kodu C#:

Administrator chce, aby na każdym nowym dokumencie w kontrolce typu tekst o nazwie „Ulica”  domyślnie był wyświetlany tekst „ul.”. W tym celu we właściwościach kontrolki w polu „Inicjowanie” ustawia „C# Script”, klika „Ustaw” i wpisuje następujące zapytanie:

 Globals.MainFrame.ulica.Text="ul."

 

Inicjowanie kontrolki typu tekst o nazwie „Ulica” za pomocą kodu C#

 

Następnie administrator klika w ramach okna na ikonkę [Kompiluj i zapisz], a potem, po zamknięciu okna, przechodzi do zakładki „Schemat obiegu”, klika na etap „Rejestracja” i w sekcji „Kontrolki” przy kontrolce „Ulica” zaznacza parametr „Inicjalizacja SQL/C#”. Następnie zapisuje typ obiegu.

 

Zaznaczanie etapu, na którym ma nastąpić inicjalizacja kontrolki „Ulica”

 

Kontrolka „Uiica” na nowym dokumencie

Zarówno w przypadku zainicjowania kontrolki za pomocą zapytania SQL, jak i za pomocą kodu C#, od tej pory na każdym nowoutworzonym dokumencie w kontrolce „Ulica”  automatycznie wyświetlany jest tekst „ul.”  – operator może dopisać tekst lub, w razie potrzeby,  zmienić tekst „ul.” na inny.

 

Nowy dokument – w kontrolce „Ulica” automatycznie wprowadzony został tekst „ul.”

 

Sekcja Zmiana wartości (Obserwator)

W ramach tej sekcji znajdują się następujące pola:

  • Kontrolki powiązane – kontrolka prezentująca listę kontrolek powiązanych, 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 lub C# Script .

 

Przyklad

Administrator dodał w definicji typu obiegu następujące kontrolki typu Tekst:

  • Imię (identyfikator: imie)
  • Nazwisko (identyfikator: nazwisko)
  • Ulica (identyfikator: ulica)
  • Numer mieszkania (identyfikator: numer_mieszkania)
  • Kod pocztowy (identyfikator: Kod)
  • Miasto (identyfikator: miasto)
  • Dane osobowe (łącznie) (identyfikator: Dane)

Administrator chce, aby w kontrolce Dane osobowe (łącznie)  wyświetlone zostały dane z wszystkich pozostałych wymienionych kontrolek typu tekst.

W tym celu we właściwościach kontrolki Dane osobowe (łącznie)  w polu Kontrolki powiązane klika w link Dodaj  i kolejno wybiera kontrolki Imię, Nazwisko, Ulica, Numer mieszkania,  Kod pocztowy i Miasto.

 

Wersja z zastosowaniem zapytania SQL

Następnie w polu „Wzór na wartość”  administrator ustawia „SQLOD”, klika „Ustaw” i wpisuje następujące zapytanie (gdzie parametr @nowaLinia odpowiada za umiejscowienie następującego po nim fragmentu tekstu w nowej linijce, a  ’ ’  to odstęp między kolejnymi wartościami kontrolek):

declare @nowaLinia varchar(max) = char(13) + char(10)

select  @imie@  + ' ' +  @nazwisko@ + @nowaLinia
+ @ulica@ + ' '+  @numer_mieszkania@ + @nowaLinia
+  @Kod@ + ' '+  @miasto@

 

Wprowadzanie zapytania SQL w kontrolce „Dane osobowe (łącznie)”

 

Następnie administrator zapisuje typ obiegu.

 

Od tej pory kiedy operator uzupełni kontrolki tekstowe Imię, Nazwisko, Ulica, Numer mieszkania,  Kod pocztowy i Miasto, wtedy wszystkie ich wartości zostaną zapisane w kontrolce Dane osobowe (łącznie).

 

Kontrolka „Dane osobowe (łącznie)” uzupełniona wartościami z pozostałych kontrolek typu Tekst

 

Wersja z zastosowaniem kodu C#

Ten sam cel można osiągnąć za pomocą kodu C# – wówczas (po dodaniu kontrolek powiązanych) w polu „Wzór na wartość” administrator ustawia „C# Script”, klika „Ustaw” i wpisuje następujące zapytanie (gdzie parametr Environment.NewLine odpowiada za umiejscowienie następującego po nim fragmentu tekstu w nowej linijce, a  ’ ’  to odstęp między kolejnymi wartościami kontrolek):

Globals.MainFrame.dane.Text= Globals.MainFrame.imie.Text + ' ' 
+ Globals.MainFrame.nazwisko.Text
+ Environment.NewLine + Globals.MainFrame.ulica.Text +' ' 
+ Globals.MainFrame.numer_mieszkania.Text
+ Environment.NewLine + Globals.MainFrame.Kod.Text + ' ' 
+ Globals.MainFrame.miasto.Text

 

Wprowadzanie kodu C# w kontrolce „Dane osobowe (łącznie)”

 

Następnie administrator klika w ramach okna na ikonkę [Kompiluj i zapisz], a potem po zamknięciu okna zapisuje typ obiegu.

Od tej pory kiedy operator uzupełni kontrolki tekstowe Imię, Nazwisko, Ulica, Numer mieszkania,  Kod pocztowy i Miasto, wtedy wszystkie ich wartości zostaną zapisane w kontrolce Dane osobowe (łącznie).



URL

Kontrolka typu „URL” służy do prezentacji aktywnego linku strony WWW na karcie obiegu.

Wskazówka
Od wersji 2023.1.0 istnieje możliwość obserwowania kontrolki typu URL przez inne kontrolki (zob. przykład Obserwacja kontrolki typu URL przez inne kontrolki).

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 typu URL i jej właściwości

 

Na dokumencie Comarch DMS, kontrolka ta umożliwia wprowadzenie adresu strony WWW oraz jego zaprezentowanie na karcie obiegu. Po przyciśnięciu wprowadzonego linku, aplikacja podnosi stronę w przeglądarce internetowej. Na karcie obiegu może być użyta kilkukrotnie.

 

Wartość w kontrolce na karcie obiegu dodawana jest poprzez przycisk [Dodaj].

Prezentowana jest nazwa linku, a nie adres strona WWW.

Zmiana wartości dokonywana jest za pomocą przycisku [Zmień]. Link można usunąć za pomocą przycisku [Usuń].

 

Dodawanie adresu URL na danym dokumencie

 

Adres URL dodany na danym dokumencie

 

Istnieje możliwość ustawienia dla danego obiegu stałego adresu URL, który będzie automatycznie pojawiał się w ramach kontrolki typu URL po zapisaniu dokumentu. W tym celu należy zastosować procedurę do.OnAfterDocumentSave.

 

Przyklad

Przykład ustawienia automatycznie wyświetlanego adresu URL w ramach danego typu obiegu dokumentów

Admiistrator w ramach typu obiegu o nazwie „Faktury” dodaje kontrolkę URL o nazwie „Link do strony pomocy” (identyfikator: „Url1”).

Po wybraniu przycisku [Zmień] w polu „Nazwa linku” wpisuje Strona pomocy Comarch DMS, a w polu „Adres” https://pomoc.comarch.pl/dms/.

Następnie klika w przycisk  [Zapisz] ,  a później zapisuje typ obiegu za pomocą ikony zapisz32 [Zapisz].

 

Definiowanie kontrolki typu URL w ramach typu obiegu „Faktury”

 

Następnie w bazie Comarch DMS administrator odnajduje procedurę do.OnAfterDocumentSave (katalog Programmability/Stored Procedures) i po kliknięciu na jej nazwę prawym przyciskiem myszki wybiera „Modify”.

 

Baza Comarch DMS – wybór opcji „Modify” dla procedury do.OnAfterDocumentSave

 

Następnie wprowadza następujące zapytanie:

ALTER PROCEDURE [do].[OnAfterDocumentSave]
@DocumentId as int = NULL, -- DWD_ID z tabeli DF_Work
@SavedBy as int = NULL -- DCD_ID z tabeli DF_ConfOSDictionary
AS
If exists(
select * from do.RO_ObjectsTypes t
join do.RO_Documents d on d.DFH_Id=t.DFH_Id
where d.DWD_ID=@DocumentId and t.DFH_Name='Faktury'--nazwa typu obiegu
)

Begin
declare @dkoid INT
select @dkoid=c.DWC_DKOId from do.df_work w
join do.df_WorkCF c on w.DWD_ID= c.DWC_DWDId
join do.DF_ConfCFCardDokFlow f on c.DWC_DKOId=f.DKO_ID
where f.DKO_Name='Url1' and w.DWD_ID=@DocumentId--Nazwa kontrolki URL (identyfikator)

update do.DF_WorkCF set DWC_Number='Strona pomocy Comarch DMS' 
--nazwa wpisana w polu "Nazwa linku"
where DWC_DKOId=@dkoid and DWC_DWDId=@DocumentId

update do.DF_WorkCF set DWC_ValueString= 'https://pomoc.comarch.pl/dms/'
--link wprowadzony w polu "Adres"
where DWC_DKOId=@dkoid and DWC_DWDId=@DocumentId
END

 

Później administrator naciska przycisk „Execute” i powraca do Comarch DMS.

Na każdym nowym dokumencie po zapisaniu dokumentu w kontrolce „Link do strony pomocy” dostępny jest domyślnie link do strony https://pomoc.comarch.pl/dms/

 

Wybrany w definicji obiegu odnośnik URL na nowym dokumencie



Wartość logiczna

Kontrolka typu „Wartość logiczna” pozwala na wybranie wartości: Tak/Nie.

 

Kontrolka typu Wartość logiczna na dokumencie

 

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.

 

Przykładem użycia kontrolki „Wartość logiczna” może być każde pytanie, na które możliwa jest odpowiedź w postaci wartości Tak lub Nie, np. „Czy było zamówienie?”

 

Kontrolka typu  Wartość logiczna i jej właściwości

 

Przyklad

Przykład wykorzystania kontrolki typu Wartość logiczna do zablokowania przekazania dokumentu do następnego etapu

W ramach typu obiegu „Faktury” dodano kontrolkę typu Wartość logiczna o nazwie „Czy zatwierdzono?” (identyfikator: „Bool1”).

Administrator chce, aby warunkiem koniecznym do przekazania dokumentu z etapu „Rejestracja” do następnego etapu „Dekretacja” był wybór opcji „Tak” w ramach tej kontrolki.

W tym celu administrator wybrał zakładkę „Schemat obiegu”, następnie kliknął na etap „Dekretacja”  i w ramach zakładki „Przekazanie” link ” Definiuj warunki”. W otwartym oknie wpisał następujący warunek:

 

[Bool1] = 1

 

Następnie zapisał typ obiegu.

Wprowadzanie warunku przekazania dokumentu do następnego etapu

 

Od tej pory kiedy operator DMS zapisze dokument i nie wybierze wartości w kontrolce „Czy zatwierdzono?” lub wybierze opcję Nie – przekazanie do następnego etapu nie będzie możliwe.

 

Blokada przekazania dokumentu do następnego etapu z powodu braku wyboru opcji w kontrolce „Czy zatwierdzono?”

 



Własna akcja

Kontrolka typu „Własna akcja” umożliwia uruchomienie z poziomu karty obiegu:

  • programu (exe)
  • procedury SQL
  • pliku wykonywalnego na serwerze IIS
  • kodu w języku C#

 

Na właściwościach tej kontrolki dostępne są 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”.
  • Plik wykonywalny – użytkownik może uruchomić aplikację typu exe. Aplikacja musi znajdować się na dysku komputera, na którym działa Comarch DMS lub w udostępnionym udziale dyskowym, do którego ma dostęp użytkownik systemu. Ścieżkę do aplikacji należy umieścić w cudzysłowie, np. „c:\windows\system32\calc.exe”.
  • IIS – pole umożliwia uruchomienie plików wykonywalnych na serwerze IIS.
  • Procedura – możliwe jest uruchomienie procedury znajdującej się w bazie obiegu. Należy wpisać nazwę procedury.
  • Procedura ERP – możliwe jest uruchomienie procedury znajdującej się w bazie systemu ERP. Należy wpisać nazwę procedury.
  • C# Script – istnieje możliwość wywołania procesu zdefiniowanego za pomocą kodu w języku C#.
  • Nazwa spółki – opcja dostępna w trybie wielospółkowym. Operator może wybrać spółkę z rozwijanej listy.
  • Potwierdzenie wykonania akcji –  użytkownik może zdefiniować własny komunikat, który ma się wyświetlić na szczegółach dokumentu po wykonaniu akcji na przycisku.
  • Pytaj przed uruchomieniem – jeżeli parametru zostanie zaznaczony, po kliknięciu przycisku „własna akcja” system wyświetli komunikat „Czy uruchomić akcję?”.
  • Zapisz przed uruchomieniem – zaznaczenie parametru sprawia, że po kliknięciu w przycisk własnej akcji, dokument najpierw jest automatycznie zapisywany, a następnie wykonywane jest polecenie zapisane w konfiguracji kontrolki.

 

Istnieje możliwość przekazywania parametrów dynamicznych do procedury lub programu skonfigurowanego dla kontrolki „Własna akcja”.

Parametry dynamiczne to nazwy kontrolek znajdujących się na karcie obiegu oznaczone znakami „@” na początku i na końcu nazwy.

 

Wskazówka
Przykład zastosowania pliku wykonywalnego:
plik.exe @Wartość netto@ @Wartość brutto@

 

Wskazówka
Przykład zastosowania procedury składowanej:
cdn.procedura @Wartość netto@ @Wartość brutto@

 

Kontrolkę można również zainicjować kodem w języku C#. Dla tej opcji możliwy jest wybór miejsca wykonania skryptu: Serwer IIS lub Proces (exe).

 

Uwaga
Uruchomienie skryptu na niezależnym procesie exe jest zalecane w przypadku obsługi API, które nie powinno działać na procesach wielowątkowych takich jak proces IIS.

 

Okno definiowania procedury wywołania kontrolki typu Własna akcja w języku C#

 

Funkcjonalność obsługuje następujące kontrolki:

  • Data i godzina
  • Dokument elektroniczny
  • Kontrahent
  • Liczba rzeczywista
  • Liczba stałoprzecinkowa
  • Liczba całkowita
  • Lista
  • Tekst
  • Towar
  • Wartość logiczna

 

Kontrolka typu Własna akcja i jej właściwości

 

Uruchamianie plików wykonywalnych na serwerze IIS

Funkcjonalność dotyczy stacjonarnej wersji aplikacji Comarch DMS. Umożliwia operatorom uruchamianie tego samego pliku *.exe umieszczonego bezpośrednio na serwerze IIS.

Przygotowany plik *.exe, należy umieścić w katalogu \bin\exe w folderze, w którym zainstalowano aplikację webową. Konfigurując kontrolkę ‘Własna akcja’ należy w polu IIS wprowadzić nazwę i ścieżkę  do pliku, który wywoła przygotowaną aplikację.
Nazwę i ścieżkę do pliku należy wprowadzić w cudzysłowie.

 

Ustawienia kontrolki ‘Własna akcja’ po wyborze opcji „IIS”

 

Uruchamianie plików wykonywalnych

 

Przyklad

Przykład pokazuje definiowanie kontrolki typu Własna akcja jako plik wykonywalny w taki sposób, aby wywoływany był kalkulator systemu Windows.

 

Ustawienia kontrolki ‘Własna akcja’ po wyborze opcji 'Plik wykonywalny’, tak, aby na karcie obiegu wywoływany był kalkulator

 

Po takim zdefiniowaniu kontrolki oraz zapisaniu zmian i typu obiegu  po kliknięciu na nowym dokumencie kontrolki „Akcja” zostanie wywołany kalkulator.

 

Wywoływanie kalkulatora za pomocą kontrolki „Akcja”

 

Przyklad

Przykład pokazuje definiowanie kontrolki typu Własna akcja jako plik wykonywalny w taki sposób, aby wywoływany był notatnik.

 

Ustawienia kontrolki ‘Własna akcja’ po wyborze opcji 'Plik wykonywalny’, tak, aby na karcie obiegu wywoływany był notatnik

 

Po takim zdefiniowaniu kontrolki oraz zapisaniu zmian i typu obiegu  po kliknięciu na nowym dokumencie kontrolki „Akcja” zostanie wywołany notatnik.

 

Wywoływanie notatnika za pomocą kontrolki „Akcja”

 

Uruchomienie procedury z bazy Comarch DMS

Aby uruchomić procedurę z bazy Comarch DMS, należy wybrać opcję „Procedura” i w otwartym oknie wpisać zapytanie według następującego wzoru:

exec nazwaprocedury
@pierwszy parametr z procedury = @identyfikator_kontrolki@,
@drugi parametr z procedury = @identyfikator_drugiej_kontrolki@,

itd.

Przyklad

Administrator dodał cztery kontrolki:

  • kontrolka typu tekst o nazwie „Nazwa działu” (identyfikator: Nazwa_dzialu)
  • kontrolka typu tekst o nazwie „Nazwa działu 2” (identyfikator: Nazwa_dzialu2)
  • kontrolka typu liczba całkowita o nazwie „Id spółki” (identyfikator: Id)
  • kontrolkę typu Własna akcja o nazwie  „Dodaj nowy dział” (identyfikator: Akcja)

Administrator chce, aby po wpisaniu danych do kontrolek „Nazwa działu”, „Nazwa działu 2”  i  „Id spółki”, a następnie kliknięciu w przycisk „Dodaj nowy dział” został dodany nowy dział w zakładce „Działy” w strukturze organizacyjnej wybranej spółki w Comarch DMS.

W tym celu wybrał procedurę do.AddDepartment, w której potrzebne są trzy parametry: @Name1 (varchar), @Name2 (varchar) i @CompanyId (int), jak jest widoczne na poniższej ilustracji.

 

Widok procedury do.AddDepartment w bazie Comarch DMS – zaznaczono potrzebne parametry

 

Po utworzeniu wspomnianych czterech kontrolek administrator we właściwościach kontrolki „Dodaj nowy dział” klika w link „Ustaw” w polu „Procedura” i w otwartym oknie wprowadza nastepujące zapytanie:

exec do.AddDepartment
@Name1 = @Nazwa_dzialu@, 
@Name2 = @nazwa_dzialu2@,
@CompanyId = @Id@

 

Ustawienia kontrolki ‘Własna akcja’ po wyborze opcji 'Procedura’, tak, aby z poziomu dokumentu można było dodać nowy dział w strukturze organizacyjnej spółki w Comarch DMS

 

Administrator zapisuje okno i typ obiegu. Od tej pory, kiedy operator DMS wpisze wartości w kontrolkach „Nazwa działu”, „Nazwa działu 2”  i  „Id spółki”, a później kliknie w przycisk „Dodaj nowy dział” – zostanie dodany nowy dział w zakładce „Działy” w strukturze organizacyjnej wybranej spółki w Comarch DMS

 

W konfiguracji kontrolki możliwe jest włączenie komunikatu z pytaniem, czy uruchomić daną akcję, pytanie wyświetlane jest po kliknięciu w przycisk wywołujący zdefiniowaną akcję.

 

 

Komunikat wyświetlany użytkownikowi, gdy na kontrolce zaznaczono parametr „Pytaj przed uruchomieniem”

 

W konfiguracji kontrolki można również  włączyć opcję wyświetlania  określonego komunikatu po wykonaniu akcji – w tym celu należy zaznaczyć checkbox w polu „Potwierdzenie wykonania akcji” i wpisać treść komunikatu w pustym polu poniżej. Wówczas po kliknięciu w przycisk akcji i po jej wykonaniu zostanie wyświetlony komunikat o określonej treści.

 

Włączanie opcji „Potwierdzenie wykonania akcji” i „Pytaj przed uruchomieniem”

 

Komunikat potwierdzający wykonanie akcji



Właściciel

Kontrolka „Właściciel” umożliwia zmianę właściciela dokumentu.

Właścicielem dokumentu domyślnie jest osoba tworząca dokument.

 

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 typu Właściciel i jej właściwości

 

Funkcjonalność właściciela dokumentu wprowadzona została w aplikacji na potrzeby funkcjonalności stanowisk powiązanych ze strukturą organizacyjną.

Operator, który jest właścicielem dokumentu jest zarazem punktem odniesienia w strukturze organizacyjnej, od którego należy zacząć wyszukiwanie najbliższego przełożonego, posiadającego określone uprawnienie typu Stanowisko powiązane ze strukturą organizacyjną, np. Kierownik (zob. Stanowisko powiązane ze strukturą).

Właścicielem dokumentu staje się domyślnie operator, który utworzył dokument. Istnieją dwa sposoby na zmianę właściciela dokumentu:

  • Zmiana poprzez kontrolkę „Właściciel” – właściciela dokumentu można zmienić ręcznie na każdym etapie zmieniając operatora w kontrolce typu „Właściciel” (warunek: kontrolka nie podlega w danym etapie właściwościom Tylko do odczytu i jest widoczna). Aby zmienić operatora, należy wpisać odpowiednią frazę w kontrolce i wybrać operatora z wyświetlanej listy.

 

 

Zmiana operatora w kontrolce typu Właściciel

 

W ramach kontrolki typu Właściciel na karcie danego dokumentu po wpisaniu frazy można wybrać z listy jednego z pracowników lub działów, które zdefiniowano w zakładce „Struktura organizacyjna” (zob. Informacje ogólne). Przy nazwiskach pracowników widoczne jest oznaczenie (P), zaś przy nazwach działów (D). W przypadku pracy w trybie wielospółkowym w nawiasach kwadratowych obok oznaczenia (P) lub (D) znajduje się skrót nazwy spółki.

 

Lista wyświetlana w kontrolce typu Właściciel – widoczne oznaczenia (P) (pracownik) i (D) (dział)

 

  • Automatyczna zmiana właściciela dokumentu – właściciel dokumentu może zostać zmieniony automatycznie podczas przekazywania dokumentu do etapu, na którym została ustawiona właściwość „Automatyczna zmiana właściciela dokumentu”. Musi być tu spełniony jeden warunek – dostęp do dokumentu na tym etapie może posiadać tylko jeden operator. Takie uprawnienie można ustawić w konfiguracji typu obiegu (uprawnienia statyczne) lub wybrać na szczegółach dokumentu podczas przekazywania dokumentu (uprawnienia dynamiczne). Jeśli parametr „Automatyczna zmiana właściciela dokumentu” został zaznaczony, a na szczegółach dokumentu podczas przekazywania dokumentu dodano więcej niż jednego operatora uprawnionego do dokumentu w następnym etapie, wówczas przekazanie dokumentu nie jest możliwe i wyświetlany jest komunikat informujący o przyczynie problemu z przekazaniem.

 

Ustawianie automatycznej zmiany właściciela dokumentu dla danego etapu

 

Komunikat wyświetlany przy próbie przekazania dokumentu do następnego etapu, gdy jest do niego uprawniony więcej niż jeden operator, a parametr „Automatyczna zmiana właściciela dokumentu” jest zaznaczony

 

Jeżeli na typie obiegu zostanie zdefiniowana kontrolka „Właściciel”, to nie można na żadnym etapie tego typu obiegu zaznaczyć właściwości „Automatyczna zmiana właściciela dokumentu” i odwrotnie. Błędna konfiguracja typu obiegu skutkuje komunikatem ostrzegawczym przy próbie zapisu:

 

Komunikat wyświetlany przy próbie zapisu typu obiegu, gdy konfiguracja typu obiegu jest niezgodna z wymaganiami kontrolki typu Właściciel

 

Uwaga
Dla funkcjonalności właściciela dokumentu nie ma możliwości zdefiniowania w jednym typie obiegu: kontrolki typu “Właściciel” na karcie obiegu oraz aktywowania parametru “Automatyczna zmiana właściciela dokumentu”, znajdującego się na właściwościach któregokolwiek etapu.

 

Jeżeli operator inicjujący nie wskaże w kontrolce typu „Właściciel” (na karcie obiegu) innego operatora to, po zapisie zmian wprowadzonych na dokumencie lub po przekazaniu do kolejnego etapu, aplikacja wstawi domyślnego operatora (w tym wypadku inicjującego dokument).

 

Kontrolka typu Właściciel na dokumencie



Załącznik

Kontrolka typu „Załącznik” umożliwia załączanie plików:

  • z dysku
  • bezpośrednio z urządzenia typu skaner lub z innych urządzeń
  • z modułu Repozytorium (od wersji 2023.1.0; jeśli współpraca Comarch DMS z Repozytorium jest włączona; zob. Załącznik dodany z modułu Repozytorium)

 

Kontrolka posiada możliwość uruchomienia skanera w celu wykonania skanu dokumentu.

 

Uwaga
Uruchomienie skanera jest możliwe tylko w przypadku aplikacji stacjonarnej.

 

Uwaga
Dodawanie załącznika z modułu Repozytorium jest aktualnie możliwe tylko w przypadku aplikacji stacjonarnej.

 

Właściwości kontrolki typu Załącznik są podzielone na dwie sekcje:

  • Ogólne
  • Archiwa

 

W ramach sekcji „Ogólne” 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.
  • Podpisy elektroniczne PDF – checkbox dodany w wersji 2023.0.0; po jego zaznaczeniu przy załącznikach formacie PDF dostępny jest przycisk do podpisywania dokumentów (zob. Podpisy elektroniczne dokumentów PDF).
  • 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”.
  • Wersjonowanie pliku – opcja „Tak” umożliwia podpięcie kilku wersji tego samego pliku o takiej samej nazwie pod jedną kontrolkę. Każdy nowo dodany plik zawiera na końcu nazwy kolejny numer wersji podany w nawiasach. Domyślną opcją jest „Nie”.

 

Zakładka typu Załącznik, sekcja „Ogólne”

 

W ramach sekcji „Archiwa” dostępne są następujące pola:

  • Manager dokumentów – umożliwia załączanie plików umieszczonych w managerze dokumentów albo „Współpraca z Repozytorium” – jeśli współpraca z Repozytorium jest włączona.
  • Nazwa spółki –  parametr dostepny w trybie wielospółkowym, w parametrze należy wskazać spółkę, w której będą zapisywane załączniki.
  • Lokalizacja – pole dostępne, gdy zaznaczono checkbox przy „Współpraca z Repozytorium”; lokalizacja w Repozytorium, do której powinny być przesyłane pliki
  • Zastosuj login operatora Repozytorium – pole dostępne, gdy zaznaczono checkbox przy „Współpraca z Repozytorium”; w tym polu należy wybrać operatora, w którego imieniu załączniki będą przekazywane do Repozytorium
  •  przycisk ‘Dodaj’  w sekcji ” Ustawienia typów dokumentów” –  pole dostępne, gdy zaznaczono checkbox przy „Współpraca z Repozytorium”; pod napisem ‘Typy’ powinny zostać wybrane takie właściwości jak:
    • typ dokumentów, który będzie przypisywany do przesłanych plików, a także określony typ domyślny
    • po kliknięciu „Dodaj”, a następnie wyborze konkretnych atrybutów i kliknięciu „Ustaw” – kontrolki DMS, które zostaną zmapowane do atrybutów
  • Etap mapowania – pole dostępne, gdy zaznaczono checkbox przy „Współpraca z Repozytorium”; etap obiegu dokumentu, na którym wartości kontrolek zostaną zmapowane do atrybutów, a także typ dokumentu będzie zmapowany na  plik przesłany do Repozytorium

 

Opcje dostępne w sekcji „Archiwa” są szczegółowo omówione w rozdziale Konfiguracja kontrolki typu Załącznik w ramach integracji modułu Repozytorium z modułem Workflow.

 

Dla parametru „Nazwa spółki” możliwe są opcje:

  • „Brak spółki – baza OD” – załączniki są zapisywane do bazy Comarch DMS,
  • „Brak spółki – IBARD” – załączniki są zapisywane w usłudze Comarch IBARD.

 

Wartość “Brak spółki” dla kontrolki typu Załącznik

 

Kontrolka typu Załącznik, sekcja „Archiwa” – gdy włączona jest współpraca z Managerem dokumentów

 

Kontrolka typu Załącznik, sekcja „Archiwa”, gdy włączono współpracę z modułem Repozytorium – przykład

 

Obok nazwy załączonego pliku prezentowana jest:

    • w przypadku załącznika dodanego z dysku lub ze skanu:
      • ikona podpisu elektronicznego (jeśli w ustawieniach kontrolki typu załącznik zaznaczono parametr „Podpis elektroniczny PDF i jeśli dodany załącznik jest w formacie PDF)
      • ikona zapisu załącznika (umożliwia zapisanie pliku na dysk lokalny)
      • ikona kosza (umożliwia odpięcie pliku od dokumentu). Ikona kosza jest nieaktywna, gdy na właściwościach kontrolki został oznaczony parametr „Tylko do odczytu”.
    • w przypadku załącznika dodanego z modułu Repozytorium:
      • ikona podpisu elektronicznego (po zapisaniu dokumentu w Comarch DMS – jeśli w ustawieniach kontrolki typu załącznik zaznaczono parametr „Podpis elektroniczny PDF i jeśli dodany załącznik jest w formacie PDF)
      • ikona zapisu załącznika (umożliwia zapisanie pliku na dysk lokalny)
      • ikona kosza (umożliwia odpięcie pliku od dokumentu). Ikona kosza jest nieaktywna, gdy na właściwościach kontrolki został oznaczony parametr „Tylko do odczytu”
      • ikona zmiany typu dokumentu (umożliwia zmianę typu dokumentu w Repozytorium na jeden z dostępnych w ustawieniach danej kontrolki typu załącznik. Ikona jest niewidoczna, gdy na właściwościach kontrolki został oznaczony parametr „Tylko do odczytu”.

 

Dwie kontrolki typu załącznik na nowym dokumencie w Comarch DMS, po zapisaniu dokumentu – do kontrolki „Załącznik” dodano plik PDF i graficzny z dysku, a do kontrolki „Załącznik 2” – z Repozytorium

 

W pliku Web.config znajduje się klucz: <add key=”DestinationAttachmentsWorkflow” value=”” />.
Wartość klucza definiuje bazę, w której będą przechowywane załączniki dodawane do dokumentów.

Klucz <add key=”DestinationAttachmentsWorkflow” value=”” /> przyjmuje wartości:

      • „DO” – baza danych DMS,
      • „XL” – baza danych ERP XL,
      • „IBARD” – usługa IBARD.

 

Załączniki z Managera dokumentów

Załączanie plików przechowywanych w Managerze dokumentów dostępne jest dla pracowników posiadających uprawnienie do pracy z modułem Manager dokumentów (zob. Dostęp do modułu Manager dokumentów), w tych typach obiegów, w których na kontrolce typu Załącznik zaznaczono parametr ‘Manager dokumentów’.

Możliwe jest przesyłanie załączników z managera dokumentów na dysk lokalny. Lokalizację przechowywania plików przesłanych do managera dokumentów określa klucz:
<add key=”DestinationAttachmentsRepository” value=”DO” />. Przyjmuje wartości:

      • „DO” – baza danych DMS
      • „IBARD” – usługa IBARD.

Operator posiadający uprawnienia do Managera dokumentów, podczas dodawania plików w kontrolce typu Załącznik będzie miał dostępną do wyboru opcję „Z managera dokumentów”

 

Menu wyboru źródła, z którego zostanie załączony plik do dokumentu DMS, widoczna pozycja „Z managera dokumentów”

 

Operator może do kontrolki typu Załącznik dodać wyłącznie te pliki, do których posiada przynajmniej uprawnienie do podglądu.

 

Okno Managera dokumentów wywołane z kontrolki typu Załącznik

 

Plik zostanie załączony po podświetleniu w wywołanym oknie managera dokumentów i kliknięciu w ikonę lub po podwójnym kliknięciu w wiersz, w którym wyświetlane są informacje o pliku.

 

Załączniki w Comarch DMS Repozytorium

W przypadku, gdy spółka korzysta z funkcjonalności Comarch DMS Repozytorium, załączniki przesyłane do Repozytorium mogą być przechowywane w bazie MongoDB lub w usłudze IBARD. Dokumentacja dotycząca funkcjonalności Repozytorium znajduje się na indywidualnych stronach partnerów oraz  na stronach pomocowych pod adresem Comarch DMS – Repozytorium – Baza Wiedzy programu Comarch DMS.



Kontrolki w trybie wielofirmowym

Wybór spółki w zapytaniach inicjujących wartości kontrolek

Możliwość określenia spółki dostępna jest w kontrolkach których wartości mogą być inicjowane przez SQL OD, tj:

  • Dane tabelaryczne
  • Data i godzina
  • Liczba rzeczywista
  • Liczba całkowita
  • Liczba stałoprzecinkowa
  • Lista
  • Tekst

Wskazanie spółki odbywa się poprzez zastosowanie w zapytaniu parametru @^DocumentCompanyId@

 

Przyklad

W Comarch DMS utworzono cztery spółki:

 

W dodatkowej tabeli (do.wdrKontrahenci) dodano kolumnę, w której zamieszczono informację o id spółki, do której przypisany jest kontrahent.

 

 

Na definicji typu obiegu w kontrolce typu lista ustawiono inicjowanie wartości poprzez SQL OD i dodano warunek aby na liście kontrahentów wyświetlane były tylko te pozycje, które zostały przypisane do spółki w ramach której dodawany jest dokument.

 

 

 

Na karcie obiegu, w zależności od spółki, w której dodawany jest dokument wyświetlona zostaje zawężona lista kontrahentów.

 



Szczegóły dokumentu

Wybór spółki na karcie obiegu

Przed rozpoczęciem pracy z dokumentem DMS posiadającym kontrolki typu: dokument elektroniczny, kontrahent, towar lub dokument ERP XL, każda z tego typu kontrolek musi posiadać określoną spółkę.

Jeżeli spółka nie została wskazana na właściwościach kontrolek to w momencie inicjowania dokumentu aplikacja wyświetli pytanie z jaką spółką niezainicjowane kontrolki mają współpracować.

Po wskazaniu spółki i zatwierdzeniu wyboru przyciskiem OK, wyświetlana jest karta obiegu w kontekście wskazanej spółki.

 

Dynamiczny wybór spółki podczas generowania dokumentu

 

Dzięki funkcjonalności dynamicznego wyboru spółki podczas tworzenia dokumentu DMS możliwe jest przygotowanie jednego typu obiegu, który może być wykorzystywany w rożnych spółkach ERP.

Dla przykładu, w procesie w którym występują kontrolki typu: „Kontrahent”, „Dokument elektroniczny”, „Dokumenty ERP XL”, kontrolka z wartością dokumentu pobieraną z bazy ERP, mogą być oznaczone pozycją „Dowolna spółka ERP XL”. W momencie tworzenia dokumentu DMS aplikacja zapyta operatora o spółkę, która zostanie przekazana do kontrolek. Kontrolki „Kontrahent” i „Dokument elektroniczny” zostaną powiązane z wybraną spółką (możliwe będzie otwarcie listy/szczegółów kontrahentów oraz dokumentów dla wskazanej spółki). Na wskazanej spółce wygenerowany zostanie dokument ERP XL (za pomocą kontrolki „Dokumenty ERP XL”). Zapytanie które pobierze wartość dokumentu z bazy ERP XL do kontrolki liczbowej również wykona się na wskazanej spółce.

Każda kontrolka z karty obiegu, która obsługuje wielofirmowość posiada w konfiguracji dodatkowe pozycje: „Dowolna spółka ERP XL”, „Dowolna spółka ERP Optima”, „Dowolna spółka ERP Altum” . Wybór jednej z tych opcji powoduje zwężenie spółek skonfigurowanych w aplikacji Comarch DMS, do spółek wskazanego typu systemu Comarch ERP, na etapie tworzenia dokumentu DMS.

 

Uwaga
Aplikacja nie pozwoli zapisać typu obiegu jeżeli dla kontrolek zostaną wskazane dowolne spółki powiązane z różnymi systemami Comarch ERP.

 

Możliwość wyboru domyślnej spółki dla edytora zapytań SQL kontrolki „Liczba stałoprzecinkowa”