Monkeybread Software - MBS FileMaker Plugin: CURL.FormAddKeyFile

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

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.FormAddKeyFile"; curl; name; Path { ; ContentType; ContentHeaders } ) More

Parameters

Parameter Description Example Flags

curl The CURL session handle. $curl

name The name of the form field. "city"

Path Native file path. "/Users/cs/Desktop/test.txt"

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

Parameter	Description	Example	Flags
curl	The CURL session handle.	$curl
name	The name of the form field.	"city"
Path	Native file path.	"/Users/cs/Desktop/test.txt"
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 a file with the given key name into the form.
Please call CURL.FormFinish after you added all your fields and before you call CURL.Perform.

This function requires a native path. Use Path.FileMakerPathToNativePath to convert a FileMaker path to a native path if required. If you like to have the user choose the path, you can use FileDialog functions.
For Server be aware that server has limited permissions and may not be able to access all files on a computer.

Examples

Add image file to form:

MBS("CURL.FormAddKeyFile"; $curl; "Attachment"; "/Users/cs/desktop/Paris.jpg")

Blog Entries

Release notes

Version 10.3
- Added ContentType and ContentHeaders parameter for CURL.FormAddKeyContainer, CURL.FormAddKeyFile, CURL.FormAddKeyText and CURL.FormAddKeyValue.

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

CURL.FormAddKeyContainerContentType - CURL.FormAddKeyFileContentType

Feedback: Report problem or ask question.