Package com.inductiveautomation.reporting.designer

Class ReportingDesignerHook

java.lang.Object

com.inductiveautomation.ignition.designer.model.AbstractDesignerModuleHook

com.inductiveautomation.reporting.designer.ReportingDesignerHook

All Implemented Interfaces:

Locatable, LocationRenderingUpdater, DesignerModuleHook

public class ReportingDesignerHook
extends AbstractDesignerModuleHook
implements Locatable

Constructor Summary

Constructors

Constructor	Description
ReportingDesignerHook()

Method Summary

Modifier and Type	Method	Description
void	configureSerializer(XMLSerializer serializer)	Provides the module a chance to add serialization delegates to the serializer custom for classes that might be encountered when serializing objects provided by this module
DesignerDataSourceRegistry	getDataSourceRegistry()
List<com.jidesoft.docking.DockableFrame>	getFrames()	A list of DockableFrames that this module provides, that should be available to all workspaces.
Icon	getModuleIcon()	Return an appropriate icon to display for this module.
MenuBarMerge	getModuleMenu()	Returns a menu merge for any global menu additions.
List<com.jidesoft.action.CommandBar>	getModuleToolbars()	Returns the toolbars for the module.
String	getResourceCategoryKey(ResourcePath resource)	Used by modules that add project resources to an Ignition project.
String	getResourceDisplayName(ResourcePath resourcePath)	Allows a module to give an appropriate display name for the resource.
Icon	getResourceIcon(ResourcePath resourcePath)	Allows a module to give an appropriate icon for a resource.
DesignerShapeRegistry	getShapeRegistry()
void	initializeScriptManager(ScriptManager manager)	Initialize a newly-instantiated script manager.
void	locate(Location location)
void	notifyProjectSaveStart(SaveContext save)	Notifies the module that the user has requested that the project is saved.
protected void	setupRM14()
void	shutdown()	Called when the module is shut down.
void	startup(DesignerContext context, LicenseState activationState)	The main entrypoint for the module hook.
void	updateLocationRenderer(LocationRenderingInfo builder, Location location)	Provides an opportunity for a module to enrich tag reference locations with extra context.

Methods inherited from class com.inductiveautomation.ignition.designer.model.AbstractDesignerModuleHook

configureDeserializer, configureFunctionFactory, createPermissionKeys, getResourceCategoryKey, getResourceDisplayName, getResourceIcon, notifyActivationStateChanged, notifyProjectSaveDone

Methods inherited from class java.lang.Object

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

Constructor Details

ReportingDesignerHook

public ReportingDesignerHook()

Method Details

startup

public void startup(DesignerContext context,
 LicenseState activationState)
             throws Exception

Description copied from interface: DesignerModuleHook

The main entrypoint for the module hook. This will only be called once for a given project. If another project is ever opened, DesignerModuleHook.shutdown() will be called and a new hook will be instantiated

Specified by:

startup in interface DesignerModuleHook

Overrides:

startup in class AbstractDesignerModuleHook

Throws:

Exception - if the module was not able to be initialized for the given project.

shutdown

public void shutdown()

Description copied from interface: DesignerModuleHook

Called when the module is shut down. This will happen if the user opens a different project within the same designer session - the existing modules will be shut down, and new module hooks will be instantiated and started up.

Specified by:

shutdown in interface DesignerModuleHook

Overrides:

shutdown in class AbstractDesignerModuleHook

initializeScriptManager

public void initializeScriptManager(ScriptManager manager)

Description copied from interface: DesignerModuleHook

Initialize a newly-instantiated script manager. This will be called exactly once for any given ScriptManager instance. Usually this will involve calling ScriptManager.addScriptModule(String, Object), which reflectively loads the public (instance and static) java functions from the given object into the scripting environment, at the provided path.

Specified by:

initializeScriptManager in interface DesignerModuleHook

Overrides:

initializeScriptManager in class AbstractDesignerModuleHook

setupRM14

protected void setupRM14()

getDataSourceRegistry

public DesignerDataSourceRegistry getDataSourceRegistry()

getShapeRegistry

public DesignerShapeRegistry getShapeRegistry()

getResourceCategoryKey

public String getResourceCategoryKey(ResourcePath resource)

Description copied from interface: DesignerModuleHook

Used by modules that add project resources to an Ignition project. This will be called when the platform needs to render your resource type in first-party UI. Only project resources that match this module's ID will passed to this function.

Specified by:

getResourceCategoryKey in interface DesignerModuleHook

Parameters:

resource - A resource path within this module's resources.

Returns:

A bundle resource key for the category of this resource.

configureSerializer

public void configureSerializer(XMLSerializer serializer)

Description copied from interface: DesignerModuleHook

Provides the module a chance to add serialization delegates to the serializer custom for classes that might be encountered when serializing objects provided by this module

Specified by:

configureSerializer in interface DesignerModuleHook

Overrides:

configureSerializer in class AbstractDesignerModuleHook

notifyProjectSaveStart

public void notifyProjectSaveStart(SaveContext save)

Description copied from interface: DesignerModuleHook

Notifies the module that the user has requested that the project is saved. The module must check-in any checked-out resources that it is holding.

Specified by:

notifyProjectSaveStart in interface DesignerModuleHook

Overrides:

notifyProjectSaveStart in class AbstractDesignerModuleHook

getFrames

@Nonnull
public List<com.jidesoft.docking.DockableFrame> getFrames()

Description copied from interface: DesignerModuleHook

A list of DockableFrames that this module provides, that should be available to all workspaces.

Specified by:

getFrames in interface DesignerModuleHook

Overrides:

getFrames in class AbstractDesignerModuleHook

getModuleMenu

public MenuBarMerge getModuleMenu()

Description copied from interface: DesignerModuleHook

Returns a menu merge for any global menu additions. May be null.

Specified by:

getModuleMenu in interface DesignerModuleHook

Overrides:

getModuleMenu in class AbstractDesignerModuleHook

See Also:

• JMenuMerge

getModuleToolbars

@Nonnull
public List<com.jidesoft.action.CommandBar> getModuleToolbars()

Description copied from interface: DesignerModuleHook

Returns the toolbars for the module. May be empty but not null.

Specified by:

getModuleToolbars in interface DesignerModuleHook

Overrides:

getModuleToolbars in class AbstractDesignerModuleHook

getModuleIcon

@Nullable
public Icon getModuleIcon()

Description copied from interface: DesignerModuleHook

Return an appropriate icon to display for this module. Ideally, an InteractiveIcon of some kind.

Specified by:

getModuleIcon in interface DesignerModuleHook

See Also:

• InteractiveSvgIcon
• InteractiveVectorIcon
• VectorIcons.getInteractive

getResourceIcon

public Icon getResourceIcon(ResourcePath resourcePath)

Description copied from interface: DesignerModuleHook

Allows a module to give an appropriate icon for a resource.

Specified by:

getResourceIcon in interface DesignerModuleHook

See Also:

• InteractiveSvgIcon
• InteractiveVectorIcon
• VectorIcons.getInteractive

getResourceDisplayName

public String getResourceDisplayName(ResourcePath resourcePath)

Description copied from interface: DesignerModuleHook

Allows a module to give an appropriate display name for the resource. For most resources this won't be necessary (the resource's name itself should be used), but for some resources whose name is null, this may be appropriate.

Specified by:

getResourceDisplayName in interface DesignerModuleHook

Returns:

the name for a resource, or null to use the resource's folder path/name.

updateLocationRenderer

public void updateLocationRenderer(@Nonnull
 LocationRenderingInfo builder,
 @Nonnull
 Location location)

Description copied from interface: DesignerModuleHook

Provides an opportunity for a module to enrich tag reference locations with extra context. The location provided is guaranteed to reside within your module. Call methods on LocationRenderingInfo to enrich the rendering.

Specified by:

updateLocationRenderer in interface DesignerModuleHook

Specified by:

updateLocationRenderer in interface LocationRenderingUpdater

See Also:

• LocationRenderingUpdater

locate

public void locate(Location location)

Specified by:

locate in interface Locatable