Square9.CustomNode SDK
The Square9.CustomNode namespace provides classes for working with data and documents in Action and Capture based workflow processes. Developers can reference Square9.CustomNode in a .Net Framework class library, most commonly using C# or VB.Net. Numerous code examples are available in Square 9's GitHub Repo.
Classes
- Properties Class
Represents the properties of a process, containing methods for getting and setting property values.
- Database Class
Represents a connected MongoDB database, containing functions for interacting with the processes within MongoDB.
- ActionDocument Class
Represents the document of an ActionProcess, containing properties with GlobalAction document information. Data loaded into this class by the Engine can be used to access specific details
- ActionEngine Class
Represents the executing GlobalAction engine, containing methods and properties pertaining to engine information.
- ActionImporter Class
Base object from which custom Action Importers derive and define behavior. Inherit from this class for any node that will begin a GlobalAction workflow process.
- ActionNode Class
Base class from which GlobalAction Nodes derive and define behavior. Inherit from this class when building any GlobalAction node that will operate on a process after a document has entered a workflow.
- ActionProcess Class
Represents a GlobalAction process in memory, containing properties, methods and classes for use in process manipulation.
- CaptureDocument Class
Represents the document of a GlobalCapture process, containing methods and properties for interaction with a GlobalCapture document.
- CaptureEngine Class
Represents the executing GlobalCapture engine, containing methods and properties pertaining to engine information.
- CaptureImporter Class
Base object from which custom Capture Importers derive and define behavior. An Importer in GlobalCapture is used to inject documents into a workflow. Inherit from this class to create Nodes that start a GlobalCapture workflow.
- CaptureNode Class
Base class from which GlobalCapture Nodes derive and define behavior. A Node in GlobalCapture can be used anywhere in the workflow after a document has been imported and the Process has been created. Inherit from this class to create Nodes that take actions or make decisions on processes in a GlobalCapture workflow.
- CaptureProcess Class
Represents a GlobalCapture process in memory, containing properties, methods and classes for use in process manipulation.
- CustomNode Class
Base class from which Custom Nodes derive and define behavior.
- Database Class
Represents a connected MongoDB database, containing functions for interacting with the processes within MongoDB.
- Engine Class
Represents the executing engine, containing methods and properties pertaining to engine information.
- GlobalSearchDocument Class
Represents a GlobalSearch document associated with a GlobalAction custom node.
- Process Class
Represents a process in memory, containing properties, methods and classes for use in process manipulation.
- ProcessFilter Class
Abstract class representing a process filter, for use in combining into a process query.
- ProcessTypeFilter Class
Represents a process filter by process type.
- Properties Class
Represents the properties of a process, containing methods for getting and setting property values.
- PropertyFilter Class
Represents a process filter by property.
- Setting Class
Represents a node setting controlled by custom node interfaces within GlobalCapture.
- Settings Class
Represents the settings set by a custom node, containing methods for retrieving setting values.
- StatusFilter Class
Represents a process filter by process status.
- WorkflowNameFilter Class
Represents a process filter by workflow name.
Constructors
- PropertyFilter(string, string, PropertyComparator) Constructor
Initializes a new instance of the PropertyFilter class with a specified property name, value, and comparator.
- GlobalSearchDocument(string, string) Constructor
Initializes a new instance of the GlobalSearchDocument class with a specified Archive ID and Document ID.
- ProcessTypeFilter(ProcessType) Constructor
Initializes a new instance of the ProcessTypeFilter class with a specified process type.
- PropertyFilter(string, string, PropertyComparator) Constructor
Initializes a new instance of the PropertyFilter class with a specified property name, value, and comparator.
- StatusFilter(ProcessStatus) Constructor
Initializes a new instance of the StatusFilter class with a specified process status.
- WorkflowNameFilter(string) Constructor
Initializes a new instance of the WorkflowNameFilter class with a specified workflow name.
Designing Custom Node HTML
One of the many benefits of Custom Nodes is the ability to manage their settings and configuration from within the GlobalCapture designer. The node.html file should be added to any Custom Node package.
Enums
- QueryOperator Enum
Specifies logical operators used to execute process queries.
- ProcessStatus Enum
Specifies the process status.
- ProcessType Enum
Specifies the process type.
- PropertyComparator Enum
Specifies logical comparators used to compare property values.
- QueryOperator Enum
Specifies logical operators used to execute process queries.
- SettingType Enum
An enum containing the possible object types of a Setting.
Methods
- AddHistory Method
Adds a history entry to the Process. Use the history to notate import events in the process lifecycle that users or admins might need for troubleshooting or audit history.
- AddPage Method
Adds a file page to the process.
- AddHistory Method
Adds a history entry to the Process. Use the history to notate import events in the process lifecycle that users or admins might need for troubleshooting or audit history.
- AddPage Method
Adds a file page to the process.
- ClearPages Method
Clears all pages from the process.
- CreateProcessByWorkflowName Method
Creates a new Process based on a provided workflow and file.
- CreateProcess Method
Creates a new Process based on a workflow and a file.
- DeleteProcessById Method
Deletes a process from the process database by process ID.
- GetBooleanSetting Method
Gets a bool value from the NodeSettings dictionary by setting name.
- GetCaptureApiClient Method
Gets an HttpClient object configured to make calls to the CaptureApi associated with the executing engine.
- GetEngineConfigSetting Method
Gets a value from the engine app.config file by key name.
- GetIntSetting Method
Gets an int value from the NodeSettings dictionary by setting name.
- GetListSetting Method
Gets a list value from the NodeSettings dictionary by setting name.
- GetMultiValue Method
Gets the values of a multi-value process property.
- GetPage Method
Gets a page file path from the process at a specified index.
- GetPages Method
Gets the full list of page file paths from the process.
- GetProcessById Method
Gets a Process from the process database by process ID.
- GetProcessDynamic Method
Gets the currently executing process from the engine in dynamic object form.
- GetProcessesByProperty Method
Queries the MongoDB database for a list of Processes that satisfy a property match.
- GetProcessesByQuery Method
Queries the MongoDB database for a list of Processes based on a query of combined ProcessFilters.
- GetProcessesByStatus Method
Queries the MongoDB database for a list of Processes of a specific status.
- GetProcessesByWorkflowName Method
Queries the MongoDB database for a list of Processes from a specific workflow.
- GetPropertyByName Method
Gets a property object by property name.
- GetPropertyNames Method
Gets a list of of property names on the current process.
- GetSetting Method
Gets a Setting from the NodeSettings dictionary by setting name.
- GetSingleValue Method
Gets the value of a single value process property.
- GetSquare9ApiClient Method
Gets an HttpClient object configured to make calls to a Square9Api.
- GetStringSetting Method
Gets a string value from the NodeSettings dictionary by setting name.
- GetTableFieldValues Method
Gets the table field values of a table field process property.
- Import Method (ActionImporter)
The method that will run when an ActionImporter is picked up by the engine.
- Import Method (CaptureImporter)
The method that will run when a <see cref="CaptureImporter"/> is picked up by the engine.
- InsertPage Method
Inserts a file page to the process at a specific index.
- InsertProcess Method
Inserts a new Process into the process database.
- LoadConfig Method
Returns a strongly typed object deserialized from the JSON data in the node.config file included in the custom node .s9n file.
- LogHistory Method
Logs a message to the process history.
- MergePages Method
Merges a separated document into a single file on the process.
- MovePage Method
Moves a page from one index in the page array to another.
- RemovePage Method
Removes a page from the process at a specified index and deletes it from the file system.
- ReplacePage Method
Replaces a page at a specific index on the process with another page.
- Run Method
The method that will run when a CustomNode is called by the engine.
- SaveProcessDynamic Method
Overwrites the current process with the provided dynamic process object.
- SaveProperty Method
Saves a property back to the process.
- SetCurrentNodeByNodeName Method
Sets the current node of a process to a new node by name.
- SetMultiValueProperty Method
Sets the value of a multi-value process property.
- SetNextNodeByLinkName Method
Sets the next node by link name.
- SetNextNodeByNodeName Method
Sets the next node by name.
- SetSingleProperty Method
Sets the value of a single value process property.
- SetStatus Method
Sets the ProcessStatus of the process.
- SetTableFieldProperty Method
Sets the value of a table field process property.
- UpdateProcess Method
Updates an existing Process in the process database.