payroll runtime and function: added method lookup apply range value

updated version to 0.9.0-beta.12

Author: Jani Giannoudis

Client.Scripting/Function/PayrollFunction.cs

@@ -978,6 +978,16 @@ public T GetRangeObjectLookup<T>(string lookupName, decimal rangeValue, string o
         return string.IsNullOrWhiteSpace(value) ? default : value.ObjectValueJson<T>(objectKey);
     }
 
+    /// <summary>Apply a range value to the lookup ranges, and multiplying the lookup value with the range amount</summary>
+    /// <param name="lookupName">The lookup name</param>
+    /// <param name="rangeValue">The range value</param>
+    /// <param name="valueFieldName">Value field name</param>
+    /// <remarks>Only numeric JSON lookup values are supported.
+    /// The first lookup range value must be zero.</remarks>
+    /// <returns>Summary of all lookup ranges</returns>
+    public decimal ApplyRangeValue(string lookupName, decimal rangeValue, string valueFieldName = null) =>
+        Runtime.ApplyRangeValue(lookupName, rangeValue, valueFieldName);
+
     #endregion
 
     #region Actions

Client.Scripting/PayrollEngine.Client.Scripting.csproj

@@ -182,7 +182,7 @@
 
 	<ItemGroup>
 		<PackageReference Include="Microsoft.CodeAnalysis.CSharp" Version="4.14.0" />
-		<PackageReference Include="PayrollEngine.Client.Core" Version="0.9.0-beta.11" />
+		<PackageReference Include="PayrollEngine.Client.Core" Version="0.9.0-beta.12" />
 	</ItemGroup>
 
 	<!-- include xml documention files and json schemas to the nuget package -->

Client.Scripting/PayrollEngine.Client.Scripting.xml

@@ -6470,6 +6470,15 @@
             <param name="lookupKey">The lookup key (optional)</param>
             <param name="culture">The culture, null for the system culture (optional)</param>
         </member>
+        <member name="M:PayrollEngine.Client.Scripting.Function.PayrollFunction.ApplyRangeValue(System.String,System.Decimal,System.String)">
+            <summary>Apply a range value to the lookup ranges, and multiplying the lookup value with the range amount</summary>
+            <param name="lookupName">The lookup name</param>
+            <param name="rangeValue">The range value</param>
+            <param name="valueFieldName">Value field name</param>
+            <remarks>Only numeric JSON lookup values are supported.
+            The first lookup range value must be zero.</remarks>
+            <returns>Summary of all lookup ranges</returns>
+        </member>
         <member name="F:PayrollEngine.Client.Scripting.Function.PayrollFunction.ConditionConsequentMarker">
             <summary>Condition consequent marker</summary>
         </member>
@@ -9964,6 +9973,15 @@
             <param name="culture">The value culture</param>
             <returns>The lookup value matching tho the lookup key</returns>
         </member>
+        <member name="M:PayrollEngine.Client.Scripting.Runtime.IPayrollRuntime.ApplyRangeValue(System.String,System.Decimal,System.String)">
+            <summary>Apply a range value to the lookup ranges, and multiplying the lookup value with the range amount</summary>
+            <param name="lookupName">The lookup name</param>
+            <param name="rangeValue">The range value</param>
+            <param name="valueFieldName">Value field name</param>
+            <remarks>Only numeric JSON lookup values are supported.
+            The first lookup range value must be zero.</remarks>
+            <returns>Summary of all lookup ranges</returns>
+        </member>
         <member name="T:PayrollEngine.Client.Scripting.Runtime.IPayrunEmployeeAvailableRuntime">
             <summary>Runtime for the payrun employee available function <see cref="T:PayrollEngine.Client.Scripting.Function.PayrunEmployeeAvailableFunction"/></summary>
         </member>

Client.Scripting/Runtime/IPayrollRuntime.cs

@@ -152,6 +152,15 @@ public interface IPayrollRuntime : IRuntime
     /// <returns>The lookup value matching tho the lookup key</returns>
     string GetRangeLookup(string lookupName, decimal rangeValue, string lookupKey = null, string culture = null);
 
+    /// <summary>Apply a range value to the lookup ranges, and multiplying the lookup value with the range amount</summary>
+    /// <param name="lookupName">The lookup name</param>
+    /// <param name="rangeValue">The range value</param>
+    /// <param name="valueFieldName">Value field name</param>
+    /// <remarks>Only numeric JSON lookup values are supported.
+    /// The first lookup range value must be zero.</remarks>
+    /// <returns>Summary of all lookup ranges</returns>
+    decimal ApplyRangeValue(string lookupName, decimal rangeValue, string valueFieldName = null);
+
     #endregion
 
 }

Directory.Build.props

@@ -2,7 +2,7 @@
 
 	<PropertyGroup>
 		<TargetFramework>net9.0</TargetFramework>
-		<Version>0.9.0-beta.11</Version>
+		<Version>0.9.0-beta.12</Version>
 		<FileVersion>0.9.0</FileVersion>
 		<InformationalVersion></InformationalVersion>
 		<Authors>Jani Giannoudis</Authors>