Curseur

Cette carte de fonction est uniquement disponible dans Workflows Connector Builder.

Cette carte de fonction fonctionne uniquement dans un flux d'événement de moniteur de scrutation.

Lorsque la carte Curseur s'exécute, elle enregistre une valeur dans les métadonnées du flux qui peut être utilisée pour filtrer les requêtes API pour les exécutions planifiées du moniteur de scrutation.

Cette valeur est spécifique à chaque flux que vos utilisateurs créent avec votre moniteur de scrutation déployé.

En général, le curseur stocke une valeur d'horodatage à utiliser comme filtre de requête API. Il peut également stocker des valeurs d'état pour la requête de scrutation, par exemple, une liste d'identifiants précédemment enregistrés.

L'implémentation la plus simple pour un curseur dans les événements de moniteur de scrutation consiste à interroger l'API à l'aide d'un horodatage. Cette méthode renvoie des enregistrements nouveaux ou mis à jour et ne nécessite pas un objet curseur complexe pour conserver d'autres métadonnées entre les interrogations.

Ajoutez une carte Curseur

Lorsque vous créez un événement de moniteur de scrutation dans Connector Builder, la carte d'événement inclut une sortie nommée Curseur. La création de l'événement de scrutation ajoute également cette carte de fonction Curseur qui comprend une seule entrée nommée Propriétés et n'a pas de sorties.

Chaque fois que le de scrutation s'exécute, la valeur transmise dans le champ Propriétés devient la nouvelle valeur du champ Curseur sur la carte d'événement Moniteur de surveillance.

La carte Curseur prend en charge les types suivants : Date & Time, Number, Text et Object. Vous pouvez utiliser le format requis pour construire le filtre de votre appel API. Les types spécifiés dans le champ Curseur de la carte Moniteur de scrutation et le champ d'entrée Propriétés de la carte de fonction Curseur doivent correspondre.

Mettre à jour la carte Moniteur de scrutation

La première fois que le moniteur de scrutation s'exécute, le champ Curseur de la carte d'événement Moniteur de scrutation est vide, votre flux doit donc gérer cette exécution initiale. Si le champ Curseur est vide, ignorez la carte qui invoque l'API pour récupérer les enregistrements. Initialisez le curseur, par exemple, avec une carte de fonction Maintenant si vous utilisez un horodatage pour le curseur. Toutes les exécutions suivantes du moniteur de scrutation ont un champ Curseur avec une valeur car le flux invoque la carte Curseur à chaque fois.

Utiliser le curseur pour le filtrage des requêtes

Pour les exécutions futures, le champ Curseur de la carte Moniteur de scrutation inclut la valeur assignée de l'exécution précédente. Le flux utilise cette valeur comme point de départ pour le filtre de la requête API, par exemple, comme paramètre appelé startDate.

Créez un autre point de données comme point de fin pour la requête API. Par exemple, l'invocation de la carte de fonction Now fournit un nouveau paramètre endDate. Vous pouvez ensuite fournir les paramètres startDate et endDate à la requête API. Les noms des paramètres dépendent des noms de filtres spécifiés par votre service API. La fenêtre temporelle est la durée entre la dernière exécution du moniteur de scrutation et l'exécution actuelle du moniteur de scrutation.

Utilisez les paramètres startDate et endDate comme filtres pour votre requête API. Après avoir récupéré les enregistrements, le flux met à jour le champ Propriétés de la carte Curseur pour une utilisation lors de la prochaine exécution planifiée.

Pour un exemple de flux d'événement de moniteur de scrutation avec la carte Curseur, consultez Créer un flux d'événement de moniteur de scrutation.

Entrée

Sortie

Cette carte n'a pas de champ de sortie.