Monkeybread Software - MBS FileMaker Plugin: CURL.FormAddKeyTextContentType

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.FormAddKeyTextContentType

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.FormAddKeyTextContentType"; 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

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"
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
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 text 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.
Starting with version 10.3, this is the same function as CURL.FormAddKeyText.

Examples

Add text file:

MBS("CURL.FormAddKeyTextContentType"; $curl; "Attachment"; "test.txt"; "Hello World"; "UTF-8"; "text/plain")

Add PDF container:

Set Variable [ $r; Value: MBS( "CURL.FormAddKeyContainerContentType"; $curl; "file"; "document.pdf"; Test::MyContainer; "application/pdf") ]
Set Variable [ $r; Value: MBS( "CURL.FormFinish"; Handle ) ]

Example Databases

CURL/CURL Send Form

Blog Entries

Release notes

Version 10.2
- Changed CURL.FormAddKeyText and CURL.FormAddKeyTextContentType to use UTF-8 as default encoding.

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

CURL.FormAddKeyText - CURL.FormAddKeyValue

Feedback: Report problem or ask question.