Office.js property 'From' does not return emailaddress of email sent as a delegate

[digiofficerobin]

Article URL
On what page did you find the problem?
https://learn.microsoft.com/en-us/javascript/api/outlook/office.messageread?view=outlook-js-preview

from
Gets the email address of the sender of a message.

The from and sender properties represent the same person unless the message is sent by a delegate. In that case, the from property represents the delegator, and the sender property represents the delegate.

Note: The recipientType property of the EmailAddressDetails object in the from property is undefined.

The from property returns an EmailAddressDetails object.

Describe the problem
Steps to reproduce:

1. Start One Outlook
2. Install Scriptlab for Outlook https://marketplace.microsoft.com/en-us/product/office/wa200001603?tab=overview
3. Send an e-mail as a delegate of a user or shared mailbox
4. Go to Sent items
5. Click on the sent e-mail
6. Open Scriptlab for Outlook
7. Click New in Scriptlab for Outlook
8. Paste the code below
9. Run the code in Scriptlab

document.getElementById("run").addEventListener("click", run);

function run() {

  console.log(`current mailbox ${Office.context.mailbox.userProfile.emailAddress}`)

  console.log(`from ${Office.context.mailbox.item.from.emailAddress}`);

  console.log(`sender ${Office.context.mailbox.item.sender.emailAddress}`)

}

Screenshots

[AlexJerabek]

Hi @digiofficerobin,

Thanks for reporting this. @samantharamon, could you please take a look?

[samantharamon]

Hi @digiofficerobin,

Thanks for raising this. This appears to be a bug in the documentation where we need to clarify the expected values for the delegation type, specifically, send as and send on behalf permissions (for information on these permissions, see Manage permissions for recipients in Exchange Online).

• Send as permissions - Allows the delegate to send messages as if they were sent directly from another user's mailbox or a shared mailbox. Because there's no indication that the message was sent by a delegate, the from and sender properties return the delegator or shared mailbox's address.
• Send on behalf permissions - Allows the delegate to send messages on behalf of another user. The From address of these messages show that the delegate sent the message (usually appears as " on behalf of <delegator's name>"). For this permission type, the from property returns the delegator's address and the sender property returns the delegate's address.

In the screenshot you shared, it looks like the message was sent with send as permissions, so the from and sender properties returning the same address is expected.

I'll create a PR to clarify the behavior in the documentation.

[digiofficerobin]

@samantharamon Thanks, I had Read and manage (Full Access) and Send as access. When I give myself only Send as permission, then I don't see any changes in the properties. Even after restarting Outlook. I have noticed that these changes are not immediate effective. I will test this again next week.

I've tested with a user mailbox which I had already Send as permission. Then the from and sender properties works as expected.

I've also noticed that the Edit button for permission (2) Send as does not give the same result as clicking on button (1) Send on behalf.

No members shown when clicking on Send on behalf.

4 members shown when click on Edit of permission Send as.

I think they should be the same list.

[digiofficerobin]

Addition to my last comment about the the two different lists. They are probably not the same list. One is for Send as and the other Send on behalf.

The Send on behalf group is missing on a shared mailbox compared to a user mailbox.

User mailbox

Shared mailbox

[samantharamon]

@digiofficerobin While the UIs are different for user and shared mailboxes, I believe you can use the Send on behalf option from the shared mailbox to manage permissions (#1 label in your screenshot). You can also use PowerShell to manage permissions (see Can't manage Send on Behalf permissions for shared mailboxes in the EAC).

Unfortunately, we don't manage the Exchange admin center. I recommend directing your questions to the Microsoft Q&A Exchange forum for assistance.