SubField - fonction de script et fonction de graphique

SubField() permet d'extraire des composants de sous-chaîne d'un champ de chaîne parent, où les champs d'enregistrement d'origine se composent de plusieurs parties séparées par un délimiteur.

La fonction Subfield() peut s'utiliser, par exemple, pour extraire le prénom et le nom de famille d'une liste d'enregistrements constituée de noms complets, les parties de composant d'un nom de chemin ou encore les données de tables séparées par des virgules.

Si vous utilisez la fonction Subfield() dans une instruction LOAD en ignorant le paramètre field_no facultatif, un enregistrement complet sera généré pour chaque sous-chaîne. Si plusieurs champs sont chargés à l'aide de la fonction Subfield(), les produits cartésiens de toutes les combinaisons sont créés.

Syntax:

SubField(text, delimiter[, field_no ])

Return data type: chaîne

Arguments:

Arguments
Argument	Description
text	Chaîne d'origine. Il peut s'agir d'un texte codé de manière irréversible, d'une variable, d'une expansion dollar ou d'une autre expression.
delimiter	Caractère inclus dans la chaîne d'entrée text qui divise la chaîne en plusieurs composants.
field_no	Le troisième argument, facultatif, est un entier spécifiant laquelle des sous-chaînes de la chaîne parent text doit être renvoyée. Utilisez la valeur 1 pour renvoyer la première sous-chaîne, la valeur 2 pour renvoyer la deuxième sous-chaîne, et ainsi de suite. Si field_no est une valeur positive, les sous-chaînes sont extraites de gauche à droite. Si field_no est une valeur négative, les sous-chaînes sont extraites de droite à gauche.

Il est possible d'utiliser SubField() à la place de combinaisons de fonctions complexes telles que Len(), Right(), Left(), Mid() et d'autres fonctions de chaîne.

Exemple	Résultat
SubField(S, ';' ,2)	Renvoie 'cde' si S correspond à 'abc;cde;efg'.
SubField(S, ';' ,1)	Renvoie une chaîne vide si S est une chaîne vide.
SubField(S, ';' ,1)	Renvoie une chaîne vide si S correspond à ';'.
Imaginons que vous ayez une variable contenant le nom de chemin d'accès vMyPath, Set vMyPath=\Users\ext_jrb\Documents\Qlik\Sense\Apps;.	Dans un graphique de type texte et image, vous pouvez ajouter une mesure telle que : SubField(vMyPath, '\',-3), ce qui aboutit à Qlik, car il s'agit de la troisième sous-chaîne en partant de l'extrémité droite de la variable vMyPath.

Example:

Ajoutez l'exemple de script à votre application et exécutez-le. Ensuite, ajoutez au moins les champs répertoriés dans la colonne des résultats à une feuille de votre application afin de visualiser le résultat.

FullName:

LOAD * inline [

Name

'Dave Owen'

'Joe Tem'

];

SepNames:

Load Name,

SubField(Name, ' ',1) as FirstName,

SubField(Name, ' ',-1) as Surname

Resident FullName;

Drop Table FullName;

Table des résultats
Name	FirstName	Surname
Dave Owen	Dave	Owen
Joe Tem	Joe	Tem

Example:

Cet exemple montre comment l'utilisation de plusieurs instances de la fonction Subfield(), chacune omettant le paramètre field_no, à partir de la même instruction LOAD crée des produits cartésiens de toutes les combinaisons. L'option DISTINCT est utilisée pour éviter de créer des enregistrements en double.

LOAD DISTINCT

Instrument,

SubField(Player,',') as Player,

SubField(Project,',') as Project;

Load * inline [

Instrument|Player|Project

Guitar|Neil,Mike|Music,Video

Guitar|Neil|Music,OST

Synth|Neil,Jen|Music,Video,OST

Synth|Jo|Music

Guitar|Neil,Mike|Music,OST

] (delimiter is '|');

Table des résultats
Instrument	Player	Project
Guitar	Mike	Music
Guitar	Mike	Video
Guitar	Mike	OST
Guitar	Neil	Music
Guitar	Neil	Video
Guitar	Neil	OST
Synth	Jen	Music
Synth	Jen	Video
Synth	Jen	OST
Synth	Jo	Music
Synth	Neil	Music
Synth	Neil	Video
Synth	Neil	OST