/// <summary>
/// Sets the <paramref name="inputExpression">input expression</paramref> for the input referenced by <paramref name="inputRef"/>
/// </summary>
/// <remarks>
/// When the expression is null or whitespace the table input will not be used for the rule (will be removed when it was already defined before).
/// When the expression is "valid" and the input expression has been defined before, it will override it
/// </remarks>
/// <param name="inputRef">Reference to decision table input</param>
/// <param name="inputExpression">Input evaluation expression</param>
/// <exception cref="DmnBuilderException">Throws <see cref="DmnBuilderException"/> when the definition has already been built</exception>
/// <exception cref="ArgumentNullException">Throws <see cref="ArgumentNullException"/> when the <paramref name="inputRef"/> is null</exception>
/// <exception cref="DmnBuilderException">Throws <see cref="DmnBuilderException"/> when the <paramref name="inputRef"/> is not recognized as the valid table input</exception>
private void SetInput(TableInput.Ref inputRef, string inputExpression)
{
if (IsBuilt)
{
throw Logger.Error <DmnBuilderException>("Table rule is already built");
}
if (inputRef == null)
{
throw new ArgumentNullException(nameof(inputRef));
}
if (!AllTableInputs.ContainsKey(inputRef))
{
throw Logger.Error <DmnBuilderException>("Input reference is not valid for current table");
}
if (string.IsNullOrWhiteSpace(inputExpression))
{
if (InputsInternal.ContainsKey(inputRef))
{
InputsInternal.Remove(inputRef);
}
}
else
{
InputsInternal[inputRef] = inputExpression;
}
}
/// <summary>
/// Adds the expression based table input
/// </summary>
/// <remarks>The inputs are "indexed" in the order as added to the table definition builder</remarks>
/// <param name="expression">Expression to be used as table input</param>
/// <param name="inputRef">Reference to added table input that can be used in rule builders</param>
/// <param name="allowedValues">Allowed input values</param>
/// <exception cref="DmnBuilderException">Throws <see cref="DmnBuilderException"/> when the definition has already been built</exception>
/// <exception cref="ArgumentNullException"> when the <paramref name="expression"/> is not provided</exception>
/// <exception cref="ArgumentException"> when the <paramref name="expression"/> is empty or whitespace</exception>
public TableDecision WithInput(string expression, out TableInput.Ref inputRef, params string[] allowedValues)
{
if (IsBuilt)
{
throw Logger.Error <DmnBuilderException>($"Decision is already built");
}
if (expression == null)
{
throw new ArgumentNullException(nameof(expression));
}
if (string.IsNullOrWhiteSpace(expression))
{
throw new ArgumentException("Missing expression", nameof(expression));
}
var input = new TableInput(Variables, Decisions, InputsInternal.Count).WithExpression(expression);
_ = allowedValues != null && allowedValues.Length > 0
? input.WithAllowedValues(allowedValues)
: input.WithoutAllowedValuesConstraint();
inputRef = input.Reference;
InputsInternal.Add(input);
InputsByRef.Add(inputRef, input);
return(this);
}
/// <summary>
/// Sets the <paramref name="inputExpression">input expression</paramref> for the input referenced by <paramref name="inputRef"/>
/// </summary>
/// <remarks>
/// When the expression is null or whitespace the table input will not be used for the rule (will be removed when it was already defined before).
/// When the expression is "valid" and the input expression has been defined before, it will override it
/// </remarks>
/// <param name="inputRef">Reference to decision table input</param>
/// <param name="inputExpression">Input evaluation expression</param>
/// <exception cref="DmnBuilderException">Throws <see cref="DmnBuilderException"/> when the definition has already been built</exception>
/// <exception cref="ArgumentNullException">Throws <see cref="ArgumentNullException"/> when the <paramref name="inputRef"/> is null</exception>
/// <exception cref="DmnBuilderException">Throws <see cref="DmnBuilderException"/> when the <paramref name="inputRef"/> is not recognized as the valid table input</exception>
public TableRuleThenOrAndBuilder And(TableInput.Ref inputRef, string inputExpression)
{
Rule.SetInput(inputRef, inputExpression);
return(this);
}
/// <summary>
/// Sets the <paramref name="inputExpression">input expression</paramref> for the input referenced by <paramref name="inputRef"/>
/// </summary>
/// <remarks>
/// <see cref="When"/>clears all input expressions for the rule first and then add the <paramref name="inputExpression"/> for <see cref="inputRef"/>
/// When the expression is null or whitespace the table input will not be used for the rule (will not be added).
/// </remarks>
/// <param name="inputRef">Reference to decision table input</param>
/// <param name="inputExpression">Input evaluation expression</param>
/// <exception cref="DmnBuilderException">Throws <see cref="DmnBuilderException"/> when the definition has already been built</exception>
/// <exception cref="ArgumentNullException">Throws <see cref="ArgumentNullException"/> when the <paramref name="inputRef"/> is null</exception>
/// <exception cref="DmnBuilderException">Throws <see cref="DmnBuilderException"/> when the <paramref name="inputRef"/> is not recognized as the valid table input</exception>
public TableRuleThenOrAndBuilder When(TableInput.Ref inputRef, string inputExpression)
{
Rule.ClearInputs();
Rule.SetInput(inputRef, inputExpression);
return(new TableRuleThenOrAndBuilder(Rule));
}
/// <summary>
/// Adds the expression based table input
/// </summary>
/// <remarks>The inputs are "indexed" in the order as added to the table definition builder</remarks>
/// <param name="expression">Expression to be used as table input</param>
/// <param name="inputRef">Reference to added table input that can be used in rule builders</param>
/// <exception cref="DmnBuilderException">Throws <see cref="DmnBuilderException"/> when the definition has already been built</exception>
/// <exception cref="ArgumentNullException"> when the <paramref name="expression"/> is not provided</exception>
/// <exception cref="ArgumentException"> when the <paramref name="expression"/> is empty or whitespace</exception>
public TableDecision WithInput(string expression, out TableInput.Ref inputRef)
{
return(WithInput(expression, out inputRef, null));
}
/// <summary>
/// Adds the variable based table input
/// </summary>
/// <remarks>The inputs are "indexed" in the order as added to the table definition builder</remarks>
/// <param name="variableRef">Reference to variable used as table input</param>
/// <param name="inputRef">Reference to added table input that can be used in rule builders</param>
/// <exception cref="DmnBuilderException">Throws <see cref="DmnBuilderException"/> when the definition has already been built</exception>
public TableDecision WithInput(Variable.Ref variableRef, out TableInput.Ref inputRef)
{
return(WithInput(variableRef, out inputRef, null));
}
