Versions Compared

Key

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

...

ElementOpisPrzykłady akcjiWybór w PWE
ActionDestination.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
ActionDestination.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)
ActionDestination.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)
ActionDestination.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
ActionDestination.dtButton()

Przycisk na tabeli

Akcja dodana do przycisku na tabeli formularza inicjowana jest metodą dtButtonInit w parametrze otrzymując obiekt przycisku (

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

 

Akcja dodawana jest na poziomie dodawania/edytowania przycisku tabeli formularza:

Image Added

Inicjalizacja akcji

Warning

Funkcjonalność jeszcze niedostępna.

...

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.

Tip

Można przerwać akceptację formularza poprzez zwrócenie false:

Code Block
languagejs
defaultActions: {
	button: function(button){
		// do some job
		return false;
	}
}
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.
ActionDestination.form()
form
enable (
Jsdoc
displayValuedoc
propertyjsdoc.plusworkflow
classNamePW.form.action.Action
)
Funkcja wywoływana jest, jeżeli zostanie spełniony warunek dla akcji. (Funkcjonalność jeszcze niedostępna)
ActionDestination.dtButton()
dtButtonclick (
Jsdoc
displayValuedoc
propertyjsdoc.plusworkflow
classNamePW.form.button.DtButton
)
Funkcja wywoływana jest po kliknięciu na przycisk w tabeli, do którego dodana jest akcja.

Poniżej przykładowa implementacja akcji pokazującej skonfigurowaną wiadomość. W zależności od 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();
		},
		dtButton: function(button){
			this.showMsg();
		},
	},	
	
	showMsg: function(){
		ServiceFactory.getMessageService().showSuccess(this.get('msg'));
	}
});

...