Lista de Funções

O Cast Iron Express oferece uma seleção de funções para uso nos mapeamentos. Essas funções podem ser utilizadas para manipular os valores do campo que estiverem sendo mapeados, como alterar o conteúdo das sequências, executar operações numéricas em números e manipular valores de data e hora.

Por padrão, ao se registrar em uma conta do Cast Iron Express, esta função será desativada. Para utilizar esta função adicional, clique em Complementos e selecione o pacote Funções de Mapeamento. Para obter informações adicionais, consulte Incluindo Função em sua Conta do Express.

Tabela 1. Funções de Sequência. Esta tabela lista e descreve as funções de sequência
Função de mapeamento Descrição

Concatenate

Aceita dois ou mais argumentos e efetua cast deles na sequência. Retorna a sequência que é a concatenação dos valores de seus argumentos após a conversão. O usuário também pode configurar as sequências de prefix e/ou postfix, mais um delimitador que é inserido entre cada um dos argumentos.

Length

Retorna um número inteiro igual ao comprimento em caracteres do valor do argumento. Se o valor do argumento for a sequência vazia, o número inteiro 0 será retornado.

Lowercase

Retorna o valor do argumento após converter cada caractere em seu correspondente minúsculo, conforme definido na seção de mapeamentos de maiúsculas e minúsculas apropriados no padrão Unicode.

Uppercase

Retorna o valor do argumento após converter cada caractere em seu correspondente maiúsculo, conforme definido na seção de mapeamentos de maiúsculas e minúsculas apropriados no padrão Unicode.

Replace

Retorna a sequência que é obtida ao substituir cada subsequência de não sobreposição da entrada que corresponde ao padrão fornecido com uma ocorrência da sequência de substituição.

Starts with

Retorna um resultado booleano indicando se o valor do primeiro argumento inicia com o valor do segundo argumento.

String

Retorna o valor do argumento representado como uma sequência. Este valor pode ser utilizado para efetuar cast dos tipos de dados numéricos em sequências para evitar que os mapeamentos exibam um aviso.

Substring

Retorna a parte do valor do primeiro argumento, iniciando na posição indicada pelo valor do segundo argumento e continuando até o número de caracteres indicado pelo valor do terceiro argumento. Para subsequência, há apenas um campo como "entrada" para a função. No entanto, para a função, o índice e os valores de comprimento iniciais são configurados na janela de diálogo função. No texto existente (e todas as outras descrições), argumento é utilizado nos dois casos.

Trim

Retorna o valor do argumento com espaço em branco normalizado ao remover o espaço em branco inicial e final e substituir as sequências de um ou mais caracteres de espaço em branco por um espaço único.

Tabela 2. Funções Matemáticas. Esta tabela lista e descreve as funções matemáticas
Função de mapeamento Descrição

Absolute value

Retorna o valor numérico (ou módulo) de um número sem considerar o seu sinal.

Mean

Retorna a média dos valores na sequência de entrada, ou seja, a soma dos valores dividida pelo número de valores.

Ceiling

Retorna o menor número inteiro não menor que X.

Divide

Retorna um valor de resultados quando o primeiro argumento é dividido pelo segundo.

Floor

Retorna o maior número inteiro não maior do que X.

Format

A função formato-número converte seu primeiro argumento em uma sequência utilizando a sequência de padrão de formatação especificada pelo segundo argumento e o formato decimal nomeado pelo terceiro argumento ou o formato decimal padrão, se não houver nenhum terceiro argumento.

As opções de formatação para o segundo parâmetro são os seguintes:
  • 0 – Dígito
  • # – Dígito (zero mostrado como ausente)
  • . - A posição da vírgula decimal. Por exemplo: ###.##
  • , – O grupo separador de milhares. Por exemplo: ###,###.##
  • % – Exibe o número como uma porcentagem. Por exemplo: ##%
  • ; - Padrão separador. O primeiro padrão é usado para números positivos e o segundo para números negativos.
O formato decimal do terceiro parâmetro ajuda na localização do número e as opções a seguir podem ser utilizadas:
  • 0 – Dígito
  • # – Dígito (zero mostrado como ausente)
  • . - Separador decimal ou separador decimal monetário
  • - - Sinal de menos
  • , – Separador de agrupamento
  • E – Separa mantissa e expoente na notação científica. Não precisa ser colocado entre aspas no prefixo ou sufixo
  • ; - Separa subpadrões positivos e negativos
  • % – Multiplicar por 100 e mostrar como porcentagem
  • \u2030 – Multiplicar por 1000 e mostrar como por valor mille
  • ¤ (\u00A4) - sinal de moeda, substituído pelo símbolo monetário. Se apresentado em dobro, substituído pelo símbolo de moeda internacional. Se estiver presente em um padrão, o separador decimal monetário será usado em vez do separador decimal
  • ' – Utilizado para colocar entre aspas caracteres especiais em um prefixo ou sufixo. Por exemplo, '#'# formata 123 em #123. Para criar uma aspa simples em si, utilize dois em uma linha: # o''clock

Maximum

Retorna o maior valor dos nós transmitidos como o argumento.

Minimum

Retorna o menor valor dos nós transmitidos como o argumento.

Modulo

Retorna o módulo ou o valor restante após o primeiro argumento ser dividido pelo segundo.

Multiply

Retorna o valor de todos os argumentos multiplicados juntos.

Number

Converte o argumento em um decimal.

Round

Retorna o número sem nenhuma parte fracionária que estiver mais próxima do argumento. Se houver dois números desse tipo, o que estiver mais próximo do infinito positivo será retornado.

Subtract

Retorna um valor pelo qual o segundo argumento é subtraído do primeiro

Sum

Retorna um valor obtido ao incluir os valores no argumento.

Tabela 3. Funções Booleanas. Esta tabela lista e descreve as funções booleanas
Função de mapeamento Descrição (Description)

Boolean

Calcula o valor booleano efetivo do argumento.

Not

Retornará true se o valor booleano efetivo for false, e retornará false se o valor booleano efetivo for true.

Tabela 4. Funções de Data. Esta tabela lista e descreve as funções de data
Função de mapeamento Descrição

Date Time (Date)

O primeiro argumento deve estar no formato de data, o segundo argumento é um formato de hora. O resultado é um formato DateTime que possui ambas data e hora nos argumentos

Date to String (Date)

O segundo argumento é uma sequência que mostra como formatar a data/hora. Os seguintes caracteres-chave são substituídos por partes da data/hora:
  • yy – Últimos dois dígitos do ano. Por exemplo, 86 de 1986
  • MM - Mês de dois dígitos
  • dd – Data de dois dígitos
  • HH - Hora de dois dígitos
  • mm - Minutos de dois dígitos
  • ss - Segundos de dois dígitos

Por exemplo, se a função Formatar Sequência de Caracteres de Data foi chamada com os parâmetros de entrada a seguir:

dateTime: 2012-02-22T16:18:00.852-08:00

sequência de formatações: MM/dd/yyyy

sequência de código de idioma: en_US

A seguinte sequência seria retornada: 22/02/2012.

Para obter mais informações sobre a função de Data para Sequência, consulte o tópico Formatar Sequência de Data na seção de ajuda do Studio.

Adjust to Timezone (Date)

Converte o parâmetro TimeDate para manter um fuso horário específico, ou para nenhum. O fuso horário aplicado é o segundo argumento, por exemplo:
  • -10H - Um fuso horário de menos 10 horas
  • +5H30M – Um fuso horário de mais 5 horas e 30 minutos
  • 0H - Um fuso horário em 0 hora
Tabela 5. Funções de Utilitário. Esta tabela lista e descreve as funções de utilitário
Função de mapeamento Descrição

Composição

Encadeia uma série de funções.




Feedback | notices