Unterstützte cURL-Optionen
cURL (Client für URLs) ist eine Open-Standard-Bibliothek mit Software-Funktionen, die den Aus URL einfügen Scriptschritt aktivieren, um viele übliche Optionen der Dateiübertragung zu unterstützen. Erstellen Sie in diesem Scriptschritt mithilfe von cURL-Optionen angeben eine Formel, die eine oder mehrere der folgenden cURL-Optionen enthält.
Nur die nachfolgend aufgeführten Optionen werden durch FileMaker-Clients unterstützt. Weitere Informationen finden Sie in der cURL-Dokumentation.
 
Option1
Parameter2
Hinweise
--anyauth
 
 
--basic
 
 
--ciphers
<Liste von Ciphers>
 
--connect-timeout
<Sekunden>
Geben Sie eine Dezimalzahl für Sekunden an.
--continue-at
-C
<Versatz>
Die Verwendung von „-“ für die aktuelle Dateigröße wird nicht unterstützt. Daten ersetzen binäre Ziele, sie werden nicht angehängt.
--cookie
-b
<Name=Daten[;n2=d2]> oder <$[$]fmvariable>
Siehe Tabellenhinweis 3.
--cookie-jar
-c
<$[$]fmvariable>
Direkter Dateizugriff und „-“ werden durch eine FileMaker-Variable ersetzt.
--crlf
 
 
--data
-d
<Daten> oder @<$[$]fmvariable>
Siehe Tabellenhinweis 4.
--data-ascii
<Daten[;n2=d2]> oder @<$[$]fmvariable>
Siehe Tabellenhinweis 4.
--data-binary
<Daten[;n2=d2]> oder @<$[$]fmvariable>
Siehe Tabellenhinweis 4.
--data-raw
<Daten>
 
--data-urlencode
<Daten> oder =<daten> oder @<$[$]fmvariable> oder <Name>=<Daten> oder <Name>@<$[$]fmvariable>
Siehe Tabellenhinweis 4.
--digest
 
 
--disable-eprt
 
 
--disable-epsv
 
 
--dump-header
-D
<$[$]fmvariable>
Siehe Tabellenhinweis 3.
--expect100-timeout
<Sekunden>
Geben Sie eine Dezimalzahl für Sekunden an.
--fail
-f
 
 
--FM-text-encoding
<Kodierung>
Konvertiert Text in den Optionen, die unmittelbar auf diese Option folgen, von FileMaker-interner Zeichenkodierung in die angegebene Kodierung. Verwenden Sie einen der Namen, die für den Parameter Kodierung der TextEncode Funktion definiert sind.
--form
-F
<Name=Inhalt> oder <Name=@$[$]fmvariable>
Siehe Tabellenhinweis 4.
--form-string
<Name=Inhalt>
 
--ftp-alternative-to-user
<Befehl>
 
--ftp-create-dirs
 
 
--ftp-method
multicwd, nocwd oder singlecwd
Geben Sie eine dieser Methoden an.
--ftp-pasv
 
 
--ftp-port
-P
<Schnittstelle> oder <IP-Adresse> oder <Hostname> oder -
Fügen Sie :[Start]-[Ende] an, um einen Bereich von Ports anzugeben.
--ftp-pret
 
 
--ftp-skip-pasv-ip
 
 
--ftp-ssl-ccc
 
Stellt auch --ftp-ssl-ccc-mode auf passive ein, falls noch nicht geschehen.
--ftp-ssl-ccc-mode
active oder passive
Geben Sie einen dieser Modi an.
--ftp-ssl-control
 
 
--head
-I
 
 
--header
-H
<Name: Wert>
Verwenden Sie diese Option für jeden Header, den Sie angeben.
--ignore-content-length
 
 
--interface
<Name>
 
--ipv4
-4
 
 
--ipv6
-6
 
 
--junk-session-cookies
-j
 
 
--keepalive-time
<Sekunden>
Geben Sie eine Ganzzahl für Sekunden an.
--limit-rate
<Geschwindigkeit[b|B|k|K|m|M|g|G]>
Geben Sie eine Ganzzahl gefolgt von einer optionalen Einheit ein.
--list-only
-l
 
 
--local-port
<num>[-num]
Geben Sie einen Port oder einen Bereich von Ports an.
--location
-L
 
 
--location-trusted
 
 
--max-filesize
<Bytes>
 
--max-time
-m
<Sekunden>
Geben Sie eine Dezimalzahl für Sekunden an.
--no-keepalive
 
Standardmäßig sind keepalive-Meldungen aktiviert. Verwenden Sie diese Option, um sie zu deaktivieren.
--noproxy
<Host[,Host]> oder *
 
--output
-o
<Dateiname>
Der Dateiname wird nur als Attribut von Containerdaten verwendet.
--path-as-is
 
 
--post301
 
 
--post302
 
 
--post303
 
 
--proxy
-x
<[Protokoll://][Benutzer:Passwort@]Proxyhost[:Port]>
 
--proxy-anyauth
 
 
--proxy-basic
 
 
--proxy-digest
 
 
--proxy-header
<Name: Wert>
Verwenden Sie diese Option für jeden Header, den Sie angeben.
--proxy-user
-U
<Benutzer:Passwort>
Wenn das Passwort nicht existiert, fordern FileMaker-Clients im Gegensatz zum curl-Befehlszeilenprogramm den Benutzer nicht zur Passworteingabe auf.
--proxy1.0
<Proxyhost[:Port]>
 
--proxytunnel
-p
 
 
--quote
-Q
<Befehl>
Verwenden Sie diese Option einmal für jeden Befehl an den FTP-Server.
--range
-r
<Bereich>
 
--raw
 
 
--referer
-e
<URL>
Unterstützt ;auto am Ende des URL, wenn mit --location verwendet.
--request
-X
<Befehl>
 
--resolve
<Host:Port:Adresse>
Verwenden Sie diese Option für jeden Resolver, den Sie angeben.
--show-error
-S
 
Weitere Informationen finden Sie unter Fehlerbehandlung.
--socks4
<Host[:Port]>
 
--socks4a
<Host[:Port]>
 
--socks5
<Host[:Port]>
 
--socks5-hostname
<Host[:Port]>
 
--speed-limit
-Y
<Geschwindigkeit>
Geben Sie eine Ganzzahl an Bytes pro Sekunde an.
--speed-time
-y
<Zeit>
Geben Sie eine Ganzzahl für Sekunden an.
--ssl
 
--ftp-ssl wird ebenfalls unterstützt.
--ssl-reqd
 
--ftp-ssl-reqd wird ebenfalls unterstützt.
--time-cond
-z
<Datumsausdruck>
Unterstützt nur die Angabe eines Datumsausdrucks im cURL-Stil.
--tr-encoding
 
 
--trace
<$[$]fmvariable>
Siehe Tabellenhinweis 3.
--trace-ascii
<$[$]fmvariable>
Siehe Tabellenhinweis 3.
--trace-time
 
 
--upload-file
-T
<$[$]fmvariable>
Siehe Tabellenhinweis 3. Unterstützt kein Globbing (Angabe von Dateinamen, die einem Muster entsprechen) oder die Angabe eines Dateinamens im URL.
--use-ascii
-B
 
 
--user
-u
<Benutzer:Passwort>
Wenn das Passwort nicht existiert, fordern FileMaker-Clients im Gegensatz zum curl-Befehlszeilenprogramm den Benutzer nicht zur Passworteingabe auf.
--user-agent
A
<Agent-Zeichenfolge>
 
Tabellenhinweise
1. Für einige Optionen werden Lang- und Kurzform des Optionsnamens unterstützt (z. B. ‑‑data und -d).
2. Optionale Teile von Parametern befinden sich in eckigen Klammern [ ].
3. Direkter Dateizugriff wird durch eine FileMaker-Variable ersetzt.
4. Direkter Dateizugriff wird durch eine FileMaker-Variable mit dem vorangestellten @ ersetzt.
Verwenden von Variablen
Obwohl Ihnen die unterstützten Optionen direkten Zugriff auf Dateien oder das Erstellen von Dateien im Dateisystem erlauben, können Sie eine FileMaker-Variable als Quelle oder Ziel der Daten angeben, die die Option verlangt. Um auf eine Datei zuzugreifen bzw. eine Datei zu erstellen, können Sie die Variable auf ein Containerfeld setzen.
Um auf eine Datei zuzugreifen, können Sie die Variable auf ein Containerfeld setzen, das die Datei enthält, und dann diese Variable als Parameter der cURL-Option verwenden.
Um eine Datei zu erstellen, können Sie eine Variable als Parameter der cURL-Option verwenden, ein Containerfeld auf diese Variable setzen und dann das Containerfeld als Datei exportieren.
Fehlerbehandlung
Nicht unterstützte cURL-Optionen werden ignoriert.
Bei Verwendung der Option --show-error:
Wenn von der cURL-Bibliothek zurückgegebene Fehler verursachen, dass FileMaker-Clients den Fehlercode 1631 über die Hole ( LetzteFehlerNr ) Funktion zurückgeben, um einen unspezifizierten Verbindungsfehler zu melden, gibt die Hole ( LetzteExterneFehlerNrDetail ) Funktion denselben Text wie das Befehlszeilenprogramm curl zurück.
Wenn ein Vorgang erfolgreich ist, der Server aber Antwortcode 400 oder höher mit den Daten liefert, geben FileMaker-Clients einen entsprechenden Fehlercode zurück. Ist kein entsprechender FileMaker-Fehlercode vorhanden, gibt „Hole (LetzteFehlerNr)“ 1631 zurück und „Hole (LetzteExterneFehlerNrDetail)“ den Antwortcode in der Form „Antwortcode: nnn“.
Wenn Sie die Option --show-error nicht verwenden, veranlasst der Server-Antwortcode von 401, dass „Hole (LetzteFehlerNr)“ den FileMaker-Fehlercode 1627 („Authentifizierung fehlgeschlagen“) zurückgibt. Alle anderen Antwortcodes geben FileMaker-Fehlercode 0 („Kein Fehler“) zurück.
Beispiel:
Sendet HTTPS POST-Daten als zwei Schlüssel-Wert-Paare, vname=Robert und nname=Schmidt an www.filemaker.com mit den Anmeldedaten meinBenutzername und meinPasswort und speichert die verlangten Daten in der Variablen $$Ergebnis.
Im Scriptschritt „Aus URL einfügen“:
Stellen Sie Ziel auf die Variable $$Ergebnis ein.
Stellen Sie URL angeben auf https://www.filemaker.com/ ein.
Stellen Sie cURL-Optionen angeben auf eines der folgenden entsprechenden Optionensets ein:
"--user meinBenutzername:meinPasswort --data vname=Robert&nname=Schmidt"
"--user meinBenutzername:meinPasswort -d vname=Robert --data-ascii nname=Schmidt"
"--user meinBenutzername:meinPasswort -d @$post_daten"
Dabei ist die Variable $post_daten entweder auf Schlüssel-Wert-Paare als Text eingestellt oder auf ein Containerfeld, dessen Inhalt eine Textdatei ist, die Schlüssel-Wert-Paare enthält.
Das Script zeigt das obige Beispiel, das Schlüssel-Wert-Paare aus einer Datei im Containerfeld post_daten sendet.
Variable setzen [ $post_daten ; Tabelle::post_daten ]
Aus URL einfügen [SSL-Zertifikate verifizieren; Auswahl; Mit Dialog: Aus ; $$Ergebnis ;
"https://www.filemaker.com/" ;
"--user meinBenutzername:meinPasswort -d @$post_daten" ]
Hinweise 
Stellen Sie in cURL-Optionen jedem Anführungszeichen einen umgekehrten Schrägstrich voran. Um beispielsweise einen HTTP-Header für Inhaltstyp: application/json anzugeben, lautet der Textausdruck für cURL-Optionen angeben:
"--header \"Inhaltstyp: application/json\""