SharePoint - changements

Catalogue des nœuds Déclencheurs

Sur cette page

Suivre les éléments ajoutés, modifiés ou supprimés dans une liste.

Utilisation et spécificités

Sélectionnez un identifiant Microsoft Graph et les permissions de la ressource. OneDrive accepte aussi une connexion OAuth déléguée. Les déclencheurs interrogent les changements à intervalle régulier ; publiez pour les activer. Renseignez les identifiants de lecteur, site, liste ou utilisateur selon l’opération.

Type technique : sharepoint_trigger. Runtime : nodulz.

Identifiants et prérequis

Microsoft Graph (integration / microsoft_graph). OneDrive, SharePoint et Outlook avec une application Entra ID.

Créez l’identifiant dans la rubrique Identifiants de votre instance nodulz, puis sélectionnez-le dans le nœud. Les identifiants disponibles dépendent du propriétaire et du partage. Consultez le guide des identifiants pour les accès et la rotation.

Paramètres

Les noms ci-dessous correspondent aux clés techniques. Les valeurs par défaut ne constituent pas une configuration prête à exécuter : renseignez les champs requis par votre opération. Les chemins contenant [] décrivent les éléments d’une liste ; certains champs dépendent du mode sélectionné.

Paramètre	Type	Par défaut	Valeurs / limites
`credentialId`	`string`	`""`	-
`userId`	`string`	`""`	-
`driveId`	`string`	`""`	-
`siteId`	`string`	`""`	-
`listId`	`string`	`""`	-
`itemId`	`string`	`"root"`	-
`folderId`	`string`	`"inbox"`	-
`calendarId`	`string`	`""`	-
`resource`	`enum`	`"list"`	`drive`, `list`, `new_messages`, `messages`, `calendar`
`events`	`array`	`["changed","deleted"]`	-; min 1
`pollInterval`	`number`	`60`	-; ≥ 10, ≤ 86400
`startDateTime`	`string`	`""`	-
`endDateTime`	`string`	`""`	-
`testPayload`	`string`	`""`	-

Aide de configuration

credentialId Secret Microsoft Graph: OneDrive : secret OAuth pour un compte personnel ou professionnel, ou application Entra ID. SharePoint et Outlook : application Entra ID avec consentement administrateur et permissions applicatives adaptées.
resource Événements à suivre: Nouveaux mails : uniquement les créations dans le dossier choisi. Changements de mails : inclut lecture/non-lu et déplacement. Calendrier : calendrier principal dans une période fixe.
events Changements: Le premier passage initialise le suivi sans déclencher les éléments existants. Graph regroupe les ajouts et modifications. Une suppression peut aussi correspondre à un déplacement hors du périmètre. Les changements sont livrés après publication, avec reprise sur erreur ; un doublon reste possible après un arrêt brutal.
pollInterval Intervalle (secondes): De 10 à 86 400 secondes. Les pages delta et les éléments déjà livrés sont conservés entre les passages. Un curseur expiré nécessite de réinitialiser la source du trigger.
testPayload Données de test (JSON): Objet JSON facultatif pour les tests manuels. Sans valeur, un exemple est généré ; aucun appel Microsoft n’est effectué par ce trigger de test.

Configuration initiale

Exemple de configuration initiale du catalogue, à adapter avant exécution. Les secrets doivent rester dans les identifiants.

json

{
  "credentialId": "",
  "userId": "",
  "driveId": "",
  "siteId": "",
  "listId": "",
  "itemId": "root",
  "folderId": "inbox",
  "calendarId": "",
  "resource": "list",
  "events": [
    "changed",
    "deleted"
  ],
  "pollInterval": 60,
  "startDateTime": "",
  "endDateTime": "",
  "testPayload": ""
}

Vérification

Testez le nœud avec des données représentatives. Contrôlez sa sortie dans l’inspecteur et les logs, puis utilisez le mapping de l’éditeur pour les champs des nœuds suivants. Un test de déclencheur avec payload simulé ne valide pas la livraison du service externe.

Voir aussi : Expressions et données, Exécutions, Catalogue des nœuds.