1. Installation

1. Download and install the LINQ Library component from Forge.

2. In Service Studio, open your application.

3. Go to Manage Dependencies → add the LINQ Library public actions you need.

4. Publish your application.

2. Configuration

No special configuration is required. Once the extension is installed and referenced, you can start using the provided actions in your logic flows.

3. Available Actions

The library exposes the following LINQ operations (for Record Lists or Entity Queries):

• Union(ListA, ListB) → Returns all unique elements from both lists.

• Intersect(ListA, ListB) → Returns elements that exist in both lists.

• Except(ListA, ListB) → Returns elements that exist in the first list but not in the second.

• Concat(ListA, ListB) → Appends elements of ListB to ListA (keeps duplicates).

• Distinct(ListA) → Removes duplicates from the list.

4. Usage Instructions

1. Prepare two Record Lists (or a single one for Distinct).

2. Drag the desired LINQ action (e.g., Union) into your logic flow.

3. Pass your lists as parameters.

4. Use the Output List as the result in your app logic.

Example – Union

UnionResult = LINQ.Union(EmployeeList, ManagerList)

Result → A Record List containing all unique employees and managers.

Example – Distinct

CleanList = LINQ.Distinct(AllDepartments)

Result → A Record List with duplicates removed.

5. Notes & Best Practices

• All functions are based on the .NET Framework LINQ engine for performance.

• Works in Reactive Web, Traditional Web, and Mobile apps.

• Always ensure your input lists are of the same type/structure when using Union, Intersect, Except, or Concat.

• If you only need to filter or map simple lists, prefer native OutSystems functions; use this library for more advanced set operations.

6. Demo Application

The asset includes a demo module that shows examples of each operation (Union, Intersect, Except, Concat, Distinct) in action. Install it together with the library to explore real use cases and copy patterns into your own apps.