Requête HTTP

Cette action envoie les données au serveur Web de destination en utilisant la méthode HTTP sélectionnée. Les schémas d'URI HTTP et HTTPS sont autorisés.

HTTP fonctionne comme un protocole de requête-réponse entre client et serveur. Dans cette action, fonctionne comme un client qui communique avec un serveur à distance. Cette action va soumettre la requête HTTP sélectionnée au serveur. Le serveur renverra un message de réponse, concernant l'état d'achèvement de la requête et la réponse dans le corps du message.

À propos : Ce groupe identifie l'action sélectionnée.

Nom : permet de définir un nom pour l'action. Cela permet de reconnaître plus facilement l'action dans la liste des actions de la solution. Par défaut, le nom de l'action provient de son type.
Description : Informations personnelles sur l'action. Mettre une description qui explique l'objectif et le rôle de l'action dans la solution.
Type d'action : Information en lecture seule sur le type d'action sélectionné.

Le groupe Paramètres de connexion permet de choisir les paramètres de connexion.

Note

Cette action est compatible avec le protocole Internet version 6 (IPv6).

Destination: L'adresse, le port et la destination (chemin) sur le serveur Web.

Note

La définition du port est facultative quand le serveur Web fonctionne sur le port 80 par défaut. Coder en dur les paramètres de connexion ou utiliser un nom d'hôte et une adresse IP fixes. Utiliser une valeur variable pour définir cette option dynamiquement. Pour plus d'informations, consulter l'article Utilisation de Valeurs Composées dans le guide utilisateur de Loftware Automation.

Exemple

Si la variable hostname fournit le nom du serveur Web et la variable port fournit le numéro de port, saisir la destination suivante : [hostname] :[port]

Méthode requise: Affiche les méthodes de requête disponibles.
Délai écoulé: Le temps imparti (en ms) pour que la connexion au serveur soit établie et la réponse reçue.
Enregistrer la réponse d'état dans une variable: Définit la variable dans laquelle est enregistré le code d'état renvoyé par le serveur.

Conseil

L'état du code doit être de l'ordre de 2XX. Par exemple, 200 est une bonne réponse. Les codes 5XX sont des erreurs du serveur.
Enregistrer la réponse de données dans une variable: Variable où sont enregistrées les données reçues du serveur.

Le groupe Authentification permet de sécuriser la connexion au serveur Web.

Activer une authentification de base: Permet de mettre les identifiants nécessaires à la connexion au serveur Web. L'identifiant et le mot de passe peuvent être fixes ou fournis par une valeur variable.

L'authentification Basique HTTP (BA) utilise les entêtes statiques standard HTTP. Le mécanisme BA ne procure aucune protection de confidentialité pour les infos d'identification transmises. Elles sont seulement encodées en Base64 pendant le transit, mais ne sont ni cryptées ni hachées. L'authentification de base devrait être utilisée en HTTPS.

Afficher le mot de passe: Démasque les caractères de l'identifiant et du mot de passe.

Note

L'action Requête HTTP s'exécute sur Web Printing Server et pas sur Web Printing Client.

Si vous utilisez l'action Requête HTTP dans Loftware Loftware Web Client et que vous souhaitez exécuter localement (en contournant Web Printing Server), ajoutez le préfixe « LOCAL_» au nom de votre action.

Contenu permet de définir le contenu à envoyer au serveur Web.

Données: Spécifie le contenu qui sera envoyé en sortie. Il peut être fixe, un mixte de contenu fixe et variable, ou contenu variable seul. Pour insérer un contenu de variable, cliquer sur le bouton avec une flèche à droite de la zone de données et insérer la variable de la liste. Pour plus d'informations, consulter l'article Combinaison de valeurs dans un objet dans le guide utilisateur de Loftware.
Encodage: Spécifie l'encodage des données envoyées.

Conseil

Auto définit automatiquement l'encodage. Si nécessaire, sélectionner le type d'encodage préféré dans le menu déroulant.
Type: Spécifie la caractéristique Content-Type pour le message HTTP. Si aucun type n'est sélectionné, la valeur par défaut application/x-www-form-urlencoded est utilisée. Si la liste ne contient aucun type utilisable, il est possible d'en définir un personnalisé, ou déterminer une variable qui le définira dynamiquement..

Des Entêtes HTTP supplémentaires sont exigées par certain serveurs HTTP (spécialement pour les services REST).

Note

Comme l'action Requête HTTP utilise déjà une clé d'abonnement intégrée, il est inutile de saisir la valeur de la clé d'abonnement Ocp-Apim-Subscription-Key dans des entêtes HTTP supplémentaires .

Vous devez fournir la valeur Ocp-Apim-Subscription-Key si vous effectuez un appel vers l'API sur le Cloud depuis une application en dehors de Loftware.

Entêtes additionnelles : Entêtes codées en dur ou récupérées d'une variable. Pour accéder aux variables, cliquer sur la petite flèche à la droite du champ de texte. Pour plus d'informations, consulter l'article Combinaison de valeurs dans un objet dans le guide utilisateur de Loftware.

Certains serveurs HTTP (spécialement pour les services REST) obligent à inclure l'entête HTTP personnalisée dans le message. Cette section permet de fournir les entêtes HTTP nécessaires.

L'entête HTTP doit être introduite en respectant la syntaxe suivante :

Nom du champ d'entête: Valeur du champ d'entête

Par exemple, pour utiliser les noms des champs Accept, User-Agent et Content-Type, utiliser la syntaxe suivante :
```
Accept : application/json ; charset=utf-8
User-Agent : Mozilla/5.0 (Windows NT 6.3 ; WOW64) AppleWebKit/537.36 (KHTML,
like Gecko) Chrome/31.0.1650.63 Safari/537.36
Content-Type: application/json; charset=UTF-8
```
Vous pouvez coder en dur les noms des champs des entêtes ou obtenir leurs valeurs à partir des variables des déclencheurs. Il est possible d'utiliser autant de champs d'entête personnalisés que nécessaires, mais chaque entête doit être placée sur une nouvelle ligne.

Note

Les entêtes HTTP saisies vont remplacer les entêtes déjà définies dans les propriétés des actions, telles que Content-Type (type de contenu).

Exécution d'une action et traitement d'erreur

Chaque action peut être soumise à condition. Une action conditionnelle ne fonctionne que quand les conditions fournies lui permettent de fonctionner. Pour définir ces conditions, cliquer sur Afficher les options d'exécution et de gestion des erreurs.

Options d'exécution existantes :

Activée : Spécifie si l'action est activée ou désactivée. Seules les actions activées seront exécutées. Cette fonctionnalité est utilisable lors du test d'un formulaire.
Condition : définit une expression de programmation d'une ligne qui doit fournir une valeur booléenne (vrai ou faux). Quand le résultat de l'expression est vrai, l'action s'exécute. Une condition permet d'éviter que l'action soit exécutée chaque fois.

Options de Traitement d'erreurs :

Ignorer l'échec : Spécifie si une erreur doit être ignorée. Si elle est activée, l'exécution des actions continue même si l'action en cours a échoué.
Remarque
Les actions indentées qui dépendent de l'action actuelle ne seront pas exécutées en cas d'échec. L'exécution des actions continuera avec l'action suivante qui se trouve au même niveau que l'action actuelle. L'erreur est enregistrée dans le journal, mais elle n'interrompt pas l'exécution de l'action.

Exemple

À la fin de l'impression, il est possible d'envoyer la mise à jour du statut à une application externe en utilisant l'action Requête HTTP . Si l'action d'impression échoue, le déclencheur arrête le traitement des actions. Pour effectuer le rapport, même après un échec d'impression, l'action Imprimer l'étiquette doit avoir l'option Ignorer l'échec activée.

Enregistrer l'erreur dans une variable : permet de définir une variable pour y enregistrer l'erreur. La raison de l'erreur est aussi enregistrée dans les variables internes ActionLastErrorId et ActionLastErrorDesc.