Topics   All   MacOS (Only)   Windows (Only)   Linux (Only, Not)   iOS (Only, Not)  
Components   Crossplatform Mac & Win   Server   Client   Old   Guides   Examples
New in version: 9.0   9.1   9.2   9.3   9.4   9.5   10.0   10.1   10.2   10.3    Statistic  

CURL.FormAddKeyText

Add a section to a multipart/formdata HTTP POST.

Component Version macOS Windows Server FileMaker Cloud FileMaker 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 value
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 Optional
The text encoding.
Default is native until version 10.1, UTF-8 from 10.2 on.
Possible encoding names: ANSI, Arabic-Mac, Arabic-Win, Baltic-Win, CentralEurope-Mac, ChineseSimp-Mac, ChineseSimp-Win, ChineseTrad-Mac, ChineseTrad-Win, Cyrillic-Mac, Cyrillic-Win, EasternEurope-Win, Greek-Mac, Greek-Win, Hebrew-Mac, Hebrew-Win, ISO-8859-1, ISO-8859-2, ISO-8859-3, ISO-8859-4, ISO-8859-5, ISO-8859-6, ISO-8859-7, ISO-8859-8, ISO-8859-9, ISO-8859-15, Korean-Johab, Korean-Mac, Korean-Win, Latin1, Mac, Native, ShiftJIS-Mac, ShiftJIS-Win, Turkish-Mac, Turkish-Win, UTF-8, DOS or Windows. Pass native to use the native encoding of the current platform.
UTF8
ContentType Optional
Available in MBS FileMaker Plugin 10.3 or newer.
The content type for this file.
"text/plain"
ContentHeaders Optional
Available in MBS FileMaker Plugin 10.3 or newer.
List of headers to include.
"Content-Id: 12345"

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

Blog Entries

Release notes

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


CURL.FormAddKeyFileContentType   -   CURL.FormAddKeyTextContentType

Feedback: Report problem or ask question.




Links
MBS Xojo PDF Plugins