Kontrolka typu Dane tabelaryczne – przykłady definicji kontrolki za pomocą C#

Uwaga

Przed kompilacją skryptów C# na komputerze z IIS należy nadać użytkownikowi IIS_IUSRS prawozapisu 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 zapisz32 [Zapisz] .

Metoda:AddRow

Opis: Metoda umożliwia dodanie pustego wiersza do kontrolki tabelarycznej.
Definicja: void Globals.MainFrame..AddRow ()

Przyklad

Zainicjowanie kontrolki typu Dane tabelaryczne z dodanym jednym pustym wierszem:

 Globals.MainFrame.Multiline1.AddRow();

Zainicjowanie kontrolki wybraną pozycją przedstawiono w poniższych filmach:

Film

Wprowadzanie kodu i kompilacja (dla kontrolki „Tabela” (identyfikator: Multiline1):

https://pomoc.comarch.pl/dms/wp-content/uploads/2024/09/tabaddrow-1.mp4

Dodawanie nowego dokumentu – w kontrolce „Tabela” widoczny jest jeden pusty wiersz zainicjowany za pomocą C#:

https://pomoc.comarch.pl/dms/wp-content/uploads/2024/09/tabaddrow-2.mp4

Metoda:AddRows

- Opis: Metoda umożliwia dodanie wielu pustych wierszy do kontrolki typu Dane tabelaryczne.
Definicja: bool Globals.MainFrame..AddRows (int)
Zwracane wyniki:
- true -wiersze zostały dodane
- false – błąd

Przyklad

Zainicjowanie kontrolki typu Dane tabelaryczne z 10 dodanymi pustymi wierszami:

 Globals.MainFrame.Multiline1.AddRows(10);

Zainicjowanie kontrolki wybraną pozycją przedstawiono w poniższych filmach:

Film

Wprowadzanie kodu i kompilacja (dla kontrolki „Tabela” (identyfikator: Multiline1):

https://pomoc.comarch.pl/dms/wp-content/uploads/2024/09/tabaddrows-1.mp4

Dodawanie nowego dokumentu – w kontrolce „Tabela” widoczne jest 10 pustych wierszy zainicjowanych za pomocą C#:

https://pomoc.comarch.pl/dms/wp-content/uploads/2024/09/tabaddrows-2.mp4

Metoda:Clear

- Opis: Metoda umożliwia usunięcie wszystkich wierszy z kontrolki typu Dane tabelaryczne.
Definicja: void Globals.MainFrame..Clear()

Przyklad

Zainicjowanie kontrolki typu Dane tabelaryczne:

 Globals.MainFrame.Multiline1.Clear();

Zainicjowanie kontrolki wybraną pozycją przedstawiono w poniższych filmach:

Film

Wprowadzanie kodu i kompilacja (dla kontrolki „Tabela” (identyfikator: Multiline1):

https://pomoc.comarch.pl/dms/wp-content/uploads/2024/09/tabclear-1.mp4

Dodawanie nowego dokumentu – w kontrolce „Tabela” nie jest widoczne 10 pustych wierszy:

https://pomoc.comarch.pl/dms/wp-content/uploads/2024/09/tabclear-2.mp4

Właściwość:Column

- Opis: W przypadku edycji kontrolki tabelarycznej właściwość „Column” zwraca numer ostatnio modyfikowanej kolumny. W przypadku dodania nowego wiersza zwraca wartość -1, usunięcia wiersza zwraca wartość -2.
- Definicja: Globals.MainFrame..Column
Typ: int
Dostęp: Odczyt

Przyklad

Konfiguracja kontrolki typu Liczba całkowita, w której zostanie wyświetlona wartość dotycząca ostatniej modyfikacji kolumny (-1 – dodanie nowego wiersza, -2 – usunięcie wiersza):

 Globals.MainFrame.Int1.Value = Globals.MainFrame.Multiline1.Column;

Zainicjowanie kontrolki wybraną pozycją przedstawiono w poniższych filmach:

Film

Wprowadzanie kodu i kompilacja (dla kontrolki „Tabela” (identyfikator: Multiline1) i kontrolki „Numer ostatnio modyfikowanej kolumny” (identyfikator: Int1):

https://pomoc.comarch.pl/dms/wp-content/uploads/2024/09/tabcolumn-1.mp4

Dodawanie nowego dokumentu – w kontrolce „Numer ostatnio modyfikowanej kolumny” widoczne jest -1, gdy ostatnio dodano nowy wiersz w kontrolce „Tabela” lub -2, gdy ostatnio usunięto wiersz:

https://pomoc.comarch.pl/dms/wp-content/uploads/2024/09/tabcolumn-2.mp4

Właściwość:Row

- Opis: Właściwość zwraca numer ostatnio edytowanego wiersza.
- Definicja: Globals.MainFrame..Row
Typ: int
Dostęp: Odczyt

Przyklad

Konfiguracja kontrolki typu Liczba całkowita, w której zostanie wyświetlony numer ostatnio modyfikowanego wiersza:

 Globals.MainFrame.Int2.Value = Globals.MainFrame.Multiline1.Row;

Film

Wprowadzanie kodu i kompilacja (dla kontrolki „Tabela” (identyfikator: Multiline1) i kontrolki „Numer ostatnio edytowanego wiersza” (identyfikator: Int2):

https://pomoc.comarch.pl/dms/wp-content/uploads/2024/09/tabrow-1.mp4

Dodawanie nowego dokumentu – w kontrolce „Numer ostatnio edytowanego wiersza” widoczny jest numer wiersza, w którym ostatnio dokonano zmiany:

https://pomoc.comarch.pl/dms/wp-content/uploads/2024/09/tabrow2.mp4

Metoda:RemoveRow

- Opis: Metoda umożliwia usunięcie wskazanego wiersza kontrolki tabelarycznej.
- Definicja: bool Globals.MainFrame..RemoveRow(int)
Zwracane wyniki:
- true – wiersze zostału usunięte
- false – błąd

Przyklad

Konfiguracja kontrolki typu Dane tabelaryczne:

 Globals.MainFrame.Multiline1.RemoveRow(3);

Film

Wprowadzanie kodu i kompilacja (na zakładce „Schemat obiegu” ustawiono inicjalizację kontrolki na etapie 2):

https://pomoc.comarch.pl/dms/wp-content/uploads/2024/09/tabremove-1.mp4

Przekazywanie dokumentu do kolejnego etapu – w kontrolce „Tabela” zostaje usunięty wiersz 3 (nalezy pamiętać, że numery wierszy liczone są od 0 – a zatem wiersz 3 to wiersz oznaczony w tabeli numerem 4):

https://pomoc.comarch.pl/dms/wp-content/uploads/2024/09/tabremove-2.mp4

Właściwość:RowCount

- Opis: Właściwość zwraca ilość wierszy znajdujących się w kontrolce tabelarycznej.
- Definicja: Globals.MainFrame..RowCount
Typ: int
Dostęp: Odczyt

Przyklad

Konfiguracja kontrolki typu Liczba całkowita „Liczba wierszy” (identyfikator: Int1), gdy kontrolka typu Dane tabelaryczne „Tabela” ma identyfikator Multiline1:

Globals.MainFrame.Int1.Value = Globals.MainFrame.Multiline1.RowCount;

Film

Wprowadzanie kodu i kompilacja (w ramach konfiguracji kontrolki typu Liczba całkowita „Liczba wierszy” (identyfikator: Int1) i gdy kontrolka typu Dane tabelaryczne „Tabela” ma identyfikator Multiline1):

https://pomoc.comarch.pl/dms/wp-content/uploads/2024/09/tabrowcount-1.mp4

Dodawanie nowego dokumentu – w kontrolce typu Liczba całkowita „Liczba wierszy” widoczna jest aktualna liczba wierszy znajdujących się w kontrolce typu Dane tabelaryczne „Tabela”:

https://pomoc.comarch.pl/dms/wp-content/uploads/2024/09/tabrowcount-2-1.mp4

Dostęp do wartości komórek kontrolki „Dane tabelaryczne”

Dostęp do wartości komórki w kontrolce „Dane tabelaryczne” realizowany jest w oparciu o poniższą definicję:

Globals.MainFrame..Items[index]..

Gdzie „index” to numer wiersza liczony od 0 (0 – pierwszy wiersz, 1 – drugi wiersz, …).

Definicje wartości komórek w zależności od typu kolumny

Aby sprawdzić definicje wartości dla danego typu kolumny, kliknij w jej nazwę poniżej i sprawdź informacje wyświetlane po prawej stronie:

Data i godzinaDokument elektronicznyDokumenty w obieguKontrahentLiczba całkowitaLiczba rzeczywistaLiczba stałoprzecinkowaListaTekstTowarWartość logiczna

- Opis: Ustawienie/odczytanie daty.
- Definicja: Globals.MainFrame..Items[index]..Value
Typ: DateTime?
Dostęp: Zapis/Odczyt

Przykład:

 Globals.MainFrame.Multiline1.Items[0].DateTime1.Value = DateTime.Now;

- Opis: Ustawienie/odczytanie numerycznego identyfikatora dokumentu elektronicznego
- Definicja: Globals.MainFrame..Items[index]..Id
Typ: int?
Dostęp: Zapis/Odczyt

Przykład:

 Globals.MainFrame.Multiline1.Items[0].ERPDocument1.Id = 5024;

- Opis: Ustawienie/odczytanie numerycznego identyfikatora typu dokumentu elektronicznego
- Definicja: Globals.MainFrame..Items[index]..IdType
Typ: int?
Dostęp: Zapis/Odczyt

Przykład:

 Globals.MainFrame.Multiline1.Items[0].ERPDocument1.IdType = 1521;

- Opis: Ustawienie/odczytanie tekstowego identyfikatora dokumentu elektronicznego
- Definicja: Globals.MainFrame..Items[index]..IdText
Typ: string
Dostęp: Zapis/Odczyt

Przykład:

 Globals.MainFrame.Multiline1.Items[0].ERPDocument1.IdText = "E97B3CE0-F719-44CD-A473-54A59ABF20D5";

- Opis: Ustawienie/odczytanie tekstowego identyfikatora typu dokumentu elektronicznego
- Definicja: Globals.MainFrame..Items[index]..IdTextType
Typ: string
Dostęp: Zapis/Odczyt

Przykład:

 Globals.MainFrame.Multiline1.Items[0].ERPDocument1.IdTextType = "3EEC4A14-8263-4196-B721-CE7A61C12F45";

- Opis: Ustawienie/odczytanie numeru dokumentu elektronicznego
- Definicja: Globals.MainFrame..Items[index]..Number
Typ: string
Dostęp: Odczyt

Przykład:

 Globals.MainFrame.Multiline1.Items[0].ERPDocument1.Number;

- Opis: Ustawienie/odczytanie numerycznego identyfikatora dokumentu w obiegu
- Definicja: Globals.MainFrame..Items[index]..Id
Typ: int?
Dostęp: Zapis/Odczyt

Przykład:

 Globals.MainFrame.Multiline1.Items[0].WorkflowDocuments1.Id = 2;

- Opis: Odczytanie numeru dokumentu w obiegu
- Definicja: Globals.MainFrame..Items[index]..Number
Typ: String
Dostęp: Odczyt

Przykład:

 Globals.MainFrame.Multiline1.Items[0].WorkflowDocuments1.Number;

- Opis: Ustawienie/odczytanie numerycznego identyfikatora dokumentu w obiegu
- Definicja: Globals.MainFrame..Items[index]..Id
Typ: int?
Dostęp: Odczyt/Zapis

Przykład:

 Globals.MainFrame.Multiline1.Items[0].ERPContractor1.Id = 1;

- Opis: Ustawienie/odczytanie tekstowego identyfikatora kontrahenta
- Definicja: Globals.MainFrame..Items[index]..IdText
Typ: string
Dostęp: Odczyt/Zapis

Przykład:

 Globals.MainFrame.Multiline1.Items[0].ERPContractor1.IdText;

- Opis: Odczytanie skrótu kontrahenta
- Definicja: Globals.MainFrame..Items[index]..Shortcut
Typ: string
Dostęp: Odczyt

Przykład:

 Globals.MainFrame.Multiline1.Items[0].ERPContractor1.Shortcut;

- Opis: Ustawienie/odczytanie wartości komórki
- Definicja: Globals.MainFrame..Items[index]..Value
Typ: int?
Dostęp: Odczyt/Zapis

Przykład:

 Globals.MainFrame.Multiline1.Items[0].Int2.Value = 16;

- Opis: Ustawienie/odczytanie wartości komórki
- Definicja: Globals.MainFrame..Items[index]..Value
Typ: float?
Dostęp: Odczyt/Zapis

Przykład:

 Globals.MainFrame.Multiline1.Items[0].Real1.Value = (float)124.57;

- Opis: Ustawienie/odczytanie wartości komórki

Uwaga

Typ stałoprzecinkowy zdefiniowany w kompilatorze DMS posiada 6 miejsc po przecinku.

- Definicja: Globals.MainFrame..Items[index]..Value
Typ: decimal?
Dostęp: Odczyt/Zapis

Przykład:

Globals.MainFrame.Multiline1.Items[0].Decimal1.Value = (decimal)25.36;

- Opis: Ustawienie/odczytanie numerycznego identyfikatora pozycji listy
- Definicja: Globals.MainFrame..Items[index]..Value
Typ: int?
Dostęp: Odczyt/Zapis

Przykład:

 Globals.MainFrame.Multiline1.Items[0].List1.Value = 3;

- Opis: Ustawienie/odczytanie tekstowego identyfikatora pozycji listy
- Definicja: Globals.MainFrame..Items[index]..ValueText
Typ: string
Dostęp: Odczyt/Zapis

Przykład:

Globals.MainFrame.Multiline1.Items[0].List1.ValueText = "prz";

- Opis: Odczytanie pozycji listy
- Definicja: Globals.MainFrame..Items[index]..Text
Typ: string
Dostęp: Odczyt

Przykład:

 Globals.MainFrame.Multiline1.Items[0].List1.Text;

- Opis: Ustawienie/odczytanie wartości tekstowej komórki
- Definicja: Globals.MainFrame..Items[index]..Text
Typ: string
Dostęp: Odczyt/Zapis

Przykład:

Globals.MainFrame.Multiline1.Items[0].String3.Text = "Faktura zakupu";

- Opis: Ustawienie/odczytanie numerycznego identyfikatora towaru
- Definicja: Globals.MainFrame..Items[index]..Id
Typ: int?
Dostęp: Odczyt/Zapis

Przykład:

 Globals.MainFrame.Multiline1.Items[0].ERPArticle1.Id = 1;

- Opis: Ustawienie/odczytanie numerycznego identyfikatora towaru
- Definicja: Globals.MainFrame..Items[index]..IdText
Typ: string
Dostęp: Odczyt/Zapis

Przykład:

Globals.MainFrame.Multiline1.Items[0].ERPArticle1.IdText;

- Opis: Ustawienie/odczytanie numerycznego identyfikatora towaru
- Definicja: Globals.MainFrame..Items[index]..Shortcut
Typ: string
Dostęp: Odczyt

Przykład:

 Globals.MainFrame.Multiline1.Items[0].ERPArticle1.Shortcut;

- Opis: Ustawienie/odczytanie wartości komórki
- Definicja: Globals.MainFrame..Items[index]..Value
Typ: bool
Dostęp: Odczyt/Zapis

Przykład:

 Globals.MainFrame.Multiline1.Items[0].Bool1.Value = true;

Przyklad

Inicjowanie kontrolki typu Dane tabelaryczne za pomocą kodu C# – przykładowe uzupełnienie pierwszego wiersza (pierwszy wiersz = index 0)

Globals.MainFrame.Multiline1.AddRows(3);
Globals.MainFrame.Multiline1.Items[0].DateTime1.Value = DateTime.Now;
Globals.MainFrame.Multiline1.Items[0].ERPContractor1.Id = 1;
Globals.MainFrame.Multiline1.Items[0].String1.Text = "FZ-2/2024";
Globals.MainFrame.Multiline1.Items[0].ERPDocument1.Id = 5024;
Globals.MainFrame.Multiline1.Items[0].Int1.Value = Globals.MainFrame.Multiline1.Items[0].ERPDocument1.IdType = 1521;
Globals.MainFrame.Multiline1.Items[0].WorkflowDocuments1.Id = 2;
Globals.MainFrame.Multiline1.Items[0].String2.Text = Globals.MainFrame.Multiline1.Items[0].WorkflowDocuments1.Number;
Globals.MainFrame.Multiline1.Items[0].Int2.Value = 16;
Globals.MainFrame.Multiline1.Items[0].Real1.Value = (float)124.57;
Globals.MainFrame.Multiline1.Items[0].Decimal1.Value = (decimal)25.36;
Globals.MainFrame.Multiline1.Items[0].List1.ValueText = "prz";
Globals.MainFrame.Multiline1.Items[0].String3.Text = "Faktura zakupu";
Globals.MainFrame.Multiline1.Items[0].ERPArticle1.Id = 1;
Globals.MainFrame.Multiline1.Items[0].Bool1.Value = true;

Film

Wprowadzanie kodu i kompilacja (dla kontrolki „Tabela” (identyfikator: Multiline1):

https://pomoc.comarch.pl/dms/wp-content/uploads/2024/09/inicj-tab-1.mp4

Pierwszy wiersz zainicjowany w kontrolce typu Dane tabelaryczne „Tabela” na dokumencie Comarch DMS za pomocą kodu 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?

Sprawdź Szkolenia Comarch DMS!

Powrót do początku artykułu