Microsoftの再接続
PortantはMicrosoftに接続して、OneDriveまたはSharePoint内のテンプレートの読み取りと出力の保存を行います。この接続が切断されると、ワークフローは完全に失敗するのではなく途中で停止するため、最初の兆候として、ドキュメントが届いていないというお客様からの連絡があることがよくあります。
症状
- 実行が停止し、Drafts（下書き）として表示されるワークフロー。
- HubSpotでトリガーされたワークフローがPortantのステップで止まっている。
- 生成されたPDFがHubSpotのレコードに添付されなくなった。
- チームメンバーのMicrosoftアカウントが繰り返し切断される。
- SharePointまたはOneDriveからファイルを選択する際にエラーが発生する。
再接続
- Portant Settings → Integrations（設定 → インテグレーション）に移動します。
- Individual Permissions（個別の権限）の下にあるMicrosoftを見つけ、Manage（管理）をクリックします。
- 再接続し、表示されるプロンプトを承認します。
完了すると、MicrosoftがConnected（接続済み）と表示されます。その後、影響を受けた項目を1件再実行して確認してください。
Microsoft SharePointは別の接続であり、Teams Permissions（チームの権限）の下に表示されます。個人のOneDriveではなくSharePointライブラリにテンプレートや出力を保存している場合は、そちらも確認してください。MicrosoftがConnectedと表示されていても、SharePointが接続されていない場合があります。
接続が繰り返し切断される場合
テナントによっては、Microsoftの接続が他のテナントよりもはるかに頻繁に切断される場合があり、場合によっては1〜2週間ごとに発生することがあります。繰り返し再接続している場合は、以下を確認してください。
- テナントの条件付きアクセスポリシーまたはトークンの有効期間ポリシーによって、付与が早期に失効していないかを確認してください。Microsoftの管理者にお問い合わせください。
- 同意がユーザーごとではなく、組織レベルで付与されていることを確認してください。管理者の同意リンクについてはMicrosoft permissions issueを、管理者が特定のユーザーやグループにアクセスを割り当てる方法についてはApproving Portant in Microsoft 365 (Entra ID)を参照してください。
- 発生頻度と使用中のテナントをお知らせください。繰り返し発生する切断は、そのまま受け入れるのではなく、調査する価値があります。
Portantは現在、Microsoftの接続が切断された際に通知を送信しません。通知機能が追加されるまでの間、確実な確認方法はPermissions（権限）ページを確認することであり、Microsoftベースのワークフローが正常に動作しない場合は、まずそこを確認する習慣をつけることをお勧めします。