Insérer depuis URL

Entre le contenu à partir d'une URL dans une rubrique ou une variable.

Options 

• Sélectionner tout le contenu remplace l'intégralité du contenu d'une rubrique ou d'une variable. Si vous ne sélectionnez pas cette option :

  • Dans le cas d'une rubrique, cette action remplace uniquement la partie sélectionnée de la rubrique active ou insère des données au point d'insertion. Par défaut, le point d'insertion se situe à la fin des données de la rubrique.

  • Dans le cas d'une variable qui ne contient aucune donnée de type Conteneur, cette action insère des données à la fin de la valeur actuelle de la variable. Dans le cas d'une variable qui contient des données de type Conteneur, cette action remplace son contenu.

• Avec boîte de dialogue indique si afficher la boîte de dialogue Options "Insérer depuis URL" au moment de l'exécution de l'action de script.

• Cible indique la rubrique ou la variable dans laquelle insérer le contenu URL. Si la variable n'existe pas, cette action de script en crée une (consultez la section Utilisation de variables).

• URL vous permet de saisir l'URL ou de créer votre URL à partir d'un calcul.

• Encoder automatiquement l'URL remplace les caractères spéciaux par les valeurs codées correspondantes requises pour les URL. Par exemple, un espace est remplacé par %20. Lorsque cette option est désélectionnée, l'URL reste telle qu'elle a été saisie. Les options cURL ne sont pas codées.

• Vérifier les certificats SSL permet de vérifier le certificat SSL du serveur indiqué dans l'URL. S'il est impossible de vérifier le certificat, les utilisateurs peuvent néanmoins choisir de se connecter ou d'annuler pour ignorer cette action de script. S'il est impossible de vérifier le certificat et que l'action de script Gestion erreurs est définie sur Oui, l'action Insérer depuis URL se comporte comme si le serveur était indisponible.

• Définir les options cURL vous permet de saisir une ou plusieurs options cURL prises en charge en tant que calcul. Consultez la section Options cURL prises en charge.

Provient de la version 

12.0

Description 

Cette action de script télécharge la ressource spécifiée par l'URL dans une variable ou une rubrique. Les protocoles suivants sont pris en charge :

• http, https

• ftp, ftps, sftp

• file

• smb

• smtp, smtps

• ldap, ldaps

Reportez-vous aux remarques pour consulter les exceptions. Les autres protocoles ne sont pas pris en charge et renvoient une erreur.

Vous devez définir une variable cible, définir une rubrique cible dans le modèle actif, cliquer dans une rubrique ou utiliser l'action de script Activer rubrique avant d'exécuter cette action de script. Si aucune valeur Cible n'est indiquée, les données sont placées dans la rubrique active. Dans le cas contraire, cette action de script renvoie un code d'erreur qu'il est possible de saisir avec la fonction Obtenir ( DernièreErreur ).

Pour une liste des formats image et audio/vidéo pris en charge dans les rubriques de type Conteneur, consultez la section Utilisation de données dans les rubriques Conteneur.

Important  Pour de meilleures performances dans FileMaker WebDirect, assurez-vous que l'option Sélectionner tout le contenu est sélectionnée lorsque la cible est une rubrique.

Remarques 

• En tant que plateforme d'intégration cloud, Claris Connect facilite la connexion de votre app personnalisée FileMaker aux services et apps Web. Consultez la section Claris Connect.

• L'action de script Insérer depuis URL prend en charge le format UTF-8 uniquement pour URL. Toutefois, pour Définir les options cURL, vous pouvez contrôler le codage des paramètres dans les options cURL. Consultez la section Options cURL prises en charge.

• Lorsque la valeur Cible est une variable, les données sont normalement stockées sous forme de texte. Pour les stocker sous forme de données de conteneur, spécifiez l'option cURL décrite dans la section Options cURL prises en charge.

• Pour déterminer le délai pendant lequel l'action de script attend une réponse du serveur, indiquez une valeur dans l'option cURL --max-time.

• Dans FileMaker WebDirect :

  • Si l'option Avec boîte de dialogue est définie sur Oui, cette action de script s'exécute comme si l'option Encoder automatiquement l'URL était sélectionnée.

  • Si l'option Sélectionner tout le contenu est désélectionnée et que l'action de script Insérer depuis URL insère du contenu dans une rubrique Texte, le contenu de l'URL est ajouté à la rubrique Texte. Des extractions multiples peuvent entraîner des résultats imprévisibles et des performances ralenties.

• Le protocole file :

  • n'est pas pris en charge dans FileMaker WebDirect, FileMaker Data API et la Publication Web personnalisée ;

  • peut être utilisé dans des scripts côté serveur, uniquement pour faire référence à des fichiers du dossier Documents ou du dossier temporaire (consultez la section Chemins d'accès dans les scripts côté serveur).

• Les chemins d'accès renvoyés par les fonctions Obtenir, telles que Obtenir ( CheminDocuments ) et Obtenir ( CheminTemporaire ), sont au format FileMaker et doivent être convertis au format URL standard avant de pouvoir être utilisées avec le protocole file dans URL. (Consultez la fonction ConvertFromFileMakerPath.) Un moyen plus simple d'accéder aux fichiers locaux est d'exécuter l'action de script Lire depuis le fichier de données, qui utilise ces chemins sans conversion.

• FileMaker Go ne prend pas en charge les protocoles ldap et ldaps.

• Si la réponse du serveur ne contient aucun contenu, la fonction Obtenir ( DernièreErreur ) peut renvoyer 10 (« Données requises manquantes ») après l'exécution de cette action de script. Il se peut que cette valeur de retour ne signifie pas qu'une erreur s'est produite si la réponse attendue est la réception d'aucun contenu.

Exemple 1 

Accède à un site Web et insère un fichier PDF dans une rubrique conteneur Rapport des ventes.

Insérer depuis URL [ Avec boîte de dialogue: Non ; Cible: Clients::Rapport des ventes ; "https://exemple.com/rapport_ventes.pdf" ]

Exemple 2 

Insère une carte présentant l'adresse du client dans la rubrique conteneur Carte de l'adresse.

Insérer depuis URL [ Avec boîte de dialogue: Non ; Cible: Clients::Carte de l'adresse ; "http://maps.google.com/maps/api/staticmap?center=" & Clients::Adresse & "&zoom=14&markers=" & Clients::Adresse & "&size=256x256&sensor=false&key=API_KEY" ]

Exemple 3 

Insère le code HTML pour https://www.apple.com.

Insérer depuis URL [ Avec boîte de dialogue: Non ; Cible: Clients::Code du site Web HTML ; "https://www.apple.com" ]

Exemple 4 

Utilise les options cURL --user et --upload-file pour uploader un fichier d'une rubrique Conteneur à un serveur au moyen des identifiants myusername et mypassword, puis stocke les résultats du serveur dans la variable $$results. Pour HTTP ou HTTPS, le nom du fichier sur le serveur sera identique au nom du fichier dans la rubrique Conteneur.

Définir variable [ $file ; Valeur: table::conteneur ]
Insérer depuis URL [ Avec boîte de dialogue: Non ; Cible: $$results ; 
"https://exemple.com/uploads" ; Vérifier les certificats SSL ; 
options cURL: "--user myusername:mypassword --upload-file $file 
 --header \"Content-type: image/png\"" ]

Exemple 5 

Envoie un e-mail via un serveur SMTP avec une connexion sécurisée. Utilise les options cURL --mail-from pour l'adresse de l'expéditeur, --mail-rcpt pour l'adresse du destinataire, --upload-file pour le fichier contenant le message, et --user pour les identifiants de connexion au serveur SMTP.

Définir variable [ $mail ; Valeur: TextEncode ( Table::Email ; "utf-8" ; 3 ) ]
Insérer depuis URL [ Sélectionner ; Avec boîte de dialogue: Non ; Cible: $result ;
"smtps://smtp.example.com:465" ; Vérifier les certificats SSL ; options cURL: 
    "--mail-from expéditeur@exemple.com 
    --mail-rcpt destinataire@exemple.com 
    --upload-file $mail 
    --user compte:mot de passe" ]

La rubrique Texte Table::Email contient le message suivant, notamment le corps de l'e-mail au format HTML :

De : Nom de l'expéditeur <expéditeur@exemple.com>
Pour : Nom du destinataire <destinataire@exemple.com>
Objet : Ligne d'objet
Content-Type: text/html; charset="utf8"
<html><body>Corps de l'e-mail</body></html>

Rubriques connexes 

• Page de référence des actions de script