@uipath/skills 1.195.0

package/skills/uipath-rpa/references/activity-docs/UiPath.NetIQeDirectory.Activities/1.6/coded/examples.md

@@ -0,0 +1,361 @@
+# NetIQ eDirectory Examples
+
+Examples using the `netiq` service from `UiPath.NetIQeDirectory.Activities` package.
+
+**Required package:** `"UiPath.NetIQeDirectory.Activities": "[1.4.1]"`
+
+---
+
+## Create a User and Check Status
+
+```csharp
+using System.Collections.Generic;
+using UiPath.NetIQeDirectory;
+using UiPath.NetIQeDirectory.Activities.API;
+using UiPath.NetIQeDirectory.Interfaces;
+
+namespace MyProject
+{
+    public class CreateUserWorkflow : CodedWorkflow
+    {
+        [Workflow]
+        public async Task Execute(INetIQeDirectoryClientProvider clientProvider)
+        {
+            INetIQeDirectoryUserService userService =
+                netiq.NetIQeDirectoryUserService(clientProvider);
+
+            // Create a new user
+            var properties = new Dictionary<string, object>
+            {
+                { "givenName", "John" },
+                { "sn", "Doe" },
+                { "mail", "john.doe@corp.com" },
+                { "userPrincipalName", "john.doe@corp.com" }
+            };
+
+            string userDn = await userService.CreateUser(
+                commonName: "John Doe",
+                sAMAccountName: "john.doe",
+                password: "P@ssw0rd123!",
+                locationDn: "OU=Users,O=corp",
+                properties: properties,
+                enabled: true,
+                connection: Connection.Primary);
+
+            Log($"Created user: {userDn}");
+
+            // Check user status
+            (LockStatus lockStatus, ActiveStatus activeStatus) =
+                await userService.GetUserStatus(userDn, Connection.Primary);
+            Log($"Lock: {lockStatus}, Active: {activeStatus}");
+        }
+    }
+}
+```
+
+## Password Management
+
+```csharp
+using System;
+using UiPath.NetIQeDirectory;
+using UiPath.NetIQeDirectory.Activities.API;
+using UiPath.NetIQeDirectory.Interfaces;
+
+namespace MyProject
+{
+    public class PasswordWorkflow : CodedWorkflow
+    {
+        [Workflow]
+        public async Task Execute(INetIQeDirectoryClientProvider clientProvider, string userDn)
+        {
+            INetIQeDirectoryUserService userService =
+                netiq.NetIQeDirectoryUserService(clientProvider);
+
+            // Check password expiration
+            DateTime? pwdExpiry = await userService.GetPasswordExpirationDate(
+                userDn, Connection.Primary);
+            if (pwdExpiry.HasValue)
+                Log($"Password expires: {pwdExpiry.Value}");
+            else
+                Log("Password never expires.");
+
+            // Change password
+            await userService.ChangeUserPassword(userDn, "NewP@ss456!", Connection.Primary);
+            Log("Password changed.");
+
+            // Force change at next logon
+            await userService.ForcePasswordChange(userDn, Connection.Primary);
+            Log("Must change password at next logon.");
+
+            // Validate credentials
+            bool isValid = await userService.ValidateUserCredentials(
+                ValidateCredentialsUserFilter.SAMAccountName,
+                "john.doe",
+                "NewP@ss456!",
+                ConnectionWithoutAuto.Primary);
+            Log($"Credentials valid: {isValid}");
+        }
+    }
+}
+```
+
+## User Status and Expiration
+
+```csharp
+using System;
+using UiPath.NetIQeDirectory;
+using UiPath.NetIQeDirectory.Activities.API;
+using UiPath.NetIQeDirectory.Interfaces;
+
+namespace MyProject
+{
+    public class UserStatusWorkflow : CodedWorkflow
+    {
+        [Workflow]
+        public async Task Execute(INetIQeDirectoryClientProvider clientProvider, string userDn)
+        {
+            INetIQeDirectoryUserService userService =
+                netiq.NetIQeDirectoryUserService(clientProvider);
+
+            // Unlock user
+            await userService.SetUserStatus(userDn, UserStatus.Unlocked, Connection.Primary);
+            Log("User unlocked.");
+
+            // Set account expiration
+            await userService.SetUserExpirationDate(
+                userDn, DateTime.Now.AddMonths(6), Connection.Primary);
+            Log("Expiration date set.");
+
+            // Get groups
+            string[] groups = await userService.GetUserGroups(userDn, Connection.Primary);
+            foreach (string groupDn in groups)
+            {
+                Log($"Member of: {groupDn}");
+            }
+        }
+    }
+}
+```
+
+## Group Management
+
+```csharp
+using System.Collections.Generic;
+using UiPath.NetIQeDirectory;
+using UiPath.NetIQeDirectory.Activities.API;
+using UiPath.NetIQeDirectory.Enums;
+using UiPath.NetIQeDirectory.Interfaces;
+
+namespace MyProject
+{
+    public class GroupWorkflow : CodedWorkflow
+    {
+        [Workflow]
+        public async Task Execute(INetIQeDirectoryClientProvider clientProvider)
+        {
+            INetIQeDirectoryGroupService groupService =
+                netiq.NetIQeDirectoryGroupService(clientProvider);
+            INetIQeDirectoryUserService userService =
+                netiq.NetIQeDirectoryUserService(clientProvider);
+            INetIQeDirectoryObjectService objectService =
+                netiq.NetIQeDirectoryObjectService(clientProvider);
+
+            // Create a group
+            string groupDn = await groupService.CreateGroup(
+                commonName: "Engineering",
+                sAMAccountName: "Engineering",
+                locationDn: "OU=Groups,O=corp",
+                properties: new Dictionary<string, object>
+                {
+                    { "description", "Engineering team" }
+                },
+                type: GroupType.GlobalSecurity,
+                connection: Connection.Primary);
+
+            Log($"Created group: {groupDn}");
+
+            // Add a user to the group
+            string userDn = await objectService.GetDistinguishedName(
+                "john.doe", ConnectionWithoutAuto.Primary);
+            await userService.AddUserToGroup(
+                userDn, groupDn, Connection.Primary, Connection.Primary);
+            Log("User added to group.");
+
+            // List user members
+            string[] members = await groupService.GetMembersDN(
+                groupDn, EntryType.User, Connection.Primary);
+            foreach (string memberDn in members)
+            {
+                Log($"Member: {memberDn}");
+            }
+
+            // Check membership
+            bool isMember = await objectService.IsObjectMemberOfGroup(
+                userDn, groupDn, Connection.Primary, Connection.Primary,
+                recurseIntoChildGroups: true);
+            Log($"Is member: {isMember}");
+
+            // Remove user from group
+            await userService.RemoveUserFromGroup(
+                userDn, groupDn, Connection.Primary, Connection.Primary);
+            Log("User removed.");
+        }
+    }
+}
+```
+
+## Search and Filter Objects
+
+```csharp
+using System.Collections.Generic;
+using UiPath.NetIQeDirectory;
+using UiPath.NetIQeDirectory.Activities.API;
+using UiPath.NetIQeDirectory.Interfaces;
+
+namespace MyProject
+{
+    public class SearchWorkflow : CodedWorkflow
+    {
+        [Workflow]
+        public async Task Execute(INetIQeDirectoryClientProvider clientProvider)
+        {
+            INetIQeDirectoryObjectService objectService =
+                netiq.NetIQeDirectoryObjectService(clientProvider);
+
+            // Resolve SAM account name to DN
+            string dn = await objectService.GetDistinguishedName(
+                "john.doe", ConnectionWithoutAuto.Primary);
+            Log($"DN: {dn}");
+
+            // Get all properties
+            Dictionary<string, object> props = objectService.GetObjectProperties(
+                dn, Connection.Primary);
+            foreach (var kvp in props)
+            {
+                Log($"{kvp.Key} = {kvp.Value}");
+            }
+
+            // Search with LDAP filter
+            string[] results = await objectService.FilterObjects(
+                "(&(objectClass=user)(department=Engineering))",
+                "OU=Users,O=corp",
+                ConnectionWithoutAuto.Primary);
+            Log($"Found {results.Length} users in Engineering.");
+
+            // Update properties
+            await objectService.UpdateProperties(dn,
+                new Dictionary<string, object>
+                {
+                    { "title", "Senior Engineer" },
+                    { "department", "Platform" }
+                },
+                Connection.Primary);
+            Log("Properties updated.");
+        }
+    }
+}
+```
+
+## Computer Management
+
+```csharp
+using System.Collections.Generic;
+using UiPath.NetIQeDirectory;
+using UiPath.NetIQeDirectory.Activities.API;
+using UiPath.NetIQeDirectory.Interfaces;
+
+namespace MyProject
+{
+    public class ComputerWorkflow : CodedWorkflow
+    {
+        [Workflow]
+        public async Task Execute(INetIQeDirectoryClientProvider clientProvider)
+        {
+            INetIQeDirectoryComputerService computerService =
+                netiq.NetIQeDirectoryComputerService(clientProvider);
+
+            // Create a computer
+            string computerDn = await computerService.CreateComputer(
+                commonName: "WORKSTATION01",
+                sAMAccountName: "WORKSTATION01$",
+                locationDn: "OU=Computers,O=corp",
+                properties: new Dictionary<string, object>
+                {
+                    { "description", "Dev workstation" }
+                },
+                enabled: true,
+                connection: Connection.Primary);
+
+            Log($"Created computer: {computerDn}");
+
+            // Check status
+            ActiveStatus status = await computerService.GetComputerStatus(
+                computerDn, Connection.Primary);
+            Log($"Status: {status}");
+
+            // Add to group
+            await computerService.AddComputerToGroup(
+                computerDn,
+                "CN=DevMachines,OU=Groups,O=corp",
+                Connection.Primary, Connection.Primary);
+            Log("Added to group.");
+
+            // Disable
+            await computerService.SetComputerStatus(
+                computerDn, ActiveStatus.Disabled, Connection.Primary);
+            Log("Computer disabled.");
+        }
+    }
+}
+```
+
+## Move, Rename, and Manage OUs
+
+```csharp
+using System.Collections.Generic;
+using UiPath.NetIQeDirectory;
+using UiPath.NetIQeDirectory.Activities.API;
+using UiPath.NetIQeDirectory.Interfaces;
+
+namespace MyProject
+{
+    public class MoveRenameOUWorkflow : CodedWorkflow
+    {
+        [Workflow]
+        public async Task Execute(INetIQeDirectoryClientProvider clientProvider)
+        {
+            INetIQeDirectoryObjectService objectService =
+                netiq.NetIQeDirectoryObjectService(clientProvider);
+            INetIQeDirectoryOrganizationService ouService =
+                netiq.NetIQeDirectoryOrganizationService(clientProvider);
+
+            // Create an OU
+            string ouDn = await ouService.CreateOrganizationalUnit(
+                organizationUnitName: "Contractors",
+                locationDn: "O=corp",
+                properties: new Dictionary<string, object>
+                {
+                    { "description", "Contractor accounts" }
+                },
+                connection: Connection.Primary);
+            Log($"Created OU: {ouDn}");
+
+            // Move an object to the new OU
+            string userDn = await objectService.GetDistinguishedName(
+                "john.doe", ConnectionWithoutAuto.Primary);
+            await objectService.MoveObject(userDn, ouDn, Connection.Primary);
+            Log("User moved to Contractors OU.");
+
+            // Rename an object
+            string newDn = await objectService.GetDistinguishedName(
+                "john.doe", ConnectionWithoutAuto.Primary);
+            await objectService.RenameObject(newDn, "John M. Doe", Connection.Primary);
+            Log("User renamed.");
+
+            // Delete the OU
+            await ouService.DeleteOrganizationalUnit(ouDn, recursive: true, Connection.Primary);
+            Log("OU deleted.");
+        }
+    }
+}
+```

package/skills/uipath-rpa/references/activity-docs/UiPath.NetIQeDirectory.Activities/1.6/coded/netiq-edirectory.md

@@ -0,0 +1,109 @@
+# NetIQ eDirectory Activities API Reference
+
+Reference for the `netiq` service from `UiPath.NetIQeDirectory.Activities` package.
+
+**Required package:** `"UiPath.NetIQeDirectory.Activities": "[1.4.1]"`
+
+**Auto-imported namespaces:** `UiPath.NetIQeDirectory.Activities.API`, `UiPath.Core`, `UiPath.NetIQeDirectory`, `UiPath.NetIQeDirectory.Models`, `UiPath.NetIQeDirectory.Core`
+
+**Service accessor:** `netiq` (type `INetIQeDirectoryService`)
+
+---
+
+## Overview
+
+The NetIQ eDirectory API provides coded workflow access to manage NetIQ/Micro Focus eDirectory (LDAP-based directory service) objects — users, computers, groups, organizational units, and common directory operations (search, move, rename, property management).
+
+The main entry point is `INetIQeDirectoryService`, accessed via the `netiq` service accessor. This service acts as a factory: each method takes an `INetIQeDirectoryClientProvider` (obtained from a NetIQ eDirectory Scope activity) and returns a sub-service bound to your LDAP connection.
+
+**Note:** Most methods in this API are **asynchronous** (return `Task` or `Task<T>`), except `GetObjectProperties` which is synchronous.
+
+### Usage Pattern
+
+```csharp
+// 1. Obtain sub-services from the factory
+INetIQeDirectoryUserService userService = netiq.NetIQeDirectoryUserService(clientProvider);
+INetIQeDirectoryGroupService groupService = netiq.NetIQeDirectoryGroupService(clientProvider);
+INetIQeDirectoryObjectService objectService = netiq.NetIQeDirectoryObjectService(clientProvider);
+
+// 2. Call operations on the sub-services
+string dn = await objectService.GetDistinguishedName("john.doe", ConnectionWithoutAuto.Primary);
+var (lockStatus, activeStatus) = await userService.GetUserStatus(dn, Connection.Primary);
+```
+
+### Connection Parameter
+
+Most methods accept a `Connection` or `ConnectionWithoutAuto` parameter that specifies which eDirectory connection to use (when the scope has primary and secondary connections configured):
+
+- `Connection.Auto` — Automatically select based on the DN suffix
+- `Connection.Primary` — Use the primary connection
+- `Connection.Secondary` — Use the secondary connection
+- `ConnectionWithoutAuto.Primary` / `ConnectionWithoutAuto.Secondary` — Same but without the `Auto` option
+
+**Important:** Unlike Active Directory Domain Services, the `Connection` parameter in NetIQ methods has **no default value** — it must always be specified explicitly.
+
+### API Categories
+
+| Category | Sub-Service | Description | Reference |
+|---|---|---|---|
+| **Objects** | `INetIQeDirectoryObjectService` | DN lookup, properties, search, move, rename, group membership | [api.md - Objects](api.md#objects) |
+| **Users** | `INetIQeDirectoryUserService` | Create, delete, status, password, groups, expiration | [api.md - Users](api.md#users) |
+| **Computers** | `INetIQeDirectoryComputerService` | Create, delete, status, group membership | [api.md - Computers](api.md#computers) |
+| **Groups** | `INetIQeDirectoryGroupService` | Create, delete groups, manage membership | [api.md - Groups](api.md#groups) |
+| **Organizational Units** | `INetIQeDirectoryOrganizationService` | Create and delete OUs | [api.md - Organizational Units](api.md#organizational-units) |
+
+For full coded workflow examples, see [examples.md](examples.md).
+
+---
+
+## Service Factory Methods
+
+The `INetIQeDirectoryService` (accessed via `netiq`) exposes these factory methods. Each takes an `INetIQeDirectoryClientProvider` and returns a sub-service:
+
+| Method | Returns | Description |
+|---|---|---|
+| `NetIQeDirectoryObjectService(clientProvider)` | `INetIQeDirectoryObjectService` | Common object operations |
+| `NetIQeDirectoryUserService(clientProvider)` | `INetIQeDirectoryUserService` | User management |
+| `NetIQeDirectoryComputerService(clientProvider)` | `INetIQeDirectoryComputerService` | Computer management |
+| `NetIQeDirectoryGroupService(clientProvider)` | `INetIQeDirectoryGroupService` | Group management |
+| `NetIQeDirectoryOrganizationService(clientProvider)` | `INetIQeDirectoryOrganizationService` | OU management |
+
+---
+
+## Type Reference
+
+### INetIQeDirectoryClientProvider
+
+LDAP connection provider obtained from the NetIQ eDirectory Scope activity. Provides authenticated `LdapConnection` instances for primary and optional secondary connections.
+
+### FilterProperty
+
+Used to build LDAP search filters.
+
+```csharp
+// Constructor
+new FilterProperty(string name, string value, Relation relation)
+```
+
+| Parameter | Type | Description |
+|---|---|---|
+| `name` | `string` | LDAP attribute name (e.g., `"sAMAccountName"`, `"cn"`, `"mail"`) |
+| `value` | `string` | Value to match |
+| `relation` | `Relation` | Comparison operator |
+
+---
+
+## Key Enum Reference Summary
+
+| Enum | Values | Description |
+|---|---|---|
+| `Connection` | `Auto`, `Primary`, `Secondary` | Which eDirectory connection to use |
+| `ConnectionWithoutAuto` | `Primary`, `Secondary` | Connection without auto-select |
+| `ConnectionType` | `LDAP`, `LDAPS` | Connection protocol |
+| `EntryType` | `User`, `Group`, `Computer`, `OrganizationalUnit` | Type of directory entry |
+| `ActiveStatus` | `Disabled` (0), `Enabled` (1) | Account enabled/disabled state |
+| `LockStatus` | `Unlocked` (0), `Locked` (1) | Account lock state |
+| `UserStatus` | `Disabled` (0), `Enabled` (1), `Unlocked` (2) | User status to set (includes unlock) |
+| `GroupType` | `LocalDistribution`, `LocalSecurity`, `GlobalDistribution`, `GlobalSecurity`, `UniversalDistribution`, `UniversalSecurity` | Group type and scope |
+| `Relation` | `EqualTo`, `NotEqual`, `GreaterThanOrEqualTo`, `LessThanOrEqualTo` | Filter comparison operator |
+| `ValidateCredentialsUserFilter` | `SAMAccountName`, `UserPrincipalName`, `DistinguishedName` | How to identify user for credential validation |

package/skills/uipath-rpa/references/activity-docs/UiPath.PDF.Activities/4.1/activities/ConvertEmailToPDF.md

@@ -0,0 +1,59 @@
+# Convert Email to PDF
+
+`UiPath.PDF.Activities.PDF.NetCore.ConvertEmailToPDF`
+
+Converts a `MailMessage` object to a PDF file. The activity automatically detects whether the email body is HTML or plain text and applies the appropriate rendering template, preserving the subject, sender, and recipient metadata as a formatted header block. Optional page header/footer HTML templates, paper size, margin, and scale settings are available for layout customization.
+
+**Package:** `UiPath.PDF.Activities`
+**Category:** App Integration > PDF
+
+## Properties
+
+### Input
+
+| Name | Display Name | Kind | Type | Required | Default | Placeholder | Description |
+|------|-------------|------|------|----------|---------|-------------|-------------|
+| `Email` | Email | `InArgument` | `MailMessage` | Yes | | | The email message to convert to PDF. Both HTML and plain-text bodies are supported. |
+
+### Configuration
+
+| Name | Display Name | Type | Default | Description |
+|------|-------------|------|---------|-------------|
+| `HeaderHtml` | Html Header Content | `InArgument<string>` | | An HTML string to use as a page header template. |
+| `FooterHtml` | Html Footer Content | `InArgument<string>` | | An HTML string to use as a page footer template. |
+| `PaperSize` | Paper Size | `InArgument<PdfPaperSize>` | `A4` | The paper size used for the PDF output. |
+| `Margin` | Margin | `InArgument<int>` | `0` | Page margin in points. |
+| `Scale` | Scale | `InArgument<double>` | `1.0` | Page rendering scale. Must be between 0.1 and 2 inclusive. |
+| `KeepBackground` | Keep Background | `InArgument<bool>` | `true` | Whether to preserve background color and graphics during conversion. |
+| `OutputFileName` | Output File Path | `InArgument<string>` | | Full path of the output PDF file. If not specified, a default file name is generated. |
+
+### Output
+
+| Name | Display Name | Type | Description |
+|------|-------------|------|-------------|
+| `OutputFile` | Output File | `ILocalResource` | The resulting PDF file as a local resource. |
+
+### Enum Reference
+
+**`PdfPaperSize`**: `A4`, `A3`, `A5`, `A2`, `A6`, `Letter`, `Legal`, `Tabloid`, `Ledger`, `Executive`, `Statement`, `B4`, `B5`, `Number10Envelope`, `DLEnvelope`, `C5Envelope`, `C4Envelope`
+
+## XAML Example
+
+```xml
+<pdf:ConvertEmailToPDF
+    DisplayName="Convert Email to PDF"
+    Email="[mailMessage]"
+    PaperSize="Letter"
+    OutputFileName="[&quot;C:\output\email-export.pdf&quot;]"
+    OutputFile="[outputFile]" />
+```
+
+> The `pdf` namespace prefix maps to `clr-namespace:UiPath.PDF.Activities.PDF.NetCore;assembly=UiPath.PDF.Activities`.
+
+## Notes
+
+- The `Email` argument accepts a `System.Net.Mail.MailMessage` object. Use a mail activity (e.g., Get Mail, Get IMAP Mail Messages) to obtain a `MailMessage`, then pass it directly to this activity.
+- The activity inspects `MailMessage.IsBodyHtml` and `AlternateViews` to automatically select either the HTML or plain-text rendering template. No manual mode switch is required.
+- Rendered output includes a header block with **Subject**, **From**, and **To** fields extracted from the message.
+- `Scale` must be ≥ 0.1 and ≤ 2. Values outside this range will cause a runtime error.
+- When `OutputFileName` is omitted, a default PDF file name is generated in the current working directory.

package/skills/uipath-rpa/references/activity-docs/UiPath.PDF.Activities/4.1/activities/ConvertHtmlToPDF.md

@@ -0,0 +1,91 @@
+# Convert HTML to PDF
+
+`UiPath.PDF.Activities.PDF.NetCore.ConvertHtmlToPDF`
+
+Converts HTML content to a PDF file. The HTML can be supplied as an inline string or read from a local file, controlled by the **Input mode** selector. Optional header, footer, paper size, margin, scale, and background settings allow full control over the rendered output.
+
+**Package:** `UiPath.PDF.Activities`
+**Category:** App Integration > PDF
+
+## Properties
+
+### Input
+
+| Name   | Display Name | Kind         | Type     | Required | Default | Placeholder | Description                                                                  |
+| ------ | ------------ | ------------ | -------- | -------- | ------- | ----------- | ---------------------------------------------------------------------------- |
+| `Html` | HTML content | `InArgument` | `string` | Yes† | | | The HTML string to convert to PDF. Visible when **Input mode** is `Content`. |
+| `FileName` | File (local path) | `InArgument` | `string` | Yes* | | | Local path to an HTML file to convert. Visible when **Input mode** is `File`. Mutually exclusive with `ResourceFile`. |
+| `ResourceFile` | File | `InArgument` | `IResource` | Yes* | | | A file resource handle pointing to the HTML file to convert. Visible when **Input mode** is `File`. Mutually exclusive with `FileName`. |
+
+> *†Required when `InputMode` is `Content`. \*Exactly one of `FileName` or `ResourceFile` is required when `InputMode` is `File` (`[OverloadGroup]`).*
+
+### Configuration
+
+| Name | Display Name | Type | Default | Description |
+|------|-------------|------|---------|-------------|
+| `InputMode` | Input mode | `ItemInputMode` | `Content` | Selects whether the HTML source is an inline string (`Content`) or a file (`File`). Controls which input properties are visible. |
+| `PaperSize` | Paper Size | `InArgument<PdfPaperSize>` | `A4` | The paper size used for the PDF output. |
+| `Margin` | Margin | `InArgument<int>` | `0` | Page margin in points. |
+| `Scale` | Scale | `InArgument<double>` | `1.0` | Page rendering scale. Must be between 0.1 and 2 inclusive. |
+| `KeepBackground` | Keep Background | `InArgument<bool>` | `true` | Whether to preserve background color and graphics during conversion. |
+| `HeaderHtml` | Html Header Content | `InArgument<string>` | | An HTML document to use as a page header template. Visible when **Header input mode** is `Content`. |
+| `HeaderInputMode` | Header input mode | `ItemInputMode` | `Content` | Selects whether the header source is an inline string or a file. |
+| `FooterHtml` | Html Footer Content | `InArgument<string>` | | An HTML document to use as a page footer template. Visible when **Footer input mode** is `Content`. |
+| `FooterInputMode` | Footer input mode | `ItemInputMode` | `Content` | Selects whether the footer source is an inline string or a file. |
+| `OutputFileName` | Output File Path | `InArgument<string>` | | Full path of the output PDF file. If not specified, a default file name is generated. |
+
+### Output
+
+| Name | Display Name | Type | Description |
+|------|-------------|------|-------------|
+| `OutputFile` | Output File | `ILocalResource` | The resulting PDF file as a local resource. |
+
+## Valid Configurations
+
+**Mode 1 — Inline HTML content (default):**
+Set `InputMode` to `Content` and provide the `Html` string. `FileName` and `ResourceFile` are hidden.
+
+**Mode 2 — HTML from a local file path:**
+Set `InputMode` to `File` and provide `FileName`. `Html` is hidden. `FileName` and `ResourceFile` are mutually exclusive (`[OverloadGroup]`).
+
+**Mode 3 — HTML from a file resource:**
+Set `InputMode` to `File` and provide `ResourceFile`. `Html` is hidden.
+
+The same three modes apply independently to `HeaderInputMode` and `FooterInputMode`.
+
+### Conditional Properties
+
+These properties appear or change behavior based on other property values (controlled by ViewModel rules and dependencies):
+
+- **`Html`** (InArgument\<string\>) — Visible only when `InputMode` is `Content`. When `InputMode` switches to `File`, `Html` is hidden and the `Item` (FileName/ResourceFile) fields appear.
+- **`FileName`** (InArgument\<string\>) — Visible only when `InputMode` is `File`.
+- **`ResourceFile`** (InArgument\<IResource\>) — Visible only when `InputMode` is `File`.
+- **`HeaderHtml`** (InArgument\<string\>) — Visible only when `HeaderInputMode` is `Content`.
+- **`FooterHtml`** (InArgument\<string\>) — Visible only when `FooterInputMode` is `Content`.
+
+### Enum Reference
+
+**`ItemInputMode`**: `Content`, `File`
+
+**`PdfPaperSize`**: `A4`, `A3`, `A5`, `A2`, `A6`, `Letter`, `Legal`, `Tabloid`, `Ledger`, `Executive`, `Statement`, `B4`, `B5`, `Number10Envelope`, `DLEnvelope`, `C5Envelope`, `C4Envelope`
+
+## XAML Example
+
+```xml
+<pdf:ConvertHtmlToPDF
+    DisplayName="Convert Html to PDF"
+    Html="[htmlString]"
+    OutputFileName="[&quot;C:\output\report.pdf&quot;]"
+    PaperSize="A4"
+    Scale="[1.0]"
+    OutputFile="[outputFile]" />
+```
+
+> The `pdf` namespace prefix maps to `clr-namespace:UiPath.PDF.Activities.PDF.NetCore;assembly=UiPath.PDF.Activities`.
+
+## Notes
+
+- `FileName` and `ResourceFile` are decorated with `[OverloadGroup]` — at most one may be bound at runtime. Bind `FileName` for a plain string path, or `ResourceFile` when working with storage buckets and file resources.
+- `Scale` must be ≥ 0.1 and ≤ 2. Values outside this range will cause a runtime error.
+- When `OutputFileName` is omitted, a default PDF file name is generated in the current working directory.
+- Header and footer HTML templates have their own independent `InputMode` selectors (`HeaderInputMode`, `FooterInputMode`).