Passer au contenu principal
HttpRequest envoie à des services externes des requêtes HTTP contenant des données application/x-www-form-urlencoded, du texte ou des données binaires.

​
Propriétés

NameTypeAccessDescription
UrlstringLecture/écritureL’URL de la ressource.
MethodstringLecture/écritureLa méthode de requête (par exemple, GET ou POST).
AuthTokenstringLecture/écritureJeton d’authentification si le service externe exige une authentification.
AuthSchemestringLecture/écritureMode d’authentification.
ThrowExceptionOnFailedbooleanLecture/écritureSi true (par défaut), les codes d’état de réponse HTTP en dehors de 200–299 génèrent une exception. Voir la note ci-dessous.
TimeoutnumberLecture/écritureDélai d’expiration de la requête, en minutes. La valeur par défaut est de 1 minute.
ResponseTextstringLecture seuleLe corps de la réponse au format texte.
ResponseTypestringLecture seuleLe type de contenu de la réponse (par exemple, application/json).
StatusnumberLecture seuleLe code d’état de la réponse HTTP renvoyé par le service externe.
Lorsque ThrowExceptionOnFailed est false, aucune exception n’est générée pour les réponses 4xx/5xx — vérifiez alors vous-même le code d’état HTTP dans Status. Une réponse avec un code d’erreur signifie que le service externe est joignable et qu’il répond. Les erreurs liées à la disponibilité du service ou aux échecs de connexion génèrent toujours une exception du programme, quelle que soit cette propriété — dans ces cas, aucun code d’état HTTP n’est disponible.
Si ThrowExceptionOnFailed est true et que la réponse contient un code d’erreur, la transaction est interrompue et le message d’erreur apparaît dans Skill Monitor.
La valeur Timeout ne peut pas dépasser la limite de durée d’exécution du script (600 secondes).

​
Méthodes

​
SetHeader

void SetHeader(string name, string value);
Définit un en-tête HTTP supplémentaire pour la requête. Appelez cette méthode une fois par en-tête.

​
Send

void Send();
Envoie la requête HTTP.

​
SetFileContent

void SetFileContent(DocumentExportResult documentExportResult, string mediaType?);
void SetFileContent(BinaryFile binaryFile, string mediaType?);
Initialise un corps de requête HTTP à partir d’un fichier. Le type de contenu est déterminé à partir de l’extension du fichier (par exemple, application/json, application/pdf). Pour le remplacer, transmettez mediaType.
  • La première surcharge envoie les données exportées (depuis Document.Exports) sous forme de fichier.
  • La seconde surcharge envoie des données binaires — soit l’image source utilisée lors de la création de la transaction, soit une image provenant d’un champ de type Picture.

​
SetSourceFileContent

void SetSourceFileContent(string mediaType?);
Initialise une requête avec des données binaires à partir de l’image source importée lors de la création de la transaction. Le type de contenu est déterminé à partir de l’extension du fichier. Remplacez-le par mediaType si nécessaire.
SetSourceFileContent est obsolète — cette méthode accède uniquement au premier fichier d’une transaction. Utilisez plutôt SetFileContent.

​
SetStringContent

void SetStringContent(string content, ContentEncoding contentEncoding?, string mediaType?);
Initialise un corps de requête HTTP basé sur une string. Par défaut, Content-Type: application/json et l’encodage UTF-8 sont utilisés. Vous pouvez remplacer l’un ou l’autre à l’aide des paramètres optionnels.

​
SetUrlFormEncodedContent

void SetUrlFormEncodedContent(any content);
Initialise le corps de la requête à partir d’un objet JavaScript et l’encode au format application/x-www-form-urlencoded. L’objet doit être un simple ensemble de paires propriété-valeur : 
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);