de.ipcon.form

Interface ClientContextI

All Superinterfaces:

AutomatikStrukturLoaderI, de.ipcon.db.core.BasicClientContextI, BasicDialogI, FormattedChoiceDialogI, FormTransactionBuilderI, java.io.Serializable, StrukturParameterDefaultApplierI, TransactionBuilderI, TransactionProviderI

All Known Implementing Classes:

BasicClient

public interface ClientContextI
extends de.ipcon.db.core.BasicClientContextI, FormTransactionBuilderI

Field Summary

Fields inherited from interface de.ipcon.db.core.TransactionProviderI

$0

Fields inherited from interface de.ipcon.tools.BasicDialogI

CANCELED, CONFIRMED, DENIED, TYPE_ERROR, TYPE_INFO, TYPE_PLAIN, TYPE_QUESTION, TYPE_WARNING

Fields inherited from interface de.ipcon.db.core.StrukturParameterDefaultApplierI

$0

Fields inherited from interface de.ipcon.db.core.AutomatikStrukturLoaderI

$0

Method Summary

Modifier and Type	Method and Description
void	addAction(FormAction a) Adds an action to this ClientContextI.
void	addAction(FormAction a, MDIElementI mdie) Adds an action to this ClientContextI, either globally or for a specific "MDIElementI".
default void	addActions(ClientDesktopElement cde) Adds all actions associated with the given "ClientDesktopElement" to this ClientContextI.
void	addSaveBOListener(SaveBOListenerI l)
void	addVisualComponent(javax.swing.JComponent c, java.lang.String position)
void	addVisualComponent(java.lang.String container, javax.swing.JComponent c, java.lang.String position)
void	authenticate(java.lang.String username, java.lang.String password)
void	authenticate(java.lang.String username, java.lang.String password, boolean inhibitInitFeatureManager)
void	authenticate(java.lang.String username, java.lang.String password, boolean inhibitInitFeatureManager, java.lang.String originHash)
void	bringUsToFront()
void	close()
javax.swing.JRootPane	determineRootPane(FormContextI ftx)
void	endWaitFeedback()
java.lang.String	executeCommand(java.lang.String s)
java.util.Map	getAllActions()
java.util.HashMap	getAllMenus()
java.util.HashMap	getAllToolBars()
Lesezeichen	getBookmarkByTid(java.lang.String tid, java.lang.String entityName) Retrieves a single Lesezeichen uniquely identified by its tid and entity name.
Lesezeichen[]	getBookmarks(EntityI entity) Returns all Lesezeichen instances associated with the specified entity from the cache, sorted by priority in descending order (highest priority first).
Lesezeichen[]	getBookmarks(EntityI entity, boolean reload) Returns all Lesezeichen instances associated with the specified entity, sorted by priority in descending order (highest priority first).
FormContextI	getClientFtx() Returns the global application-level form context associated with the desktop client.
CodebausteinStorageI	getCodebausteinStorage()
DBManInfo	getDBManInfo() Retrieves information about the server.
Folder	getFolder(java.lang.String path)
Folder[]	getFolderChildren(Folder parent)
Formular	getFormByTid(java.lang.String tid, java.lang.String entityName) Retrieves a single Formular uniquely identified by its tid and entity name.
FormElementI	getFormElementForBO(BO bo)
Formular[]	getForms(EntityI entity) Returns all Formular instances associated with the specified entity from the cache, sorted by priority in descending order (highest priority first).
Formular[]	getForms(EntityI entity, boolean reload) Returns all Formular instances associated with the specified entity, sorted by priority in descending order (highest priority first).
default FormContextI	getFtx() Deprecated. Legacy access method. Do not use. Historically returned an initial/default form context, but frequently caused bugs when form code confused this global instance with the form-local FormContextI (leading to accidental state pollution of the global client context). For global desktop/menu actions, use getClientFtx() instead. For form-specific logic, always access the active form's dedicated context.
FulltextSearcherI	getFulltextSearcher()
java.util.Map	getGlobalActions(FormContextI ftx)
java.awt.Image	getLogo()
MDIElementI	getMDIElementForBO(BO bo)
MDIManagerI	getMDIManager()
javax.swing.JMenu	getMenu(java.lang.String name)
java.util.List<ClientPluginI>	getPlugins()
Report	getReportByTid(java.lang.String tid, java.lang.String entityName) Retrieves a single Report uniquely identified by its tid and entity name.
Report[]	getReports(EntityI entity) Returns all Report instances associated with the specified entity from the cache, sorted by priority in descending order (highest priority first).
Report[]	getReports(EntityI entity, boolean reload) Returns all Report instances associated with the specified entity, sorted by priority in descending order (highest priority first).
java.lang.String	getServerName()
Struktur[]	getStrukturenForEntity(java.lang.String entity) Returns all structures for a given entity-name
Struktur[]	getStrukturenForEntity(java.lang.String entity, boolean reload) Returns all structures for a given entity-name
Struktur[]	getStrukturenForEntity(java.lang.String entity, boolean reload, boolean directOnly) Returns all structures for a given entity-name
Struktur[]	getStrukturenForEntity(java.lang.String entity, boolean reload, boolean directOnly, EntityI[] entitiesOnly) Returns all structures for a given entity-name
Struktur[]	getStrukturenForSearchString(java.lang.String searchString, int searchType, boolean reload, boolean directOnly, EntityI[] entitiesOnly) Searches entities for a given string and generates/retrieves the structures for them
Schablone	getTemplateByTid(java.lang.String tid, java.lang.String entityName) Retrieves a single Schablone uniquely identified by its tid and entity name.
Schablone[]	getTemplates(EntityI entity) Returns all Schablone instances associated with the specified entity from the cache, sorted by priority in descending order (highest priority first).
Schablone[]	getTemplates(EntityI entity, boolean reload) Returns all Schablone instances associated with the specified entity, sorted by priority in descending order (highest priority first).
default Schablone[]	getTemplatesForSubEntitiesInAdminsOrdner(EntityI entity) Convenience overload for getTemplatesForSubEntitiesInAdminsOrdner(EntityI, boolean, boolean, Set) using cached data without exclusion filters or uniqueness constraints.
Schablone[]	getTemplatesForSubEntitiesInAdminsOrdner(EntityI entity, boolean reload, boolean uniqueEntities, java.util.Set entitiesToExclude) Internal specialized lookup for templates across polymorphic sub-entities located in administrator folders.
default Schablone[]	getTemplatesForSubEntitiesInAdminsOrdner(EntityI entity, java.util.Set entitiesToExclude) Convenience overload for getTemplatesForSubEntitiesInAdminsOrdner(EntityI, boolean, boolean, Set) using cached data and without entity uniqueness constraints.
java.lang.String	getUniquePrefix()
FormatterI	getVarFormatter()
java.lang.String	getWindowTitle(BO bo)
java.lang.String	getWindowTitle(BO bo, java.lang.String explicitDescription, boolean skipEntity)
boolean	isClosed()
boolean	isConnected()
boolean	isConnected(boolean failfast)
boolean	isMemoryTightClient()
boolean	isMemoryTightClient(boolean failfast)
boolean	isNotificationSystemActivated()
boolean	isShowBOProperties()
boolean	isShowHiddenProperties()
boolean	isShowHistory()
void	logon()
FormElementI	openForm(Formular f, BO bo)
FormElementI	openForm(Formular f, BO bo, java.util.Map parameters)
FormElementI	openForm(Formular form, BO bo, java.util.Map parameters, FormElementI origin)
FormElementI	openForm(Formular f, BO bo, java.util.Map parameters, java.lang.String title)
FormElementI	openForm(Formular f, BO bo, java.util.Map parameters, java.lang.String title, FormContextI formContext)
FormElementI	openForm(Formular f, BO bo, java.util.Map parameters, java.lang.String title, FormContextI formContext, boolean isMassChange)
FormElementI	openForm(Formular f, Transaction tx, BO bo)
FormElementI	openForm(Formular f, Transaction tx, BO bo, java.util.Map parameters)
FormElementI	openForm(Formular f, Transaction tx, BO bo, java.util.Map parameters, java.lang.String title)
FormElementI	openForm(Formular f, Transaction tx, BO bo, java.util.Map parameters, java.lang.String title, FormContextI formContext)
FormElementI	openForm(Formular f, Transaction tx, BO bo, java.util.Map parameters, java.lang.String title, FormContextI formContext, boolean isMassChange)
FormElementI	openNew(Schablone s)
FormElementI	openNew(Schablone s, java.util.Map parameters)
FormElementI	openNew(Schablone template, java.util.Map parameters, FormElementI origin) Creates a new BO with the given Schablone and parameters and opens it relative to the optional origin form
FormElementI	openView(BO bo)
FormElementI	openView(BO bo, java.util.Map parameters)
FormElementI	openView(BO bo, java.util.Map parameters, java.lang.String title)
FormElementI	openView(BO bo, java.util.Map parameters, java.lang.String title, boolean reloadFormCache)
FormElementI	openView(BO bo, java.util.Map parameters, java.lang.String title, boolean reloadFormCache, boolean useAutomatic)
FormElementI	openView(Lesezeichen l)
FormElementI	openView(Lesezeichen l, java.util.Map parameters)
void	passwordChangeInLogonDialogInitiated() Notifies the client that a password change has been initiated in the logon UI.
FormElementI	preparePrinting(Report r, BO bo)
FormElementI	preparePrinting(Report r, BO[] bos)
FormElementI	preparePrinting(Report r, BO[] bos, java.lang.String title)
FormElementI	preparePrinting(Report r, BO[] bos, java.lang.String title, FormElementI owner)
FormElementI	preparePrinting(Report r, BO bo, java.lang.String title)
FormElementI	preparePrinting(java.lang.String entityName, java.lang.String reportName, BO bo)
FormElementI	preparePrinting(java.lang.String entityName, java.lang.String reportName, BO[] bos)
FormElementI	preparePrinting(java.lang.String entityName, java.lang.String reportName, BO[] bos, java.lang.String title)
FormElementI	preparePrinting(java.lang.String entityName, java.lang.String reportName, BO bo, java.lang.String title)
void	refreshActions()
void	registerClientContainer(java.lang.String name, ClientContainerI cc)
javax.swing.JFrame	registerMDIManagerInstance(java.lang.String name, MDIManagerI manager)
void	removeAction(FormAction a) Removes an action globally from this ClientContextI.
void	removeAction(FormAction a, MDIElementI mdie) Removes an action from this ClientContextI, either globally or for a specific "MDIElementI".
default void	removeActions(ClientDesktopElement cde) Removes all actions associated with the given "ClientDesktopElement" from this ClientContextI.
void	removeSaveBOListener(SaveBOListenerI l)
FormElementI	reopenView(FormElementI fe)
FormElementI	reopenView(FormElementI fe, Struktur useStruktur)
FormElementI	reopenView(FormElementI fe, Struktur useStruktur, boolean reloadBO)
void	resetPassword(java.lang.String username)
void	setDefaultFocusOwner(javax.swing.JComponent c)
void	setEmptyMDIFocus()
void	setMenuBar(javax.swing.JMenuBar c)
void	setTitle()
void	setTitle(java.lang.String s)
void	startL10nPackPrefetcher()
void	startWaitFeedback()
void	submitAction(java.awt.event.ActionEvent a)
void	suggestGC()
void	trackLRUAccess(Formular form, java.lang.Long boId, java.lang.String title, FormContextI formContext) For tracking LRU forms in the persistent session (`Sitzung`).
void	trackLRUAccess(Lesezeichen bookmark, java.lang.String title) For tracking LRU bookmarks in the persistent session (`Sitzung`).
void	trackLRUAccess(Report report, java.lang.String title) For tracking LRU reports in the persistent session (`Sitzung`).
void	trackReadAccess(Struktur structure) Updates the read access statistics for the passed Struktur.
FormElementI	updateView(FormElementI fe)

Methods inherited from interface de.ipcon.db.core.BasicClientContextI

getBLOB, getBO, getBOLoader, getCurrentUser, getDialogParent, getEventProvider, getGlobalVar, getGlobalVars, getLocalFile, getProjectPackage, getSchema, getScript, getSession, isServerAuthoritativeSyncServer, putLocalFile, putLocalFile, queryBO, queryBO, setGlobalVar, setScript

Methods inherited from interface de.ipcon.db.core.TransactionProviderI

saveBO, saveBO, saveWithRetries, saveWithRetries

Methods inherited from interface de.ipcon.db.core.TransactionBuilderI

getNewTransaction, getNewTransaction, getNewTransaction, getNewTransaction, getNewTransactionWithInstrumentedSchema, getNewTransactionWithInstrumentedSchema, getNewTransactionWithInstrumentedSchema, getNewTransactionWithInstrumentedSchema

Methods inherited from interface de.ipcon.schema.FormattedChoiceDialogI

showListChoiceDialog, showListChoiceDialog, showListChoiceDialog, showListChoiceDialog, showListChoiceDialog, showListChoiceDialog, showListChoiceDialog, showMultiListChoiceDialog, showMultiListChoiceDialog, showMultiListChoiceDialog

Methods inherited from interface de.ipcon.tools.BasicDialogI

showBigDecimalInputDialog, showBigDecimalInputDialog, showBigDecimalInputDialog, showBigDecimalInputDialog, showConfirmDialog, showConfirmDialog, showConfirmDialog, showConfirmDialog, showConfirmDialog, showDateInputDialog, showDateInputDialog, showDateInputDialog, showDateInputDialog, showDateInputDialog, showError, showError, showError, showError, showError, showError, showError, showError, showException, showException, showException, showFileChooser, showFileChooser, showFileChooser, showFileChooser, showFileChooser, showFileChooser, showFileChooser, showFileChooser, showFileChooser, showFilesChooser, showFilesChooser, showFilesChooser, showFilesChooser, showFilesChooser, showFilesChooser, showFolderChooser, showFolderChooser, showFolderChooser, showFolderChooser, showIntegerInputDialog, showIntegerInputDialog, showIntegerInputDialog, showIntegerInputDialog, showLongInputDialog, showLongInputDialog, showLongInputDialog, showLongInputDialog, showMessageDialog, showMessageDialog, showMessageDialog, showMessageDialogNonModal, showMessageDialogNonModal, showMessageDialogNonModal, showMultipleChoiceDialog, showMultipleChoiceDialog, showOpenFileChooser, showOpenFileChooser, showOpenFileChooser, showOpenFileChooser, showOpenFileChooser, showOpenFilesChooser, showOpenFilesChooser, showOpenFilesChooser, showOpenFilesChooser, showPasswordInputDialog, showPasswordInputDialog, showSaveFileChooser, showSaveFileChooser, showSaveFileChooser, showSaveFileChooser, showSaveFileChooser, showSaveFileChooser, showStringInputDialog, showStringInputDialog, showStringInputDialog, showStringInputDialog, showStringInputDialog, showTimespanInputDialog, showTimespanInputDialog, showTimespanInputDialog, showTimespanInputDialog, showTimespanInputDialog, showTimespanInputDialog, showTimespanInputDialog, showUserLoginDialog, showUserLoginDialog, showYesNoDialog

Methods inherited from interface de.ipcon.db.core.StrukturParameterDefaultApplierI

applyDefaults

Methods inherited from interface de.ipcon.db.core.AutomatikStrukturLoaderI

getAutomatikStrukturForPath, getAutomatikStrukturForPath, getAutomatikStrukturForPath, getAutomatikStrukturForPath

Methods inherited from interface de.ipcon.form.FormTransactionBuilderI

getNewFormTransaction, getNewFormTransaction

Method Detail

getLogo

java.awt.Image getLogo()

authenticate

void authenticate(java.lang.String username,
                  java.lang.String password,
                  boolean inhibitInitFeatureManager,
                  java.lang.String originHash)
           throws AuthenticationException

Throws:

AuthenticationException

authenticate

void authenticate(java.lang.String username,
                  java.lang.String password,
                  boolean inhibitInitFeatureManager)
           throws AuthenticationException

Throws:

AuthenticationException

authenticate

void authenticate(java.lang.String username,
                  java.lang.String password)
           throws AuthenticationException

Throws:

AuthenticationException

resetPassword

void resetPassword(java.lang.String username)

passwordChangeInLogonDialogInitiated

void passwordChangeInLogonDialogInitiated()

Notifies the client that a password change has been initiated in the logon UI.

startL10nPackPrefetcher

void startL10nPackPrefetcher()

logon

void logon()

close

void close()

isClosed

boolean isClosed()

getServerName

java.lang.String getServerName()

isConnected

boolean isConnected()

isConnected

boolean isConnected(boolean failfast)

isMemoryTightClient

boolean isMemoryTightClient()

isMemoryTightClient

boolean isMemoryTightClient(boolean failfast)

submitAction

void submitAction(java.awt.event.ActionEvent a)

getUniquePrefix

java.lang.String getUniquePrefix()

setTitle

void setTitle()

setTitle

void setTitle(java.lang.String s)

getVarFormatter

FormatterI getVarFormatter()

getFtx

@Deprecated
default FormContextI getFtx()

Deprecated. Legacy access method. Do not use.

Historically returned an initial/default form context, but frequently caused bugs when form code confused this global instance with the form-local FormContextI (leading to accidental state pollution of the global client context).

For global desktop/menu actions, use getClientFtx() instead. For form-specific logic, always access the active form's dedicated context.

Returns:

always null

getClientFtx

FormContextI getClientFtx()

Returns the global application-level form context associated with the desktop client.

This context serves as the execution environment for global desktop actions, such as application-wide menu and toolbar actions marked as local="true" (e.g. dynamic LRU history items). It is distinct from individual, form-specific contexts.

Returns:

the global client FormContextI, or null if uninitialized

suggestGC

void suggestGC()

getFulltextSearcher

FulltextSearcherI getFulltextSearcher()

bringUsToFront

void bringUsToFront()

openView

FormElementI openView(BO bo,
                      java.util.Map parameters,
                      java.lang.String title,
                      boolean reloadFormCache,
                      boolean useAutomatic)

openView

FormElementI openView(BO bo,
                      java.util.Map parameters,
                      java.lang.String title,
                      boolean reloadFormCache)

openView

FormElementI openView(BO bo,
                      java.util.Map parameters,
                      java.lang.String title)

openView

FormElementI openView(BO bo,
                      java.util.Map parameters)

openView

FormElementI openView(BO bo)

openView

FormElementI openView(Lesezeichen l,
                      java.util.Map parameters)

openView

FormElementI openView(Lesezeichen l)

getMDIElementForBO

MDIElementI getMDIElementForBO(BO bo)

getFormElementForBO

FormElementI getFormElementForBO(BO bo)

openForm

FormElementI openForm(Formular f,
                      Transaction tx,
                      BO bo,
                      java.util.Map parameters,
                      java.lang.String title,
                      FormContextI formContext,
                      boolean isMassChange)

openForm

FormElementI openForm(Formular f,
                      Transaction tx,
                      BO bo,
                      java.util.Map parameters,
                      java.lang.String title,
                      FormContextI formContext)

openForm

FormElementI openForm(Formular f,
                      Transaction tx,
                      BO bo,
                      java.util.Map parameters,
                      java.lang.String title)

openForm

FormElementI openForm(Formular f,
                      Transaction tx,
                      BO bo,
                      java.util.Map parameters)

openForm

FormElementI openForm(Formular f,
                      Transaction tx,
                      BO bo)

openForm

FormElementI openForm(Formular f,
                      BO bo,
                      java.util.Map parameters,
                      java.lang.String title,
                      FormContextI formContext,
                      boolean isMassChange)

openForm

FormElementI openForm(Formular f,
                      BO bo,
                      java.util.Map parameters,
                      java.lang.String title,
                      FormContextI formContext)

openForm

FormElementI openForm(Formular f,
                      BO bo,
                      java.util.Map parameters,
                      java.lang.String title)

openForm

FormElementI openForm(Formular form,
                      BO bo,
                      java.util.Map parameters,
                      FormElementI origin)

openForm

FormElementI openForm(Formular f,
                      BO bo,
                      java.util.Map parameters)

openForm

FormElementI openForm(Formular f,
                      BO bo)

openNew

FormElementI openNew(Schablone template,
                     java.util.Map parameters,
                     FormElementI origin)

Creates a new BO with the given Schablone and parameters and opens it relative to the optional origin form

Parameters:

template - the template to create the new BO with, nonnull.

parameters - a nullable map of parameters for the template

origin - a nullable FormElementI to open the new view relative to

openNew

FormElementI openNew(Schablone s,
                     java.util.Map parameters)

openNew

FormElementI openNew(Schablone s)

updateView

FormElementI updateView(FormElementI fe)

reopenView

FormElementI reopenView(FormElementI fe,
                        Struktur useStruktur,
                        boolean reloadBO)

reopenView

FormElementI reopenView(FormElementI fe,
                        Struktur useStruktur)

reopenView

FormElementI reopenView(FormElementI fe)

preparePrinting

FormElementI preparePrinting(java.lang.String entityName,
                             java.lang.String reportName,
                             BO bo,
                             java.lang.String title)

preparePrinting

FormElementI preparePrinting(java.lang.String entityName,
                             java.lang.String reportName,
                             BO bo)

preparePrinting

FormElementI preparePrinting(java.lang.String entityName,
                             java.lang.String reportName,
                             BO[] bos,
                             java.lang.String title)

preparePrinting

FormElementI preparePrinting(java.lang.String entityName,
                             java.lang.String reportName,
                             BO[] bos)

preparePrinting

FormElementI preparePrinting(Report r,
                             BO bo,
                             java.lang.String title)

preparePrinting

FormElementI preparePrinting(Report r,
                             BO bo)

preparePrinting

FormElementI preparePrinting(Report r,
                             BO[] bos,
                             java.lang.String title,
                             FormElementI owner)

preparePrinting

FormElementI preparePrinting(Report r,
                             BO[] bos,
                             java.lang.String title)

preparePrinting

FormElementI preparePrinting(Report r,
                             BO[] bos)

getStrukturenForSearchString

Struktur[] getStrukturenForSearchString(java.lang.String searchString,
                                        int searchType,
                                        boolean reload,
                                        boolean directOnly,
                                        EntityI[] entitiesOnly)

Searches entities for a given string and generates/retrieves the structures for them

Parameters:

searchString - the String to which the entities are compared

searchType - defines the type of matching done. see DynamischerOrdner

reload - force a reload

directOnly - only return structure that is for the entity directly, that is resolved from the path, no parent class structure

entitiesOnly - only returns structure of the passed EntityI; no restriction if null

getStrukturenForEntity

Struktur[] getStrukturenForEntity(java.lang.String entity,
                                  boolean reload,
                                  boolean directOnly,
                                  EntityI[] entitiesOnly)

Returns all structures for a given entity-name

Parameters:

entity - The entity name for which to collect the structures

reload - force a reload

directOnly - only return structures that are for the entity directly, no parent class structures

entitiesOnly - only adds structures of the passed EntityI; no restriction if null

getStrukturenForEntity

Struktur[] getStrukturenForEntity(java.lang.String entity,
                                  boolean reload,
                                  boolean directOnly)

Returns all structures for a given entity-name

Parameters:

entity - The entity name for which to collect the structures

reload - force a reload

directOnly - only return structures that are for the entity directly, no parent class structures

getStrukturenForEntity

Struktur[] getStrukturenForEntity(java.lang.String entity,
                                  boolean reload)

Returns all structures for a given entity-name

Parameters:

entity - The entity name for which to collect the structures

reload - force a reload

getStrukturenForEntity

Struktur[] getStrukturenForEntity(java.lang.String entity)

Returns all structures for a given entity-name

Parameters:

entity - The entity name for which to collect the structures

getTemplates

Schablone[] getTemplates(EntityI entity,
                         boolean reload)

Returns all Schablone instances associated with the specified entity, sorted by priority in descending order (highest priority first). Only templates assigned to at least one group of the current user are returned.

Parameters:

entity - the target entity for which to retrieve templates

reload - if true, forces a fresh database query; if false, cached instances from the StrukturCache may be used

Returns:

an array of matching Schablone instances, or an empty array if none are found

Throws:

de.ipcon.tools.MissingArgumentException - if entity is null

getTemplates

Schablone[] getTemplates(EntityI entity)

Returns all Schablone instances associated with the specified entity from the cache, sorted by priority in descending order (highest priority first). Equivalent to calling getTemplates(EntityI, boolean) with reload = false.

Parameters:

entity - the target entity for which to retrieve templates

Returns:

an array of matching Schablone instances, or an empty array if none are found

Throws:

de.ipcon.tools.MissingArgumentException - if entity is null

See Also:

getTemplates(EntityI, boolean)

getTemplatesForSubEntitiesInAdminsOrdner

Schablone[] getTemplatesForSubEntitiesInAdminsOrdner(EntityI entity,
                                                     boolean reload,
                                                     boolean uniqueEntities,
                                                     java.util.Set entitiesToExclude)

Internal specialized lookup for templates across polymorphic sub-entities located in administrator folders. Intended primarily for our UI tree component (i.e. PolymorphicTemplateSelectionTree).

Parameters:

entity - the parent entity defining the polymorphic subtree scope

reload - if true, forces a fresh database query bypass of the cache

uniqueEntities - if true, restricts the output to at most one template per sub-entity type

entitiesToExclude - optional set of EntityI instances to skip during traversal; may be null

Returns:

an array of sub-entity Schablone instances assigned to the current user's groups

Throws:

de.ipcon.tools.MissingArgumentException - if entity is null

getTemplatesForSubEntitiesInAdminsOrdner

default Schablone[] getTemplatesForSubEntitiesInAdminsOrdner(EntityI entity,
                                                             java.util.Set entitiesToExclude)

Convenience overload for getTemplatesForSubEntitiesInAdminsOrdner(EntityI, boolean, boolean, Set) using cached data and without entity uniqueness constraints.

Parameters:

entity - the parent entity defining the polymorphic subtree scope

entitiesToExclude - optional set of EntityI instances to skip; may be null

Returns:

an array of sub-entity Schablone instances assigned to the current user's groups

Throws:

de.ipcon.tools.MissingArgumentException - if entity is null

getTemplatesForSubEntitiesInAdminsOrdner

default Schablone[] getTemplatesForSubEntitiesInAdminsOrdner(EntityI entity)

Convenience overload for getTemplatesForSubEntitiesInAdminsOrdner(EntityI, boolean, boolean, Set) using cached data without exclusion filters or uniqueness constraints.

Parameters:

entity - the parent entity defining the polymorphic subtree scope

Returns:

an array of sub-entity Schablone instances assigned to the current user's groups

Throws:

de.ipcon.tools.MissingArgumentException - if entity is null

getForms

Formular[] getForms(EntityI entity,
                    boolean reload)

Returns all Formular instances associated with the specified entity, sorted by priority in descending order (highest priority first). Only forms assigned to at least one group of the current user are returned.

Parameters:

entity - the target entity for which to retrieve forms

reload - if true, forces a fresh database query; if false, cached instances from the StrukturCache may be used

Returns:

an array of matching Formular instances, or an empty array if none are found

Throws:

de.ipcon.tools.MissingArgumentException - if entity is null

getForms

Formular[] getForms(EntityI entity)

Returns all Formular instances associated with the specified entity from the cache, sorted by priority in descending order (highest priority first). Equivalent to calling getForms(EntityI, boolean) with reload = false.

Parameters:

entity - the target entity for which to retrieve forms

Returns:

an array of matching Formular instances, or an empty array if none are found

Throws:

de.ipcon.tools.MissingArgumentException - if entity is null

See Also:

getForms(EntityI, boolean)

getBookmarks

Lesezeichen[] getBookmarks(EntityI entity,
                           boolean reload)

Returns all Lesezeichen instances associated with the specified entity, sorted by priority in descending order (highest priority first). Only bookmarks assigned to at least one group of the current user are returned.

Parameters:

entity - the target entity for which to retrieve bookmarks

reload - if true, forces a fresh database query; if false, cached instances from the StrukturCache may be used

Returns:

an array of matching Lesezeichen instances, or an empty array if none are found

Throws:

de.ipcon.tools.MissingArgumentException - if entity is null

getBookmarks

Lesezeichen[] getBookmarks(EntityI entity)

Returns all Lesezeichen instances associated with the specified entity from the cache, sorted by priority in descending order (highest priority first). Equivalent to calling getBookmarks(EntityI, boolean) with reload = false.

Parameters:

entity - the target entity for which to retrieve bookmarks

Returns:

an array of matching Lesezeichen instances, or an empty array if none are found

Throws:

de.ipcon.tools.MissingArgumentException - if entity is null

See Also:

getBookmarks(EntityI, boolean)

getReports

Report[] getReports(EntityI entity,
                    boolean reload)

Returns all Report instances associated with the specified entity, sorted by priority in descending order (highest priority first). Only reports assigned to at least one group of the current user are returned.

Parameters:

entity - the target entity for which to retrieve reports

reload - if true, forces a fresh database query; if false, cached instances from the StrukturCache may be used

Returns:

an array of matching Report instances, or an empty array if none are found

Throws:

de.ipcon.tools.MissingArgumentException - if entity is null

getReports

Report[] getReports(EntityI entity)

Returns all Report instances associated with the specified entity from the cache, sorted by priority in descending order (highest priority first). Equivalent to calling getReports(EntityI, boolean) with reload = false.

Parameters:

entity - the target entity for which to retrieve reports

Returns:

an array of matching Report instances, or an empty array if none are found

Throws:

de.ipcon.tools.MissingArgumentException - if entity is null

See Also:

getReports(EntityI, boolean)

getTemplateByTid

Schablone getTemplateByTid(java.lang.String tid,
                           java.lang.String entityName)

Retrieves a single Schablone uniquely identified by its tid and entity name. Only templates assigned to at least one group of the current user are returned.

Parameters:

tid - the tid of the template

entityName - the simple name of the target entity

Returns:

the matching Schablone, or null if no template matches or if no matching template is assigned to at least one group of the current user; if multiple templates match, the one with the highest priority is returned

Throws:

EntityResolveException - if entityName is null or cannot be resolved to a valid entity

getFormByTid

Formular getFormByTid(java.lang.String tid,
                      java.lang.String entityName)

Retrieves a single Formular uniquely identified by its tid and entity name. Only forms assigned to at least one group of the current user are returned.

Parameters:

tid - the tid of the form

entityName - the simple name of the target entity

Returns:

the matching Formular, or null if no form matches or if no matching form is assigned to at least one group of the current user; if multiple forms match, the one with the highest priority is returned

Throws:

EntityResolveException - if entityName is null or cannot be resolved to a valid entity

getBookmarkByTid

Lesezeichen getBookmarkByTid(java.lang.String tid,
                             java.lang.String entityName)

Retrieves a single Lesezeichen uniquely identified by its tid and entity name. Only bookmarks assigned to at least one group of the current user are returned.

Parameters:

tid - the tid of the bookmark

entityName - the simple name of the target entity

Returns:

the matching Lesezeichen, or null if no bookmark matches or if no matching bookmark is assigned to at least one group of the current user; if multiple bookmarks match, the one with the highest priority is returned

Throws:

EntityResolveException - if entityName is null or cannot be resolved to a valid entity

getReportByTid

Report getReportByTid(java.lang.String tid,
                      java.lang.String entityName)

Retrieves a single Report uniquely identified by its tid and entity name. Only reports assigned to at least one group of the current user are returned.

Parameters:

tid - the tid of the report

entityName - the simple name of the target entity

Returns:

the matching Report, or null if no report matches or if no matching report is assigned to at least one group of the current user; if multiple reports match, the one with the highest priority is returned

Throws:

EntityResolveException - if entityName is null or cannot be resolved to a valid entity

addSaveBOListener

void addSaveBOListener(SaveBOListenerI l)

removeSaveBOListener

void removeSaveBOListener(SaveBOListenerI l)

getAllMenus

java.util.HashMap getAllMenus()

getAllToolBars

java.util.HashMap getAllToolBars()

getMDIManager

MDIManagerI getMDIManager()

setEmptyMDIFocus

void setEmptyMDIFocus()

getWindowTitle

java.lang.String getWindowTitle(BO bo,
                                java.lang.String explicitDescription,
                                boolean skipEntity)

getWindowTitle

java.lang.String getWindowTitle(BO bo)

determineRootPane

javax.swing.JRootPane determineRootPane(FormContextI ftx)

getAllActions

java.util.Map getAllActions()

getGlobalActions

java.util.Map getGlobalActions(FormContextI ftx)

addActions

default void addActions(ClientDesktopElement cde)

Adds all actions associated with the given "ClientDesktopElement" to this ClientContextI.

Parameters:

cde - The "ClientDesktopElement" whose actions should be added.

removeActions

default void removeActions(ClientDesktopElement cde)

Removes all actions associated with the given "ClientDesktopElement" from this ClientContextI.

Parameters:

cde - The "ClientDesktopElement" whose actions should be removed.

addAction

void addAction(FormAction a,
               MDIElementI mdie)

Adds an action to this ClientContextI, either globally or for a specific "MDIElementI".

This method registers an action with the ClientContextI, making it available either globally or for a specific "MDIElementI". If an "MDIElementI" is provided, the action is associated with that element; otherwise, it is added to the global action map.

Parameters:

a - The action to add.

mdie - The "MDIElementI" to associate the action with (optional).

Throws:

java.lang.IllegalArgumentException - If a non-local, non-prototype action is registered in a multi-window environment.

addAction

void addAction(FormAction a)

Adds an action to this ClientContextI.

This method registers an action with the ClientContextI, making it available globally by adding it to the global action map.

Parameters:

a - The action to add.

removeAction

void removeAction(FormAction a,
                  MDIElementI mdie)

Removes an action from this ClientContextI, either globally or for a specific "MDIElementI".

This method unregisters an action from the ClientContextI, either globally or for a specific "MDIElementI". If an "MDIElementI" is provided, the action is removed from that element; otherwise, it is removed from the global action map.

Parameters:

a - The action to remove.

mdie - The "MDIElementI" to remove the action from (optional).

removeAction

void removeAction(FormAction a)

Removes an action globally from this ClientContextI.

This method unregisters an action globally from the ClientContextI by removing it from the global action map.

Parameters:

a - The action to remove.

refreshActions

void refreshActions()

getMenu

javax.swing.JMenu getMenu(java.lang.String name)

setMenuBar

void setMenuBar(javax.swing.JMenuBar c)

setDefaultFocusOwner

void setDefaultFocusOwner(javax.swing.JComponent c)

executeCommand

java.lang.String executeCommand(java.lang.String s)

addVisualComponent

void addVisualComponent(java.lang.String container,
                        javax.swing.JComponent c,
                        java.lang.String position)

addVisualComponent

void addVisualComponent(javax.swing.JComponent c,
                        java.lang.String position)

registerClientContainer

void registerClientContainer(java.lang.String name,
                             ClientContainerI cc)

registerMDIManagerInstance

javax.swing.JFrame registerMDIManagerInstance(java.lang.String name,
                                              MDIManagerI manager)

startWaitFeedback

void startWaitFeedback()

endWaitFeedback

void endWaitFeedback()

getPlugins

java.util.List<ClientPluginI> getPlugins()

getCodebausteinStorage

CodebausteinStorageI getCodebausteinStorage()

isShowHiddenProperties

boolean isShowHiddenProperties()

isShowBOProperties

boolean isShowBOProperties()

isShowHistory

boolean isShowHistory()

getDBManInfo

DBManInfo getDBManInfo()

Retrieves information about the server.

Returns:

a DBManInfo instance with information about the server.

isNotificationSystemActivated

boolean isNotificationSystemActivated()

getFolder

Folder getFolder(java.lang.String path)

trackReadAccess

void trackReadAccess(Struktur structure)

Updates the read access statistics for the passed Struktur.

trackLRUAccess

void trackLRUAccess(Lesezeichen bookmark,
                    java.lang.String title)

For tracking LRU bookmarks in the persistent session (`Sitzung`).

trackLRUAccess

void trackLRUAccess(Formular form,
                    java.lang.Long boId,
                    java.lang.String title,
                    FormContextI formContext)

For tracking LRU forms in the persistent session (`Sitzung`).

trackLRUAccess

void trackLRUAccess(Report report,
                    java.lang.String title)

For tracking LRU reports in the persistent session (`Sitzung`).

getFolderChildren

Folder[] getFolderChildren(Folder parent)