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: 
    
    

    Nazwa	Typ	Wartość domyślna	Opis
    variableSetIdParam	String/Number	null	Identyfikator tabeli dynamicznej/Numer tabeli dynamicznej na formularzu zgodnie z mapą procesu (pierwsza tabela ma numer 0)

    
    

  • Rezultat funkcji:
    
    

    Typ	Opis
    Suncode.form.view.gadget.variableset.VariableSet	Komponent tabeli dynamicznej lub undefined, jeśli nie znaleziono

    
    
    

• getAll - zwraca wszystkie komponenty tabel dynamicznych.
  

  • Parametry funkcji: 
    
    

    Nazwa	Typ	Wartość domyślna	Opis
    getEditable	Boolean	false	Informacja, czy zwracac tylko edytowalne tabele dynamiczne

    
    

  • Rezultat funkcji:
    
    

    Typ	Opis
    Suncode.form.view.gadget.variableset.VariableSet[]	Tablica komponentów tabel dynamicznych lub pusta tablica, jeśli nie znaleziono żadnej tabeli

    
    
    

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

  • Parametry funkcji: 
    
    

    Nazwa	Typ	Wartość domyślna	Opis
    variableSet	Suncode.form.view.gadget.variableset.VariableSet	null	Komponent tabeli dynamicznej
    startEditing	Boolean	false	Informuje, czy rozpocząć edycję pierwszej edytowalnej komórki nowo dodanego rekordu
    records	Object/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

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

  • Parametry funkcji: 
    
    

    Nazwa	Typ	Wartość domyślna	Opis
    variableSet	Suncode.form.view.gadget.variableset.VariableSet	null	Komponent tabeli dynamicznej

    
    

  • Rezultat funkcji:
    
    

    Typ	Opis
    Ext.data.Model	Aktualnie zaznaczony rekord

• deleteSelected - usuwa wszystkie zaznaczone rekordy w tabeli dynamicznej.
  

  • Parametry funkcji: 
    
    

    Nazwa	Typ	Wartość domyślna	Opis
    variableSet	Suncode.form.view.gadget.variableset.VariableSet	null	Komponent tabeli dynamicznej

    
    

  • Rezultat funkcji: brak

• copySelected - kopiuje wszystkie zaznaczone rekordy w tabeli dynamicznej.
  

  • Parametry funkcji: 
    
    

    Nazwa	Typ	Wartość domyślna	Opis
    variableSet	Suncode.form.view.gadget.variableset.VariableSet	null	Komponent tabeli dynamicznej

    
    

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

  • Parametry funkcji: 
    
    

    Nazwa	Typ	Wartość domyślna	Opis
    variableSet	Suncode.form.view.gadget.variableset.VariableSet	null	Komponent tabeli dynamicznej
    record	Ext.data.Model	null	Obiekt rekordu tabeli dynamicznej

    
    

     

  • Rezultat funkcji:
    
    

    Typ	Opis
    Integer	Numer wiersza

• getColumnIndex - zwraca numer kolumny dla danej zmiennej formularza.
  

  • Parametry funkcji: 
    
    

    Nazwa	Typ	Wartość domyślna	Opis
    variableSet	Suncode.form.view.gadget.variableset.VariableSet	null	Komponent tabeli dynamicznej
    variableId	String	null	Identyfikator zmiennej formularza (identyfikator zmiennej procesu) znajdującej się w tabeli dynamicznej

    
    

  • Rezultat funkcji:
    
    

    Typ	Opis
    Integer	Numer kolumny

• getValue - zwraca wartość zmiennej formularza w konkretnej komórce w tabeli dynamicznej.
  

  • Parametry funkcji: 
    
    

    Nazwa	Typ	Wartość domyślna	Opis
    variableSet	Suncode.form.view.gadget.variableset.VariableSet	null	Komponent tabeli dynamicznej
    rowIndex	Integer	null	Numer wiersza rekordu (pierwszy wiersz ma numer 0)
    variableId	String	null	Identyfikator zmiennej formularza (identyfikator zmiennej procesu) znajdującej się w tabeli dynamicznej

    
    

     

  • Rezultat funkcji:
    
    

    Typ	Opis
    Object	Wartość zmiennej w komórce

• setValue - ustawia wartość zmiennej formularza w konkretnej komórce w tabeli dynamicznej.
  

  • Parametry funkcji: 
    
    

    Nazwa	Typ	Wartość domyślna	Opis
    variableSet	Suncode.form.view.gadget.variableset.VariableSet	null	Komponent tabeli dynamicznej
    rowIndex	Integer	null	Numer wiersza rekordu (pierwszy wiersz ma numer 0)
    variableId	String	null	Identyfikator zmiennej formularza (identyfikator zmiennej procesu) znajdującej się w tabeli dynamicznej
    value	Object	null	Wartość zmiennej formularza

    
    

  • Rezultat funkcji: brak
    
    
    

• save - zapisuje rekordy tabeli dynamicznej do kontekstu zadania.
  

  • Parametry funkcji: 
    
    

    Nazwa	Typ	Wartość domyślna	Opis
    variableSet	Suncode.form.view.gadget.variableset.VariableSet	null	Komponent tabeli dynamicznej

    
    

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

  • Parametry funkcji: 
    
    

    Nazwa	Typ	Wartość domyślna	Opis
    variableSet	Suncode.form.view.gadget.variableset.VariableSet	null	Komponent tabeli dynamicznej
    rowIndex	Integer	null	Numer wiersza rekordu (pierwszy wiersz ma numer 0)
    variableId	String	null	Identyfikator 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: 
    
    

    Nazwa	Typ	Wartość domyślna	Opis
    variableSet	Suncode.form.view.gadget.variableset.VariableSet	null	Komponent tabeli dynamicznej
    rowIndex	Integer	null	Numer wiersza rekordu (pierwszy wiersz ma numer 0)
    variableId	String	null	Identyfikator 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: 
    
    

    Nazwa	Typ	Wartość domyślna	Opis
    variableSet	Suncode.form.view.gadget.variableset.VariableSet	null	Komponent tabeli dynamicznej

    
    

     

  • Rezultat funkcji:
    
    

    Typ	Opis
    String	Zawartość tabeli w formie JSON

     

     

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

  • Parametry funkcji: 
    
    

    Nazwa	Typ	Wartość domyślna	Opis
    variableSet	Suncode.form.view.gadget.variableset.VariableSet	null	Komponent tabeli dynamicznej

    
    

  • Rezultat funkcji:
    
    

    Typ	Opis
    Integer	Ilość wierszy w tabeli dynamicznej

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

  • Parametry funkcji: 
    
    

    Nazwa	Typ	Wartość domyślna	Opis
    variableSet	Suncode.form.view.gadget.variableset.VariableSet	null	Komponent tabeli dynamicznej
    variableId	String	null	Zmienna procesu identyfikująca kolumnę w tabeli dynamicznej
    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)

    
    

  • Rezultat funkcji:
    
    

    Typ	Opis
    Integer/String	Sumę 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: 
    
    

    Nazwa	Typ	Wartość domyślna	Opis
    variableSet	Suncode.form.view.gadget.variableset.VariableSet	null	Komponent tabeli dynamicznej
    title	String	null	Tytuł (możliwe jest podawanie tagów HTML)

    
    

  • Rezultat funkcji: brak

• removeBottomToolbarButtons - usuwa wszystkie przyciski z dolnej belki oraz ukrywa ją.

  • Parametry funkcji: 
    
    

    Nazwa	Typ	Wartość domyślna	Opis
    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.

  • Parametry funkcji: 
    
    

    Nazwa	Typ	Wartość domyślna	Opis
    variableSet	Suncode.form.view.gadget.variableset.VariableSet	null	Komponent tabeli dynamicznej
    itemId	String	null	Identyfikator 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

  
  

   

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

    Nazwa	Typ	Wartość domyślna	Opis
    variableSet	Suncode.form.view.gadget.variableset.VariableSet	null	Komponent tabeli dynamicznej
    criteria	Object[]	[]	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:
    
    

    Typ	Opis
    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: 
    
    

    Nazwa	Typ	Wartość domyślna	Opis
    variableSet	Suncode.form.view.gadget.variableset.VariableSet	null	Komponent tabeli dynamicznej
    criteria	Object[]	[]	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:
    
    

    Typ	Opis
    Integer	Ilość usuniętych rekordów

  
  

   

• clear - usuwa wszystkie rekordy z tabeli dynamicznej.

  • Parametry funkcji: 
    
    

    Nazwa	Typ	Wartość domyślna	Opis
    variableSet	Suncode.form.view.gadget.variableset.VariableSet	null	Komponent tabeli dynamicznej
    silent	Boolean	false	Informuje, 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: 
    
    

    Nazwa	Typ	Wartość domyślna	Opis
    variableSet	Suncode.form.view.gadget.variableset.VariableSet	null	Komponent tabeli dynamicznej
    variableId	String	null	Zmienna procesu identyfikująca kolumnę w tabeli dynamicznej

    
    

  • Rezultat funkcji: brak

• hideColumn - ukrywa kolumnę w tabeli dynamicznej.

  • Parametry funkcji: 
    
    

    Nazwa	Typ	Wartość domyślna	Opis
    variableSet	Suncode.form.view.gadget.variableset.VariableSet	null	Komponent tabeli dynamicznej
    variableId	String	null	Zmienna 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: 
    
    

    Nazwa	Typ	Wartość domyślna	Opis
    variableSet	Suncode.form.view.gadget.variableset.VariableSet	null	Komponent tabeli dynamicznej
    variableId	String	null	Zmienna procesu identyfikująca kolumnę w tabeli dynamicznej

    
    

  • Rezultat funkcji:
    
    

    Typ	Opis
    String	Nazwa kolumny w tabeli dynamicznej lub null, jeżeli kolumna o podanym identyfikatorze nie istnieje w tabeli