Adição de Atributos de Coleta

Como Adicionar um Novo Atributo para uma Coleta

Para adicionar um novo atributo para uma coleção:

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 255 caracteres.
   • Descrição: Insira uma descrição. Você pode inserir um máximo de 255 caracteres.
   • Selecione a opção Entrada ou Calculado como o tipo de atributo.

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

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

     Nota:

     Ao selecionar Entrada ou Calculado e salvar o atributo, você não poderá alterar esta configuração após o atributo ser criado. Alterar o tipo de atributo substitui qualquer validação ou cálculo especificado anteriormente.
   • Tipo de Dados: Selecione uma das seguintes opções como o 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 é possível compartilhá-la entre outras coletas.
     • Texto com Várias Linhas: Se esta opção for selecionada, selecione o Número de Linhas, de 3 a 50 linhas. 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 a rolagem, nas caixas de diálogo Ações. O tamanho máximo deve ser 2.000 caracteres. No entanto, a largura permanece fixa para a área de texto.

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

     • 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 das Configurações do Sistema.

       Nota:

       Você só pode inserir valores numéricos 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 de Número Negativo: Selecione como deseja exibir números negativos:
       • Escala: Defina a escala da moeda. 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 você especificar este valor, 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 é fechada.
3. Na janela Editar Coleta, clique em Salvar para salvar a coleção.

   Nota:

   Você deve salvar o novo atributo e a coleção. Apenas depois de fazer isso você poderá acessar a guia Validações ou a guia Cálculo para o atributo.
4. Selecione o atributo que você criou e clique no ícone Editar.

   A janela Editar Atributo é 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 Value1 e Value2 conforme necessário.
   3. Se você 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 Entrada (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: Adiciona 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, selecione o tipo de dados e o tipo de cálculo, conforme descrito na tabela a seguir.

   Tabela 38-3 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 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 um número for menor que zero, o valor positivo do número será retornado. Se o número especificado for igual ou maior que zero, o número especificado será retornado.

  ABS(<Número>)

• 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( {Balance (Reporting)}, '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 Datas:: retorna a diferença entre duas datas, em dias, horas, minutos ou segundos. 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

  DAY(<DATE>)

• Extrair Texto:: retorna a substring contida no valor, a partir das posições especificadas.

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

  Exemplo: 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 dar suporte aos 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')))
  

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

  Length ({<attribute>})

  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(<Value>)

  Exemplo: 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 (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: retorna 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( { Balance (Entered)}, 'CAD', 'REC'), TRANSLATE( {Balance (Functional)}, 'CAD', 'REC'), TRANSLATE( {Balance (Reporting)}, 'CAD', 'REC') )

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

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

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

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

  POWER(x,y) where x=BASE NUMBER,and y=EXPONENT; x e y podem ser atributos ou cálculos, contanto que sejam numéricos.

  Exemplo: POWER(3,4)=81

  Nota:

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

  Valores negativos inverterão o cálculo exponencial. Por exemplo, POWER(2, -2) = 1 / (2^2) = 1 / 4 = .25.

• Anterior: retorna 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, sendo 1 a primeira posição.

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

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

• Converter: converte um atributo de moeda em 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(<Value>)

  Exemplo: UPPERCASE( {Nome} )

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

  YEAR (<DATE>)

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 selecione Int1 como um Identificador de Chave em Editar Coleta

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

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

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

   • Clique em <Value> e informe um valor (entre aspas 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'.

     Nota: Confirme que <xxx> foi substituído com aspas simples: 'xxx'. Por exemplo: INSTRING({TextInput}, 'tion')

5. Clique em OK para salvar os atributos.

Como Adicionar 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 Atributos Selecionados.

   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 Coleção.

4. Você pode marcar a caixa de seleção na coluna Persistir para indicar que o valor do atributo deve persistir nos formulários referenciados. 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. Não é possível salvar esta configuração após salvar a coleta.
5. Clique em Salvar ou Salvar e Fechar.