1
0
mirror of https://github.com/Bayselonarrend/OpenIntegrations.git synced 2025-11-23 22:05:15 +02:00
Files
OpenIntegrations/docs/en/md/HTTP-client/Body-set/Add-multipart-form-data-file.mdx

91 lines
2.6 KiB
Plaintext
Raw Normal View History

2025-05-04 21:43:56 +03:00
---
sidebar_position: 6
2025-05-05 11:15:20 +03:00
description: Add Multipart file and other functions to work with HTTP-client in the Open Integration Package, a free open-source integration library for 1C:Enterprise 8, OneScript and CLI
2025-05-05 09:49:19 +03:00
keywords: [1C, 1С, 1С:Enterprise, 1С:Enterprise 8.3, API, Integration, Services, Exchange, OneScript, CLI, HTTP-client]
2025-05-04 21:43:56 +03:00
---
import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';
# Add Multipart file
Adds a file block to the multipart/form-data body
`Function AddMultipartFormDataFile(Val FieldName, Val FileName, Val Data, Val DataType = "") Export`
| Parameter | CLI option | Type | Required | Description |
|-|-|-|-|-|
| FieldName | - | String | ✔ | Form field name |
| FileName | - | String | ✔ | File name with extension |
| Data | - | BinaryData, String | ✔ | File data to be written |
| DataType | - | String | ✖ | MIME type of data |
Returns: DataProcessorObject.OPI_HTTPClient - This processor object
<br/>
:::tip
The Multipart record must first be initialized using the `StartMultipartBody` function
Parameters with Binary data type can also accept file paths on disk and URLs
:::
:::caution
**NOCLI:** this method is not available in CLI version
:::
<br/>
```bsl title="1C:Enterprise/OneScript code example"
2025-10-21 11:36:43 +03:00
URL = "https://bin.openintegrations.dev";
2025-05-04 21:43:56 +03:00
URL = URL + "/post";
2025-10-21 11:36:43 +03:00
Image = "https://hut.openintegrations.dev/test_data/picture.jpg"; // URL, Path or Binary Data
2025-05-04 21:43:56 +03:00
Result = OPI_HTTPRequests.NewRequest()
.Initialize(URL)
.StartMultipartBody()
.AddMultipartFormDataFile("file1", "pic.png", Image, "image/png") // <---
.AddMultipartFormDataField("Field1", "Text")
.AddMultipartFormDataField("Field2", "10")
.ProcessRequest("POST")
.ReturnResponseAsJSONObject();
```
2025-05-21 08:49:49 +03:00
```json title="Result"
{
"args": {},
"data": "",
"files": {
"file1": "..."
},
"form": {
"Field1": "Text",
"Field2": "10"
},
"headers": {
"Accept": "*/*",
"Accept-Charset": "utf-8",
"Accept-Encoding": "gzip",
2025-10-07 19:27:04 +03:00
"Connection": "Keep-Alive",
2025-05-21 08:49:49 +03:00
"Content-Length": "2114372",
2025-10-31 15:42:42 +03:00
"Content-Type": "multipart/form-data; boundary=a83b6b8924c04241b06376cce5d15a72",
2025-10-07 19:27:04 +03:00
"Host": "localhost:2424",
"Max-Forwards": "10",
2025-09-12 20:23:31 +03:00
"User-Agent": "1Script v$2.0.0.0",
2025-10-31 15:42:42 +03:00
"X-Arr-Log-Id": "f1739523-46a5-4fd0-bc64-1e68f95be515",
2025-10-07 19:27:04 +03:00
"X-Arr-Ssl": "2048|256|C=BE, O=GlobalSign nv-sa, CN=GlobalSign GCC R6 AlphaSSL CA 2025|CN=*.openintegrations.dev",
"X-Forwarded-Host": "bin.openintegrations.dev",
"X-Original-Url": "/post"
2025-05-21 08:49:49 +03:00
},
"json": null,
"origin": "***",
2025-10-07 19:27:04 +03:00
"url": "https://bin.openintegrations.dev/post"
2025-05-21 08:49:49 +03:00
}
```