AttributePivoter

Regrouper les lignes par et (optionnellement) Regrouper les colonnes par définissent une imbrication logique de groupes de lignes.

Pour chacun de ces groupes logiquement imbriqués, l'AttributePivoter calcule des statistiques récapitulatives, qu'il émet sous forme de lignes de tableau via le port Summary. La valeur de la ligne de synthèse calculée est définie par <attrName><description>, où <attrName> est le nom de l'attribut de regroupement et <description> est la valeur fournie dans le paramètre 'Description des lignes de synthèse'.

Par exemple, dans le cas d'un regroupement selon l'attribut "Region_RSS", la ligne synthétisant toutes les régions aura pour valeur "Region_RSS Total" pour l'attribut "Region_RSS", à condition que la description des lignes de synthèse soit sur la valeur par défaut de "Total".

Les entités sont regroupées selon un attribut de regroupement et des statistiques sont calculées, pour chaque groupe, selon un attribut défini en paramètre. Il existe deux types d'attributs de regroupement qui fonctionnent ensemble pour définir ces groupes :

• Attributs de regroupement en lignes : L'utilisateur spécifie un ensemble ordonné d'attributs qui divisent les statistiques en rangées. Il y a une seule ligne de données de résultat pour chaque ensemble unique de valeurs pour l'ensemble spécifié d'attributs de regroupement de lignes.
• Attribut de regroupement de colonnes : L'utilisateur peut éventuellement spécifier un attribut unique pour définir les colonnes dans les lignes résultantes. S'il est spécifié, chaque valeur unique de l'attribut de regroupement de colonnes apporte une colonne de données statistiques au résultat, pour chaque statistique calculée. De plus, s'il y a plus d'une valeur unique pour la colonne, une colonne de résumé sera générée pour chaque statistique.
  Si aucun attribut de regroupement n'est sélectionné, chaque ligne contiendra un unique résultat.

Les attributs de regroupement des lignes étant ordonnés, ils effectuent une imbrication logique des groupes. Au niveau le plus bas, un ensemble complet de valeurs uniques est représenté par une seule ligne du résultat. Un niveau plus haut se trouve le groupement logique constitué de l'ensemble des lignes pour lesquelles tous les attributs de groupement de lignes sont uniques, à l'exception de la dernière ligne spécifiée. Cette imbrication logique se poursuit jusqu'aux premiers attributs de regroupement de lignes spécifiés.

Une ligne résultant d'un ensemble complet de valeurs de données uniques est appelée "ligne de données". Une "ligne de résumé" supplémentaire est générée pour chaque regroupement logiquement imbriqué, qui résume les données des lignes de données contenues dans le regroupement.

Les lignes forment un tableau avec les attributs suivants :

1. Tous les attributs de regroupement de lignes dont les valeurs combinées déterminent le groupe
2. Pour chaque type de résumé pivot, un attribut avec des statistiques correspondants, est calculé à partir de toutes les entités du groupe ligne.
3. Si plus d'un groupe de colonnes a été défini, chacun des attributs de (2.) sera répété pour tous les groupes de colonnes, ainsi qu'une valeur récapitulative (c'est-à-dire un "grand total") calculée sur les valeurs des attributs de tous les groupes de colonnes. La méthode de calcul de la valeur récapitulative dépend de la statistique qu'elle représente :
   • Les statistiques Count (compte) et Sum (somme) sont synthétisées s avec la somme des statistiques calculées pour le groupe de lignes.
   • Average (moyenne) correspond à la moyenne de toutes les valeurs de chaque groupe de lignes.
   • Les valeurs Min correspondent aux valeurs minimales de l'attribut analysé de chaque groupe de lignes.
   • Les valeurs Max correspondent aux valeurs maximales de l'attribut analysé de chaque groupe de lignes.
     

Les premières entités et les premières statistiques émises contiennent des attributs supplémentaires comportant des informations de schéma nécessaires pour écrire les données dans le cadre d'un schéma dynamique.

Dans cet exemple, nous partons d'un simple tableau CSV de statistiques à faire pivoter et à analyser. Les entités CSV sont acheminées dans un AttributePivoter.

Dans la boîte de dialogue des paramètres, nous choisissons de regrouper les lignes par région, puis par potentiel. L'ordre est important.

L'attribut à analyser est observed - la colonne contenant nos statistiques. Nous avons demandé des calculs de Compte, de Somme et de Moyenne.

Les statistiques sont ajoutées en sortie.

Entités avec des attributs à analyser.

Une seule nouvelle entité sera produite, contenant toutes les statistiques calculées pour chaque groupe de lignes complètement défini. Les attributs de ces entités sont décrits dans la section "Regroupement des résultats et structure tabulaire".

La première ligne sortant du port DATA contient les informations relatives aux types d'entités définies par le schéma dynamique.

Pour chaque regroupement logiquement imbriqué tel que décrit dans la section "Regroupement des résultats et structure tabulaire", une ligne de résumé sera émise avant la première ligne de données du groupe. Elle fournit des informations récapitulatives pour toutes les rangées contenues dans le groupe. Un résumé de toutes les lignes sera toujours généré.

La première ligne sortant du port Summary contient les informations relatives au schéma pour une configuration dynamique.

Utilisation de l'éditeur de texte

L'éditeur de texte fournit un moyen efficace de construire des chaînes de textes (dont les expressions régulières) à partir de données source diverses, telles que des attributs, des paramètres et des constantes, et le résultat est directement utilisé dans le paramètre.

Editeur de texte

Utilisation de l'éditeur arithmétique

L'éditeur arithmétique fournit un moyen simple de construire des expressions mathématiques à partir de plusieurs données source, telles que des attributs et des fonctions, et le résultat est directement utilisé dans un paramètre.

Éditeur arithmétique

Valeur conditionnelle

Définit des valeurs selon un ou plusieurs tests.

Fenêtre de définition de conditions

Contenu

Les expressions et chaînes de caractères peuvent inclure des fonctions, caractères, paramètres et plus.

Lors du paramétrage des valeurs - qu'elles soient entrées directement dans un paramètre ou construites en utilisant l'un des éditeurs - les chaînes de caractères et les expressions contenant des fonctions Chaîne de caractères, Math, Date et heure ou Entité FME auront ces fonctions évaluées. Par conséquent, les noms de ces fonctions (sous la forme @<nom_de_fonction>) ne doivent pas être utilisés comme valeurs littérales de chaîne de caractères.

Types de contenu

Fonctions chaînes de caractères	Ces fonctions manipulent les chaînes de caractères.
Caractères spéciaux	Un ensemble de caractères de contrôle est disponible dans l'éditeur de texte.
Fonctions mathématiques	Plusieurs fonctions sont disponibles dans les deux éditeurs.
Fonctions Date/heure	Les fonctions de dates et heures sont disponibles dans l'Editeur texte.
Opérateurs mathématiques	Ces opérateur sont disponibles dans l'éditeur arithmétique.
Fonctions d'entités	Elles retournent des valeurs spécifiques aux entités.
Paramètres FME	Les paramètres FME et spécifiques au traitement peuvent être utilisés.
Créer et modifier un paramètre publié	Créer ses propres paramètres éditables.

Note : Tous les outils ne sont pas disponibles dans tous les Transformers.