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

Concatenar

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.

Comprimento

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.

Minúsculo

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.

Maiúsculo

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.

Substituir

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.

Inicia com

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

Sequência

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.

Subsequência

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.

Ajustar

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

Valor absoluto

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

Média

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

Limite

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

Dividir

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.

Formatar

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

Máximo

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

Mínimo

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.

Multiplicar

Retorna o valor de todos os argumentos multiplicados juntos.

Número

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.

Subtrair

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

Somar

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)

Booleano

Calcula o valor booleano efetivo do argumento.

Não

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

Data e Hora (Data)

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

Data para a Sequência (Data)

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.

Ajustar para o Fuso Horário (Data)

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.