既知の問題と制限事項

フローに影響する可能性があるBoxコネクタの既知の制限事項は以下のとおりです。

  • ファイルまたはフォルダー、アプリケーション、認証ユーザーの各アイテムでは、Webhookは1つに制限されます。アイテムにWebhookを添付した後は、第2のWebhookが別のトリガーイベントに対応する場合でも、第2のWebhookを添付できません。

  • ユーザーのアプリケーションのWebhookは1000に制限されます。ユーザーのWebhookをそれ以上作成するには、別のアプリケーションを作成するか既存のWebhookを更新し、フォルダーツリー内のより上位のレベルに適用します。

  • コネクタはWebhooks V2を使用し、ID 0のルートフォルダーに作成することはできません。「Box」を参照してください。

  • ペイロードには、オブジェクト応答と追加のコンテキスト情報が含まれます。

追加情報

  • 通知の送信に失敗すると、Boxアプリケーションはペイロードを最大で10回再送信します。

  • Boxアプリケーションを削除すると、そのアプリケーションに関連するすべてのWebhookは自動的に削除されます。

  • Webhookに関連するすべてのアクティブアクセストークンを削除すると、Webhookは自動的に削除されます。これには、開発者トークンとパスワードリセットが含まれます。

  • 最後に成功した送信が30日前で、最後の成功送信日と最後のトリガー日の間の期間が14日間を超える場合、Webhookは自動的に削除されます。
  • Webhookが削除されると、BoxはWEBHOOK>DELETEDというイベント名のWebhookペイロードを通知URLに送信します。ペイロードの本文には以下の情報が含まれます。
コピー
"additional_info": { "reason": "auto_cleanup" } 

ファイルとフォルダーの削除と復元

Boxファイルおよびフォルダーを削除および復元し、Boxイベントが含まれるWorkflowフローのステータスが変化すると、ユーザーに競合エラーメッセージが送信される場合があります。

問題

ユーザーは、Boxイベントが含まれるアクティブなWorkflowsフローに以下の変更を加えます。

  • フロー(IDで指定)で使用されるファイルまたはフォルダーは、Boxゴミ箱に移動されます。
  • Workflowフローは非アクティブ化されます。
  • ファイルまたはフォルダーは、Boxゴミ箱から復元されます。
  • Workflowフローはアクティブ化されます。
  • ユーザーに409 Conflictエラーメッセージが送信されます。

ファイルまたはフォルダをゴミ箱に移動してから復元すると、関連するWebhookも復元されます。この場合は、Webhookに関連する追加のファイルまたはフォルダーが存在します。Boxでは、ファイルとフォルダーの数はWebhookごとに1つに制限されます。

解決法

  1. 復元されたWebhookを(消去ではなく)削除します。

  2. フローがアクティブ化に失敗したEventカードで、[Target Item ID(ターゲットアイテムID)]フィールドにファイルまたはフォルダーを指定します。

  3. Custom API Actionカードを使用して、呼び出しによってすべてのWebhookが一覧表示されるようにカードを構成します。

  4. ファイルまたはフォルダーのターゲットであるWebhookのIDを特定します。

  5. Custom API Actionカードを使用して、 WebhookのIDを削除する呼び出しを行います。

関連項目

Boxコネクタ

Okta Workflowsの要素について

Box APIドキュメンテーション