Shared code tutorial

Author: alistairwheeler

docs/make/project/module.md

@@ -42,7 +42,7 @@ To create a Module, follow the steps below :
 | Compare with remote repository | Compare local configuration with a remote repository |
 | ALTER DB history | Retain relevant configuration items' old values during export |
 
-### Module filtering & default module
+### Module filtering & default module {#module-filtering}
 
 The **Visible Modules* button in the platform's header: ![](img/module/header-button.png)
 - Filters the platform's configuration objects by module (eye icon next to the module name).

docs/make/settings/shared-code.md

@@ -54,4 +54,4 @@ Shared Code can be used in various scenarios, including Java class creation, bus
 
 - [PlatformHooks](/docs/core/platform-hooks)  
 - [Unit testing](/docs/core/unit-testing)    
-
+- [Unit test shared code tutorial](/tutorial/enhancing/shared-code)

docs/tutorial/enhancing/TrnProductTest.java

@@ -0,0 +1,64 @@
+package com.simplicite.tests.Training;
+
+import static org.junit.Assert.assertEquals;
+import static org.junit.Assert.fail;
+
+import org.json.JSONObject;
+import org.junit.Test;
+
+import com.simplicite.bpm.*;
+import com.simplicite.util.*;
+import com.simplicite.util.exceptions.*;
+import com.simplicite.util.tools.*;
+
+/**
+ * Unit tests for the TrnProduct business object
+ * Tests the product stock management functionality
+ */
+public class TrnProductTest {
+
+    /**
+     * Helper method to get system admin grant for testing
+     * @return Grant with system admin privileges
+     */
+	public Grant getGrant() {
+        // Using the system admin grant for testing
+        return Grant.getSystemAdmin();
+    }
+    
+    /**
+     * Test the increaseStock action
+     * Verifies that calling increaseStock increases the product stock by 10 units
+     */
+    @Test
+    public void testIncreaseStock() {
+        try {
+            // Create a test product with initial stock of 5
+            ObjectDB product = getGrant().getTmpObject("TrnProduct");
+            // Set test product data using JSON
+            product.setValuesFromJSONObject(new JSONObject()
+                .put("trnPrdCode", "TEST001")
+                .put("trnPrdName", "Test Product")
+                .put("trnPrdStock", 5), true, false, false);
+            // Save the test product to database
+            product.save();
+            
+            // Get reference to stock field and store initial value
+            ObjectField stockField = product.getField("trnPrdStock");
+            int initialStock = stockField.getInt(0);
+            
+            // Execute the increaseStock action on the product
+            product.invokeAction("IncreaseStock", null);
+            
+            // Assert that stock increased by exactly 10 units
+            assertEquals("Stock should be increased by 10", initialStock + 10, stockField.getInt(0));
+            
+            // Cleanup by removing test product from database
+            product.delete();
+        }
+        catch (Exception e) {
+            // Fail test and show error if any exception occurs
+            fail("Test failed: " + e.getMessage());
+        }
+    }
+}

docs/tutorial/enhancing/_external-shared-code.md

@@ -1,7 +1,6 @@
 ---
-sidebar_class_name: hidden
 sidebar_position: 15
-title: Mapping
+title: 3.4. Mapping
 ---
 
 Mapping