Passer au contenu principal
Une requête HTTP contenant des données de type application/x-www-form-urlencoded, texte et binaire.

Propriétés

NameTypeDescription
UrlstringL’url de la ressource.
MethodstringType de requête (par exemple GET ou POST).
AuthTokenstringJeton d’authentification (si l’authentification du service externe est requise).
AuthSchemestringSchéma d’authentification.
ThrowExceptionOnFailedbooleanIndique s’il faut générer une exception lorsque le service externe renvoie un code d’erreur comme statut de réponse HTTP (c.-à-d. en dehors de l’intervalle 200–299). Si défini sur False, aucune exception n’est générée lorsqu’un service externe renvoie un code d’erreur comme statut de réponse HTTP. Pour consulter l’état du code de réponse HTTP, vérifiez la valeur de la propriété Status. Valeur par défaut : True. Important ! Si la réponse contient un code d’erreur, cela signifie que le service externe fonctionne et répond aux requêtes. En revanche, si une erreur liée à la disponibilité du service ou à la connexion Internet se produit lors de l’envoi d’une requête HTTP, une exception du programme sera générée quelle que soit la valeur de cette propriété, car aucun code de statut HTTP du service externe n’est alors disponible.
TimeoutnumberDélai d’expiration de la requête (en minutes). Valeur par défaut : 1 minute. Important ! Le délai d’expiration de la requête ne peut pas dépasser la limite d’exécution du script (600 secondes).
ResponseTextstring, read-onlyRésultats de la réponse au format Texte.
ResponseTypestring, read-onlyType de réponse renvoyé par le service, p. ex. « application/json ».
StatusnumberCode de statut HTTP renvoyé par le service externe. Si ThrowExceptionOnFailed est défini sur True, un code d’erreur génère une exception et la transaction est interrompue. Le texte du message d’erreur peut être consulté dans Skill Monitor.

Méthodes

NameDescription
SetHeader(string name, string value);Définit des en-têtes HTTP supplémentaires pour la requête. Appelez cette méthode pour chaque en-tête.
Send();Envoie la requête HTTP.
SetFileContent(DocumentExportResult documentExportResult, string mediaType?);Initialise une requête HTTP basée sur un flux, permettant de transmettre les données exportées sous forme de fichier. Le type de contenu est défini automatiquement d’après l’extension du fichier exporté, par exemple application/json, application/pdf. Si nécessaire, vous pouvez définir le type de contenu à l’avance à l’aide du paramètre optionnel mediaType.
SetFileContent(BinaryFile binaryFile, string mediaType?);Initialise une requête HTTP basée sur des données binaires, en transmettant soit le fichier image source importé lors de la création de la transaction, soit l’image contenue dans le champ de type Picture. Le type de contenu est défini automatiquement d’après l’extension du fichier importé. Si nécessaire, vous pouvez définir le type de contenu à l’avance à l’aide du paramètre optionnel mediaType.
SetSourceFileContent(string mediaType?);Initialise une requête HTTP basée sur des données binaires, permettant de transmettre le fichier image source importé lors de la création de la transaction. Le type de contenu est défini automatiquement d’après l’extension du fichier importé. Si nécessaire, vous pouvez définir le type de contenu à l’avance à l’aide du paramètre optionnel mediaType. Important : cette méthode est obsolète. Elle n’accédera qu’au premier fichier de la transaction. Utilisez plutôt la méthode SetFileContent().
SetStringContent(string content, ContentEncoding contentEncoding?, string mediaType?);Initialise une requête HTTP basée sur une string. Par défaut, Content-Type est défini sur application/json avec l’encodage UTF-8. Si nécessaire, vous pouvez modifier à la fois le contenu et l’encodage.
SetUrlFormEncodedContent(any content);Initialise le contenu pour une requête basée sur un objet JavaScript et l’encode en application/x-www-form-urlencoded. L’objet JavaScript doit être initialisé comme un simple ensemble de propriétés, par ex. : var form = {}; form.grant_type = "password"; form.scope = "openid permissions"; form.client_id = "value of client_id"; form.client_secret = "value of client_secret"; form.password = "Password"; form.username = "User Name"; request.SetUrlFormEncodedContent(form);