セクション内の新規ノート(トリガー)

このピースでできること

  • Microsoft OneNoteの指定セクションに新しいノートページが作成されたことをポーリングで検知します。

Microsoft OneNoteの接続方法

1. 接続を作成

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

2. 接続設定

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

3. Microsoft OneNoteへのアクセス許可を与える

  • 管理者アカウントを選んでログインします。
  • アプリに許可を行います。

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

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

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

企業のMicrosoftセキュリティポリシーにより、外部アプリへのアクセス許可がブロックされている場合、接続時に以下のようなメッセージが表示されることがあります。
「workrunには、組織内のリソースへのアクセス許可が必要です。このアクセス許可を付与できるのは管理者のみです。」
この場合、貴社の情シス部門にMicrosoft Entra IDでの管理者同意(Admin Consent)の付与を依頼してください。
【標準のworkrun接続を利用している場合に、情シス担当者へ共有する情報】
  • アプリ表示名:workrun
  • クライアントID:f099e7f6-b923-41ce-9362-ee72073805f4
自社Azureアプリを利用している場合は、自社で登録したアプリの表示名とクライアントIDを共有してください。
管理者同意の具体的な手順は、以下のMicrosoft公式ドキュメントをご参照ください。
管理者同意の付与後、再度Microsoft OneNoteへのアクセス許可を行ってください。

ピースの設定項目

1. ノートブック(必須)

  • 監視対象のノートブックを選択します。
  • f(動的値)をクリックすると任意で入力できます。

2. セクション(必須)

  • 監視対象のセクションを選択します。
  • f(動的値)をクリックすると任意で入力できます。

取得できる情報

指定したOneNoteセクションの新しいページを、1ページずつ取得できます。
  • / :ページID・タイトル。
  • / :作成日時・最終更新日時。
  • :追加取得したページ本文のHTML文字列。本文取得に失敗した場合はnullです。
  • / :API応答に含まれる本文API URL・OneNoteで開くリンクなど。
  • など:API応答に含まれる作成元情報。

取得条件と注意点

  • 選択したセクションのページを取得し、通常実行は保存した境界より が新しいページを検知します。既存ページの本文編集だけは検知対象ではありません。
  • 有効化時に基準時刻を保存します。通常検索は次ページも取得します。
  • テストは作成日時の降順で最大10ページを要求した先頭応答から最大5件を返します。各ページの本文取得も行います。
  • ページ一覧の取得失敗はエラーになりますが、個別の本文取得失敗は でページ情報を返します。

利用例

を新規ページの通知に、 をHTML本文の後続処理に利用できます。

出力例(抜粋)

キーと階層を示す架空例です。実際の項目・値は受信内容や接続先により異なります。

ポーリングの補足

  • 有効化時に基準時刻を保存します。通常実行は、その境界より作成日時が新しいページを検知します。
  • テストでは最大10件を要求した応答から最大5件を返します。既存ページの内容更新だけを監視するものではありません。