Package com.inductiveautomation.sfc.designer

Class SFCDesignerHook

java.lang.Object

com.inductiveautomation.ignition.designer.model.AbstractDesignerModuleHook

com.inductiveautomation.sfc.designer.SFCDesignerHook

All Implemented Interfaces:

DesignerModuleHook, ClientStepRegistryProvider, StepConfigRegistry

public class SFCDesignerHook
extends AbstractDesignerModuleHook
implements ClientStepRegistryProvider, StepConfigRegistry

Constructor Summary

Constructors

Constructor	Description
SFCDesignerHook()

Method Summary

Modifier and Type	Method	Description
java.util.Map<java.lang.String,java.lang.String>	createPermissionKeys()	Allows a module to create one or more id-bundlekey pairs that the module will use for role-based client security.
static SFCDesignerHook	get(DesignerContext context)
StepConfigFactory	getConfigFactory(java.lang.String factoryId)
MenuBarMerge	getModuleMenu()	Returns a menu merge for any global menu additions.
java.lang.String	getResourceCategoryKey(ProjectResourceId resource)	Used by modules that add project resources to an Ignition project.
ClientStepRegistry	getStepRegistry()
SfcWorkspace	getWorkspace()
void	initializeScriptManager(ScriptManager manager)	Initialize a newly-instantiated script manager.
boolean	isSaving()
void	notifyProjectSaveDone()	Notifies the module that the save operation has finished.
void	notifyProjectSaveStart(SaveContext save)	Notifies the module that the user has requested that the project is saved.
void	register(java.lang.String stepFactoryId, StepConfigFactory factory)
void	shutdown()	Called when the module is shut down.
void	startup(DesignerContext context, LicenseState activationState)	The main entrypoint for the module hook.

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

configureDeserializer, configureFunctionFactory, configureSerializer, getFrames, getModuleToolbars, getResourceDisplayName, getResourceIcon, notifyActivationStateChanged

Methods inherited from class java.lang.Object

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

Constructor Detail

SFCDesignerHook

public SFCDesignerHook()

Method Detail

get

public static SFCDesignerHook get(DesignerContext context)

getWorkspace

public SfcWorkspace getWorkspace()

register

public void register(java.lang.String stepFactoryId,
                     StepConfigFactory factory)

Specified by:

register in interface StepConfigRegistry

getConfigFactory

public StepConfigFactory getConfigFactory(java.lang.String factoryId)

startup

public void startup(DesignerContext context,
                    LicenseState activationState)
             throws java.lang.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:

java.lang.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

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

notifyProjectSaveDone

public void notifyProjectSaveDone()

Description copied from interface: DesignerModuleHook

Notifies the module that the save operation has finished. This is the cue to check-out any previously checked-out resources that it was forced to check-in before the save.

Specified by:

notifyProjectSaveDone in interface DesignerModuleHook

Overrides:

notifyProjectSaveDone in class AbstractDesignerModuleHook

isSaving

public boolean isSaving()

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

getStepRegistry

public ClientStepRegistry getStepRegistry()

Specified by:

getStepRegistry in interface ClientStepRegistryProvider

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

getResourceCategoryKey

public java.lang.String getResourceCategoryKey(ProjectResourceId resource)

Description copied from interface: DesignerModuleHook

Used by modules that add project resources to an Ignition project. This will be called when the exporter is displaying all of the resources inside a project for export. Only project resources that match this module's ID will passed to this function.

Used by the import/export system.

Specified by:

getResourceCategoryKey in interface DesignerModuleHook

Overrides:

getResourceCategoryKey in class AbstractDesignerModuleHook

Parameters:

resource - A project resource that was added by this module.

Returns:

A bundle resource key for the category of this resource.

createPermissionKeys

public java.util.Map<java.lang.String,java.lang.String> createPermissionKeys()

Description copied from interface: DesignerModuleHook

Allows a module to create one or more id-bundlekey pairs that the module will use for role-based client security.

Specified by:

createPermissionKeys in interface DesignerModuleHook

Overrides:

createPermissionKeys in class AbstractDesignerModuleHook

Returns:

Map of id-bundlekey entries. May be empty but not null.