triggerwf

Build 1501 on 14/Nov/2017  This topic last edited on: 22/Mar/2016, at 16:27

triggerwf [-<option> . . .]

Creates or removes triggers that execute a workflow when something changes in the system.

Options

-remove

   If specified the triggers are removed, otherwise they are created

[-ids] <comma-separated database ids>

   Database id(s) of the object(s) to monitor for changes

-conditions <string>

   Name of the file or of the search configuration containing the searchconditions used to select the objects to monitor for changes

-pars <list of name-value pairs in the format 'name1:value1;name2:value2...'; e.g. 'folderId:30;cmd:up' to define a 'folderId' parameter with value 30 and a 'cmd' parameter with value 'up'.>

   Optional parameters used to replace variables in the search conditions

-mode <trigger mode>

What to monitor: "Object" for changes in the objects, "Referencing" for changes in the referencing objects, and "CheckOut" for check-out/check-in operations. Optional, defaults to "Object" (monitor objects changes)

-attr <string>

Attribute to monitor. Compulsory if monitoring referencing changes, optional - and defaulting to 'any attribute' if monitoring object changes and check-out/check-in operations.

-name <string>

   Workflow name

-wfpars <list of name-value pairs in the format 'name1:value1;name2:value2...';e.g. 'folderId:30;cmd:up' to define a 'folderId' parameter with value 30 and a 'cmd' parameter with value 'up'.>

   Optional extra parameters to pass to the workflow. Ignored when removing    triggers.

-priority <integer>

Execution priority for the workflow. Workflows with higher priority values are executed first. If not specified it is assumed 0 = minimum priority. Ignored when removing triggers.

-profile <string>

Execution profile for the workflow. The profile configuration determines the number of retries and the log actions to take after execution. If not specified the default profile will be used. Ignored when removing triggers.

-username <string>

The optional user name to use to login into the system. If not specified the Web service login is used. Ignored in interactive mode.

-password <string>

The user password to use to login into the system. Ignored if no system user name is specified. Ignored in interactive mode.

-lang <string>

User-interface language, e.g. 'en-US' for English, US version. Ignored in interactive mode.

-srvname <string>

The name of the Web service connection parameters to use, as defined in the user configuration file (USERCONFIG.XML file, typically stored in C:\Users\<yourWindowsname>\AppData\Roaming\TeraDP\GN4\ on Windows 10 / 8 / 7 / Vista and in c:\Documents and Settings\<user name>\Application Data on Windows XP / Server 2003). If not specified the first connection in the configuration file is used. Ignored in interactive mode.

Notes:

When using this parameter, have in mind that there is no way to ensure that the same name in the USERCONFIG.XML file gets used coherently on all network computers. Therefore, this is not a safe method unless you are using it only on well known computers.

Use either -srvname or -srvurl, but not both.

-srvurl <string>

The URL of Web service to connect to, e.g. http://myhost.com/GN4/Adminsrv.asmx. Ignored in interactive mode.

Notes:

When using this parameter, have in mind that it is independent of the USERCONFIG.XML settings, therefore, much safer.

Use either -srvname or -srvurl, but not both.

-srvusername <string>

The Windows user name to use to login to the Web service. If not specified the current Windows login is used, and the password and domain options are ignored. Ignored in interactive mode.

-srvpassword <string>

The Windows user password to use to login to the Web service. Ignored ininteractive mode.

-srvdomain <string>

The domain of the user to use to login to the Web service. Ignored in interactive mode.

-srvpassphrase <string>

Pass-phrase used to encrypt/decrypt data transferred to and from the server. Ignored in interactive mode.