Add Outlook add-in command that invokes a function

Author: akrantz

manifest.outlook.xml

@@ -66,6 +66,21 @@
                     <SourceLocation resid="Taskpane.Url" />
                   </Action>
                 </Control>
+                <Control xsi:type="Button" id="ActionButton">
+                  <Label resid="ActionButton.Label"/>
+                  <Supertip>
+                    <Title resid="ActionButton.Label"/>
+                    <Description resid="ActionButton.Tooltip"/>
+                  </Supertip>
+                  <Icon>
+                    <bt:Image size="16" resid="Icon.16x16"/>
+                    <bt:Image size="32" resid="Icon.32x32"/>
+                    <bt:Image size="80" resid="Icon.80x80"/>
+                  </Icon>
+                  <Action xsi:type="ExecuteFunction">
+                    <FunctionName>action</FunctionName>
+                  </Action>
+                </Control>                
               </Group>
             </OfficeTab>
           </ExtensionPoint>
@@ -85,9 +100,11 @@
       <bt:ShortStrings>
         <bt:String id="GroupLabel" DefaultValue="Contoso Add-in"/>
         <bt:String id="TaskpaneButton.Label" DefaultValue="Show Taskpane"/>
+        <bt:String id="ActionButton.Label" DefaultValue="Perform an action"/>
       </bt:ShortStrings>
       <bt:LongStrings>
         <bt:String id="TaskpaneButton.Tooltip" DefaultValue="Opens a pane displaying all available properties."/>
+        <bt:String id="ActionButton.Tooltip" DefaultValue="Perform an action when clicked."/>
       </bt:LongStrings>
     </Resources>
   </VersionOverrides>

src/commands/commands.ts

@@ -3,11 +3,37 @@
  * See LICENSE in the project root for license information.
  */
 
-(() => {
-  // The initialize function must be run each time a new page is loaded
-  Office.initialize = () => {
+Office.onReady(info => {
+  // If needed, Office.js is ready to be called
+});
 
-  };
+/**
+ * Shows a notification when the add-in command is executed.
+ * @param event 
+ */
+function action(event: Office.AddinCommands.Event) {
+  const message: Office.NotificationMessageDetails = {
+    type: Office.MailboxEnums.ItemNotificationMessageType.InformationalMessage, 
+    message: "Performed action.",
+    icon: "Icon.80x80",
+    persistent: true
+  }
+  
+  // Show a notification message
+  Office.context.mailbox.item.notificationMessages.replaceAsync("action", message);
+
+  // Be sure to indicate when the add-in command function is complete
+  event.completed();
+}
+
+function getGlobal() { 
+  return (typeof self !== "undefined") ? self :
+    (typeof window !== "undefined") ? window : 
+    (typeof global !== "undefined") ? global :
+    undefined;
+}
+
+const g = getGlobal() as any;
 
-  // Add any ui-less function here
-})();
+// the add-in command functions need to be available in global scope
+g.action = action;