Ces fonctions effectuent une variété d'actions spécialisées. Vous pouvez les utiliser avec tous les types de données.
Coalesce(v1,v2,v3,…,vn)
: renvoie la première valeur non nulle.
Important
Les valeurs transmises à la fonction Coalesce doivent toutes être du même type (à savoir toutes de type chaîne, numérique ou spatial).
Coalesce(null, "oranges", "apples", null, "grapes")
renvoie oranges.
Coalesce(oranges, apples, grapes)
renvoie une erreur.
Coalesce("1", "2", "3")
renvoie 1.
Coalesce(null, null, null)
renvoie une valeur nulle.
Coalesce(toDateTime("apples"), toDateTime(1))
renvoie 1899-12-31 00:00:00, car toDateTime("apples") renvoie une valeur nulle.
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, w | Ignorés sauf s'il s'agit du premier caractère de la chaîne. |
b, f, p, v | 1 |
c, g, j, k, q, s, x, z | 2 |
d et t | 3 |
l | 4 |
m et 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 à l'aide d'un encodage des pourcentages non standard basé sur UTF-16 pour le moteur d'origine et l'AMP.
Important
Veuillez noter que cette méthode n'est plus recommandée. Nous recommandons d'utiliser la nouvelle fonction UrlEncodeUTF8 à la place.
UrlEncode("C:\temp\Alteryx URL Encode")
renvoie C:/temp/Alteryx%20URL%20Encode.
UrlEncodeUTF8(String)
: encode une chaîne à l'aide de l'encodage des pourcentages conforme à la norme RFC 3986*. La fonction convertit les caractères en unités UTF8 et ignore les caractères définis dans le jeu de caractères non réservé. Contrairement à la fonction UrlEncode ci-dessus, cette fonction n'ignore pas les délimiteurs d'URL communs tels que « / ». Elle n'est donc pas adaptée pour encoder des URL de chemin complet. Vous devez utiliser cette fonction pour encoder des composants URL spécifiques, comme les paramètres des composants de requête.
Note
*RFC 3986 est la norme utilisée pour le codage des URL et définit une méthode pour encoder les caractères Unicode en les convertissant en une séquence d'octets UTF-8 et en représentant chaque octet par un signe % (pourcentage) suivi de deux chiffres hexadécimaux.
UrlEncodeUTF8("C:\temp\Alteryx URL Encode")
renvoie C%3A%5Ctemp%5CAlteryx%20URL%20Encode.