Monkeybread Software - MBS FileMaker Plugin: CURL.FormAddKeyContainer

Topics All MacOS (Only) Windows (Only) Linux (Only, Not) iOS (Only, Not)
Components Crossplatform Mac & Win Server Client Old Deprecated Guides Examples Videos
New in version: 9.3 9.4 9.5 10.0 10.1 10.2 10.3 10.4 10.5 10.6 Statistic FMM Blog

CURL.FormAddKeyContainer

Add a section to a multipart/formdata HTTP POST.

Component	Version	macOS	Windows	Linux	Server	FileMaker iOS SDK
CURL	2.6	Yes	Yes	Yes	Yes	Yes

MBS( "CURL.FormAddKeyContainer"; curl; name; filename; container { ; ContentType; ContentHeaders } ) More

Parameters

Parameter Description Example Flags

curl The CURL session handle. $curl

name The name of the form field. "city"

filename The file name for this file. "test.txt"

container The file content as a container value. Can be PDF, PNG, GIF, BMP, JPEG or other file content.

ContentType Available in MBS FileMaker Plugin 10.3 or newer.
The content type for this file. "text/plain" Optional

ContentHeaders Available in MBS FileMaker Plugin 10.3 or newer.
List of headers to include. "Content-Id: 12345" Optional

Parameter	Description	Example	Flags
curl	The CURL session handle.	$curl
name	The name of the form field.	"city"
filename	The file name for this file.	"test.txt"
container	The file content as a container value. Can be PDF, PNG, GIF, BMP, JPEG or other file content.
ContentType	Available in MBS FileMaker Plugin 10.3 or newer. The content type for this file.	"text/plain"	Optional
ContentHeaders	Available in MBS FileMaker Plugin 10.3 or newer. List of headers to include.	"Content-Id: 12345"	Optional

Result

Returns "OK" or error code.

Description

Add a section to a multipart/formdata HTTP POST.
This adds file form field with a given name and value.

Please call CURL.FormFinish after you added all your fields and before you call CURL.Perform.

Examples

Add file from container:

MBS("CURL.FormAddKeyContainer"; $curl; "Attachment"; "paris.jpg"; Test::test)

Add SOAP request with MTOM attachment:

Set Variable [ $result ; Value: MBS("CURL.FormAddKeyText"; $curl; "request"; "<soap:Envelope><soap:Body><tns:data><xop:include href=\"test.png\"/></tns:data></soap:Body> </soap:Envelope>"; "text/xml") ]
Set Variable [ $result ; Value: MBS("CURL.FormAddKeyContainer"; $curl; "test"; "image.png"; Table::ContainerField; "image/png"; "Content-Id: 1234") ]
Set Variable [ $result ; Value: MBS("CURL.FormFinish"; $curl) ]

Blog Entries

Release notes

Version 10.3
- Added ContentType and ContentHeaders parameter for CURL.FormAddKeyContainer, CURL.FormAddKeyFile, CURL.FormAddKeyText and CURL.FormAddKeyValue.

Created 18th August 2014, last changed 14th May 2020

CURL.FileInfos - CURL.FormAddKeyContainerContentType

Feedback: Report problem or ask question.