Condition Scripts

A condition script can be used by commands that use a condition to determine a particular outcome, such as commands that control execution flow.

The following script is an example of a condition script:

using System;
using Sequentum.ContentGrabber.Api;
using Sequentum.ContentGrabber.Commands;
public class Script
{        
 public static bool ConditionScript(ConditionScriptArguments args)
 {
         if(args.GlobalData["test"].ToString().Length == 10)
         {
                 return true;
         }
         else
         {
                 return false;
         }                
 }
}

The script must have a static method with the following signature.

public static bool ConditionScript(ConditionScriptArguments args)

The script must return true or false.

An instance of the ConditionScriptArguments class is provided by Sequentum Enterprise and has the following functions and properties:

Property or Function Description

Agent Agent

The current agent.

ScriptUtils ScriptUtilities

A script utility class with helper methods. See Script Utilities for more information.

Command Command

The current agent command being executed.

IContainer ParentContainer

The parent container command of the current command.

IConnection DatabaseConnection

The current internal database connection used by the agent. This connection is already open and should not be closed by your script.

IHtmlNode HtmlNode

The extracted HTML node.

IHtmlDocument HtmlDocument

The current HTML document.

IInternalDataRow DataRow

The current internal data row containing the data that has been extracted so far in the current container command.

bool IsDebug

True if the agent is running in debug mode.

bool IsSchemaOnly

If true, only the data schema is required, so you can optimize processing by only returning the data schema with no data.

int RetryCount

The number of times this command has been retried.

bool IsParentCommandActionError

This parameter is set to true if the parent action command encountered an error while executing the action command.

IInputData InputDataCache

All input data available to the current command.

BrowserResponse LastErrorResponse

The last error response from the web browser. This will contain any errors messages when loading a new web page.

void WriteDebug(string debugMessage, DebugMessageType messageType = DebugMessageType.Information)

Writes log information to the agent log. This method has no effect if agent logging is disabled, or if called during design time.

debugMessage - The log message.

messageType - The log message type. The agent log level specifies what information is written to the log. If the log level is set to Low for example, only errors are written to the log.

void WriteDebug(string debugMessage, bool showMessageInDesignMode, DebugMessageType messageType = DebugMessageType.Information)

Writes log information to the agent log. This method has no effect if agent logging is disabled, or if called during design time.

debugMessage - The log message.

showMessageInDesignMode - Set to True if you want to see debug messages in design mode.

messageType - The log message type. The agent log level specifies what information is written to the log. If the log level is set to Low for example, only errors are written to the log.

void WriteInfo(string debugMessage, params object[] pars)

Writes log information to the agent log. This method has no effect if agent logging is disabled, or if called during design time.

debugMessage - The log message.

pars - A variable number of parameters used in the debug message.

void WriteError(string debugMessage, params object[] pars)

Writes log error to the agent log. This method has no effect if agent logging is disabled, or if called during design time.

debugMessage - The log message.

pars - A variable number of parameters used in the debug message.

void WriteWarning(string debugMessage, params object[] pars)

Writes log warning to the agent log. This method has no effect if agent logging is disabled, or if called during design time.

debugMessage - The log message.

pars - A variable number of parameters used in the debug message.

void Notify(bool alwaysNotify)

Triggers notification at the end of an agent run. 

alwaysNotify  - If alwaysNotify is set to false, this method only triggers a notification if the agent has been configured to send notifications on critical errors.

void Notify(string message, bool alwaysNotify)

Triggers notification at the end of an agent run, and adds the message to the notification email.

message - The message to add to the notification email.

alwaysNotify  - If alwaysNotify is set to false, this method only triggers a notification if the agent has been configured to send notifications on critical errors.

void AddNotificationMessage(string message)

Adds a message to the notification message, but does not trigger a notification.

message  - The message to add to the notification email.

GlobalDataDictionary GlobalData

Global data dictionary that can be used to store data that needs to be available in all scripts and after agent restarts.

 

Input Parameters are also stored in this dictionary.

IConnection GetDatabaseConnection(string connectionName)

Returns the specified database connection. The database connection must have been previously defined for the agent or be a shared connection for all agents on the computer. Your script is responsible for opening and closing the connection by calling the OpenDatabase and CloseDatabase methods.

IInputDataRow GetInputData()

If the current command is a data provider, the data for that command is returned. Otherwise, this function searches the command's parents and returns the first found input data.

IInputDataRow GetInputData(Command command)

If the specified command is a data provider, the data for that command is returned. Otherwise, this function searches the command's parents and returns the first found input data.

IInputDataRow GetInputData(string commandName)

If the specified command is a data provider, the data for that command is returned. Otherwise, this function searches the command's parents and returns the first found input data.

IInputDataRow GetInputData(Guid commandId)

If the specified command is a data provider, the data for that command is returned. Otherwise, the function throws an error.

void RotateProxies()

Moves to the next proxy before next page load.

void RemoveCurrentProxy()

Removes the current proxy and moves to the next proxy before next page load.

CustomDataStorage GetOrAddDataStorage(string storageName, string key, CustomDataColumns columns)

Returns a custom database table storage that can be used to store persistent data while running an agent. A new storage is created if it does not already exist. The storage is created in the internal database.

storageName - The name of the storage.

key - A value indentifying a sub-storage.

columns - Data field definitions for the storage.

void IncreaseDataCount()

Increases data count.

Was this article helpful?
0 out of 0 found this helpful

Comments

0 comments

Please sign in to leave a comment.