AzureServiceBusConnector

Se connecte au bus de service Azure à l'aide du SDK Azure Service Bus.

Aller à la configuration

Cas d'utilisations typiques

Recevoir et envoyer des messages à partir d'une file d'attente ou d'un sujet
Interopérabilité avec des plateformes d'analyse Big Data

Comment fonctionne-t-il ?

AzureServiceBusConnector se connecte au bus de service Azure à l'aide du SDK Azure Service Bus.

Service Bus utilise le protocole AMQP 1.0. Le connecteur prend en charge l'envoi et la réception de messages.

De plus amples informations sur le Service Bus sont disponibles dans la documentation officielle de Microsoft.

Configuration

Ports d'entrée

Ports de sortie

Paramètres

Authentification

Source des identifiants

Requis pour l'authentification. L'utilisation d'une connexion Web s'intègre le mieux à FME, mais dans certains cas, vous pouvez souhaiter utiliser l'une des autres sources.

Connexion web - utiliser une connexion web Azure Service Bus enregistrée dans la base de données de connexions FME.
Intégrée - Chaîne de connexion au bus de service

Compte

Disponible lorsque la source d'accréditation est Connexion web. Pour créer une connexion Azure Service Bus, cliquez sur le menu déroulant "Compte" et sélectionnez "Ajouter une connexion web…".

La connexion pourra ensuite être gérée via Outils -> Options FME... -> Connexions Web.

Informations d'authentification intégrées

Chaîne de connexion du bus de service

Disponible lorsque la source d'authentification est intégrée. La chaîne de connexion se trouve dans l'espace de noms Azure Portal Event Hubs sous Shared Access Policies.

Requête

Action

Le type d'opération à effectuer. Les choix possibles sont :

Recevoir depuis la file d'attente
Recevoir depuis un abonnement
Envoyer à la file d'attente
Envoyer au sujet

Hubs d'événements

Le hub de l'événement auquel se connecter.

Les autres paramètres disponibles dépendent de la valeur du paramètre Requête > Action. Les paramètres de chaque action sont détaillés ci-dessous.

Paramètres - Recevoir depuis la file d'attente

Options - Recevoir depuis la file d'attente

Mode de réception

Deux options de réception de messages sont disponibles :

Flux : Le connecteur continue à recevoir des messages indéfiniment. La traduction doit être interrompue pour arrêter la réception.
Lots : Seul un nombre donné de messages sont reçus avant que la connexion soit close.

Supprimer à la réception

Si oui, le message est supprimé de la file d'attente dès sa réception.

Si non, le message est récupéré mais reste dans la file d'attente. Le message pourra être reçu après la période de blocage.

Taille des lots

La méthode Par lots (Batch) spécifie le nombre de messages à lire par lot. La valeur par défaut est 1.

Paramètres - Recevoir depuis un abonnement

Options - Recevoir depuis un abonnement

Mode de réception

Deux options de réception de messages sont disponibles :

Flux : Le connecteur continue à recevoir des messages indéfiniment. La traduction doit être interrompue pour arrêter la réception.
Lots : Seul un nombre donné de messages sont reçus avant que la connexion soit close.

Supprimer à la réception

Si oui, le message est supprimé de l'abonnement dès sa réception.

Si non, le message est récupéré mais reste dans l'abonnement. Le message pourra être reçu après la période de blocage.

Taille des lots

La méthode Par lots (Batch) spécifie le nombre de messages à lire par lot. La valeur par défaut est 1.

Paramètres - Envoyer à la file d'attente

Options - Envoyer à la file d'attente

File d'attente	La file d'attente à laquelle envoyer les messages.
Créer une file d'attente	Si oui, créer la file d'attente avec le nom donné. Un message sera enregistré si la file d'attente existe déjà. Si non, utilise la file d'attente disponible.
Payload	Contenu du message Il s'agit souvent de JSON, mais il peut s'agir de n'importe quelle chaîne, binaire, nombre entier ou valeur en virgule flottante.
Propriétés du message	Propriétés du message paramétrables. Toute valeur de clé peut être utilisée, mais les clés suivantes sont associées aux attributs respectifs du message. session_id message_id content_type correlation_id vers reply_to reply_to_session_id subject scheduled_enqueue_time_utc time_to_live partition_key

Paramètres - Action d'envoi au sujet

Options - Envoi au sujet

Sujet	Le sujet auquel envoyer les messages.
Créer sujet	Si oui, créer le sujet avec le nom donné. Un message sera enregistré si la file d'attente existe déjà. Si non, utilise le sujet disponible.
Payload	Contenu du message Il s'agit souvent de JSON, mais il peut s'agir de n'importe quelle chaîne, binaire, nombre entier ou valeur en virgule flottante.
Propriétés du message	Propriétés du message paramétrables. Toute valeur de clé peut être utilisée, mais les clés suivantes sont associées aux attributs respectifs du message. session_id message_id content_type correlation_id vers reply_to reply_to_session_id subject scheduled_enqueue_time_utc time_to_live partition_key

Attributs en sortie

Les attributs suivants peuvent être sélectionnés pour être inclus dans les entités de sortie. Chaque entité de sortie représente un message qui a été soit envoyé, soit reçu.

_payload	La charge utile du message. Chaîne UTF-8 si possible à décoder, sinon binaire ou numérique.
_properties	Une paire clé/valeur des propriétés du message.
_content_type	Le type de contenu paramétrable du message.
_correlation_id	L'identifiant de corrélation paramétrable du message.
_enqueued_sequence_number	La position du message dans la file d'attente/l'abonnement.
_enqueued_time	L'horodatage FME du moment où un message a été ajouté à la file d'attente ou à l'abonnement.
_expires_at	L'horodatage FME de l'expiration du message.
_lock_tocken	Un uuid utilisé pour indiquer que le message a été reçu mais qu'il n'a pas été complété ou supprimé. Il empêche les autres destinataires de recevoir le message
_locked_until	Horodatage FME indiquant que le message sera déverrouillé afin de pouvoir être reçu à nouveau.
_message_id	L'id paramétrable d'un message.
_partition_key	La clé de partition dans laquelle est le message.
_reply_to	La réponse paramétrable à un message.
_sequence_number	Le numéro de séquence d'un message.
_subject	Le sujet paramétrable d'un message.
_time_to_live	L'horodatage FME de la durée pendant laquelle le message restera dans la file d'attente/l'abonnement.
_to	Le destinataire paramétrable d'un message.

É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.

Définir des valeurs de paramètres

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.

Options - Tables

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

Outils de tableau

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.

Références

Comportement	Basé sur des entités
Stockage des entités	Non
Dépendances	Compte Microsoft Azure avec le bus de service Service Bus
Alias
Historique	Implémenté dans FME 2019.2

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.

Les exemples peuvent contenir des informations sous licence Open Government - Vancouver et/ou Open Government - Canada.