triggerName | String Fully qualified name for the new trigger that uses any combination of letters, and/or the underscore character. Make sure to specify the name of the folder and subfolder in which you want to save the trigger. Note: For a list of reserved words and symbols for element names, see webMethods Service Development Help. | ||
package | String Name of the package in which you want to save the trigger. | ||
properties | Document Optional. Properties that you want to assign to the trigger. | ||
Key | Description | ||
joinTimeOut | String Number of milliseconds Integration Server waits for the other documents in the join condition. Integration Server starts the join time-out period when it pulls the first document that satisfies the join condition from the trigger queue. You need to specify a join time-out only when your condition is an AND or XOR join type. You do not need to specify a join time-out for an OR join condition or a condition that does not use joins. Set joinTimeOut to -1 to indicate that the join condition never expires. The default is 1 day. | ||
queueCapacity | String Maximum number of documents that Integration Server maintains in the queue for this trigger. The default is 10. | ||
queueRefillLevel | String Number of unprocessed documents that must remain in the trigger queue before Integration Server retrieves more documents for the trigger from the Broker. The default is 4. The queueRefillLevel value must be less than or equal to the queueCapacity value. Note: The queueRefillLevel parameter applies to a webMethods messaging trigger that receives documents from the Broker only. At run time, Integration Server ignores the queueRefillLevel if the trigger receives documents from Universal Messaging. | ||
ackQueueSize | String Maximum number of pending document acknowledgments for the trigger. The value must be greater than zero. The default is 1. | ||
maxRetryAttempts | String Maximum number of times Integration Server should attempt to re-execute the trigger service. If you want the trigger service to retry until it executes successfully, specify -1. The default is 5 retries. | ||
retryInterval | String Number of seconds Integration Server waits between retry attempts. The default is 10 seconds. | ||
onRedeliveryFailure | String Specifies how Integration Server handles retry failure for the trigger. Retry failure occurs when Integration Server reaches the maximum number of retry attempts and the trigger service still fails because of a run-time exception. Specify one of the following values: Throw Exception to indicate that Integration Server throws a ServiceException when the last allowed retry attempt ends because of a run-time exception. This is the default. Suspend and Retry Later to indicate that Integration Server suspends the trigger when the last allowed retry attempt ends because of a run-time exception. Integration Server retries the trigger service at a later time. Note: If you set onRedeliveryFailure to Suspend and Retry later, you must specify a service for the resumeTaskSvcName parameter. If you do not specify a service and the trigger suspends because of retry failure, Integration Server will not resume the trigger automatically. You must resume the trigger manually. Selecting Suspend and Retry Later also instructs Integration Server to suspend the trigger when a transient error occurs during trigger preprocessing. For more information about transient error handling during trigger preprocessing, see webMethods Service Development Help. | ||
resumeTaskSvcName | String Fully qualified name of the service that Integration Server executes when one of the following occurs: During exactly-once processing, the document resolver service ends because of a transient error. Integration Server suspends the trigger and invokes the resumeTaskSvcName to determine when the resources associated with the document resolver service are available. After the resources become available, Integration Server resumes document retrieval and document processing for the trigger. A trigger ends because of retry failure and the onRedeliveryFailure variable is set to Suspend and Retry Later. Integration Server executes the resumeTaskSvcName to determine whether the resources associated with a trigger service are available. If the resources are available, Integration Server resumes document retrieval and document processing for the trigger. | ||
isPriorityEnabled | Boolean Indicates whether the trigger receives messages in order of priority or in the order in which they are published. Specify one of the following values: true to indicate that documents should reach the trigger in order of priority. The higher the priority the faster the document will be received. false to indicate that documents should reach the trigger in the order in which they are published. This is the default. Note: The isPriorityEnabled parameter applies to a webMethods messaging trigger that receives documents from the Broker only. At run time, Integration Server ignores the isPriorityEnabled value if the trigger receives a locally published documents or receives documents from Universal Messaging. All webMethods messaging triggers that receive documents from Universal Messaging receive higher priority documents in an expedited fashion. | ||
isConcurrent | String Indicates whether the trigger uses a concurrent processing mode or a serial processing mode. Specify one of the following values: true to specify a concurrent processing mode. Integration Server processes as many documents in the trigger queue as it can at once. false to specify a serial processing mode. Integration Server processes documents in the trigger queue one after the other. This is the default. | ||
serialSuspendOnError | String Indicates whether Integration Server suspends document processing and document retrieval automatically when a trigger service ends with an error. Set to: true to indicate that Integration Server suspends the trigger automatically if an error occurs during trigger service execution. false to indicate that Integration Server should not suspend a trigger if an error occurs during trigger service execution. This is the default. | ||
maxExecutionThreads | String Maximum number of documents that Integration Server can process concurrently for this trigger. Integration Server uses one server thread to process each document in the trigger queue. | ||
dupDetection | String Indicates whether Integration Server performs exactly-once processing for guaranteed documents received by this trigger. Set to: true to indicate that Integration Server performs exactly-once processing for guaranteed documents received by this trigger. false to indicate that exactly-once processing is not performed. This is the default. | ||
dupHistory | String Indicates whether Integration Server uses a document history database as part of performing exactly-once processing. Set to: true to indicate that Integration Server uses a document history database as part of exactly-once processing. false to indicate that Integration Server does not use a document history database as part of exactly-once processing. This is the default. | ||
dupHistoryTTL | String Number of milliseconds that the document history database maintains an entry for a document processed by this trigger. The default is 2 hours. | ||
dupResolverSvcName | String Fully qualified name of the service used to determine conclusively whether a document's status is New, Duplicate, or In Doubt. | ||
executeUser | String Optional. Name of the user account whose credentials Integration Server uses to execute a service associated with the trigger. You can specify a locally defined user account or a user account defined in a central or external directory. The default is Administrator. Note: The executeUser parameter applies to webMethods messaging triggers that receive message from Universal Messaging only. At run time, Integration Server ignores the executeUser value if the trigger receives documents from the Broker or locally published documents. To set the execution user for webMethods messaging triggers that receive documents from Broker or locally published documents, use Integration Server Administrator to set the User property on the Settings > Resources > Store Settings > Edit Document Store Settings page. | ||
conditions | Document List Optional. Specifies the conditions for the trigger. A condition associates one or more publishable document types with a single service. The publishable document type acts as the subscription piece of the trigger. The service is the processing piece. When the trigger receives documents to which it subscribes, the Integration Server processes the document by invoking the service specified in the condition. Triggers can contain multiple conditions; however, a trigger can contain only one join condition. Note: The order in which you list conditions in the conditions list is important because it indicates the order in which Integration Server evaluates the conditions at run time. When Integration Server receives a document, it invokes the service specified in the first condition that is satisfied by the document. The remaining conditions are ignored. For more information about the order in which conditions are evaluated, see the Publish-Subscribe Developer’s Guide. | ||
Key | Description | ||
conditionName | String Name you want to assign to the condition. By default, Integration Server assigns each condition a default name such as Condition1 or Condition2. | ||
serviceName | String Fully qualified name of the service that to be invoked when the trigger receives documents or messages to which it subscribes. | ||
joinType | String The join type for the condition. The join type determines whether Integration Server needs to receive all, any, or only one of the documents or messages in the condition to execute the trigger service. You must specify a joinType if the condition subscribes to more than one document type or message. That is, if messageTypeFilterPairs contains more than one pair, you must select a joinType. Specify one of the following: N/A to indicate this is not a join condition. AND to indicate that Integration Server invokes the trigger service when the server receives an instance of each specified message type within the join time-out period. The instance documents must have the same activation ID. This is the default join type. OR to indicate that Integration Server invokes the associated trigger service when it receives an instance of any one of the specified publishable document types. XOR to indicate that Integration Server invokes the associated trigger service when it receives an instance of any of the specified document types. For the duration of the join time-out period, Integration Server discards (blocks) any instances of the specified publishable document types with the same activation ID. | ||
messageTypeFilterPairs | Document List Specifies the messages and document types to which a trigger subscribes and the filter that must be applied to instances of the message or document type. | ||
Key | Description | ||
messageType | String Fully qualified name of the publishable document type or message to which the trigger subscribes. | ||
filter | String Optional. Filter that you want applied to each received document. The trigger processes only those documents that meet the filter criteria. If the publishable document type uses Broker as the messaging provider, specify a filter that you want Integration Server and/or Broker to apply to each instance of this publishable document type. If the publishable document type uses Universal Messaging as the messaging provider, specify the local filter that you want Integration Server to apply to each instance of the publishable document type received by the trigger. | ||
providerFilter | String Optional. Filter that you want Universal Messaging to apply to each instance of the publishable document type. Universal Messaging enqueues the document for the trigger only if the filter criteria is met. Note: At run time, Integration Server ignores the providerFilter if the trigger receives documents from Broker or locally published documents. | ||
Note: If you specify multiple messageType values in one condition, you need to select a joinType. |