Adição de Atributos de Coleta

Adição de um Novo Atributo para uma Coleta

Para adicionar um novo atributo para uma coleta:

1. Na janela Criar Novo Atributo, especifique o seguinte na guia Propriedades:
   • Nome: Insira um Nome para o atributo. Você pode inserir um máximo de 80 caracteres.
   • Descrição: Insira uma descrição. Você pode inserir um máximo de 255 caracteres.
   • Selecione a opção Entrada ou Calculado como tipo de atributo.

     Entrada é o padrão, e a guia Validações será habilitada. Para períodos que foram abertos e instâncias de formulário criadas, a regra de validação modificada não é aplicável. As alterações feitas só serão aplicadas nas novas instâncias de formulário.

     Se você selecionar Calculado, a guia Cálculos será habilitada.

     Nota:

     Após selecionar Entrada ou Calculado e salvar o atributo, não será possível alterar esta configuração a criação do atributo. Alterar o tipo de atributo substitui qualquer validação ou cálculo especificado anteriormente.
   • Tipo de Dados: Selecione uma das seguintes opções como tipo de dados. Após selecionar o tipo de dados, você também pode selecionar as opções Obrigatório e/ou Usar Valor.
     • Data
     • DataHora
     • Inteiro
     • Lista: Clique em Adicionar e insira valores para o atributo. Lista é o local da coleta e não pode ser compartilhada entre outras coletas.
     • Texto com Várias Linhas: Se esta opção for selecionada, selecione o Número de Linhas, de 3 a 50. O valor padrão é 3. O Texto com Várias Linhas determina o número de linhas de texto visíveis no formulário, sem rolagem, nas caixas de diálogo Ações. O tamanho máximo deve ser 2.000 caracteres. No entanto, a largura permanece fixa na área de texto.

       Marque a caixa de seleção Obrigatório se for obrigatório que Tipo de Dados mantenha esse valor. Se você marcar a caixa de seleção Usar Valor, o valor inserido para o Número de Linhas também será aplicável aqui por padrão. Além disso, será um texto que rola para baixo.

     • Número: Selecione esta opção para especificar as opções de formatação. Isso substituirá as configurações padrão na seção Preferências em Configurações do Sistema.

       Nota:

       Você pode inserir apenas valores numérico para esse atributo.
       • Casas Decimais: Insira o número de casas decimais a serem exibidas.
       • Exibir como Porcentagem: Exibe um sinal de porcentagem.
       • Usar Separador de Milhar: Exibe o separador de milhar (por exemplo: 1.000,00). O sistema exibe o separador de milhares para a configuração regional do usuário.
       • Moeda: Selecione a moeda.
       • Formato do Número Negativo: Selecione como deseja exibir números negativos:
       • Escalar: Escala o número. O intervalo é de 1000 a 1000000000000.
     • Texto: Insira até 255 caracteres.
     • Verdadeiro/Falso
     • Sim/Não
   • Obrigatório: Se o atributo for obrigatório, você deverá inserir um valor neste campo durante a entrada de dados.
   • Usar Valor: Se este valor for especificado, o sistema aplicará o valor informado pelo designer para qualquer registro criado pelo usuário. É possível alterar o valor padrão durante a entrada de dados.
2. Clique em OK para salvar o atributo. A janela Criar Novo Atributo será fechada.
3. Na janela Editar Coleta, clique em Salvar para salva a coleta.

   Nota:

   Você deve salvar o novo atributo e a coleta. Após fazer isso você poderá acessar a guia Validações ou Cálculo do atributo.
4. Selecione o atributo que você criou e clique no ícone Editar.

   A janela Editar Atributo será exibida.

5. Se você selecionou a opção Entrada (etapa 1), poderá adicionar uma expressão condicional na guia Validações:
   1. Clique em Adicionar. Uma linha é adicionada à tabela.
   2. Clique nas colunas na primeira linha para exibir as listas suspensas, nas quais é possível selecionar o Operador e inserir o Valor1 e o Valor2 correspondentes.
   3. Se precisar de uma segunda condição, clique em Adicionar para adicionar outra linha.
   4. Clique nas colunas na segunda linha para exibir as listas suspensas, nas quais é possível selecionar a Conjunção como E ou Ou.
   5. Clique em OK para salvar as condições.
6. Se você selecionou a opção Calculado (etapa 1), poderá adicionar um cálculo na guia Cálculos. Selecione o Tipo de Cálculo:
   • Atribuir Valor à Lista: Selecione o Atributo associado.
   • Condicional: Adicione a condição para Definição do Cálculo.
   • Com Script: Forneça a Definição do Cálculo e selecione o atributo e a função.
7. Para adicionar uma expressão de cálculo, especifique um tipo de dados e um tipo de cálculo, conforme descrito na tabela a seguir.

   Tabela 32-2 Tipo de Dados e Tipo de Cálculo

   Tipo de Dados selecionado na guia Propriedades	Tipo de Cálculo	Descrição
   Para todos os tipos de dados	Selecione Atribuir Valor à Lista e selecione o valor de Atributo. Você deve ter salvado os valores de atributo da Lista.	Retorne a um valor de atributo com base na atribuição para um membro da Lista.
   Para todos os tipos de dados	Condicional	No caso de um determinado atributo, retorne o valor de atributo A caso as condições especificadas forem atendidas. Se as condições não foram atendidas, retorne valor de atributo B.
   Lista	Atribuir Lista ao Valor	Com base no valor de um atributo, retorne o membro relacionado da lista.
   Inteiro, Número, Texto	Com Script Consulte Funções com Script	Um cálculo com script de formato livre. com script está disponível para atributos do tipo Inteiro, Texto com Várias Linhas, Número ou Texto.

8. Clique em OK para salvar o atributo.

   Nota:

   As alterações nos atributos se aplicam apenas a períodos de coleta de dados subsequentes.

Funções com Script

• Valor Absoluto: Retorna o valor absoluto de um número específico. Se o número for menor que zero, o valor positivo do número é retornado. Se o número especificado for igual ou maior que zero, o número especificado é retornado.

  ABS(<Number>)

• 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.

  ADD_MONTH(<Start Date>, <Months>, <Length>)

  Exemplo: ADD_MONTH(DATE(2017, 2, 15) 3)

• Média Anterior: Calcula a média de um valor numérico nos X períodos anteriores.

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

  Exemplo: AVERAGE_PRIOR( {Saldo (Relatório)}, '2', 'EUR'

• Data: Retorna um valor de data com base nos valores de inteiro especificados para ano, mês e dia.

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

• Diferença de Data: Retorna a diferença em dias, horas, minutos ou segundos entre duas datas. Para DATA 1 e DATA 2, é possível usar os valores TODAY e NOW, que denotam a data atual (sem componente de horário) e a data/horário, respectivamente.

  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

  DIA(<DATA>)

• Extrair Texto: Retorna a substring contida no valor, com base nas posições especificadas.

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

  Exemplo: SUBSTRING( {Nome} , 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 cálculos do tipo ELSE IF.

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

  Exemplo:

  IF_THEN_ELSE( {Risk Rating} = 'Low', 'Good',
  IF_THEN_ELSE( {Risk Rating} = 'Medium', 'Better',
  IF_THEN_ELSE({Risk Rating} = 'High', 'Best','Bad')))
  

• Comprimento: assume um valor de texto como parâmetro e retorna um número inteiro que consiste no número de caracteres no texto. Se o valor estiver vazio ou for nulo, o cálculo retornará 0.

  Comprimento ({<atributo>})

  Exemplo: LENGTH('Value') retornaria 5, e LENGTH({Name}) retornaria o número de caracteres no nome do objeto.

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

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

• Minúscula: Retorna o valor em letra minúscula.

  LOWERCASE(<Valor>)

  Exemplo: LOWERCASE( {Descrição} )

• 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 (Inserido)}, '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: Calcula o valor máximo nos X períodos anteriores.

  MAX_PRIOR (<Valor>, <Número de Períodos>)

  Exemplo: MAX_PRIOR( {Saldo (Funcional)}, '6', 'CAD', 'REC')

• 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: MIN( TRANSLATE( { Saldo (Informado)}, 'CAD', 'REC'), TRANSLATE( {Saldo (Funcional)}, 'CAD', 'REC'), TRANSLATE( {Saldo (Relatório)}, 'CAD', 'REC') )

• Mínimo Anterior: Calcula o valor mínimo nos X períodos anteriores.

  MIN_PRIOR (<Value>, (<Value>, <Number oMIN_PRIOR( {Source System Balance (Functional)}, '6', 'EUR', 'Simplificado')

• Mês: Retorna o valor de mês de uma data como um número inteiro (1-12)

  MES (<DATA>)

• Potência: Eleva um número para a potência exponencial de outro.

  POWER(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.

  Exemplo: POWER(3,4)=81

  Nota:

  Valores fracionais reduzirão o número para a respectiva raiz. Por exemplo, POWER(27, 1/3) = 3 a raiz cúbica.

  Os valores negativos executarão uma inversão do cálculo exponencial. Por exemplo, POWER(2, -2) = 1 / (2^2) = 1 / 4 = 0,25.

• Anterior: Calcula o valor do período anterior especificado.

  PRIOR(<Valor>, <Número de Períodos Anteriores>)

  Exemplo: PRIOR( {Saldo do Sistema de Origem (Inserido)}, '1', 'EUR')

• Arredondar: Retorna o valor arredondado para as casas decimais especificadas.

  ROUND(<Valor>, <Casas Decimais>)

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

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

  SUM_PRIOR(<Valor>, <Número de Períodos>)

  Exemplo: SUM_PRIOR( {Balance (Reporting)}, '3', 'EUR')

• Localização do Texto: Retorna a localização da substring contida no valor do atributo, a partir de 1 como a primeira posição.

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

  Exemplo: INSTRING( UPPERCASE( {Name} ), '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 (Inserido)}, '1', 'EUR', 'Contábil')

• Maiúscula: Retorna o valor em letra maiúscula.

  UPPERCASE(<Valor>)

  Exemplo: UPPERCASE( {Nome} )

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

  ANO (<DATA>)

Exemplo para Adicionar um Atributo de Cálculo

1. Crie uma coleta com os seguintes atributos:

   Int1: Entrada como tipo de atributo e Tipo de Dados como Inteiro. Clique em OK e, em Editar Coleta, selecione Int1 como um Identificador de Chave

   TextInput: Entrada como tipo de atributo e Tipo de Dados como Texto.

2. Salve os dados.
3. Crie um atributo com o nome TextCalc com tipo de atributo como Calculado e Tipo de Dados como Texto.
4. Na guia Cálculos, especifique o seguinte:
   • Tipo de Cálculo: Selecione Com Script.
   • Adicionar Função: selecione TextLocation e depois clique em Adicionar.

     INSTRING(<Value>, <Value To Search>) é adicionado à Definição do Cálculo.

   • Clique em <Value> e insira um valor (entre aspas simples e com distinção entre maiúsculas e minúsculas) ou, em Adicionar Atributo, selecione o atributo TextInput e clique em Adicionar.

     <Value> é alterado para {TextInput}.

   • Substitua <Value to Search> por 'tion'.

     Observação: Certifique-se de que você substituiu <xxx> com aspas simples: 'xxx'. Por exemplo: INSTRING({TextInput}, 'tion')

5. Clique em OK para salvar os atributos.

Adição de Atributos da Dimensão

Na janela Adicionar Atributo da Dimensão:

1. Selecione uma Dimensão
2. Selecione atributos na lista Atributos Disponíveis e mova-os para a lista Atributo Selecionado.

   O sistema inclui o atributo de chave da dimensão como um Atributo Selecionado. Não é possível limpar o atributo de chave.

3. Clique em OK.

   A janela Adicionar Atributo da Dimensão é fechada e os atributos selecionados são exibidos na janela Editar Coleta.

4. Você pode marcar a caixa de seleção na coluna Persistir para indicar se o valor do atributo deve persistir nos formulários da referência. Se o atributo da dimensão for atualizado, as alterações não serão atualizadas nos formulários nos quais se faz referência ao atributo. Se esta caixa de seleção não for marcada, o atributo ao qual se faz referência será atualizado com as alterações mais recentes. Esta configuração não pode ser alterada após a coleta ser salva.
5. Clique em Salvar ou Salvar e Fechar.