TimeWindower

Catégories

Exécution

Ajoute un attribut de période temporelle à chaque entité, en attribuant un ID de période basé soit sur l'heure à laquelle l'entité arrive au Transformer, soit sur un horodatage stocké comme attribut.

La durée d'une période de temps est spécifiée avec un choix d'unités (secondes, minutes, heures ou jours), et la première période peut commencer au démarrage du traitement, avec l'arrivée de la première entité, ou à un horodatage spécifié.

La valeur de l'ID de la période peut être soit :

  • un compte incrémentiel de périodes (basé sur la durée spécifiée, en commençant par zéro (0)), ou

  • l'heure de début ou de fin de la période (en secondes, heure Unix).

Configuration

Ports de sortie

Les entités qui ont réussi à faire ajouter l'attribut Window ID à l'entité.

Toutes les entités sortent par ce port sauf si :

  • l'entité est rejetée, ou

  • un Type de commande est sélectionné et l'entité est en dehors de la période actuelle

Lorsque l'attribut Window ID change, une nouvelle entité est créée et envoyée à partir de ce port.

Cette nouvelle entité quitte le port WindowChanged avant que les entités de cette période ne soient envoyées par le port Output.

OutOfSequence Les entités sont produites ici si les données qui entrent dans le TimeWindower sont séquencées et que l'horodatage d'une entité est en dehors de la période actuelle et de la tolérance de la période.

Note  Ce Transformer ne trie pas les entités dans le temps. Si les entités entrant dans le Transformer ne sont pas ordonnées, la même entité modifiée dans la période peut être sortie plus d'une fois.

Ce port n'est exposé que si la période de temps est basée sur la valeur d'un attribut.

Les entités sont sorties par ce port si leur horodatage ne correspond pas à la période de temps actuelle et si l'intervalle de tolérance de la période à laquelle elles appartenaient est terminé.

Le port dynamique <Rejected> apparaît quand un paramètre est défini à une valeur non littérale rendant le process impossible.

Par exemple, si un paramètre numérique tel que la largeur de ligne, Début du compte, ou Nombre de décimales est défini par une expression, une valeur d'attribut ou un paramètre, il est possible de passer une valeur non numérique ne pouvant être utilisé. Décimales = Chat ne peut pas être traité, l'entité sera donc émise via ce port.

Les entités rejetées auront un attribut fme_rejection_code expliquant la raison du rejet.

Gestion des entités rejetées : ce paramètre permet d'interrompre la traduction ou de la poursuivre lorsqu'elle rencontre une entité rejetée. Ce paramètre est disponible à la fois comme option par défaut de FME et comme paramètre de traitement.

Paramètres

Durée de la période

L'unité de la durée de la période de temps est spécifiée par le paramètre Unités de temps.

Unités de temps

Les unités pour la durée de la période.

  • Secondes
  • Minutes (par défaut)
  • Heures
  • Jours

Début de la période de temps

Définit quand la période s'initialise pour la première fois.

  • Au démarrage du traitement (par défaut)
  • Avec la première entité
  • À l'horodatage

À l'horodatage

Horodatage spécifié par l'utilisateur pour la première période. Ce paramètre est activé lorsque l'option A l'Horodatage est sélectionnée pour le paramètre Début de la période.

Données horodatées

Détermine comment les entités entrant dans le Transformer sont assignées à une période de temps.

S'il est réglé sur Non (par défaut), les entités sont assignées à la période de temps à partir de l'heure du traitement en cours.

S'il est défini sur Oui, l'attribut d'horodatage est utilisé pour l'affectation des périodes de temps.

Attribut d'horodatage

L'horodatage à évaluer et à utiliser pour attribuer l'entité à une période. Il doit s'agir d'une date/heure FME valide. Ce paramètre est activé lorsque le paramètre Les données contiennent un horodatage vaut Oui.

Attribut ID de période

Nommez l'attribut qui contient l'identifiant de la période. Le type d'identifiant est spécifié par Type d'ID.

Type d'ID

Spécifie le type d'identification de la période.

  • Heure de début de période (par défaut) : L'heure de début d'une période assignée en secondes depuis le début de l'époque Unix, 00:00:00 UTC le 1er janvier 1970. Les heures de début de période avant cette date sont exprimées en secondes négatives.
  • Heure de fin de période : L'heure de fin d'une période assignée en secondes depuis le début de l'époque Unix, 00:00:00 UTC le 1er janvier 1970. Les heures de fin de période avant cette date sont exprimées en secondes négatives.
  • Numéro de période : Un nombre entier pour les périodes assignées. Le nombre commence à 0 et il est attribué à la première période. Le nombre peut également être négatif, -1 est attribué à la période précédant la première période.

Spécifie l'ordre chronologique dans lequel les données sont censées arriver au Transformer. Ceci n'est utile que lorsqu'un attribut Timestamp est spécifié.

Type d'ordre

Renforce l'ordre des entités à travers le port de sortie. Les entités qui ne suivent pas l'ordre spécifié seront envoyées au port OutOfSequence.

  • Aucun (par défaut) Il n'y a pas d'ordre attendu. Le Transformer ajoutera des ID de période aux entités au fur et à mesure de leur passage, produisant une entité WindowChanged à chaque fois que cela se produit. Le port OutOfSequence est caché.

  • Ordre dhronologique : Les entités arriveront dans l'ordre croissant de l'ID de la période. Ceci est utilisé pour se connecter à des réseaux de capteurs ou à tout système ou dispositif en direct ou en temps réel. Des paramètres de tolérance sont disponibles.

  • Inverser l'ordre chronologique : Les entités arriveront dans l'ordre décroissant de l'ID de la période - c'est-à-dire que les données les plus récentes arriveront en premier. Cela peut être utilisé pour absorber des données temporelles historiques. Des paramètres de tolérance sont disponibles.

Paramètres de tolérance

 

Activé lorsque le type d'ordre est chronologique ou chronologique inversé.

Intervalle de tolérance

L'intervalle de tolérance en unités spécifiées par le paramètre Unités de temps de tolérance. Un intervalle de tolérance valide doit être compris entre 0 et l'intervalle de durée de la période.

Les entités qui arrivent hors service peuvent être acceptées en fonction des paramètres de l'intervalle de tolérance.

Lorsque l'intervalle de tolérance est fixé à 0, toutes les entités attribuées aux périodes précédentes seront considérées comme en retard, et seront envoyées au port OutOfSequence.

Si l'intervalle de tolérance est différent de zéro, les entités tardives seront tout de même acceptées pour la sortie si les entités qui arrivent tôt sont dans l'intervalle de tolérance de la période suivante. Il est recommandé que l'intervalle de tolérance soit une fraction de la durée de la période, avec un maximum ne dépassant pas 50%.

Exemple :

Durée de la période : 5 minutes

Début de la période : Avec la première entité

Type de tri : Chronologique

Intervalle de tolérance : 1 minute

Horodatage d'entité

(hh:mm:ss)

ID de période d'entité

Statut

12:00:00

0

Génère la sortie

12:05:30

1

Retient l'entité

12:04:00

0

Génère la sortie

12:07:00

1

L'entité de sortie de 12:05:30 et ensuite l'entité actuelle.

12:03:00

0

Entité dans le mauvais ordre

  • L'entité initiale à 12:00:00 définit l'heure de début, et est ensuite envoyée au port de sortie.

  • La deuxième entité de 12:05:30 provient de la période suivante avec un ID de 1. Comme l'horodatage de 12:05:30 est dans la tolérance d'une minute par rapport à la fin de la période précédente à 12:05:00, l'entité sera maintenue.

  • La troisième entité est acceptée, puisque la TimeWindower accepte toujours les entités de la période ID 0.

  • Avec la quatrième entité, l'horodatage a maintenant dépassé la tolérance d'une minute à partir de la fin de la période précédente. Cela signifie que la TimeWindower émet toutes les entités "retenues", comme celle de 12:05:30, puis l'entité actuelle de 12:07:00, toutes deux issues de la période ID 1. Ces éléments sont émis dans l'ordre après l'émission d'une entité via le port WindowChanged.

  • La cinquième entité de la période ID 0 sera hors service.

Unités de temps de tolérance

Unités de l'intervalle de tolérance

  • Secondes

  • Minutes (par défaut)

  • Heures

  • Jours

Éditer les paramètres des Transformers

À l'aide d'un ensemble d'options de menu, les paramètres du Transformer peuvent être attribués en faisant référence à d'autres éléments de traitement. Des fonctions plus avancées, telles qu'un éditeur avancé et un éditeur arithmétique, sont également disponibles dans certains Transformers. Pour accéder à un menu de ces options, cliquez sur à côté du paramètre applicable. Pour plus d'informations, voir Options de menus et paramètres de Transformer.

Définir les valeurs

Il existe plusieurs façons de définir une valeur à utiliser dans un Transformer. La plus simple est de simplement taper une valeur ou une chaîne de caractères, qui peut inclure des fonctions de différents types comme des références d'attributs, des fonctions mathématiques et de chaînes de caractères, et des paramètres de traitement. Il existe un certain nombre d'outils et de raccourcis qui peuvent aider à construire des valeurs, généralement disponibles dans le menu contextuel déroulant adjacent au champ de valeur.

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.

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.

Options - Tables

Les Transformers avec des paramètres de style table possèdent des outils additionnels pour remplir et manipuler des valeurs.

Réordonner

Activé une fois que vous avez cliqué sur un élément de ligne. Les choix comprennent :

  • Ajouter une ligne
  • Supprimer une ligne
  • Déplacer la ligne en cours au dessus
  • Déplacer la ligne en cours en dessous
  • Déplacer la ligne en cours en haut de liste
  • Déplacer la ligne en cours en bas de liste

Couper, Copier et Coller

Activé une fois que vous avez cliqué sur un élément de ligne. Les choix comprennent :

  • Couper une ligne - supprime et copie dans le presse-papiers.
  • Copie une ligne dans le presse-papiers.
  • Colle une ligne depuis le presse-papiers.

Copier, copier et coller peuvent être utilisés au sein d'un Transformer ou entre Transfromers.

Filtre

Commencez à taper une chaîne de caractères, et la matrice n'affichera que les lignes correspondant à ces caractères. Recherche dans toutes les colonnes. Cela n'affecte que l'affichage des attributs dans le Transformer - cela ne change pas les attributs qui sont sortis.

Importer

Le bouton d'import remplit la table avec un jeu de nouveaux attributs lus depuis un jeu de données. L'application spécifique varie selon les Transformers.

Réinitialiser/Rafraîchir

Réinitialise la table à son état initial, et peut fournir des options additionnelles pour supprimer des entrées invalides. Le comportement varie d'un Transformer à l'autre.

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

FME Community

FME Community est l'endroit où trouver des démos, des tutoriaux, des articles, des FAQ et bien plus encore. Obtenez des réponses à vos questions, apprenez des autres utilisateurs et suggérez, votez et commentez de nouvelles entités.

Voir tous les résultats à propos de ce Transformer sur FME Community.