SharePoint / OneDrive のファイル
レポート、エクスポート、取引先などが SharePoint や OneDrive に置くファイルを監視します。TaskBeacon が読み取るのはファイルの 名前、サイズ、更新日時だけで(中身は一切読みません)、新しいファイルが時間内に届かなかったときに Missed(未実行)と表示します。
ルール
- New file by a time(指定時刻までに新しいファイル): 例えば平日の 08:00 まで。前回の期限(遅くとも 12 時間前)以降にファイルが更新されていれば OK、そうでなければ期限後に Missed になります。
- Updated at least every N hours(少なくとも N 時間ごとに更新): ファイルが N 時間より古くなると Missed になります。
- File name with today's date(今日の日付入りのファイル名): sales_{yyyy}-{MM}-{dd}.csv は今日のファイルを探します(あなたのタイムゾーン基準)。* は任意の文字列に一致し、一致したファイルのうち最も新しいものが対象になります。名前を指定しないフォルダーは、その中で最も新しいファイルが対象です。
- At least … KB(… KB 以上): それより小さいファイルは Odd data(異常データ)と表示されます(例: 空のエクスポート)。
1. アプリ登録とアクセス許可
Power BI と同じようにアプリ登録を作成します(テナント ID、クライアント ID、クライアントシークレット)。次に API permissions → Add a permission → Microsoft Graph → Application permissions で次のいずれかを選び、管理者が Grant admin consent を押します。
- Sites.Selected(推奨、最小限のアクセス): これだけでは何にもアクセスできません。その後、管理者がアプリに対象サイト 1 つの読み取り権限を付与します。 Microsoft Graph の POST /sites/{site-id}/permissions を、次のボディで呼び出します: {"roles": ["read"], "grantedToIdentities": [{"application": {"id": "<client id>", "displayName": "TaskBeacon monitor"}}]} (付与する人またはツール、例えば Graph Explorer や PnP PowerShell には Sites.FullControl.All が必要です)。
- Files.SelectedOperations.Selected: 同様の方法で、サイト全体ではなく個別のファイルやフォルダーを対象にします。
- Files.Read.All: 簡単ですが、テナント内のすべてのファイルを読めてしまいます。Selected 系のスコープが使えない場合にだけ使ってください。
OneDrive の場合は、フォルダーに Files.SelectedOperations.Selected を付与するか、Files.Read.All を使います。
2. TaskBeacon で接続する
Jobs → ▾ → Add integration…(連携を追加…)→ SharePoint / OneDrive。サイトのアドレス(例: https://contoso.sharepoint.com/sites/Finance)、 OneDrive の場合は所有者のメールアドレスを入力します。Test connection and continue(接続をテストして続行)の後、+ Add a file(ファイルを追加)を使います。パスはサイトの既定のドキュメントライブラリ(Documents)内のもので、例えば Reports/Daily です。
実環境ではまだテストされていません。結果をお知らせください(support@taskbeacon.io)。
ユースケース: SharePoint にファイルが 8:00 までに届かないときにアラートを受け取る。その他のご質問: FAQ