[Outlook] Publish Mailbox 1.15 (#2165)

* Draft Mailbox 1.15 documentation

* Fix link

* Add build files

* Remove preview tags from spam-reporting improvements

* Update ms.date and add supported build number

* Add Smart Alerts function support  and sendAsync

* Apply suggestion from review

* Run build script

Author: samantharamon

.openpublishing.publish.config.json

@@ -42,6 +42,7 @@
         "outlook-js-1.12",
         "outlook-js-1.13",
         "outlook-js-1.14",
+        "outlook-js-1.15",
         "powerpoint-js-preview",
         "powerpoint-js-1.1",
         "powerpoint-js-1.2",
@@ -184,6 +185,10 @@
       "ReferenceTOC": "docs/docs-ref-autogen/outlook_1_14/toc.yml",
       "ConceptualTOCUrl": "/office/dev/add-ins/toc.json"
     },
+    {
+      "ReferenceTOC": "docs/docs-ref-autogen/outlook_1_15/toc.yml",
+      "ConceptualTOCUrl": "/office/dev/add-ins/toc.json"
+    },
     {
       "ReferenceTOC": "docs/docs-ref-autogen/excel/toc.yml",
       "ConceptualTOCUrl": "/office/dev/add-ins/toc.json"

docs/docfx.json

@@ -299,6 +299,12 @@
         "src": "docs-ref-autogen/outlook_1_14",
         "dest": "api"
       },
+      {
+        "files": ["**/*.md", "**/*.yml"],
+        "group": "outlook-js-1.15",
+        "src": "docs-ref-autogen/outlook_1_15",
+        "dest": "api"
+      },
       {
         "files": ["**/toc.yml"],
         "group": "excel-js-preview",
@@ -927,6 +933,10 @@
         "dest": "outlook-js-1.14",
         "moniker_range": "outlook-js-1.14"
       },
+      "outlook-js-1.15": {
+        "dest": "outlook-js-1.15",
+        "moniker_range": "outlook-js-1.15"
+      },
       "excel-js-preview": {
         "dest": "excel-js-preview",
         "moniker_range": "excel-js-preview"
@@ -1201,6 +1211,7 @@
         "docs-ref-autogen/outlook_1_12/**": "outlook",
         "docs-ref-autogen/outlook_1_13/**": "outlook",
         "docs-ref-autogen/outlook_1_14/**": "outlook",
+        "docs-ref-autogen/outlook_1_15/**": "outlook",
         "docs-ref-autogen/powerpoint/**": "powerpoint",
         "docs-ref-autogen/powerpoint_1_1/**": "powerpoint",
         "docs-ref-autogen/powerpoint_1_2/**": "powerpoint",

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

@@ -165,6 +165,30 @@ fields:
 
 
       \[ [API set: Mailbox 1.10](/office/dev/add-ins/reference/javascript-api-for-office) \]
+  - name: InitializationContextChanged
+    uid: 'office!Office.EventType.InitializationContextChanged:member'
+    package: office!
+    summary: >-
+      Occurs in Outlook when an add-in's task pane is opened from an [actionable
+      message](https://learn.microsoft.com/outlook/actionable-messages)<!-- -->,
+      [InsightMessage](https://learn.microsoft.com/javascript/api/outlook/office.mailboxenums.itemnotificationmessagetype#fields)
+      notification, [Smart
+      Alerts](https://learn.microsoft.com/office/dev/add-ins/outlook/onmessagesend-onappointmentsend-events) dialog, or
+      [integrated spam-reporting](https://learn.microsoft.com/office/dev/add-ins/outlook/spam-reporting) dialog. This
+      event prevents an add-in from relaunching if its task pane is already open in Outlook.
+
+
+      **Important**: The `InitializationContextChanged` event can only be handled in a task pane. Function commands
+      can't register a handler for this event.
+
+
+      To add an event handler for the `InitializationContextChanged` event, use the `addHandlerAsync` method of the
+      `Item` object. The event handler receives an argument of type
+      [Office.InitializationContextChangedEventArgs](https://learn.microsoft.com/javascript/api/outlook/office.initializationcontextchangedeventargs?view=outlook-js-1.15)<!--
+      -->.
+
+
+      \[ [API set: Mailbox 1.15](/office/dev/add-ins/reference/javascript-api-for-office) \]
   - name: ItemChanged
     uid: 'office!Office.EventType.ItemChanged:member'
     package: office!

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

@@ -165,6 +165,30 @@ fields:
 
 
       \[ [API set: Mailbox 1.10](/office/dev/add-ins/reference/javascript-api-for-office) \]
+  - name: InitializationContextChanged
+    uid: 'office!Office.EventType.InitializationContextChanged:member'
+    package: office!
+    summary: >-
+      Occurs in Outlook when an add-in's task pane is opened from an [actionable
+      message](https://learn.microsoft.com/outlook/actionable-messages)<!-- -->,
+      [InsightMessage](https://learn.microsoft.com/javascript/api/outlook/office.mailboxenums.itemnotificationmessagetype#fields)
+      notification, [Smart
+      Alerts](https://learn.microsoft.com/office/dev/add-ins/outlook/onmessagesend-onappointmentsend-events) dialog, or
+      [integrated spam-reporting](https://learn.microsoft.com/office/dev/add-ins/outlook/spam-reporting) dialog. This
+      event prevents an add-in from relaunching if its task pane is already open in Outlook.
+
+
+      **Important**: The `InitializationContextChanged` event can only be handled in a task pane. Function commands
+      can't register a handler for this event.
+
+
+      To add an event handler for the `InitializationContextChanged` event, use the `addHandlerAsync` method of the
+      `Item` object. The event handler receives an argument of type
+      [Office.InitializationContextChangedEventArgs](https://learn.microsoft.com/javascript/api/outlook/office.initializationcontextchangedeventargs?view=outlook-js-1.15)<!--
+      -->.
+
+
+      \[ [API set: Mailbox 1.15](/office/dev/add-ins/reference/javascript-api-for-office) \]
   - name: ItemChanged
     uid: 'office!Office.EventType.ItemChanged:member'
     package: office!

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

@@ -32,6 +32,7 @@ interfaces:
   - 'outlook!Office.From:interface'
   - 'outlook!Office.InfobarClickedEventArgs:interface'
   - 'outlook!Office.InfobarDetails:interface'
+  - 'outlook!Office.InitializationContextChangedEventArgs:interface'
   - 'outlook!Office.InternetHeaders:interface'
   - 'outlook!Office.IsAllDayEvent:interface'
   - 'outlook!Office.Item:interface'

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

@@ -3704,6 +3704,133 @@ methods:
       return:
         type: void
         description: ''
+  - name: 'sendAsync(options, callback)'
+    uid: 'outlook!Office.AppointmentCompose#sendAsync:member(1)'
+    package: outlook!
+    fullName: 'sendAsync(options, callback)'
+    summary: Sends the appointment being composed.
+    remarks: >-
+      \[ [API set: Mailbox 1.15](/javascript/api/requirement-sets/outlook/outlook-api-requirement-sets) \]
+
+
+      **[Minimum permission
+      level](https://learn.microsoft.com/office/dev/add-ins/outlook/understanding-outlook-add-in-permissions)<!--
+      -->**: **read/write mailbox**
+
+
+      **[Applicable Outlook
+      mode](https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points)<!--
+      -->**: Appointment Organizer
+
+
+      **Important**:
+
+
+      - The `sendAsync` method is only supported in task pane and function command implementations. It isn't supported
+      in [event-based handlers](https://learn.microsoft.com/office/dev/add-ins/outlook/autolaunch) or [item multi-select
+      scenarios](https://learn.microsoft.com/office/dev/add-ins/outlook/item-multi-select)<!-- -->.
+
+
+      - In a function command implementation, the value returned in `asyncResult.status` may not reflect whether the
+      appointment being composed is successfully sent. This is because the `sendAsync` method is an asynchronous API and
+      events outside the add-in's control (for example, events handled by a separately installed [Smart Alerts
+      add-in](https://learn.microsoft.com/office/dev/add-ins/outlook/onmessagesend-onappointmentsend-events)<!-- -->)
+      could block the item from being sent. Since you can't rely on the status returned in `asyncResult.status` to run
+      certain operations, you should only call the
+      [event.completed](https://learn.microsoft.com/javascript/api/office/office.addincommands.event#office-office-addincommands-event-completed-member(1))
+      method in the callback function. The `event.completed` call signals that the add-in has completed processing.
+      Other than this call, other code in the callback function isn't guaranteed to run. We recommend processing other
+      operations before calling `sendAsync`<!-- -->.
+
+
+      - In a task pane implementation, any code included to run when `asyncResult.status` is
+      `Office.AsyncResultStatus.Success` isn't guaranteed to be processed. This is because the item may have already
+      been sent and the add-in has completed processing. We recommend processing other operations before calling
+      `sendAsync`<!-- -->.
+
+
+      - Any code included after the `sendAsync` call isn't guaranteed to run since the add-in completes processing after
+      the `sendAsync` call.
+    isPreview: false
+    isDeprecated: false
+    syntax:
+      content: >-
+        sendAsync(options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<void>) =>
+        void): void;
+      parameters:
+        - id: options
+          description: >-
+            An object literal that contains the `asyncContext` property. Use the `asyncContext` property to specify any
+            object you want to access in the callback function.
+          type: '<xref uid="office!Office.AsyncContextOptions:interface" />'
+        - id: callback
+          description: >-
+            Optional. When the method completes, the function passed in the `callback` parameter is called with a single
+            parameter, `asyncResult`<!-- -->. The `asyncResult` parameter is an `Office.AsyncResult` object.
+          type: '(asyncResult: <xref uid="office!Office.AsyncResult:interface" />&lt;void&gt;) =&gt; void'
+      return:
+        type: void
+        description: ''
+  - name: sendAsync(callback)
+    uid: 'outlook!Office.AppointmentCompose#sendAsync:member(2)'
+    package: outlook!
+    fullName: sendAsync(callback)
+    summary: Sends the appointment being composed.
+    remarks: >-
+      \[ [API set: Mailbox 1.15](/javascript/api/requirement-sets/outlook/outlook-api-requirement-sets) \]
+
+
+      **[Minimum permission
+      level](https://learn.microsoft.com/office/dev/add-ins/outlook/understanding-outlook-add-in-permissions)<!--
+      -->**: **read/write mailbox**
+
+
+      **[Applicable Outlook
+      mode](https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points)<!--
+      -->**: Appointment Organizer
+
+
+      **Important**:
+
+
+      - The `sendAsync` method is only supported in task pane and function command implementations. It isn't supported
+      in [event-based handlers](https://learn.microsoft.com/office/dev/add-ins/outlook/autolaunch) or [item multi-select
+      scenarios](https://learn.microsoft.com/office/dev/add-ins/outlook/item-multi-select)<!-- -->.
+
+
+      - In a function command implementation, the value returned in `asyncResult.status` may not reflect whether the
+      appointment being composed is successfully sent. This is because the `sendAsync` method is an asynchronous API and
+      events outside the add-in's control (for example, events handled by a separately installed [Smart Alerts
+      add-in](https://learn.microsoft.com/office/dev/add-ins/outlook/onmessagesend-onappointmentsend-events)<!-- -->)
+      could block the item from being sent. Since you can't rely on the status returned in `asyncResult.status` to run
+      certain operations, you should only call the
+      [event.completed](https://learn.microsoft.com/javascript/api/office/office.addincommands.event#office-office-addincommands-event-completed-member(1))
+      method in the callback function. The `event.completed` call signals that the add-in has completed processing.
+      Other than this call, other code in the callback function isn't guaranteed to run. We recommend processing other
+      operations before calling `sendAsync`<!-- -->.
+
+
+      - In a task pane implementation, any code included to run when `asyncResult.status` is
+      `Office.AsyncResultStatus.Success` isn't guaranteed to be processed. This is because the item may have already
+      been sent and the add-in has completed processing. We recommend processing other operations before calling
+      `sendAsync`<!-- -->.
+
+
+      - Any code included after the `sendAsync` call isn't guaranteed to run since the add-in completes processing after
+      the `sendAsync` call.
+    isPreview: false
+    isDeprecated: false
+    syntax:
+      content: 'sendAsync(callback?: (asyncResult: Office.AsyncResult<void>) => void): void;'
+      parameters:
+        - id: callback
+          description: >-
+            Optional. When the method completes, the function passed in the `callback` parameter is called with a single
+            parameter, `asyncResult`<!-- -->. The `asyncResult` parameter is an `Office.AsyncResult` object.
+          type: '(asyncResult: <xref uid="office!Office.AsyncResult:interface" />&lt;void&gt;) =&gt; void'
+      return:
+        type: void
+        description: ''
   - name: 'setSelectedDataAsync(data, options, callback)'
     uid: 'outlook!Office.AppointmentCompose#setSelectedDataAsync:member(1)'
     package: outlook!

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

@@ -0,0 +1,45 @@
+### YamlMime:TSType
+name: Office.InitializationContextChangedEventArgs
+uid: 'outlook!Office.InitializationContextChangedEventArgs:interface'
+package: outlook!
+fullName: Office.InitializationContextChangedEventArgs
+summary: >-
+  Provides data from an [actionable message](https://learn.microsoft.com/outlook/actionable-messages)<!-- -->,
+  [InsightMessage](https://learn.microsoft.com/javascript/api/outlook/office.mailboxenums.itemnotificationmessagetype#fields)
+  notification, [Smart
+  Alerts](https://learn.microsoft.com/office/dev/add-ins/outlook/onmessagesend-onappointmentsend-events) dialog, or
+  [integrated spam-reporting](https://learn.microsoft.com/office/dev/add-ins/outlook/spam-reporting) dialog when the
+  `Office.EventType.InitializationContextChanged` event occurs.
+remarks: '\[ [API set: Mailbox 1.15](/javascript/api/requirement-sets/outlook/outlook-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+  - name: initializationContextData
+    uid: 'outlook!Office.InitializationContextChangedEventArgs#initializationContextData:member'
+    package: outlook!
+    fullName: initializationContextData
+    summary: >-
+      Represents the data to be passed to an add-in's task pane from an actionable message, notification message, Smart
+      Alerts dialog, or integrated spam-reporting dialog.
+    remarks: '\[ [API set: Mailbox 1.15](/javascript/api/requirement-sets/outlook/outlook-api-requirement-sets) \]'
+    isPreview: false
+    isDeprecated: false
+    syntax:
+      content: 'initializationContextData: string;'
+      return:
+        type: string
+  - name: type
+    uid: 'outlook!Office.InitializationContextChangedEventArgs#type:member'
+    package: outlook!
+    fullName: type
+    summary: >-
+      Represents the type of the event. For details, refer to
+      [Office.EventType](https://learn.microsoft.com/javascript/api/office/office.eventtype)<!-- -->.
+    remarks: '\[ [API set: Mailbox 1.15](/javascript/api/requirement-sets/outlook/outlook-api-requirement-sets) \]'
+    isPreview: false
+    isDeprecated: false
+    syntax:
+      content: 'type: "olkInitializationContextChanged";'
+      return:
+        type: '"olkInitializationContextChanged"'