Limitations et problèmes connus

Les limitations connues suivantes du connecteur Box qui peuvent avoir une incidence sur vos flux.

  • Une limite d'un webhook est fixée pour chacun des éléments suivants : fichier ou dossier, application et utilisateur authentifié. Une fois qu'un webhook est attaché à un élément, aucun second Webhook ne peut être attaché, même s'il répond à un événement déclencheur différent.

  • Il existe a une limite de 1 000 webhooks pour une application pour un utilisateur. Pour créer davantage de webhooks pour un utilisateur, créez une autre application ou mettez à jour les Webhooks existants afin qu'ils s'appliquent à des niveaux ultérieurs dans l'arborescence des dossiers.

  • Les connecteurs utilisent les webhooks V2 et ne peuvent pas être créés sur le dossier racine avec l'ID 0. Consultez Box.

  • La charge utile comprend une réponse d'objet et des informations contextuelles complémentaires.

Informations complémentaires

  • L'application Box renvoie une charge utile jusqu'à 10 fois après un échec de transmission d'une notification.

  • La suppression d'une application Box supprime automatiquement tous les webhooks qui sont associés à cette application.

  • La suppression de tous les jetons d'accès actifs associés à un webhook entraînera la suppression automatique de ce dernier. Cela inclut les jetons de développeur et les réinitialisations de mot de passe.

  • Si la dernière transmission réussie remonte à 30 jours et que la période entre la date de la dernière transmission réussie et celle du dernier déclencheur est supérieure à 14 jours, le webhook est automatiquement supprimé.
  • Lorsqu'un webhook est supprimé, Box envoie une charge utile Webhook avec le nom d'événement WEBHOOK>DELETED à l'URL de notification. Le corps de la charge utile comprend les informations suivantes :
"additional_info": {

  "reason": "auto_cleanup"

}

Suppression et restauration de fichiers et de dossiers

Les utilisateurs peuvent recevoir un message d'erreur de conflit après avoir supprimé et restauré des fichiers et des dossiers Box, et après avoir modifié le statut du flux Workflows qui contient les événements Box.

Problème :

Un utilisateur apporte les modifications suivantes à un flux Workflows actif qui contient un événement Box :

  • Le fichier ou le dossier qui est utilisé dans le flux (par ID) est déplacé vers la corbeille de Box.
  • Le flux de Workflows est désactivé.
  • Le fichier ou le dossier est restauré depuis la corbeille de Box.
  • Le flux de Workflows est activé.
  • L'utilisateur reçoit un message d'erreur de conflit 409.

Lorsque le fichier ou le dossier est déplacé vers la corbeille, puis restauré, le webhook associé est également restauré. Dans ce cas, un fichier ou un dossier supplémentaire est associé au webhook. Box limite le nombre de fichiers et de dossiers à un par Webhook.

Résolution :

  1. Retirez le Webhook restauré, plutôt que de le supprimer.

  2. Dans la carte d'événement dans laquelle le flux n'a pas été activé, indiquez le fichier ou le dossier dans le champ ID de l'élément cible.

  3. À l'aide de la carte Action d'API personnalisée, configurez la carte pour qu'elle effectue un appel afin de répertorier tous les webhooks.

  4. Recherchez l'ID du webhook qui est la cible du fichier ou du dossier.

  5. À l'aide de la carte Action d'API personnalisée, effectuez un appel pour supprimer l'ID du webhook.