Kontrolka typu Data i godzina – przykład definicji kontrolki za pomocą C#
Uwaga
Należy pamiętać, aby na zakładce „Schemat obiegu” na etapie, na którym ma się odbyć inicjalizacja, na zakładce „Kontrolki” zaznaczyć parametr „Inicjalizacja SQL/C#” przy danej kontrolce i aby zapisać wszystkie wprowadzone zmiany za pomocą przycisku [Zapisz] .
Właściwość:Value
Opis: Właściwość umożliwia odczyt wprowadzonej do kontrolki daty i godziny oraz zainicjowanie kontrolki datą i godziną.
Definicja: Globals.MainFrame.<identyfikator kontrolki Data i godzina>.Value
Typ: DateTime?
Dostęp: Zapis/Odczyt
Przyklad
Zainicjowanie kontrolki aktualną datą:
Globals.MainFrame.DateTime1.Value = DateTime.Now;
Zainicjowanie kontrolki aktualną datą przedstawiono w poniższym filmach:
Film
Wprowadzanie kodu i kompilacja
Dodawanie nowego dokumentu – w kontrolce „Aktualna data” widoczna jest data zainicjowana za pomocą C#:
Kontrolka typu Dokument elekroniczny – przykłady definicji kontrolki za pomocą C#
Uwaga
Należy pamiętać, aby na zakładce „Schemat obiegu” na etapie, na którym ma się odbyć inicjalizacja, na zakładce „Kontrolki” zaznaczyć parametr „Inicjalizacja SQL/C#” przy danej kontrolce i aby zapisać wszystkie wprowadzone zmiany za pomocą przycisku [Zapisz] .
Kontrolka „Dokument elektroniczny” posiada identyfikatory numeryczne i tekstowe.
Jeżeli kontrolka współpracuje z systemem ERP: XL, Altum, Optima, domyślnie ustawiane są identyfikatory numeryczne.
W przypadku współpracy z systemem CEEużywane są identyfikatory tekstowe.
Właściwość: Id
Opis: Właściwość umożliwia odczytanie i ustawienie numerycznego identyfikatora dokumentu kontrolki elektronicznej.
Opis: Właściwość umożliwia odczytanie i ustawienie typu dokumentu kontrolki elektronicznej dla systemów ERP posiadających numeryczne identyfikatory typów dokumentów (ERP XL, ERP Optima, ERP Altum).
Zainicjowanie kntrolki typu Dokument elektroniczny – po pomyślnej kompilacji
Poniższy film przedstawia zainicjowanie kontrolki typu Dokument elektroniczny podczas tworzenia nowego dokumentu:
Film
Podczas dodawania nowego dokumentu dokument o zdefiniowanym id i należący do wybranego typu zostaje automatycznie dodany do kontrolki typu Dokument elektroniczny:
Właściwość: IdText
Opis: Właściwość umożliwia odczytanie i ustawienie tekstowego identyfikatora dokumentu kontrolki elektronicznej.
Opis: Po zamknięciu komunikatu, właściwość StopPropagation=true umożliwia blokadę przekazania dokumentu DMS do kolejnego etapu. Jeżeli dokument nie został jeszcze zapisany, właściwość pozwala na blokadę zapisu dokumentu.
Wyświetlenie komunikatu dotyczącego wprowadzenia/braku wartości w kontrolce typu Tekst „Numer dokumentu” oraz blokada przekazania dokumentu do następnego etapu:
Po wprowadzeniu tekstu w kontrolce „Numer dokumentu” o identyfikatorze String1, zostanie wyświetlony komunikat.
Zostanie również zwolniona blokada przekazania dokumentu do kolejnego etapu (lub zapisu dokumentu, jeżeli dokument nie został jeszcze zapisany).
Usunięcie treści w kontrolce „Numer dokumentu” o identyfikatorze String1 spowoduje ponowne wyświetlenie komunikatu i zablokowanie możliwości przekazania do kolejnego etapu.
if (Globals.MainFrame.String1.Text != null)
{
Globals.MainFrame.Message1.Title = "Dokument do zatwierdzenia";
Globals.MainFrame.Message1.Message = "Wprowadzono wartość.";
Globals.MainFrame.Message1.StopPropagation = false;
}
else
{
Globals.MainFrame.Message1.Message = "Nie wprowadzono wartości.";
Globals.MainFrame.Message1.StopPropagation = true;
}
Dodatkowo w ramach pola „Kontrolki powiązane” wybrano kontrolkę „Numer dokumentu” (String1).
Film
Definiowanie kontrolki typu Komunikat:
Komunikat wyświetlony po zapisani dokumentu, gdy nie wprowadzono wartości w kontrolce „Numer dokumentu” – po prawej widoczny symbol blokady przekazania do następnego etapu
Film
Komunikat widoczny po kliknięciu w symbol blokady przekazania dokumentu, a nastepnie: komunikat widoczny po wprowadzeniu wartości w kontrolce „Numer dokumentu” oraz zwolnienie blokady przekazania do następnego etapu:
Kontrolka typu Kontrahent – przykłady definicji kontrolki za pomocą C#
Uwaga
Należy pamiętać, aby na zakładce „Schemat obiegu” na etapie, na którym ma się odbyć inicjalizacja, na zakładce „Kontrolki” zaznaczyć parametr „Inicjalizacja SQL/C#” przy danej kontrolce i aby zapisać wszystkie wprowadzone zmiany za pomocą przycisku [Zapisz] .
Kontrolka „Kontrahent” posiada identyfikatory numeryczne i tekstowe.
Jeżeli kontrolka współpracuje z systemem ERP: XL, Altum, Optima, domyślnie ustawiany jest identyfikator numeryczny (Id).
W przypadku współpracy z systemem CEEużywane są identyfikatory tekstowe (IdText).
Właściwość: Id
Opis: Właściwość umożliwia odczytanie i ustawienie tekstowego identyfikatora kontrahenta dla systemu CEE.
Dodatkowo w ramach pola „Kontrolki powiązane” wybrano kontrolkę „Kontrahent” (ERPContractor1).
Film
Uzupełnienie kontrolki „Skrót kontrahenta” nazwą z kontrolki typu Kontrahent:
Kontrolka typu Liczba całkowita – przykłady definicji kontrolki za pomocą C#
Uwaga
Przed kompilacją skryptów C# na komputerze z IIS należy nadać użytkownikowi IIS_IUSRS prawo zapisu do katalogu .scriptcs_cache
Uwaga
Należy pamiętać, aby na zakładce „Schemat obiegu” na etapie, na którym ma się odbyć inicjalizacja, na zakładce „Kontrolki” zaznaczyć parametr „Inicjalizacja SQL/C#” przy danej kontrolce i aby zapisać wszystkie wprowadzone zmiany za pomocą przycisku [Zapisz] .
Właściwość: Value
Opis: Właściwość umożliwia odczytanie i ustawienie wartości kontrolki.
Definicja: Globals.MainFrame.<identyfikator kontrolki typu liczba całkowita>.Value
Typ: int?
Dostęp: Odczyt/Zapis
Przyklad
Zainicjowanie kontrolki typu Liczba całkowita:
Globals.MainFrame.Int1.Value = 9485;
Zainicjowanie kontrolki wybraną liczbą przedstawiono w poniższych filmach:
Film
Wprowadzanie kodu i kompilacja:
Dodawanie nowego dokumentu – w kontrolce „Numer kolejny” widoczna jest liczba zainicjowana za pomocą C#:
Rozpoczynasz pracę z Comarch DMS i chcesz dowiedzieć się, jak korzystać z programu? A może masz już podstawową wiedzę o Comarch DMS i chcesz dowiedzieć się więcej?
Kontrolka typu Liczba rzeczywista – przykłady definicji kontrolki za pomocą C#
Uwaga
Przed kompilacją skryptów C# na komputerze z IIS należy nadać użytkownikowi IIS_IUSRS prawo zapisu do katalogu .scriptcs_cache
Uwaga
Należy pamiętać, aby na zakładce „Schemat obiegu” na etapie, na którym ma się odbyć inicjalizacja, na zakładce „Kontrolki” zaznaczyć parametr „Inicjalizacja SQL/C#” przy danej kontrolce i aby zapisać wszystkie wprowadzone zmiany za pomocą przycisku [Zapisz] .
Właściwość: Value
Opis: Właściwość umożliwia odczytanie i ustawienie wartości kontrolki.
Uwaga
Zakres wartości zmiennej należy do przedziału od: -3.4 x 1038 do: + 3.4 x 1038
Definicja: Globals.MainFrame.<identyfikator kontrolki typu liczba rzeczywista>.Value
Typ: float?
Dostęp: Odczyt/Zapis
Przyklad
Zainicjowanie wybraną liczbą kontrolki typu Liczba rzeczywista:
Globals.MainFrame.Real1.Value = (float)5876.47;
Zainicjowanie kontrolki aktualną datą przedstawiono w poniższych filmach:
Film
Wprowadzanie kodu i kompilacja:
Dodawanie nowego dokumentu – w kontrolce „Liczba rzeczywista” widoczna jest liczba zainicjowana za pomocą C#:
Rozpoczynasz pracę z Comarch DMS i chcesz dowiedzieć się, jak korzystać z programu? A może masz już podstawową wiedzę o Comarch DMS i chcesz dowiedzieć się więcej?
Kontrolka typu Liczba stałoprzecinkowa – przykłady definicji kontrolki za pomocą C#
Uwaga
Przed kompilacją skryptów C# na komputerze z IIS należy nadać użytkownikowi IIS_IUSRS prawo zapisu do katalogu .scriptcs_cache
Uwaga
Należy pamiętać, aby na zakładce „Schemat obiegu” na etapie, na którym ma się odbyć inicjalizacja, na zakładce „Kontrolki” zaznaczyć parametr „Inicjalizacja SQL/C#” przy danej kontrolce i aby zapisać wszystkie wprowadzone zmiany za pomocą przycisku [Zapisz] .
Właściwość: Value
Opis: Właściwość umożliwia odczytanie i ustawienie wartości kontrolki.
Uwaga
Typ stałoprzecinkowy zdefiniowany w kompilatorze DMS posiada 6 miejsc po przecinku.
Aby liczba wyświetlana była z 1,2,3,4,5 lub 6 miejscami po przecinku należy wybrać właściwą wartość na definicji kontrolki typu Liczba stałoprzecinkowa w ramach pola „Liczba miejsc po przecinku, do której będzie zaokrąglana wartość” i zapisać zmiany – domyślnie liczba jest zaokrąglana do dwóch miejsc po przecinku
Definicja: Globals.MainFrame.<identyfikator kontrolki typu liczba stałoprzecinkowa>.Value
Typ: decimal?
Dostęp: Odczyt/Zapis
Przyklad
Zainicjowanie kontrolki typu Liczba stałoprzecinkowa:
Zainicjowanie kontrolki wybraną liczbą przedstawiono w poniższych filmach (w polu: „Liczba miejsc po przecinku, do której będzie zaokrąglana wartość” wybrano wartość „6”):
Film
Wprowadzanie kodu i kompilacja:
Dodawanie nowego dokumentu – w kontrolce „Wartość 1” widoczna jest liczba zainicjowana za pomocą C#:
Rozpoczynasz pracę z Comarch DMS i chcesz dowiedzieć się, jak korzystać z programu? A może masz już podstawową wiedzę o Comarch DMS i chcesz dowiedzieć się więcej?
Kontrolka typu Lista – przykłady definicji kontrolki za pomocą C#
Uwaga
Należy pamiętać, aby na zakładce „Schemat obiegu” na etapie, na którym ma się odbyć inicjalizacja, na zakładce „Kontrolki” zaznaczyć parametr „Inicjalizacja SQL/C#” przy danej kontrolce i aby zapisać wszystkie wprowadzone zmiany za pomocą przycisku [Zapisz] .
Kontrolka „Lista” posiada identyfikatory numeryczne i tekstowe.
Rodzaj używanego identyfikatora zależy od właściwości „Rodzaj identyfikatora”, którą ustawia się na definicji danej kontrolki typu Lista.
Pole „Rodzaj identyfikatora” na definicji kontrolki typu Lista
Metoda: AddItem
Opis: Metoda umożliwia dodanie nowej pozycji w ramach kontrolki typu Lista.
1. Dla właściwości „Rodzaj identyfikatora” = Int
Definicja: byte Globals.MainFrame.<identyfikator kontrolki typu Lista>.AddItem (int, string)
Przyklad
Zainicjowanie kontrolki typu Lista (gdy „Rodzaj identyfikatora” = Int):
Zainicjowanie kontrolki wybranymi pozycjami przedstawiono w poniższych filmach:
Film
Wprowadzanie kodu i kompilacja:
Dodawanie nowego dokumentu – w kontrolce „Rodzaj transportu” po kliknięciu w kontrolkę widoczna jest lista zainicjowana za pomocą C#:
Zwracane wyniki:
0 – element został dodany do kolekcji
1 – identyfikator elementu już istnieje w kolekcji
2 – niewłaściwy typ identyfikatora dodawanej pozycji
3 – błąd dodawania pozycji
Metoda: Clear
Opis: Metoda usuwa wszystkie pozycje listy.
Definicja: void Globals.MainFrame.<identyfikator kontrolki typu Lista>.Clear()
Przyklad
Zainicjowanie kontrolki typu Lista – w poniższym przykładzie operator chce zachować w zapytaniu wcześniej dodane pozycje, ale nie powinny być dostępne na dokumencie – natomiast zamiast nich mają być wyświetlane dwie nowe pozycje – „Tramwaj” i „Samolot”:
Dodawanie nowego dokumentu – w kontrolce „Rodzaj transportu” widoczna jest lista zainicjowana za pomocą C# – pierwsze trzy pozycje listy z zapytania nie są dostępne, ponieważ zastosowano metodę „Clear”:
Metoda: SetSelectedItem
Opis: Metoda ustawia wskazaną pozycję w kontrolce lista.
1. Dla właściwości „Rodzaj identyfikatora” = Int
Definicja: byte Globals.MainFrame.<identyfikator kontrolki typu Lista>.SetSelectedItem (int)
Przyklad
Zainicjowanie kontrolki typu Lista (gdy „Rodzaj identyfikatora” = Int), a w kontrolce typu Lista ma być domyślnie wyświetlana wartość „Kurier”
Zainicjowanie kontrolki wybranymi pozycjami przedstawiono w poniższych filmach:
Film
Wprowadzanie kodu i kompilacja:
Dodawanie nowego dokumentu – w kontrolce „Sposób dostawy” po kliknięciu w kontrolkę widoczna jest lista zainicjowana za pomocą C# – z domyślnie wyświetlaną wartością „Kurier”:
2. Dla właściwości „Rodzaj identyfikatora” = Text
Definicja: byte Globals.MainFrame.<identyfikator kontrolki typu Lista>.SetSelectedItem(string)
Przyklad
Zainicjowanie kontrolki typu Lista (gdy „Rodzaj identyfikatora” = Text):
Zainicjowanie kontrolki wybranymi pozycjami przedstawiono w poniższych filmach:
Film
Wprowadzanie kodu i kompilacja:
Dodawanie nowego dokumentu – w kontrolce „Rodzaj transportu” po kliknięciu w kontrolkę widoczna jest lista zainicjowana za pomocą C# z domyślną wartością „Samochód”:
Zwracane wyniki:
0 – pozycja została ustawiona
1 – nie odnaleziono pozycji
2 – zastosowano argument niewłaściwego typu
Metoda: ClearSelectedItem
Opis: Metoda usuwa wybraną pozycję listy.
Definicja: void Globals.MainFrame.<identyfikator kontrolk typu Lista>.ClearSelectedItem()
Przyklad
Zainicjowanie kontrolki typu Lista (gdy „Rodzaj identyfikatora” = Text) – operator chce, aby na liście nie wyświetlano wybranej wcześniej wartości domyślnej, dlatego dodaje metodę ClearSelectedItem :
Zainicjowanie kontrolki wybranymi pozycjami przedstawiono w poniższych filmach:
Film
Wprowadzanie kodu i kompilacja:
Dodawanie nowego dokumentu – w kontrolce „Rodzaj transportu” po kliknięciu w kontrolkę widoczna jest lista zainicjowana za pomocą C# – bez wartości domyślnej :
Właściwość: SelectedText
Opis: Zwraca wprowadzoną przez użytkownika wartość wyszukiwania listy.
Konfiguracja zmiany wartości w kontrolce typu Tekst Nazwa pozycji wybranej w kontrolce „Sposób dostawy” (identyfikator: String2), gdy wybrano pozycję w kontrolce typu Lista Sposób dostawy (identyfikator: List1) :
Konfigurację kontrolki Nazwa pozycji wybranej w kontrolce „Sposób dostawy” i zmianę wartości tej kontrolki na nowym dokumencie przedstawiono w poniższych filmach:
Film
Wprowadzanie kodu i kompilacja:
Dodawanie nowego dokumentu – w kontrolce Nazwa pozycji wybranej w kontrolce „Sposób dostawy” wartość zmienia się zgodnie z wartością wybraną w kontrolce Sposób dostawy :
Rozpoczynasz pracę z Comarch DMS i chcesz dowiedzieć się, jak korzystać z programu? A może masz już podstawową wiedzę o Comarch DMS i chcesz dowiedzieć się więcej?
Kontrolka typu Tekst – przykłady definicji kontrolki za pomocą C#
Uwaga
Przed kompilacją skryptów C# na komputerze z IIS należy nadać użytkownikowi IIS_IUSRS prawo zapisu do katalogu .scriptcs_cache
Uwaga
Należy pamiętać, aby na zakładce „Schemat obiegu” na etapie, na którym ma się odbyć inicjalizacja, na zakładce „Kontrolki” zaznaczyć parametr „Inicjalizacja SQL/C#” przy danej kontrolce i aby zapisać wszystkie wprowadzone zmiany za pomocą przycisku [Zapisz] .
Właściwość: Text
Opis: Właściwość umożliwia odczytanie i ustawienie wartości kontrolki.
Definicja: Globals.MainFrame.<identyfikator kontrolki typu Tekst>.Text
Zainicjowanie kontrolki wybranym tekstem przedstawiono w poniższych filmach :
Film
Wprowadzanie kodu i kompilacja:
Dodawanie nowego dokumentu – w kontrolce „Numer dokumentu” widoczny jest tekst zainicjowany za pomocą C#:
Rozpoczynasz pracę z Comarch DMS i chcesz dowiedzieć się, jak korzystać z programu? A może masz już podstawową wiedzę o Comarch DMS i chcesz dowiedzieć się więcej?
Kontrolka typu Towar – przykłady definicji kontrolki za pomocą C#
Uwaga
Przed kompilacją skryptów C# na komputerze z IIS należy nadać użytkownikowi IIS_IUSRS prawo zapisu do katalogu .scriptcs_cache
Uwaga
Należy pamiętać, aby na zakładce „Schemat obiegu” na etapie, na którym ma się odbyć inicjalizacja, na zakładce „Kontrolki” zaznaczyć parametr „Inicjalizacja SQL/C#” przy danej kontrolce i aby zapisać wszystkie wprowadzone zmiany za pomocą przycisku [Zapisz] .
Kontrolka „Towar” posiada identyfikator numeryczny i tekstowy:
Jeżeli kontrolka współpracuje z systemem ERP: XL, Altum, Optima, domyślnie ustawiany jest identyfikator numeryczny (Id).
Jeżeli kontrolka współpracuje z systemem CEE używane są identyfikatory tekstowe (IdText).
Właściwość: Id
Opis: Właściwość umożliwia odczytanie i ustawienie numerycznego identyfikatora towaru dla systemów ERP: XL, Altum, Optima.
Definicja: Globals.MainFrame.<identyfikator kontrolki typu Towar>.Id
Typ: int?
Dostęp: Odczyt/Zapis
Przyklad
Zainicjowanie kontrolki typu Towar towarem o identyfikatorze 1 (w przypadku współpracy z Comarch ERP XL):
Globals.MainFrame. ERPArticle1.Id = 1;
Zainicjowanie kontrolki wybranymi pozycjami przedstawiono w poniższych filmach:
Film
Wprowadzanie kodu i kompilacja:
Dodawanie nowego dokumentu – w kontrolce „Towar” widoczny jest towar zainicjowany za pomocą C#:
Właściwość: IdText
Opis: Właściwość umożliwia odczytanie i ustawienie tekstowego identyfikatora towaru dla systemu CEE.
Definicja: Globals.MainFrame.<identyfikator kontrolki typu Towar>.IdText
Typ: String
Dostęp: Odczyt/Zapis
Przyklad
Zainicjowanie kontrolki typu Towar towarem o identyfikatorze (w przypadku współpracy z Comarch CEE):
Opis: Właściwość umożliwia odczytanie nazwy towaru ustawionego na kontrolce.
Definicja: Globals.MainFrame.<identyfikator kontrolki typu Towar>.Shortcut
Typ: String
Dostęp: Odczyt
Rozpoczynasz pracę z Comarch DMS i chcesz dowiedzieć się, jak korzystać z programu? A może masz już podstawową wiedzę o Comarch DMS i chcesz dowiedzieć się więcej?