Funções Especializadas
Essas funções executam uma variedade de ações especializadas e podem ser usadas com todos os tipos de dados.
Escapexmlmetacharacters (String)
: substitui METACARACTERES XML por suas versões de escape. Há cinco caracteres que serão escapados.
Caractere | Versão de escape |
---|---|
" | " |
' | ' |
< | |
> | > |
& | & |
Exemplo
Escapexmlmetacaracteres ("2 > 1 & 1 >
retorna 2 > 1 & 1 < 2
Getval (índice, v0,... vn)
: devolve o valor (v0,..., vn) especificado pelo [índice] baseado em 0.
GetEnvironmentVariable (nome)
: retorna a variável de ambiente especificada em Name. Para obter uma lista de variáveis de ambiente, vá para o painel de controle > System > Configurações avançadas do sistema > variáveis de ambiente. Aparece uma lista de variáveis de sistema. Qualquer valor deste pode ser usado.
Suporte de galeria
O alteryx não oferece suporte ao GetEnvironmentVariable
em aplicativos salvos na galeria.
Exemplo
GetEnvironmentVariable (CommonProgramFiles)
retorna C:\Arquivos de Programas\arquivos comuns
GetEnvironmentVariable (os)
retorna Windows_NT
Mensagem (messageType, mensagem, returnValue)
: Use com uma instrução condicional para gerar uma mensagem para o log de mensagens e atualizar os dados da coluna com um valor especificado quando uma condição for atendida.
O tipo de mensagem e o texto são mostrados na janela de resultados. Se o log estiver habilitado, o arquivo de log de saída também se assemelha a essas informações. Consulte -ERR:REF-NOT-FOUND-janela de resultados e -ERR:REF-NOT-FOUND-arquivo de log de saída.
Parâmetros
MessageType: um número que corresponde ao tipo de mensagem:
- 1 = mensagens
- 2 = avisos
- 3 = erros
- 5 = CONV erros (erros de conversão de campo)
- 8 = arquivos (entrada)
- 9 = arquivos (saída)
mensagem: o texto da mensagem, expresso como uma cadeia de caracteres entre aspas.
ReturnValue: um valor para a saída para dados de coluna. Isso pode ser um valor numérico (por exemplo, 0), NULL, ou uma cadeia de caracteres de texto entre aspas (por exemplo, "false").
Exemplo
Neste exemplo, a função Message é usada dentro de uma expressão condicional para produzir uma mensagem de erro de conversão de campo e atualizar dados de coluna com um valor de "false" se os valores de data/hora dados não contiverem dados de tempo válidos.
Se [Hora] = "0" e [Minutos] = "0", então
Message (5, "tempo inválido em DateTime", "false")
Mais
True
Endif
NULL ()
: retorna um valor nulo
Rangemedian (...)
: calcula a mediana de uma série de intervalos agregados. Veja a -ERR:REF-NOT-FOUND-escala mediana.
Readregistrystring (Key, ValueName, DefaultValue = ")
: retorna um valor do registro.
Soundex (String)
: Retorna o Soundex da Corda. Soundex cria um código baseado no primeiro personagem na seqüência mais três caracteres com base nos seguintes itens:
Caractere | Soundex |
---|---|
Caracteres não-alfa (números e pontuação) | -1 |
a, e, i, o, u, y, h, e w | ignorado a menos que o primeiro personagem na corda |
b, f, p, e v | 1 |
c, g, j, k, q, s, x, e z | 2 |
d e t | 3 |
l | 4 |
m e n | 5 |
r | 6 |
Exemplo
Se o código resultante é apenas 2 ou 3 caracteres de comprimento, Soundex usa zeros para preencher o código para quatro caracteres. Por exemplo, no nome Lauren, somente os L, r e n são traduzidos (LRN), portanto o código SOUNDEX resultante torna-se L650. Se o código resultante é mais de quatro caracteres longo, todos os caracteres após o quarto caractere são ignorados. Por exemplo, no nome Patrick, o P, t, r, c e k podem ser traduzidos (Ptrck), mas o código SOUNDEX resultante será apenas quatro caracteres: P362.
Soundex_Digits(String)
: Retorna os primeiros quatro dígitos ou o Soundex se nenhum. Se houver dígitos (números) na seqüência de caracteres, os quatro primeiros dígitos são retornados. Se não houver nenhum dígitos, o SOUNDEX código é retornado.
Cadeia de caracteres | Soundex_Digits |
---|---|
3825 Iris, íris | 3825 |
55555 principal | 5555 |
14L Broadway | 14 |
Rua do comércio | C562 |
Rua L | L236 |
Topnidx (N, V0, v1,..., vn)
: retorna o índice baseado em 0 do Nth do valor máximo da lista. Com N==0, é o mesmo que MaxIdx(...)
N
é o ponto de partida, V0
é o campo indexado (variáveis subseqüentes são opcionais), e vn é o objetivo.
Exemplo
Topnidx (0, [IndexedField], 5)
retorna os cinco primeiros de um fluxo
UrlEncode (String)
: Codifica a corda como uma URL legal da web.
Exemplo
C:\temp\alteryx url encode
retorna C:/Temp/alteryx%20URL%20Encode