Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Polish

Serwis VariableSetService pozwala zarządzać tabelami dynamicznymi oraz zmiennymi znajdującymi się w tych tabelach. Posiada następujące funkcje:

  • get - pobiera komponent tabeli dynamicznej.
    • Parametry funkcji

      NazwaTyp

      Wartość domyślna

      Opis
      variableSetIdParamString/NumbernullIdentyfikator tabeli dynamicznej/Numer tabeli dynamicznej na formularzu zgodnie z mapą procesu (pierwsza tabela ma numer 0)


    • Rezultat funkcji:

      TypOpis
      Suncode.form.view.gadget.variableset.VariableSetKomponent tabeli dynamicznej lub undefined, jeśli nie znaleziono



  • getAll - zwraca wszystkie komponenty tabel dynamicznych.
    • Parametry funkcji

      NazwaTyp

      Wartość domyślna

      Opis
      getEditableBooleanfalseInformacja, czy zwracac tylko edytowalne tabele dynamiczne


    • Rezultat funkcji:

      TypOpis
      Suncode.form.view.gadget.variableset.VariableSet[]Tablica komponentów tabel dynamicznych lub pusta tablica, jeśli nie znaleziono żadnej tabeli
  • hide - ukrywa tabele dynamiczne
    • Parametry funkcji

      NazwaTyp

      Wartość domyślna

      Opis
      variablesString/Number/String[],Number[]nullIdentyfikator/tablica identyfikatorów tabel dynamicznych lub numer(indeks)/tablica numerów tabel dynamicznych. Numer określa indeks tabeli dynamicznej na formularzu, dla numeru 0 jest to pierwsza tabela zadania, itd. Podając tablicę można mieszać typy, czyli można podać tablicę: [ 'id_tabeli_1', 3 ], co ukryje tabelę o id: 'id_tabeli_1' oraz tabelę, która jest czwarta w kolejności na formularzu.


    • Rezultat funkcji: brak

 

  • show - pokazuje tabele dynamiczne
    • Parametry funkcji

      NazwaTyp

      Wartość domyślna

      Opis
      variablesString/Number/String[],Number[]nullIdentyfikator/tablica identyfikatorów tabel dynamicznych lub numer(indeks)/tablica numerów tabel dynamicznych. Numer określa indeks tabeli dynamicznej na formularzu, dla numeru 0 jest to pierwsza tabela zadania, itd. Podając tablicę można mieszać typy, czyli można podać tablicę:  [ 'id_tabeli_1', 3 ], co pokaże tabelę o id: 'id_tabeli_1' oraz tabelę, która jest czwarta w kolejności na formularzu.


    • Rezultat funkcji: brak

 

  • addRow - dodaje pusty rekord do tabeli dynamicznej. Możliwe jest rozpoczęcie edycji pierwszej edytowalnej komórki nowo dodanego rekordu.
    • Parametry funkcji

      NazwaTyp

      Wartość domyślna

      Opis
      variableSetSuncode.form.view.gadget.variableset.VariableSetnull

      Komponent tabeli dynamicznej

      startEditingBooleanfalseInformuje, czy rozpocząć edycję pierwszej edytowalnej komórki nowo dodanego rekordu
      recordsObject/Object[]{}Wartości w nowym wierszu postaci { id_kolumny1 : "wartosc_1", id_kolumny2 : "wartosc_2" }.
      Możliwe jest podanie także tablicy rekordów w powyższej postaci, co spowoduje dodanie kilku wierszy do tabeli dynamicznej.


    • Rezultat funkcji: brak

 

  • insertRow - wstawia pusty rekord do tabeli dynamicznej na podanej pozycji. Możliwe jest rozpoczęcie edycji pierwszej edytowalnej komórki nowo dodanego rekordu.
    • Parametry funkcji

      NazwaTyp

      Wartość domyślna

      Opis
      variableSetSuncode.form.view.gadget.variableset.VariableSetnull

      Komponent tabeli dynamicznej

      indexNumberbrakNumer wiersza od którego wstawione zostaną nowe wiersze. Numer musi być większy lub równy 0.
      startEditingBooleanfalseInformuje, czy rozpocząć edycję pierwszej edytowalnej komórki nowo wstawionego rekordu
      recordsObject/Object[]{}Wartości we wstawionym wierszu postaci { id_kolumny1 : "wartosc_1", id_kolumny2 : "wartosc_2" }.
      Możliwe jest podanie także tablicy rekordów w powyższej postaci, co spowoduje dodanie kilku wierszy do tabeli dynamicznej.


    • Rezultat funkcji: brak

 

  • getSelected - pobiera aktualnie zaznaczony rekord w tabeli dynamicznej, zwraca null, gdy żaden rekord nie jest aktualnie zaznaczony.
    • Parametry funkcji

      NazwaTyp

      Wartość domyślna

      Opis
      variableSetSuncode.form.view.gadget.variableset.VariableSetnullKomponent tabeli dynamicznej


    • Rezultat funkcji:

      TypOpis
      Ext.data.ModelAktualnie zaznaczony rekord
  • deleteSelected - usuwa wszystkie zaznaczone rekordy w tabeli dynamicznej.
    • Parametry funkcji

      NazwaTyp

      Wartość domyślna

      Opis
      variableSetSuncode.form.view.gadget.variableset.VariableSetnullKomponent tabeli dynamicznej


    • Rezultat funkcji: brak

 

  • copySelected - kopiuje wszystkie zaznaczone rekordy w tabeli dynamicznej.
    • Parametry funkcji

      NazwaTyp

      Wartość domyślna

      Opis
      variableSetSuncode.form.view.gadget.variableset.VariableSetnullKomponent tabeli dynamicznej


    • Rezultat funkcji: brak


  • getRowIndex - zwraca numer wiersza dla danego rekordu.
    • Parametry funkcji

      NazwaTyp

      Wartość domyślna

      Opis
      variableSetSuncode.form.view.gadget.variableset.VariableSetnullKomponent tabeli dynamicznej
      recordExt.data.ModelnullObiekt rekordu tabeli dynamicznej


       

    • Rezultat funkcji:

      TypOpis
      IntegerNumer wiersza
  • getColumnIndex - zwraca numer kolumny dla danej zmiennej formularza.
    • Parametry funkcji

      NazwaTyp

      Wartość domyślna

      Opis
      variableSetSuncode.form.view.gadget.variableset.VariableSetnullKomponent tabeli dynamicznej
      variableIdStringnullIdentyfikator zmiennej formularza (identyfikator zmiennej procesu) znajdującej się w tabeli dynamicznej


    • Rezultat funkcji:

      TypOpis
      IntegerNumer kolumny
  • getValue - zwraca wartość zmiennej formularza w konkretnej komórce w tabeli dynamicznej lub ciąg wartości ze wszystkich komórek w danej kolumnie (od 3.1.8).
    • Parametry funkcji

      NazwaTyp

      Wartość domyślna

      Opis
      variableSetSuncode.form.view.gadget.variableset.VariableSetnullKomponent tabeli dynamicznej
      rowIndexIntegernullNumer wiersza rekordu (pierwszy wiersz ma numer 0). W przypadku podania null, zwracany jest ciąg wartości ze wszystkich komórek w danej kolumnie. Kolejne wartości są rozdzielone znakiem średnika (od 3.1.8)
      variableIdStringnullIdentyfikator zmiennej formularza (identyfikator zmiennej procesu) znajdującej się w tabeli dynamicznej


       

    • Rezultat funkcji:

      TypOpis
      ObjectWartość zmiennej w komórce
  • setValue - ustawia wartość zmiennej formularza w konkretnej komórce w tabeli dynamicznej lub ciąg wartości we wszystkich komórkach w danej kolumnie (jeżeli ciąg wartości jest dłuższy, niż ilość rekordów w tabeli dynamicznej, to dodawane są nowe rekordy z pustymi wartościami dla innych komórek, jeżeli ciąg wartości jest krótszy, niż ilość rekordów w tabeli dynamicznej, to w pozostałych rekordach w danej kolumnie ustawiana jest pusta wartość) (od 3.1.8).
    • Parametry funkcji

      NazwaTyp

      Wartość domyślna

      Opis
      variableSetSuncode.form.view.gadget.variableset.VariableSetnullKomponent tabeli dynamicznej
      rowIndexIntegernullNumer wiersza rekordu (pierwszy wiersz ma numer 0). W przypadku podania null, ustawiany jest ciąg wartości we wszystkich komórkach w danej kolumnie. Kolejne wartości powinny być rozdzielone znakiem średnika (od 3.1.8)
      variableIdStringnullIdentyfikator zmiennej formularza (identyfikator zmiennej procesu) znajdującej się w tabeli dynamicznej
      valueObjectnullWartość zmiennej formularza


    • Rezultat funkcji: brak


  • save - zapisuje rekordy tabeli dynamicznej do kontekstu zadania.
    • Parametry funkcji

      NazwaTyp

      Wartość domyślna

      Opis
      variableSetSuncode.form.view.gadget.variableset.VariableSetnullKomponent tabeli dynamicznej


    • Rezultat funkcji: brak

  • markErrorCell - zaznacza komórkę w tabeli dynamicznej jako błędna (czerwone tło).
    • Parametry funkcji

      NazwaTyp

      Wartość domyślna

      Opis
      variableSetSuncode.form.view.gadget.variableset.VariableSetnullKomponent tabeli dynamicznej
      rowIndexIntegernullNumer wiersza rekordu (pierwszy wiersz ma numer 0)
      variableIdStringnullIdentyfikator zmiennej formularza (identyfikator zmiennej procesu) znajdującej się w tabeli dynamicznej


      Rezultat funkcji: brak

       

  • unmarkErrorCell - odznacza komórkę w tabeli dynamicznej jako błędną (usuwa czerwone tło).
    • Parametry funkcji

      NazwaTyp

      Wartość domyślna

      Opis
      variableSetSuncode.form.view.gadget.variableset.VariableSetnullKomponent tabeli dynamicznej
      rowIndexIntegernullNumer wiersza rekordu (pierwszy wiersz ma numer 0)
      variableIdStringnullIdentyfikator zmiennej formularza (identyfikator zmiennej procesu) znajdującej się w tabeli dynamicznej


       

    • Rezultat funkcji: brak

       

  • getVariableSetData - zwraca wszystkie zmienne formularza we wszystkich rekordach tabeli dynamicznej w formie JSON.

     

    • Parametry funkcji

      NazwaTyp

      Wartość domyślna

      Opis
      variableSetSuncode.form.view.gadget.variableset.VariableSetnullKomponent tabeli dynamicznej


       

    • Rezultat funkcji:

      TypOpis
      StringZawartość tabeli w formie JSON

       

       

  • getRowsCount - zwraca ilość wierszy w tabeli dynamicznej.

    • Parametry funkcji

      NazwaTyp

      Wartość domyślna

      Opis
      variableSetSuncode.form.view.gadget.variableset.VariableSetnullKomponent tabeli dynamicznej


    • Rezultat funkcji:

      TypOpis
      IntegerIlość wierszy w tabeli dynamicznej
  • getColumnSum - zwraca sumę wartości z danej kolumny.

    • Parametry funkcji

      NazwaTyp

      Wartość domyślna

      Opis
      variableSetSuncode.form.view.gadget.variableset.VariableSetnullKomponent tabeli dynamicznej
      variableIdStringnullZmienna procesu identyfikująca kolumnę w tabeli dynamicznej
      groupedBooleanfalseInformuje, czy zwracać rezultat w postaci obiektu zawierającego sumę z poszczególnych grup
      (ma znaczenie tylko, gdy tabela dynamiczna ma aktywną opcję grupowania)


    • Rezultat funkcji:

      TypOpis
      Integer/StringSumę wartości z danej kolumny (typ String występuje, gdy suma została wykonana na kolumnie, która zawiera wartości tekstowe - rezultatem jest ciąg znaków)
  • setTitle - ustawia tytuł.

    • Parametry funkcji

      NazwaTyp

      Wartość domyślna

      Opis
      variableSetSuncode.form.view.gadget.variableset.VariableSetnullKomponent tabeli dynamicznej
      titleStringnullTytuł (możliwe jest podawanie tagów HTML)


    • Rezultat funkcji: brak

  • removeBottomToolbarButtons - usuwa wszystkie przyciski z dolnej belki oraz ukrywa ją. Dodawanie rekordów za pomocą klawiatury jest możliwe tylko w przypadku, gdy przycisk dodawania, wstawiania lub kopiowania jest dostępny, widoczny i niezablokowany. Usuwanie rekordów za pomocą klawiatury jest możliwe tylko w przypadku, gdy przycisk usuwania jest dostępny, widoczny i niezablokowany.

    • Parametry funkcji

      NazwaTyp

      Wartość domyślna

      Opis
      variableSetSuncode.form.view.gadget.variableset.VariableSetnullKomponent tabeli dynamicznej


    • Rezultat funkcji:brak

  • removeBottomToolbarButton - usuwa określony przycisk z dolnej belki oraz ukrywa ją, gdy przycisk był ostatnim dostępnym na belce. Dodawanie rekordów za pomocą klawiatury jest możliwe tylko w przypadku, gdy przycisk dodawania, wstawiania lub kopiowania jest dostępny, widoczny i niezablokowany. Usuwanie rekordów za pomocą klawiatury jest możliwe tylko w przypadku, gdy przycisk usuwania jest dostępny, widoczny i niezablokowany.

    • Parametry funkcji

      NazwaTyp

      Wartość domyślna

      Opis
      variableSetSuncode.form.view.gadget.variableset.VariableSetnullKomponent tabeli dynamicznej
      itemIdStringnullIdentyfikator przycisku na belce. Oczekiwane wartości to:
      - add - przycisk dodawania wiersza
      - insert
      - przycisk wstawiania wiersza
      - delete - przycisk usuwania wiersza
      - copy - przycisk kopiowania wiersza
      - dowolne id, będące id przycisku DT_BUTTON podanego w mapie


    • Rezultat funkcji:brak


     

     

  • disableBottomToolbarButtons - blokuje wszystkie przyciski z dolnej belki. Dodawanie rekordów za pomocą klawiatury jest możliwe tylko w przypadku, gdy przycisk dodawania, wstawiania lub kopiowania jest dostępny, widoczny i niezablokowany. Usuwanie rekordów za pomocą klawiatury jest możliwe tylko w przypadku, gdy przycisk usuwania jest dostępny, widoczny i niezablokowany.

    • Parametry funkcji

      NazwaTyp

      Wartość domyślna

      Opis
      variableSetSuncode.form.view.gadget.variableset.VariableSetnullKomponent tabeli dynamicznej


    • Rezultat funkcji:brak


     

     

  • disableBottomToolbarButton - blokuje określony przycisk z dolnej belki. Dodawanie rekordów za pomocą klawiatury jest możliwe tylko w przypadku, gdy przycisk dodawania, wstawiania lub kopiowania jest dostępny, widoczny i niezablokowany. Usuwanie rekordów za pomocą klawiatury jest możliwe tylko w przypadku, gdy przycisk usuwania jest dostępny, widoczny i niezablokowany.

    • Parametry funkcji

      NazwaTyp

      Wartość domyślna

      Opis
      variableSetSuncode.form.view.gadget.variableset.VariableSetnullKomponent tabeli dynamicznej
      itemIdStringnullIdentyfikator przycisku na belce. Oczekiwane wartości to:
      - add - przycisk dodawania wiersza
      - insert
      - przycisk wstawiania wiersza
      - delete - przycisk usuwania wiersza
      - copy - przycisk kopiowania wiersza
      - dowolne id, będące id przycisku DT_BUTTON podanego w mapie


    • Rezultat funkcji:brak


     

     

  • enableBottomToolbarButtons - aktywuje wszystkie przyciski z dolnej belki. Dodawanie rekordów za pomocą klawiatury jest możliwe tylko w przypadku, gdy przycisk dodawania, wstawiania lub kopiowania jest dostępny, widoczny i niezablokowany. Usuwanie rekordów za pomocą klawiatury jest możliwe tylko w przypadku, gdy przycisk usuwania jest dostępny, widoczny i niezablokowany.

    • Parametry funkcji

      NazwaTyp

      Wartość domyślna

      Opis
      variableSetSuncode.form.view.gadget.variableset.VariableSetnullKomponent tabeli dynamicznej


    • Rezultat funkcji:brak


     

     

  • enableBottomToolbarButton - aktywuje określony przycisk z dolnej belki. Dodawanie rekordów za pomocą klawiatury jest możliwe tylko w przypadku, gdy przycisk dodawania, wstawiania lub kopiowania jest dostępny, widoczny i niezablokowany. Usuwanie rekordów za pomocą klawiatury jest możliwe tylko w przypadku, gdy przycisk usuwania jest dostępny, widoczny i niezablokowany.

    • Parametry funkcji

      NazwaTyp

      Wartość domyślna

      Opis
      variableSetSuncode.form.view.gadget.variableset.VariableSetnullKomponent tabeli dynamicznej
      itemIdStringnullIdentyfikator przycisku na belce. Oczekiwane wartości to:
      - add - przycisk dodawania wiersza
      - insert
      - przycisk wstawiania wiersza
      - delete - przycisk usuwania wiersza
      - copy - przycisk kopiowania wiersza
      - dowolne id, będące id przycisku DT_BUTTON podanego w mapie


    • Rezultat funkcji:brak



     

  • addBottomToolbarButton - dodaje przycisk do dolnej belki.

    • Parametry funkcji

      NazwaTyp

      Wartość domyślna

      Opis
      variableSetSuncode.form.view.gadget.variableset.VariableSetnullKomponent tabeli dynamicznej
      buttonObject/Ext.button.ButtonnullObiekt konfiguracyjny przycisku (podawany do tworzenia Ext.button.Button)


    • Rezultat funkcji:brak



     

  • insertBottomToolbarButton - dodaje przycisk do dolnej belki na określonej pozycji.

    • Parametry funkcji

      NazwaTyp

      Wartość domyślna

      Opis
      variableSetSuncode.form.view.gadget.variableset.VariableSetnullKomponent tabeli dynamicznej
      buttonObject/Ext.button.ButtonnullObiekt konfiguracyjny przycisku (podawany do tworzenia Ext.button.Button)
      indexIntegernullPozycja, na które dodawany jest przycisk


    • Rezultat funkcji:brak


     

  • getRecordsByCriteria - wyszukuje rekordy w tabeli dynamicznej na podstawie podanych kryteriów (wartości w kolumnach, dokładność co do wartości i typu).

    • Parametry funkcji

      NazwaTyp

      Wartość domyślna

      Opis
      variableSetSuncode.form.view.gadget.variableset.VariableSetnullKomponent tabeli dynamicznej
      criteriaObject[][]Tablica obiektów kryteriów. Kryterium musi zawierać następujące właściwości:
      - id - identyfikator kolumny (zmienna procesu)
      - value - oczekiwana wartość


    • Rezultat funkcji:

      TypOpis
      Ext.data.Model[]Znalezione rekordy

     

  • deleteRecordsByCriteria - usuwa rekordy z tabeli dynamicznej na podstawie podanych kryteriów z dokładnością do typu (wartości w kolumnach, dokładność co do wartości i typu).

    • Parametry funkcji

      NazwaTyp

      Wartość domyślna

      Opis
      variableSetSuncode.form.view.gadget.variableset.VariableSetnullKomponent tabeli dynamicznej
      criteriaObject[][]Tablica obiektów kryteriów. Kryterium musi zawierać następujące właściwości:
      - id - identyfikator kolumny (zmienna procesu)
      - value - oczekiwana wartość


    • Rezultat funkcji:

      TypOpis
      IntegerIlość usuniętych rekordów



     

  • deleteRecords (od 3.1.8) - usuwa określone rekordy z tabeli dynamicznej.

    • Parametry funkcji

      NazwaTyp

      Wartość domyślna

      Opis
      variableSetSuncode.form.view.gadget.variableset.VariableSetnullKomponent tabeli dynamicznej
      recordsExt.data.Model[]nullTablica rekordów do usunięcia


    • Rezultat funkcji: brak

       

     

  • clear - usuwa wszystkie rekordy z tabeli dynamicznej.

    • Parametry funkcji

      NazwaTyp

      Wartość domyślna

      Opis
      variableSetSuncode.form.view.gadget.variableset.VariableSetnullKomponent tabeli dynamicznej
      silentBooleanfalseInformuje, czy podczas usuwania mają zostać wywołane akcje bulkremove and clear dla store'a


    • Rezultat funkcji: brak

 

  • showColumn - pokazuje kolumnę w tabeli dynamicznej.

    • Parametry funkcji

      NazwaTyp

      Wartość domyślna

      Opis
      variableSetSuncode.form.view.gadget.variableset.VariableSetnullKomponent tabeli dynamicznej
      variableIdStringnullZmienna procesu identyfikująca kolumnę w tabeli dynamicznej


    • Rezultat funkcji: brak

 

  • hideColumn - ukrywa kolumnę w tabeli dynamicznej.

    • Parametry funkcji

      NazwaTyp

      Wartość domyślna

      Opis
      variableSetSuncode.form.view.gadget.variableset.VariableSetnullKomponent tabeli dynamicznej
      variableIdStringnullZmienna procesu identyfikująca kolumnę w tabeli dynamicznej


    • Rezultat funkcji: brak

 

  • getColumnName - pobiera nazwę kolumny w tabeli dynamicznej z uwzględnieniem tłumaczenia (widoczną w nagłówku).
    • Parametry funkcji

      NazwaTyp

      Wartość domyślna

      Opis
      variableSetSuncode.form.view.gadget.variableset.VariableSetnullKomponent tabeli dynamicznej
      variableIdStringnullZmienna procesu identyfikująca kolumnę w tabeli dynamicznej


    • Rezultat funkcji:

      TypOpis
      StringNazwa kolumny w tabeli dynamicznej lub null, jeżeli kolumna o podanym identyfikatorze nie istnieje w tabeli


  • setColumnName - ustawia nazwę kolumny w tabeli dynamicznej (widoczną w nagłówku), zachowuje informację o opisie i wymagalności zmiennej.
    • Parametry funkcji

      NazwaTyp

      Wartość domyślna

      Opis
      variableSetSuncode.form.view.gadget.variableset.VariableSetnullKomponent tabeli dynamicznej
      variableIdStringnullZmienna procesu identyfikująca kolumnę w tabeli dynamicznej
      nameStringnullNazwa kolumny


    • Rezultat funkcji: brak



  • addTool - dodaje przycisk narzędzia do nagłówka tabeli dynamicznej.
    • Parametry funkcji

      NazwaTyp

      Wartość domyślna

      Opis
      variableSetSuncode.form.view.gadget.variableset.VariableSetnullKomponent tabeli dynamicznej
      toolObject/Ext.panel.ToolnullObiekt konfiguracyjny narzędzia (podawany do tworzenia Ext.panel.Tool)


    • Rezultat funkcji: brak



  • getTitle - zwraca tytuł tabeli dynamicznej bez tagów HTML.
    • Parametry funkcji

      NazwaTyp

      Wartość domyślna

      Opis
      variableSetSuncode.form.view.gadget.variableset.VariableSetnullKomponent tabeli dynamicznej


    • Rezultat funkcji:

      TypOpis
      StringTytuł tabeli dynamicznej bez tagów HTML
  • getInfo - zwraca informacje o tabeli dynamicznej.
    • Parametry funkcji

      NazwaTyp

      Wartość domyślna

      Opis
      variableSetSuncode.form.view.gadget.variableset.VariableSetnullKomponent tabeli dynamicznej

       

       

    • Rezultat funkcji

      TypOpis
      Object

      Obiekt zawierający informacje o tabeli dynamicznej. Obiekt posiada następujące właściwości:

          - id (Typ String)

            Identyfikator tabeli dynamicznej

          - originalName (Typ String)

             Oryginalny tytuł tabeli dynamicznej (właściowiść DT_TABLE_NAME z konfiguracji)

          - title (Typ String)

             Tytuł tabeli dynamicznej bez tagów HTML

          - columns (Typ Array)

             Tablica informacji o poszczególnych kolumnach. Każdy element jest typu Object i zawiera następujące właściwości:

              - id (Typ String)

                  Identyfikator zmiennej procesu

              - name (Typ String)

                  Nazwa kolumny tabeli dynamicznej (nazwa zmiennej procesu) z uwzględnieniem tłumaczenia (nazwa widoczna w nagłówku)

              - editable (Typ Boolean)

                  Informuje, czy kolumna jest edytowalna

              - hidden (Typ Boolean)

                  Informuje, czy kolumna jest ukryta

       

       

  • addRenderer (od 3.1.6) - pozwala na dodanie dowolnej funkcji renderującej wartość komórki w tabelce dynamicznej. Zarejestrować można dowolną liczbę rendererów, które zostaną wywołane zgodnie z kolejnością dodania.

    • Parametry funkcji:

       

      NazwaTypWartość domyślnaOpis
      variableSetSuncode.form.view.gadget.variableset.VariableSetnullKomponent tabeli dynamicznej
      rendererFunctionnull

      Funkcja renderująca wartość danych kolumn. Przyjmuje następujące parametry:

      - value: wartość komórki (nie formatowana) 

      - data: obiekt całego rekordu (wiersza)

      Code Block
      js
      js
      {
      	"id_zmiennej": "wartość",
      	"id_zmiennej2": "wartość2"
      }

      - column: identyfikator aktualnie renderowanej kolumny (id zmiennej) 

      - metaData: obiekt zawierający informacje o wierszu

      Code Block
      js
      js
      {
      	row: //indeks wiersza (readonly)
      	cell: //indeks kolumny (readonly)
      	style: //nadany styl elementu TD
      	cls: // nadana klasa css elementu TD
       
      	// 3.1.7+
      	encode: // czy kodować znaki html (domyślnie true)
      }


      Warning

      Parametr metaData.encode może być wykorzystany w przypadku, gdy chcemy w komórce wstawić tagi html. W takim przypadku musimy sami zadbać o zakodowanie wartości wpisanej przez użytkownika.

       

      Funkcja może zwrócić wartość, która zostanie wpisana do komórki (o ile inne funkcje renderujące wywołane później nie zmienią tej wartości.

      Przykład:

      Code Block
      js
      js
      // Rejestracja renderera
      var vss = ServiceFactory.getVariableSetService();
       
      vss.addRenderer(vss.get(0), function(value, data, column, metaData){
       
      	// nadanie stylu na podstawie wartości zmienna1
      	metaData.style = 'color: ' + value; // lub data[column]
       
      	// nadanie klasy na podstawie wartości zmienna2
      	metaData.cls = data['zmienna2'];
       
      	// nadanie nowej wartości
      	return 'rendered:' + value;
      }, ['zmienna1']); // renderer dla podanej kolumny
      columnsString[]Wszystkie kolumny tabelkiTablica identyfikatorów zmiennych (kolumn) dla których ma obowiązywać ta funkcja renderująca. Jeżeli pominiemy ten parametr, funkcja będzie obowiązywać dla wszystkich zmiennych.


    • Rezultat funkcji: brak

       

       

  • removeRenderers (od 3.1.6) - usuwa wszystkie funkcje renderujące z podanej zmiennej tabelki dynamicznej
    • Parametry funkcji:

       

      NazwaTypWartość domyślnaOpis
      variableSetSuncode.form.view.gadget.variableset.VariableSetnullKomponent tabelki dynamicznej
      columnsString[]Wszystkie kolumny tabelkiTablica identyfikatorów zmiennych (kolumn) z których usunąć wszystkie funkcje renderujące.
    • Rezultat funkcji: brak

     

  • selectAll (od 3.1.8) - zaznacza wszystkie rekordy z tabeli dynamicznej (uwaga: wiąże się to z dodaniem do każdego rekordu określonej klasy css, rekordy nie są zwracane przez selModel.getSelection()).

    • Parametry funkcji

      NazwaTyp

      Wartość domyślna

      Opis
      variableSetSuncode.form.view.gadget.variableset.VariableSetnullKomponent tabeli dynamicznej


    • Rezultat funkcji: brak



     

  • deselectAll (od 3.1.8) - odznacza wszystkie rekordy z tabeli dynamicznej (uwaga: wiąże się to z usunięciem z każdego rekordu określonej klasy css).

    • Parametry funkcji

      NazwaTyp

      Wartość domyślna

      Opis
      variableSetSuncode.form.view.gadget.variableset.VariableSetnullKomponent tabeli dynamicznej


    • Rezultat funkcji: brak



  • getAllSelected (od 3.1.8) - zwraca wszystkie zaznaczone rekordy (za pomocą funkcji selectAll, czyli posiadające określona klasę css).
    • Parametry funkcji

      NazwaTyp

      Wartość domyślna

      Opis
      variableSetSuncode.form.view.gadget.variableset.VariableSetnullKomponent tabeli dynamicznej


    • Rezultat funkcji:

      TypOpis
      Ext.data.Model[]Tablica zaznaczonych rekordów

       

       

  • minimize (od 3.1.25) - minimalizuje tabelę dynamiczną.

    • Parametry funkcji

      NazwaTyp

      Wartość domyślna

      Opis
      variableSetSuncode.form.view.gadget.variableset.VariableSetnullKomponent tabeli dynamicznej


    • Rezultat funkcji: brak

 

  • maximize (od 3.1.25) - maksymalizuje tabelę dynamiczną.

    • Parametry funkcji

      NazwaTyp

      Wartość domyślna

      Opis
      variableSetSuncode.form.view.gadget.variableset.VariableSetnullKomponent tabeli dynamicznej


    • Rezultat funkcji: brak

Opis

VariableSetService

VariableSetServiceallows to manage dynamic tables and variables in these tables. It has the following functions:

  • get– gets dynamic table component.
  • Function parameters
Rezultat funkcji:
Opis
English

Serwis VariableSetService pozwala zarządzać tabelami dynamicznymi oraz zmiennymi znajdującymi się w tych tabelach. Posiada następujące funkcje:

get - pobiera komponent tabeli dynamicznej.
Parametry funkcji
NazwaTyp

Wartość domyślna

Typ

Name

Typee

Default value

Description

variableSetIdParam

String/Number

null

Identyfikator tabeli dynamicznej/Numer tabeli dynamicznej na formularzu zgodnie z mapą procesu (pierwsza tabela ma numer 0)

Dynamic table id /Dynamic table number on the form according to the process map (the first table has the number 0)

 

  • Function result:

Typee

Description

Suncode.form.view.gadget.variableset.VariableSet

Komponent tabeli dynamicznej lub undefined, jeśli nie znalezionogetAll - zwraca wszystkie komponenty tabel dynamicznych.
Parametry funkcji
NazwaTyp

Wartość domyślna

Opis

Dynamic table component or undefined if it was not found

 

  • Function parameters
  • getAll- returns all components of dynamic tables.
Rezultat funkcji:
TypOpis

Name

Typee

Default value

Description

getEditable

Boolean

false

Informacja, czy zwracac tylko edytowalne tabele dynamiczne

Information whether to return only editable dynamic tables

 

  • Function result:
Parametry funkcji
NazwaTyp

Wartość domyślna

Opis

Typee

Description

Suncode.form.view.gadget.variableset.VariableSet[]

Tablica komponentów tabel dynamicznych lub pusta tablica, jeśli nie znaleziono żadnej tabelihide - ukrywa tabele dynamiczne

An array of dynamic table components or an empty array if no table was found

 

  • hide - hides dynamic tables
  • Function parameters

Name

Typee

Default value

Description

variables

String/Number/String[],Number[]

null

Identyfikator/tablica identyfikatorów tabel dynamicznych lub numer(indeks)/tablica numerów tabel dynamicznych. Numer określa indeks tabeli dynamicznej na formularzu, dla numeru 0 jest to pierwsza tabela zadania, itd. Podając tablicę można mieszać typy, czyli można podać tablicę: [ 'id_tabeli_

ID / table of dynamic table identifiers or number (index) / array of dynamic table numbers. The number specifies the index of the dynamic table on the form, for the number 0 it is the first table of the task, etc. By giving the table, you can mix Typees, i.e. you can specify an array: [ 'table_id_1', 3 ],

co ukryje tabelę o

which will hide the table with id: 'table_id_

tabeli_

1'

oraz tabelę, która jest czwarta w kolejności na formularzu.Rezultat funkcji: brak

and a table, which is the fourth in order on the form.

 

  • Function result: null

 

  • show - pokazuje tabele dynamiczne
    Parametry funkcjishows dynamic tables
  • Function parametersNazwa

Name

Typ

Typee

Wartość domyślna

Default value

Opis

Description

variables

String/Number/String[],Number[]

null

Identyfikator/tablica identyfikatorów tabel dynamicznych lub numer(indeks)/tablica numerów tabel dynamicznych. Numer określa indeks tabeli dynamicznej na formularzu, dla numeru 0 jest to pierwsza tabela zadania, itd. Podając tablicę można mieszać typy, czyli można podać tablicę:  [ 'id_tabeli_

ID / table of dynamic table identifiers or number (index) / array of dynamic table numbers. The number specifies the index of the dynamic table on the form, for the number 0 it is the first table of the task, etc. By giving the table, you can mix Typees, i.e. you can specify an array: [ 'table_id_1', 3 ],

co pokaże tabelę o

which will show the table with id: 'table_id_

tabeli_

1'

oraz tabelę, która jest czwarta w kolejności na formularzu.
  • Rezultat funkcji: brak
  •  

    addRow - dodaje pusty rekord do tabeli dynamicznej. Możliwe jest rozpoczęcie edycji pierwszej edytowalnej komórki nowo dodanego rekordu.
    Parametry funkcji
    NazwaTyp

    Wartość domyślna

    Opis

    and a table, which is the fourth in order on the form.

     

    • Function result: null

     

    • addRow- adds an empty record to the dynamic table. It is possible to start editing the first editable cell of the newly added record.
    • Function parameters

    Name

    Typee

    Default value

    Description

    variableSet

    Suncode.form.view.gadget.variableset.VariableSet

    null

    Komponent tabeli dynamicznej

    Dynamic table component

    startEditing

    Boolean

    false

    Informuje, czy rozpocząć edycję pierwszej edytowalnej komórki nowo dodanego rekordu

    Informs whether to start to edit the first editable cell of the newly added record

    records

    Object/Object[]

    {}

    Wartości w nowym wierszu postaci

    Value in new row with character { id_

    kolumny1

    column1 : "

    wartosc

    value_1", id_

    kolumny2

    column2 : "

    wartosc

    value_2" }.

    Możliwe jest podanie także tablicy rekordów w powyższej postaci, co spowoduje dodanie kilku wierszy do tabeli dynamicznej.
  • Rezultat funkcji: brak
  •  

    insertRow - wstawia pusty rekord do tabeli dynamicznej na podanej pozycji. Możliwe jest rozpoczęcie edycji pierwszej edytowalnej komórki nowo dodanego rekordu.
    Parametry funkcji
    NazwaTyp

    Wartość domyślna

    Opis

    It is also possible to provide a records table in the above form, which will add several rows to the dynamic table.

     

    • Function result: null

     

    • insertRow - inserts an empty record into the dynamic table at the given position. It is possible to start editing the first editable cell of the newly added record.
    • Function parameters

    Name

    Typee

    Default value

    Description

    variableSet

    Suncode.form.view.gadget.variableset.VariableSet

    null

    Komponent tabeli dynamicznej

    Dynamic table component

    index

    Number

    brakNumer wiersza od którego wstawione zostaną nowe wiersze. Numer musi być większy lub równy

    null

    The number of the row from which the new rows will be inserted. The number must be greater than or equal to 0.

    startEditing

    Boolean

    false

    Informuje, czy rozpocząć edycję pierwszej edytowalnej komórki nowo wstawionego rekordu

    Informs whether to start to edit the first editable cell of the newly inserted record

    records

    Object/Object[]

    {}

    Wartości we wstawionym wierszu postaci

    Value in the inserted row with character { id_

    kolumny1

    column1 : "

    wartosc

    value_1", id_

    kolumny2

    column2 : "

    wartosc

    value_2" }.

    Możliwe jest podanie także tablicy rekordów w powyższej postaci, co spowoduje dodanie kilku wierszy do tabeli dynamicznej.
  • Rezultat funkcji: brak
  •  

    getSelected - pobiera aktualnie zaznaczony rekord w tabeli dynamicznej, zwraca null, gdy żaden rekord nie jest aktualnie zaznaczony.
    Parametry funkcji
    NazwaTyp

    Wartość domyślna

    Opis

    It is also possible to provide a table of records in the above form, which will add several rows to the dynamic table.

     

    • Function result: null

     

    • getSelected- gets the currently selected record in the dynamic table, returns null when no record is currently selected.
    • Function parameters

    Name

    Typee

    Default value

    Description

    variableSet

    Suncode.form.view.gadget.variableset.VariableSet

    null

    Komponent tabeli dynamicznejRezultat funkcji

    Dynamic table component

     

    • Function result:Typ

    Typee

    OpisdeleteSelected - usuwa wszystkie zaznaczone rekordy w tabeli dynamicznej.
    Parametry funkcji
    NazwaTyp

    Wartość domyślna

    Opis

    Description

    Ext.data.Model

    Aktualnie zaznaczony rekord

    Currently selected record

    • deleteSelected- deletes all selected records in the dynamic table.
    • Function parameters

    Name

    Typee

    Default value

    Description

    variableSet

    Suncode.form.view.gadget.variableset.VariableSet

    null

    Komponent tabeli dynamicznej
  • Rezultat funkcji: brak
  • Dynamic table component

     

    • Function result: null 
    • Function parameters: 
    • copySelected - kopiuje wszystkie zaznaczone rekordy w tabeli dynamicznej.
      Parametry funkcji
      NazwaTyp

      Wartość domyślna

      Opiscopies all selected records in the dynamic table.
    Parametry funkcji
    NazwaTyp

    Wartość domyślna

    Opis

    Name

    Typee

    Default value

    Description

    variableSet

    Suncode.form.view.gadget.variableset.VariableSet

    null

    Komponent tabeli dynamicznej
  • Rezultat funkcji: brak
  • getRowIndex - zwraca numer wiersza dla danego rekordu.

    Dynamic table component

     

    • Function result: null 

     

    • getRowIndex- returns the row number for the record.
    • Function parameters

    Name

    Typee

    Default value

    Description

    variableSet

    Suncode.form.view.gadget.variableset.VariableSet

    null

    Komponent tabeli dynamicznej

    Dynamic table component

    record

    Ext.data.Model

    null

    Obiekt rekordu tabeli dynamicznej

    Dynamic table record object

     

    • Rezultat funkcjiFunction result:Typ

    Typee

    Opis

    Description

    Integer

    Numer wiersza

    Row number

    • getColumnIndex - zwraca numer kolumny dla danej zmiennej formularza.
      Parametry funkcjireturns the column number for the given form variable.
    • Function parametersNazwa

    Name

    Typ

    Typee

    Wartość domyślna

    Default value

    Opis

    Description

    variableSet

    Suncode.form.view.gadget.variableset.VariableSet

    null

    Komponent tabeli dynamicznejRezultat funkcji:
    TypOpis
    IntegerNumer kolumny
    getValue - zwraca wartość zmiennej formularza w konkretnej komórce w tabeli dynamicznej lub ciąg wartości ze wszystkich komórek w danej kolumnie (od

    Dynamic table component

    variableId

    String

    null

    Identyfikator zmiennej formularza (identyfikator zmiennej procesu) znajdującej się w tabeli dynamicznej

    The id of the form variable (process variable identifier) in the dynamic table

     

    • Function result:

    Type

    Description

    Integer

    Column number

    • getValue- returns the value of a form variable in a specific cell in the dynamic table or a string of values from all cells in a given column (from 3.1.8).
    • Parametry funkcjiFunction parametersNazwa

    Name

    Typ

    Type

    Wartość domyślna

    Default value

    Opis

    Description

    variableSet

    Suncode.form.view.gadget.variableset.VariableSet

    null

    Komponent tabeli dynamicznej

    Dynamic table component

    rowIndex

    Integer

    null

    Numer wiersza rekordu (pierwszy wiersz ma numer 0). W przypadku podania null, zwracany jest ciąg wartości ze wszystkich komórek w danej kolumnie. Kolejne wartości są rozdzielone znakiem średnika (od

     

    Rezultat funkcji:
    TypOpis
    ObjectWartość zmiennej w komórce
    setValue - ustawia wartość zmiennej formularza w konkretnej komórce w tabeli dynamicznej lub ciąg wartości we wszystkich komórkach w danej kolumnie (jeżeli ciąg wartości jest dłuższy, niż ilość rekordów w tabeli dynamicznej, to dodawane są nowe rekordy z pustymi wartościami dla innych komórek, jeżeli ciąg wartości jest krótszy, niż ilość rekordów w tabeli dynamicznej, to w pozostałych rekordach w danej kolumnie ustawiana jest pusta wartość) (od

    The row number of the record (the first row has the number 0). If you specify null, a string of values is returned from all cells in a given column. The next values are separated by a semicolon (from 3.1.8)

    variableId

    String

    null

    Identyfikator zmiennej formularza (identyfikator zmiennej procesu) znajdującej się w tabeli dynamicznej

    The id of the form variable (process variable identifier) in the dynamic table

     

    • Function result:

    Type

    Description

    Object

    Variable value in the cell

    • setValue -sets the value of a form variable in a specific cell in a dynamic table or a string of values in all cells in a given column (if the value string is longer than the number of records in the dynamic table, new records are added with empty values for other cells if the value string is shorter , than the number of records in the dynamic table, in the other records in a given column an empty value is set) (from 3.1.8).
    • Parametry funkcjiFunction parametersNazwa

    Name

    Typ

    Type

    Wartość domyślna

    Default value

    Opis

    Description

    variableSet

    Suncode.form.view.gadget.variableset.VariableSet

    null

    Komponent tabeli dynamicznej

    Dynamic table component

    rowIndex

    Integer

    null

    Numer wiersza rekordu (pierwszy wiersz ma numer 0). W przypadku podania null, ustawiany jest ciąg wartości we wszystkich komórkach w danej kolumnie. Kolejne wartości powinny być rozdzielone znakiem średnika (od

    The row number of the record (the first row has the number 0). If you specify null, a string of values is set in all cells in a given column. The next values should be separated by a semicolon (from 3.1.8)

    variableId

    String

    null

    Identyfikator zmiennej formularza (identyfikator zmiennej procesu) znajdującej się w tabeli dynamicznejParametry funkcji
    NazwaTyp

    Wartość domyślna

    Opis

    The identifier of the form variable (process variable identifier) in the dynamic table

    value

    Object

    null

    Wartość zmiennej formularzaRezultat funkcji: brak
    save - zapisuje rekordy tabeli dynamicznej do kontekstu zadania.

    The value of the form variable

     

    • Function result:null

    • Function parameters: 
    • save -writes dynamic table records to the task context.

    Name

    Type

    Default value

    Description

    variableSet

    Suncode.form.view.gadget.variableset.VariableSet

    null

    Komponent tabeli dynamicznejRezultat funkcji: brak
    markErrorCell - zaznacza komórkę w tabeli dynamicznej jako błędna (czerwone tło).
    Parametry funkcji
    NazwaTyp

    Wartość domyślna

    Opis

    Dynamic table component

     

    • Function parameters: 
      • Function result:null
    • markErrorCell - selects the cell in the dynamic table as invalid (red background).

    Name

    Type

    Default value

    Description

    variableSet

    Suncode.form.view.gadget.variableset.VariableSet

    null

    Komponent tabeli dynamicznej

    Dynamic table component

    rowIndex

    Integer

    null

    Numer wiersza rekordu (pierwszy wiersz ma numer Rezultat funkcji: brak

     

    unmarkErrorCell - odznacza komórkę w tabeli dynamicznej jako błędną (usuwa czerwone tło).
    Parametry funkcji
    NazwaTyp

    Wartość domyślna

    Opis

    The row number of the record (the first row has the number 0)

    variableId

    String

    null

    Identyfikator zmiennej formularza (identyfikator zmiennej procesu) znajdującej się w tabeli dynamicznej

    The id of the form variable (process variable identifier) in the dynamic table

     

    • Function result:null
    • Function parameters: 
    • unmarkErrorCell- unmarks the cell in the dynamic table as invalid (removes the red background).

    Name

    Type

    Default value

    Description

    variableSet

    Suncode.form.view.gadget.variableset.VariableSet

    null

    Komponent tabeli dynamicznej

    Dynamic table component

    rowIndex

    Integer

    null

    Numer wiersza rekordu (pierwszy wiersz ma numer

     

    Rezultat funkcji: brak

     

    getVariableSetData - zwraca wszystkie zmienne formularza we wszystkich rekordach tabeli dynamicznej w formie

    The row number of the record (the first row has the number 0)

    variableId

    String

    null

    Identyfikator zmiennej formularza (identyfikator zmiennej procesu) znajdującej się w tabeli dynamicznej

    The id of the form variable (process variable identifier) in the dynamic table

     

    • Function result:null

     

    • getVariableSetData - returns all form variables in all records in the dynamic table in the form of JSON.

     

    • Parametry funkcjiFunction parametersNazwa

    Name

    Typ

    Type

    Wartość domyślna

    Default value

    Opis

    Description

    variableSet

    Suncode.form.view.gadget.variableset.VariableSet

    null

    Komponent tabeli dynamicznej

    Dynamic table component

     

    • Rezultat funkcjiFunction result:Typ

    Type

    Opis

    Description

    String

    Zawartość tabeli w formie

    Table contents in the form of JSON

     

    •  

      getRowsCount - zwraca ilość wierszy w tabeli dynamicznej.

      Parametry funkcjigetRowsCount - returns the number of rows in the dynamic table.
      • Function parametersNazwa

    Name

    Typ

    Type

    Wartość domyślna

    Default value

    Opis

    Description

    variableSet

    Suncode.form.view.gadget.variableset.VariableSet

    null

    Komponent tabeli dynamicznejRezultat funkcji

    Dynamic table component

     

    • Function result:Typ

    Type

    OpisParametry funkcji
    NazwaTyp

    Wartość domyślna

    Opis

    Description

    Integer

    Ilość wierszy w tabeli dynamicznej

    getColumnSum - zwraca sumę wartości z danej kolumny.

    The number of rows in the dynamic table

    • getColumnSum - returns the sum of values from a given column.
      • Function parameters: 

    Name

    Type

    Default value

    Description

    variableSet

    Suncode.form.view.gadget.variableset.VariableSet

    null

    Komponent tabeli dynamicznej

    Dynamic table component

    variableId

    String

    null

    Zmienna procesu identyfikująca kolumnę w tabeli dynamicznejRezultat funkcji:
    TypOpis
    Integer/StringSumę wartości z danej kolumny (typ String występuje, gdy suma została wykonana na kolumnie, która zawiera wartości tekstowe - rezultatem jest ciąg znaków)

    setTitle - ustawia tytuł.

    Parametry funkcji
    NazwaTyp

    Wartość domyślna

    Opis

    Process variable that identifies the column in the dynamic table

    grouped

    Boolean

    false

    Informuje, czy zwracać rezultat w postaci obiektu zawierającego sumę z poszczególnych grup
    (ma znaczenie tylko, gdy tabela dynamiczna ma aktywną opcję grupowania)

    It informs whether to return the result in the form of an object containing the sum from individual groups

    (only valid if the dynamic table has active the grouping option)

     

    • Function result:

    Type

    Description

    Integer/String

    The sum of values from a given column (Type String occurs when the sum has been made on a column that contains text values - the result is a string of characters)

    • setTitle- sets the title.
      • Function parameters: 

    Name

    Type

    Default value

    Description

    variableSet

    Suncode.form.view.gadget.variableset.VariableSet

    null

    Komponent tabeli dynamicznej

    Dynamic table component

    title

    String

    null

    Tytuł

    Title (

    możliwe jest podawanie tagów HTML)
  • Rezultat funkcji: brak

  • removeBottomToolbarButtons - usuwa wszystkie przyciski z dolnej belki oraz ukrywa ją. Dodawanie rekordów za pomocą klawiatury jest możliwe tylko w przypadku, gdy przycisk dodawania, wstawiania lub kopiowania jest dostępny, widoczny i niezablokowany. Usuwanie rekordów za pomocą klawiatury jest możliwe tylko w przypadku, gdy przycisk usuwania jest dostępny, widoczny i niezablokowany.

    Parametry funkcji
    NazwaTyp

    Wartość domyślna

    Opis

    HTML tags are possible)

     

    • Function result:null
    • removeBottomToolbarButtons - removes all buttons from the bottom bar and hides it. Adding records using the keyboard is only possible if the add, insert or copy button is available, visible and unblocked. Deleting records using the keyboard is only possible if the delete button is available, visible and unblocked.
      • Function parameters: 
    Parametry funkcji
    NazwaTyp

    Wartość domyślna

    Opis

    Name

    Type

    Default value

    Description

    variableSet

    Suncode.form.view.gadget.variableset.VariableSet

    null

    Komponent tabeli dynamicznej
  • Rezultat funkcji:brak

  • removeBottomToolbarButton - usuwa określony przycisk z dolnej belki oraz ukrywa ją, gdy przycisk był ostatnim dostępnym na belce. Dodawanie rekordów za pomocą klawiatury jest możliwe tylko w przypadku, gdy przycisk dodawania, wstawiania lub kopiowania jest dostępny, widoczny i niezablokowany. Usuwanie rekordów za pomocą klawiatury jest możliwe tylko w przypadku, gdy przycisk usuwania jest dostępny, widoczny i niezablokowany.

    Dynamic table component

     

    • Function result:null
    • removeBottomToolbarButton - removes a specific button from the bottom bar and hides it when the button was last available on the bar. Adding records using the keyboard is only possible if the add, insert or copy button is available, visible and unblocked. Deleting records using the keyboard is only possible if the delete button is available, visible and unblocked.
      • Function parameters: 

    Name

    Type

    Default value

    Description

    variableSet

    Suncode.form.view.gadget.variableset.VariableSet

    null

    Komponent tabeli dynamicznej

    Dynamic table component

    itemId

    String

    null

    Identyfikator przycisku na belce. Oczekiwane wartości to

    The id of the button on the bar. Expected values are:
    - add

    - przycisk dodawania wiersza

     - row adding button
    -

    insert - przycisk wstawiania wiersza

    insert - row insert button
    -

    delete - przycisk usuwania wiersza

     delete – row delete button
    -

    copy - przycisk kopiowania wiersza
    - dowolne id, będące id przycisku DT_BUTTON podanego w mapie
  • Rezultat funkcji:brak

  •  

     

    disableBottomToolbarButtons - blokuje wszystkie przyciski z dolnej belki. Dodawanie rekordów za pomocą klawiatury jest możliwe tylko w przypadku, gdy przycisk dodawania, wstawiania lub kopiowania jest dostępny, widoczny i niezablokowany. Usuwanie rekordów za pomocą klawiatury jest możliwe tylko w przypadku, gdy przycisk usuwania jest dostępny, widoczny i niezablokowany.

    Parametry funkcji
    NazwaTyp

    Wartość domyślna

    Opis

     copy – row copy button
    any id, being the button id DT_BUTTON given in the map

     

    • Function result:null

     

    • disableBottomToolbarButtons - blocks all buttons from the bottom bar. Adding records using the keyboard is only possible if the add, insert or copy button is available, visible and unblocked. Deleting records using the keyboard is only possible if the delete button is available, visible and unblocked.
      • Function parameters: 

    Name

    Type

    Default value

    Description

    variableSet

    Suncode.form.view.gadget.variableset.VariableSet

    null

    Komponent tabeli dynamicznejRezultat funkcji:brak

    Dynamic table component

     

    • Function result:null

     

    •  

      disableBottomToolbarButton - blokuje określony przycisk z dolnej belki. Dodawanie rekordów za pomocą klawiatury jest możliwe tylko w przypadku, gdy przycisk dodawania, wstawiania lub kopiowania jest dostępny, widoczny i niezablokowany. Usuwanie rekordów za pomocą klawiatury jest możliwe tylko w przypadku, gdy przycisk usuwania jest dostępny, widoczny i niezablokowany.Parametry funkcji
      NazwaTyp

      Wartość domyślna

      Opisblocks a specific button from the bottom bar. Adding records using the keyboard is only possible if the add, insert or copy button is available, visible and unblocked. Deleting records using the keyboard is only possible if the delete button is available, visible and unblocked.
      • Function parameters: 

    Name

    Type

    Default value

    Description

    variableSet

    Suncode.form.view.gadget.variableset.VariableSet

    null

    Komponent tabeli dynamicznej

    Dynamic table component

    itemId

    String

    null

    Identyfikator przycisku na belce. Oczekiwane wartości to

    The id of the button on the bar. Expected values are:
    - add

    - przycisk dodawania wiersza

     - row adding button
    -

    insert - przycisk wstawiania wiersza

    insert - row insert button
    -

    delete - przycisk usuwania wiersza

     delete – row delete button
    -

    copy - przycisk kopiowania wiersza
    - dowolne id, będące id przycisku DT_BUTTON podanego w mapie
  • Rezultat funkcji:brak

  •  

     

    enableBottomToolbarButtons - aktywuje wszystkie przyciski z dolnej belki. Dodawanie rekordów za pomocą klawiatury jest możliwe tylko w przypadku, gdy przycisk dodawania, wstawiania lub kopiowania jest dostępny, widoczny i niezablokowany. Usuwanie rekordów za pomocą klawiatury jest możliwe tylko w przypadku, gdy przycisk usuwania jest dostępny, widoczny i niezablokowany.

    Parametry funkcji
    NazwaTyp

    Wartość domyślna

    Opis

     copy – row copy button
    any id, being the button id DT_BUTTON given in the map

     

    • Function result:null

     

    • enableBottomToolbarButtons - activates all buttons from the bottom bar. Adding records using the keyboard is only possible if the add, insert or copy button is available, visible and unblocked. Deleting records using the keyboard is only possible if the delete button is available, visible and unblocked.
      • Function parameters: 

    Name

    Type

    Default value

    Description

    variableSet

    Suncode.form.view.gadget.variableset.VariableSet

    null

    Komponent tabeli dynamicznejRezultat funkcji:brak

    Dynamic table component

     

    • Function result:null

     

    •  

      enableBottomToolbarButton - aktywuje określony przycisk z dolnej belki. Dodawanie rekordów za pomocą klawiatury jest możliwe tylko w przypadku, gdy przycisk dodawania, wstawiania lub kopiowania jest dostępny, widoczny i niezablokowany. Usuwanie rekordów za pomocą klawiatury jest możliwe tylko w przypadku, gdy przycisk usuwania jest dostępny, widoczny i niezablokowany.Parametry funkcji
      NazwaTyp

      Wartość domyślna

      Opisactivates the specified button from the bottom bar. Adding records using the keyboard is only possible if the add, insert or copy button is available, visible and unblocked. Deleting records using the keyboard is only possible if the delete button is available, visible and unblocked.
      • Function parameters: 

    Name

    Type

    Default value

    Description

    variableSet

    Suncode.form.view.gadget.variableset.VariableSet

    null

    Komponent tabeli dynamicznej

    Dynamic table component

    itemId

    String

    null

    Identyfikator przycisku na belce. Oczekiwane wartości to

    The id of the button on the bar. Expected values are:
    - add

    - przycisk dodawania wiersza

     - row adding button
    -

    insert - przycisk wstawiania wiersza

    insert - row insert button
    -

    delete - przycisk usuwania wiersza

     delete – row delete button
    -

    copy - przycisk kopiowania wiersza
    - dowolne id, będące id przycisku DT_BUTTON podanego w mapieRezultat funkcji:brak

     copy – row copy button
    any id, being the button id DT_BUTTON given in the map

     

    • Function result:null

     

    • addBottomToolbarButton - dodaje przycisk do dolnej belki.Parametry funkcjiadds a button to the bottom bar.
      • Function parametersNazwa

    Name

    Typ

    Type

    Wartość domyślna

    Default value

    Opis

    Description

    variableSet

    Suncode.form.view.gadget.variableset.VariableSet

    null

    Komponent tabeli dynamicznej

    Dynamic table component

    button

    Object/Ext.button.Button

    null

    Obiekt konfiguracyjny przycisku (podawany do tworzenia

    Button configuration object (provided for creating Ext.button.Button)

    Rezultat funkcji:brak

     

    • Function result:null

     

    • insertBottomToolbarButton - dodaje przycisk do dolnej belki na określonej pozycji.Parametry funkcjiadds a button to the bottom bar at a specific position.
      • Function parametersNazwa

    Name

    Typ

    Type

    Wartość domyślna

    Default value

    Opis

    Description

    variableSet

    Suncode.form.view.gadget.variableset.VariableSet

    null

    Komponent tabeli dynamicznej

    Dynamic table component

    button

    Object/Ext.button.Button

    null

    Obiekt konfiguracyjny przycisku (podawany do tworzenia Rezultat funkcji:brak

    Button configuration object (provided for creating Ext.button.Button)

    index

    Integer

    null

    Pozycja, na które dodawany jest przycisk

    The position to which the button is added

     

    • Function result:null

     

    • getRecordsByCriteria - wyszukuje rekordy w tabeli dynamicznej na podstawie podanych kryteriów (wartości w kolumnach, dokładność co do wartości i typu).Parametry funkcji
      NazwaTyp

      Wartość domyślna

      Opissearches records in the dynamic table based on given criteria (values in columns, accuracy in value and Typeu).
      • Function parameters: 

    Name

    Type

    Default value

    Description

    variableSet

    Suncode.form.view.gadget.variableset.VariableSet

    null

    Komponent tabeli dynamicznej

    Dynamic table component

    criteria

    Object[]

    []

    Tablica obiektów kryteriów. Kryterium musi zawierać następujące właściwości

    An array of criteria objects. The criterion must contain the following properties:
    - id -

    identyfikator kolumny (zmienna procesu

    column id (process variable)
    - value -

    oczekiwana wartośćRezultat funkcji

    expected value

     

    • Function result:Typ

    Type

    Opis

    Description

    Ext.data.Model[]

    Znalezione rekordy

    Records found

     

    • deleteRecordsByCriteria - usuwa rekordy z tabeli dynamicznej na podstawie podanych kryteriów z dokładnością do typu (wartości w kolumnach, dokładność co do wartości i typu).Parametry funkcji
      NazwaTyp

      Wartość domyślna

      Opisremoves records from the dynamic table based on given criteria with accuracy to Typeu (values in columns, accuracy in value and Typeu).
      • Function parameters: 

    Name

    Type

    Default value

    Description

    variableSet

    Suncode.form.view.gadget.variableset.VariableSet

    null

    Komponent tabeli dynamicznej

    Dynamic table component

    criteria

    Object[]

    []

    Tablica obiektów kryteriów. Kryterium musi zawierać następujące właściwości

    An array of criteria objects. The criterion must contain the following properties:
    - id -

    identyfikator kolumny (zmienna procesu

    column id (process variable)
    - value -

    oczekiwana wartośćRezultat funkcji

    expected value

     

    • Function result:Typ

    Type

    Opis

    Description

    Integer

    Ilość usuniętych rekordów

    Number of deleted records

     

    • deleteRecords (od from 3.1.8) - usuwa określone rekordy z tabeli dynamicznej.Parametry funkcjideletes specific records from the dynamic table.
      • Function parametersNazwa

    Name

    Typ

    Type

    Wartość domyślna

    Default value

    Opis

    Description

    variableSet

    Suncode.form.view.gadget.variableset.VariableSet

    null

    Komponent tabeli dynamicznejRezultat funkcji: brak

    Dynamic table component

    records

    Ext.data.Model[]

    null

    Tablica rekordów do usunięcia

    Record table to delete

     

    • Function result:null

     

    •  

      clear - usuwa wszystkie rekordy z tabeli dynamicznej.Parametry funkcjideletes all records from the dynamic table.
      • Function parametersNazwa

    Name

    Typ

    Type

    Wartość domyślna

    Default value

    Opis

    Description

    variableSet

    Suncode.form.view.gadget.variableset.VariableSet

    null

    Komponent tabeli dynamicznejRezultat funkcji: brak

    Dynamic table component

    silent

    Boolean

    false

    Informuje, czy podczas usuwania mają zostać wywołane akcje bulkremove and clear dla store'a

    Informs that during delation bulkremove actions and clear for storage have to be called.

     

    • Function result:null

     

    • showColumn - pokazuje kolumnę w tabeli dynamicznej.Parametry funkcjishows the column in the dynamic table.
      • Function parametersNazwa

    Name

    Typ

    Type

    Wartość domyślna

    Default value

    Opis

    Description

    variableSet

    Suncode.form.view.gadget.variableset.VariableSet

    null

    Komponent tabeli dynamicznejRezultat funkcji: brak

    Dynamic table component

    variableId

    String

    null

    Zmienna procesu identyfikująca kolumnę w tabeli dynamicznej

    Process variable that identifies the column in the dynamic table

     

    • Function result:null

     

    • hideColumn - ukrywa kolumnę w tabeli dynamicznej.Parametry funkcjihides column in the dynamic table.
      • Function parametersNazwa

    Name

    Typ

    Type

    Wartość domyślna

    Default value

    Opis

    Description

    variableSet

    Suncode.form.view.gadget.variableset.VariableSet

    null

    Komponent tabeli dynamicznejRezultat funkcji: brak

    Dynamic table component

    variableId

    String

    null

    Zmienna procesu identyfikująca kolumnę w tabeli dynamicznej

    Process variable that identifies the column in the dynamic table

     

    • Function result:null

     

    • getColumnName - pobiera nazwę kolumny w tabeli dynamicznej z uwzględnieniem tłumaczenia (widoczną w nagłówku).
      Parametry funkcji
      NazwaTyp

      Wartość domyślna

      OpisgetColumnName- gets the name of the column in the dynamic table including the translation (visible in the header).
    • Function parameters: 

    Name

    Type

    Default value

    Description

    variableSet

    Suncode.form.view.gadget.variableset.VariableSet

    null

    Komponent tabeli dynamicznejRezultat funkcji:
    TypOpis
    StringNazwa kolumny w tabeli dynamicznej lub null, jeżeli kolumna o podanym identyfikatorze nie istnieje w tabeli
    setColumnName - ustawia nazwę kolumny w tabeli dynamicznej (widoczną w nagłówku), zachowuje informację o opisie i wymagalności zmiennej.
    Parametry funkcji
    NazwaTyp

    Wartość domyślna

    Opis

    Dynamic table component

    variableId

    String

    null

    Zmienna procesu identyfikująca kolumnę w tabeli dynamicznej

    Process variable that identifies the column in the dynamic table

     

    • Function result:

    Type

    Description

    String

    Name of the column in the dynamic table or null if the column with the given id does not exist in the table

     

    • setColumnName- sets the column name in the dynamic table (visible in the header), saves information about the Description and maturity of variable.
    • Function parameters: 

    Name

    Type

    Default value

    Description

    variableSet

    Suncode.form.view.gadget.variableset.VariableSet

    null

    Komponent tabeli dynamicznej

    Dynamic table component

    variableId

    String

    null

    Zmienna procesu identyfikująca kolumnę w tabeli dynamicznejParametry funkcji
    NazwaTyp

    Wartość domyślna

    Opis

    Process variable that identifies the column in the dynamic table

    name

    String

    null

    Nazwa kolumny
  • Rezultat funkcji: brak

  • addTool - dodaje przycisk narzędzia do nagłówka tabeli dynamicznej.

    Column name

     

    • Function result:null

     

    • addTool- adds a tool button to the dynamic table header.
    • Function parameters: 

    Name

    Type

    Default value

    Description

    variableSet

    Suncode.form.view.gadget.variableset.VariableSet

    null

    Komponent tabeli dynamicznej

    Dynamic table component

    tool

    Object/Ext.panel.Tool

    null

    Obiekt konfiguracyjny narzędzia (podawany do tworzenia

    Tool configuration object (provided for creating Ext.panel.Tool)

  • Rezultat funkcji: brak

  • getTitle - zwraca tytuł tabeli dynamicznej bez tagów HTML.
    Parametry funkcji
    NazwaTyp

    Wartość domyślna

    Opis

     

    • Function result:null

     

    • getTitle- returns the title of the dynamic table without HTML tags.
    • Function parameters: 

    Name

    Type

    Default value

    Description

    variableSet

    Suncode.form.view.gadget.variableset.VariableSet

    null

    Komponent tabeli dynamicznejRezultat funkcji

    Dynamic table component

     

    • Function result:Typ

    Type

    OpisParametry funkcji
    NazwaTyp

    Wartość domyślna

    Opis

    Description

    String

    Tytuł tabeli dynamicznej bez tagów HTMLgetInfo - zwraca informacje o tabeli dynamicznej.

    The title of the dynamic table without HTML tags

    • getInfo- returns information about the dynamic table.
    • Function parameters: 

    Name

    Type

    Default value

    Description

    variableSet

    Suncode.form.view.gadget.variableset.VariableSet

    null

    Komponent tabeli dynamicznej

    Dynamic table component

     

    •  

      Rezultat funkcji
      TypOpisObjectObiekt zawierający informacje o tabeli dynamicznej. Obiekt posiada następujące właściwościFunction result:

    Type

    Description

    Object

    An object containing information about a dynamic table. The object has the following properties:

        - id (

    Typ

    Type String)

         

    Identyfikator tabeli dynamicznej

    Dynamic table id

        - originalName(

    Typ

    Type String)

           Oryginalny tytuł tabeli dynamicznej (właściowiść

          The original title of the dynamic table (propertyDT_TABLE_NAME

    z konfiguracji

    from configuration)

        - title (

    Typ

    Type String)

          

    Tytuł tabeli dynamicznej bez tagów HTML

    The title of the dynamic table without HTML tags

        - columns (

    Typ

    Type Array)

          

    Tablica informacji o poszczególnych kolumnach. Każdy element jest typu Object i zawiera następujące właściwości

    Information table about individual columns. Each element is Typeu Object and contains the following properties:

            - id (

    Typ

    Type String)

      

             Identyfikator zmiennej procesu

            The id of the process variable

            - name (

    Typ

    Type String)

               

    Nazwa kolumny tabeli dynamicznej (nazwa zmiennej procesu) z uwzględnieniem tłumaczenia (nazwa widoczna w nagłówku

    Name of the dynamic table column (Name of the process variable) including the translation (Name visible in the header)

            -

    editable

     editable (

    Typ

    Type Boolean)

               

    Informuje, czy kolumna jest edytowalna

    Informs whether the column is editable

            - hidden (

    Typ

    Type Boolean)

      

             Informuje, czy kolumna jest ukryta

            Informs whether the column is hidden

     

    •  

      addRenderer (od from 3.1.6)  - pozwala na dodanie dowolnej funkcji renderującej wartość komórki w tabelce dynamicznej. Zarejestrować można dowolną liczbę rendererów, które zostaną wywołane zgodnie z kolejnością dodania.Parametry funkcji:

       

      NazwaTypWartość domyślnaOpis- allows to add any function that renders the value of a cell in the dynamic table. You can register any number of renderers that will be called according to the order in which they were added.
      • Function parameters: 

     

    Name

    Type

    Default value

    Description

    variableSet

    Suncode.form.view.gadget.variableset.VariableSet

    null

    Komponent tabeli dynamicznej

    Dynamic table component

    renderer

    Function

    null

    Funkcja renderująca wartość danych kolumn. Przyjmuje następujące parametry

    Function that renders the value of column data. It accepts the following parameters:

    - value:

    wartość komórki (nie formatowana) 

    cell value (not formatted)

    - data:

    obiekt całego rekordu (wiersza

    object of the entire record (row)

    Code Blockjsjs{ "id_zmiennej
    {
            "variable_id": "
    wartość
    value",
            
    "
    id
     variable_
    zmiennej2
    id2": "
    wartość2
    value2"
    }

    - column:

    identyfikator aktualnie renderowanej kolumny (id zmiennej) 

    - metaData: obiekt zawierający informacje o wierszu

    Code Blockjsjs{

    ID of the currently rendered column (variable id)

    metaData: object containing information about row

    {
            row: //
    indeks
    row 
    wiersza
    index (readonly)
            
    cell: //
    indeks
    column 
    kolumny
    index (readonly)
            
    style: //
    nadany
    given 
    styl
    element 
    elementu
    style TD
            
    cls: // 
    nadana
    given 
    klasa
    element class css 
    elementu
    TD
     
            
    // 3.1.7+
            
    encode: // 
    czy
    whether 
    kodować
    to 
    znaki
    encode characters html (
    domyślnie
    by default true)
    }
    warning

     

    Parametr

    metaData.encode

    może być wykorzystany w przypadku, gdy chcemy w komórce wstawić tagi html. W takim przypadku musimy sami zadbać o zakodowanie wartości wpisanej przez użytkownika.

     

    Funkcja może zwrócić wartość, która zostanie wpisana do komórki (o ile inne funkcje renderujące wywołane później nie zmienią tej wartości.

    Przykład:

    Code Blockjsjs// Rejestracja renderera

     parameter can be used if you want to insert html tags in your cell. In this case, we must take care of encoding the value entered by the user.

     

    The function can return a value that will be entered into the cell (unless other rendering functions called later will change this value.

    Example:

    // Renderer registration
    var vss = ServiceFactory.getVariableSetService();
     
    vss.addRenderer(vss.get(0), function(value, data, column, metaData){
     
            
    // 
    nadanie
    give 
    stylu
    style 
    na
    based 
    podstawie
    on 
    wartości
    value 
    zmienna1
    variable1
            
    metaData.style = 'color: ' + value; // 
    lub
    or data[column]
     
            
    // 
    nadanie
    give 
    klasy
    class 
    na
    based 
    podstawie
    on 
    wartości
    value 
    zmienna2
    variable2
            
    metaData.cls = data['
    zmienna2
    variable2'];
     
            
    // 
    nadanie
    giving 
    nowej
    a 
    wartości
    new value
            return 'rendered:' + value;
    }, ['
    zmienna1
    variable1']); // renderer 
    dla
    for 
    podanej
    the 
    kolumnyRezultat funkcji: brak
    given column

    columns

    String[]

    Wszystkie kolumny tabelkiTablica identyfikatorów zmiennych (kolumn) dla których ma obowiązywać ta funkcja renderująca. Jeżeli pominiemy ten parametr, funkcja będzie obowiązywać dla wszystkich zmiennych.

    All table columns

    An array of variable identifiers (columns) for which this rendering function is to be valid. If you omit this parameter, the function will apply to all variables.

     

    • Function result:null

     

     

    • removeRenderers (od from 3.1.6) - usuwa wszystkie funkcje renderujące z podanej zmiennej tabelki dynamicznejParametry funkcji:removes all rendering functions from the given dynamic table variable
    • Function parameters: 

     

    Nazwa

    Name

    Typ

    Type

    Wartość domyślna

    Default value

    Opis

    Description

    variableSet

    Suncode.form.view.gadget.variableset.VariableSet

    null

    Komponent tabelki dynamicznej
  • Rezultat funkcji: brak
  •  

    selectAll (od

    Dynamic table component

    columns

    String[]

    Wszystkie kolumny tabelkiTablica identyfikatorów zmiennych (kolumn) z których usunąć wszystkie funkcje renderujące.

    All table columns

    An array of variable identifiers (columns) from which to delete all rendering functions.

      • Function result:null

     

     

    • selectAll (from 3.1.8) - zaznacza wszystkie rekordy z tabeli dynamicznej (uwaga: wiąże się to z dodaniem do każdego rekordu określonej klasy css, rekordy nie są zwracane przez marks all records from the dynamic table (note: thisinvolves adding a specific css class to each record, records are not returned byselModel.getSelection()).
      • Parametry funkcjiFunction parametersNazwa

    Name

    Typ

    Type

    Wartość domyślna

    Default value

    Opis

    Description

    variableSet

    Suncode.form.view.gadget.variableset.VariableSet

    null

    Komponent tabeli dynamicznejRezultat funkcji: brak

    Dynamic table component

     

    • Function result:null

     

    • deselectAll (od from 3.1.8) - odznacza wszystkie rekordy z tabeli dynamicznej (uwaga: wiąże się to z usunięciem z każdego rekordu określonej klasy css).Parametry funkcji
      NazwaTyp

      Wartość domyślna

      Opisdeselects all records from the dynamic table (note:this involves deleting a particular css class from each record).
      • Function parameters: 

    Name

    Type

    Default value

    Description

    variableSet

    Suncode.form.view.gadget.variableset.VariableSet

    null

    Komponent tabeli dynamicznej
  • Rezultat funkcji: brak

  • getAllSelected (od

    Dynamic table componen

     

    • Function result:null

     

    • getAllSelected(from 3.1.8) - zwraca wszystkie zaznaczone rekordy (za pomocą funkcji selectAll, czyli posiadające określona klasę css).
      Parametry funkcji
      NazwaTyp

      Wartość domyślna

      Opisreturns all selected records (using functionselectAll, that is, having a specific css class).
    • Function parameters: 

    Name

    Type

    Default value

    Description

    variableSet

    Suncode.form.view.gadget.variableset.VariableSet

    null

    Komponent tabeli dynamicznejRezultat funkcji

    Dynamic table component

    • Function result:Typ

    Type

    Opis

     

     

    Description

    Ext.data.Model[]

    Tablica zaznaczonych rekordów

    Table of selected records

    • minimize (od from 3.1.25) - minimalizuje tabelę dynamicznąminimizes the dynamic table.
      • Parametry funkcjiFunction parametersNazwa

    Name

    Typ

    Type

    Wartość domyślna

    Default value

    Opis

    Description

    variableSet

    Suncode.form.view.gadget.variableset.VariableSet

    null

    Komponent tabeli dynamicznejRezultat funkcji: brak

    Dynamic table component

    • Function result:null

     

    • maximize (od from 3.1.25) - maksymalizuje tabelę dynamicznąmaximizes the dynamic table.
      • Parametry funkcjiFunction parametersNazwa

    Name

    Typ

    Type

    Wartość domyślna

    Default value

    Opis

    Description

    variableSet

    Suncode.form.view.gadget.variableset.VariableSet

    null

    Komponent tabeli dynamicznej
  • Rezultat funkcji: brak

  • Dynamic table component

    • Function result:null