Parametri sfdcDigest

Esegue una sincronizzazione incrementale, che estrae solo le modifiche apportate all'oggetto Salesforce dopo l'ultima esecuzione del flusso di dati. Valori validi: vero o falso. Sincronizzazione incrementale:

• È disponibile se è stata abilitata la sincronizzazione dei dati.
• Non è supportata per gli oggetti Big Object di Salesforce.

Esegue un'unica estrazione completa per sincronizzare i dati della serie di dati con i dati presenti nell'oggetto Salesforce. Specificare qualsiasi valore per questo parametro.

Dopo l'estrazione completa, il flusso di dati esegue ogni volta un'estrazione incrementale anche se il parametro fullRefreshToken è incluso nella definizione del flusso di dati. Per eseguire nuovamente un'estrazione completa, modificare il valore del parametro fullRefreshToken impostandolo su un valore diverso.

la sincronizzazione incrementale è disponibile se è stata abilitata la sincronizzazione dei dati.

Una matrice dei nomi di tutti i campi dai quali si desidera estrarre i dati per l'oggetto Salesforce specificato. La trasformazione sfdcDigest non supporta l'estrazione da tutti i tipi di campi.

Vedere Attributi dei campi.

Filtro che limita i record estratti dall'oggetto Salesforce specificato. La trasformazione sfdcDigest estrae tutti i record dall'oggetto Salesforce per cui è vero il filtro. È possibile specificare un filtro strutturato o avanzato.

Vedere Parametri delle condizioni di filtro.

Utilizzato per campi di testo e numerici che possono essere nulli. I campi numerici possono avere un null letterale, mentre i campi di testo possono avere “null”. Valore predefinito che sostituisce un valore nullo per il campo specificato. Immettere un valore di stringa.

Esempio: "defaultValue": "0"

Tipo di campo di CRM Analytics associato al campo specificato. I tipi validi sono Testo, Numerico o Data. Tutti i valori, anche quelli numerici, possono essere di tipo Testo. Ad esempio, per impostazione predefinita, il trimestre fiscale degli oggetti Salesforce è di tipo Numero. È tuttavia possibile cambiarlo in Testo. Specificare un tipo per sovrascrivere il tipo determinato da CRM Analytics.

Esempio: "type": "Text"

non è possibile modificare il tipo di un campo su Numerico o Data.

Solo per i campi di data. La differenza, in mesi, tra il primo mese dell'anno fiscale e il primo mese dell'anno di calendario (gennaio). Ad esempio, se l'anno fiscale inizia in gennaio, la differenza è 0. Se l'anno fiscale inizia in ottobre, la differenza è 9.

Esempio: "fiscalMonthOffset": 9

Questo attributo controlla anche se CRM Analytics genera campi data fiscale. Per generare campi data fiscale, impostare fiscalMonthOffset su un valore diverso da 0.

CRM Analytics non supporta i campi con valori di fiscalMonthOffset diversi nella stessa serie di dati. L'uso di valori di fiscalMonthOffset diversi può generare risultati imprevisti quando si filtra in base a intervalli di date fiscali relativi. Si consiglia di impostare lo stesso valore per tutti gli attributi fiscalMonthOffset di una serie di dati.

Solo per i campi di data. Indica se l'anno fiscale è l'anno nel quale l'anno fiscale inizia o finisce. Poiché l'anno fiscale può iniziare in un anno di calendario e terminare in un altro, è necessario specificare quale anno utilizzare per l'anno fiscale.

• Se impostato su True, l'anno fiscale è l'anno in cui finisce l'anno fiscale. Il valore predefinito è True.
• Se impostato su false, l'anno fiscale è l'anno nel quale inizia l'anno fiscale.

Esempio: "isYearEndFiscalYear": true

Questo campo è rilevante solo quando fiscalMonthOffset è maggiore di 0.

CRM Analytics non supporta i campi con valori di isYearEndFiscalYear diversi nella stessa serie di dati. L'uso di valori di isYearEndFiscalYear diversi può generare risultati imprevisti quando si filtra in base a intervalli di date fiscali relativi. Si consiglia di impostare lo stesso valore per tutti gli attributi isYearEndFiscalYear di una serie di dati.

Solo per i campi di data. Il primo giorno della settimana per l'anno di calendario e, se applicabile, l'anno fiscale. Utilizzare 0 per impostare come primo giorno Domenica, 1 per impostare come primo giorno Lunedì e così via. Utilizzare -1 per impostare il 1° gennaio come primo giorno. L'impostazione predefinita è -1.

Esempio: "firstDayOfWeek": 0

CRM Analytics non supporta i campi con valori di firstDayOfWeek diversi nella stessa serie di dati. L'uso di valori di firstDayOfWeek diversi può generare risultati imprevisti quando si filtra in base a intervalli di date settimanali relativi. Si consiglia di impostare lo stesso valore per tutti gli attributi firstDayOfWeek di una serie di dati.

Solo per i campi di testo. Indica se il campo specificato dispone di valori multipli.

Esempio: "isMultiValue": false

Solo per i campi di testo. Singolo carattere usato per separare i valori multipli nel campo specificato quando isMultiValue è True (vero). Questo valore viene impostato sul punto e virgola (;) se non si specifica alcun valore e isMultiValue è uguale a true. Impostare su nullo quando isMultiValue è falso.

Esempio: "multiValueSeparator": ";"

Numero massimo di cifre in un valore numerico, oppure lunghezza di un valore di testo. Per i valori numerici: Include tutti i numeri a sinistra e a destra della virgola decimale (ma esclude il carattere virgola decimale). Il valore deve essere compreso tra 1 e 18 (inclusi). Per i valori di testo: Il valore viene impostato automaticamente su 255 caratteri e deve essere compreso tra 1 e 32.000 caratteri (inclusi).

Esempio: "precision": 10

Numero di cifre a destra della virgola decimale in un valore numerico. Deve essere inferiore al valore della precisione. Il valore deve essere compreso tra 0 e 17 caratteri (inclusi).

Esempio: "scale": 2

Il campo dell'oggetto Salesforce a cui si desidera applicare una condizione di filtro. Ogni condizione di filtro in un filtro strutturato utilizza la seguente sintassi:

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

Lo scopo dipende dal contesto.

• operator può essere utilizzato come operatore di confronto, ad esempio =, < e IN, che confronta il valore del campo con un valore costante.
• operator può anche essere utilizzato come operatore logico (AND, OR o NOT) che collega più condizioni di filtro.

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

Indica se è stato citato il valore di stringa in una condizione di filtro.

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

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

Se non si include isQuoted per un filtro in un valore di stringa, CRM Analytics presume che il valore di stringa non sia citato e aggiunge le virgolette.