com.inductiveautomation.reporting.gateway

Class ReportingGatewayHook

java.lang.Object

com.inductiveautomation.ignition.gateway.model.AbstractGatewayModuleHook

com.inductiveautomation.reporting.gateway.ReportingGatewayHook

All Implemented Interfaces:

GatewayModuleHook

public class ReportingGatewayHook
extends AbstractGatewayModuleHook

Created by carl.gould on 1/13/2015.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	ReportingGatewayHook.RPC

Constructor Summary

Constructors

Constructor and Description
ReportingGatewayHook()

Method Summary

Modifier and Type	Method and Description
static ReportingGatewayHook	get() Statically retrieves the hook from within a wicket request cycle
static ReportingGatewayHook	get(GatewayContext context) Grabs the Reporting Module's Gateway hook instance from the gateway context
java.lang.String	getLicenseEdition()
LicenseState	getLicenseState()
int	getLimitedReportCount()
java.util.Optional<java.lang.String>	getMountedResourceFolder()
java.util.Optional<java.lang.String>	getMountPathAlias() Used by the mounting underneath /main/res/module-id/* and /main/data/module-id/* as an alternate mounting path instead of your module id, if present.
java.lang.String	getProjectNameFromId(long id)
static java.lang.String	getProjectNameFromId(long id, GatewayContext context)
GatewayDataSourceRegistry	getRegistry()
ReportExecutionData	getReportData(long projectId, java.lang.String reportPath, ReportDataConfiguration dataConfig, java.util.Map<java.lang.String,java.lang.Object> parameters, boolean sampleData, ReportExecutionContext execContext)
ReportExecutionData	getReportData(long projectId, java.lang.String reportPath, ReportDataConfiguration dataConfig, java.util.Map<java.lang.String,java.lang.Object> parameters, java.util.Map<java.lang.String,java.lang.Object> extraConfigs, boolean sampleData, ReportExecutionContext execContext)
java.lang.Object	getRPCHandler(ClientReqSession session, java.lang.Long projectId) A class whose functions will become exposed automatically through reflection to the Designer and the Client through RPC
ReportStatusManager	getStatusManager()
java.util.Optional<OverviewContributor>	getStatusOverviewContributor() Implement this method to contribute meta data to the Status section's Systems / Overview page.
java.util.List<? extends INamedTab>	getStatusPanels() A list (may be null or empty) of panels to display in the status section
void	initializeScriptManager(ScriptManager manager) Initialize a newly-instantiated script manager.
boolean	isTrialExpired()
boolean	isTrialMode()
void	mountRouteHandlers(RouteGroup routes) Provides a chance for the module to mount any route handlers it wants.
void	notifyLicenseStateChanged(LicenseState licenseState) Notify module hook when the license state has changed.
void	setup(GatewayContext context) Called to before startup.
void	shutdown() Called to shutdown this module.
void	startup(LicenseState licenseState) Called to initialize the module.

Methods inherited from class com.inductiveautomation.ignition.gateway.model.AbstractGatewayModuleHook

configureDeserializer, configureFunctionFactory, configureSerializer, getHomepagePanels

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.inductiveautomation.ignition.gateway.model.GatewayModuleHook

getConfigCategories, getConfigOverviewContributor, getConfigPanels, isFreeModule, updateSystemMap

Constructor Detail

ReportingGatewayHook

public ReportingGatewayHook()

Method Detail

get

public static ReportingGatewayHook get(GatewayContext context)

Grabs the Reporting Module's Gateway hook instance from the gateway context

get

public static ReportingGatewayHook get()

Statically retrieves the hook from within a wicket request cycle

setup

public void setup(GatewayContext context)

Description copied from interface: GatewayModuleHook

Called to before startup. This is the chance for the module to add its extension points and update persistent records and schemas. None of the managers will be started up at this point, but the extension point managers will accept extension point types.

startup

public void startup(LicenseState licenseState)

Description copied from interface: GatewayModuleHook

Called to initialize the module. Will only be called once. Persistence interface is available, but only in read-only mode.

shutdown

public void shutdown()

Description copied from interface: GatewayModuleHook

Called to shutdown this module. Note that this instance will never be started back up - a new one will be created if a restart is desired

getProjectNameFromId

public java.lang.String getProjectNameFromId(long id)

getProjectNameFromId

public static java.lang.String getProjectNameFromId(long id,
                                                    GatewayContext context)

getRegistry

public GatewayDataSourceRegistry getRegistry()

getRPCHandler

public java.lang.Object getRPCHandler(ClientReqSession session,
                                      java.lang.Long projectId)

Description copied from interface: GatewayModuleHook

A class whose functions will become exposed automatically through reflection to the Designer and the Client through RPC

Specified by:

getRPCHandler in interface GatewayModuleHook

Overrides:

getRPCHandler in class AbstractGatewayModuleHook

getReportData

public ReportExecutionData getReportData(long projectId,
                                         java.lang.String reportPath,
                                         ReportDataConfiguration dataConfig,
                                         java.util.Map<java.lang.String,java.lang.Object> parameters,
                                         boolean sampleData,
                                         ReportExecutionContext execContext)
                                  throws java.lang.Exception

Throws:

java.lang.Exception

getReportData

public ReportExecutionData getReportData(long projectId,
                                         java.lang.String reportPath,
                                         ReportDataConfiguration dataConfig,
                                         java.util.Map<java.lang.String,java.lang.Object> parameters,
                                         java.util.Map<java.lang.String,java.lang.Object> extraConfigs,
                                         boolean sampleData,
                                         ReportExecutionContext execContext)
                                  throws java.lang.Exception

Throws:

java.lang.Exception

initializeScriptManager

public void initializeScriptManager(ScriptManager manager)

Description copied from interface: GatewayModuleHook

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.

This function may be called before GatewayModuleHook.startup(LicenseState), but never before GatewayModuleHook.setup(GatewayContext).

Specified by:

initializeScriptManager in interface GatewayModuleHook

Overrides:

initializeScriptManager in class AbstractGatewayModuleHook

getStatusManager

public ReportStatusManager getStatusManager()

mountRouteHandlers

public void mountRouteHandlers(RouteGroup routes)

Description copied from interface: GatewayModuleHook

Provides a chance for the module to mount any route handlers it wants. These will be active at /main/data/module-id/* See RouteGroup for details. Will be called after startup().

getMountPathAlias

public java.util.Optional<java.lang.String> getMountPathAlias()

Description copied from interface: GatewayModuleHook

Used by the mounting underneath /main/res/module-id/* and /main/data/module-id/* as an alternate mounting path instead of your module id, if present.

getMountedResourceFolder

public java.util.Optional<java.lang.String> getMountedResourceFolder()

Returns:

the path to a folder in one of the module's gateway jar files that should be mounted at /main/res/module-id/foldername

getStatusOverviewContributor

public java.util.Optional<OverviewContributor> getStatusOverviewContributor()

Description copied from interface: GatewayModuleHook

Implement this method to contribute meta data to the Status section's Systems / Overview page.

getStatusPanels

public java.util.List<? extends INamedTab> getStatusPanels()

Description copied from interface: GatewayModuleHook

A list (may be null or empty) of panels to display in the status section

Specified by:

getStatusPanels in interface GatewayModuleHook

Overrides:

getStatusPanels in class AbstractGatewayModuleHook

notifyLicenseStateChanged

public void notifyLicenseStateChanged(LicenseState licenseState)

Description copied from interface: GatewayModuleHook

Notify module hook when the license state has changed. This could only contain changes for the module or it could contain a change to the platform license (version, restrictions such as expiration date, sqltag count...)

Specified by:

notifyLicenseStateChanged in interface GatewayModuleHook

Overrides:

notifyLicenseStateChanged in class AbstractGatewayModuleHook

getLicenseEdition

public java.lang.String getLicenseEdition()

getLimitedReportCount

public int getLimitedReportCount()

getLicenseState

public LicenseState getLicenseState()

isTrialMode

public boolean isTrialMode()

isTrialExpired

public boolean isTrialExpired()