7 Preparando dados
7.1 Preparando seus dados antes de criar o gráfico
7.1.5 Personalizando colunas com fórmulas
É possível criar e aplicar fórmulas a valores de coluna usando a linguagem de fórmulas do SAP Lumira. O editor de fórmulas é exibido na parte superior do painel dados. Quando você cria uma fórmula em uma coluna, uma nova coluna é criada com os valores afetados pela fórmula.
Note
Todas as funções que estão disponíveis na linguagem de fórmulas possuem uma descrição de sua sintaxe.
Estes recursos são suportados pelo editor de fórmulas: ● Combinação de duas colunas do conjunto de dados.
● Aplicação de funções a partir de conjuntos de funções predefinidas para manipulação de números, data e texto. As funções também são acompanhadas pela descrição da sintaxe.
● Use cláusulas "If...Then...Else".
● Use o recurso de autocompletar para agilizar a edição. ● Use um seletor de calendário para os parâmetros de data. ● Copie e cole qualquer texto ou sintaxe na definição de função. 1. Clique no botão Editor de fórmulas na parte superior do painel Dados.
O Editor de fórmulas é exibido.
2. Digite um nome de coluna na caixa de texto superior Nome da coluna.
3. Clique duas vezes nos nomes das colunas ou nas funções nas listas adequadas para inserir um campo de sintaxe de fórmula.
4. Digite os parâmetros da função e as informações correlatas, com base na tarefa da função. Você deve digitar os nomes das colunas usadas nessa fórmula. O recurso de autocompletar sugere os nomes das colunas após a digitação da primeira letra.
5. Se você estiver inserindo informações de calendário, clique no botão Inserir data na parte inferior da lista de funções para usar o selecionador de data.
6. Clique em OK para aplicar a fórmula.
Uma nova coluna é criada com os valores gerados pela fórmula.
Example
Criando uma fórmula
Se quiser criar uma fórmula que multiplique os valores da coluna margin_gross_percent por 100 e arredonde o resultado para cima, siga estas instruções:
Etapa Descrição
Abra o editor de fórmulas. O editor de fórmulas é exibido na parte superior do painel Dados.
Clique em uma das funções. Selecione Ceil(num).
Digite os parâmetros Ceil(margin_gross_percent )*100 Uma nova coluna com o nome da fórmula
padrão é criada.
A coluna é chamada Ceil(margin_gross_percent )*100.
Guia do Usuário do SAP Lumira
Preparando dados
© 2013 SAP AG ou empresa afiliada da SAP. Todos os direitos
Etapa Descrição
Alterar o nome da coluna Clique com o botão direito do mouse no cabeçalho da coluna e selecione Renomear.
7.1.5.1
Referência de funções
Você pode personalizar valores em uma ou mais colunas definindo funções disponíveis na barra de fórmulas. As funções são divididas nas seguintes categorias:
Categoria Descrição
Agregação
Note
Funções de agregação são implementadas na definição de uma medida.
Agrega dados, por exemplo, somando ou tirando a média de um conjunto de valores.
Caractere Manipula as sequências de caracteres Data e hora Retorna os dados de data ou hora Numérico Retorna dados numéricos Lógico Retorna TRUE ou FALSE
Diversos Funções que não se ajustam às categorias acima
Criando uma medida diretamente de uma coluna ou atributo [page 59]
Funções de caractere [page 48]
Funções de data e hora [page 51]
Funções numéricas [page 52]
Funções lógicas [page 53]
Funções diversas [page 54]
7.1.5.1.1
Funções de caractere
Uma função de caractere permite a você manipular sequências de caracteres em uma fórmula.
Sintaxe da função Descrição
Concatenate(str1, str2) Concatena duas strings em uma única. O operador + também pode concatenar strings.
● str1 : primeira string ● str2 : segunda string
48
© 2013 SAP AG ou empresa afiliada da SAP. Todos os direitos
reservados.
Guia do Usuário do SAP Lumira
Sintaxe da função Descrição
Esta fórmula retorna "MrBrown": Concatenate("Mr", "Brown") . ExceptFirstWord(str, sep) Retorna uma cópia da string onde a primeira palavra foi removida.
● str : string de entrada ● sep : um separador
Esta fórmula retorna "Standford Street": ExceptFirstWord("Level 3, Standford Street", ", ")
ExceptLastWord(str, sep) Retorna uma cópia da string onde a última palavra foi removida. ● str : string de entrada
● sep : um separador
Esta fórmula retorna "james.brown":
ExceptLastWord("james.brown@company.com", "@") . FirstWord(str, sep) Retorna a primeira palavra da string.
● str : string de entrada ● sep : um separador
Esta fórmula retorna "Senior": FirstWord("Senior Developer", " ") LastWord(str, sep) Retorna a última palavra de uma string.
● str : string de entrada ● sep : um separador
Esta fórmula retorna "Purple": LastWord("Red/Purple", "/") Length(str) Retorna o comprimento de uma string.
● str : string de entrada
Esta fórmula retorna 8: Length("How long")
LowerCase(str) Retorna uma cópia de uma determina string em que todos os caracteres são convertidos em minúsculas.
● str : string de entrada
Esta fórmula retorna "good job": LowerCase("GOOD JOB")
Lpad(str, length, pad) Retorna a cópia de uma string que foi preenchida com caracteres à esquerda do comprimento total especificado.
● str : string de entrada
● length : comprimento esperado
● pad : sequência de caracteres que deve ser adicionada.
Esta fórmula retorna "####Incomplete field": Lpad("Incomplete field", 20, "#")
Replace(str, target, replacement)
Retorna uma string em que todas as ocorrências de uma determinada string são substituídas por uma outra string especificada.
● str : string de entrada
Guia do Usuário do SAP Lumira
Preparando dados
© 2013 SAP AG ou empresa afiliada da SAP. Todos os direitos
Sintaxe da função Descrição
● target : a string a ser substituída.
● replacement : o valor da string a ser inserido.
Esta fórmula retorna "Very guud sung": Replace("Very good song", "o" , "u") Rpad(str, length, pad) Retorna a cópia de uma string que foi preenchida com caracteres à direita do
comprimento total especificado. ● str : string de entrada
● length : comprimento esperado
● pad : sequência de caracteres que deve ser adicionada. SubString(str, start) Retorna uma substring de uma determinada string.
● str : a string da qual uma substring é calculada. ● start : a posição inicial na substring de entrada. Esta fórmula retorna "ng": SubString("Wong", 3) SubString(str, start, length) Retorna uma substring de uma determinada string.
● str : a string da qual uma substring é calculada. ● start : a posição inicial na substring de entrada. ● length : o comprimento da substring a retornar. Esta fórmula retorna "on": SubString("Wong", 2, 2) ToText(param) Converte o parâmetro determinado em uma string.
● param : parâmetro a ser convertido. Qualquer tipo é aceito. Números são truncados a 0 casas decimais.
Trim(str, toTrim) Retorna uma cópia da string onde as repetições à esquerda e à direita do caractere determinado foram removidas.
● str : string de entrada
● toTrim : esta string deve conter apenas o caractere a ser removido. Esta fórmula retorna "Auror": Trim("Aurora", "a")
TrimLeft(str, toTrim) Retorna uma cópia da string onde as repetições à esquerda do caractere determinado foram removidas.
● str : string de entrada
● toTrim : esta string deve conter apenas o caractere a ser removido. Esta fórmula retorna "bove": TrimLeft("Above" , "A")
TrimRight(str, toTrim) Retorna uma cópia da string onde as repetições à direita do caractere determinado foram removidas.
● str : string de entrada
● toTrim : esta string deve conter apenas o caractere a ser removido. Esta fórmula retorna "Laur": TrimRight("Laura" , "a")
50
© 2013 SAP AG ou empresa afiliada da SAP. Todos os direitos
reservados.
Guia do Usuário do SAP Lumira
Sintaxe da função Descrição
UpperCase(str) Retorna uma cópia de uma determina string em que todos os caracteres são convertidos em maiúsculas.
● str : string de entrada
Esta fórmula retorna "LITTLE BOY": UpperCase("Little Boy")
ToDate(string, format) Converte a string de entrada determinada string em uma data de acordo com o formato especificado. O formato da data é uma combinação dos tokens reservados a seguir, separados por qualquer delimitador: - 'd' ou 'dd' para dia do mês (1-31), - 'M' ou 'MM' para mês do ano (1-12), - 'y' ou 'yy' para ano abreviado sem o século (0-99), - 'yyyy' para ano com o século (como em 1956 ou 2012). Todas as outras sequências são consideradas como delimitadores. ● string : string de entrada a ser convertida.
● format : constante de string de formato da data
Esta fórmula converte o formato respectivo da string 'yyyy/dd/MM' como data: ToDate(Obj, 'yyyy/dd/MM')
7.1.5.1.2
Funções de data e hora
Funções de data e hora retornam os dados de data e hora.
Sintaxe da função Descrição
AddMonthToDate(d ate , periods)
Retorna a data produzida adicionando o número especificado de meses a uma data ● date : data original
● periods: número de períodos a serem adicionados
Esta fórmula retorna 2012-02-01: AddMonthToDate(2012-01-01,1) AddWeekToDate(da
te , periods)
Retorna a data produzida adicionando o número especificado de semanas a uma data ● date : data original
● periods: número de períodos a serem adicionados
Esta fórmula retorna 2012-01-08: AddWeekToDate(2012-01-01,1) AddYearToDate(dat
e , periods)
Retorna a data produzida adicionando o número especificado de anos a uma data ● date : data original
● periods: número de períodos a serem adicionados
Esta fórmula retorna 2013-01-01: AddYearToDate(2012-01-01,1) Day(date) Retorna o dia do mês como um número de 1 a 31.
● date : uma data
Esta fórmula retorna 23: Day(2012-03-23)
DayOfWeek(date) Retorna o dia da semana como um número de 1 (domingo) à 7 (sábado).
Guia do Usuário do SAP Lumira
Preparando dados
© 2013 SAP AG ou empresa afiliada da SAP. Todos os direitos
Sintaxe da função Descrição
● date : uma data
Esta fórmula retorna 6: DayOfWeek(2012-03-23) DayOfYear(date) Retorna o dia do ano como um número.
● date : uma data
Esta fórmula retorna 83: DayOfYear(2012-03-23) LastDayOfMonth(d
ate)
Retorna a data gerada pelo cálculo do último dia do mês de uma determinada data. ● date : uma data
Esta fórmula retorna a data 2012-03-31: LastDayOfMonth(2012-03-23) LastDayOfWeek(dat
e)
Retorna a data gerada pelo cálculo do último dia da semana de uma determinada data. ● date : uma data
Esta fórmula retorna a data 2012-03-24: LastDayOfWeek(2012-03-23) MakeDate(year,
month, day)
Retorna uma data que é criada do ano, mês e dia especificados. ● year : um número que representa um ano.
● month : um número que representa um mês. ● day : um número que representa um dia do mês.
Esta fórmula retorna a data 2011-06-12. MakeDate(2011, 6, 12) Month(date) Retorna o mês do ano como um número de 1 a 12.
● date : uma data
Esta fórmula retorna 3: Month(2012-03-23)
Quarter(date) Retorna um número que representa o trimestre de uma determinada data. ● date : uma data
Esta fórmula retorna 1: Quarter(2012-03-23)
Week(date) Retorna um número que representa a semana de uma determinada data. ● date : uma data
Esta fórmula retorna 12: Week(2012-03-23) Year(date) Retorna o ano de uma determinada data.
● date : uma data
Esta fórmula retorna 2012: Year(2012-03-23)
7.1.5.1.3
Funções numéricas
Uma função numérica permite que você retorne valores numéricos em uma fórmula.
52
© 2013 SAP AG ou empresa afiliada da SAP. Todos os direitos
reservados.
Guia do Usuário do SAP Lumira
Sintaxe da função Descrição
Mod(num, divisor) Retorna o restante da divisão de um número por outro número. ● num : um número
● divisor : o divisor
Esta fórmula retorna 1: Mod(15,2) Power(num,
exponent)
Elevar um número a uma potência. O operador ^ pode ser utilizado no lugar desta função.
● num : um número ● exponent : o expoente
Esta fórmula retorna 8: Power(2,3)
Round(num, digits) Retorna um valor numérico arredondado para um número especificado de casas decimais.
● num : um número
● digits : o número de casas decimais para arredondar. Esta fórmula retorna 14.8: Round(14.81, 1)
Sign(num) Retorna -1 se o número especificado for negativo, 0 se o número especificado for zero e +1 se o número especificado for positivo.
● num : um número
Esta fórmula retorna -1: Sign(-2)
ToText(num, digits) Converte o número especificado em uma string. O número é truncado em um número específico de casas decimais.
● num : um número
● digits : número de casas decimais a usar. Este parâmetro é opcional, seu valor predeterminado é 0.
Esta fórmula retorna 12.14: ToText(12.1451, 2)
Truncate(num, digits) Retorna um valor numérico truncado em um número especificado de casas decimais. ● num : um número
● digits : número de casas decimais a truncar. Esta fórmula retorna 12.200: Truncate(12.281, 1)
7.1.5.1.4
Funções lógicas
Você pode usar funções lógicas em uma fórmula para retornar TRUE ou FALSE.
Sintaxe da função Descrição
IsNotNull(obj) Retorna um valor booleano indicando se o campo fornecido não contém um valor nulo. ● obj : um objeto do usuário
Guia do Usuário do SAP Lumira
Preparando dados
© 2013 SAP AG ou empresa afiliada da SAP. Todos os direitos
Sintaxe da função Descrição
IsNull(obj) Retorna um valor booleano indicando se o campo fornecido contém um valor nulo. ● obj : um objeto do usuário
7.1.5.1.5
Funções diversas
As seguintes funções podem ser usadas em uma fórmula, mas não se ajustam às categorias padrão de famílias de função:
Sintaxe da função Descrição
GroupValues(column, ListOfValues, newValue)
Agrupa uma lista de valores.
● column : objeto do usuário no qual se aplica o agrupamento. ● ListOfValues : lista de valores a serem agrupados.
● newValue : valor que deve substituir os valores agrupados. Esta fórmula retorna "My Countries" quando a coluna CountryColumn contém os valores "USA", "India" ou "France":
GroupValues(CountryColumn, ["USA", "India", "France"], "My Countries")
ToNumber(param) Converte o parâmetro determinado em um valor numérico. ● param : parâmetro a ser convertido. Qualquer tipo é aceito.
Números são truncados a 0 casas decimais.