@uipath/skills 1.195.0

package/skills/uipath-rpa/references/activity-docs/UiPath.Word.Activities/2.5/coded/windows-api.md

@@ -0,0 +1,433 @@
+# Word — Windows (Interop) API
+
+Full-featured API using `word.UseWordDocument(...)` returning `IWordDocument`. Uses COM interop. For general info see [word.md](word.md).
+
+---
+
+## Opening Word Documents
+
+### `word.UseWordDocument(string path)`
+
+Opens a Word document with default options (create if not exists = true, auto-save = true).
+Returns `IWordDocument` (disposable — use with `using`).
+
+```csharp
+using var doc = word.UseWordDocument("report.docx");
+```
+
+### `word.UseWordDocument(WordUseOptions options)`
+
+Full control over how the document is opened.
+
+```csharp
+using var doc = word.UseWordDocument(new WordUseOptions
+{
+    Path = "report.docx",
+    CreateIfNotExist = true,
+    ReadOnly = false,
+    AutoSave = true,
+    SensitivityOperation = WordLabelOperation.None,
+    SensitivityLabel = null
+});
+```
+
+#### `WordUseOptions` Properties
+
+| Property | Type | Default | Description |
+|---|---|---|---|
+| `Path` | `string` | — | Path of the Word file |
+| `CreateIfNotExist` | `bool` | `true` | Create the file if it does not exist |
+| `ReadOnly` | `bool` | `false` | Open the document read-only |
+| `AutoSave` | `bool` | `true` | Save changes when done |
+| `SensitivityOperation` | `WordLabelOperation` | `None` | Sensitivity label operation (`None`, `Add`, `Clear`) |
+| `SensitivityLabel` | `IWordLabelObject` | `null` | Sensitivity label to apply (used when `SensitivityOperation` is `Add`) |
+
+---
+
+## Text Operations
+
+### AppendText
+
+Writes text in the Word document at the current caret's position.
+
+```csharp
+void AppendText(this IWordDocument wordDocument, string text, bool addNewLineBeforeText = true);
+```
+
+| Parameter | Type | Default | Description |
+|---|---|---|---|
+| `text` | `string` | — | Text to be written |
+| `addNewLineBeforeText` | `bool` | `true` | Insert a line break after the existing text before appending |
+
+```csharp
+doc.AppendText("First paragraph.");
+doc.AppendText("Second paragraph on a new line.", true);
+doc.AppendText(" Appended inline.", false);
+```
+
+### ReadText
+
+Reads all text from a Word document.
+
+```csharp
+string ReadText(this IWordDocument wordDocument);
+```
+
+Returns the full text content of the document.
+
+```csharp
+string content = doc.ReadText();
+Log($"Document has {content.Length} characters.");
+```
+
+### ReplaceTextInDocument
+
+Replaces occurrences of a text string within a Word document.
+
+```csharp
+bool ReplaceTextInDocument(this IWordDocument wordDocument, string searchFor, string replaceWith, bool replaceAll = true);
+```
+
+| Parameter | Type | Default | Description |
+|---|---|---|---|
+| `searchFor` | `string` | — | Text to find (max 256 characters) |
+| `replaceWith` | `string` | — | Replacement text (max 255 characters) |
+| `replaceAll` | `bool` | `true` | If `true`, replace all occurrences; if `false`, only the first |
+
+Returns `true` if the operation was successful.
+
+```csharp
+bool found = doc.ReplaceTextInDocument("{{CustomerName}}", "Acme Corp");
+bool first = doc.ReplaceTextInDocument("old text", "new text", replaceAll: false);
+```
+
+---
+
+## Bookmark Operations
+
+### SetBookmarkContent
+
+Sets the text content of a named bookmark in the document.
+
+```csharp
+void SetBookmarkContent(this IWordDocument wordDocument, string bookmarkName, string bookmarkText);
+```
+
+| Parameter | Type | Description |
+|---|---|---|
+| `bookmarkName` | `string` | Bookmark name as defined in the document |
+| `bookmarkText` | `string` | Text to set inside the bookmark |
+
+```csharp
+doc.SetBookmarkContent("CompanyName", "Acme Corp");
+doc.SetBookmarkContent("InvoiceDate", DateTime.Now.ToString("yyyy-MM-dd"));
+```
+
+---
+
+## Hyperlink Operations
+
+### AddHyperlinkToDocument
+
+Adds a hyperlink to a Word document. Multiple overloads for different positioning strategies.
+
+#### At end of document (default)
+
+```csharp
+bool AddHyperlinkToDocument(this IWordDocument wordDocument, string textToDisplay, string address);
+```
+
+```csharp
+doc.AddHyperlinkToDocument("Visit UiPath", "https://uipath.com");
+```
+
+#### At start or end of document
+
+```csharp
+bool AddHyperlinkToDocument(this IWordDocument wordDocument, string textToDisplay, string address, Position positionWhereToInsert);
+```
+
+```csharp
+doc.AddHyperlinkToDocument("Visit UiPath", "https://uipath.com", Position.Start);
+```
+
+#### Relative to a text
+
+```csharp
+bool AddHyperlinkToDocument(this IWordDocument wordDocument, string textToDisplay, string address, Position positionWhereToInsert, string textToSearchFor);
+```
+
+```csharp
+doc.AddHyperlinkToDocument("Click here", "https://uipath.com", Position.After, "For more info");
+```
+
+#### Full control
+
+```csharp
+bool AddHyperlinkToDocument(this IWordDocument wordDocument, string textToDisplay, string address, InsertHyperlinkRelativeToType insertRelativeTo, Position positionWhereToInsert, string textToSearchFor);
+```
+
+| Parameter | Type | Description |
+|---|---|---|
+| `textToDisplay` | `string` | Display text for the hyperlink |
+| `address` | `string` | URL/address of the hyperlink |
+| `insertRelativeTo` | `InsertHyperlinkRelativeToType` | `Document` or `Text` |
+| `positionWhereToInsert` | `Position` | Where to insert (`Start`, `End`, `Before`, `After`, `Replace`) |
+| `textToSearchFor` | `string` | Text relative to which to insert (when `insertRelativeTo` is `Text`) |
+
+Returns `true` if successful.
+
+---
+
+## Picture Operations
+
+### AddPicture
+
+Adds a picture to a Word document. Multiple overloads for different positioning strategies.
+
+#### At end of document (default)
+
+```csharp
+void AddPicture(this IWordDocument wordDocument, string pictureToInsert);
+```
+
+```csharp
+doc.AddPicture(@"C:\Images\logo.png");
+```
+
+#### At start or end of document
+
+```csharp
+void AddPicture(this IWordDocument wordDocument, string pictureToInsert, Position positionWhereToInsert);
+```
+
+```csharp
+doc.AddPicture(@"C:\Images\header.png", Position.Start);
+```
+
+#### Relative to a bookmark
+
+```csharp
+void AddPicture(this IWordDocument wordDocument, string pictureToInsert, string bookmarkToSearchFor, Position positionWhereToInsert);
+```
+
+| Parameter | Type | Description |
+|---|---|---|
+| `bookmarkToSearchFor` | `string` | Bookmark name relative to which to insert |
+| `positionWhereToInsert` | `Position` | `Before`, `After`, or `Replace` (replaces the bookmark with the image) |
+
+```csharp
+doc.AddPicture(@"C:\Images\signature.png", "SignatureBookmark", Position.Replace);
+```
+
+#### Relative to text
+
+```csharp
+void AddPicture(this IWordDocument wordDocument, string pictureToInsert, string textToSearchFor, Occurrence textOccurrence, int? occurenceIndex, Position positionWhereToInsert);
+```
+
+| Parameter | Type | Description |
+|---|---|---|
+| `textToSearchFor` | `string` | Text relative to which to insert the image |
+| `textOccurrence` | `Occurrence` | `All`, `First`, `Last`, or `Specific` |
+| `occurenceIndex` | `int?` | Index when `textOccurrence` is `Specific` |
+| `positionWhereToInsert` | `Position` | `Before`, `After`, or `Replace` |
+
+```csharp
+doc.AddPicture(@"C:\Images\chart.png", "Insert chart here", Occurrence.First, null, Position.Replace);
+```
+
+### ReplacePicture
+
+Replaces pictures in a Word document based on their Alt Text.
+
+```csharp
+void ReplacePicture(this IWordDocument wordDocument, string findPicturesWithAltText, string replaceWithPicture);
+```
+
+| Parameter | Type | Description |
+|---|---|---|
+| `findPicturesWithAltText` | `string` | Alt Text of the picture(s) to replace |
+| `replaceWithPicture` | `string` | File path of the replacement image |
+
+```csharp
+doc.ReplacePicture("company_logo", @"C:\Images\new_logo.png");
+```
+
+---
+
+## DataTable Operations
+
+### InsertDataTableInDocument
+
+Inserts a DataTable into a Word document. Multiple overloads for different positioning strategies.
+
+#### At end of document (default)
+
+```csharp
+void InsertDataTableInDocument(this IWordDocument wordDocument, DataTable tableToInsert);
+```
+
+```csharp
+doc.InsertDataTableInDocument(dataTable);
+```
+
+#### At start or end of document
+
+```csharp
+void InsertDataTableInDocument(this IWordDocument wordDocument, DataTable tableToInsert, Position positionWhereToInsert);
+```
+
+```csharp
+doc.InsertDataTableInDocument(dataTable, Position.End);
+```
+
+#### Relative to a bookmark
+
+```csharp
+void InsertDataTableInDocument(this IWordDocument wordDocument, DataTable tableToInsert, string bookmarkToSearchFor, Position positionWhereToInsert);
+```
+
+```csharp
+doc.InsertDataTableInDocument(dataTable, "TablePlaceholder", Position.Replace);
+```
+
+#### Relative to text
+
+```csharp
+void InsertDataTableInDocument(this IWordDocument wordDocument, DataTable tableToInsert, string textToSearchFor, Occurrence textOccurrence, int? occurenceIndex, Position positionWhereToInsert);
+```
+
+| Parameter | Type | Description |
+|---|---|---|
+| `tableToInsert` | `DataTable` | The DataTable to insert |
+| `textToSearchFor` | `string` | Text relative to which to insert |
+| `textOccurrence` | `Occurrence` | `All`, `First`, `Last`, or `Specific` |
+| `occurenceIndex` | `int?` | Index when `textOccurrence` is `Specific` |
+| `positionWhereToInsert` | `Position` | `Before`, `After`, or `Replace` |
+
+```csharp
+doc.InsertDataTableInDocument(dataTable, "Items", Occurrence.First, null, Position.After);
+```
+
+---
+
+## Clipboard Operations
+
+### PasteChartPictureIntoDocument
+
+Pastes a chart or image from the clipboard into a Word document.
+
+```csharp
+bool PasteChartPictureIntoDocument(this IWordDocument wordDocument, PasteRelativeToType pasteRelativeTo, Position positionWhereToPaste, string textToSearchFor, PasteOptionType pasteOption);
+```
+
+| Parameter | Type | Description |
+|---|---|---|
+| `pasteRelativeTo` | `PasteRelativeToType` | `Document` or `Text` |
+| `positionWhereToPaste` | `Position` | Position relative to target |
+| `textToSearchFor` | `string` | Text relative to which to paste (when `pasteRelativeTo` is `Text`) |
+| `pasteOption` | `PasteOptionType` | `EmbedData`, `LinkData`, or `Picture` |
+
+Returns `true` if the paste was successful.
+
+```csharp
+// Paste at end of document as embedded data
+doc.PasteChartPictureIntoDocument(PasteRelativeToType.Document, Position.End, null, PasteOptionType.EmbedData);
+
+// Paste after specific text as picture
+doc.PasteChartPictureIntoDocument(PasteRelativeToType.Text, Position.After, "Chart placeholder", PasteOptionType.Picture);
+```
+
+---
+
+## Save and Export
+
+### SaveDocumentAs
+
+Saves a Word document in a different format.
+
+```csharp
+void SaveDocumentAs(this IWordDocument wordDocument, WordSaveAsType saveAsType, string saveAsFile, bool replaceExisting = true);
+```
+
+| Parameter | Type | Default | Description |
+|---|---|---|---|
+| `saveAsType` | `WordSaveAsType` | — | Target format |
+| `saveAsFile` | `string` | — | Full path for the new file |
+| `replaceExisting` | `bool` | `true` | Replace existing file of the same name |
+
+**`WordSaveAsType` values:**
+
+| Value | Format |
+|---|---|
+| `XmlDocument` | .docx |
+| `MacroEnabledDocument` | .docm |
+| `OldDocument` | .doc |
+| `WebPage` | .html |
+| `FilteredWebPage` | .html (filtered) |
+| `RichText` | .rtf |
+| `PlainText` | .txt |
+
+```csharp
+doc.SaveDocumentAs(WordSaveAsType.XmlDocument, @"C:\Output\report_copy.docx");
+doc.SaveDocumentAs(WordSaveAsType.RichText, @"C:\Output\report.rtf");
+```
+
+### SaveAsPDF
+
+Exports a Word document to PDF.
+
+```csharp
+void SaveAsPDF(this IWordDocument wordDocument, string filePathToSaveAs, bool replaceExisting = true);
+```
+
+| Parameter | Type | Default | Description |
+|---|---|---|---|
+| `filePathToSaveAs` | `string` | — | PDF output file path |
+| `replaceExisting` | `bool` | `true` | Replace existing file of the same name |
+
+```csharp
+doc.SaveAsPDF(@"C:\Output\report.pdf");
+```
+
+---
+
+## Sensitivity Labels
+
+### AddSensitivityLabel
+
+Adds a sensitivity label to the document.
+
+```csharp
+void AddSensitivityLabel(this IWordDocument handle, IWordLabelObject label);
+```
+
+| Parameter | Type | Description |
+|---|---|---|
+| `label` | `IWordLabelObject` | Label object with at least `LabelId` set |
+
+**`IWordLabelObject` properties:**
+
+| Property | Type | Description |
+|---|---|---|
+| `LabelId` | `string` | Sensitivity label ID (required) |
+| `Justification` | `string` | Justification for changing the label |
+
+### GetSensitivityLabel
+
+Retrieves the sensitivity label from a document.
+
+```csharp
+IWordLabelObject GetSensitivityLabel(this IWordDocument handle);
+```
+
+Returns an `IWordLabelObject` with the document's current sensitivity label.
+
+```csharp
+IWordLabelObject label = doc.GetSensitivityLabel();
+if (label != null)
+{
+    Log($"Label ID: {label.LabelId}");
+}
+```

package/skills/uipath-rpa/references/activity-docs/UiPath.Word.Activities/2.5/coded/word.md

@@ -0,0 +1,47 @@
+# Word Activities API Reference
+
+Reference for the `word` service from `UiPath.Word.Activities` package.
+
+**Required package:** `"UiPath.Word.Activities": "[2.3.1]"`
+
+**Auto-imported namespaces:** `System`, `System.Collections.Generic`, `System.Data`, `UiPath.Word`, `UiPath.Word.Activities`, `UiPath.Word.Activities.API`, `UiPath.Word.Activities.API.Models`
+
+**Service accessor:** `word` (type `IWordService`)
+
+---
+
+## Two API Layers
+
+The Word API has two layers:
+
+1. **Windows (Interop) API** — uses `word.UseWordDocument(...)` returning `IWordDocument`. Full-featured API that opens Word via COM interop. Supports hyperlinks, pictures, DataTables, bookmarks, clipboard paste, save-as, PDF export, sensitivity labels, and more. See [windows-api.md](windows-api.md).
+
+2. **Portable API** — uses `word.UseDocument(...)` returning `IWordDocumentHandle`. Lightweight cross-platform API using Xceed. Supports basic append text, read text, and replace text. See [portable-api.md](portable-api.md).
+
+**Always prefer the Windows API (`UseWordDocument`) unless cross-platform compatibility is required.**
+
+For full coded workflow examples, see [examples.md](examples.md).
+
+---
+
+## Key Enum Reference
+
+| Enum | Values |
+|---|---|
+| `Position` | `Start`, `End`, `Before`, `After`, `Replace` |
+| `Occurrence` | `All`, `First`, `Last`, `Specific` |
+| `InsertRelativeType` | `Document`, `Bookmark`, `Text` |
+| `InsertHyperlinkRelativeToType` | `Document`, `Text` |
+| `PasteRelativeToType` | `Document`, `Text` |
+| `PasteOptionType` | `EmbedData`, `LinkData`, `Picture` |
+| `WordSaveAsType` | `XmlDocument` (.docx), `MacroEnabledDocument` (.docm), `OldDocument` (.doc), `WebPage`, `FilteredWebPage`, `RichText` (.rtf), `PlainText` (.txt) |
+| `WordLabelOperation` | `None`, `Add`, `Clear` |
+
+## Key Types
+
+| Type | Description |
+|---|---|
+| `IWordDocument` | Disposable handle for Windows interop documents. Returned by `UseWordDocument`. Use with `using`. |
+| `IWordDocumentHandle` | Disposable handle for portable (Xceed) documents. Returned by `UseDocument`. Use with `using`. |
+| `WordUseOptions` | Options for opening/creating Word documents (Windows API). See [windows-api.md](windows-api.md). |
+| `IWordLabelObject` | Sensitivity label with `LabelId` (`string`) and `Justification` (`string`) properties. |

package/skills/uipath-rpa/references/activity-docs/UiPath.Word.Activities/2.6/activities/AddComment.md

@@ -0,0 +1,148 @@
+# Add Comment
+
+`UiPath.Word.Activities.DocumentAddComment` (cross-platform)
+`UiPath.Word.Activities.WordAddComment` (Windows)
+
+Adds a comment to a Word document anchored to a text match, a named bookmark, or (Windows only) a tracked change revision.
+
+**Package:** `UiPath.Word.Activities`
+**Category:** Word
+
+## Properties
+
+### Cross-Platform (`DocumentAddComment`)
+
+#### Input
+
+| Name | Display Name | Kind | Type | Required | Default | Description |
+|------|-------------|------|------|----------|---------|-------------|
+| `FilePath` | File path | InArgument | `string` | Conditional | | Full path to the Word document file |
+| `PathResource` | File | InArgument | `IResource` | Conditional | | A file resource reference to the Word document |
+| `CommentText` | Comment | InArgument | `string` | Yes | | The text content of the comment. |
+
+Mutually exclusive — provide exactly one of `FilePath` or `PathResource` (see Valid Configurations).
+
+#### Options
+
+| Name | Display Name | Kind | Type | Required | Default | Description |
+|------|-------------|------|------|----------|---------|-------------|
+| `AnchorType` | Search by | Property | `CommentAnchorType` | No | `Text` | The type of anchor for the comment. Cross-platform supports `Text` and `Bookmark` only. |
+| `AnchorText` | Text to comment | InArgument | `string` | Conditional | | The text to search for in the document. The comment will be anchored to this text. Required when anchor type is Text. |
+| `Bookmark` | Bookmark | InArgument | `string` | Conditional | | The name of the bookmark to anchor the comment to. Required when anchor type is Bookmark. |
+| `OccurrenceIndex` | Occurrence index | InArgument | `int?` | No | `1` | The occurrence of the anchor text to target. Default is 1 (first occurrence). |
+| `Author` | Author | InArgument | `string` | No | | The author name for the comment. If not specified, uses the current system user (cross-platform). |
+
+### Windows (`WordAddComment`)
+
+**Required Scope:** `WordApplicationScope`
+
+#### Input
+
+| Name | Display Name | Kind | Type | Required | Default | Description |
+|------|-------------|------|------|----------|---------|-------------|
+| `CommentText` | Comment | InArgument | `string` | Yes | | The text content of the comment. |
+
+#### Options
+
+| Name | Display Name | Kind | Type | Required | Default | Description |
+|------|-------------|------|------|----------|---------|-------------|
+| `AnchorType` | Search by | Property | `CommentAnchorType` | No | `Text` | The type of anchor for the comment. Text anchors to a text match; Bookmark anchors to a named bookmark; Revision anchors to a tracked change. |
+| `AnchorText` | Text to comment | InArgument | `string` | Conditional | | The text to search for in the document. Required when anchor type is Text. |
+| `AnchorRevision` | Text to search in revisions | InArgument | `string` | Conditional | | The text to search for in the document's revisions. The comment will be anchored to this text. Required when anchor type is Revision. Windows only. |
+| `Bookmark` | Bookmark | InArgument | `string` | Conditional | | The name of the bookmark to anchor the comment to. Required when anchor type is Bookmark. |
+| `OccurrenceIndex` | Occurrence index | InArgument | `int?` | No | `1` | The occurrence of the anchor text or revision text to target. Default is 1 (first occurrence). |
+| `Author` | Author | InArgument | `string` | No | | The author name for the comment. If not specified, uses the current Word user. |
+
+#### CommentAnchorType Enum Values
+
+| Value | Platforms | Description |
+|-------|-----------|-------------|
+| `Text` | Both | Anchor the comment to a text match in the document. |
+| `Bookmark` | Both | Anchor the comment to a named bookmark in the document. |
+| `Revision` | Windows only | Anchor the comment to a tracked change (revision) in the document. |
+
+## Valid Configurations
+
+**Cross-platform document input:** Supports two input modes (mutually exclusive via OverloadGroups):
+
+**Mode A — Local Path**: Set `FilePath` to the document path.
+**Mode B — Resource**: Set `PathResource` to a file resource reference.
+
+Only one of `FilePath` or `PathResource` should be set.
+
+**Anchor type selection (both platforms):**
+
+| Anchor Type | Required Property | Optional Properties | Leave Empty |
+|-------------|-------------------|---------------------|-------------|
+| Text (default) | `AnchorText` | `OccurrenceIndex` | `Bookmark`, `AnchorRevision` |
+| Bookmark | `Bookmark` | | `AnchorText`, `OccurrenceIndex`, `AnchorRevision` |
+| Revision (Windows only) | `AnchorRevision` | `OccurrenceIndex` | `AnchorText`, `Bookmark` |
+
+## XAML Example
+
+**Cross-platform — anchor to text:**
+
+```xml
+<ui:DocumentAddComment
+    DisplayName="Add Comment"
+    FilePath="[documentPath]"
+    AnchorType="Text"
+    AnchorText="[textToComment]"
+    OccurrenceIndex="1"
+    CommentText="[commentText]"
+    Author="[authorName]" />
+```
+
+**Cross-platform — anchor to bookmark:**
+
+```xml
+<ui:DocumentAddComment
+    DisplayName="Add Comment"
+    FilePath="[documentPath]"
+    AnchorType="Bookmark"
+    Bookmark="[bookmarkName]"
+    CommentText="[commentText]" />
+```
+
+**Windows — anchor to text (inside Word Application Scope):**
+
+```xml
+<ui:WordAddComment
+    DisplayName="Add Comment"
+    AnchorType="Text"
+    AnchorText="[textToComment]"
+    OccurrenceIndex="1"
+    CommentText="[commentText]"
+    Author="[authorName]" />
+```
+
+**Windows — anchor to bookmark:**
+
+```xml
+<ui:WordAddComment
+    DisplayName="Add Comment"
+    AnchorType="Bookmark"
+    Bookmark="[bookmarkName]"
+    CommentText="[commentText]" />
+```
+
+**Windows — anchor to a tracked change revision:**
+
+```xml
+<ui:WordAddComment
+    DisplayName="Add Comment"
+    AnchorType="Revision"
+    AnchorRevision="[revisedText]"
+    OccurrenceIndex="1"
+    CommentText="[commentText]"
+    Author="[authorName]" />
+```
+
+## Notes
+
+- **Windows — Revision anchor:** Uses the separate `AnchorRevision` property (not `AnchorText`) to search within tracked changes. Matches revision text via case-sensitive substring search.
+- **Cross-platform:** Supports `Text` and `Bookmark` anchor types only. Setting `AnchorType` to `Revision` throws an exception.
+- `OccurrenceIndex` is 1-based. Defaults to 1 (first occurrence). Values less than 1 throw an exception.
+- `Author` defaults to the current Word user on Windows, or the current system user (`Environment.UserName`) on cross-platform.
+- Must be placed inside a **Word Application Scope** when using the Windows variant.
+- The cross-platform variant works on both Windows and Linux robots without requiring Microsoft Word to be installed.

package/skills/uipath-rpa/references/activity-docs/UiPath.Word.Activities/2.6/activities/DisableTrackChanges.md

@@ -0,0 +1,79 @@
+# Disable Track Changes
+
+`UiPath.Word.Activities.DocumentDisableTrackChanges` (cross-platform)
+`UiPath.Word.Activities.WordDisableTrackChanges` (Windows)
+
+Disables track changes on a Word document. New edits will no longer be tracked as revisions.
+
+**Package:** `UiPath.Word.Activities`
+**Category:** Word
+
+## Availability
+
+| Platform | Activity | Available |
+|----------|----------|-----------|
+| Windows | `WordDisableTrackChanges` | Yes |
+| Cross-platform | `DocumentDisableTrackChanges` | No (hidden — `browsable: false`) |
+
+The cross-platform variant is implemented but not yet exposed in UiPath Studio. It is hidden from the activity panel via `browsable: false` in the portable metadata. Only the Windows variant is available for use at this time.
+
+## Properties
+
+### Cross-Platform (`DocumentDisableTrackChanges`)
+
+#### Input
+
+| Name | Display Name | Kind | Type | Required | Default | Description |
+|------|-------------|------|------|----------|---------|-------------|
+| `FilePath` | File path | InArgument | `string` | Conditional | | Full path to the Word document file |
+| `PathResource` | File | InArgument | `IResource` | Conditional | | A file resource reference to the Word document |
+
+Mutually exclusive — provide exactly one (see Valid Configurations).
+
+No additional properties. Cross-platform simply removes tracking from the document settings.
+
+### Windows (`WordDisableTrackChanges`)
+
+**Required Scope:** `WordApplicationScope`
+
+#### Options
+
+| Name | Display Name | Kind | Type | Required | Default | Description |
+|------|-------------|------|------|----------|---------|-------------|
+| `Password` | Password | InArgument | `string` | No | | Password required to unprotect a document that was protected with TrackForEveryone. If the document is not protected, this property is ignored. |
+
+## Valid Configurations
+
+**Cross-platform:** Supports two input modes (mutually exclusive via OverloadGroups):
+
+**Mode A — Local Path**: Set `FilePath` to the document path.
+**Mode B — Resource**: Set `PathResource` to a file resource reference.
+
+Only one of `FilePath` or `PathResource` should be set.
+
+**Windows:** No mutually exclusive groups. `Password` is an independent optional property.
+
+## XAML Example
+
+**Cross-platform:**
+
+```xml
+<ui:DocumentDisableTrackChanges
+    DisplayName="Disable Track Changes"
+    FilePath="[documentPath]" />
+```
+
+**Windows (inside Word Application Scope):**
+
+```xml
+<ui:WordDisableTrackChanges
+    DisplayName="Disable Track Changes"
+    Password="[optionalPassword]" />
+```
+
+## Notes
+
+- **Windows:** If the document was protected with a password via Enable Track Changes (`TrackForEveryone`), provide the same password in `Password` to unprotect and disable tracking. Throws an exception if the document is protected and no password (or an incorrect password) is provided.
+- **Cross-platform:** Removes the `<w:trackRevisions>` element from the document's internal `settings.xml`. No password support.
+- Must be placed inside a **Word Application Scope** when using the Windows variant.
+- The cross-platform variant works on both Windows and Linux robots without requiring Microsoft Word to be installed.