| 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 | The content type for this file. | "text/plain" | Optional Added in version 10.3. |
| ContentHeaders | List of headers to include. | "Content-Id: 12345" | Optional Added in version 10.3. |
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) ]
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
- CURL.FormAddKeyContainer
- CURL.FormAddKeyFile
- CURL.FormAddKeyTextContentType
- CURL.FormAddKeyValue
- CURL.FormFinish
- CURL.GetFormData
- CURL.Perform
Release notes
- Version 10.3
- Added ContentType and ContentHeaders parameter for CURL.FormAddKeyContainer, CURL.FormAddKeyFile, CURL.FormAddKeyText and CURL.FormAddKeyValue.
- Version 10.2
- Changed CURL.FormAddKeyText and CURL.FormAddKeyTextContentType to use UTF-8 as default encoding.
Blog Entries
- Translating Insert from URL options for CURL to MBS Plugin calls
- MBS FileMaker Plugin, version 10.3pr1
- MBS FileMaker Plugin, version 10.2pr6
- MBS Filemaker Plugin, version 2.6pr6
This function checks for a license.
Created 18th August 2014, last changed 14th May 2020
CURL.FormAddKeyFileContentType - CURL.FormAddKeyTextContentType
