Opções cURL suportadas
cURL (Client for URLs) é uma biblioteca de padrão aberto de funções de software que habilita a Inserir do URL etapa de script para oferecer suporte a muitas opções comuns de transferência de arquivo. Na etapa de script, use Especificar opções cURL para criar um cálculo que inclui uma ou mais das opções cURL a seguir.
Somente as opções listadas abaixo são suportadas pelos clientes do FileMaker. Para obter mais informações, consulte a documentação do cURL.
 
Opção1
Parâmetro2
Notas
--anyauth
 
 
--basic
 
 
--ciphers
<lista de códigos>
 
--connect-timeout
<segundos>
Especifique um número decimal de segundos.
--continue-at
-C
<desvio>
O uso de "-" para tamanho de arquivo atual não é suportado. Os dados substituem, não anexam, destinos binários.
--cookie
-b
<nome=dados[;n2=d2]> ou <$[$]fmvariable>
Consulte a nota de tabela 3.
--cookie-jar
-c
<$[$]fmvariable>
O acesso direto ao arquivo e "-" são substituídos por uma variável do FileMaker.
--crlf
 
 
--data
-d
<dados> ou @<$[$]fmvariable>
Consulte a nota de tabela 4.
--data-ascii
<dados> ou @<$[$]fmvariable>
Consulte a nota de tabela 4.
--data-binary
<dados> ou @<$[$]fmvariable>
Consulte a nota de tabela 4.
--data-raw
<data>
 
--data-urlencode
<dados> ou =<dados> ou @<$[$]fmvariable> ou <nome>=<dados> ou <nome>@<$[$]fmvariable>
Consulte a nota de tabela 4.
--digest
 
 
--disable-eprt
 
 
--disable-epsv
 
 
--dump-header
-D
<$[$]fmvariable>
Consulte a nota de tabela 3.
--expect100-timeout
<segundos>
Especifique um número decimal de segundos.
--fail
-f
 
 
--FM-text-encoding
<codificação>
Converte texto em opções que seguem imediatamente essa opção da codificação interna de caracteres do FileMaker para a codificação especificada. Use um dos nomes definidos para o parâmetro de codificação da TextEncode função.
--form
-F
<nome=conteúdo> ou <nome=@$[$]fmvariable>
Consulte a nota de tabela 4.
--form-string
<nome=conteúdo>
 
--ftp-alternative-to-user
<comando>
 
--ftp-create-dirs
 
 
--ftp-method
multicwd, nocwd ou singlecwd
Especifique um destes métodos.
--ftp-pasv
 
 
--ftp-port
-P
<interface> ou <endereço IP> ou <nome do host> ou -
Acrescente :[start]-[end] para especificar um intervalo de portas.
--ftp-pret
 
 
--ftp-skip-pasv-ip
 
 
--ftp-ssl-ccc
 
Configure também --ftp-ssl-ccc-mode como passive, caso ainda não esteja configurado.
--ftp-ssl-ccc-mode
active ou passive
Especifique um destes modos.
--ftp-ssl-control
 
 
--head
-I
 
 
--header
-H
<nome: valor>
Use essa opção uma vez para cada cabeçalho que você especificar.
--ignore-content-length
 
 
--interface
<nome>
 
--ipv4
-4
 
 
--ipv6
-6
 
 
--junk-session-cookies
-j
 
 
--keepalive-time
<segundos>
Especifique um número inteiro de segundos.
--limit-rate
<velocidade[b|B|k|K|m|M|g|G]>
Especifique um número inteiro seguido por uma unidade opcional.
--list-only
-l
 
 
--local-port
<núm>[-num]
Especifique uma porta ou um intervalo de portas.
--location
-L
 
 
--location-trusted
 
 
--max-filesize
<bytes>
 
--max-time
-m
<segundos>
Especifique um número decimal de segundos.
--no-keepalive
 
Por padrão, as mensagens de aviso de tempo limite estão ativadas. Use essa opção para desativá-las.
--noproxy
<host[,host]> ou *
 
--output
-o
<nome do arquivo>
O nome do arquivo é usado somente como um atributo de dados do container.
--path-as-is
 
 
--post301
 
 
--post302
 
 
--post303
 
 
--proxy
-x
<[protocolo://][usuário:senha@]hostDo Proxy[:porta]>
 
--proxy-anyauth
 
 
--proxy-basic
 
 
--proxy-digest
 
 
--proxy-header
<nome: valor>
Use essa opção uma vez para cada cabeçalho que você especificar.
--proxy-user
-U
<usuário:senha>
Diferente da ferramenta de linha de comando do curl, se a senha não existir, os clientes do FileMaker não solicitarão a senha ao usuário.
--proxy1.0
<hostDoProxy[:porta]>
 
--proxytunnel
-p
 
 
--quote
-Q
<comando>
Use essa opção uma vez para cada comando ao servidor de FTP.
--range
-r
<intervalo>
 
--raw
 
 
--referer
-e
<URL>
Aceita ;auto no final do URL quando usado com --location.
--request
-X
<comando>
 
--resolve
<host:porta:endereço>
Use essa opção uma vez para cada resolvedor que você especificar.
--show-error
-S
 
--socks4
<host[:porta]>
 
--socks4a
<host[:porta]>
 
--socks5
<host[:porta]>
 
--socks5-hostname
<host[:porta]>
 
--speed-limit
-Y
<velocidade>
Especifique um número inteiro de bytes por segundo.
--speed-time
-y
<tempo>
Especifique um número inteiro de segundos.
--ssl
 
--ftp-ssl também é suportado.
--ssl-reqd
 
--ftp-ssl-reqd também é suportado.
--time-cond
-z
<expressão de data>
Aceita somente a especificação de expressão de data no estilo cURL.
--tr-encoding
 
 
--trace
<$[$]fmvariable>
Consulte a nota de tabela 3.
--trace-ascii
<$[$]fmvariable>
Consulte a nota de tabela 3.
--trace-time
 
 
--upload-file
-T
<$[$]fmvariable>
Consulte a nota de tabela 3. Não aceita mascaramento de nome de arquivo (especificação de nomes de arquivo que seguem um padrão) ou especificação de um nome de arquivo no URL.
--use-ascii
-B
 
 
--user
-u
<usuário:senha>
Diferente da ferramenta de linha de comando do curl, se a senha não existir, os clientes do FileMaker não solicitarão a senha ao usuário.
--user-agent
-A
<string do agente>
 
Notas da tabela
1. Algumas opções aceitam formatos longos e curtos do nome da opção (por exemplo, ‑‑data e -d).
2. As partes opcionais dos parâmetros estão entre colchetes [ ].
3. O acesso direto ao arquivo é substituído por uma variável do FileMaker.
4. O acesso direto ao arquivo é substituído por uma variável do FileMaker com o prefixo @.
Utilização de variáveis
Apesar de nenhuma opção suportada permitir que você acesse ou crie arquivos diretamente no sistema de arquivos, você pode especificar uma variável do FileMaker como a fonte ou o destino dos dados que a opção exige. Para acessar ou criar um arquivo, você pode definir a variável como um campo de container.
Para acessar um arquivo, você pode definir a variável como um campo de container, que contém o arquivo, e usar essa variável como o parâmetro da opção cURL.
Para criar um arquivo, você pode usar uma variável como o parâmetro da opção cURL, definir um campo de container como essa variável e exportar o campo de container como um arquivo.
Como lidar com erros
As opções cURL não suportadas são ignoradas.
Se você usar a opção --show-error:
Quando os erros retornados pela biblioteca de cURL fazem com que os clientes do FileMaker retornem o código de erro 1631 por meio da Get ( LastError ) função para indicar uma falha de conexão não especificada, a Get ( LastExternalErrorDetail ) função retorna o mesmo erro retornado pela ferramenta de linha de comando do cURL.
Quando uma operação é bem-sucedida, mas o servidor retorna um código de resposta 400 ou superior com os dados, os clientes do FileMaker retornam um código de erro adequado. Se não houver um código de erro adequado do FileMaker, Get (LastError) retornará 1631 e Get (LastExternalErrorDetail) retornará o código de resposta na forma "Código de resposta: nnn".
Se você não usar a opção --show-error, o código de resposta do servidor 401 fará com que o Get (LastError) retorne o código de erro 1627 do FileMaker ("Falha na autenticação"). Todos os outros códigos de resposta retornam o código de erro 0 do FileMaker ("Sem erro").
Exemplo
Envia dados HTTPS POST como dois pares de chave-valor, fname=Bob e lname=Smith para www.filemaker.com usando as credenciais meunomedeusuário e minhasenha e armazena os dados solicitados na variável $$results.
Na etapa de script Inserir do URL:
Configure Destino como a variável chamada $$results.
Configure Especificar URL como https://www.filemaker.com/.
Configure Especificar opções cURL como um dos conjuntos de opções equivalentes a seguir:
"--user meunomedeusuário:minhasenha --data fname=Bob&lname=Smith"
"--user meunomedeusuário:minhasenha -d fname=Bob --data-ascii lname=Smith"
"--user meunomedeusuário:minhasenha -d @$post_data"
no qual a variável $post_data é configurada como pares de chave-valor como texto ou configurada como um campo de container cujo conteúdo é um arquivo de texto que contém pares de chave-valor.
Este script mostra o exemplo acima enviando pares de chave-valor de um arquivo no campo de container post_data.
Definir variável [ $post_data ; table::post_data ]
Inserir do URL [Verificar certificados SSL; Com diálogo: Desativado ; $$results ;
"https://www.filemaker.com/" ;
"--user meunomedeusuário:minhasenha -d @$post_data" ]
Notas 
Nas opções do cURL, coloque um caractere de barra invertida antes das aspas. Por exemplo, para especificar um cabeçalho HTTP para Content-type: application/json, a expressão do texto de Especificar opções cURL é:
"--header \"Content-type: application/json\""