Loading
CRM Analytics
Parâmetros de computeRelative

Você está aqui:

  1. Ajuda do Salesforce
  2. Documentação
  3. CRM Analytics

Parâmetros de computeRelative

Ao definir uma transformação computeRelative, você define o atributo de ação como computeRelative. Você também especifica os parâmetros para a origem de entrada, o campo de particionamento, o campo de classificação e as definições de campos derivados.

Parâmetros

Você pode especificar parâmetros nas seguintes seções do nó computeRelative.

A tabela a seguir descreve os parâmetros da seção parameters.

Parâmetro Obrigatório? Valor
origem Sim Nó no arquivo de definição de fluxo de dados que identifica a origem de entrada para essa transformação.
partitionBy Sim Nome de API do campo usado para particionar os registros no conjunto de dados. Especifique somente um campo de particionamento.
orderBy Sim

Campo usado para classificar os registros dentro de cada partição, e a ordem de classificação: crescente (asc) ou decrescente (desc). Especifique somente um campo de classificação.

Exemplo: 

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

Uma lista de definições para campos derivados. Os campos derivados podem ser baseados em um campo de origem ou em uma expressão SAQL.

Exemplo mostrando campos derivados com base em um campo de origem e em uma expressão 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

A tabela a seguir descreve os atributos na seção computedFields.

Parâmetro Obrigatório? Valor
nome Sim Nome de API do campo derivado para adicionar ao conjunto de dados. O nome deve ser exclusivo no conjunto de dados. Se o nome não for exclusivo, a execução do fluxo de dados falhará.
rótulo Não O nome de exibição do campo derivado que aparece na interface do usuário do CRM Analytics. Pode ter até 255 caracteres. Usa como padrão o nome da API se não for especificado.
descrição Não Descrição do campo derivado apenas para informação.
expression Sim

Atributos de expressão usados para calcular o valor do campo derivado. A expressão pode ser baseada em campos de entrada ou em outros campos derivados na transformação.

Exemplo: 

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

expression

A tabela a seguir descreve os atributos na seção expression ao criar um campo derivado com base em um campo de origem.

Parâmetro Obrigatório? Valor
sourceField Sim Nome da API do campo de entrada do nó de origem usado na expressão.
offset Sim

A função usada na expressão. Você pode usar as seguintes funções:

current()
Obtém o valor do registro atual.
Exemplo: 
"offset": "current()"
first()
Obtém o valor do primeiro registro na partição, como o primeiro CreateDate de uma oportunidade.
Exemplo: 
"offset": "first()"
next()

Obtém o valor do próximo registro.

Exemplo: 
"offset": "next()"
previous()
Obtém o valor do registro anterior.
Exemplo: 
"offset": "previous()"

Campos derivados são calculados na ordem em que são definidos. O cálculo de um campo derivado pode ser baseado no valor de outro campo derivado, desde que este já tenha sido definido. Por exemplo, next() não pode acessar o valor de um campo derivado na próxima linha.

Para obter os resultados corretos ao usar as funções previous() e next(), a transformação computeRelative requer que você classifique os registros.
padrão Sim (somente para campos numéricos)

O valor padrão, se não for possível calcular um. Por exemplo, você pode especificar um valor padrão quando não existe um valor anterior ou próximo. Você pode inserir um valor constante ou current() como valor padrão.

Exemplos:

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

A tabela a seguir descreve os atributos na seção expression ao criar um campo derivado com base em uma expressão SAQL.

Parâmetro Obrigatório? Valor
saqlExpression Sim

Expressão SAQL usada para calcular o valor do campo derivado. A expressão pode ser baseada em campos de entrada ou em outros campos derivados na transformação. Você pode usar as funções de deslocamento current(), first(), next() e previous() na expressão.

Exemplo para calcular a variação percentual do valor anterior para o valor atual:

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

Você também pode usar o operador de caso SAQL na expressão.

Exemplo para valores de saída Up, Down ou No Change com base na mudança do valor anterior para o valor atual:

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

O tipo de campo do CRM Analytics associado ao campo. Os tipos válidos são Data, Numérico e Texto.

Exemplo:

"type": "Text"
scale Não

O número de dígitos à direita do separador decimal em um valor numérico.

Exemplo:

"scale": 2
padrão Sim (somente para campos numéricos)

O valor padrão, se não for possível calcular um.

Exemplo:

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