Components All New MacOS Windows Linux iOS
Examples Mac & Win Server Client Guides Statistic FMM Blog Deprecated Old

CURL.FormAddKeyText

Add a section to a multipart/formdata HTTP POST.

Component Version macOS Windows Linux Server iOS SDK
CURL 2.6 ✅ Yes ✅ Yes ✅ Yes ✅ Yes ✅ Yes
MBS( "CURL.FormAddKeyText"; curl; name; filename; text { ; Encoding; 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"
text The text for the text file. "Hello World"
Encoding The text encoding.
Default is native until version 10.1, UTF-8 from 10.2 on.
Possible encoding names: ANSI, ISO-8859-1, Latin1, Mac, Native, UTF-8, DOS, Hex, Base64 or Windows. More listed in the FAQ.
UTF8 Optional
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 simply text file 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 a text file to form:

MBS("CURL.FormAddKeyText"; $curl; "Attachment"; "test.txt"; "Hello World"; "UTF-8")

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.txt\"/></tns:data></soap:Body> </soap:Envelope>"; "text/xml") ]
Set Variable [ $result ; Value: MBS("CURL.FormAddKeyText"; $curl; "test"; "A text attachment with ID 1234."; "text/plain"; "Content-Id: 1234") ]
Set Variable [ $result ; Value: MBS("CURL.FormFinish"; $curl) ]

See also

Release notes

Blog Entries

This function checks for a license.

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


CURL.FormAddKeyFileContentType - CURL.FormAddKeyTextContentType