Sobre os Atributos Calculados

Os atributos calculados são somente para leitura.

Os administradores podem adicionar atributos calculados às seções de atributos nas caixas de diálogo Ações, e os usuários do workflow podem exibi-los nas caixas de diálogo de ações e nas transações. Os administradores podem restringir o acesso a determinadas funções definindo o acesso como Não Exibir. Por exemplo, para o atributo XYZ calculado, um administrador pode adicionar a ele o acesso Visualizador: Não Exibir, de modo que XYZ não seja exibido aos visualizadores.

Qualquer função de usuário pode adicionar atributos calculados como colunas nas exibições e listas. Eles também podem ser adicionados como atributos filtráveis no painel de Filtro.

A seguinte tabela lista os tipos de cálculo que cada tipo de atributo pode usar quando a opção Cálculo é escolhida:

Table 4-1 Os Tipos de Cálculo que Cada Tipo de Atributo Pode Usar Quando a Opção de Cálculo é Escolhida

Tipo de Atributo Atribuir Valor à Lista Condicional Com Script Atribuir Lista ao Valor
Data     X  
Data/Hora     X  
Inteiro X X X  
Lista   X   X
Texto de Várias Linhas X X X  
Número X X X  
Texto X X X  
Verdadeiro/Falso   X    
Usuário        
Sim/Não   X    

Exemplos de Funções com Script:

Para todas as funções numéricas, qualquer valor nulo na entrada é ignorado durante o cálculo do resultado.

  • Adicionar Mês: Retorna um deslocamento de data; um número especificado de meses a contar da data inicial. A data sempre incorrerá no deslocamento do mês especificado. Se a data inicial tiver um valor de dia além do que está no mês de deslocamento, será usado o último dia do mês de deslocamento. Por exemplo, EDate (31 de janeiro de 2017) retornará (28 de fevereiro de 2017). Em Meses, informe o número de meses antes ou depois das data de início. Um valor positivo para meses produz uma data futura. Um valor negativo produz uma data passada.

    EDate(<Data de Início>, <Meses>, <Duração>)

    Example: EDate(DATE(2017, 2, 15) 3)

  • Função de Média Anterior: Calcula a média de um valor numérico durante os X períodos anteriores.

    AVERAGE_PRIOR(<Valor>, <Número de Períodos>, <Moeda de Destino*>, <Tipo de Taxa*>, <Período da Taxa*>

    Exemplo: AVERAGE_PRIOR( {Saldo do Sistema de Origem (Relatório)}, '2', 'EUR', 'REC')

    Note:

    Os parâmetros com um asterisco, *, serão obrigatório se o valor for um atributo do tipo saldo, como Sistema de Origem. Se o valor for um valor comum (como um atributo numérico), os parâmetros * deverão ser omitidos.

    Note:

    O Tipo de Taxa deve ser um tipo de taxa válido no sistema, ou o valor "REC", o que significa usar o tipo de taxa atribuído à reconciliação. O parâmetro Período da Taxa deve ser "CURRENT" ou "PRIOR", o que significa usar os tipos de taxa do período atual ou período anterior ao converter a moeda.
  • Data: Retorna um valor de data com base nos valores de inteiro especificados para ano, mês e dia. Por exemplo, essa função cria um valor do tipo Data. Assim, DATE(2018, 5, 31) seria convertido em 31 de maio de 2018. Isso pode ser usado, então, na função Diferença de Data para extrair a diferença em dias entre uma data, como uma data de término, e a data específica.

    DATE(<Ano>, <Mês>, <Dia>)

    Você também pode usar as datas PERIOD START, PERIOD END, ou PERIOD CLOSE na criação de um atributo de dados calculado. Por exemplo, se você quisesse comparar a Data de Fechamento em uma transação de Ajuste com a data PERIOD END.

  • Diferença de Datas: Retorna a diferença em dias, horas, minutos ou segundos entre duas datas. Para Data 1 e Data 2, os valores 'TODAY' e 'NOW' podem ser usados, que denotam a data atual (sem componente de tempo) e a data/hora, respectivamente.

    Os tipos válidos são DAYS, HOURS, MINUTES, SECONDS.

    DATE_DIFF(<Data1>, <Data2>, <Tipo>)

    Exemplo: DATE_DIFF('TODAY', {Data Final do Preparador}, 'DAYS') ou DATE_DIFF({Data Final do Preparador}, 'NOW', 'HOURS')

  • Dia: Retorna o valor de dia de uma data como um número inteiro

    DAY(<DATE>)

  • Texto de Extração: Retorna a substring contida no valor, a partir das posições especificadas. Extrair Texto/Localização do Texto usa o valor 1 para o primeiro caractere.

    SUBSTRING(<Valor>, <Localização>, <Tamanho>)

    Example: SUBSTRING( {Name} , 5, 10)

  • Instrução If Then Else: Permite que o usuário insira um cálculo condicional no cálculo com script. Os cálculos IF_THEN_ELSE também podem ser aninhados para suportar os tipos de cálculos "ELSE IF".

    IF_THEN_ELSE(<Condição>, <Valor1>, <Valor2>)

    Example:

    IF_THEN_ELSE( {Risk Rating} = 'Low', 'Good',
    IF_THEN_ELSE( {Risk Rating} = 'Medium', 'Better',
    IF_THEN_ELSE({Risk Rating} = 'High', 'Best','Bad')))
    
  • String Interna: Retorna o índice da substring dentro do valor.

    INSTRING(<Valor1>, <Valor a Pesquisar>)

    Exemplo: INSTRING({Nome}, 'a')

  • Tamanho: usa um valor de texto como parâmetro e retorna um número inteiro que é o número de caracteres no texto.

    LENGTH('Valor') retorna 5, e LENGTH({Name}) retornaria o número de caracteres no nome do objeto. Se o valor estiver vazio/nulo, o cálculo retornará 0.

    Use o cálculo com SUBSTRING para extrair os últimos 4 caracteres de um valor de texto.

    Exemplo: SUBSTRING( {MyString}, LENGTH ({MyString}) - 4

  • Minúsculas: Retorna o valor em minúsculas.

    LOWERCASE(<Value>)

    Example: LOWERCASE( {Description} )

  • Máximo: Retorna o valor máximo de uma lista de atributos. Pode haver um número qualquer de parâmetros.

    MAX(<Valor1>, <Valor2>,<ValorN>)

    Exemplo: MAX( TRANSLATE( {Saldo do Sistema de Origem de Origem (Informado)}, 'USD', 'Contábil'), TRANSLATE( {Saldo do Sistema de Origem (Funcional)}, 'USD', 'Contábil'), TRANSLATE( {Saldo do Sistema de Origem (Relatório)}, 'USD', 'Contábil') )

  • Máximo Anterior: Retorna o valor máximo durante os X períodos anteriores.

    MAX_PRIOR (<Valor>, <Número de Períodos>, <Moeda de Destino*>, <Tipo de Taxa*>, <Período da Taxa*>)

    Exemplo: MAX_PRIOR( {Saldo do Sistema de Origem (Funcional)}, '6', 'CAD', 'REC', 'CURRENT')

    Note:

    Os parâmetros com um asterisco, *, serão obrigatório se o valor for um atributo do tipo saldo, como Sistema de Origem. Se o valor for um valor comum (como um atributo numérico), os parâmetros * deverão ser omitidos.

    Note:

    O Tipo de Taxa deve ser um tipo de taxa válido no sistema, ou o valor "REC", o que significa usar o tipo de taxa atribuído à reconciliação. O parâmetro Período da Taxa deve ser "CURRENT" ou "PRIOR", o que significa usar os tipos de taxa do período atual ou período anterior ao converter a moeda.
  • Mínimo: Retorna o valor mínimo de uma lista de atributos. Pode haver um número qualquer de parâmetros.

    MIN(<Valor1>, <Valor2>,<ValorN>)

    Exemplo: MAX( TRANSLATE( {Saldo do Sistema de Origem de Origem (Inserido)}, 'CAD', 'REC'), TRANSLATE( {Saldo do Sistema de Origem (Funcional)}, 'CAD', 'REC'), TRANSLATE( {Saldo do Sistema de Origem (Relatório)}, 'CAD', 'REC') )

  • Mínimo Anterior: Retorna o valor mínimo durante os X períodos anteriores.

    MIN_PRIOR (<Valor>, <Número de Períodos>, <Moeda de Destino*>, <Tipo de Taxa*>, <Período da Taxa*>)

    Exemplo: MIN_PRIOR( {Saldo do Sistema de Origem (Funcional)}, '2', 'EUR', 'Simplificado)

    Note:

    Os parâmetros com um asterisco, *, serão obrigatório se o valor for um atributo do tipo saldo, como Sistema de Origem. Se o valor for um valor comum (como um atributo numérico), os parâmetros * deverão ser omitidos.

    Note:

    O Tipo de Taxa deve ser um tipo de taxa válido no sistema, ou o valor "REC", o que significa usar o tipo de taxa atribuído à reconciliação. O parâmetro Período da Taxa deve ser "CURRENT" ou "PRIOR", o que significa usar os tipos de taxa do período atual ou período anterior ao converter a moeda.
  • Mês: Retorna o valor de mês de uma data como um número inteiro (1-12)

    MONTH (<DATE>)

  • Potência: eleva um número à potência exponencial de outro.

    POTÊNCIA(x,y), em que x=NÚMERO BASE e y=EXPOENTE, e x e y podem ser atributos ou cálculos, desde que sejam numéricos.

    Example: POWER(3,4)=81

    Note:

    Valores fracionários reduzirão o número à sua raiz. Por exemplo, POTÊNCIA(27, 1/3) = 3 a raiz cúbica.

    Note:

    Valores negativos resultarão em um inverso do cálculo exponencial. Por exemplo, POWER(2, -2) = 1 / (2^2) = 1 / 4 = .25.
  • Anterior: Retorna o valor do período anterior especificado. Se o Número de Períodos Anteriores for omitido, será pressuposto o valor 1.

    PRIOR(<Valor>, <Número de Períodos Anteriores*>, <Moeda de Destino*>, <Tipo de Taxa*>, <Período da Taxa*>)

    Exemplo: PRIOR( {Saldo do Sistema de Origem (Informado)}, '1', 'rec', 'pior')

    Note:

    Os parâmetros com um asterisco, *, serão obrigatório se o valor for um atributo do tipo saldo, como Sistema de Origem. Se o valor for um valor comum (como um atributo numérico), os parâmetros * deverão ser omitidos.

    Note:

    O Tipo de Taxa deve ser um tipo de taxa válido no sistema, ou o valor "REC", o que significa usar o tipo de taxa atribuído à reconciliação. O parâmetro Período da Taxa deve ser "CURRENT" ou "PRIOR", o que significa usar os tipos de taxa do período atual ou período anterior ao converter a moeda.
  • Arredondar: Retorna o valor arredondado para as casas decimais especificadas.

    ROUND(<Valor>, <Casas Decimais>)

    Exemplo: ROUND( ({Tradução com Script} /7), 4)

  • Soma Anterior: Retorna a soma de um valor durante os X períodos anteriores.

    SUM_PRIOR (<Valor>, <Número de Períodos>, <Moeda de Destino*>, <Tipo de Taxa*>, <Período da Taxa*>)

    Exemplo: SUM_PRIOR( {Saldo do Sistema de Origem (Relatório)}, '3', 'EUR', 'REC')

    Note:

    Os parâmetros com um asterisco, *, serão obrigatório se o valor for um atributo do tipo saldo, como Sistema de Origem. Se o valor for um valor comum (como um atributo numérico), os parâmetros * deverão ser omitidos.

    Note:

    O Tipo de Taxa deve ser um tipo de taxa válido no sistema, ou o valor "REC", o que significa usar o tipo de taxa atribuído à reconciliação. O parâmetro Período da Taxa deve ser "CURRENT" ou "PRIOR", o que significa usar os tipos de taxa do período atual ou período anterior ao converter a moeda.
  • Localização do Texto: Retorna o índice da substring contida no valor, a partir da posição 1como a primeira posição.

    INSTRING(<Valor>, <Valor a Pesquisar>)

    Exemplo: INSTRING( UPPERCASE( {Nome} ), 'TAX' )

  • Converter: Converte um atributo de moeda em um atributo numérico usando um tipo de taxa especificado.

    TRANSLATE(<Valor>, <Moeda de Destino>, <Tipo de Taxa>)

    Exemplo: TRANSLATE( {Saldo do Sistema de Origem (Informado)}, 'EUR', 'Contábil')

    Note:

    O Tipo de Taxa deve ser um tipo de taxa válido no sistema, ou o valor "REC", o que significa usar o tipo de taxa atribuído à reconciliação.
  • Maiúsculas: Retorna o valor em maiúsculas.

    UPPERCASE(<Value>)

    Example: UPPERCASE( {Name} )

  • Ano: Retorna o valor de ano de uma data como um número inteiro.

    YEAR (<DATE>)