Opções cURL suportadas

cURL (Client for URLs) é uma biblioteca de padrão aberto de funções de software que habilita a Etapa de script Inserir do URL 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.

Nota  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\""

Somente as opções listadas abaixo são suportadas pelos clientes do FileMaker. Para obter mais informações, consulte a documentação do cURL.

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 Função Get(LastError) para indicar uma falha de conexão não especificada, a Função Get(LastErrorDetail) 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(LastErrorDetail) 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 exemplo.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.

• Defina Especificar URL como https://exemplo.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"

  quando a variável $post_data estiver definida como pares de valores-chave como texto ou definida como um campo de container cujo conteúdo é um arquivo de texto contendo pares de valores-chave.

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 [ Com diálogo: Off ; Destino: $$results ; 
"https://exemplo.com/" ; Verificar certificados SSL ; 
opções cURL: "--user meunomedeusuário:minhasenha -d @$post_data" ]