ConfigurableVaultApplicationBaseTSecureConfiguration Class |
Namespace: MFiles.VAF.Core
public class ConfigurableVaultApplicationBase<TSecureConfiguration> : VaultApplicationBase, IUsesAdminConfigurations, IUsesVaultExtensionMethods, IConfigurationDomainNode where TSecureConfiguration : class, new()
The ConfigurableVaultApplicationBaseTSecureConfiguration type exposes the following members.
Name | Description | |
---|---|---|
![]() | ConfigurableVaultApplicationBaseTSecureConfiguration |
Constructor.
|
Name | Description | |
---|---|---|
![]() | AdminConfigurationsManager |
Admin Configuration Manager to handle the wire-up between M-Files Admin and Dashboard Nodes.
(Inherited from VaultApplicationBase.) |
![]() | ApplicationDefinition |
The application definition information.
(Inherited from VaultApplicationBase.) |
![]() | ApplicationRunningStatus |
Returns the application running status. Indicates if the application is starting, stopping or running normally.
(Inherited from VaultApplicationBase.) |
![]() | BackgroundOperations |
A manager for creating background operations.
(Inherited from VaultApplicationBase.) |
![]() | Configuration |
The application's current configuration.
|
![]() | ConfigurationStorage |
The configuration storage object.
(Inherited from VaultApplicationBase.) |
![]() | ConfManager |
Configuration Manager that enforces security controls.
|
![]() | EventSourceIdentifier |
Returns the vault application event source identifier that is used when logging to Windows event log.
(Inherited from VaultApplicationBase.) |
![]() | ExecutionTracer |
The execution tracer object.
(Inherited from VaultApplicationBase.) |
![]() | InitialLoadComplete |
True after the Initialize() method has been executed.
(Inherited from VaultApplicationBase.) |
![]() | License |
The optional license of the application.
Set this in inherited class constructor to get license.
(Inherited from VaultApplicationBase.) |
![]() | MetadataStructureValidationResult |
The results from the metadata structure validation.
(Inherited from VaultApplicationBase.) |
![]() | MetadataStructureValidator |
The metadata structure validator object.
(Inherited from VaultApplicationBase.) |
![]() | PermanentVault |
The permanent vault object, runs as MFServer user.
(Inherited from VaultApplicationBase.) |
![]() | TaskQueueManager |
Task queue manager.
(Inherited from VaultApplicationBase.) |
Name | Description | |
---|---|---|
![]() | AddVaultExtensionMethod |
Adds a vault extension method that does not have a separate event handler proxy.
(Inherited from VaultApplicationBase.) |
![]() | AssertApplicationInStableState |
Throws an exception if the application is in a state where it
cannot properly handle server events.
(Inherited from VaultApplicationBase.) |
![]() | ClearAutomaticallyGeneratedScripts |
Clears the automatically generated scripts that are no longer used from the metadata structure (from property definitions and workflow states).
(Inherited from VaultApplicationBase.) |
![]() | CollectUnusedHandlers |
Method for collecting extension method names which are unused.
(Inherited from VaultApplicationBase.) |
![]() | ConvertToLocalVault |
Overridable factory method for local vault objects. Converts the vault object to locally used and possibly
stored vault object. This method allows the implementations to improve the performance by using
in-process vault. Overriding functionality may e.g. implement local caching features to the vault.
(Inherited from VaultApplicationBase.) |
![]() | CreateAdminConfigurationManager |
Overridable factory method to create the admin configuration manager object.
(Inherited from VaultApplicationBase.) |
![]() | CreateConfigurationStorage |
Provides the application storage.
This is sealed, as it always returns the configuration manager's storage object.
(Overrides VaultApplicationBaseCreateConfigurationStorage.) |
![]() | CreateEventHandlerMethodInfo |
Overridable factory method to create the event handler method info.
(Inherited from VaultApplicationBase.) |
![]() | CreateExecutionTracer |
Overridable factory method to create the execution tracer object.
(Inherited from VaultApplicationBase.) |
![]() | CreateMetadataStructureCacheEventSink |
Creates the metadata structure cache event sink that can be used to update the cache based on events. Currently
only updating the users, user groups and logins is supported. If one does not want to register the event handlers
and update the cache then this method should be overridden and it should return null.
(Inherited from VaultApplicationBase.) |
![]() | CreateMetadataStructureValidator |
Overridable factory method to create the metadata structure validator component.
(Inherited from VaultApplicationBase.) |
![]() | CreatePropertyMethodInfo |
Overridable factory method to create the property method info.
(Inherited from VaultApplicationBase.) |
![]() | CreateStateMethodInfo |
Overridable factory method to create the state method info.
(Inherited from VaultApplicationBase.) |
![]() | CreateStateTransitionMethodInfo |
Overridable factory method to create the state transition method info.
(Inherited from VaultApplicationBase.) |
![]() | CreateVaultExtensionMethodInfo |
Overridable factory method to create the vault extension method info.
(Inherited from VaultApplicationBase.) |
![]() | CustomValidation |
Override this method to perform custom validation on the configuration/vault.
|
![]() | Equals | Determines whether the specified object is equal to the current object. (Inherited from Object.) |
![]() | EvaluateAutomaticStateTransitionTrigger |
Invokes the registered automatic state transition condition handlers.
(Inherited from VaultApplicationBase.) |
![]() | EvaluateStatePostConditions |
Invokes all the state post-condition evaluation handlers.
(Inherited from VaultApplicationBase.) |
![]() | EvaluateStatePreConditions |
Invokes all the state precondition evaluation handlers.
(Inherited from VaultApplicationBase.) |
![]() | EventHandlerBelongsToThisVaultApplication |
Check if the event handler belongs to this application.
(Inherited from VaultApplicationBase.) |
![]() | ExecuteVaultExtensionMethod |
Executes the defined vault extension method.
(Inherited from VaultApplicationBase.) |
![]() | Finalize | Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.) |
![]() | GetApplicationLicenseDetails |
Called by platform to request the license details text, either currently loaded or the given license.
(Inherited from VaultApplicationBase.) |
![]() | GetApplicationLicenseStatus |
Called to request the status information of the application.
(Inherited from VaultApplicationBase.) |
![]() | GetCapabilities |
Describes the capabilities this node has.
The capabilities returned correspond to which
interface methods are implemented/ok to call.
|
![]() | GetCommands |
Provides the commands that can be shown and/or run for this node.
Only safe to call if GetCapabilities returns the
Commands flag.
|
![]() | GetConfiguration |
Gets the current/stored configuration value for the node.
Only safe to call if GetCapabilities returns the
Configuration flag.
|
![]() | GetConfigurationManager |
Resolves the configuration manager the application uses.
This can control where the configuration is stored/loaded from and what the
default security level is.
|
![]() | GetConfigurationSchema |
Gets the schema describing the structure of the configuration.
Only safe to call if GetCapabilities returns the
Schema flag.
|
![]() | GetDashboardContent |
Provides the html for a custom dashboard to display for the node.
Only safe to call if GetCapabilities returns the
StatusDashboard flag.
|
![]() | GetDelegateScriptTemplate |
Method for reading the VBScript template from the resources.
(Inherited from VaultApplicationBase.) |
![]() | GetDescription |
Provides a description of the domain.
Currently displayed in the domain header area, and in some
default dashboards.
|
![]() | GetEventHandlerDelegateScript |
Method for retrieving the VBScript delegation code for the certain event type.
(Inherited from VaultApplicationBase.) |
![]() | GetEventHandlerEnvironment |
Creates the local event handler environment.
(Inherited from VaultApplicationBase.) |
![]() | GetHashCode | Serves as the default hash function. (Inherited from Object.) |
![]() | GetID |
Provides the static id for the node.
This value should at least be unique amongst siblings.
IDs cannot have spaces, newlines or periods.
|
![]() | GetMetadataStructureCache |
Creates the metadata structure cache for the given vault. If the caching is not desired then
this method should be overridden and it should return null.
(Inherited from VaultApplicationBase.) |
![]() | GetMethodsByAttributeT |
Returns a collection of the methods decorated with the given attribute.
(Inherited from MethodSource.) |
![]() | GetName |
Gets the human readable name for the domain.
Can be localized.
|
![]() | GetPrivateMethodSources |
Gets private method sources
(Inherited from VaultApplicationBase.) |
![]() | GetPropertyAutomaticNumber |
Invokes the property customized automatic numbering handler.
(Inherited from VaultApplicationBase.) |
![]() | GetPropertyCustomValue |
Invokes the property custom value calculation handler.
(Inherited from VaultApplicationBase.) |
![]() | GetPropertyEnvironment |
Creates the local property environment.
(Inherited from VaultApplicationBase.) |
![]() | GetPropertyHandlerDelegateScript |
Method for retrieving the VBScript delegation code for the certain state.
(Inherited from VaultApplicationBase.) |
![]() | GetSortPriority |
Controls the order in which the node appears amongst siblings.
|
![]() | GetStateEnvironment |
Creates the local state environment.
(Inherited from VaultApplicationBase.) |
![]() | GetStateHandlerDelegateScript |
Method for retrieving the VBScript delegation code for the certain state.
(Inherited from VaultApplicationBase.) |
![]() | GetStateTransitionEnvironment |
Creates the local state environment.
(Inherited from VaultApplicationBase.) |
![]() | GetStateTransitionHandlerDelegateScript |
Method for retrieving the VBScript delegation code for a certain state transition.
(Inherited from VaultApplicationBase.) |
![]() | GetStatusSummary |
Provides a status summary for the node.
Only safe to call if GetCapabilities returns the
StatusSummary flag.
|
![]() | GetSubDomainNodes |
Provides a list of sub domain nodes to appear as children of this node.
Only safe to call if GetCapabilities returns the
SubDomains flag.
|
![]() | GetType | Gets the Type of the current instance. (Inherited from Object.) |
![]() | GetVaultExtensionMethodDelegateScript |
Method for retrieving the VBScript delegation code for the certain vault extension method.
(Inherited from VaultApplicationBase.) |
![]() | GetVaultExtensionMethodEventHandlerProxyName |
Returns the name for the vault extension method event handler proxy of this Vault Application.
(Inherited from VaultApplicationBase.) |
![]() | Initialize |
Initializes the vault application in the specified vault. The method e.g. installs required event delegating scripts in the vault.
(Inherited from VaultApplicationBase.) |
![]() | InitializeAdminConfigurations |
Provides the AdminConfigurationManager instance created for this app to interface
with the MFAdmin configuration node.
|
![]() | InitializeApplication |
Protected overridable for the child classes to override instead of Initialize.
InitializeApplication can be used to make changes to the vault structure.
(Inherited from VaultApplicationBase.) |
![]() | InitializeImpl |
Reload clear the internal data structures and loads the modules and their event handlers.
(Inherited from VaultApplicationBase.) |
![]() | InitializeTaskQueueManager |
Protected overridable for the child classes to override so they can pass in their own settings.
PermanentVault is initialized and should be used as the vault connection.
(Inherited from VaultApplicationBase.) |
![]() | Install |
Installs the application.
(Inherited from VaultApplicationBase.) |
![]() | InstallApplication |
Protected overridable for the child classes to override instead of Install.
InstallApplication can be used to prevent installation of the application.
InstallApplication should also install any additional required components.
InstallApplication cannot make changes to the vault structure.
(Inherited from VaultApplicationBase.) |
![]() | InstallEventHandlerAndVaultExtensionMethodDelegateScripts |
Generates and installs the VBScript delegate scripts for event handlers defined in the application.
(Inherited from VaultApplicationBase.) |
![]() | InstallHandlerDelegateScripts |
Generates and installs the VBScript delegate scripts for all handlers that are defined in the application.
(Inherited from VaultApplicationBase.) |
![]() | InstallPropertyHandlerDelegateScripts |
Generates and installs the VBScript delegate scripts for property handlers defined in the application.
(Inherited from VaultApplicationBase.) |
![]() | InstallStateAndStateTransitionHandlerDelegateScripts |
Generates and installs the VBScript delegate scripts for state handlers defined in the application.
(Inherited from VaultApplicationBase.) |
![]() | IsGeneratedAutomatically |
Checks if the given script is generated automatically. This is decided by the existence of a line with certain content.
(Inherited from VaultApplicationBase.) |
![]() | IsHandlerDefinedForProperty |
Checks if the has handler(s) of the given type.
(Inherited from VaultApplicationBase.) |
![]() | IsHandlerDefinedForState |
Checks if the state has handler(s) of the given type.
(Inherited from VaultApplicationBase.) |
![]() | IsHandlerDefinedForStateTransition |
Checks if the state has handler(s) of the given type.
(Inherited from VaultApplicationBase.) |
![]() | IsValid |
Indicates whether the current configuration is valid based on the
built-in validation and custom validation logic.
|
![]() | LoadConfiguration |
Safely loads the application's configuration.
Defaulting to an empty JSON object if none is found.
|
![]() | LoadHandlerMethods |
Finds and caches all event handler methods and vault extension methods in the assembly. The methods are decorated with specific attributes.
(Inherited from VaultApplicationBase.) |
![]() | MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.) |
![]() | NewEnvironment |
Returns a new Event Handler environment, to be populated in the event handler script.
(Inherited from VaultApplicationBase.) |
![]() | OnConfigurationUpdated |
Override this to handle configuration changes.
|
![]() | PopulateConfigurationObjects(Vault) | (Overrides VaultApplicationBasePopulateConfigurationObjects(Vault).) |
![]() | PopulateConfigurationObjects(Vault, Object) |
Populates a configuration objects from single host object.
(Inherited from VaultApplicationBase.) |
![]() | PopulateConfigurationObjectsAndValidate |
Populates and validates objects marked with MFConfiguration attribute.
(Inherited from VaultApplicationBase.) |
![]() | RegisterEventHandlers |
Registers the specified event handler method.
(Inherited from VaultApplicationBase.) |
![]() | RegisterHandlersT |
Generic method for collecting all methods from the given source that are decorated with the specified attribute type.
(Inherited from VaultApplicationBase.) |
![]() | RegisterMethodsFromSource |
Registers all methods from the specified source.
(Inherited from VaultApplicationBase.) |
![]() | RegisterPropertyHandler |
Registers the specified property handler method.
(Inherited from VaultApplicationBase.) |
![]() | RegisterStateHandler |
Registers the specified state handler method.
(Inherited from VaultApplicationBase.) |
![]() | RegisterStateTransitionHandler |
Registers the specified state transition handler method.
(Inherited from VaultApplicationBase.) |
![]() | RegisterVaultExtensionMethodHandler |
Registers the specified vault extension method.
(Inherited from VaultApplicationBase.) |
![]() | ReinitializeMetadataStructureCache |
Reinitialize the metadata structure cache.
(Inherited from VaultApplicationBase.) |
![]() | RemoveVaultExtensionMethod |
Removes a vault extension method that does not have a separate event handler proxy.
(Inherited from VaultApplicationBase.) |
![]() | ReportMetadataStructureValidationErrors |
Handles the validation results. By default only outputs errors to event log.
(Inherited from VaultApplicationBase.) |
![]() | Run |
Invokes all methods that have the MFEventHandlerAttribute and are applicable to this event.
(Inherited from VaultApplicationBase.) |
![]() | RunStateAction |
Invokes the state run action handlers.
(Inherited from VaultApplicationBase.) |
![]() | SaveConfiguration |
Saves a new configuration value for the node.
Only safe to call if GetCapabilities returns the
Configuration flag.
|
![]() | SetApplicationLicense |
Setting in new license content.
Gets called after application instantiation before Initialize(),
and also when a new license is applyed from MF-Admin.
(Inherited from VaultApplicationBase.) |
![]() | SetCallingThreadCulture |
Sets the current thread culture according to the current user's culture.
(Inherited from VaultApplicationBase.) |
![]() | ShouldUpdateScript |
Checks if the script should be updated. The script should be updated only if the old script was automatically generated
and the new script differs from the old one.
(Inherited from VaultApplicationBase.) |
![]() | StartApplication |
Protected overridable for the child classes to override instead of StartOperations. PermanentVault is initialized and should be used as the vault connection.
StartApplication should be used to start recurring background operations.
(Inherited from VaultApplicationBase.) |
![]() | StartOperations |
Starts the vault operations in the specified vault. The method e.g. begins to use the vault in a background job.
(Inherited from VaultApplicationBase.) |
![]() | ToString | Returns a string that represents the current object. (Inherited from Object.) |
![]() | Uninitialize |
Un-initializes the vault application in the specified vault.
(Inherited from VaultApplicationBase.) |
![]() | UninitializeApplication |
Protected overridable for the child classes to override instead of Uninitialize.
UninitializeApplication can be used make changes in the vault structure.
(Inherited from VaultApplicationBase.) |
![]() | UninitializeImpl |
Un-initializes the vault application in the specified vault.
(Inherited from VaultApplicationBase.) |
![]() | Uninstall |
Uninstall the application.
(Inherited from VaultApplicationBase.) |
![]() | UninstallApplication |
Protected overridable for the child classes to override instead of Uninitialize.
UninstallApplication can be used to prevent uninstallation of the application.
UninstallApplication should also uninstall any additional required components, that were installed by the InstallApplication-method.
UninstallApplication cannot make changes to the vault structure.
(Inherited from VaultApplicationBase.) |
![]() | Validate |
Validates the node along with the current, or passed configuration text.
Only safe to call if GetCapabilities returns the
Validation flag.
|
![]() | ValidateConfigurationAttributes |
Does internal "old school" validation based on configuration attributes.
|
![]() | ValidateMetadataStructure |
Validates the application and all types in the same assembly.
(Inherited from VaultApplicationBase.) |
![]() | ValidatePropertyValue |
Invokes all property validation handlers.
(Inherited from VaultApplicationBase.) |
Name | Description | |
---|---|---|
![]() | applicationRunningStatus |
Indicates the application running status. This is volatile because the value can be accessed from multiple threads to avoid caching delays -- the enumeration read and write itself is atomic.
(Inherited from VaultApplicationBase.) |
![]() | cacheEventSink |
The vault listeners registered to update the metadatastructurecache backing vault instances.
(Inherited from VaultApplicationBase.) |
![]() | eventHandlerMethods |
Collections of the event handling methods.
(Inherited from VaultApplicationBase.) |
![]() | eventSourceIdentifier |
The application event source identifier that is used in conjunction with the Windows event log.
(Inherited from VaultApplicationBase.) |
![]() | MaxTimeToWaitBackgroundOperationsAtUninitialization |
Defines how long the background operations can be waited at uninitialization.
(Inherited from VaultApplicationBase.) |
![]() | propertyMethods |
Collection of property extension methods by property.
(Inherited from VaultApplicationBase.) |
![]() | stateMethods |
Collection of state extension methods by state.
(Inherited from VaultApplicationBase.) |
![]() | stateTransitionMethods |
Collection of state transition extension methods by state.
(Inherited from VaultApplicationBase.) |
![]() | unusedVaultExtensionNames |
List of vault extension method names which are known but not used.
(Inherited from VaultApplicationBase.) |
![]() | vaultExtensionMethods |
Collection of vault extension methods by name.
(Inherited from VaultApplicationBase.) |
Name | Description | |
---|---|---|
![]() | AssertCapable |
Throws an exception if a node does not support a certain capability.
(Defined by ConfigurationDomainNodeExtensionMethods.) |
![]() | IsCapable |
Determines whether a node supports a certain capability.
Capabilities correspond to interface methods that are
valid to call on a node.
(Defined by ConfigurationDomainNodeExtensionMethods.) |