cURL (Client pour URL) est une bibliothèque de normes ouvertes qui contient des fonctions logicielles permettant à l'Insérer depuis URL action de script de prendre en charge de nombreuses options habituelles pour le transfert de fichier. Dans cette action de script, utilisez Définir les options cURL pour créer un calcul qui intègre une ou plusieurs des options cURL suivantes.
Seules les options répertoriées ci-dessous sont prises en charge par les clients FileMaker. Pour plus d'informations, consultez la documentation de cURL.
Option1 | Paramètre2 | Remarques |
|
|
|
|
|
|
|
|
|
|
| Indiquez un nombre décimal de secondes. |
|
| L'utilisation de « - » pour la taille du fichier actif n'est pas autorisée. Les données remplacent les cibles binaires et ne s'y ajoutent pas. |
|
| Voir la note 3. |
|
| L'accès direct au fichier et « - » sont remplacés par une variable FileMaker. |
|
|
|
|
| Voir la note 4. |
|
| Voir la note 4. |
|
| Voir la note 4. |
|
|
|
|
| Voir la note 4. |
|
|
|
|
|
|
|
|
|
|
| Voir la note 3. |
|
| Indiquez un nombre décimal de secondes. |
|
|
|
|
| Lorsque l'action de script Insérer depuis URL cible une variable, utilisez cette option pour forcer le stockage des données renvoyées sous forme de données de conteneur. |
|
| Convertit du texte dans les options qui suivent immédiatement cette option, d'un codage de caractère interne à FileMaker au codage spécifié. Utilisez l'un des noms définis pour le paramètre |
|
| Voir la note 4. |
|
|
|
|
|
|
|
|
|
|
| Indiquez l'une de ces méthodes. |
|
|
|
|
| Ajoutez |
|
|
|
|
|
|
|
| Définit également |
|
| Indiquez l'un de ces modes. |
|
|
|
|
|
|
|
| Utilisez cette option une fois pour chaque en-tête que vous spécifiez. |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| Indiquez un nombre entier de secondes. |
|
| Indiquez un entier suivi d'une unité facultative. |
|
|
|
|
| Indiquez un port ou une plage de ports. |
|
|
|
|
|
|
|
|
|
|
| Indiquez un nombre décimal de secondes. |
|
| Par défaut, les messages keepalive sont activés. Utilisez cette option pour les désactiver. |
|
|
|
|
| Le nom du fichier sert uniquement d'attribut pour les données Conteneur. |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| Utilisez cette option une fois pour chaque en-tête que vous spécifiez. |
|
| A la différence de l'outil de ligne de commande curl, si aucun mot de passe n'existe, les clients FileMaker ne le demandent pas à l'utilisateur. |
|
|
|
|
|
|
|
| Utilisez cette option une fois pour chaque commande au serveur FTP. |
|
|
|
|
|
|
|
| Prend en charge |
|
|
|
|
| Utilisez cette option une fois pour chaque critère resolve que vous spécifiez. |
|
| Consultez la section Gestion des erreurs. |
|
|
|
|
|
|
|
|
|
|
|
|
|
| Indiquez un nombre entier d'octets par seconde. |
|
| Indiquez un nombre entier de secondes. |
|
|
|
|
|
|
|
| N'accepte que l'écriture d'une expression de date de style cURL. |
|
|
|
|
| Voir la note 3. |
|
| Voir la note 3. |
|
|
|
|
| Voir la note 3. Ne prend pas en charge l'indication de noms de fichier qui suivent un modèle. Pour FTP et FTPS, le nom du fichier après l’upload sur le serveur sera identique à celui spécifié à la fin de l'URL. Pour tous les autres protocoles pris en charge, le nom du fichier est identique à celui spécifié dans les données de conteneur : tout nom de fichier dans l'URL est ignoré. |
|
|
|
|
| A la différence de l'outil de ligne de commande curl, si aucun mot de passe n'existe, les clients FileMaker ne le demandent pas à l'utilisateur. |
|
|
|
1. Pour certaines options, les formes longues et courtes du nom sont prises en charge (par exemple, ‑‑data
et -d
).
2. Les parties facultatives des paramètres se trouvent entre crochets [ ].
3. L'accès direct au fichier est remplacé par une variable FileMaker.
4. L'accès direct au fichier est remplacé par une variable FileMaker précédée du caractère @.
Bien qu'aucune des options prises en charge ne vous permet d'accéder directement aux fichiers ou d'en créer dans le système de fichiers, vous pouvez indiquer une variable FileMaker en tant que source ou destination des données demandées par l'option. Pour accéder à un fichier ou en créer un, vous pouvez définir la variable vers une rubrique Conteneur.
Pour accéder à un fichier, définissez la variable vers une rubrique Conteneur (celle-ci contenant le fichier), puis utilisez cette variable en tant que paramètre de l'option cURL.
Pour créer un fichier, utilisez une variable en tant que paramètre de l'option cURL, définissez une rubrique Conteneur vers cette variable, puis exportez la rubrique Conteneur en tant que fichier.
Les options cURL non prises en charge sont ignorées.
Si vous utilisez l'option --show-error
:
•Quand les erreurs renvoyées par la bibliothèque cURL forcent les clients FileMaker à renvoyer un code d'erreur de 1631 via la Obtenir ( DernièreErreur ) fonction pour indiquer un échec de connexion non spécifié, la Obtenir ( DétailDernièreErreurExterne ) fonction renvoie le même texte que celui renvoyé par l'outil de ligne de commande curl.
•Quand une opération aboutit mais que le serveur renvoie un code réponse de 400 ou plus avec les données, les clients FileMaker renvoient un code d'erreur approprié. Si aucun code d'erreur FileMaker ne semble approprié, Obtenir ( DernièreErreur ) renvoie 1631 et Obtenir ( DétailDernièreErreurExterne ) renvoie le code réponse sous la forme "Response code: nnn."
Si vous n'utilisez pas l'option --show-error
, un code de réponse serveur de 401 force Obtenir ( DernièreErreur ) à renvoyer le code d'erreur FileMaker de 1627 (« échec de l'authentification »). Tous les autres codes de réponse renvoient un code d'erreur FileMaker de 0 (« aucune erreur »).
Envoie des données HTTPS POST sous forme de deux paires clé-valeur, fname=Bob
et lname=Smith
à www.filemaker.com en utilisant les informations d'identification myusername
et mypassword
et stocke les données requises dans la variable $$results.
Dans l'action de script Insérer depuis URL :
•Définissez Cible sur la variable appelée $$results
.
•Définissez URL sur https://www.filemaker.com/
.
•Configurez Définir les options cURL sur l'un des jeux d'options équivalents suivants :
"--user myusername:mypassword --data fname=Bob&lname=Smith"
"--user myusername:mypassword -d fname=Bob --data-ascii lname=Smith"
"--user myusername:mypassword -d @$post_data"
où la variable $post_data
est définie sur des paires clé-valeur en tant que texte ou définie sur une rubrique Conteneur dont le contenu est un fichier texte avec des paires clé-valeur.
Ce script montre l'exemple ci-dessus envoyant des paires clé-valeur depuis un fichier dans la rubrique Conteneur post_data
.
Définir variable [ $post_data ; table::post_data ]
Insérer depuis URL [Vérifier les certificats SSL ; Avec boîte de dialogue: Non ; $$results ;
"https://www.filemaker.com/" ;
"--user myusername:mypassword -d @$post_data" ]
•Dans les options cURL, insérez une barre oblique inversée devant chaque guillemet. Par exemple, pour indiquer un en-tête HTTP pour Content-type: application/json
, l'expression texte pour Définir les options cURL est :
"--header \"Content-type: application/json\""