Page History

...

• Fields - zawiera dowolną ilość elementów Field. Określają one kolejne pola na formularzu parametrów aplikacji. Wartość domyślna: pole tekstowe (Type=text). Element Field posiada następujące podelementy i atrybuty:
  • parameterId - atrybut, określa identyfikator parametru aplikacji. Wartość pola zostanie przypisana do określonego parametru. Pole może być polem pomocniczym, więc określenie artybutu atrybutu parameterId nie jest wymagane. Wartość domyślna: null.

  • Id - element, określa identyfikator pola na formularzu (właściwość itemId). Powinien być unikalny w ramach formularza. Pozwala wykonywać operacje na polu za pomocą API JS za pomocą podania identyfikatora. Żadna akcja nie musi być wykonywana na polu, więc nie ma konieczności definiowania elementu Id. Wartość domyślna: null.

  • Active - element, określa, czy pole jest aktywne (nie jest zablokowane i jego wartość jest brana pod uwagę w uzupełnianiu parametrów aplikacji). Właściwość ta pozwala posiadać kilka typów pól przypisanych dla jednego parametru aplikacji, które są aktywowane odpowiednio w zależności od innych okoliczności. Należy jedynie pamiętać, żeby tylko jedno pole dla danego parametru aplikacji było aktywne, gdyż w przeciwnym przypadku pobrana wartość będzie losowa. Wartość domyślna: true.

  • AllowBlank - element, określa, czy wartość pola może pozostać pusta. Pola, które mają tą właściwość ustawioną na true nie zgłaszają błędu podczas standardowej walidacji formularza. Wartość domyślna: true.

  • CustomProperty - element, określa wartość właściwości pola o nazwie customProperty. Pozwala oznaczać pola i grupować je, co ułatwia ich odszukanie wyszukanie na formularzu. Wartość domyślna: null.

  • DefaultValue - element, określa domyślną wartość pola, którym jest one uzupełnione po otwarciu formularza. Wartość domyślna: null.

  • Description - element, określa opis pola. Dodawana jest ikona w etykiecie, po najechaniu na którą jest on wyświetlanyna której po umieszczeniu kursora myszki jest wyświetlana informacja z podanym opisem. Wartość domyślna: właściwość description adnotacji StandardToolParameter @StandardToolParameter (dopasowanie pola i parametru następuje przez właściwość id adnotacji StandardToolParameter @StandardToolParameteri atrybut parameterId).

  • Hidden - element, określa, czy pole jest ukryte na formularzu. Wartość domyślna: false.

  • Label - element, określa etykietę pola (gdy pole jest tabelą, określa jej tytuł). Wartość domyślna: null.

  • Table - element, określa, czy pole jest tabelą. Tabela składa się z jednej kolumny Wartość, w której każda komórka zawiera edytor zdefiniowany przez aktualny element Field. Wartość domyślna: false.

  • TimeIncrement - element, określa odstęp w minutach między kolejnymi wartościami na liście dla pola typu time. Wartość domyślna: 30.

  • Type- element, określa typ pola. Wartość domyślna: text. Akceptowane wartości to:
    • text - pole tekstowe
    • textarea - wieloliniowe pole tekstowe
    • float - pole dziesiętne
    • integer - pole całkowite
    • date - pole datowe w formacie Y-m-d
    • time - pole czasowe w formie listy rozwijanej z wartościami w formacie H:i
    • radiobutton - pole jednokrotnego wyboru, wymaga zdefiniowania elementu Values w elemencie Field
    • htmlarea - wieloliniowe pole edycji HTML
    • staticlist - lokalna nieedytowalna lista rozwijana ze stałymi wartościami, wymaga zdefiniowania elementu Values w elemencie Field
    • editablestaticlist - lokalna edytowalna lista rozwijana ze stałymi wartościami, wymaga zdefiniowania elementu Values w elemencie Field
    • dynamiclist - zdalna nieedytowalna lista rozwijana uzupełniana wartościami po stronie serwera, wymaga zdefiniowania elementu DynamicListConfiguration w elemencie Field
    • editabledynamiclist - zdalna edytowalna lista rozwijana uzupełniana wartościami po stronie serwera, wymaga zdefiniowania elementu DynamicListConfiguration w elemencie Field
    • servicecaller - pole wywołujące serwis, wymaga zdefiniowania elementu ServiceCallerConfiguration w elemencie Field
    • variable - lista rozwijana zmiennych procesu

  • Values - element, zawiera dowolną ilość elementów Value. Określają one wartości na potrzeby niektórych typów pól. Element Value posiada następujące podelementy:

    • Id - identyfikator wartości. Stanowi ukrytą wartość pola podczas pobierania jego wartości. Element jest wymagany. Wartość domyślna: null.

    • Value - nazwa wartości. Stanowi widoczną wartość pola. Wartość domyślna: null.

    • Description - opis wartości. Wartość domyślna: "".
  • TableConfiguration- element, określa konfigurację pola w postaci tabeli. Posiada następujące podelementy:
    • CellValuesSeparator - określa separator wartości z poszczególnych komórek w tabeli. Wartość domyślna: ";".
  • aaa
• Validators - zawiera dowolną ilość elementów Validator. Określają one dodatkowe walidacje (poza standardową walidacją uzupełnienia wartości oraz poprawności formatu danych w polu) podczas zapisywania formularza parametrów aplikacji. Jeżeli przynajmniej jeden z walidatorów nie zwaliduje poprawnie formularza, to zapis parametrów aplikacji jest przerywany. Wartość domyślna: null. Element Validatorposiada następujące podelementy:
  • Name - zawiera węzeł tekstowy, określa nazwę walidatora. Dostępne są następujące walidatory:
    • areNotEmptyValidator - sprawdza, czy wartość określonego pola została podana. Wymaga podania parametru FieldId.
    • customScriptValidator - wykonuje skrypt zdefiniowany przez twórcę szablonu formularza w celu dokonania walidacji. Oczekiwane jest zwrócenie w skrypcie wartości true lub false w zależności od poprawności formularza. Wymaga zdefiniowania elementu JavaScriptCode.
  • Parameters - zawiera dowolną ilość elementów Parameter. Są to parametry przekazywane do walidatora. Element Parameterposiada następujące podelementy:
    • FieldId - zawiera węzeł tekstowy, określa identyfikator pola na formularzu. Wartość domyślna: null.
    • JavaScriptCode - zawiera węzeł tekstowy zawarty w znacznikach <![CDATA[ i ]]>. Definiuje skrypt wykonywany podczas walidacji formularza za pomocą walidatora customScriptValidator. Wykonywany skrypt powinien zwrócić true lub false w zależności od poprawności formularza. Podczas wykonywania kodu na globalnym scope dostępne są takie obiekty jak: formApi (API JS formularza udostępniające zestaw funkcji, opis poniżej), Ext (framework Ext JS). Wartość domyślna: null.

4. Akcje przycisków tabeli dynamicznej:

...