docs: update request body instruction (#391)

Author: mytharcher

docs/en-US/handbook/workflow-request/index.md

@@ -48,12 +48,32 @@ Define key-value pairs for the query string. Values can dynamically utilize vari
 
 **Request Body**
 
-Currently, the request body supports only standard JSON format. Use the variable button in the upper-right corner of the text editor to insert context variables.
+Depends on the `Content-Type` option, different formats are supported.
+
+##### application/json
+
+Standard JSON format text is supported. Use the variable button in the upper-right corner of the text editor to insert context variables.
 
 :::info{title=Note}
 Ensure that variables within JSON are used as strings, for example: `"a": "{{$context.data.a}}"`.
 :::
 
+##### application/x-www-form-urlencoded
+
+This format supports standard key-value pairs. The variable button in the text editor can also be used to insert context variables.
+
+##### application/xml
+
+Supports standard XML format text. Similar to JSON, you can use the variable button to insert context variables.
+
+##### multipart/form-data
+
+Supports `multipart/form-data` format for key-value pairs. When selecting a data type as a file object, you can upload files. Files can only be selected from existing file objects in the context, such as results from file collection queries or related data from associated file collection.
+
+:::info{title=Note}
+When selecting file data, ensure that the variable corresponds to a single file object, not a list of files (in many-to-one relationships, the relationship field's value will be an array).
+:::
+
 **Timeout Settings**
 
 If the request takes too long to respond, the timeout setting will cancel it, leading to the premature termination of the current workflow with a failure status.

docs/fr-FR/handbook/workflow-request/index.md

@@ -1,62 +1,81 @@
-### Requêtes HTTP
+# Requêtes HTTP
 
 Lorsqu'il est nécessaire d'interagir avec un autre système web, le nœud **Requête HTTP** est l'outil idéal. Ce nœud vous permet d'envoyer une requête HTTP à une adresse spécifiée, accompagnée de données dans les formats JSON ou `application/x-www-form-urlencoded`, facilitant ainsi la communication avec des systèmes externes.
 
 Si vous êtes déjà familier avec des outils comme Postman, maîtriser le nœud Requête HTTP sera un jeu d'enfant. Cependant, contrairement aux outils traditionnels, ce nœud exploite des variables de contexte du workflow actuel, ce qui en fait un ajout puissant à l'intégration de votre processus métier.
 
-### Installation
+## Installation
 
 Il s'agit d'un plugin intégré, il n'est donc pas nécessaire de procéder à une installation.
 
-### Guide de l'Utilisateur
+## Guide de l'Utilisateur
 
-#### Création d'un Nœud
+### Création d'un Nœud
 
 Dans l'interface de configuration du workflow, cliquez sur le bouton plus ("+") pour ajouter un nœud "Requête HTTP" au processus :
 
 ![Requête HTTP_Ajouter](https://static-docs.nocobase.com/46f2a6fc3f6869c80f8fbd362a54e644.png)
 
-#### Configuration du Nœud
+### Configuration du Nœud
 
 ![Configuration du Nœud Requête HTTP](https://static-docs.nocobase.com/2fcb29af66b892fa704add52e2974a52.png)
 
-**Méthode de Requête**
+#### Méthode de Requête
 
 Choisissez parmi les méthodes de requête HTTP disponibles : `GET`, `POST`, `PUT`, `PATCH`, et `DELETE`.
 
-**URL de Requête**
+#### URL de Requête
 
 Indiquez l'URL du service HTTP, y compris le protocole (`http://` ou `https://`). Pour des raisons de sécurité, il est recommandé d'utiliser `https://`.
 
-**Format des Données de Requête**
+#### Format des Données de Requête
 
 Cela définit le `Content-Type` dans l'en-tête de la requête, avec les options `application/json` et `application/x-www-form-urlencoded`.
 
-**Configuration des En-têtes de Requête**
+#### Configuration des En-têtes de Requête
 
 Définissez des paires clé-valeur pour les en-têtes de la requête, avec des valeurs qui peuvent faire référence dynamiquement aux variables du contexte du workflow.
 
 :::info{title=Note}
 L'en-tête `Content-Type` est prédéfini par le paramètre de format des données de la requête. La saisie manuelle ici ne remplacera pas cette configuration.
 :::
 
-**Paramètres de Requête**
+#### Paramètres de Requête
 
 Définissez des paires clé-valeur pour la chaîne de requête. Les valeurs peuvent utiliser dynamiquement des variables du contexte du workflow.
+#### Corps de la requête
 
-**Corps de la Requête**
+La partie Body de la requête prend en charge différents formats selon le `Content-Type` sélectionné.
 
-Actuellement, le corps de la requête prend uniquement en charge le format JSON standard. Utilisez le bouton de variable dans le coin supérieur droit de l'éditeur de texte pour insérer des variables de contexte.
+##### application/json
 
-:::info{title=Note}
-Assurez-vous que les variables dans le JSON soient utilisées sous forme de chaînes, par exemple : `"a": "{{$context.data.a}}"`.
+Prend en charge le format texte JSON standard. Vous pouvez insérer des variables du contexte du flux à l'aide du bouton de variable situé en haut à droite de la zone d'édition de texte.
+
+:::info{title=Astuce}
+Les variables doivent être utilisées à l'intérieur d'une chaîne JSON, par exemple : `"a": "{{$context.data.a}}"`.
+:::
+
+##### application/x-www-form-urlencoded
+
+Prend en charge le format `application/x-www-form-urlencoded` sous forme de paires clé-valeur. La valeur peut contenir des variables du contexte du flux, qui seront interprétées comme un modèle de chaîne et concaténées pour former la valeur finale.
+
+##### application/xml
+
+Prend en charge le format texte XML standard. Vous pouvez insérer des variables du contexte du flux à l'aide du bouton de variable situé en haut à droite de la zone d'édition de texte.
+
+##### multipart/form-data <Badge>v1.8.0+</Badge>
+
+Prend en charge les données de formulaire au format `multipart/form-data` sous forme de paires clé-valeur. Si le type de données est défini sur "objet fichier", il est possible de téléverser un fichier. Le fichier doit être sélectionné via une variable pointant vers un objet fichier existant dans le contexte, comme un résultat de requête sur une table de fichiers ou une relation avec une table de fichiers.
+
+:::info{title=Astuce}
+Lorsque vous sélectionnez un fichier, assurez-vous que la variable correspond à un **objet fichier unique**, et non à une **liste de fichiers** (dans le cas d'une relation multiple, le champ relationnel sera un tableau).
 :::
 
-**Paramètres de Délai d'Attente**
+#### Paramètres de Délai d'Attente
 
 Si la requête prend trop de temps pour répondre, le paramètre de délai d'attente l'annulera, ce qui entraînera la terminaison prématurée du workflow actuel avec un état d'échec.
 
-**Ignorer l'Échec**
+#### Ignorer l'Échec
 
 Le nœud de requête considère tout code d'état HTTP entre `200` et `299` comme un succès. Les codes en dehors de cette plage sont considérés comme des échecs. Si vous sélectionnez l'option "Ignorer les requêtes échouées et continuer le workflow", le workflow poursuivra les nœuds suivants, même si la requête échoue.
 

docs/ja-JP/handbook/workflow-request/index.md

@@ -48,10 +48,30 @@ HTTPサービスのURLで、プロトコル部分（`http://`または`https://`
 
 #### リクエストボディ
 
-リクエストのボディ部分は、現在標準のJSON形式のみをサポートしています。テキストエディタの右上隅にある変数ボタンを使用して、プロセスコンテキストの変数を挿入できます。
+リクエストの Body 部分は、`Content-Type` の選択に応じて、さまざまな形式をサポートします。
+
+##### application/json
+
+標準的な JSON 形式のテキストをサポートしており、テキスト編集ボックスの右上にある変数ボタンから、フローのコンテキスト変数を挿入できます。
+
+:::info{title=ヒント}
+変数は JSON の文字列内で使用する必要があります。例：`"a": "{{$context.data.a}}"`。
+:::
+
+##### application/x-www-form-urlencoded
+
+`application/x-www-form-urlencoded` 形式のキーと値のペアをサポートしており、値にはフローコンテキストの変数を使用できます。変数が含まれる場合、それは文字列テンプレートとして解釈され、最終的な文字列に連結されます。
+
+##### application/xml
+
+標準的な XML 形式のテキストをサポートしており、テキスト編集ボックスの右上にある変数ボタンから、フローのコンテキスト変数を挿入できます。
+
+##### multipart/form-data <Badge>v1.8.0+</Badge>
+
+`multipart/form-data` 形式のキーと値のペアのフォームデータをサポートしています。データタイプにファイルオブジェクトを選択すると、ファイルのアップロードが可能です。ファイルは、コンテキスト内にすでに存在するファイルオブジェクト（ファイルテーブルのクエリ結果や、関連ファイルテーブルのリレーションデータ）を変数で指定する必要があります。
 
 :::info{title=ヒント}
-注：変数はJSONの文字列の中で使用する必要があります。例：`"a": "{{$context.data.a}}"`。
+ファイルデータを選択する場合、変数が単一のファイルオブジェクトを指していることを確認してください。複数ファイルの関係（多対多）のクエリでは、リレーションフィールドの値は配列になります。
 :::
 
 #### タイムアウト設定

docs/zh-CN/handbook/workflow-request/index.md

@@ -48,10 +48,30 @@ HTTP 服务的 URL，需要包含协议部分（`http://` 或 `https://`），
 
 #### 请求体
 
-请求的 Body 部分，目前仅支持标准的 JSON 格式，可以通过文本编辑框右上角的变量按钮插入流程上下文中的变量。
+请求的 Body 部分，根据 `Content-Type` 选择的不同，支持不同的格式。
+
+##### application/json
+
+支持标准的 JSON 格式的文本，可以通过文本编辑框右上角的变量按钮插入流程上下文中的变量。
+
+:::info{title=提示}
+变量必须在 JSON 的字符串中使用，例如：`"a": "{{$context.data.a}}"`。
+:::
+
+##### application/x-www-form-urlencoded
+
+支持 `application/x-www-form-urlencoded` 格式的键值对，值可以使用流程上下文中的变量，包含变量时会作为字符串模板解析并拼接为最终的字符串值。
+
+##### application/xml
+
+支持标准的 XML 格式的文本，可以通过文本编辑框右上角的变量按钮插入流程上下文中的变量。
+
+##### multipart/form-data <Badge>v1.8.0+</Badge>
+
+支持 `multipart/form-data` 格式的键值对表单数据，数据类型选择文件对象时可以上传文件。文件仅能通过变量选择上下文中已存在的文件对象，如对文件表查询的结果，或关联文件表的关系数据。
 
 :::info{title=提示}
-注：变量必须在 JSON 的字符串中使用，例如：`"a": "{{$context.data.a}}"`。
+选择文件数据时，需要确保变量对应的是单个文件对象，而不是一个文件列表（在对多关系查询时，关系字段的值会是一个数组）。
 :::
 
 #### 超时设置