Lire sur un socket réseau |
L'action Lire sur un socket réseau lit les données entrantes sur un socket réseau.
Vous pouvez configurer les propriétés de l'action Lire sur un socket réseau dans les onglets suivants.
Socket réseau
Protocole : Définit le protocole de socket à utiliser.
Port : Définit le port d'adresse réseau.
Adresse réseau :
Écouter sur toutes les interfaces de réseau : Indique au socket d'écouter toutes les adresses réseau.
Écouter sur une adresse IP spécifique (v4/v6) : Indique au socket de n'écouter que l'adresse IP que vous avez définie.
Paramètres de communication
Délai de lecture : Indique le temps d'attente de lecture des données par le socket.
Délai d'écriture : Indique le temps d'attente d'écriture des données par le socket. Disponible uniquement quand vous sélectionnez TCP en tant que protocole.
Protocole de connexion
Envoyer un message de confirmation à la connexion du client : Indique que le message envoyé lorsque la connexion de socket est établie. Saisissez le message que vous voulez dans la zone de saisie. Autrement, vous pouvez ajouter une variable pour définir le message de confirmation. Vous pouvez également ajouter un caractère spécial à la valeur que vous avez saisie.
Enregistrer le message de réponse après la lecture des données de la connexion du client : Indique que le message qui est envoyé après l'exécution de l'action. Saisissez le message que vous voulez dans la zone de saisie. Autrement, vous pouvez ajouter une variable pour définir le message de réponse. Vous pouvez également ajouter un caractère spécial à la valeur que vous avez saisie.
Options de données
Page de code : Indique la méthode qui est utilisée pour coder le message lu.
Arrêter la lecture quand : Spécifie la condition selon laquelle l'action cesse de lire le message.
La séquence de caractères est reçue : Indique que l'action cesse de lire le message après la réception d'une séquence de caractères spécifiée.
Caractères : Définit la séquence de caractères qui indique à l’action de cesser de lire le message.
Inclure une séquence dans le contenu de données d'entrée : Indique que la séquence de caractères spécifiée est lue dans le contenu des données.
Nombre de caractères reçu : Indique que l'action cesse de lire le message après la réception d'un nombre spécifié de caractères.
Caractères : Définit le nombre maximum de caractères que l’action accepte dans le message.
Le port devient inactif : Indique que l'action cesse de lire le message en cas d'inactivité du port pendant une certaine durée.
Temps à attendre : Indique la durée pendant laquelle le port peut rester inactif avant que l’action cesse la lecture du message.
Socket déconnecté : Indique que l’action cesse de lire le message quand le socket se déconnecte.
Type de contenu: Indique le type de contenu de fichier. L’action traite le contenu du message selon ce format.
Les données sont contenues dans un message SOAP : Lorsque cette option est activée, l'action s'attend à ce que les données soient contenues dans un message SOAP.
Réponse
Répondre avec une nouvelle connexion : Indique à l’action de répondre en utilisant la nouvelle connexion spécifiée.
Nom d'hôte : Indique le nom DNS de l'hôte distant auquel vous souhaitez vous connecter.
Adresse IP(v4/v6) : Définit l'adresse IP pour la connexion.
Port : Définit le port d'adresse réseau.
Sortie
Enregistrer les données d'entrée dans la variable : Indique la variable dans laquelle vous souhaitez enregistrer l'entrée de l'action. Saisissez la variable souhaitée. Autrement, vous pouvez aussi ajouter une variable.
Action
Nom : Indique le nom de l'action. Vous pouvez remplacer le nom par défaut en saisissant un nouveau nom dans le champ.
Description : Présente une description de l’action.
Exécuter une action : Pour définir la fréquence à laquelle l'action doit être exécutée.
Toujours : Indique que l'action est exécutée à chaque fois que l'événement se produit.
Jamais : Indique que l'action n’est pas exécutée lorsque l'événement se produit.
Sous conditions, en fonction de la variable : Indique que l'action est uniquement exécutée lorsqu’une variable sélectionnée répond à une condition spécifiée. Utiliser cette option dans les situations où une seule condition détermine l'exécution de l'action. Après avoir sélectionné cette option, vous pouvez créer l'instruction conditionnelle dans la zone de saisie.
Variable : Indique la variable que vous souhaitez utiliser pour l'instruction conditionnelle. Saisissez la variable dans la zone de saisie. Cliquer sur pour voir une liste de variables récemment utilisées ou cliquer sur Plus de variables pour ouvrir la boîte de dialogue Insérer une variable.
[Opérateur relationnel]: Définit l'opérateur relationnel à utiliser pour l'énoncé conditionnel. Cliquez sur l'opérateur existant pour afficher une liste contenant d'autres opérateurs, puis cliquez sur celui que vous souhaitez utiliser. Pour en savoir plus, reportez-vous à la rubrique Opérateurs relationnels. Les opérateurs qui sont disponibles dans la liste dépendent de si vous avez sélectionné Texte ou Décimal pour l'option Type.
Valeur : Définit les valeurs à utiliser pour l'instruction conditionnelle. Pour ajouter une valeur, cliquez sur , cliquez sur <saisir une valeur>, saisissez la valeur souhaitée, puis appuyez sur Enter
. Pour supprimer une valeur, utilisez le bouton secondaire de la souris pour cliquer dessus, puis cliquez sur Supprimer. Pour certains opérateurs, par exemple Est vide et N'est pas vide, il n'est pas nécessaire de définir de valeur. Dans ces cas, le champ Valeur n'est pas disponible.
Type : Indique si l'énoncé conditionnel évalue un texte ou une valeur décimale.
Sous conditions, en fonction de l'expression : Spécifie les conditions dans lesquelles l'action est exécutée. Utilisez cette option pour les situations nécessitant plusieurs énoncés conditionnels. Lorsque vous sélectionnez cette option, vous pouvez créer l'instruction conditionnelle dans la zone de saisie en créant les instructions conditionnelles de votre choix. Vous pouvez créer et éditer l'expression conditionnelle dans l'onglet Vue arborescente. Cliquez sur l'onglet Vue arborescente pour afficher une vue en lecture seule de l'expression conditionnelle.
Contrôles de zone de saisie (onglet Vue arborescente)
[Opérateur conditionnel]: Définit l'opérateur conditionnel pour les énoncés conditionnels du groupe. L'opérateur conditionnel par défaut est And.
Cliquez sur l'opérateur conditionnel existant pour afficher un menu que vous pouvez utiliser pour configurer votre expression conditionnelle d'une des manières suivantes :
And, Or, NotAnd, NotOr : Cliquez sur l'opérateur conditionnel que vous souhaitez utiliser pour les instructions conditionnelles. Pour en savoir plus sur les opérateurs conditionnels pris en charge, consulter Opérateurs conditionnels.
Ajouter une condition : Cliquez pour ajouter un autre énoncé conditionnel au groupe actuel.
Ajouter groupe : Cliquez pour ajouter un sous-groupe d'instructions conditionnelles au groupe actuel.
Supprimer le groupe : Cliquez sur pour supprimer le sous-groupe. Disponible lorsque vous ouvrez le menu à partir d'un sous-groupe.
Tout supprimer : Cliquez pour supprimer tous les énoncés conditionnels (y compris les sous-groupes). Disponible lorsque vous ouvrez le menu à partir du groupe supérieur.
: Ajoute une instruction conditionnelle au groupe associé à cet opérateur. Visible à droite de chaque opérateur conditionnel de votre expression.
: Supprime l’instruction conditionnelle. Visible à droite d'une instruction conditionnelle existante lorsque vous pointez sur l'instruction.
Variable : Indique la variable que vous souhaitez utiliser pour l'instruction conditionnelle. Saisissez la variable dans la zone de saisie. Cliquer sur pour voir une liste de variables récemment utilisées ou cliquer sur Plus de variables pour ouvrir la boîte de dialogue Insérer une variable.
[Opérateur relationnel]: Définit l'opérateur relationnel à utiliser pour l'énoncé conditionnel. Cliquez sur l'opérateur existant pour afficher une liste contenant d'autres opérateurs, puis cliquez sur celui que vous souhaitez utiliser. Pour en savoir plus, reportez-vous à la rubrique Opérateurs relationnels. Les opérateurs qui sont disponibles dans la liste dépendent de si vous avez sélectionné Texte ou Décimal pour l'option Type.
Valeur : Définit les valeurs à utiliser pour l'instruction conditionnelle. Pour ajouter une valeur, cliquez sur , cliquez sur <saisir une valeur>, saisissez la valeur souhaitée, puis appuyez sur Enter
. Pour supprimer une valeur, utilisez le bouton secondaire de la souris pour cliquer dessus, puis cliquez sur Supprimer. Pour certains opérateurs, par exemple Est vide et N'est pas vide, il n'est pas nécessaire de définir de valeur. Dans ces cas, le champ Valeur n'est pas disponible.
Type : Indique si l'énoncé conditionnel évalue un texte ou une valeur décimale.
Erreur de traitement et diagnostic
Ignorer les erreurs et continuer à exécuter les actions : Indique que lorsque cette option échoue, les autres actions continueront à être exécutées. Si elle n’est pas sélectionnée et que l'action échoue, le comportement résultant dépend de plusieurs facteurs, comme suit :
L'action s'inscrit dans une action du Groupe
Si vous avez spécifié De manière séquentielle pour la propriété Exécuter les actions sur l’onglet Exécution du Groupe, aucune autre action n'est exécutée dans cette action de groupe. Aucune action en dehors de cette action du Groupe n'est affectée.
Si vous avez spécifié En parallèle pour la propriété Exécuter les actions sur l’onglet Exécution du Groupe, les erreurs sont ignorées et les autres actions dans ce Groupe sont exécutées. Aucune action en dehors de cette action du Groupe n'est affectée.
L'action ne s'inscrit pas dans une action du Groupe
Si vous avez spécifié De manière séquentielle pour la propriété Exécuter les actions sur l’onglet Exécution de l’événement, aucune autre action n'est exécutée dans l’événement.
Si vous avez spécifié En parallèle pour la propriété Exécuter les actions sur l’onglet Exécution de l’événement, les erreurs sont ignorées et les autres actions dans l’événement sont exécutées.
Réessayer en cas d'échec : Spécifie que si l'action échoue, BarTender essaie de l'exécuter à nouveau.
Nombre maximum de nouvelles tentatives : Indique le nombre maximum de tentatives de réexécution de l'action par BarTender. Disponible lorsque l'option Réessayer en cas d'échec est sélectionnée.
Intervalle de nouvelles tentatives : Indique la durée d'attente de BarTender après que l’action échoue avant de tenter de réexécuter l'action. Disponible lorsque l'option Réessayer en cas d'échec est sélectionnée.