Paramètres sfdcDigest

Effectue une synchronisation incrémentielle, qui extrait uniquement les modifications apportées à l'objet Salesforce depuis la dernière exécution du flux de données. Les valeurs valides sont : true ou false. Synchronisation incrémentielle :

• Disponible si vous avez activé la synchronisation des données.
• N'est pas prise en charge pour les big objects Salesforce.

Effectue une extraction complète unique pour synchroniser les données du jeu de données avec celles de l'objet Salesforce. Spécifiez n'importe quelle valeur pour ce paramètre.

Après l'extraction complète, le flux de données effectue toujours une extraction incrémentielle, même lorsque paramètre fullRefreshToken est inclus dans la définition du flux de données. Pour exécuter une nouvelle extraction complète, changez la valeur du paramètre fullRefreshToken.

La synchronisation incrémentielle est disponible si vous avez activé la synchronisation des données.

Un groupe de noms composé de tous les champs de l'objet Salesforce spécifié à partir desquels vous souhaitez extraire des données. La transformation sfdcDigest ne prend pas en charge l'extraction à partir de tous les types de champ.

Consulter les Attributs utilisateur.

Un filtre qui limite les enregistrements extraits de l'objet Salesforce spécifié. La transformation sfdcDigest extrait tous les enregistrements de l'objet Salesforce pour lequel le filtre est défini sur true. Vous pouvez spécifier un filtre structuré ou avancé.

Consultez les Paramètres des conditions de filtrage.

Utilisé pour des champs de texte et numériques qui peuvent être nuls. Les champs numériques peuvent inclure un littéral null, alors que les champs de texte peuvent inclure “null”. Une valeur par défaut remplace une valeur nulle pour le champ spécifié. Saisissez une valeur de chaîne.

Exemple : "defaultValue": "0"

Type de champ CRM Analytics associé au champ spécifié. Les types valides sont Texte, Numérique ou Date. Toutes les valeurs, y compris les valeurs numériques, peuvent être des valeurs de Texte. Par exemple, par défaut le trimestre fiscal des objets Salesforce est une valeur numérique. Vous pouvez toutefois le changer en valeur de texte. Spécifiez un type pour remplacer le type déterminé par CRM Analytics.

Exemple : "type": "Text"

Vous ne pouvez pas modifier le type d’un champ sur Numérique ou Date.

Pour des champs de date uniquement. Spécifiez la différence, en mois, entre le premier mois de l'exercice fiscal et le premier mois de l'année civile (janvier). Par exemple, si l'exercice fiscal commence en janvier, le décalage est de 0. Si l'exercice fiscal commence en octobre, le décalage est de 9.

Exemple : "fiscalMonthOffset": 9

Cet attribut détermine également si CRM Analytics génère des champs de date fiscale. Pour générer des champs de date fiscale, donnez à fiscalMonthOffset une valeur autre que 0.

CRM Analytics ne prend pas en charge les champs avec des valeurs fiscalMonthOffset différentes dans le même jeu de données. L'utilisation de valeurs fiscalMonthOffset différentes peut entraîner des résultats inattendus lorsque vous filtrez par plages de dates fiscales relatives. Nous recommandons de définir les mêmes valeurs pour tous les attributs fiscalMonthOffset d'un jeu de données.

Pour des champs de date uniquement. Indique si l'exercice fiscal est l'année au cours de laquelle l'exercice fiscal commence ou se termine. L'exercice fiscal peut commencer au cours d'une année civile et se terminer dans une autre ; par conséquent, vous devez spécifier quelle année utiliser pour l'exercice fiscal.

• Si la valeur est true, alors l'exercice fiscal est l'année au cours de laquelle l'exercice fiscal se termine. La valeur par défaut est true.
• Si la valeur est false, alors l'exercice fiscal est l'année au cours de laquelle l'exercice fiscal commence.

Exemple : "isYearEndFiscalYear": true

Ce champ s'applique uniquement lorsque fiscalMonthOffset est supérieur à 0.

CRM Analytics ne prend pas en charge les champs avec des valeurs isYearEndFiscalYear différentes dans le même jeu de données. L'utilisation de valeurs isYearEndFiscalYear différentes peut entraîner des résultats inattendus lorsque vous filtrez par plages de dates fiscales relatives. Nous recommandons de définir les mêmes valeurs pour tous les attributs isYearEndFiscalYear d'un jeu de données.

Pour des champs de date uniquement. Le premier jour de la semaine pour l'année civile et, le cas échéant, l'exercice fiscal. Utilisez 0 pour définir le premier jour sur Dimanche, 1 pour définir le premier jour sur Lundi, et ainsi de suite. Utilisez -1 pour définir le premier jour sur 1er janvier. La valeur par défaut est -1.

Exemple : "firstDayOfWeek": 0

CRM Analytics ne prend pas en charge les champs avec des valeurs firstDayOfWeek différentes dans le même jeu de données. L'utilisation de valeurs firstDayOfWeek différentes peut entraîner des résultats inattendus lorsque vous filtrez par plages de dates hebdomadaires relatives. Nous recommandons de définir les mêmes valeurs pour tous les attributs firstDayOfWeek d'un jeu de données.

Pour des champs de date uniquement. Indique si le champ spécifié a plusieurs valeurs.

Exemple : "isMultiValue": false

Pour des champs de date uniquement. Caractère unique utilisé pour séparer les valeurs multiples dans le champ spécifié lorsque isMultiValue est true. Si vous ne spécifiez aucune valeur et que isMultiValue est égal à true, cette valeur applique par défaut le point-virgule (;). Défini sur null lorsque isMultiValue est false.

Exemple : "multiValueSeparator": ";"

Le nombre maximal de chiffres dans une valeur numérique, ou la longueur d'une valeur de texte. Pour des valeurs numériques : comprend tous les chiffres à gauche et à droite de la virgule (mais pas la virgule). Doit être une valeur de 1 à 18. Pour des valeurs de texte : comprend par défaut 255 caractères et doit être une valeur de 1 à 32 000 caractères.

Exemple : "precision": 10

Le nombre de chiffres à droite de la virgule dans une valeur numérique. Doit être inférieur à la valeur precision. Doit être une valeur de 0 à 17 caractères.

Exemple : "scale": 2

Le champ de l'objet Salesforce auquel vous souhaitez appliquer la condition de filtrage. Chaque condition de filtrage d'un filtre structuré utilise la syntaxe suivante :

{ 
"field": "<field name>", 
"operator": "<operator>", 
"value": "<value>", 
"isQuoted": true|false}

L'objet dépend du contexte.

• operator peut être utilisé en tant qu'opérateur de comparaison (par exemple =, <, et IN) qui compare la valeur du champ à une valeur constante.
• operator peut également être utilisé en tant qu'opérateur logique (AND, OR ou NOT) qui associe plusieurs conditions de filtrage.

"filterConditions": [
   {
      "operator": "OR",
      "conditions": [
         {
            "field": "StageName",
            "operator": "=",
            "value": "Closed Won"
         },
         {
            "field": "Probability",
            "operator": ">=",
            "value": "90"
         }
      ]
   }
]

Indique si vous avez commenté la valeur de chaîne dans une condition de filtrage.

"filterConditions": [
   {
   "field": "StageName",
   "operator": "IN",
   "value": "('Closed Won', 'Closed Lost')",
   "isQuoted": true
   }
]

"filterConditions": [
   {
   "field": "StageName",
   "operator": "IN",
   "value": ["Closed Won", "Closed Lost"],
   "isQuoted": false
   }
]

Si vous n'incluez pas isQuoted pour un filtre dans une valeur de chaîne, CRM Analytics considère que la valeur de chaîne n'est pas commentée et ajoute les guillemets pour vous.