Loading
CRM Analytics
Parámetros de computeRelative

Usted está aquí:

  1. Ayuda de Salesforce
  2. Documentos
  3. CRM Analytics

Parámetros de computeRelative

Cuando define una transformación computeRelative, establece el atributo de acción en computeRelative. También especifica los parámetros para la fuente de entrada, campo de partición, campo de clasificación y definiciones de campo derivadas.

Parámetros

Puede especificar los parámetros en las siguientes secciones del nodo computeRelative.

La siguiente tabla describe los parámetros de la sección parameters.

Parámetro ¿Obligatorio? Valor
source Sí Nodo del archivo de definición de flujo de datos que identifica la fuente de entrada para esta transformación.
partitionBy Sí Nombre de API del campo utilizado para dividir los registros en el conjunto de datos. Especifique solo un campo de división.
orderBy Sí

Campo utilizado para ordenar los registros en cada partición y el orden de clasificación: ascendente (asc) o descendente (desc). Especifique solo un campo de ordenación.

Ejemplo: 

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

Una lista de definiciones para campos derivados. Los campos derivados se pueden basar en un campo de origen o una expresión de SAQL.

Ejemplo mostrando campos derivados basándose en un campo de origen y una expresión de 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

La siguiente tabla describe los atributos de la sección computedFields.

Parámetro ¿Obligatorio? Valor
name Sí Nombre de API del campo derivado para agregar al conjunto de datos. El nombre debe ser exclusivo dentro del conjunto de datos. Si el nombre no es exclusivo, fallará la ejecución del flujo de datos.
label No El nombre de visualización del campo derivado que aparece en la interfaz de usuario de CRM Analytics. Puede tener hasta 255 caracteres. Toma como valor predeterminado el nombre de API si no se especifica.
descripción No Descripción del campo derivado únicamente para información.
expression Sí

Atributos de expresión utilizados para calcular el valor del campo derivado. La expresión puede basarse en campos de entrada u otros campos derivados en la transformación.

Ejemplo: 

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

expression

La siguiente tabla describe los atributos en la sección expression al crear un campo derivado basándose en un campo de origen.

Parámetro ¿Obligatorio? Valor
sourceField Sí Nombre de API del campo de entrada desde el nodo de origen que se utiliza en la expresión.
offset Sí

La función utilizada en la expresión. Puede utilizar las siguientes funciones:

current()
Obtiene el valor del registro actual.
Ejemplo: 
"offset": "current()"
first()
Obtiene el valor del primer registro en la partición, como la primera Fecha de creación para una oportunidad.
Ejemplo: 
"offset": "first()"
next()

Obtiene el valor del siguiente registro.

Ejemplo: 
"offset": "next()"
previous()
Obtiene el valor del registro anterior.
Ejemplo: 
"offset": "previous()"

Los campos derivados se calculan en el orden en que están definidos. El cálculo de un campo derivado puede basarse en el valor de otro campo derivado siempre y cuando ya esté definido. Por ejemplo, next() no puede acceder al valor de un campo derivado en la siguiente fila.

Para obtener los resultados correctos al utilizar las funciones previous() y next(), la transformación computeRelative le requiere ordenar los registros.
predeterminado Sí (solo para campos numéricos)

El valor predeterminado si no se puede calcular alguno. Por ejemplo, puede especificar un valor predeterminado cuando no existe ningún valor anterior o siguiente. Puede insertar un valor constante o current() como un valor predeterminado.

Ejemplos:

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

La siguiente tabla describe los atributos en la sección expression al crear un campo derivado basándose en una expresión de SAQL.

Parámetro ¿Obligatorio? Valor
saqlExpression Sí

Expresión SAQL utilizada para calcular el valor del campo derivado. La expresión puede basarse en campos de entrada u otros campos derivados en la transformación. Puede utilizar las funciones de compensación current()first(),next() y previous() en la expresión.

Ejemplo para calcular el cambio de porcentaje desde el importe anterior al importe actual:

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

También puede utilizar el operador de caso de SAQL en la expresión.

Ejemplo para imprimir valores de Hacia arriba, Hacia abajo o Sin cambios basándose en el cambio desde el importe anterior al importe actual:

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

Tipo de campo de CRM Analytics asociado con el campo. Los tipos válidos son Fecha, Numérico y Texto.

Ejemplo:

"type": "Text"
scale No

El número de dígitos a la derecha del punto decimal en un valor numérico.

Ejemplo:

"scale": 2
predeterminado Sí (solo para campos numéricos)

El valor predeterminado si no se puede calcular alguno.

Ejemplo:

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