Add duplicate mapping for a FileProperties sample (#2296)

Author: AlexJerabek

docs/code-snippets/office-snippets.yaml

@@ -4033,6 +4033,26 @@ Office.File#getSliceAsync:member(1):
             });
         }
     }
+Office.FileProperties:interface:
+  - |-
+    // To read the URL of the current file, you need to write a callback function that returns the URL.
+    // The following example shows how to:
+    // 1. Pass an anonymous callback function that returns the value of the file's URL
+    //    to the callback parameter of the getFilePropertiesAsync method.
+    // 2. Display the value on the add-in's page.
+    function getFileUrl() {
+        // Get the URL of the current file.
+        Office.context.document.getFilePropertiesAsync(function (asyncResult) {
+            const fileProperties: Office.FileProperties = asyncResult.value;
+            const fileUrl = fileProperties.url;
+            if (fileUrl == "") {
+                showMessage("The file hasn't been saved yet. Save the file and try again");
+            }
+            else {
+                showMessage(fileUrl);
+            }
+        });
+    }
 Office.HostType:enum:
   - |-
     const contextInfo = Office.context.diagnostics;

docs/docs-ref-autogen/office/office/office.addincommands.event.yml

@@ -338,16 +338,29 @@ methods:
       -->**: Compose or Read
 
 
-      **Important**: The `options` parameter only applies to Outlook
-      add-ins. It was introduced in Mailbox 1.8. Although Outlook on Android and
-      on iOS support up to Mailbox 1.5, the `options` parameter is supported in
-      online-meeting provider and note-logging mobile add-ins. For more
-      information on API support in Outlook on mobile devices, see [Outlook
-      JavaScript APIs supported in Outlook on mobile
+      **Important**:
+
+
+      - The `options` parameter only applies to Outlook add-ins. It was
+      introduced in Mailbox 1.8. Although Outlook on Android and on iOS support
+      up to Mailbox 1.5, the `options` parameter is supported in online-meeting
+      provider and note-logging mobile add-ins. For more information on API
+      support in Outlook on mobile devices, see [Outlook JavaScript APIs
+      supported in Outlook on mobile
       devices](https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-mobile-apis)<!--
       -->.
 
 
+      - [Event-based
+      activation](https://learn.microsoft.com/office/dev/add-ins/outlook/autolaunch)
+      and [integrated
+      spam-reporting](https://learn.microsoft.com/office/dev/add-ins/outlook/spam-reporting)
+      add-ins use a different event object to signal when they've completed
+      processing an event. For more information, see
+      [Office.MailboxEvent](https://learn.microsoft.com/javascript/api/outlook/office.mailboxevent)<!--
+      -->.
+
+
       #### Examples
 
 

docs/docs-ref-autogen/office/office/office.addincommands.eventcompletedoptions.yml

@@ -26,14 +26,26 @@ remarks: >-
   -->**: Compose
 
 
-  **Important**: Although Outlook on Android and on iOS support up to
-  Mailbox 1.5, the `EventCompletedOptions` object is supported in online-meeting
-  provider and note-logging mobile add-ins. For more information on API support
-  in Outlook on mobile devices, see [Outlook JavaScript APIs supported in
-  Outlook on mobile
+  **Important**:
+
+
+  - Although Outlook on Android and on iOS support up to Mailbox 1.5, the
+  `EventCompletedOptions` object is supported in online-meeting provider and
+  note-logging mobile add-ins. For more information on API support in Outlook on
+  mobile devices, see [Outlook JavaScript APIs supported in Outlook on mobile
   devices](https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-mobile-apis)<!--
   -->.
 
+
+  - [Event-based
+  activation](https://learn.microsoft.com/office/dev/add-ins/outlook/autolaunch)
+  and [integrated
+  spam-reporting](https://learn.microsoft.com/office/dev/add-ins/outlook/spam-reporting)
+  add-ins use a different event object to signal when they've completed
+  processing an event. For more information, see
+  [Office.MailboxEvent](https://learn.microsoft.com/javascript/api/outlook/office.mailboxevent)<!--
+  -->.
+
 isPreview: false
 isDeprecated: false
 type: interface

docs/docs-ref-autogen/office/office/office.fileproperties.yml

@@ -4,7 +4,41 @@ uid: office!Office.FileProperties:interface
 package: office!
 fullName: Office.FileProperties
 summary: ''
-remarks: ''
+remarks: >-
+
+
+  #### Examples
+
+
+  ```TypeScript
+
+  // To read the URL of the current file, you need to write a callback function
+  that returns the URL.
+
+  // The following example shows how to:
+
+  // 1. Pass an anonymous callback function that returns the value of the file's
+  URL
+
+  //    to the callback parameter of the getFilePropertiesAsync method.
+
+  // 2. Display the value on the add-in's page.
+
+  function getFileUrl() {
+      // Get the URL of the current file.
+      Office.context.document.getFilePropertiesAsync(function (asyncResult) {
+          const fileProperties: Office.FileProperties = asyncResult.value;
+          const fileUrl = fileProperties.url;
+          if (fileUrl == "") {
+              showMessage("The file hasn't been saved yet. Save the file and try again");
+          }
+          else {
+              showMessage(fileUrl);
+          }
+      });
+  }
+
+  ```
 
 isPreview: false
 isDeprecated: false

docs/docs-ref-autogen/office_release/office/office.addincommands.event.yml

@@ -333,16 +333,29 @@ methods:
       -->**: Compose or Read
 
 
-      **Important**: The `options` parameter only applies to Outlook
-      add-ins. It was introduced in Mailbox 1.8. Although Outlook on Android and
-      on iOS support up to Mailbox 1.5, the `options` parameter is supported in
-      online-meeting provider and note-logging mobile add-ins. For more
-      information on API support in Outlook on mobile devices, see [Outlook
-      JavaScript APIs supported in Outlook on mobile
+      **Important**:
+
+
+      - The `options` parameter only applies to Outlook add-ins. It was
+      introduced in Mailbox 1.8. Although Outlook on Android and on iOS support
+      up to Mailbox 1.5, the `options` parameter is supported in online-meeting
+      provider and note-logging mobile add-ins. For more information on API
+      support in Outlook on mobile devices, see [Outlook JavaScript APIs
+      supported in Outlook on mobile
       devices](https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-mobile-apis)<!--
       -->.
 
 
+      - [Event-based
+      activation](https://learn.microsoft.com/office/dev/add-ins/outlook/autolaunch)
+      and [integrated
+      spam-reporting](https://learn.microsoft.com/office/dev/add-ins/outlook/spam-reporting)
+      add-ins use a different event object to signal when they've completed
+      processing an event. For more information, see
+      [Office.MailboxEvent](https://learn.microsoft.com/javascript/api/outlook/office.mailboxevent)<!--
+      -->.
+
+
       #### Examples
 
 

docs/docs-ref-autogen/office_release/office/office.addincommands.eventcompletedoptions.yml

@@ -26,14 +26,26 @@ remarks: >-
   -->**: Compose
 
 
-  **Important**: Although Outlook on Android and on iOS support up to
-  Mailbox 1.5, the `EventCompletedOptions` object is supported in online-meeting
-  provider and note-logging mobile add-ins. For more information on API support
-  in Outlook on mobile devices, see [Outlook JavaScript APIs supported in
-  Outlook on mobile
+  **Important**:
+
+
+  - Although Outlook on Android and on iOS support up to Mailbox 1.5, the
+  `EventCompletedOptions` object is supported in online-meeting provider and
+  note-logging mobile add-ins. For more information on API support in Outlook on
+  mobile devices, see [Outlook JavaScript APIs supported in Outlook on mobile
   devices](https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-mobile-apis)<!--
   -->.
 
+
+  - [Event-based
+  activation](https://learn.microsoft.com/office/dev/add-ins/outlook/autolaunch)
+  and [integrated
+  spam-reporting](https://learn.microsoft.com/office/dev/add-ins/outlook/spam-reporting)
+  add-ins use a different event object to signal when they've completed
+  processing an event. For more information, see
+  [Office.MailboxEvent](https://learn.microsoft.com/javascript/api/outlook/office.mailboxevent)<!--
+  -->.
+
 isPreview: false
 isDeprecated: false
 type: interface

docs/docs-ref-autogen/office_release/office/office.fileproperties.yml

@@ -4,7 +4,41 @@ uid: office!Office.FileProperties:interface
 package: office!
 fullName: Office.FileProperties
 summary: ''
-remarks: ''
+remarks: >-
+
+
+  #### Examples
+
+
+  ```TypeScript
+
+  // To read the URL of the current file, you need to write a callback function
+  that returns the URL.
+
+  // The following example shows how to:
+
+  // 1. Pass an anonymous callback function that returns the value of the file's
+  URL
+
+  //    to the callback parameter of the getFilePropertiesAsync method.
+
+  // 2. Display the value on the add-in's page.
+
+  function getFileUrl() {
+      // Get the URL of the current file.
+      Office.context.document.getFilePropertiesAsync(function (asyncResult) {
+          const fileProperties: Office.FileProperties = asyncResult.value;
+          const fileUrl = fileProperties.url;
+          if (fileUrl == "") {
+              showMessage("The file hasn't been saved yet. Save the file and try again");
+          }
+          else {
+              showMessage(fileUrl);
+          }
+      });
+  }
+
+  ```
 
 isPreview: false
 isDeprecated: false

docs/docs-ref-autogen/outlook/outlook/office.mailboxevent.yml

@@ -29,8 +29,24 @@ remarks: >-
   -->**: Compose or Read
 
 
-  **Important**: Support for the integrated spam-reporting feature was
-  introduced in Mailbox 1.14.
+  **Important**:
+
+
+  - Support for the integrated spam-reporting feature was introduced in Mailbox
+  1.14.
+
+
+  - For information about the Event object used by the [function command
+  button](https://learn.microsoft.com/office/dev/add-ins/design/add-in-commands)<!--
+  -->, [on-send
+  add-in](https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-on-send-addins)<!--
+  -->, [online-meeting provider
+  add-in](https://learn.microsoft.com/office/dev/add-ins/outlook/online-meeting)<!--
+  -->, and [note-logging mobile
+  add-in](https://learn.microsoft.com/office/dev/add-ins/outlook/mobile-log-appointments)<!--
+  -->, see
+  [Office.AddinCommands.Event](https://learn.microsoft.com/javascript/api/office/office.addincommands.event)<!--
+  -->.
 
 isPreview: false
 isDeprecated: false

docs/docs-ref-autogen/outlook_1_10/outlook/office.mailboxevent.yml

@@ -29,8 +29,24 @@ remarks: >-
   -->**: Compose or Read
 
 
-  **Important**: Support for the integrated spam-reporting feature was
-  introduced in Mailbox 1.14.
+  **Important**:
+
+
+  - Support for the integrated spam-reporting feature was introduced in Mailbox
+  1.14.
+
+
+  - For information about the Event object used by the [function command
+  button](https://learn.microsoft.com/office/dev/add-ins/design/add-in-commands)<!--
+  -->, [on-send
+  add-in](https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-on-send-addins)<!--
+  -->, [online-meeting provider
+  add-in](https://learn.microsoft.com/office/dev/add-ins/outlook/online-meeting)<!--
+  -->, and [note-logging mobile
+  add-in](https://learn.microsoft.com/office/dev/add-ins/outlook/mobile-log-appointments)<!--
+  -->, see
+  [Office.AddinCommands.Event](https://learn.microsoft.com/javascript/api/office/office.addincommands.event)<!--
+  -->.
 
 isPreview: false
 isDeprecated: false

docs/docs-ref-autogen/outlook_1_11/outlook/office.mailboxevent.yml

@@ -29,8 +29,24 @@ remarks: >-
   -->**: Compose or Read
 
 
-  **Important**: Support for the integrated spam-reporting feature was
-  introduced in Mailbox 1.14.
+  **Important**:
+
+
+  - Support for the integrated spam-reporting feature was introduced in Mailbox
+  1.14.
+
+
+  - For information about the Event object used by the [function command
+  button](https://learn.microsoft.com/office/dev/add-ins/design/add-in-commands)<!--
+  -->, [on-send
+  add-in](https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-on-send-addins)<!--
+  -->, [online-meeting provider
+  add-in](https://learn.microsoft.com/office/dev/add-ins/outlook/online-meeting)<!--
+  -->, and [note-logging mobile
+  add-in](https://learn.microsoft.com/office/dev/add-ins/outlook/mobile-log-appointments)<!--
+  -->, see
+  [Office.AddinCommands.Event](https://learn.microsoft.com/javascript/api/office/office.addincommands.event)<!--
+  -->.
 
 isPreview: false
 isDeprecated: false