Loading
CRM Analytics
Paramètres computeRelative

Vous êtes ici :

  1. Aide de Salesforce
  2. Documents
  3. CRM Analytics

Paramètres computeRelative

Lorsque vous définissez une transformation computeRelative, vous définissez computeRelative pour l'attribut d’action. Vous spécifiez également les paramètres de la source d'entrée, du champ de partition, du champ de tri et les définitions de champ dérivés.

Paramètres

Vous pouvez spécifier les paramètres dans les sections suivantes du nœud computeRelative.

Le tableau ci-dessous répertorie les paramètres de la section parameters.

Paramètre Requis ? Valeur
source Oui Nœud du fichier de définition du flux de données qui identifie la source d'entrée de cette transformation.
partitionBy Oui Nom d'API du champ utilisé pour partitionner les enregistrements dans le jeu de données. Spécifiez un seul champ de partition.
orderBy Oui

Champ utilisé pour trier les enregistrements dans chaque partition et l'ordre de tri : croissant (asc) ou descendant (desc). Spécifiez un seul champ de tri.

Exemple : 

"orderBy": [
    {                
        "name":"CreatedDate", 
        "direction":"asc"
     }
]
computedFields Oui

Une liste de définitions de champs dérivés. Les champs dérivés peuvent être basés sur un champ source ou une expression SAQL.

Exemples de champs dérivés basés sur un champ source ou une expression SAQL. 

"computedFields": [
                {
          "name": "PreviousAmount",
          "label": "Previous Amount",
          "description": "Previous amount of opportunity",
          "expression": {
            "sourceField": "Amount",
            "offset": "previous()",
            "default": "null"
          }
        },
        {
          "name": "AmountChange",
          "label": "Amount % Change",
          "description": "Percentage change from previous amount",
          "expression": {
            "saqlExpression": "(current(Amount)-previous(Amount))/previous(Amount)*100",
            "type": "Numeric",
            "scale": 2,
            "default": "null"
          }
        }
      ]

computedFields

Le tableau ci-dessous décrit les attributs de la section computedFields.

Paramètre Requis ? Valeur
name Oui Nom d'API du champ dérivé à ajouter au jeu de données. Le nom doit être unique dans le jeu de données. Si le nom n'est pas unique, l'exécution du jeu de données échoue.
label Non Le nom d'affichage du champ dérivé qui figure dans l'interface utilisateur de CRM Analytics. Il peut contenir jusqu'à 255 caractères. Applique par défaut le nom d'API s'il n'est pas spécifié.
description Non Description du champ dérivé, à titre d'information.
expression Oui

Attributs d'expression utilisés pour calculer la valeur du champ dérivé. L'expression peut être basée sur des champs d'entrée ou sur d'autres champs dérivés de la transformation.

Exemple : 

"expression": {
    "sourceField": "CloseDate",
    "offset": "previous()",
    "default": "01-01-1970"

expression

Le tableau ci-dessous décrit les attributs de la section expression lors de la création d'un champ dérivé basé sur un champ source.

Paramètre Requis ? Valeur
sourceField Oui Le nom d'API du champ d'entrée à partir du noeud source utilisé dans l'expression.
offset Oui

La fonction utilisée dans l'expression. Vous pouvez utiliser les fonctions suivantes :

current()
Obtient la valeur de l'enregistrement en cours.
Exemple : 
"offset": "current()"
first()
Obtient la valeur du premier enregistrement dans la partition, par exemple la première CreateDate d'une opportunité.
Exemple : 
"offset": "first()"
next()

Obtient la valeur de l'enregistrement suivant.

Exemple : 
"offset": "next()"
previous()
Obtient la valeur de l'enregistrement précédent.
Exemple : 
"offset": "previous()"

Les champs dérivés sont calculés dans l'ordre où ils ont été définis. Le calcul d'un champ dérivé peut être basé sur la valeur d'un autre champ dérivé à condition qu'elle soit déjà définie. Par exemple, next() n'accède pas à la valeur d'un champ dérivé dans la ligne suivante.

Pour obtenir les résultats corrects lors de l'utilisation des fonctions previous() et next(), la transformation computeRelative nécessite de trier les enregistrements.
par défaut Oui (pour des champs numériques uniquement)

La valeur par défaut si aucune ne peut être calculée. Par exemple, vous pouvez spécifier une valeur par défaut si aucune valeur précédente ou suivante n'existe. Vous pouvez insérer une valeur constante ou current() en tant que valeur par défaut.

Exemples :

"default": "3000-01-01T00:00:00.000Z" 
"default": "current()"

Le tableau ci-dessous décrit les attributs de la section expression lors de la création d'un champ dérivé basé sur une expression SAQL.

Paramètre Requis ? Valeur
saqlExpression Oui

Expression SAQL utilisée pour calculer la valeur du champ dérivé. L'expression peut être basée sur des champs d'entrée ou sur d'autres champs dérivés de la transformation. Vous pouvez utiliser les fonctions de décalage current(),first(),next() et previous() dans l'expression.

Exemple de calcul de l'évolution en pourcentage entre le montant précédent et le montant actuel :

"saqlExpression": "(current(Amount)-previous(Amount))/previous(Amount)*100"

Vous pouvez également utiliser l'opérateur de requête SAQL dans l'expression.

Exemple de sortie de la valeur Up, Down ou No Change en fonction de l'évolution entre le montant précédent et le montant actuel :

 "saqlExpression": "case when current(Amount)>previous(Amount) then \"Up\" when
      current(Amount)<previous(Amount) then \"Down\" else \"No Change\" end"
type Oui

Type de champ CRM Analytics associé au champ. Les types valides sont Date, Numérique et Texte.

Exemple :

"type": "Text"
scale Non

Le nombre de chiffres à droite de la virgule dans une valeur numérique.

Exemple :

"scale": 2
par défaut Oui (pour des champs numériques uniquement)

La valeur par défaut si aucune ne peut être calculée.

Exemple :

"default": "null"
 
Chargement
Salesforce Help | Article