ValidateWorkOrderEdit

Syntax

sub ValidateWorkOrderEdit

Back to top

Description

This function is called for every change request, in which the work order contains hostnames, host and service groups, and/or comments that were manually edited. It receives the change request as input, as well as the edited work order elements. It returns the elements that are invalid.

Back to top

Configuration

By default, this hook is not called. To configure the hook, complete the procedure below.

To enable the ValidateWorkOrderEdit hook, use the generic procedure for overriding system defaults to set the configuration parameter ExternalValidateWorkOrderEdit to the value 1. For details, see Override FireFlow system defaults.

Note: After setting this parameter, you must restart FireFlow for the change to take affect. For details, see Restart FireFlow.

Back to top

Input Parameters

$ticket

A Perl hash reference containing a single key called flatTicket, which points to the flat ticket representation of the change request.

For details, see Flat Ticket Examples.
$validationHash

A Perl hash reference containing the work order elements that were manually edited.

The hash contains the following elements:

  • objects - The object names to be validated.
  • groups - The host and service groups to be validated.
  • comments - The comments to be validated.
$ruleNameInput The rule name to be validated.

Back to top

Return Values

$invalidHash

A Perl hash reference containing the work order elements that were found to be invalid.

Back to top