Feedback: EnhancedLocations preview API
I'd like to provide some feedback about Office.EnhancedLocation and Office.LocationIdentifier when developing an Outlook add-in.
First, very happy to see improvements with this!
In my use case, I have an Office Add-in that show me all available meeting rooms (from a different Office 365 tenant). Users can add one or more of those meeting rooms as a location to the invite, through the add-on. Sending the invite, also books the room (and because of an Organization Relationship we can even use the schedule builder to view Free/Busy).
My code would use the EnhancedLocation.addAsync with body:
var locations = [
If email@example.com is a room in our own tenant and exists in our GAL, the location gets updated with the displayName of the room "Room 1 - 6 persons".
If it is a room in the other tenant (and thus doesn't exist in our GAL), it just shows the e-mail address as location.
Preferrably, I would like to do something like:
var locations = [
"displayName": "Room 1 - 6 persons",
With custom locations, they could also use the displayName property and have their own "unique identifier" in the id field. The API would still be consistent.
And with rooms that do exist in the GAL, it could still resolve first with GAL and use the displayName is a fallback mechanism.
Hello Yannick! thanks for using our preview APIs! and also thanks for your suggestion.
I think with the current design you should be able to make it work.
For rooms within your tenant, we are ok I think we all agree on that.
For rooms outside of your tenant, though, I recommend you treat such locations as custom where in the ID you can actually set a string with the DisplayName you want (as opposed to the email), and on the type you can set it to custom(using Office.MailbxEnums.LocationType.Custom. You can also infer the ID with the displayname on your other tenant, although in edge cases you would need to provide a disambiguation xperience.
One potential problem we can have if we open the display name properties is that actual room display names can be changed and we are not sure that's a great idea to allow that.
Still we'll have a discussion on the team and see if we can improve the design.