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: 11.1   11.2   11.3   11.4   11.5   12.0   12.1   12.2   12.3   12.4    Statistic    FMM    Blog  

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

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


CURL.FormAddKeyFileContentType - CURL.FormAddKeyTextContentType

Feedback: Report problem or ask question.


Start Chat