Funciones especializadas
Estas funciones realizan una variedad de acciones especializadas. Puedes utilizarlas con todos los tipos de datos.
Coalesce
Coalesce(v1,v2,v3,…,vn)
: devuelve el primer valor no nulo.
Importante
Los valores pasados a la función Coalesce deben ser todos del mismo tipo (todos cadenas, todos numéricos o todos espaciales).
Ejemplo
Coalesce(null, "naranjas", "manzanas", null, "uvas")
devuelve naranjas.
Coalesce(naranjas, manzanas, uvas)
devuelve un error.
Coalesce("1", "2", "3")
devuelve 1.
Coalesce(null, null, null)
devuelve Null.
Coalesce(toDateTime("apples"), toDateTime(1))
devuelve 1899-12-31 00:00:00 porque toDateTime("apples") devuelve null.
EscapeXMLMetacharacters
EscapeXMLMetacharacters(String)
: reemplaza metacaracteres XML por sus versiones con escape. Hay 5 caracteres con escape.
Carácter | Versión de escape |
---|---|
" | " |
' | ' |
< | < |
> | > |
& | & |
Ejemplo
EscapeXMLMetacharacters("2>1&1<2")
devuelve 2>1&1<2
GetVal
GetVal(index, v0,...vn)
: devuelve el valor (v0, ..., vn) que se específica en el índice de base 0.
GetEnvironmentVariable
GetEnvironmentVariable(Name)
: devuelve la variable ambiental especificada en “Name”. Para obtener una lista de variables de entorno, en tu equipo, ve a Panel de control > Sistema y seguridad > Sistema > Configuración avanzada del sistema > Variables de entorno. Aparece una lista de variables del sistema. Puedes utilizar cualquier valor de esta lista.
Compatibilidad de Server
Alteryx no es compatible con GetEnvironmentVariable
en las aplicaciones guardadas en Server.
Ejemplo
GetEnvironmentVariable(CommonProgramFiles)
devuelve C:\Program Files\Common Files
GetEnvironmentVariable(OS)
devuelve Windows_NT
Mensaje
Message(messageType, message, returnValue)
: se utiliza con una instrucción condicional para generar un mensaje en el registro de mensajes y actualizar los datos de columna con un valor especificado cuando se cumple una condición.
El tipo de mensaje y el texto se muestran en la ventana Resultados. Si el registro está activado, el archivo de registro de salida también se parece a esta información. Consulta ventana Resultados y Archivo de registro de salida para obtener más información.
Parámetros
messageType
: un número que corresponde al tipo de mensaje:
1: mensajes
2: advertencias
3: errores
5: errores de conversión (errores de conversión de campo)
8: archivos (entrada)
9: archivos (salida)
message
: el texto del mensaje expresado como cadena entre comillas.
returnValue
: un valor que se produce para los datos de la columna. Puede ser un valor numérico (por ejemplo, 0), nulo o una cadena de texto entre comillas (por ejemplo, “False”).
Ejemplo
En este ejemplo, la función Mensaje se utiliza dentro de una expresión condicional para generar un mensaje de error de conversión de campo y actualizar los datos de la columna con el valor “Falso” si los valores de fecha y hora dados no contienen datos de hora válidos.
IF [Hora] = "0" [Minutos] = "0", THEN Message (5, "Hora no válida en fecha y hora", "Falso") ELSE "Verdadero" ENDIF
NULL
NULL()
: devuelve un valor NULL.
RangeMedian
RangeMedian(...)
: calcula la mediana de una serie de rangos agregados. Consulta Mediana de rango para obtener más información.
ReadRegistryString
ReadRegistryString(Key, ValueName, DefaultValue=")
: devuelve un valor del registro.
Soundex
Soundex(String)
: devuelve el Soundex de la cadena. Soundex crea un código basado en el primer carácter de la cadena más 3 caracteres basados en estos elementos:
Carácter | Soundex |
---|---|
Caracteres no alfabéticos (números y puntuación) | -1 |
a, e, i, o, u, y, h, w | Se omite, a menos que sea el primer carácter de la cadena. |
b, f, p, v | 1 |
c, g, j, k, q, s, x, z | 2 |
d, t | 3 |
l | 4 |
m, n | 5 |
r | 6 |
Ejemplo
Si el código resultante tiene solo 2 o 3 caracteres, Soundex utiliza ceros para rellenar el código hasta 4 caracteres. Por ejemplo, en el nombre Lauren, solo se traducen las letras L, r y n (Lrn), por lo que el código Soundex resultante es L650.
Si el código resultante tiene más de 4 caracteres, se omiten todos los caracteres que aparecen después del cuarto carácter. Por ejemplo, en el nombre Patrick, las letras P, t, r, c y k pueden traducirse (Ptrck), pero el código Soundex resultante es de solo 4 caracteres: P362.
Soundex_Digits
Soundex_Digits(String)
: devuelve los primeros cuatro dígitos o el Soundex si no hay ninguno.
Si hay dígitos (números) en la cadena, se devuelven los primeros cuatro.
Si no hay dígitos, se devuelve el código Soundex.
Cadena de ejemplo | Soundex_Digits |
---|---|
3825 Iris | 3825 |
55555 Main | 5555 |
14L Broadway | 14 |
Commerce Street | C562 |
L Street | L236 |
TOPNIDX
TOPNIDX(N, v0, v1, ..., vn)
: devuelve la posición de índice de base 0 original del valor N desde el valor máximo al ordenar los campos indexados (v0 a vn) en orden descendente. Los valores nulos se ignoran y N debe ser menor que los parámetros no nulos. Con N==0, es lo mismo que MaxIdx(...).
N
: el valor N máximo de los campos indexadosv0, v1, …, vn
son los campos indexados
Ejemplo
TOPNIDX(1, [IndexedField1], 5, 7)
devuelve…
0 si 5<
[IndexedField1]
<71 si
[IndexedField1]
< 5 o[IndexedField1]
es nulo2 si
[IndexedField1]
> 7
UrlEncode
UrlEncode(String)
: codifica una cadena UTF-16 como una URL web-legal para el motor original y AMP.
Ejemplo
C:\temp\Alteryx URL Encode
devuelve C:/temp/Alteryx%20URL%20Encode