@uipath/skills 1.199.0 → 1.200.0

package/skills/uipath-rpa/references/legacy/legacy-mode-guide.md

@@ -29,12 +29,12 @@ Legacy UiPath RPA projects: .NET Framework 4.6.1, VB.NET expressions, classic ac
 | Choose architecture | Sequence vs REFramework vs Dispatcher/Performer | [project-organization-guide.md](./project-organization-guide.md) |
 | Create workflow | Phase 0 → Discovery → Generate | [xaml-basics-and-rules.md](./xaml-basics-and-rules.md) |
 | Edit workflow | Phase 0 → Discovery → Edit | [xaml-basics-and-rules.md](./xaml-basics-and-rules.md) |
-| Validate file | `uip rpa-legacy validate "{projectRoot}/File.xaml" --output json` | [validation-and-fixing.md](./validation-and-fixing.md) |
-| Validate project | `uip rpa-legacy validate "{projectRoot}" --output json` | [validation-and-fixing.md](./validation-and-fixing.md) |
+| Validate file | `uip rpa-legacy validate "{projectRoot}/File.xaml" --output json` | [cli-reference.md § Validate & Fix](./cli-reference.md#phase-3-validate--fix-loop) |
+| Validate project | `uip rpa-legacy validate "{projectRoot}" --output json` | [cli-reference.md § Validate & Fix](./cli-reference.md#phase-3-validate--fix-loop) |
 | Package (optional) | `uip rpa-legacy pack "{projectRoot}" -o "{dir}"` | [cli-reference.md](./cli-reference.md) |
 | Debug | `uip rpa-legacy debug "{projectRoot}/File.xaml"` | [cli-reference.md](./cli-reference.md) |
-| Create new project | Create project.json with right packages | [project-structure.md](./project-structure.md) |
-| Create test data | Generate Excel/CSV/JSON/types for testing | [test-data-guide.md](./test-data-guide.md) |
+| Create new project | Create project.json with right packages | [cli-reference.md § Legacy Project Structure](./cli-reference.md#legacy-project-structure) |
+| Create test data | Generate Excel/CSV/JSON/types for testing | [testing-guide.md § Test Data Creation](./testing-guide.md#test-data-creation) |
 | Organize project | Folder structure, naming, libraries | [project-organization-guide.md](./project-organization-guide.md) |
 | Add error handling | TryCatch, Retry Scope, exception classification | [error-handling-guide.md](./error-handling-guide.md) |
 | Fix/build selectors | Selector anatomy, dynamic selectors, anchors | [selector-guide.md](./selector-guide.md) |
@@ -52,7 +52,7 @@ If unclear which file to edit, **ask the user**.
 4. Note project shape: count `.xaml` files, list `dependencies` keys and versions — use this to avoid re-discovering packages and activities already explored earlier in conversation
 5. Run `uip rpa-legacy validate "{projectRoot}" --output json` to trigger **package restore** (required before `find-activities` works)
 
-No Studio needed. See [environment-setup.md](./environment-setup.md) for details.
+No Studio needed. See [cli-reference.md § Phase 0](./cli-reference.md#phase-0-environment-readiness) for details.
 
 ---
 
@@ -71,7 +71,7 @@ No Studio needed. See [environment-setup.md](./environment-setup.md) for details
 
 4. **Only if Flowchart/StateMachine**: read [_XAML-GUIDE.md](./activity-docs/_XAML-GUIDE.md) for ViewState layout
 
-**Stop here.** Don't read more files unless you hit a problem during validation. Additional references if needed: [_PATTERNS.md](./activity-docs/_PATTERNS.md) (VB.NET expressions), [common-pitfalls.md](./common-pitfalls.md) (gotchas), [_INVOKE-CODE.md](./activity-docs/_INVOKE-CODE.md) (InvokeCode details), [_REFRAMEWORK.md](./activity-docs/_REFRAMEWORK.md) (REFramework), `uip docsai ask "..."` (official docs), `WebSearch` (community).
+**Stop here.** Don't read more files unless you hit a problem during validation. Additional references if needed: [_PATTERNS.md](./activity-docs/_PATTERNS.md) (VB.NET expressions), [xaml-basics-and-rules.md § Common Pitfalls](./xaml-basics-and-rules.md#common-pitfalls--quick-reference) (gotchas), [_INVOKE-CODE.md](./activity-docs/_INVOKE-CODE.md) (InvokeCode details), [_REFRAMEWORK.md](./activity-docs/_REFRAMEWORK.md) (REFramework), `uip docsai ask "..."` (official docs), `WebSearch` (community).
 
 5. **If the task involves design decisions**, read the relevant guide on demand:
    - Error handling strategy → [error-handling-guide.md](./error-handling-guide.md)
@@ -81,7 +81,7 @@ No Studio needed. See [environment-setup.md](./environment-setup.md) for details
    - Orchestrator integration (queues, assets, triggers) → [orchestrator-guide.md](./orchestrator-guide.md)
    - Test design / debugging → [testing-guide.md](./testing-guide.md)
 
-See [discovery-workflow.md](./discovery-workflow.md) for the full step-by-step procedure.
+See [cli-reference.md § Discovery Workflow](./cli-reference.md#discovery-workflow--detailed-steps) for the full step-by-step procedure.
 
 ---
 
@@ -93,7 +93,7 @@ See [discovery-workflow.md](./discovery-workflow.md) for the full step-by-step p
 - [ ] Run `find-activities` for every activity — use returned `XamlSnippet` + `XmlnsDeclaration` as starting point
 - [ ] Run `type-definition` for every enum/complex type (exact values)
 - [ ] Read [xaml-basics-and-rules.md](./xaml-basics-and-rules.md) for XAML structure
-- [ ] Read [common-pitfalls.md](./common-pitfalls.md) for gotchas
+- [ ] Read [xaml-basics-and-rules.md § Common Pitfalls](./xaml-basics-and-rules.md#common-pitfalls--quick-reference) for gotchas
 
 ### Choose Workflow Type
 
@@ -122,7 +122,7 @@ Before writing XAML for Flowchart or StateMachine:
 - [ ] All 21 baseline namespace imports present
 - [ ] Package-specific assembly refs + namespace imports added for every activity package used
 - [ ] Flowchart/StateMachine: `xmlns:av` declared, ViewState on every node
-- [ ] Scope activities: `ActivityAction<T>` body pattern (see [common-pitfalls.md](./common-pitfalls.md))
+- [ ] Scope activities: `ActivityAction<T>` body pattern (see [xaml-basics-and-rules.md § Common Pitfalls](./xaml-basics-and-rules.md#common-pitfalls--quick-reference))
 
 ### EDIT Checklist
 
@@ -156,7 +156,7 @@ FINAL (before completing):
 
 When stuck: `docsai ask` → `WebSearch` → ask user.
 
-See [validation-and-fixing.md](./validation-and-fixing.md) for detailed procedures and common error scenarios.
+See [cli-reference.md § Validate & Fix](./cli-reference.md#phase-3-validate--fix-loop) for detailed procedures and common error scenarios.
 
 ---
 
@@ -225,13 +225,13 @@ Full reference: [cli-reference.md](./cli-reference.md)
 | File | Content |
 |------|---------|
 | [cli-reference.md](./cli-reference.md) | All CLI commands, parameters, error recovery |
-| [discovery-workflow.md](./discovery-workflow.md) | Detailed discovery steps, troubleshooting |
-| [environment-setup.md](./environment-setup.md) | Project root detection, legacy verification |
-| [project-structure.md](./project-structure.md) | Legacy project layout, project.json schema |
+| [cli-reference.md § Discovery Workflow](./cli-reference.md#discovery-workflow--detailed-steps) | Detailed discovery steps, troubleshooting |
+| [cli-reference.md § Phase 0](./cli-reference.md#phase-0-environment-readiness) | Project root detection, legacy verification |
+| [cli-reference.md § Legacy Project Structure](./cli-reference.md#legacy-project-structure) | Legacy project layout, project.json schema |
 | [xaml-basics-and-rules.md](./xaml-basics-and-rules.md) | XAML anatomy, expressions, safety rules |
-| [common-pitfalls.md](./common-pitfalls.md) | Dangerous defaults, scope patterns, gotchas |
-| [validation-and-fixing.md](./validation-and-fixing.md) | Validate & fix loop, error scenarios |
-| [test-data-guide.md](./test-data-guide.md) | Excel, CSV, JSON, top 10 file types and UiPath types |
+| [xaml-basics-and-rules.md § Common Pitfalls](./xaml-basics-and-rules.md#common-pitfalls--quick-reference) | Dangerous defaults, scope patterns, gotchas |
+| [cli-reference.md § Validate & Fix](./cli-reference.md#phase-3-validate--fix-loop) | Validate & fix loop, error scenarios |
+| [testing-guide.md § Test Data Creation](./testing-guide.md#test-data-creation) | Excel, CSV, JSON, top 10 file types and UiPath types |
 | [error-handling-guide.md](./error-handling-guide.md) | Exception classification, TryCatch patterns, Retry Scope, ContinueOnError |
 | [selector-guide.md](./selector-guide.md) | Selector anatomy, dynamic selectors, anchors, validation checklist |
 | [project-organization-guide.md](./project-organization-guide.md) | Folder conventions, naming, Config.xlsx, libraries, single responsibility |

package/skills/uipath-rpa/references/legacy/project-organization-guide.md

@@ -2,7 +2,7 @@
 
 Best practices for structuring, naming, and organizing legacy UiPath RPA projects.
 
-For project.json schema and package dependencies, see [project-structure.md](./project-structure.md).
+For project.json schema and package dependencies, see [cli-reference.md § Legacy Project Structure](./cli-reference.md#legacy-project-structure).
 For REFramework file structure, see [activity-docs/_REFRAMEWORK.md](./activity-docs/_REFRAMEWORK.md).
 
 ---
@@ -274,7 +274,7 @@ In `project.json`, set `outputType` to `"Library"`:
 }
 ```
 
-See [project-structure.md](./project-structure.md) for the full Library project.json template.
+See [cli-reference.md § Legacy Project Structure](./cli-reference.md#legacy-project-structure) for the full Library project.json template.
 
 ### Key Differences from Process Projects
 

package/skills/uipath-rpa/references/legacy/selector-guide.md

@@ -2,7 +2,7 @@
 
 Selector anatomy, strategy, and best practices for building reliable UI automation in legacy UiPath workflows.
 
-For UI automation activities (Click, TypeInto, etc.), see [activity-docs/UIAutomation.md](./activity-docs/UIAutomation.md).
+UI automation activities (Click, TypeInto, etc.): [§ UIAutomation Activities Reference](#uiautomation-activities-reference) below.
 For input method gotchas (SimulateType, EmptyField), see [activity-docs/_COMMON-PITFALLS.md](./activity-docs/_COMMON-PITFALLS.md).
 
 ---
@@ -324,3 +324,165 @@ A UI Descriptor can include multiple targeting methods for resilience:
 - Application undergoes frequent UI changes
 - Multiple developers work on automations for the same application
 - Organization wants centralized selector management
+
+---
+
+## UIAutomation Activities Reference
+
+### Overview
+Legacy desktop UI automation for Windows. Click, type, find elements, manage windows/browsers. Package: `UiPath.UIAutomation.Activities`.
+
+---
+
+### Input Methods
+
+| Method | Constant | Speed | Reliability | Special Keys | Notes |
+|--------|----------|-------|-------------|--------------|-------|
+| Hardware Events (default) | SYNTHESIZE_INPUT | Slow | Most reliable | YES | Acquires input lock, blocks user input |
+| Window Messages | WINDOW_MESSAGES | Fast | Least reliable | YES | Best for classic Win32 apps |
+| UI Automation API | API | Medium | Very reliable | **NO** | SimulateClick/SimulateType; bypasses input |
+
+**CRITICAL: Cannot use SimulateClick AND SendWindowMessages simultaneously**
+**SimulateType + special keys produces design-time WARNING** (not hard error)
+
+---
+
+### Key Activities
+
+#### Mouse
+| Activity | Key Arguments | Defaults |
+|----------|---------------|----------|
+| `Click` | ClickType (Single/Double/Down/Up), MouseButton (Left/Right/Middle), KeyModifiers, CursorPosition, SimulateClick, SendWindowMessages | AlterIfDisabled=true |
+| `Hover` | CursorPosition, SimulateHover, SendWindowMessages | Hover duration ~1000ms |
+
+#### Keyboard
+| Activity | Key Arguments | Defaults |
+|----------|---------------|----------|
+| `TypeInto` | Text, SimulateType, SendWindowMessages, Activate, ClickBeforeTyping, EmptyField, DelayBetweenKeys | Activate=true, AlterIfDisabled=true |
+| `TypeSecureText` | SecureText (SecureString) | Special keys escaped in non-Simulate mode |
+| `SendHotkey` | Key, SpecialKey, KeyModifiers | Activate=true |
+
+#### Element Search
+| Activity | Key Arguments | Key Gotcha |
+|----------|---------------|------------|
+| `Element Exists` | Target | **Returns false instead of throwing on timeout** |
+| `Find Children` | Target, Filter, Scope | Returns lazy IEnumerable |
+| `Find Relative` | Target, CursorPosition (offset) | Returns first element at coordinates |
+| `Get Ancestor` | Target, UpLevels | Returns null at root |
+| `Wait Element Appear` | Target, WaitVisible, WaitActive | Adaptive polling: 50ms -> 200ms -> 1000ms |
+| `Wait Element Vanish` | Target, WaitNotVisible | Returns silently on timeout |
+
+#### Element Attributes
+| Activity | Key Arguments | Notes |
+|----------|---------------|-------|
+| `Get Text` / `Get Value` | Target | Wraps GetAttribute("text") |
+| `Get Attribute` | Target, Attribute | Returns null if attribute doesn't exist |
+| `Set Value` | Target, Text | Uses SetAttribute("text") |
+| `Select Item` | Target, Item | Exact match usually required |
+| `Select Multiple Items` | Target, MultipleItems, AddToSelection | |
+| `Check` | Target, Action (Check/Uncheck/Toggle) | Toggle reads current state first |
+| `Wait Attribute` | Attribute, AttributeValue | Supports wildcards (* and ?); polls every 100ms |
+| `Get Position` | Target | Returns Rectangle (screen coordinates) |
+
+#### Actions
+| Activity | Purpose |
+|----------|---------|
+| `Activate` | Bring window to foreground |
+| `Set Focus` | Set keyboard focus (doesn't foreground) |
+| `Highlight` | Debug visualization (blocking for duration) |
+| `Take Screenshot` | Capture element as Image |
+
+#### Scopes
+| Activity | Key Arguments |
+|----------|---------------|
+| `Open Browser` | Url, BrowserType (IE/Chrome/Firefox/Edge), Private, NewSession, Hidden, CommunicationMethod |
+| `Open Application` | Selector, FileName, Arguments, WorkingDirectory |
+| `Window Scope` | Selector OR Window (mutually exclusive) |
+| `Browser Scope` | Selector OR Browser (mutually exclusive) |
+
+---
+
+### Special Key Syntax (TypeInto)
+```
+[k(end)]        - End key
+[k(home)]       - Home key
+[k(del)]        - Delete key
+[k(backspace)]  - Backspace
+[k(enter)]      - Enter
+[k(tab)]        - Tab
+[k(escape)]     - Escape
+[k(ctrl+a)]     - Ctrl+A (press+release)
+[d(ctrl)]       - Ctrl down
+[u(ctrl)]       - Ctrl up
+[k(F1)]         - Function key F1-F12
+```
+
+**Authoring rule:** when any of these tokens appears in `Text`, write the value with child element syntax — not attribute form. The attribute form `Text="["13700132[k(enter)]"]"` runs correctly but the value will not render in Studio because the literal `[` / `]` inside the string collide with the outer VB expression markers. Use:
+
+```xml
+<uix:NTypeInto ...>
+  <uix:NTypeInto.Text>
+    <InArgument x:TypeArguments="x:String">["13700132[k(enter)]"]</InArgument>
+  </uix:NTypeInto.Text>
+</uix:NTypeInto>
+```
+
+See [../xaml/common-pitfalls.md § NTypeInto `Text` with literal `[k(...)]` special-key tokens](../xaml/common-pitfalls.md#ntypeinto-text-with-literal-k-special-key-tokens) for alternatives (`Chr(91)`/`Chr(93)` construction, split-activity).
+
+---
+
+### Critical Gotchas
+
+#### AlterIfDisabled Default
+1. **AlterIfDisabled=true by default** on Click, TypeInto, SetValue, SelectItem, Check - can interact with disabled/grayed controls unexpectedly
+
+#### TypeInto Specifics
+2. **SimulateType CANNOT handle special keys** - fails validation if `[k(...)]` syntax detected
+3. **EmptyField uses hardcoded sequence**: `[k(end)d(shift)k(home)u(shift)k(del)]` - may fail for multi-line. **CRITICAL: EmptyField is silently ignored when SimulateType=true** - only works with hardware events and SendWindowMessages
+4. **DelayBetweenKeys max 1000ms** - validation error if exceeded
+5. **Activate=true by default** - may cause unwanted window switches
+
+#### Selector Issues
+6. **Selector matching is fragile** - UI changes invalidate selectors
+7. **Placeholders** `{varName}` resolved at runtime - null variables cause failures
+8. **Closest matches** can return wrong element if multiple similar elements exist
+9. **Closest matches disabled in Exists** activity (returns false cleanly)
+
+#### Click Specifics
+10. **SimulateClick cannot CLICK_DOUBLE with BTN_RIGHT or BTN_MIDDLE**
+11. **SimulateClick doesn't acquire input lock** - others do
+12. **CursorMotionType** affects how cursor moves (straight line, smooth, etc.)
+
+#### Timing
+13. **Default timeout ~30,000ms** (30 seconds) across most activities
+14. **DelayBefore/DelayAfter are sequential** (Thread.Sleep internally)
+15. **WaitUiElementAppear adaptive polling**: 50ms -> 200ms -> 1000ms
+16. **Exists returns false instead of throwing** on timeout
+
+#### Browser Scope
+17. **NewSession=true (default)** creates new browser process (slower but isolated)
+18. **NewSession=false** reuses existing browser (faster, shared state/cookies)
+19. **Private mode** may disable extensions/drivers
+20. **CommunicationMethod**: Native (UiPath driver) vs WebDriver (Selenium-based)
+
+#### Window/Browser Scope Validation
+21. **Must set either Selector OR Window/Browser** - not both, not neither
+22. **If Window/Browser set, SearchScope cannot be set**
+
+#### Image-Based Activities
+23. **Template matching** (not AI) - sensitive to resolution, brightness, minor UI changes
+24. **Slower than selector-based** - use only for unstable selectors
+
+#### Error Handling
+25. **ContinueOnError=false by default** - exceptions thrown
+26. **Governance exceptions never suppressed** even with ContinueOnError=true
+
+#### Additional Validated Gotchas
+27. **OpenBrowser defaults to IE** - BrowserType default is `BrowserType.IE`
+28. **Hover has fixed 1000ms duration** - hardcoded, not configurable
+29. **Default timeouts**: Timeout=30,000ms, DelayAfter=300ms, DelayBefore=200ms, OpenBrowser=60s
+30. **AlterIfDisabled NOT passed to node in hardware events mode for TypeInto** (but IS passed for Click) - inconsistent behavior
+31. **CursorMotionType.Smooth only works with hardware events** - has no effect with SimulateClick or SendWindowMessages
+32. **Data Scraping hardcodes ContinueOnError=true** - extraction failures produce empty DataTable, no error
+33. **SimulateClick MV3 workaround** - hidden project setting `EnableWorkaroundForSimulateClickMV3` (default false) needed for Chrome Manifest V3 extensions
+34. **Image OCR uses hardcoded 5-pixel offset** - can cause incorrect crops on small images

package/skills/uipath-rpa/references/legacy/testing-guide.md

@@ -2,8 +2,8 @@
 
 Test design strategy, mock testing patterns, and debugging guidance for legacy UiPath workflows.
 
-For test assertion activity properties/XAML, see [activity-docs/Testing.md](./activity-docs/Testing.md).
-For test data file generation, see [test-data-guide.md](./test-data-guide.md).
+Test assertion activity properties/XAML: [§ Testing Activities Reference](#testing-activities-reference) below.
+Test data file generation: [§ Test Data Creation](#test-data-creation) below.
 For CLI debug command, see [cli-reference.md](./cli-reference.md).
 
 ---
@@ -78,7 +78,7 @@ Use these activities from `UiPath.Testing.Activities` to assert expected outcome
 2. **Use descriptive assertion messages** — `"Invoice amount should be positive"` not `"Test failed"`
 3. **Verify the OUTCOME, not the process** — check that the result is correct, not that specific activities were called
 
-See [activity-docs/Testing.md](./activity-docs/Testing.md) for activity properties, XAML syntax, and gotchas.
+See [§ Testing Activities Reference](#testing-activities-reference) for activity properties, XAML syntax, and gotchas.
 
 ---
 
@@ -307,3 +307,246 @@ Tests can be organized into **Test Sets** in Orchestrator Test Manager:
 2. **Full regression can take longer** — but should complete within a release window
 3. **Test in an environment matching production** — same Orchestrator folder structure, same asset configuration
 4. **Version test data alongside workflows** — test Excel files and expected results in the same project
+
+---
+
+## Test Data Creation
+
+How to create test data files and UiPath types for legacy workflow testing.
+
+---
+
+### Excel Test Data (COM-Compliant)
+
+#### Using ExcelApplicationScope (Interop — .xls/.xlsx)
+
+Create a DataTable in code, then write it via Excel Interop:
+
+```xml
+<!-- Step 1: Build DataTable with InvokeCode -->
+<ui:InvokeCode Code="
+Dim dt As New DataTable()
+dt.Columns.Add(&quot;Name&quot;, GetType(String))
+dt.Columns.Add(&quot;Amount&quot;, GetType(Double))
+dt.Columns.Add(&quot;Date&quot;, GetType(String))
+dt.Columns.Add(&quot;Status&quot;, GetType(String))
+dt.Rows.Add(&quot;Invoice-001&quot;, 1500.50, &quot;2024-01-15&quot;, &quot;Active&quot;)
+dt.Rows.Add(&quot;Invoice-002&quot;, 2300.00, &quot;2024-02-20&quot;, &quot;Pending&quot;)
+dt.Rows.Add(&quot;Invoice-003&quot;, 890.25, &quot;2024-03-10&quot;, &quot;Closed&quot;)
+dt.Rows.Add(&quot;Invoice-004&quot;, 0, &quot;&quot;, &quot;Active&quot;)
+dt.Rows.Add(&quot;Invoice-005&quot;, -100.00, &quot;2024-12-31&quot;, &quot;Error&quot;)
+testData = dt" Language="VBNet">
+  <ui:InvokeCode.Arguments>
+    <scg:Dictionary x:TypeArguments="x:String, Argument">
+      <OutArgument x:TypeArguments="sd:DataTable" x:Key="testData">[dtTestData]</OutArgument>
+    </scg:Dictionary>
+  </ui:InvokeCode.Arguments>
+</ui:InvokeCode>
+
+<!-- Step 2: Write to Excel via ExcelApplicationScope -->
+<!-- Use ExcelApplicationScope + ExcelWriteRange (Interop) for .xls/.xlsx -->
+```
+
+#### Test data design principles
+- Include edge cases: empty strings, zero values, negative numbers, special characters
+- Include null/DBNull values to test null handling
+- Mix data types per column to test type coercion
+- Include dates in multiple formats to test parsing
+- Include at least 5-10 rows for meaningful iteration testing
+
+#### Using WriteCsvFile (Portable — no Excel needed)
+
+```xml
+<!-- Write CSV then optionally convert to Excel -->
+<ui:WriteCsvFile FilePath="[Path.Combine(Environment.CurrentDirectory, &quot;Data&quot;, &quot;test.csv&quot;)]"
+  DataTable="[dtTestData]" />
+```
+
+---
+
+### Top 10 File Types
+
+| File Type | How to Create | Key Activity | Notes |
+|-----------|--------------|-------------|-------|
+| **Excel (.xls/.xlsx)** | `ExcelApplicationScope` + `ExcelWriteRange` | COM Interop | Use `.xls` for max legacy compat; `.xlsx` for modern |
+| **CSV (.csv)** | `WriteCsvFile` or `Write Text File` | Portable | Set `Delimitator` explicitly; specify `"UTF-8"` encoding |
+| **Text (.txt)** | `Write Text File` activity | System.IO | Use `Encoding="UTF-8"` for portability |
+| **JSON (.json)** | `Serialize JSON` + `Write Text File` | WebAPI package | Build JObject/JArray in InvokeCode, serialize, write |
+| **XML (.xml)** | Build XDocument in InvokeCode + `Write Text File` | System.Xml.Linq | Or use `Serialize XML` if available |
+| **PDF (.pdf)** | Export from Excel/Word scope, or HTML string + wkhtmltopdf | Requires source app | No native PDF creation activity in legacy |
+| **Word (.docx)** | `WordApplicationScope` + `Word Write Text` | COM Interop | Requires Word installed |
+| **HTML (.html)** | `Write Text File` with HTML string content | String building | Build HTML in InvokeCode or Assign |
+| **Email (.eml/.msg)** | `Save Mail Message` from mail activities | Mail package | Create MailMessage object first |
+| **Config (.xlsx)** | REFramework pattern: Config.xlsx with Settings/Constants/Assets sheets | Excel Interop | See `_REFRAMEWORK.md` for sheet structure |
+
+#### Creating JSON test data
+
+```vb
+' InvokeCode — build JSON string
+Dim json As String = "{" & vbCrLf &
+  "  ""name"": ""Test User""," & vbCrLf &
+  "  ""amount"": 1500.50," & vbCrLf &
+  "  ""items"": [""A"", ""B"", ""C""]" & vbCrLf &
+  "}"
+output = json
+```
+
+#### Creating XML test data
+
+```vb
+' InvokeCode — build XML string
+Dim xml As String = "<?xml version=""1.0"" encoding=""UTF-8""?>" & vbCrLf &
+  "<Invoices>" & vbCrLf &
+  "  <Invoice Id=""001"" Amount=""1500.50"" />" & vbCrLf &
+  "  <Invoice Id=""002"" Amount=""2300.00"" />" & vbCrLf &
+  "</Invoices>"
+output = xml
+```
+
+---
+
+### Top 10 UiPath Types
+
+| Type | How to Create | Common Test Values | VB.NET Expression |
+|------|--------------|-------------------|-------------------|
+| **DataTable** | `Build Data Table` activity or InvokeCode | Headers + 5-10 rows, mixed types, nulls | `New DataTable()` |
+| **String** | `Assign` / literal | `"test"`, `""`, `Nothing`, special chars `<>&"` | `"value"` |
+| **Int32** | `Assign` / `CInt()` | `0`, `-1`, `Integer.MaxValue`, `Integer.MinValue` | `CInt("42")` |
+| **Boolean** | `Assign` | `True`, `False` | `True` |
+| **DateTime** | `Assign` / `DateTime.Parse()` | Today, epoch, future, `DateTime.MinValue` | `DateTime.Now` |
+| **Dictionary(Of String, Object)** | InvokeCode or `Assign` | Config-style key-value pairs, nested objects | `New Dictionary(Of String, Object)` |
+| **String()** (array) | `Assign` / `Split()` | Empty `{}`, single item, many items | `New String() {"a","b","c"}` |
+| **SecureString** | `Get Credential` or InvokeCode | Test password strings | `New NetworkCredential("","pass").SecurePassword` |
+| **MailMessage** | `Get Outlook Mail Messages` or InvokeCode | Email with To/Subject/Body/Attachments | `New System.Net.Mail.MailMessage()` |
+| **QueueItem** | `Get Transaction Item` from Orchestrator | SpecificContent dictionary, Priority, Deadline | Requires Orchestrator queue |
+
+#### Creating a test Dictionary (Config-style)
+
+```vb
+' InvokeCode
+Dim config As New Dictionary(Of String, Object)
+config("MaxRetryNumber") = 3
+config("logF_BusinessProcessName") = "TestProcess"
+config("OrchestratorQueueName") = "TestQueue"
+config("ExcelFilePath") = "Data\Input\test.xlsx"
+output = config
+```
+
+#### Creating a test DataTable with edge cases
+
+```vb
+' InvokeCode
+Dim dt As New DataTable()
+dt.Columns.Add("Name", GetType(String))
+dt.Columns.Add("Amount", GetType(Double))
+dt.Columns.Add("IsActive", GetType(Boolean))
+
+' Normal rows
+dt.Rows.Add("Alice", 100.50, True)
+dt.Rows.Add("Bob", 0, False)
+
+' Edge cases
+dt.Rows.Add("", -999.99, True)           ' Empty name
+dt.Rows.Add(DBNull.Value, DBNull.Value, DBNull.Value)  ' All nulls
+dt.Rows.Add("Special <>&""chars", 1E+15, True)  ' Special chars, large number
+
+testData = dt
+```
+
+---
+
+## Testing Activities Reference
+
+### Overview
+Test assertions, data generation, document comparison, and test data queue management. Package: `UiPath.Testing.Activities`.
+
+---
+
+### Assertion Activities
+
+| Activity | Purpose | Key Arguments |
+|----------|---------|---------------|
+| `VerifyExpression` | Assert boolean is true | Expression (bool), ContinueOnFailure (default true) |
+| `VerifyExpressionWithOperator` | Compare two values | FirstExpression, SecondExpression, Operator |
+| `VerifyRange` | Value within/outside range | Expression, LowerLimit, UpperLimit, VerificationType (IsWithin/IsNotWithin) |
+| `VerifyControlAttribute` | Verify activity output | ActivityToTest, OutputArgument, Expression, Operator |
+
+#### Comparison Operators
+Equality (=), Inequality (<>), GreaterThan (>), GreaterThanOrEqual (>=), LessThan (<), LessThanOrEqual (<=), Contains, RegexMatch
+
+---
+
+### Document Comparison (NET5+)
+
+| Activity | Purpose | Key Arguments |
+|----------|---------|---------------|
+| `ComparePdfDocuments` | Diff two PDFs | BaselinePath, TargetPath, ComparisonType (Line/Word/Character), Rules, IncludeImages |
+| `CompareText` | Diff two strings | BaselineText, TargetText, ComparisonType, OutputFilePath (HTML) |
+| `CreateComparisonRule` | Custom ignore rules | RuleName, ComparisonRuleType (Regex/Wildcard), Pattern, UsePlaceholder |
+
+#### Comparison Output
+- `Result` (bool): True if equivalent
+- `Differences` (IEnumerable\<Difference\>): Each with Operation (Inserted/Deleted/Equal) and Text
+- `SemanticDifferences`: AI analysis when InterpretDifferencesWithAutopilot=true
+
+---
+
+### Test Data Queue Activities
+
+| Activity | Purpose | Key Arguments |
+|----------|---------|---------------|
+| `GetTestDataQueueItem` | Get next item | QueueName, MarkConsumed (default true) |
+| `GetTestDataQueueItems` | Batch fetch with filter | QueueName, Status (All/OnlyConsumed/OnlyNotConsumed), Top, Skip |
+| `NewAddTestDataQueueItem` | Add single item | QueueName, ItemInformation (Dict\<string, InArgument\>) |
+| `BulkAddTestDataQueue` | Add from DataTable | QueueName, QueueItemsDataTable |
+| `DeleteTestDataQueueItems` | Delete items | TestDataQueueItems (must have valid Ids) |
+| ~~`AddTestDataQueueItem`~~ | **OBSOLETE** | Use NewAddTestDataQueueItem instead |
+
+---
+
+### Test Data Generation
+
+| Activity | Output | Key Arguments |
+|----------|--------|---------------|
+| `RandomString` | string | Case (Lower/Upper/Camel/Mixed), Length (default 10) |
+| `RandomNumber` | decimal | Min, Max, Decimals (default 0) |
+| `RandomDate` | DateTime | MinDate, MaxDate |
+| `RandomValue` | string | FilePath (one value per line, random selection) |
+| `GivenName` | string | (from predefined list) |
+| `LastName` | string | (from predefined list) |
+| `Address` | Dict\<string, string\> | Country, City (both hidden in designer) |
+
+---
+
+### Critical Gotchas
+
+#### Assertions
+1. **ContinueOnFailure=true by default in designer activities** - assertions don't stop workflow; set to false for strict testing. **Note**: Coded workflow API defaults to `false` (opts?.ContinueOnError ?? false)
+2. **Screenshot capture** available on both success and failure (separate flags, both default false)
+3. **VerifyControlAttribute cannot be nested** inside another VerifyControlAttribute
+4. **Type compatibility validated at CacheMetadata** - incompatible types cause design-time errors
+5. **RegexMatch operator** uses full .NET regex engine
+
+#### Document Comparison
+6. **ComparePdfDocuments creates visual diff PDFs** - `{filename}_result.pdf` for both baseline and target
+7. **CompareText creates HTML diff report** at OutputFilePath (default "differences.html")
+8. **Rules (regex/wildcard)** allow ignoring dynamic content (dates, IDs)
+9. **Semantic analysis (Autopilot)** provides AI explanation separate from byte-level diff
+
+#### Test Data Queues
+10. **Requires Orchestrator** - all queue operations go through IOrchestratorService
+11. **MarkConsumed=true** prevents item from being returned again
+12. **Batch fetch max 1000** items per internal API call
+13. **Top=0 treated as null** (no limit)
+14. **Delete requires valid Ids** - items must be previously retrieved
+15. **BulkAdd DataTable columns must be unique** - throws InvalidArgumentsException
+16. **Queue items stored as JSON** in Orchestrator
+
+#### Test Data Generation
+17. **RandomValue reads from file** - file must exist with line-delimited values
+18. **Address Country/City inputs hidden in designer** but available programmatically
+19. **RandomDate validates MinDate < MaxDate** (skipped for expression arguments)
+
+#### Misc
+20. **AttachDocument** uploads file to Orchestrator as test evidence
+21. **CoverageMergeActivity is internal** (Browsable=false) - for test framework infrastructure only