Versions Compared

Key

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

...

ElementOpisPrzykłady akcjiWybór w PWE
form

Formularz

Akcja dodana do formularza inicjowana jest metodą formInit.

Akcje w których nie można wskazać głównego elementu np.

  • ukrywanie wielu zmiennych jednocześnie
variable

Zmienna

Akcja dodana do zmiennej formularza inicjowana jest metodą variableInit w parametrze otrzymując obiekt tej zmiennej (

Jsdoc
propertyjsdoc.plusworkflow
classNamePW.form.variable.Variable
).

Akcje w których można jednoznacznie wskazać zmienną, której akcje dotyczy (w największym stopniu) np.

  • ukrywanie zmiennej
  • walidacja zmiennej na żywo (np. pokazanie komunikatu bez akceptacji)
variableset

Tabelka dynamiczna

Akcja dodana do zmiennej formularza inicjowana jest metodą variableSetInit w parametrze otrzymując obiekt tabelki dynamicznej (

Jsdoc
propertyjsdoc.plusworkflow
classNamePW.form.field.VariableSet
).

Akcje które dotyczą tabelki dynamicznej i potrzebują jej identyfikator np.

  • nadanie tytułu tabelce na podstawie obliczeń
  • import danych do tabelki (akcja dodaje przycisk do tabelki)
button

Przycisk

Akcja dodana do przycisku formularza inicjowana jest metodą buttonInit w parametrze otrzymując obiekt przycisku (

Jsdoc
propertyjsdoc.plusworkflow
classNamePW.form.button.Button
).

Akcje których źródłem jest przycisk np.

  • dodawanie komentarza przed akceptacją
  • wyświetlanie komunikatów po kliknięciu przycisku

 


...


Akcje domyślne

W celu ułatwienia tworzenia akcji które reagują na domyślne zdarzenia elementów docelowych możliwe jest zdefiniowanie tzw. akcji domyślnych. 

Twórca akcji może zadeklarować funkcje, które wykonają się automatycznie, jeżeli wystąpi zdarzenie skojarzone z elementem docelowym akcji np. jeżeli akcja dodana jest do przycisku, to klikniecie w ten przycisk spowoduje wywołanie zdefiniowanej akcji domyślnej.

Info

Akcje domyślne są wywoływane tylko jeżeli warunek wykonania akcji jest spełniony.

Parametry wywołania akcji domyślnej są takie same jak parametry zdarzeń, które są źródłem wywołania akcji domyślnej.

Zdarzenia domyślne w zależności od elementu docelowego akcji:

Element docelowyNazwa funkcjiDomyślne zdarzenieOpis
ActionDestination.button()
button
click (
Jsdoc
displayValuedoc
propertyjsdoc.plusworkflow
classNamePW.form.button.Button
)
Funkcja wywoływana jest po kliknięciu na przycisk, do którego dodana jest akcja.
ActionDestination.variable()
variable
change (
Jsdoc
displayValuedoc
propertyjsdoc.plusworkflow
classNamePW.form.variable.Variable
)
Funkcja wywoływana jest po zmianie wartości zmiennej, do której dodana jest akcja.
ActionDestination.variableSet()
variableSet
change (
Jsdoc
displayValuedoc
propertyjsdoc.plusworkflow
classNamePW.form.field.VariableSet
)
Funkcja wywoływana jest jeżeli zmieni się wartość jakiejkolwiek zmiennej należącej do tabeli dynamicznej, do której dodana jest akcja.

Poniżej przykładowa implementacja akcji pokazującej skonfigurowaną wiadomość. W zależności elementu docelowego wiadomość pokaże się przy naciśnięciu przycisku, zmianie wartości zmiennej lub zmianie danych w tabelce.

Code Block
PW.FormActions.create('message', {
	
	// domyślne akcje
	defaultActions: {
		button: function(button){
			this.showMsg();
		},
		variable: function(variable, newValue, oldValue){
			this.showMsg();
		},
		variableSet: function(variableSet, added, updated, removed){
			this.showMsg();
		}
	},	
	
	showMsg: function(){
		ServiceFactory.getMessageService().showSuccess(this.get('msg'));
	}
});

 

Code Block
PW.FormActions.create('message', {
	
	buttonInit: function(button){
		this.button.on('click', this.showMsg);
	},
 
	variableInit: function(button){
		this.button.on('click', this.showMsg);
	},
 
	variableSetInit: function(button){
		this.button.on('click', this.showMsg);
	},
	showMsg: function(){
		if(this.isEnabled){
			ServiceFactory.getMessageService().showSuccess(this.get('msg'));
		}		
	}
});

 

 



Własności

  • id - unikalny w obrębie całego systemu identyfikator akcji,
  • name - nazwa akcji (obsługuje tłumaczenia),
  • description - opis akcji (obsługuje tłumaczenia),
  • icon - ikona akcji,
  • category - kategoria, do której należy akcja (może być wiele),
  • destination - element formularza, dla którego dostępna jest akcja (może być wiele)
  • parameters - parametry akcji.

...