add-office365-users

📋 Shared Instructions: shared-instructions.md — Cross-cutting concerns.

Add Office 365 Users (Wrapper)

This skill is a thin wrapper. Use /add-data-source as the single implementation path.

Delegation contract

Invoke /add-data-source with:

• api-id: shared_office365users
• mode: action

---

Office 365 Users: Method Selection Guide

After the connector is added, import the generated service:

import { Office365UsersService } from '../../generated/services/Office365UsersService'

Use the V2 methods for profiles and reporting relationships:

Scenario	Method	Result
Current signed-in user	MyProfile_V2($select?)	One GraphUser_V1
Specific user by ID or UPN	UserProfile_V2(id, $select?)	One GraphUser_V1
User's manager	Manager_V2(id, $select?)	One GraphUser_V1
Direct reports	DirectReports_V2(id, $select?, $top?)	Profiles in result.data.value
Search people	SearchUserV2(searchTerm, top?, ...)	Search response in result.data.value
Profile photo	UserPhotoMetadata(userId), then UserPhoto_V2(id)	Metadata, then binary image data

DirectReports_V2 requires the target manager's Microsoft Entra directory ID or user principal name (UPN). For the signed-in user, call MyProfile_V2('id,userPrincipalName'), then pass the returned id or fall back to userPrincipalName. For a known person, pass their directory ID or UPN directly.

Profile and direct-report pattern

Request only the fields the UI needs:

const fields = [
  'id',
  'displayName',
  'jobTitle',
  'department',
  'mail',
  'userPrincipalName',
  'officeLocation',
].join(',')

const myProfile = await Office365UsersService.MyProfile_V2(
  'id,userPrincipalName',
)
if (!myProfile.success) {
  throw new Error(myProfile.error?.message ?? 'Failed to resolve current user')
}

const managerId =
  myProfile.data?.id ?? myProfile.data?.userPrincipalName

if (!managerId) {
  throw new Error('Current user profile did not include an ID or UPN')
}

const result = await Office365UsersService.DirectReports_V2(
  managerId,
  fields,
)

if (!result.success) {
  throw new Error(result.error?.message ?? 'Failed to load direct reports')
}

const people = result.data?.value ?? []