@uipath/skills 1.195.0

package/skills/uipath-rpa/references/activity-docs/UiPath.Testing.Activities/25.10/coded/testing-data.md

@@ -0,0 +1,335 @@
+# Testing — Data Generation & Test Data Queues
+
+Random data generation and Orchestrator test data queue operations on the `testing` service (`ITestingService`). For general info see [testing.md](testing.md).
+
+---
+
+## Random Data Generation
+
+### GivenName
+
+Returns a random first name.
+
+```csharp
+string GivenName();
+```
+
+```csharp
+string firstName = testing.GivenName(); // e.g. "John"
+```
+
+### LastName
+
+Returns a random last name.
+
+```csharp
+string LastName();
+```
+
+```csharp
+string lastName = testing.LastName(); // e.g. "Smith"
+```
+
+### RandomNumber
+
+Returns a random decimal number.
+
+```csharp
+// No parameters — uses long.MinValue to long.MaxValue, 0 decimals
+decimal RandomNumber();
+
+// With range
+decimal RandomNumber(long min, long max);
+
+// With range and decimal places
+decimal RandomNumber(long min, long max, int decimals);
+```
+
+| Parameter | Type | Default | Description |
+|---|---|---|---|
+| `min` | `long` | `long.MinValue` | Minimum value (inclusive) |
+| `max` | `long` | `long.MaxValue` | Maximum value (inclusive) |
+| `decimals` | `int` | `0` | Number of decimal places |
+
+```csharp
+decimal amount = testing.RandomNumber(100, 5000, 2); // e.g. 2547.83
+decimal wholeNumber = testing.RandomNumber(1, 100);   // e.g. 42
+```
+
+### RandomDate
+
+Returns a random date within a range.
+
+```csharp
+DateTime RandomDate(DateTime minDate, DateTime maxDate);
+```
+
+| Parameter | Type | Description |
+|---|---|---|
+| `minDate` | `DateTime` | Inclusive lower bound |
+| `maxDate` | `DateTime` | Exclusive upper bound |
+
+```csharp
+DateTime date = testing.RandomDate(new DateTime(2024, 1, 1), new DateTime(2025, 1, 1));
+```
+
+### RandomString
+
+Returns a random string with a specified case and length.
+
+```csharp
+string RandomString(Case caseValue, int length);
+```
+
+| Parameter | Type | Description |
+|---|---|---|
+| `caseValue` | `Case` | Case style of the generated string |
+| `length` | `int` | Length of the string |
+
+**`Case` enum:**
+
+| Value | Example |
+|---|---|
+| `Case.LowerCase` | `"abcdef"` |
+| `Case.UpperCase` | `"ABCDEF"` |
+| `Case.CamelCase` | `"Abcdef"` |
+| `Case.Mixed` | `"aBcDeF"` |
+
+```csharp
+string code = testing.RandomString(Case.UpperCase, 8); // e.g. "XKQPLMRT"
+```
+
+### RandomValue
+
+Picks a random line from a `.txt` or `.csv` file (1-column list).
+
+```csharp
+string RandomValue(string filePath);
+```
+
+| Parameter | Type | Description |
+|---|---|---|
+| `filePath` | `string` | Path to the source file |
+
+```csharp
+string city = testing.RandomValue(@"C:\TestData\cities.txt");
+```
+
+### Address
+
+Returns a random address as a dictionary.
+
+```csharp
+Dictionary<string, string> Address(string country, string city);
+```
+
+| Parameter | Type | Description |
+|---|---|---|
+| `country` | `string` | Country for the address |
+| `city` | `string` | City for the address |
+
+```csharp
+Dictionary<string, string> addr = testing.Address("US", "New York");
+// Keys may include street, zip, state, etc.
+```
+
+---
+
+## Attach Document
+
+Attaches a document to the current test case in Orchestrator.
+
+```csharp
+// Without tags
+void AttachDocument(string filePath);
+
+// With tags
+void AttachDocument(string filePath, IEnumerable<string> tags);
+```
+
+| Parameter | Type | Description |
+|---|---|---|
+| `filePath` | `string` | File path of the document to attach |
+| `tags` | `IEnumerable<string>` | Tags to add to the test case |
+
+```csharp
+testing.AttachDocument(@"C:\Output\report.pdf");
+testing.AttachDocument(@"C:\Output\screenshot.png", new[] { "evidence", "login-test" });
+```
+
+---
+
+## Test Data Queue Operations
+
+Operations for managing test data queues in Orchestrator.
+
+### AddTestDataQueueItem
+
+Adds a single item to a test data queue.
+
+```csharp
+// Minimal
+void AddTestDataQueueItem(string queueName, Dictionary<string, object> itemInformation);
+
+// With folder path
+void AddTestDataQueueItem(string queueName, Dictionary<string, object> itemInformation, string folderPath);
+
+// With folder path and timeout
+void AddTestDataQueueItem(string queueName, Dictionary<string, object> itemInformation, string folderPath, int timeoutMs);
+```
+
+| Parameter | Type | Description |
+|---|---|---|
+| `queueName` | `string` | Queue name where to add data |
+| `itemInformation` | `Dictionary<string, object>` | The item data as key-value pairs |
+| `folderPath` | `string` | Orchestrator folder path |
+| `timeoutMs` | `int` | Timeout in milliseconds |
+
+```csharp
+testing.AddTestDataQueueItem("InvoiceTestData", new Dictionary<string, object>
+{
+    { "InvoiceNumber", "INV-001" },
+    { "Amount", 1500.00 },
+    { "Customer", "Acme Corp" }
+});
+```
+
+### BulkAddTestDataQueueItems
+
+Adds multiple items to a test data queue from a DataTable.
+
+```csharp
+// Minimal
+void BulkAddTestDataQueueItems(string queueName, DataTable queueItemsDataTable);
+
+// With folder path
+void BulkAddTestDataQueueItems(string queueName, DataTable queueItemsDataTable, string folderPath);
+
+// With folder path and timeout
+void BulkAddTestDataQueueItems(string queueName, DataTable queueItemsDataTable, string folderPath, int timeoutMs);
+```
+
+| Parameter | Type | Description |
+|---|---|---|
+| `queueName` | `string` | Queue name where items will be added |
+| `queueItemsDataTable` | `DataTable` | DataTable with entries to add |
+| `folderPath` | `string` | Orchestrator folder path |
+| `timeoutMs` | `int` | Timeout in milliseconds |
+
+```csharp
+DataTable testData = new DataTable();
+testData.Columns.Add("Name", typeof(string));
+testData.Columns.Add("Amount", typeof(double));
+testData.Rows.Add("Invoice-1", 100.0);
+testData.Rows.Add("Invoice-2", 200.0);
+
+testing.BulkAddTestDataQueueItems("InvoiceTestData", testData);
+```
+
+### GetTestDataQueueItem
+
+Gets the next test data item from a queue.
+
+```csharp
+// Minimal
+Dictionary<string, object> GetTestDataQueueItem(string queueName);
+
+// With folder path
+Dictionary<string, object> GetTestDataQueueItem(string queueName, string folderPath);
+
+// Full parameters
+Dictionary<string, object> GetTestDataQueueItem(string queueName, string folderPath, bool markConsumed, int timeoutMs);
+```
+
+| Parameter | Type | Default | Description |
+|---|---|---|---|
+| `queueName` | `string` | — | Queue name |
+| `folderPath` | `string` | `null` | Orchestrator folder path |
+| `markConsumed` | `bool` | (not set) | Mark the item as consumed |
+| `timeoutMs` | `int` | (not set) | Timeout in milliseconds |
+
+```csharp
+Dictionary<string, object> item = testing.GetTestDataQueueItem("InvoiceTestData");
+string invoiceNumber = item["InvoiceNumber"].ToString();
+```
+
+### GetTestDataQueueItems
+
+Gets all items from a specified queue.
+
+```csharp
+// Minimal
+List<TestDataQueueItem> GetTestDataQueueItems(string queueName);
+
+// With folder path
+List<TestDataQueueItem> GetTestDataQueueItems(string queueName, string folderPath);
+
+// Full parameters
+List<TestDataQueueItem> GetTestDataQueueItems(
+    string queueName,
+    string folderPath,
+    string idFilter,
+    TestDataQueueItemStatus testDataQueueItemStatus,
+    int? skip,
+    int? top,
+    int timeoutMs
+);
+```
+
+| Parameter | Type | Default | Description |
+|---|---|---|---|
+| `queueName` | `string` | — | Queue name |
+| `folderPath` | `string` | `null` | Orchestrator folder path |
+| `idFilter` | `string` | `null` | Filter by ID |
+| `testDataQueueItemStatus` | `TestDataQueueItemStatus` | (not set) | Filter by status: `All`, `OnlyConsumed`, `OnlyNotConsumed` |
+| `skip` | `int?` | `null` | Number of items to skip (for pagination) |
+| `top` | `int?` | `null` | Maximum number of items to return |
+| `timeoutMs` | `int` | (not set) | Timeout in milliseconds |
+
+**`TestDataQueueItem` properties:**
+
+| Property | Type | Description |
+|---|---|---|
+| `Id` | `long?` | The item ID |
+| `Content` | `Dictionary<string, object>` | The item data |
+| `IsConsumed` | `bool?` | Whether the item has been consumed |
+
+```csharp
+// Get all unconsumed items
+List<TestDataQueueItem> items = testing.GetTestDataQueueItems(
+    "InvoiceTestData", null, null, TestDataQueueItemStatus.OnlyNotConsumed, null, null, 30000
+);
+
+foreach (var item in items)
+{
+    Log($"Item {item.Id}: {item.Content["InvoiceNumber"]}");
+}
+```
+
+### DeleteTestDataQueueItems
+
+Deletes specified test data queue items.
+
+```csharp
+// Minimal
+void DeleteTestDataQueueItems(List<TestDataQueueItem> testDataQueueItems);
+
+// With folder path
+void DeleteTestDataQueueItems(List<TestDataQueueItem> testDataQueueItems, string folderPath);
+
+// With folder path and timeout
+void DeleteTestDataQueueItems(List<TestDataQueueItem> testDataQueueItems, string folderPath, int timeoutMs);
+```
+
+| Parameter | Type | Description |
+|---|---|---|
+| `testDataQueueItems` | `List<TestDataQueueItem>` | Items to delete |
+| `folderPath` | `string` | Orchestrator folder path |
+| `timeoutMs` | `int` | Timeout in milliseconds |
+
+```csharp
+List<TestDataQueueItem> consumed = testing.GetTestDataQueueItems(
+    "InvoiceTestData", null, null, TestDataQueueItemStatus.OnlyConsumed, null, null, 30000
+);
+testing.DeleteTestDataQueueItems(consumed);
+```

package/skills/uipath-rpa/references/activity-docs/UiPath.Testing.Activities/25.10/coded/testing-verification.md

@@ -0,0 +1,284 @@
+# Testing — Verification / Assertion APIs
+
+All verification methods on the `testing` service (`ITestingService`). Each method returns `bool` — `true` if passed, `false` if failed. For general info see [testing.md](testing.md).
+
+---
+
+## VerifyExpression
+
+Verifies a boolean expression.
+
+### Overloads
+
+```csharp
+// Minimal — just the expression
+bool VerifyExpression(bool expression);
+
+// With output message
+bool VerifyExpression(bool expression, string outputMessageFormat);
+
+// Full parameters
+bool VerifyExpression(
+    bool expression,
+    string outputMessageFormat,
+    bool continueOnFailure,
+    string alternativeVerificationTitle,
+    bool takeScreenshotInCaseOfFailingAssertion,
+    bool takeScreenshotInCaseOfSucceedingAssertion
+);
+```
+
+### Parameters
+
+| Parameter | Type | Default | Description |
+|---|---|---|---|
+| `expression` | `bool` | — | The boolean expression to verify |
+| `outputMessageFormat` | `string` | `null` | Custom output message. Supports placeholders: `{LeftExpression}`, `{LeftExpressionText}`, `{RightExpression}`, `{RightExpressionText}`, `{Result}`, `{Operator}` |
+| `continueOnFailure` | `bool` | `false` | If `true`, execution continues even if the verification fails |
+| `alternativeVerificationTitle` | `string` | `null` | Title displayed in Orchestrator. If not set, defaults to the activity's DisplayName |
+| `takeScreenshotInCaseOfFailingAssertion` | `bool` | `false` | Take screenshot on failure |
+| `takeScreenshotInCaseOfSucceedingAssertion` | `bool` | `false` | Take screenshot on success |
+
+### Usage
+
+```csharp
+testing.VerifyExpression(count > 0, "Count should be positive");
+
+testing.VerifyExpression(
+    name.Contains("test"),
+    "Name should contain 'test'",
+    continueOnFailure: true,
+    alternativeVerificationTitle: "Name validation",
+    takeScreenshotInCaseOfFailingAssertion: true,
+    takeScreenshotInCaseOfSucceedingAssertion: false
+);
+```
+
+---
+
+## VerifyExpressionWithOperator
+
+Verifies two expressions using a comparison operator.
+
+### Overloads
+
+```csharp
+// Minimal
+bool VerifyExpressionWithOperator(
+    object firstExpression,
+    Comparison operatorValue,
+    object secondExpression,
+    string outputMessageFormat = null
+);
+
+// Full parameters
+bool VerifyExpressionWithOperator(
+    object firstExpression,
+    Comparison operatorValue,
+    object secondExpression,
+    string outputMessageFormat,
+    bool continueOnFailure,
+    string alternativeVerificationTitle,
+    bool takeScreenshotInCaseOfFailingAssertion,
+    bool takeScreenshotInCaseOfSucceedingAssertion
+);
+```
+
+### Parameters
+
+| Parameter | Type | Default | Description |
+|---|---|---|---|
+| `firstExpression` | `object` | — | The left-hand expression |
+| `operatorValue` | `Comparison` | — | The comparison operator |
+| `secondExpression` | `object` | — | The right-hand expression |
+| `outputMessageFormat` | `string` | `null` | Custom output message with placeholders |
+| `continueOnFailure` | `bool` | `false` | Continue execution on failure |
+| `alternativeVerificationTitle` | `string` | `null` | Title displayed in Orchestrator |
+| `takeScreenshotInCaseOfFailingAssertion` | `bool` | `false` | Take screenshot on failure |
+| `takeScreenshotInCaseOfSucceedingAssertion` | `bool` | `false` | Take screenshot on success |
+
+### `Comparison` enum values
+
+| Value | Operator | Description |
+|---|---|---|
+| `Comparison.Equality` | `=` | Equal |
+| `Comparison.Inequality` | `<>` | Not equal |
+| `Comparison.GreaterThan` | `>` | Greater than |
+| `Comparison.GreaterThanOrEqual` | `>=` | Greater than or equal |
+| `Comparison.LessThan` | `<` | Less than |
+| `Comparison.LessThanOrEqual` | `<=` | Less than or equal |
+| `Comparison.Contains` | `Contains` | First contains second |
+| `Comparison.RegexMatch` | `Regex-Match` | First matches regex in second |
+
+### Usage
+
+```csharp
+testing.VerifyExpressionWithOperator(actualCount, Comparison.Equality, expectedCount, "Counts should match");
+testing.VerifyExpressionWithOperator(price, Comparison.GreaterThan, 0, "Price must be positive");
+```
+
+---
+
+## Convenience Verification Methods
+
+These are shorthand methods that internally call `VerifyExpressionWithOperator` with a specific `Comparison` operator.
+
+### VerifyAreEqual
+
+Verifies two expressions are equal (`Comparison.Equality`).
+
+```csharp
+bool VerifyAreEqual(object firstExpression, object secondExpression, string outputMessageFormat = null);
+```
+
+```csharp
+testing.VerifyAreEqual("Completed", status, "Status should be Completed");
+testing.VerifyAreEqual(expectedCount, actualCount, "Counts should match");
+```
+
+### VerifyAreNotEqual
+
+Verifies two expressions are not equal (`Comparison.Inequality`).
+
+```csharp
+bool VerifyAreNotEqual(object firstExpression, object secondExpression, string outputMessageFormat = null);
+```
+
+```csharp
+testing.VerifyAreNotEqual("Pending", status, "Status should have changed from Pending");
+```
+
+### VerifyIsGreater
+
+Verifies the first expression is greater than the second (`Comparison.GreaterThan`).
+
+```csharp
+bool VerifyIsGreater(object firstExpression, object secondExpression, string outputMessageFormat = null);
+```
+
+```csharp
+testing.VerifyIsGreater(revenue, 1000, "Revenue should exceed 1000");
+```
+
+### VerifyIsGreaterOrEqual
+
+Verifies the first expression is greater than or equal to the second (`Comparison.GreaterThanOrEqual`).
+
+```csharp
+bool VerifyIsGreaterOrEqual(object firstExpression, object secondExpression, string outputMessageFormat = null);
+```
+
+```csharp
+testing.VerifyIsGreaterOrEqual(itemCount, minimumRequired, "Should meet minimum item count");
+```
+
+### VerifyIsLess
+
+Verifies the first expression is less than the second (`Comparison.LessThan`).
+
+```csharp
+bool VerifyIsLess(object firstExpression, object secondExpression, string outputMessageFormat = null);
+```
+
+```csharp
+testing.VerifyIsLess(responseTime, 5000, "Response time should be under 5 seconds");
+```
+
+### VerifyIsLessOrEqual
+
+Verifies the first expression is less than or equal to the second (`Comparison.LessThanOrEqual`).
+
+```csharp
+bool VerifyIsLessOrEqual(object firstExpression, object secondExpression, string outputMessageFormat = null);
+```
+
+```csharp
+testing.VerifyIsLessOrEqual(errorCount, maxAllowedErrors, "Errors should not exceed maximum");
+```
+
+### VerifyContains
+
+Verifies the first expression contains the second (`Comparison.Contains`).
+
+```csharp
+bool VerifyContains(object firstExpression, object secondExpression, string outputMessageFormat = null);
+```
+
+```csharp
+testing.VerifyContains(fullMessage, "success", "Message should contain 'success'");
+```
+
+### VerifyIsRegexMatch
+
+Verifies the first expression matches the regex pattern in the second (`Comparison.RegexMatch`).
+
+```csharp
+bool VerifyIsRegexMatch(object firstExpression, object secondExpression, string outputMessageFormat = null);
+```
+
+```csharp
+testing.VerifyIsRegexMatch(email, @"^[\w.-]+@[\w.-]+\.\w+$", "Should be a valid email format");
+```
+
+---
+
+## VerifyRange
+
+Verifies a value is within (or outside) a specified range.
+
+### Overloads
+
+```csharp
+// Minimal
+bool VerifyRange(
+    object expression,
+    VerificationType verificationType,
+    object lowerLimit,
+    object upperLimit,
+    string outputMessageFormat = null
+);
+
+// Full parameters
+bool VerifyRange(
+    object expression,
+    VerificationType verificationType,
+    object lowerLimit,
+    object upperLimit,
+    string outputMessageFormat,
+    bool continueOnFailure,
+    string alternativeVerificationTitle,
+    bool takeScreenshotInCaseOfFailingAssertion,
+    bool takeScreenshotInCaseOfSucceedingAssertion
+);
+```
+
+### Parameters
+
+| Parameter | Type | Default | Description |
+|---|---|---|---|
+| `expression` | `object` | — | The value to verify |
+| `verificationType` | `VerificationType` | — | `IsWithin` or `IsNotWithin` the range |
+| `lowerLimit` | `object` | — | The lower bound of the range |
+| `upperLimit` | `object` | — | The upper bound of the range |
+| `outputMessageFormat` | `string` | `null` | Custom output message |
+| `continueOnFailure` | `bool` | `false` | Continue execution on failure |
+| `alternativeVerificationTitle` | `string` | `null` | Title displayed in Orchestrator |
+| `takeScreenshotInCaseOfFailingAssertion` | `bool` | `false` | Take screenshot on failure |
+| `takeScreenshotInCaseOfSucceedingAssertion` | `bool` | `false` | Take screenshot on success |
+
+### `VerificationType` enum
+
+| Value | Description |
+|---|---|
+| `VerificationType.IsWithin` | Value must be inside the range |
+| `VerificationType.IsNotWithin` | Value must be outside the range |
+
+### Usage
+
+```csharp
+// Value should be within range
+testing.VerifyRange(processingTime, VerificationType.IsWithin, 0.5, 5.0, "Processing time should be 0.5-5s");
+
+// Value should be outside range
+testing.VerifyRange(errorRate, VerificationType.IsNotWithin, 10, 100, "Error rate should not be 10-100%");
+```

package/skills/uipath-rpa/references/activity-docs/UiPath.Testing.Activities/25.10/coded/testing.md

@@ -0,0 +1,51 @@
+# Testing Activities API Reference
+
+Reference for the `testing` service from `UiPath.Testing.Activities` package.
+
+**Required package:** `"UiPath.Testing.Activities": "[25.10.2]"`
+
+**Auto-imported namespaces:** `System`, `System.Collections.Generic`, `UiPath.Testing.Activities.TestDataQueues.Enums`, `UiPath.Testing.Activities.TestData`, `UiPath.Testing.Enums`, `UiPath.Testing`, `UiPath.Testing.Activities.Models`, `UiPath.Testing.Activities.Api.Models`
+
+**Service accessor:** `testing` (type `ITestingService`)
+
+---
+
+## API Categories
+
+The Testing API has three main areas:
+
+1. **Verification / Assertions** — Methods for verifying expressions, equality, comparisons, ranges, containment, and regex matching. See [testing-verification.md](testing-verification.md).
+
+2. **Data Generation & Test Data Queues** — Random data generation (names, numbers, dates, strings, addresses) and Orchestrator test data queue operations (add, get, delete items). See [testing-data.md](testing-data.md).
+
+3. **Document & Text Comparison** — PDF document and text comparison with rules, semantic analysis, and diff output. See [testing-comparison.md](testing-comparison.md).
+
+For full coded workflow examples, see [examples.md](examples.md).
+
+---
+
+## Key Type Reference
+
+### Enums
+
+| Enum | Namespace | Values |
+|---|---|---|
+| `Comparison` | `UiPath.Testing` | `Equality` (=), `Inequality` (<>), `GreaterThan` (>), `GreaterThanOrEqual` (>=), `LessThan` (<), `LessThanOrEqual` (<=), `Contains`, `RegexMatch` |
+| `VerificationType` | `UiPath.Testing.Activities` | `IsWithin` (0), `IsNotWithin` (1) |
+| `ComparisonType` | `UiPath.Testing.Activities.Models` | `Line`, `Word`, `Character` |
+| `Case` | `UiPath.Testing.Enums` | `LowerCase`, `UpperCase`, `CamelCase`, `Mixed` |
+| `TestDataQueueItemStatus` | `UiPath.Testing.Activities.TestDataQueues.Enums` | `All` (0), `OnlyConsumed` (1), `OnlyNotConsumed` (2) |
+| `Operation` | `UiPath.Testing.Activities.Models` | `Inserted`, `Deleted`, `Equal` |
+| `DocumentOutputDiffType` | `UiPath.Testing.Activities.Models` | `None`, `Pdf`, `Unidiff`, `Html` |
+
+### Classes
+
+| Class | Namespace | Description |
+|---|---|---|
+| `TestDataQueueItem` | `UiPath.Testing.Core` | Represents a test data queue item with `Id` (`long?`), `Content` (`Dictionary<string, object>`), `IsConsumed` (`bool?`) |
+| `ComparisonResult` | `UiPath.Testing.Activities.Models` | Result of a comparison with `AreEquivalent` (`bool`), `Differences` (`List<Difference>`), `SemanticDifferences` (`SemanticDifferences`) |
+| `Difference` | `UiPath.Testing.Activities.Models` | A single difference with `Operation` (`Operation`) and `Text` (`string`) |
+| `SemanticDifferences` | `UiPath.Testing.Activities.Models` | Semantic analysis result with `AreSemanticallyEquivalent` (`bool`), `Explanation` (`string`), `Differences` (`List<SemanticDifference>`) |
+| `SemanticDifference` | `UiPath.Testing.Activities.Models` | A single semantic difference with `Explanation` (`string`) |
+| `RegexRule` | `UiPath.Testing.Activities.Models` | Comparison rule using regex pattern. Constructor: `RegexRule(string name, string pattern, bool usePlaceholder = true)` |
+| `WildcardRule` | `UiPath.Testing.Activities.Models` | Comparison rule using wildcard pattern (`*` and `?`). Constructor: `WildcardRule(string name, string pattern, bool usePlaceholder = true)` |