de.ipcon.form

Interface DetailViewOwnerI

All Superinterfaces:

FormElementI, L10nApplicatorI

All Known Implementing Classes:

FPopup, FScheduler, FTable

public interface DetailViewOwnerI
extends FormElementI

A common interface for Form Elements (FE) that manage or contain a specific FDetailView.

This interface bridges the gap between a parent container (the owner) and a detail view that displays Business Object (BO) data, facilitating data synchronization, selection handling, and transaction participation.

Field Summary

Fields inherited from interface de.ipcon.form.FormElementI

ALL_ACTIONS, AVAILABLE_ACTION_KIND, CONTEXTMENU_ACTION_KIND, LOCAL_ACTION_KIND, log, MENU_ACTION_KIND, NO_LOCAL_ACTION_KIND, NO_TOPMDI_ONLY_ACTION_KIND, NOT_AVAILABLE_ACTION_KIND, REFRESH_FROM_SHOW_POPUP, REFRESH_FROM_TRANSACTION, REFRESH_FROM_USER, SHORTCUT_ACTION_KIND, TOOLBAR_ACTION_KIND, TOPMDI_ONLY_ACTION_KIND

Method Summary

Modifier and Type	Method and Description
FDetailView	getDetailView() Retrieves the specific detail view instance managed by this owner.
default java.util.Set<BO>	getInvolvedBOsForMandatoryCheck() Returns a subset of known BOs that are relevant for validation checks (i.e. mandatory fields) during the current transaction.
java.util.Set<BO>	getKnownBOs() Returns the set of all Business Objects (BOs) currently loaded or managed by this component.
void	replaceDetailViewBO(BO bo) Replaces the primary (anchor) Business Object currently displayed in the detail view.
void	selectBO(BO toSelect) Instructs the owner to select or highlight a specific Business Object.

Methods inherited from interface de.ipcon.form.FormElementI

addBeanA, addBeanA, addFormElementListener, addHandleA, addHandleA, addHandleE, addHandleE, afterSave, afterSetValue, applyL10n, beforeSave, beforeSetValue, close, getActions, getActionsOfKind, getAttributeMap, getConfRoot, getCtx, getDebugName, getDefinitionErrorHandler, getElementConsideringIgnored, getElementMap, getFtx, getName, getSchema, handleAttributes, handleElement, handleElements, handleElements, handleElements, handleElements, handleError, handleNewElement, handleNewElement, handleNewElement, isClosed, isDebug, isEditable, isGUIBuilt, isIgnored, isInputPossible, isShown, mdiActivate, mdiClose, mdiDeactivate, mdiOpen, performAdditionalFormElementDefinitionChecks, postInit, postRefresh, refresh, refresh, removeFormElementListener, requestFocus, setEditable, showError, showError, sync, toDebugName, willCareForChildActions, willCareForChildRefresh

Method Detail

getDetailView

FDetailView getDetailView()

Retrieves the specific detail view instance managed by this owner.

Returns:

the associated FDetailView, or null if not initialized.

getKnownBOs

java.util.Set<BO> getKnownBOs()

Returns the set of all Business Objects (BOs) currently loaded or managed by this component.

This usually includes BOs that have been loaded into the model, regardless of whether they have been modified or are currently visible.

Returns:

a set of known BOs, never null (return an empty set instead).

getInvolvedBOsForMandatoryCheck

default java.util.Set<BO> getInvolvedBOsForMandatoryCheck()

Returns a subset of known BOs that are relevant for validation checks (i.e. mandatory fields) during the current transaction.

Logic:

• Verifies a transaction exists.
• Iterates through getKnownBOs().
• Filters for BOs that are not deleted and are involved in the current transaction.

Returns:

a set of BOs that were likely edited in the detail view and require validation.

selectBO

void selectBO(BO toSelect)

Instructs the owner to select or highlight a specific Business Object.

If the BO is part of the current model, it should be highlighted. Implementations should define behavior for BOs not currently loaded (e.g. ignoring the request or triggering a lazy load).

Parameters:

toSelect - the Business Object to select.

replaceDetailViewBO

void replaceDetailViewBO(BO bo)

Replaces the primary (anchor) Business Object currently displayed in the detail view.

This generally triggers a UI refresh to display the data of the new BO.

Parameters:

bo - the new Business Object to display.