Func59_ReadSingleArtifact

<< Click to Display Table of Contents >>

Navigation:  Modules > Asset Management > Software License Management > Authorization Analyzer (Complex license types) > AA Functions >

Func59_ReadSingleArtifact

Description

This function will read a single row from the artifacts table.  The results are stored during the processing of a rule and can be accessed using the AA tag JRESULT.

 

NOTES:

1.This function and the JRESULT AA tag both require the rule writer to have detailed knowledge of the artifact details that they wish to look up and use in a rule.

2.The first two parameters are required.  Then at least one of the key values are required.  Artifacts will often require both key values to find a unique record.  

Inputs

 

Parameter

Explanation

Artifact Type

Select a single artifact type from the drop down choices (required)

Source

The source value for the artifact  (required)

Key - Character

The character based key for the artifact (required/optional)

Note: use an empty string to ignore the Key - Character and find the Artifact based on the Key - Integer only

Key - Integer

The integer based key for the artifact (required/optional)

Note: use Key - Integer = 0 to ignore the the Key - Integer and find the artifact based on the Key - Character only

Additional columns to match on (optional)

This is a multi-select that allows the user to select additional columns from the artifacts table to match against

Values to match against (optional)

For every column chosen in the "Additional columns" input, the user must provide a value to match.  One entry per line, they must be in the same order as the columns.  Tags are allowed, but the match must be exact.
 
Note: for number and date columns, empty string values will match null values in the database.  For text columns, empty string values will match on null values AND empty strings in the database.

 

Outputs

 

Result

Result Explanation

Confidence Adjustment

True

No processing errors occurred and an artifact record was found.  The row will be saved in the JResult field of the node and accessible by AA tag for subsequent rule definitions.

N

False

Either the parameters were not complete (see threadlog), or no artifact record matched the input parameters.

Y

Else

An unexpected processing error was encountered

Y

 .