|
<< Click to Display Table of Contents >> Navigation: Modules > Asset Management > Software License Management > Authorization Analyzer (Complex license types) > AA Functions > Func51_CallAnotherRule |
Description
This function is used to "call", or execute, another rule from within the current rule. By default, the called rule operates on the current authorization under test. A different authorization may be submitted (with caution) to the rule. The LUR returned by the called rule is returned as the result of this function. The entire transaction log returned from the called rule is appended to the current rule's transaction log. The entire error log (if any) returned from the called rule is appended to the current rule's error log. The notes from the called rule are also appended to the notes of the current rule.
If the called rule returns a confidence less than 100%, this function returns an ELSE path. Otherwise, if the return code is OK, this function results in TRUE. Otherwise, this function results in FALSE.
Processing Notes
Since it is possible for this function to call a rule that, in turn, calls another rule, which in turn calls another rule, a means for detecting an error condition is needed. This function "watches" the number of nesting levels of rules calling rules until a maximum value is reached. if that maximum is reached, the calling of rules stops and an error condition is returned. The most likely event that will cause the nesting level maximum to be reached is for a rule to call a rule that, in turn, calls the original rule, thereby setting up an infinite loop of calls. Rule designers MUST exercise caution when using this function.
Inputs
Parameter |
Explanation |
|---|---|
Rule to call |
The rule that is the be called. A rule is not permitted to call itself. |
Optional authorization ID of authorization to be used by called rule |
Optionally allows you to specify a different authorization for the called rule to analyze. If left blank, the current authorization under test will be submitted to the called rule. Supports tags as well as AA-specific tags. |
Outputs
Result |
Result Explanation |
Confidence Adjustment |
Return Value |
|---|---|---|---|
True |
Called rule returned no error code and returned confidence from the rule = 100% |
No |
LUR returned by the called rule. |
False |
Called rule returned an error code and returned confidence from the rule = 100% |
No |
LUR returned by the called rule. |
Else |
Called rule returned confidence < 100% Note: The confidence adjustment returned by this function is the standard adjustment programmed for the current rule definition by the rule developer and NOT the confidence returned by the called rule. |
Yes |
LUR returned by the called rule. |