QuerySalesforceObject 2025.5.31.15

Bundle

org.apache.nifi | nifi-salesforce-nar

Description

Récupère les enregistrements d’un objet Salesforce sObject. Les utilisateurs peuvent ajouter des conditions de filtrage arbitraires en définissant la propriété “Custom WHERE Condition”. Le processeur peut également exécuter une requête personnalisée, bien que le traitement des enregistrements ne soit pas pris en charge dans ce cas. Prend en charge la récupération incrémentielle : les utilisateurs peuvent définir un champ dans la propriété “Age Field” qui sera utilisé pour déterminer la date de création de l’enregistrement. Lorsque cette propriété est définie, le processeur récupérera les nouveaux enregistrements. Le chargement incrémentiel et le traitement basé sur les enregistrements sont uniquement pris en charge dans les requêtes basées sur des propriétés. Il est également possible de définir une valeur seuil initiale pour l’âge, ce qui permet de filtrer tous les enregistrements plus anciens, même lors de la première exécution. Dans le cas d’une requête basée sur la propriété, ce processeur doit être exécuté uniquement sur le nœud principal. L’attribut FlowFile “record.count” indique combien d’enregistrements ont été récupérés et écrits dans la sortie. Le processeur peut accepter une entrée facultative FlowFile et faire référence aux attributs FlowFile dans la requête. Lorsque “Include Deleted Records” est défini sur “true”, le processeur inclura les enregistrements supprimés (suppressions logiques) dans les résultats en utilisant le “queryAll” API. Le champ “IsDeleted” sera automatiquement inclus dans les résultats lors de la requête d’enregistrements supprimés.

Balises

query, salesforce, sobject, soql

Exigences en matière d’entrées

ALLOWED

Prend en charge les propriétés dynamiques sensibles

false

Propriétés

Propriété

Description

age-delay

L’horodatage de fin de la fenêtre temporelle sera avancé de la valeur configurée dans cette propriété. Par exemple, avec une valeur de propriété de 10 secondes, un horodatage de fin de 12:30:45 sera remplacé par 12:30:35.

age-field

Nom d’un champ TIMESTAMP qui sera utilisé pour filtrer les enregistrements à l’aide d’une fenêtre temporelle délimitée. Le processeur ne renverra que les enregistrements dont l’horodatage est plus récent que l’horodatage enregistré après la dernière exécution du processeur.

create-zero-record-files

Indique s’il faut ou non créer un FlowFile lorsque le REST API de Salesforce ne renvoie aucun enregistrement

custom-soql-query

Indique la requête SOQL à exécuter.

custom-where-condition

Une expression personnalisée à ajouter dans la clause WHERE de la requête

field-names

Liste séparée par des virgules des noms de champs demandés à l’objet sObject devant faire l’objet d’une requête. Si ce champ n’est pas renseigné, tous les champs font l’objet d’une requête.

include-deleted-records

Si c’est le cas, le processeur inclura les enregistrements supprimés (IsDeleted = true) dans les résultats de la requête. Lorsque cette option est activée, le processeur utilise la fonction “queryAll” API.

initial-age-filter

Cette propriété indique l’heure de début que le processeur applique lors de l’exécution de la première requête.

oauth2-access-token-provider

Service fournissant des jetons d’accès à OAuth2 pour l’authentification à l’aide de l’en-tête d’autorisation HTTP

query-type

Choisissez de fournir la requête par paramètres ou une requête personnalisée complète.

read-timeout

Temps maximum autorisé pour la lecture d’une réponse de la part de Salesforce REST API

record-writer

Service utilisé pour écrire les enregistrements renvoyés par la base de données Salesforce REST API

salesforce-api-version

Le numéro de version de Salesforce REST API ajouté à URL après le chemin des services/données. Consultez la documentation de Salesforce pour connaître les versions prises en charge

salesforce-url

L’URL de l’instance Salesforce, y compris le domaine sans informations de chemin supplémentaires, tel que https://MyDomainName.my.salesforce.com

sobject-name

L’objet Salesforce sObject à interroger

Gestion de l’État

Champs d’application

Description

CLUSTER

Lorsque “Age Field” est défini, après l’exécution d’une requête, l’heure d’exécution est enregistrée. Les requêtes suivantes seront complétées par une condition supplémentaire afin que seuls les enregistrements plus récents que l’heure d’exécution enregistrée (ajustée avec la valeur facultative de “Age Delay”) soient récupérés. L’état est stocké dans le clustering afin que ce processeur puisse être exécuté sur le nœud principal uniquement et que, si un nouveau nœud principal est sélectionné, le nouveau nœud puisse reprendre là où le précédent s’est arrêté, sans dupliquer les données.

Relations

Nom

Description

failure

Le FlowFile d’entrée est envoyé vers cette relation lorsque la requête échoue.

original

Le FlowFile d’entrée est envoyé vers cette relation lorsque la requête réussit.

success

Pour les FlowFiles créés à la suite d’une requête réussie.

Écrit les attributs

Nom

Description

mime.type

L’ensemble de l’attribut mime.type est défini sur le type MIME spécifié par le Record Writer.

record.count

Définit le nombre d’enregistrements dans le FlowFile.

total.enregistrement.count

Définit le nombre total d’enregistrements dans le FlowFile.

Voir aussi :