Package io.jmix.bulkeditor.action

Class BulkEditAction<E>

java.lang.Object

io.jmix.flowui.kit.action.AbstractAction

io.jmix.flowui.kit.action.BaseAction<BulkEditAction<E>>

io.jmix.flowui.action.ObservableBaseAction<BulkEditAction<E>>

io.jmix.flowui.action.SecuredBaseAction<BulkEditAction<E>>

io.jmix.flowui.action.list.ListDataComponentAction<BulkEditAction<E>,E>

io.jmix.flowui.action.list.SecuredListDataComponentAction<BulkEditAction<E>,E>

io.jmix.bulkeditor.action.BulkEditAction<E>

Type Parameters:

E - entity type

All Implemented Interfaces:

ExecutableAction, SecurityConstraintAction, TargetAction<ListDataComponent<E>>, Action, HasShortcutCombination

@ActionType("bulked_edit")
public class BulkEditAction<E>
extends SecuredListDataComponentAction<BulkEditAction<E>,E>
implements ExecutableAction

Standard action for changing attribute values for several entity instances at once.

Should be defined for a list data component in a screen XML descriptor.

The action instance can be parameterized using the nested properties XML element or programmatically in the screen controller.

Nested Class Summary

Nested classes/interfaces inherited from class io.jmix.flowui.action.SecuredBaseAction

SecuredBaseAction.EnabledRule

Field Summary

Fields

Modifier and Type	Field	Description
protected BulkEditors	bulkEditors
protected String	exclude
protected Function<List<MetaProperty>,Map<MetaProperty,Integer>>	fieldSorter
static final String	ID
protected List<String>	includeProperties
protected boolean	useConfirmDialog
protected boolean	visibleBySpecificUiPermission

Fields inherited from class io.jmix.flowui.action.list.SecuredListDataComponentAction

accessManager, applicationContext, constraintEntityOp, metadata

Fields inherited from class io.jmix.flowui.action.list.ListDataComponentAction

selectionListenerRegistration, target

Fields inherited from class io.jmix.flowui.action.SecuredBaseAction

enabledRules

Fields inherited from class io.jmix.flowui.action.ObservableBaseAction

uiObservationSupport

Fields inherited from class io.jmix.flowui.kit.action.BaseAction

enabledExplicitly, visibleExplicitly

Fields inherited from class io.jmix.flowui.kit.action.AbstractAction

description, enabled, eventBus, icon, id, shortcutCombination, text, variant, visible

Fields inherited from interface io.jmix.flowui.kit.action.Action

PROP_DESCRIPTION, PROP_ENABLED, PROP_ICON, PROP_SHORTCUT_COMBINATION, PROP_TEXT, PROP_VARIANT, PROP_VISIBLE

Constructor Summary

Constructors

Constructor	Description
BulkEditAction()
BulkEditAction(String id)

Method Summary

Modifier and Type	Method	Description
void	execute()	Executes the action.
@Nullable String	getExclude()
@Nullable List<String>	getIncludeProperties()
boolean	getUseConfirmDialog()
protected boolean	isPermitted()
protected boolean	isVisibleBySpecificUiPermission()
protected void	setAccessManager(AccessManager accessManager)
void	setBulkEditors(BulkEditors bulkEditors)
void	setExclude(String exclude)
void	setFieldSorter(Function<List<MetaProperty>,Map<MetaProperty,Integer>> fieldSorter)
protected void	setIcons(Icons icons)
void	setIncludeProperties(List<String> includeProperties)
protected void	setMessages(Messages messages)
void	setUseConfirmDialog(boolean useConfirmDialog)
protected void	setVisibleInternal(boolean visible)
BulkEditAction<E>	withExclude(String exclude)
BulkEditAction<E>	withFieldSorter(Function<List<MetaProperty>,Map<MetaProperty,Integer>> fieldSorter)
BulkEditAction<E>	withIncludeProperties(List<String> includeProperties)
BulkEditAction<E>	withUseConfirmDialog(boolean useConfirmDialog)

Methods inherited from class io.jmix.flowui.action.list.SecuredListDataComponentAction

getConstraintEntityOp, isApplicable, setApplicationContext, setConstraintEntityOp, setMetadata, withConstraintEntityOp

Methods inherited from class io.jmix.flowui.action.list.ListDataComponentAction

actionPerform, attachSelectionListener, checkTarget, checkTargetItems, getTarget, initAction, onSelectionChange, setTarget, withTarget

Methods inherited from class io.jmix.flowui.action.SecuredBaseAction

addEnabledRule, isEnabledByRule, refreshState, removeEnabledRule

Methods inherited from class io.jmix.flowui.action.ObservableBaseAction

getUiObservationSupport

Methods inherited from class io.jmix.flowui.kit.action.BaseAction

addActionPerformedListener, self, setEnabled, setEnabledInternal, setVisible, withDescription, withEnabled, withHandler, withIcon, withShortcutCombination, withText, withVariant, withVisible

Methods inherited from class io.jmix.flowui.kit.action.AbstractAction

addPropertyChangeListener, firePropertyChange, getDescription, getEventBus, getIcon, getIconComponent, getId, getShortcutCombination, getText, getVariant, hasListener, isEnabled, isVisible, setDescription, setIcon, setIconComponent, setShortcutCombination, setText, setVariant

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface io.jmix.flowui.kit.action.Action

actionPerform, addPropertyChangeListener, getDescription, getIcon, getIconComponent, getId, getText, getVariant, isEnabled, isVisible, refreshState, setDescription, setEnabled, setIcon, setIconComponent, setText, setVariant, setVisible

Methods inherited from interface io.jmix.flowui.kit.component.HasShortcutCombination

getShortcutCombination, setShortcutCombination

Field Details

ID

public static final String ID

See Also:

• Constant Field Values

bulkEditors

protected BulkEditors bulkEditors

exclude

protected String exclude

fieldSorter

protected Function<List<MetaProperty>,Map<MetaProperty,Integer>> fieldSorter

includeProperties

protected List<String> includeProperties

useConfirmDialog

protected boolean useConfirmDialog

visibleBySpecificUiPermission

protected boolean visibleBySpecificUiPermission

Constructor Details

BulkEditAction

public BulkEditAction()

BulkEditAction

public BulkEditAction(String id)

Method Details

getExclude

public @Nullable String getExclude()

Returns:

regular expression to exclude fields if it was set by setExclude(String) or in the screen XML. Otherwise, returns null

setExclude

public void setExclude(String exclude)

Parameters:

exclude - regular expression to exclude some fields explicitly from the list of attributes available for editing

setFieldSorter

public void setFieldSorter(Function<List<MetaProperty>,Map<MetaProperty,Integer>> fieldSorter)

Parameters:

fieldSorter - function to sort fields by custom logic

getIncludeProperties

public @Nullable List<String> getIncludeProperties()

Returns:

list entity attributes to be included to bulk editor window if it was set by setIncludeProperties(List) or in the screen XML. Otherwise, returns null

setIncludeProperties

public void setIncludeProperties(List<String> includeProperties)

Parameters:

includeProperties - entity attributes to be included to bulk editor window. If set, other attributes will be ignored

getUseConfirmDialog

public boolean getUseConfirmDialog()

Returns:

true/false whether confirmation dialog setUseConfirmDialog(boolean) is used.

setUseConfirmDialog

public void setUseConfirmDialog(boolean useConfirmDialog)

Parameters:

useConfirmDialog - flag whether the confirmation dialog should be displayed to the user before saving the changes. The default value is true

setMessages

@Autowired
protected void setMessages(Messages messages)

setIcons

@Autowired
protected void setIcons(Icons icons)

setAccessManager

@Autowired
protected void setAccessManager(AccessManager accessManager)

Overrides:

setAccessManager in class SecuredListDataComponentAction<BulkEditAction<E>,E>

isVisibleBySpecificUiPermission

protected boolean isVisibleBySpecificUiPermission()

setVisibleInternal

protected void setVisibleInternal(boolean visible)

Overrides:

setVisibleInternal in class BaseAction<BulkEditAction<E>>

setBulkEditors

@Autowired
public void setBulkEditors(BulkEditors bulkEditors)

isPermitted

protected boolean isPermitted()

Overrides:

isPermitted in class SecuredListDataComponentAction<BulkEditAction<E>,E>

execute

public void execute()

Executes the action.

Specified by:

execute in interface ExecutableAction

withExclude

public BulkEditAction<E> withExclude(String exclude)

See Also:

• setExclude(String)

withFieldSorter

public BulkEditAction<E> withFieldSorter(Function<List<MetaProperty>,Map<MetaProperty,Integer>> fieldSorter)

See Also:

• setFieldSorter(Function)

withIncludeProperties

public BulkEditAction<E> withIncludeProperties(List<String> includeProperties)

See Also:

• setIncludeProperties(List)

withUseConfirmDialog

public BulkEditAction<E> withUseConfirmDialog(boolean useConfirmDialog)

See Also:

• setUseConfirmDialog(boolean)