Interface IKeyValueSummarizableElement<TData,TElement extends IWorkflowElementEntity>
-
- Type Parameters:
TData
- Type of the properties model for the workflow element. UseJSONObject
if you want to get the raw data and possibly perform serialization / deserialization yourself. SeeIElementHandler.getDataModelClass()
.TElement
- Type of the workflow element, i.e. a node or trigger.
- All Superinterfaces:
ICustomParametersUpdateable
,IElementHandler<TData,TElement>
,IResourceBundleLocator
,IWorkflowElementTypeProviding
- All Known Subinterfaces:
IKeyValueSummarizableNode<TData>
,IKeyValueSummarizableTrigger<TData>
- All Known Implementing Classes:
FcCatchErrorHandler
,FcChangeFormAvailabilityHandler
,FcChangeFormValueHandler
,FcChangeStateHandler
,FcCompressAsZipHandler
,FcCopyFormRecordHandler
,FcCounterHandler
,FcCreateTextFileHandler
,FcDeleteFormRecordHandler
,FcDoiInitHandler
,FcDoiVerifiedHandler
,FcEmailHandler
,FcExportToPersistenceHandler
,FcExportToXmlHandler
,FcFillPdfHandler
,FcFillWordHandler
,FcFormSubmitButtonHandler
,FcHttpRequestHandler
,FcImportFormValueFromXmlHandler
,FcInvitationErrorHandler
,FcInvitationSentHandler
,FcLdapQueryHandler
,FcManualHandler
,FcMoveFormRecordToInboxHandler
,FcProvideResourceHandler
,FcQualifiedFormSubmitButtonHandler
,FcQueueTaskHandler
,FcRedirectHandler
,FcRenewProcessIdHandler
,FcReturnFileHandler
,FcReturnHandler
,FcSaveToFileSystemHandler
,FcSetSavedFlagHandler
,FcShowTemplateHandler
,FcSqlStatementHandler
,FcStateTimerHandler
,FcThrowExceptionHandler
,FcTimePointHandler
,FcWriteFormRecordAttrHandler
public interface IKeyValueSummarizableElement<TData,TElement extends IWorkflowElementEntity> extends IElementHandler<TData,TElement>
Mixin that implementsIElementHandler.getElementSummaryXhtml()
andIElementHandler.getElementSummaryModel(IGetElementSummaryParams)
for nodes and triggers that wish to provide a simple key value based overview. Displays a table with two column, the key to the left and the value to the right.- Since:
- 7.0.0
- Author:
- XIMA MEDIA GmbH
-
-
Field Summary
-
Fields inherited from interface de.xima.fc.interfaces.workflow.elements.IElementHandler
CURRENT_HANDLER_VERSION
-
-
Method Summary
All Methods Instance Methods Abstract Methods Default Methods Modifier and Type Method Description ISummaryKeyValueModel
getElementSummaryKeyValueModel(IGetElementSummaryParams<TData> params)
default Serializable
getElementSummaryModel(IGetElementSummaryParams<TData> params)
When the user clicks on the info icon of a node or trigger, an panel with a quick summary of that node or trigger opens.default URL
getElementSummaryXhtml()
When the user clicks on the info icon of a node or trigger, an panel with a quick summary of that node or trigger opens.-
Methods inherited from interface de.xima.fc.interfaces.workflow.ICustomParametersUpdateable
updateCustomParams
-
Methods inherited from interface de.xima.fc.interfaces.workflow.elements.IElementHandler
extractDescription, extractName, extractSearchTerms, getCascadingStyleSheet, getCascadingStyleSheet, getDataModelClass, getDisplayLabel, getFastJsonConverter, getFilterCriteriaForEntities, getHelpPageLocation, getJavaScript, getJavaScript, getLocalizedTypeName, getPropertiesBeanClass, getPropertiesViewXhtml, getResourceBundle, getVersion, isAvailable, readEntityReferences, readPlaceholders, validateGlobal, validateLocal, writeEntityReferences, writePlaceholders
-
Methods inherited from interface de.xima.fc.interfaces.workflow.IWorkflowElementTypeProviding
getType
-
-
-
-
Method Detail
-
getElementSummaryKeyValueModel
ISummaryKeyValueModel getElementSummaryKeyValueModel(IGetElementSummaryParams<TData> params)
- Parameters:
params
- The custom properties of the node or trigger.- Returns:
- A list of key value pairs to display in a table in the overview panel.
-
getElementSummaryModel
default Serializable getElementSummaryModel(IGetElementSummaryParams<TData> params)
Description copied from interface:IElementHandler
When the user clicks on the info icon of a node or trigger, an panel with a quick summary of that node or trigger opens. By default, this panel only shows the available values returned by the node and which errors it can throw. You can implementIElementHandler.getElementSummaryXhtml()
to include a custom summary of the element's current properties. If you do, you should also override this method. It must create the view model for the XHTML page. The value returned by this method is passed to the XHTML page via the expression language variablemodel
.If you wish to display a quick summary as a list of key value pairs derived directly from the properties model, consider using the mixin
IKeyValueSummarizableElement
.- Specified by:
getElementSummaryModel
in interfaceIElementHandler<TData,TElement extends IWorkflowElementEntity>
- Parameters:
params
- The current properties model of the node or trigger.- Returns:
- The view model for the summary. When
null
, no summary is displayed.
-
getElementSummaryXhtml
default URL getElementSummaryXhtml() throws MalformedURLException
Description copied from interface:IElementHandler
When the user clicks on the info icon of a node or trigger, an panel with a quick summary of that node or trigger opens. By default, this panel only shows the available values returned by the node and which errors it can throw. You can implement this method to include a custom summary of the element's current properties. If you do, you should also overrideIElementHandler.getElementSummaryModel(IGetElementSummaryParams)
.This method should return the path to the XHTML page for the custom workflow element summary that is shown in an overlay when the user click on the info icon on a node or trigger. Usually the XHTML file is part of the JAR resources of the module or plugin. In this case, you should return an URL to a JAR file resource (
jar:file:/...
) like so:@Override public URL getXhtmlView() { return getClass().getResource("/path/to/view.xhtml"); }
The XHTML page should be a passive view without any interaction. The following to variables are made available to the XHTML page:
model
- The value that was returned byIElementHandler.getElementSummaryModel(IGetElementSummaryParams)
msg
: The localized messages as returned byIElementHandler.getResourceBundle(Locale)
. Empty when that method returnsnull
. For example, if the resource bundle contains the keymail.label
, you can access the localized message via the EL expression['mail.label']
- Specified by:
getElementSummaryXhtml
in interfaceIElementHandler<TData,TElement extends IWorkflowElementEntity>
- Returns:
- The XHTML page for the custom element summary. When
null
, no summary is displayed. - Throws:
MalformedURLException
- When the URL could not be created. When this exception is thrown, it is treated as ifnull
had been returned.
-
-