> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jinba.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Microsoft Users

> Microsoft Graph で Microsoft 365 ユーザー情報を検索

## 概要

Microsoft Users ツールでは、Microsoft 365 のメールアドレスや UPN からユーザーのディレクトリプロフィールを取得したり、各ユーザーの直属マネージャーを調べたりできます。Microsoft Graph 経由で動作します。

## 主な機能

* `MICROSOFT_GET_USERS`
  * メールアドレスまたは UPN のリストを Microsoft 365 ユーザープロフィールに解決します。表示名・メール・役職・部署・会社名・オフィス所在地を返します。解決できなかった識別子は `notFound` に返されます。
* `MICROSOFT_GET_MANAGER`
  * 各入力ユーザーの直属マネージャーを検索します。`{ user, manager }` のペアのリストを返し、マネージャーが設定されていない場合は `manager` が `null` になります。解決できなかった識別子は `notFound` に返されます。

## 認証

Microsoft Graph の委任された `User.Read.All` 権限を持つ OAuth トークンが必要です。

[Jinba のシークレット設定](https://flow.jinba.io/workspace/secrets) で Microsoft アカウント（ユーザーディレクトリ）を連携し、発行されたトークンをツールの config に指定してください。

> **テナント管理者の同意が必要です。** `User.ReadBasic.All` では不十分です — 会社名や部署の情報は `User.Read.All` でのみ取得可能です。Azure AD アプリ登録に委任された `User.Read.All` を追加し、管理者の同意を得てからご利用ください。

### 例：ユーザー情報の取得とマネージャーの検索

```yaml theme={null}
- id: get_users
  name: get_users
  tool: MICROSOFT_GET_USERS
  config:
    - name: token
      value: "{{secrets.MICROSOFT_GRAPH_USERS.access_token}}"
  input:
    - name: identifiers
      value:
        - "alice@example.com"
        - "bob@example.com"

- id: get_managers
  name: get_managers
  tool: MICROSOFT_GET_MANAGER
  needs: ["get_users"]
  config:
    - name: token
      value: "{{secrets.MICROSOFT_GRAPH_USERS.access_token}}"
  input:
    - name: identifiers
      value: "{{steps.get_users.result.users[*].userPrincipalName}}"
```

## 入力

### `identifiers`

検索するメールアドレスまたは UPN（ユーザープリンシパル名）のリストです。以下の形式に対応しています：

* 配列: `["alice@example.com", "bob@example.com"]`
* カンマ区切り文字列: `"alice@example.com, bob@example.com"`
* JSON 配列文字列: `"[\"alice@example.com\", \"bob@example.com\"]"`

## 出力

### `MICROSOFT_GET_USERS`

| フィールド                              | 説明                 |
| ---------------------------------- | ------------------ |
| `result.users[].id`                | Azure AD オブジェクト ID |
| `result.users[].displayName`       | 表示名                |
| `result.users[].mail`              | プライマリメールアドレス       |
| `result.users[].userPrincipalName` | ユーザープリンシパル名（UPN）   |
| `result.users[].jobTitle`          | 役職                 |
| `result.users[].department`        | 部署                 |
| `result.users[].companyName`       | 会社名                |
| `result.users[].officeLocation`    | オフィス所在地            |
| `result.notFound[]`                | 解決できなかった識別子        |

### `MICROSOFT_GET_MANAGER`

| フィールド                       | 説明                                          |
| --------------------------- | ------------------------------------------- |
| `result.managers[].user`    | このエントリの入力識別子                                |
| `result.managers[].manager` | マネージャーのプロフィール（ユーザーと同じフィールド）、設定なしの場合は `null` |
| `result.notFound[]`         | 解決できなかった識別子                                 |