Funções especializadas
A documentação de ajuda está disponível antes do lançamento do Designer Cloud para que você possa dar uma olhadinha. O conteúdo pode mudar até o lançamento oficial.
Essas funções executam uma variedade de ações especializadas e podem ser usadas com todos os tipos de dados.
EscapeXMLMetacharacters
EscapeXMLMetacharacters(String): substitui metacaracteres XML por suas versões de escape. Há 5 caracteres de escape.
| Caractere | Versão de escape |
|---|---|
| " | " |
| ' | ' |
| < | < |
| > | > |
| & | & |
Exemplo
EscapeXMLMetacharacters("2>1&1<2") retorna 2>1&1<2
GetVal
GetVal(index, v0,...vn): retorna o valor (v0, ..., vn) especificado pelo índice baseado em 0 (index).
GetEnvironmentVariable
GetEnvironmentVariable(Name): retorna a variável de ambiente especificada em "Name". Para obter uma lista de variáveis de ambiente, em seu computador, acesse Painel de controle > Sistema e segurança > Sistema >Configurações avançadas do sistema > Variáveis de ambiente. É exibida uma lista de variáveis do sistema. Qualquer valor dessa lista pode ser usado.
Exemplo
GetEnvironmentVariable(CommonProgramFiles) retorna C:\Program Files\Common Files
GetEnvironmentVariable(OS) retorna Windows_NT
Mensagem
Message(messageType, message, returnValue): use com uma instrução condicional para enviar uma mensagem ao log de mensagens e atualizar os dados da coluna com um valor especificado quando uma condição for atendida.
O tipo e o texto da mensagem são mostrados na janela Resultados. Se registrar em log estiver habilitado, o arquivo log de saída também se assemelha a essa informação.
Parâmetros
messageType: um número que corresponde ao tipo de mensagem:
- 1: Mensagens
- 2: Avisos
- 3: Erros
- 5: Erros de conversão (erros de conversão de campo)
- 8: Arquivos (entrada)
- 9: Arquivos (saída)
message: o texto da mensagem é expresso como uma cadeia de caracteres entre aspas.
returnValue: um valor para a saída de dados da coluna. Pode ser um valor numérico (por exemplo, 0), nulo ou uma cadeia de caracteres de texto entre aspas (por exemplo, "Falso").
Exemplo
Neste exemplo, se determinados valores de data/hora não contiverem dados de hora válidos, a função Mensagem é usada dentro de uma expressão condicional para gerar uma mensagem de erro de conversão de campo e atualizar os dados da coluna com o valor "Falso".
If [Hour] = "0" and [Minutes] = "0" then
Message(5, "Invalid time in DateTime", "False")
Else
"True"
Endif
NULL
NULL(): retorna um valor nulo.
RangeMedian
RangeMedian(...): calcula a mediana de uma série de intervalos agregados.
ReadRegistryString
ReadRegistryString(Key, ValueName, DefaultValue="): retorna um valor do registro.
Soundex
Soundex(String): retorna o Soundex da cadeia de caracteres. O Soundex cria um código com base no primeiro caractere da cadeia mais três caracteres com base nestes itens:
| Caractere | Soundex |
|---|---|
| Caracteres não alfabéticos (números e pontuação) | -1 |
| a, e, i, o, u, y, h, w | Ignorado, a menos que seja o primeiro caractere da cadeia. |
| b, f, p, v | 1 |
| c, g, j, k, q, s, x, z | 2 |
| d, t | 3 |
| l | 4 |
| m, n | 5 |
| r | 6 |
Exemplo
Se o código resultante tiver apenas dois ou três caracteres, o Soundex usará zeros para preencher o código com quatro caracteres. Por exemplo, no nome Lauren, apenas as letras L, r e n são traduzidas (Lrn), portanto o código Soundex resultante é L650.
Se o código resultante tiver mais de quatro caracteres, todos os caracteres após o quarto caractere são ignorados. Por exemplo, no nome Patrick, as letras P, t, r, c e k podem ser traduzidas (Ptrck), mas o código Soundex resultante tem apenas quatro caracteres: P362.
Soundex_Digits
Soundex_Digits(String): retorna os primeiros quatro dígitos, se existirem, ou o Soundex.
- Se houver dígitos (números) na cadeia de caracteres, os primeiros 4 dígitos são retornados.
- Se não houver dígitos, o código Soundex é retornado.
| Exemplo de cadeia de caracteres | Soundex_Digits |
|---|---|
| 3825 Iris | 3825 |
| 55555 Main | 5555 |
| 14L Broadway | 14 |
| Commerce Street | C562 |
| L Street | L236 |
TOPNIDX
TOPNIDX(N, v0, v1, ..., vn): retorna o índice de base 0 da enésima posição do valor máximo da lista. Com N==0, é o mesmo que MaxIdx(...).
Né o ponto de partida.v0é o campo indexado (variáveis subsequentes são opcionais).vné a meta.
Exemplo
TOPNIDX(0, [IndexedField], 5) retorna os cinco principais de um fluxo.
UrlEncode
UrlEncode(String): codifica a cadeia de caracteres UTF-16 como um URL válido da Web tanto para o mecanismo original quanto para o AMP.
Exemplo
C:\temp\Alteryx URL Encode retorna C:/temp/Alteryx%20URL%20Encode