Merge pull request #118 from PHOENIXCONTACT/port/feature-iprocessextensions-get-order-and-operation-number

Port IProcessExtensions get order and operation number

Author: 1nf0rmagician

src/Moryx.ControlSystem/Processes/IProcessExtensions.cs

@@ -1,8 +1,7 @@
-using Moryx.AbstractionLayer.Products;
+using System;
 using Moryx.AbstractionLayer;
-using System;
-using System.Collections.Generic;
-using System.Text;
+using Moryx.AbstractionLayer.Products;
+using Moryx.ControlSystem.Recipes;
 
 namespace Moryx.ControlSystem.Processes
 {
@@ -66,5 +65,37 @@ public static bool TryModifyProductInstance<TInstance>(this IProcess process, Ac
             setter.Invoke(instance);
             return true;
         }
+
+        /// <summary>
+        /// Returns <see cref="IOrderBasedRecipe.OrderNumber"/> on the <see cref="IProcess"/> using the given <paramref name="process"/>. 
+        /// </summary>
+        /// <param name="process">The process holding the order number</param>
+        /// <example>
+        /// <code>
+        /// <![CDATA[
+        /// process.GetOrderNumber()
+        /// ]]>
+        /// </code>
+        /// </example>
+        public static string GetOrderNumber(this IProcess process)
+        {
+            return (process.Recipe as IOrderBasedRecipe)?.OrderNumber;
+        }
+
+        /// <summary>
+        /// Returns <see cref="IOrderBasedRecipe.OperationNumber"/> on the <see cref="IProcess"/> using the given <paramref name="process"/>. 
+        /// </summary>
+        /// <param name="process">The process holding the operation number</param>
+        /// <example>
+        /// <code>
+        /// <![CDATA[
+        /// process.GetOperationNumber()
+        /// ]]>
+        /// </code>
+        /// </example>
+        public static string GetOperationNumber(this IProcess process)
+        {
+            return (process.Recipe as IOrderBasedRecipe)?.OperationNumber;
+        }
     }
 }

src/Tests/Moryx.ControlSystem.Tests/Mocks/DummyRecipe.cs

@@ -0,0 +1,17 @@
+// Copyright (c) 2023, Phoenix Contact GmbH & Co. KG
+
+using Moryx.AbstractionLayer.Recipes;
+using Moryx.ControlSystem.Recipes;
+
+namespace Moryx.ControlSystem.Tests.Mocks
+{
+    public class DummyRecipe : ProductionRecipe, IOrderBasedRecipe
+    {
+        public string OrderNumber { get; set; }
+        public string OperationNumber { get; set; }
+
+        public DummyRecipe()
+        {
+        }
+    }
+}

src/Tests/Moryx.ControlSystem.Tests/ProcessExtensionsTest.cs

@@ -0,0 +1,41 @@
+// Copyright (c) 2023, Phoenix Contact GmbH & Co. KG
+
+using Moryx.AbstractionLayer;
+using Moryx.ControlSystem.Processes;
+using Moryx.ControlSystem.Tests.Mocks;
+using NUnit.Framework;
+
+namespace Moryx.ControlSystem.Tests
+{
+    [TestFixture]
+    internal class ProcessExtensionsTest
+    {
+        [Test]
+        public void ShouldReturnOrderNumber()
+        {
+            // Arrange
+            var recipe = new DummyRecipe { OrderNumber = "O10", OperationNumber = "Op082" };
+            var process = new Process { Recipe = recipe };
+
+            // Act
+            var orderNumber = process?.GetOrderNumber();
+
+            // Assert
+            Assert.That(orderNumber, Is.EqualTo(recipe.OrderNumber));
+        }
+        
+        [Test]
+        public void ShouldReturnOperationNumber()
+        {
+            // Arrange
+            var recipe = new DummyRecipe { OrderNumber = "O10", OperationNumber = "Op082" };
+            var process = new Process { Recipe = recipe };
+
+            // Act
+            var operationNumber = process?.GetOperationNumber();
+
+            // Assert
+            Assert.That(operationNumber, Is.EqualTo(recipe.OperationNumber));
+        }
+    }
+}