Add Multipart file

Adds a file block to the multipart/form-data body

Parameters
Advanced call ?

Function AddMultipartFormDataFile(Val FieldName, Val FileName, Val Data, Val DataType = "", Val IgnoreEmpty = False) 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
IgnoreEmpty	-	Boolean	✖	Do not add file if empty data is passed

Returns

DataProcessorObject.OPI_HTTPClient - This processor object

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

1C:Enterprise/OneScript code example
    URL = "https://bin.openintegrations.dev";
    URL = URL + "/post";

    Image = "https://hut.openintegrations.dev/test_data/picture.jpg"; // URL, Path or Binary data

    Result = OPI_HTTPRequests.NewRequest()
        .Initialize(URL)
        .StartMultipartBody()
        .AddMultipartFormDataFile("file1", "pic.png", Image, "image/png") // <---
        .AddMultipartFormDataField("Field1", "Text")
        .AddMultipartFormDataField("Field2", "10")
        .ProcessRequest("POST")
        .ReturnResponseAsJSONObject();

Result
{
 "args": {},
 "data": "",
 "files": {
  "file1": "..."
 },
 "form": {
  "Field1": "Text",
  "Field2": "10"
 },
 "headers": {
  "Accept": "*/*",
  "Accept-Charset": "utf-8",
  "Accept-Encoding": "gzip",
  "Connection": "Keep-Alive",
  "Content-Length": "2114372",
  "Content-Type": "multipart/form-data; boundary=ca6114fb699942668971e0f3c262ccb5",
  "Host": "bin.openintegrations.dev",
  "Max-Forwards": "10",
  "User-Agent": "1Script v$2.0.1.0",
  "X-Arr-Log-Id": "44a6ab4c-32f9-4223-b80e-9d9c4e9058d7",
  "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": "***"
 },
 "json": null,
 "origin": "***",
 "url": "https://bin.openintegrations.dev/post"
}