Enumerations

You can specify an enumerated value by using either its fully qualified enumeration name ( Office.CoercionType.Text) or its corresponding text value ( "text"). For example, the following method call uses enumeration names:

Office.context.document.getSelectedDataAsync(Office.CoercionType.Text, {valueFormat:Office.ValueFormat.Unformatted, filterType:Office.FilterType.All},
   function (result) {
      if (result.status === Office.AsyncResultStatus.Success)
         var dataValue = result.value; // Get selected data.
         write('Selected data is ' + dataValue);
      else {
         var err = result.error;
         write(err.name + ": " + err.message);
      }
   });

// Function that writes to a div with id='message' on the page.
function write(message){
    document.getElementById('message').innerText += message;
}

Here's the same call using the enumeration text values:

Office.context.document.getSelectedDataAsync("text", {valueFormat:"unformatted", filterType:"all"},
   function (result) {
      if (result.status === "success")
         var dataValue = result.value; // Get selected data.
         write('Selected data is ' + dataValue);
      else {
         var err = result.error;
         write(err.name + ": " + err.message);
      }
   });

Reference

Support details

Support for each enumeration differs across Office host applications. See the "Support details" section of each enumerations's topic for host support information.

For more information about Office host application and server requirements, see Requirements for running Office Add-ins.