VariableSetService

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

• hide - ukrywa tabele dynamiczne
  

  • Parametry funkcji: 
    
    

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

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

    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ą. 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: 
    
    

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

    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

  
  

   

   

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

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

    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

  
  

   

   

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

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

    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

  
  
  

   

• addBottomToolbarButton - dodaje przycisk do dolnej belki.

  • Parametry funkcji: 
    
    

    Nazwa	Typ	Wartość domyślna	Opis
    variableSet	Suncode.form.view.gadget.variableset.VariableSet	null	Komponent tabeli dynamicznej
    button	Object/Ext.button.Button	null	Obiekt konfiguracyjny przycisku (podawany do tworzenia Ext.button.Button)

    
    

  • Rezultat funkcji:brak

  
  
  

   

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

  • Parametry funkcji: 
    
    

    Nazwa	Typ	Wartość domyślna	Opis
    variableSet	Suncode.form.view.gadget.variableset.VariableSet	null	Komponent tabeli dynamicznej
    button	Object/Ext.button.Button	null	Obiekt konfiguracyjny przycisku (podawany do tworzenia Ext.button.Button)
    index	Integer	null	Pozycja, 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: 
    
    

    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

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

  • 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
    name	String	null	Nazwa kolumny

    
    

  • Rezultat funkcji: brak

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

  • Parametry funkcji: 
    
    

    Nazwa	Typ	Wartość domyślna	Opis
    variableSet	Suncode.form.view.gadget.variableset.VariableSet	null	Komponent tabeli dynamicznej
    tool	Object/Ext.panel.Tool	null	Obiekt konfiguracyjny narzędzia (podawany do tworzenia Ext.panel.Tool)

    
    

  • Rezultat funkcji: brak

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

  • Parametry funkcji: 
    
    

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

    
    

  • Rezultat funkcji:
    
    

    Typ	Opis
    String	Tytuł tabeli dynamicznej bez tagów HTML

• getInfo - zwraca informacje o 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

    Object

    Obiekt zawierający informacje o tabeli dynamicznej. Obiekt posiada następujące właściwości:     - 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