Ces fonctions effectuent une variété d'actions spécialisées. Vous pouvez les utiliser avec tous les types de données.
EscapeXMLMetacharacters(String)
: remplace les métacaractères XML par leurs versions avec échappement. 5 caractères possèdent une version avec échappement.
Caractère | Version avec échappement |
---|---|
" | " |
' | ' |
< | < |
> | > |
& | & |
EscapeXMLMetacharacters("2>1&1<2")
renvoie 2>1&1<2
GetVal(index, v0,...vn)
: renvoie la valeur (v0, ..., vn) spécifiée par l'index en base 0.
GetEnvironmentVariable(Name)
: renvoie la variable d'environnement spécifiée dans Name. Pour obtenir la liste des variables d'environnement, accédez à Panneau de configuration > Système et sécurité > Système > Paramètres système avancés > Variables d'environnement. La liste des variables système apparaît. Vous pouvez utiliser n'importe quelle valeur de cette liste.
Alteryx ne prend pas en charge GetEnvironmentVariable
dans les applications enregistrées dans Server.
GetEnvironmentVariable(CommonProgramFiles)
renvoie C:\Program Files\Common Files.
GetEnvironmentVariable(OS)
renvoie Windows_NT.
Message(messageType, message, returnValue)
: utilisez une instruction conditionnelle pour générer un message dans le journal des messages et mettre à jour les données de la colonne avec la valeur spécifiée lorsqu'une condition est satisfaite.
Le type et le texte du message sont indiqués dans la fenêtre Résultats. Si la journalisation est activée, le fichier journal de sortie est également similaire à ces informations. Consultez les pages Fenêtre Résultats et Fichier journal de sortie pour plus d'informations.
messageType
: un nombre indiquant le type de message :
1 : Messages
2 : Avertissements
3 : Erreurs
5 : Erreurs de conversion (erreurs de conversion de champ)
8 : Fichiers (entrée)
9 : Fichiers (sortie)
message
: le texte du message, exprimé par une chaîne entre guillemets.
returnValue
: une valeur à générer dans les données de la colonne. Il peut s’agir d’une valeur numérique (par exemple, 0), null ou d’une chaîne de texte entre guillemets (par exemple, "False").
Dans cet exemple, la fonction Message est utilisée dans une expression conditionnelle pour générer un message d'erreur de conversion de champ et mettre à jour les données de la colonne avec la valeur « False » si les valeurs de date/heure indiquées ne contiennent pas des données temporelles valides.
If [Hour] = "0" and [Minutes] = "0" then Message(5, "Invalid time in DateTime", "False") Else "True" Endif
NULL()
: renvoie une valeur nulle.
RangeMedian(...)
: calcule la médiane à partir d'une série de plages agrégées. Consultez la page Médiane de la plage pour plus d'informations.
ReadRegistryString(Key, ValueName, DefaultValue=")
: renvoie une valeur du registre.
SOUNDEX(String)
: renvoie la clé Soundex de la chaîne. Soundex crée un code basé sur le premier caractère de la chaîne, plus 3 caractères en fonction des éléments suivants :
Caractère | Soundex |
---|---|
Caractères non alphabétiques (nombres et ponctuation) | -1 |
a, e, i, o, u, y, h et w | Ignorés sauf s'il s'agit du premier caractère de la chaîne. |
b, f, p et v | 1 |
c, g, j, k, q, s, x et z | 2 |
d, t | 3 |
l | 4 |
m, n | 5 |
r | 6 |
Si le code obtenu ne contient que 2 ou 3 caractères, Soundex utilise des zéros pour atteindre les 4 caractères. Par exemple, dans le prénom Lauren, seuls le L, le r et le n sont traduits (Lrn) ; la clé Soundex est donc L650.
Si le code obtenu possède plus de 4 caractères, tous les caractères situés après le quatrième sont ignorés. Par exemple, dans le prénom Patrick, le P, le t, le r, le c et le k peuvent être traduits (Ptrck), mais la clé Soundex ne contient que 4 caractères : P362.
Soundex_Digits(String)
: renvoie les 4 premiers chiffres ou la clé Soundex si la chaîne n'en contient aucun.
Si la chaîne comporte des chiffres (numéros), les 4 premiers sont renvoyés.
Si la chaîne ne contient aucun chiffre, la clé Soundex est renvoyée.
Exemple de chaîne | Soundex_Digits |
---|---|
3825 Iris | 3825 |
55555 Main | 5555 |
14L Broadway | 14 |
Commerce Street | C562 |
L Street | L236 |
TOPNIDX(N, v0, v1, ..., vn)
: renvoie la position d'index initiale en base 0 du Nième à partir de la valeur maximale lors du tri des champs indexés (v0 à vn) dans l'ordre décroissant. Les valeurs nulles sont ignorées et N doit être inférieur aux paramètres non nuls. Avec N==0, cette fonction est identique à MaxIdx(...).
N
: Nième de la valeur maximale des champs indexés.v0, v1, …, vn
sont les champs indexés
TOPNIDX(1, [IndexedField1], 5, 7)
renvoie…
0 si 5<
[IndexedField1]
< 71 si
[IndexedField1]
< 5 ou[IndexedField1]
est nul2 si
[IndexedField1]
> 7
UrlEncode(String)
: encode une chaîne UTF-16 en tant qu'URL web valide pour le moteur d'origine et l'AMP.
C:\temp\Alteryx URL Encode
renvoie C:/temp/Alteryx%20URL%20Encode