de.ipcon.db.core

Class AusloeseKriterium

java.lang.Object

de.ipcon.db.core.Transliterator

de.ipcon.db.core.Synchable

de.ipcon.db.core.BO

de.ipcon.db.core.CoreBOBase

de.ipcon.db.core.CoreBO

de.ipcon.db.core.AusloeseKriteriumBase

de.ipcon.db.core.AusloeseKriterium

All Implemented Interfaces:

LazyDataProviderI, NotificationAttachmentI, SaveAwareI, SaveVetoI, TransliteratorI, BOI, DescribableI, Identifiable, SchemaProviderI, java.io.Externalizable, java.io.Serializable, java.lang.Cloneable

public class AusloeseKriterium
extends de.ipcon.db.core.AusloeseKriteriumBase

Class that represents a single condition and specific change to a BO that must have happened for an BedingterAlarm to trigger (or not, in the case of a Wiedervorlage). Implementation note: A different approach would have been to have seperate classes for the "simple ones" that check for general BO change/creation/deletion and script but I think that's a little too much effort; the aenderungsTypCode approach used here works fine as well. FIXME!! TT 2024-01-15: Actually this approach does require quite some special handling and also is rather confusing in a number of places so changing this would be really useful (especially concerning the variants using "Script").

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	AusloeseKriterium.AusloeseKriteriumDefinitionException

Field Summary

Fields inherited from class de.ipcon.db.core.AusloeseKriteriumBase

ATT_AenderungsTyp, ATT_Attribut, ATT_AttributBX, ATT_AutoBeschreibung, ATT_BedingterAlarm, ATT_BenoetigtScript, ATT_BenoetigtWert, ATT_Script, ATT_VerfuegbareAenderungsTypen, ATT_VerfuegbareAttribute, ATT_Wert, ATT_WertBX, ENT_AusloeseKriterium

Fields inherited from class de.ipcon.db.core.CoreBOBase

ATT_AlsAntwortAnBeiAuftraegen, ATT_AlsEmpfaengerBCCBeiAuftraegen, ATT_AlsEmpfaengerBeiAuftraegen, ATT_AlsEmpfaengerCCBeiAuftraegen, ATT_AlsKontextBOBeiAuftraegen, ATT_WirdAlsAntwortAnVerwendetBeiAlarmen, ATT_WirdBenachrichtigtBCCBeiAlarm, ATT_WirdBenachrichtigtBeiAlarm, ATT_WirdBenachrichtigtCCBeiAlarm, ENT_CoreBO

Fields inherited from class de.ipcon.db.core.BO

BLOB_KEY, CANCEL_RECALC_CALLED, D_0, D_1, D_10, D_100, D_1000, D_10000, D_5, D_MINUS_1, D_MINUS_ONE, D_ONE, D_ZERO, doExWriteLRMFunction, EMPTY_ARRAY, F_0, F_1, L_0, L10N_KEY_BO_INSTANTIATION, L10N_KEY_BO_WITH_PROTECTED_CONSTRUCTOR, NULL_AGGREGATE, NULL_ITERATOR

Fields inherited from interface de.ipcon.schema.BOI

ATT_Badge, ATT_Badge2, ATT_Badge3, ATT_Badge4, ATT_BLOBCreatedBy, ATT_BLOBCreatedOn, ATT_BLOBDeletedBy, ATT_BLOBDeletedOn, ATT_BLOBLastModifiedBy, ATT_BLOBLastModifiedOn, ATT_Bot, ATT_Crea, ATT_CreatedBy, ATT_CreatedModifiedText, ATT_Id, ATT_InvolvedInProcs, ATT_LastModifiedBy, ATT_Ldel, ATT_Lmod, ATT_Procs, EMPTY_ARRAY, ENT_BO

Constructor Summary

Constructors

Constructor and Description
AusloeseKriterium() This exception signifies some "persistent" error in the definition of an AusloeseKriterium which will prevent the AK being checked until the definition is corrected.

Method Summary

Modifier and Type	Method and Description
void	clearWertBX()
boolean	fits(BP bp, SchemaI schema, BedingterAlarmBOStatusHelper statusHelper) Checks if this AusloeseKriterium is "triggered" by the given BP.
static AusloeseKriterium	forBOAppearance(BedingterAlarm alarm)
static AusloeseKriterium	forBOChange(BedingterAlarm alarm)
static AusloeseKriterium	forBOCreation(BedingterAlarm alarm)
static AusloeseKriterium	forBODeletion(BedingterAlarm alarm)
static AusloeseKriterium	forBODisappearance(BedingterAlarm alarm)
static AusloeseKriterium	forScript(BedingterAlarm alarm, java.lang.String script)
BX	getAttributBX()
AttributeI	getAttributeObj()
CBOAttributeTypeI	getAttributeType()
java.lang.String	getAutoBeschreibung()
java.lang.Boolean	getBenoetigtScript()
java.lang.Boolean	getBenoetigtWert()
java.util.Map<java.lang.Long,AenderungsTyp>	getVerfuegbareAenderungsTypen()
java.util.Map<java.lang.Long,BX>	getVerfuegbareAttribute()
BX	getWertBX()
boolean	isMandatory(AttributeI attr) Tells if the passed AttributeI is mandatory in the context of this BO (for the UI and access via the schema).
void	setAttribut(java.lang.String _attributeName)
void	setAttributBX(BX _bxAttr)
void	setScript(java.lang.String script)
void	setWert(java.lang.String _wert)
void	syncWert()
java.lang.String	toString()
void	verifyOnClient(BasicClientContextI ctx)

Methods inherited from class de.ipcon.db.core.AusloeseKriteriumBase

copyFrom, copyFrom, equalPayload, getAenderungsTyp, getAttribut, getAttributNE, getAttributNN, getAttributNN, getAutoBeschreibungNE, getAutoBeschreibungNN, getAutoBeschreibungNN, getBedingterAlarm, getBenoetigtScriptNN, getBenoetigtScriptNN, getBenoetigtWertNN, getBenoetigtWertNN, getScript, getScriptNE, getScriptNN, getScriptNN, getVerfuegbareAenderungsTypenIterator, getVerfuegbareAttributeIterator, getWert, getWertNE, getWertNN, getWertNN, istBenoetigtScript, istBenoetigtWert, needAenderungsTyp, needAttribut, needAttributBX, needAutoBeschreibung, needBedingterAlarm, needBenoetigtScript, needBenoetigtWert, needPopulatedVerfuegbareAenderungsTypen, needPopulatedVerfuegbareAttribute, needScript, needWert, needWertBX, readExternal, setAenderungsTyp, setBedingterAlarm, setBOLoader, slim, slim, writeExternal

Methods inherited from class de.ipcon.db.core.CoreBOBase

addAlsAntwortAnBeiAuftrag, addAlsEmpfaengerBCCBeiAuftrag, addAlsEmpfaengerBeiAuftrag, addAlsEmpfaengerCCBeiAuftrag, addAlsKontextBOBeiAuftrag, addWirdAlsAntwortAnVerwendetBeiAlarm, addWirdBenachrichtigtBCCBeiAlarm, addWirdBenachrichtigtBeiAlarm, addWirdBenachrichtigtCCBeiAlarm, getAlsAntwortAnBeiAuftraegen, getAlsAntwortAnBeiAuftraegenIterator, getAlsEmpfaengerBCCBeiAuftraegen, getAlsEmpfaengerBCCBeiAuftraegenIterator, getAlsEmpfaengerBeiAuftraegen, getAlsEmpfaengerBeiAuftraegenIterator, getAlsEmpfaengerCCBeiAuftraegen, getAlsEmpfaengerCCBeiAuftraegenIterator, getAlsKontextBOBeiAuftraegen, getAlsKontextBOBeiAuftraegenIterator, getWirdAlsAntwortAnVerwendetBeiAlarmen, getWirdAlsAntwortAnVerwendetBeiAlarmenIterator, getWirdBenachrichtigtBCCBeiAlarm, getWirdBenachrichtigtBCCBeiAlarmIterator, getWirdBenachrichtigtBeiAlarm, getWirdBenachrichtigtBeiAlarmIterator, getWirdBenachrichtigtCCBeiAlarm, getWirdBenachrichtigtCCBeiAlarmIterator, needPopulatedAlsAntwortAnBeiAuftraegen, needPopulatedAlsEmpfaengerBCCBeiAuftraegen, needPopulatedAlsEmpfaengerBeiAuftraegen, needPopulatedAlsEmpfaengerCCBeiAuftraegen, needPopulatedAlsKontextBOBeiAuftraegen, needPopulatedWirdAlsAntwortAnVerwendetBeiAlarmen, needPopulatedWirdBenachrichtigtBCCBeiAlarm, needPopulatedWirdBenachrichtigtBeiAlarm, needPopulatedWirdBenachrichtigtCCBeiAlarm, pgetAlsAntwortAnBeiAuftraegenLazy, pgetAlsEmpfaengerBCCBeiAuftraegenLazy, pgetAlsEmpfaengerBeiAuftraegenLazy, pgetAlsEmpfaengerCCBeiAuftraegenLazy, pgetAlsKontextBOBeiAuftraegenLazy, pgetWirdAlsAntwortAnVerwendetBeiAlarmenLazy, pgetWirdBenachrichtigtBCCBeiAlarmLazy, pgetWirdBenachrichtigtBeiAlarmLazy, pgetWirdBenachrichtigtCCBeiAlarmLazy, removeAlsAntwortAnBeiAuftrag, removeAlsEmpfaengerBCCBeiAuftrag, removeAlsEmpfaengerBeiAuftrag, removeAlsEmpfaengerCCBeiAuftrag, removeAlsKontextBOBeiAuftrag, removeWirdAlsAntwortAnVerwendetBeiAlarm, removeWirdBenachrichtigtBCCBeiAlarm, removeWirdBenachrichtigtBeiAlarm, removeWirdBenachrichtigtCCBeiAlarm, setAlsAntwortAnBeiAuftraegen, setAlsEmpfaengerBCCBeiAuftraegen, setAlsEmpfaengerBeiAuftraegen, setAlsEmpfaengerCCBeiAuftraegen, setAlsKontextBOBeiAuftraegen, setWirdAlsAntwortAnVerwendetBeiAlarmen, setWirdBenachrichtigtBCCBeiAlarm, setWirdBenachrichtigtBeiAlarm, setWirdBenachrichtigtCCBeiAlarm

Methods inherited from class de.ipcon.db.core.BO

_set, $, $, $, $$, $$bo, $$o, $$r, $$ri, $$ri, acquireTxWriteLock, add, afterSaveOnClient, afterSaveOnServer, afterVerifyOnClient, afterVerifyOnServer, aggregate, aggregate, aggregate, aggregate, badge, badge, beforeVerifyOnClient, beforeVerifyOnServer, bumpVersion, cacheLocally, cacheLocally, cacheLocallyAndThrowUnwrappedCause, cacheLocallyAndThrowUnwrappedCause, cacheLocallyAndThrowUnwrappedUncheckedCause, cacheLocallyAndThrowUnwrappedUncheckedCause, cancelCheckConstraints, cancelRecalc, cancelRecalcViaLoadingTransaction, clone, commitTransaction, computeTransientPropertyIfAbsent, conciseDesc, conciseDesc, conciseDesc, conciseDesc, conciseDesc, conciseDesc, conciseDesc, conciseDesc, consumeAndAssureTransientPropertyExists, copyBLOBFrom, createCopy, createCopy, deepClone, deepClone, delete, describe, describe, describe, describe, describe, describe, describe, describe, describe, describe, describeId, describeId, describeId, describeId, describeId, describeId, describeId, describeId, describeNE, describeNE, describeNE, describeNE, describeNE, destub, equalPayload, equalPayload, equalPayload, equalPayload, equals, equalsBO, equalsBO, equalsRegardingAttrs, exportBLOB, exReadString, exWriteString, forgetTransientBLOBHandle, frap, getAsBOInIssueReports, getAsBOInIssueReportsIterator, getAsString, getBackendBOLoaderWithPersistenceHandler, getBadge, getBadge, getBadge2, getBadge3, getBadge4, getBLOB, getBLOB, getBLOB, getBLOB, getBLOB, getBLOBAsDataInput, getBLOBAsEncodedString, getBLOBAsEncodedString, getBLOBAsInputStream, getBLOBAsUTF8EncodedString, getBLOBCreatedBy, getBLOBCreatedOn, getBLOBDeletedBy, getBLOBDeletedOn, getBLOBInfo, getBLOBLastModifiedBy, getBLOBLastModifiedOn, getBOLoader, getBot, getBOVersion, getBytes, getCache, getCache, getCache, getCache, getCache, getCacheNT, getCacheNT, getCacheNT, getCacheNT, getCacheNT, getCacheProvider, getCacheProvider, getClazz, getCreatedBy, getCreatedModifiedText, getDefaultScriptImportsList, getDefaultScriptImportsList, getDefaultScriptImportsList, getDescribingBOWrapper, getDescribingBOWrapper, getEventProvider, getEventProvider, getId, getInvolvedInProcs, getInvolvedInProcsIterator, getLastModifiedBy, getLazyData, getLoadingTransaction, getNullIterator, getOrCreate, getOrCreate, getOrCreate, getOrCreate, getOrCreate, getOrCreate, getOrCreate, getPermissionHandler, getProcs, getProcsIterator, getRootLoaderSchema, getSchema, getSizeFast, getTransaction, getTransientProperty, getTransientProperty, getWrappedTransientProperty, hasActiveTransaction, hasBLOB, hasBLOBOnServerSide, hasBOAssignedTempId, hashCode, hasRelationObjects, hasRelationObjects, hasSessionAssignedTempId, hasTempId, hasTempIdForNewBOs, hasTransientProperty, hasTransientPropertyUnfiltered, includeAllowed, includeInTransaction, invalidateBLOBCache, isBOAssignedTempId, isCompoundChangeInProgress, isCurrentTransactionUnderAdminControl, isIgnoreModificationConstraints, isNew, isReadOnly, isServerSideAndLoadedReadOnly, isSessionAssignedTempId, isStub, isTempId, isTempIdForNewInstance, isTemporary, isVisible, isWriteable, markCompoundChangeInProgress, markDelete, markUndelete, needLoadingTransaction, needsReload, needTransactionInclusion, newInstance, newInstance, newInstance, newInstance, newInstance, newInstance, nextTempId, notifyMessageBus, notifyMessageBus, notifyMessageBus, notifyMessageBus, notifyMessageBus, notifyMessageBus, notifyMessageBusOfAdd, notifyMessageBusOfRemove, nullSafeCompareTo, nullSafeCompareTo, nullSafeContainsBO, nullSafeContainsBO, nullSafeEquals, nullSafeEqualsBO, nullSafeEqualsBO, ofStub, propertyMissing, propertyMissing, releaseCompoundChangeInProgress, releaseTxWriteLock, remove, removeBLOB, requireNonEmptyRelation, requireNonNullAttribute, requireNonNullAttributes, requireNonNullAttributes, requireNonNullAttributes, requireNonNullAttributes, requireNonNullAttributes, requireNonNullAttributes, requireNonNullAttributes, setAsString, setBadge, setBadge, setBadge2, setBadge3, setBadge4, setBOLoaderNoCascade, setBOLoaderNoCascade, setBot, setId, setId, setIgnoreModificationConstraints, setLazyData, setTempId, setTransientProperty, setTransientProperty, setTransientProperty, setTransientProperty, setTransientProperty, setTransientProperty, slim, slim, storeBLOB, storeBLOB, storeBLOB, storeBLOB, storeBLOB, stub, toMap, toMap, toMap, toMap, toMap, toMap, toMap, toMap, toMap, toMap, toMap, toMap, toRelationMapRO, toRelationMapRO, toRelationMapRO, toRelationMapRO, toRelationMapRO, toRelationMapRO, toRelationMapRO, toRelationMapRO, undelete, verifyOnServer, wrapIfGroovy

Methods inherited from class de.ipcon.db.core.Synchable

getCrea, getLdel, getLmod, isDeleted, isLdel, setCrea, setLdel, setLdel, setLmod

Methods inherited from class de.ipcon.db.core.Transliterator

getInstanceSpecificLocale, getInstanceSpecificPaths, l10n, l10n, l10n, l10n, l10n, l10n, l10n

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface de.ipcon.schema.BOI

bumpVersion, cancelCheckConstraints, consumeAndAssureTransientPropertyExists, contains, delete, equalsBO, equalsBO, filterDeleted, filterDeleted, filterDeleted, filterDeleted, filterDeletedAndReturnMap, filterDeletedAndReturnMap, getAttribute, getAttribute, getBLOB, getBLOB, getBOVersion, getClazz, getCrea, getEntity, getEntity, getRootLoaderSchema, getSchema, getTransientProperty, hasBLOB, hasTransientProperty, hasTransientPropertyUnfiltered, isDeleted, isNew, isReadOnly, isSubEntityOf, isSubEntityOf, isTemporary, isVisible, setTransientProperty, toRelationMapRO

Methods inherited from interface de.ipcon.schema.Identifiable

collectIds, collectIds, getCommaSeparatedIdList, getId, toMap, toMap

Methods inherited from interface de.ipcon.schema.DescribableI

collectDescribe, collectDescribe, conciseDesc, conciseDesc, conciseDesc, conciseDesc, conciseDesc, conciseDesc, conciseDesc, conciseDesc, describe, describe, describe, describe, describeAndConciseDesc, describeAndConciseDesc, describeAndConciseDesc, describeAndConciseDesc, describeAndConciseDesc, describeNE, describeNE, join, join, join, notEmptyDescription

Constructor Detail

AusloeseKriterium

public AusloeseKriterium()

This exception signifies some "persistent" error in the definition of an AusloeseKriterium which will prevent the AK being checked until the definition is corrected. It is not signalled for cases where just a specific check failed, for example due to an error in the execution of an AK's Script.

Method Detail

forBOChange

public static AusloeseKriterium forBOChange(BedingterAlarm alarm)

forBOCreation

public static AusloeseKriterium forBOCreation(BedingterAlarm alarm)

forBODeletion

public static AusloeseKriterium forBODeletion(BedingterAlarm alarm)

forBOAppearance

public static AusloeseKriterium forBOAppearance(BedingterAlarm alarm)

forBODisappearance

public static AusloeseKriterium forBODisappearance(BedingterAlarm alarm)

forScript

public static AusloeseKriterium forScript(BedingterAlarm alarm,
                                          java.lang.String script)

verifyOnClient

public void verifyOnClient(BasicClientContextI ctx)

Specified by:

verifyOnClient in interface SaveVetoI

Overrides:

verifyOnClient in class BO

isMandatory

public boolean isMandatory(AttributeI attr)

Description copied from class: BO

Tells if the passed AttributeI is mandatory in the context of this BO (for the UI and access via the schema). Please note that the schema-defined, not BO-related mandatories are taken into account here as well, i.e. the method will consistently return true if the attribute is marked in the schema as

unless overridden in a subclass. Subclasses may override this method to add their own rules. If no rule exists in the subclass, the decision should always be delegated to super instead of just returning false to avoid inadvertenly breaking the rules defined in super-classes or the schema. You must never change the signature of this method, as subclasses override this and a lot of code would break or need to be adjusted.

Specified by:

isMandatory in interface BOI

Overrides:

isMandatory in class BO

Returns:

true if the given AttributeI is mandatory in the context of this BO

setScript

public void setScript(java.lang.String script)

Overrides:

setScript in class de.ipcon.db.core.AusloeseKriteriumBase

fits

public boolean fits(BP bp,
                    SchemaI schema,
                    BedingterAlarmBOStatusHelper statusHelper)
             throws Alarm.AlarmDefinitionException,
                    AusloeseKriterium.AusloeseKriteriumDefinitionException

Checks if this AusloeseKriterium is "triggered" by the given BP.

Parameters:

bp - the BP that should be checked if it fits or does not fit this AusloeseKriterium

schema - the SchemaI to get AttributeIs from and for use by possibly involved scripts

_babsh - helper class instance used to check if the BO associated with the BP fitted the BedingterAlarm of this AK before and/or after the BT/TX

Returns:

true if the given BP "triggers" this AK, false if not

Throws:

AusloeseKriterium.AusloeseKriteriumDefinitionException - if some "persistent" error in the definition of this AK is encountered during checking

Alarm.AlarmDefinitionException

getBenoetigtWert

public java.lang.Boolean getBenoetigtWert()

Specified by:

getBenoetigtWert in class de.ipcon.db.core.AusloeseKriteriumBase

getBenoetigtScript

public java.lang.Boolean getBenoetigtScript()

Specified by:

getBenoetigtScript in class de.ipcon.db.core.AusloeseKriteriumBase

getAutoBeschreibung

public java.lang.String getAutoBeschreibung()

Specified by:

getAutoBeschreibung in class de.ipcon.db.core.AusloeseKriteriumBase

toString

public java.lang.String toString()

Overrides:

toString in class BO

setAttribut

public void setAttribut(java.lang.String _attributeName)

Overrides:

setAttribut in class de.ipcon.db.core.AusloeseKriteriumBase

getAttributBX

public BX getAttributBX()

Specified by:

getAttributBX in class de.ipcon.db.core.AusloeseKriteriumBase

setAttributBX

public void setAttributBX(BX _bxAttr)

Specified by:

setAttributBX in class de.ipcon.db.core.AusloeseKriteriumBase

getVerfuegbareAttribute

public java.util.Map<java.lang.Long,BX> getVerfuegbareAttribute()

Specified by:

getVerfuegbareAttribute in class de.ipcon.db.core.AusloeseKriteriumBase

getVerfuegbareAenderungsTypen

public java.util.Map<java.lang.Long,AenderungsTyp> getVerfuegbareAenderungsTypen()

Specified by:

getVerfuegbareAenderungsTypen in class de.ipcon.db.core.AusloeseKriteriumBase

setWert

public void setWert(java.lang.String _wert)

Overrides:

setWert in class de.ipcon.db.core.AusloeseKriteriumBase

getWertBX

public BX getWertBX()

Specified by:

getWertBX in class de.ipcon.db.core.AusloeseKriteriumBase

Returns:

a BX with its V* attribute corresponding to the current attribute of this AusloeseKriterium set to the current Wert (if that is of a or can be converted to a matching value for the attribute's type).

clearWertBX

public void clearWertBX()

getAttributeObj

public AttributeI getAttributeObj()

getAttributeType

public CBOAttributeTypeI getAttributeType()

syncWert

public void syncWert()