カスタムAPI呼び出し

このピースでできること

• Microsoft Graph APIに対して任意のHTTPリクエストを送信します（認証は自動付与）。

Microsoft Excel 365の接続方法

1. 接続を作成

• 接続から「接続を作成」をクリックします。

2. 接続設定

• 接続名を設定して、「接続する」をクリックします。

 

3. Excelへのアクセス許可を与えます

• 管理者アカウントを選んでログインします。

4. 「保存」を押して接続名が設定されていることを確認します

• 「保存」を押して接続名が設定されていることを確認します。

---

⚠️ Microsoft系アプリで管理者の同意が必要な場合

企業のMicrosoftセキュリティポリシーにより、外部アプリへのアクセス許可がブロックされている場合、接続時に以下のようなメッセージが表示されることがあります。

「workrunには、組織内のリソースへのアクセス許可が必要です。このアクセス許可を付与できるのは管理者のみです。」

この場合、貴社の情シス部門にMicrosoft Entra IDでの管理者同意（Admin Consent）の付与を依頼してください。

【標準のworkrun接続を利用している場合に、情シス担当者へ共有する情報】

• アプリ表示名：workrun

• クライアントID：f099e7f6-b923-41ce-9362-ee72073805f4

自社Azureアプリを利用している場合は、自社で登録したアプリの表示名とクライアントIDを共有してください。

管理者同意の具体的な手順は、以下のMicrosoft公式ドキュメントをご参照ください。

• 管理者同意ワークフローの概要

• 管理者同意リクエストの確認と承認

管理者同意の付与後、再度Microsoft Excel 365へのアクセス許可を行ってください。

ピースの設定項目

1. URL（必須）

• ベースURLは https://graph.microsoft.com v1.0 です。

2. メソッド（必須）

3. ヘッダー（必須）

• 認証ヘッダーは接続から自動的に注入されます。

• 追加のHTTPヘッダーをJSONで指定します。

4. クエリパラメーター（必須）

• URLに付与するパラメーターをJSONで指定します。

5. ボディ（任意）

• リクエストボディをJSONで指定します。

6. 応答はバイナリですか？（任意）

• PDF、画像などのファイルを有効にする場合はオンにします。

7. 失敗時にエラーはありません（任意）

• エラー時に空の結果を返す場合はオンにします。

8. タイムアウト（秒）（任意）

• タイムアウト時間をミリ秒で指定します。

9. 失敗時に続ける（任意）

• このオプションを有効にすると、このステップをスキップし、失敗した場合は正常にフローを継続します。

10.失敗時に再試行（任意）

• 失敗したときに自動的に最大 4 回の試行を再試行します。