Arrivée de fichier

Deux blocs de déclenchement se déclenchent lorsqu'un fichier apparaît dans un emplacement surveillé :

Les deux fonctionnent par interrogation (polling). Scrydon détient la surveillance et demande à Microsoft Graph ce qui a changé depuis la dernière vérification : vous n'avez donc aucune boucle à construire ni à maintenir, et le déclencheur n'expose aucune URL entrante que quiconque pourrait appeler.

Configuration

Les chemins de dossier sont comparés sans tenir compte de la casse et une barre oblique finale ne change rien. Un dossier voisin dont le nom commence par le même texte ne correspond pas : surveiller /Contracts ne capte pas les fichiers de /ContractsArchive.

Ce que le déclencheur émet

Démarrer une instance de process flow

Reliez le déclencheur à un bloc Create Process Instance :

<start.…> désigne la sortie du déclencheur ; le nom du bloc déclencheur fonctionne aussi, par exemple <sharepointfilearrival1.dedupeKey>. Écrivez les références entre chevrons. {{…}} est la syntaxe des variables d'environnement, et une référence de bloc écrite à l'intérieur est transmise telle quelle, comme texte littéral.

La clé de déduplication est ce qui garantit une seule instance par document, et une Clé de déduplication vide utilise déjà le dedupeKey du déclencheur. La clé est dérivée du drive et du fichier : elle ne change donc pas si le fichier est renommé ou redéposé, et une seconde arrivée du même document renvoie l'instance active existante au lieu d'en démarrer une en parallèle. Un bloc Create Process Instance placé dans une boucle (Loop) fait exception : une clé vide n'y est pas complétée, et chaque itération démarre sa propre instance.

Cadence et première exécution

• Microsoft notifie Scrydon dès qu'un changement survient dans le lecteur surveillé : un fichier est donc généralement pris en compte en quelques secondes.
• Une interrogation toutes les cinq minutes fonctionne en parallèle des notifications et rattrape tout ce qu'une notification aurait manqué. Microsoft ne garantit pas leur livraison : c'est l'interrogation qui rend le déclencheur fiable, les notifications le rendent seulement rapide. Vous n'avez rien à configurer.
• Une nouvelle surveillance ne rejoue pas les fichiers déjà présents dans le dossier. La première vérification enregistre la position actuelle et n'émet rien ; seuls les fichiers arrivant ensuite déclenchent une exécution. Ajoutez à la main les documents existants si vous en avez besoin.
• Seuls les fichiers nouvellement créés déclenchent. Les dossiers, les suppressions, les renommages et les modifications d'un fichier déjà présent sont ignorés — de même qu'un fichier déplacé dans le dossier surveillé, car il conserve sa date de création d'origine.
• Si Microsoft invalide le jeton de suivi des modifications du déclencheur (ce qu'il fait après une longue interruption), le déclencheur se réarme à partir de ce moment. Les fichiers créés pendant l'invalidité du jeton ne sont pas rejoués.
• Un dépôt massif est livré sur plusieurs interrogations plutôt qu'en une fois.

Permissions

Le compte Microsoft connecté doit disposer d'un accès en lecture à l'emplacement surveillé — Sites.Read.All et Files.Read.All pour SharePoint, Files.Read / Files.Read.All pour OneDrive. Ces permissions font partie des portées demandées lors de la connexion du compte ; un compte connecté avant l'existence de ce déclencheur peut devoir être reconnecté.

Scrydon enregistre également auprès de Microsoft un abonnement aux changements du lecteur surveillé, et le renouvelle automatiquement. Si votre tenant bloque les notifications de changement, ou si l'instance Scrydon n'est pas joignable depuis le réseau de Microsoft, l'abonnement n'est simplement jamais créé et le déclencheur se rabat sur l'interrogation récurrente — plus lent, et identique par ailleurs. Rien à configurer dans un cas comme dans l'autre.

Dépannage