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

Metoda:AddRow

Opis: Metoda umożliwia dodanie pustego wiersza do kontrolki tabelarycznej.
Definicja: void Globals.MainFrame.<identyfikator kontrolki typu Dane tabelaryczne>.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):

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

Metoda:AddRows

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

Przyklad

Zainicjowanie kontrolki typu Dane tabelaryczne z dodanym jednym pustym wierszem:

 Globals.MainFrame.Multiline1.AddRows(10);

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

Film

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

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

Metoda:Clear

- Opis: Metoda umożliwia usunięcie wszystkich wierszy z kontrolki typu Dane tabelaryczne.
- Definicja: void Globals.MainFrame.<identyfikator kontrolki typu Dane tabelaryczne>.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):

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

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.<identyfikator kontrolki typu Dane tabelaryczne>.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):

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:

Właściwość:Row

- Opis: Właściwość zwraca numer ostatnio edytowanego wiersza.

- Definicja: Globals.MainFrame.<identyfikator kontrolki typu Dane tabelaryczne>.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):

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

Metoda:RemoveRow

- Opis: Metoda umożliwia usunięcie wskazanego wiersza kontrolki tabelarycznej.

- Definicja: bool Globals.MainFrame.<identyfikator kontrolki typu Dane tabelaryczne>.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):

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):

Właściwość:RowCount

- Opis: Właściwość zwraca ilość wierszy znajdujących się w kontrolce tabelarycznej.

- Definicja: Globals.MainFrame.<identyfikator kontrolki typu Dane tabelaryczne>.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):

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”:

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.<identyfikator kontrolki typu Dane tabelaryczne>.Items[index].<Identyfikator danej kolumny>.<właściwość>

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.<identyfikator kontrolki typu Dane tabelaryczne>.Items[index].<identyfikator kolumny typu Data i godzina>.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.<identyfikator kontrolki typu Dane tabelaryczne>.Items[index].<identyfikator kolumny typu Dokument elektroniczny>.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.<identyfikator kontrolki typu Dane tabelaryczne>.Items[index].<identyfikator kolumny typu Dokument elektroniczny>.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.<identyfikator kontrolki typu Dane tabelaryczne>.Items[index].<identyfikator kolumny typu Dokument elektroniczny>.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.<identyfikator kontrolki typu Dane tabelaryczne>.Items[index].<identyfikator kolumny typu Dokument elektroniczny>.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.<identyfikator kontrolki typu Dane tabelaryczne>.Items[index].<identyfikator kolumny typu Dokument elektroniczny>.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.<identyfikator kontrolki typu Dane tabelaryczne>.Items[index].<identyfikator kolumny typu Dokumenty w obiegu>.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.<identyfikator kontrolki typu Dane tabelaryczne>.Items[index].<identyfikator kolumny typu Dokumenty w obiegu>.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.<identyfikator kontrolki typu Dane tabelaryczne>.Items[index].<identyfikator kolumny typu Kontrahent>.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.<identyfikator kontrolki typu Dane tabelaryczne>.Items[index].<identyfikator kolumny typu Kontrahent>.IdText
- Typ: string
- Dostęp: Odczyt/Zapis

Przykład:

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

- Opis: Odczytanie skrótu kontrahenta

- Definicja: Globals.MainFrame.<identyfikator kontrolki typu Dane tabelaryczne>.Items[index].<identyfikator kolumny typu Kontrahent>.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.<identyfikator kontrolki typu Dane tabelaryczne>.Items[index].<identyfikator kolumny typu Liczba całkowita>.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.<identyfikator kontrolki typu Dane tabelaryczne>.Items[index].<identyfikator kolumny typu Liczba rzeczywista>.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.<identyfikator kontrolki typu Dane tabelaryczne>.Items[index].<identyfikator kolumny typu Liczba stałoprzecinkowa>.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.<identyfikator kontrolki typu Dane tabelaryczne>.Items[index].<identyfikator kolumny typu Lista>.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.<identyfikator kontrolki typu Dane tabelaryczne>.Items[index].<identyfikator kolumny typu Lista>.ValueText
- Typ: string
- Dostęp: Odczyt/Zapis

Przykład:

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

- Opis: Odczytanie pozycji listy

- Definicja: Globals.MainFrame.<identyfikator kontrolki typu Dane tabelaryczne>.Items[index].<identyfikator kolumny typu Lista>.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.<identyfikator kontrolki typu Dane tabelaryczne>.Items[index].<identyfikator kolumny typu Tekst>.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.<identyfikator kontrolki typu Dane tabelaryczne>.Items[index].<identyfikator kolumny typu Towar>.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.<identyfikator kontrolki typu Dane tabelaryczne>.Items[index].<identyfikator kolumny typu Towar>.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.<identyfikator kontrolki typu Dane tabelaryczne>.Items[index].<identyfikator kolumny typu Towar>.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.<identyfikator kontrolki typu Dane tabelaryczne>.Items[index].<identyfikator kolumny typu Wartość logiczna>.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):

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