Plug-in Navigateur Web Windows /Mac OS 4 ème Dimension 1985-2007 4D SAS. Tous droits réservés.
Pour Windows et Mac OS Copyright 1985-2007 4D SAS / 4D, Inc. Tous droits réservés Le logiciel et le manuel sont soumis aux lois du copyright et ne doivent en aucun cas être reproduits en tout ou partie, hormis dans le cadre d une utilisation sous licence personnelle et ce, uniquement en accord avec les termes du contrat, Cette interdiction couvre la copie du support électronique, l archivage ou l utilisation du logiciel de quelque manière que ce soit, autre que celle décrite dans l accord de licence logicielle. 4D, 4D Draw, 4D Write, 4D Insider, 4ème Dimension, 4D Server et les logos 4ème Dimension et 4D sont des marques déposées de 4D SAS. Windows, Windows NT, Windows XP et Microsoft sont des marques déposées de Microsoft Corporation. Apple, Macintosh, MacOS, MacOS X, QuickTime sont des marques commerciales ou des marques déposées d Apple Computer Inc. Mac2Win Software Copyright 1990-2007, est un produit d Altura Software, Inc. Ce produit intègre un logiciel développé par Apache Software Foundation (http://www.apache.org/). 4ème Dimension utilise un logiciel cryptographique écrit par Eric Young (eay@cryptsoft.com) 4ème Dimension utilise un logiciel écrit par Tim Hudson (tjh@cryptsoft.com). ACROBAT Copyright 1987-2007, Secret Commercial Adobe Systems Inc. Tous droits réservés. ACROBAT est une marque déposée d Adobe Systems Inc. Toute autre référence à un nom de marque correspond à une marque commerciale, à une marque déposée ou à un copyright de son détenteur respectif.
Sommaire 4D Live Window.................5 Eléments requis.......................... 5 Principales différences de fonctionnement Mac/Windows.... 6 Installation du plug-in....................... 7 Description des commandes................... 8 Web_SetURL...................................... 8 Web_GetURL..................................... 9 Web_Back........................................ 9 Web_Forward..................................... 9 Web_GetContent................................. 10 Web_SetPreferences............................... 10 Codes d erreurs......................... 11 4D Live Window 3
Sommaire 4 4D Live Window
Le plug-in 4D Live Window vous permet d intégrer des zones de navigation Web dans vos formulaires 4D, tout comme vous le faites avec les zones 4D Write. Une zone 4D Live Window peut être utilisée pour afficher des documents locaux tels que des aides en ligne ou des données Internet telles que Google Maps. A noter que le plug-in 4D Live Window est un navigateur très léger, proposant des fonctions d interprétation HTML basiques. Eléments requis Le plug-in 4D Live Window requiert au minimum la version 2004.5 de 4 e Dimension ainsi que la configuration système suivante : Système d exploitation Navigateur Windows Mac OS Windows 2000, Windows XP Service Version 10.4 (Tiger) ou plus Pack 2 ou plus récent récente MS Internet Explorer 6 ou plus récent Safari 2 ou plus récent Pour pouvoir redistribuer MS Internet Explorer sur un CD avec votre application, vous devez obtenir une licence (gratuite) à l adresse suivante : http://www.microsoft.com/technet/prodtechnol/ie/ieak/default.mspx Sous Windows, le plug-in utilise les contrôles Microsoft Web Browser, basés sur Microsoft Internet Explorer. L apparence et les fonctions de votre navigateur intégré dépendront de la version de MS Internet Explorer installée sur le poste. Sous Mac OS, le plug-in utilise le framework Webkit d Apple et la même technologie que celle développée pour Safari 2.0. Par conséquent, il n est pas possible d utiliser le plug-in sur des systèmes antérieurs à Mac OS 10.4. Comme le plug-in utilise des fonctions système natives, il fonctionne différemment sous Windows et Mac OS X. De même, il existe des différences au niveau des fonctionnalités prises en charge. 4D Live Window 5
Sur les deux plates-formes, les documents au format http:// sont pris en charge. En plus du contenu HTTP valide, certains types de fichiers peuvent être affichés directement, comme les images (JPEG, GIF, PNG) et les documents PDF. Mac OS affiche les documents PDF à l aide de l utilitaire intégré Aperçu, tandis que Windows nécessite l installation préablable d Acrobat Reader. Sous Windows, l affichage et la modification de documents Microsoft Office est également prise en charge lorsque Microsoft Office est installé. Plus précisément, les documents Word, Excel et PowerPoint (extensions.doc,.xls et.ppt) peuvent être affichés. Le format MS Office XML est également accepté. Sous Windows, 4D Live Window permet l affichage de dossiers locaux ou externes via ftp:// ou la syntaxe réseau (\\leserveur\levolume). Les documents doivent débuter par file://. A noter également que le nom des fichiers doit être codé en tant qu URL (par exemple de mon document.pdf à mon%20document.pdf ). Enfin, vous pouvez glisser-déposer des documents compatibles dans une zone 4D Live Window depuis le Finder (Mac OS)/Explorateur (Windows). Principales différences de fonctionnement Mac/Windows Sous Mac OS, la fenêtre du navigateur ignore l instruction Javascript Open Window. Sous Windows en revanche, l instruction Javascript Open Window ou la commande Ouvrir dans une nouvelle fenêtre du menu contextuel du navigateur provoquera l ouverture d une autre fenêtre MS Internet Explorer à l extérieur de 4D. Sous Mac OS, un site Web utilisant du code Javascript peut entraîner des problèmes lors redimensionnement de la fenêtre. Cela est particulièrement sensible avec le site maps.google.com. Pour éviter que l application ne quitte inopinément, la fonction de redimensionnement est limitée sous Mac OS. Par défaut, la taille de la zone est définie au moment de l ouveture du formulaire uniquement. Il n est plus possible de la modifier par la suite. Le développeur peut rétablir les fonctions de redimensionnement via la commande Web_SetPreferences si la page affichée ne contient pas de code Javascript déclenché par le redimensionnement, comme par exemple une documentation en ligne ou un email. 6 4D Live Window
Installation du plug-in Sous Windows, des plug-ins Web tels que Flash peuvent provoquer des erreurs Javascript. Certains plug-ins peuvent également rencontrer des difficultés à ouvrir des fenêtres. Par exemple, QuickTime ne peut pas requérir des codecs supplémentaires. Sous Windows, certaines touches ne sont pas prises en compte dans la zone du navigateur, notamment les touches [Tab] et [Suppr] ainsi que les raccourcis de commande (tels que [Ctrl] + C). La touche Ret. Arrière est toutefois prise en charge, ainsi que les fonctions de copier et coller via le menu contextuel. Sous Windows, le plug-in MS Internet Explorer ne rend pas pas la main à 4D pendant le téléchargement de chaque ressource (une page Web est constituée de plusieurs ressources telles que des images, des frames, etc.). Ce mécanisme rend impossible l accès au serveur Web de l application 4D qui héberge le plug-in. Bien entendu, un 4D Client peut accéder à un serveur Web lancé depuis 4D Server, mais pas à son propre serveur Web. Il n est pas possible d afficher des documents Microsoft Office 2007 dans une zone de navigation Web incluse. Leur affichage s effectue toujours dans une nouvelle fenêtre. Le contenu du menu contextuel (accessible via un clic droit dans la zone) ainsi que les fonctions proposées sont différents entre Mac OS et Windows. Installation du plug-in Le plug-in 4D Live Window doit être installé dans le dossier PlugIns situé à côté de votre fichier de structure. Les zones du plug-in sont créées dans les formulaires comme pour les autres plug-ins, par exemple 4D Write. Notez que si vous souhaitez utiliser plusieurs zones du plug-ins dans un même formulaire (même dans des pages différentes), les noms des variables des zones doivent être différents même si elles affichent le même URL. Ce principe est semblable à l ouverture de plusieurs fenêtres dans un navigateur, chaque fenêtre est alors indépendante. 4D Live Window 7
Description des commandes Web_SetURL Web_SetURL (zone; url; macospath) Code d erreur url Texte URL complet (http://www.4d.com) macospath Entier long 0 pour URL, 1 pour chemin. Inutilisé sous Windows Web_SetURL permet de spécifier l URL ou le document à ouvrir dans la zone 4D Live Window. C est généralement la première commande appliquée à la zone. La chaîne passée dans le paramètre url doit être un URL complet et valide (par exemple http://www.4d.com ou file:///c:/mon %20Document.pdf). Sous Mac OS, un nom de fichier doit être un chemin Unix valide, de la forme : file://localhost/users/thomas/documents/image%c3.jpg. Les caractères 8-bits et les caractères spéciaux tels que les espaces doivent être encodés. Les caractères incorrectement encodés peuvent provoquer le blocage de l application. Le paramètre macospath permet d encoder automatiquement un chemin d accès de fichier. Passez 1 pour utiliser un chemin HFS du type MonDisque:Users:thomas:Documents:imageö.jpg. Sous Windows, les noms de fichiers sont acceptés, comme C:\Mon Document.pdf" ou Câblé.jpg sans qu il ne soit nécessaire d encoder les caractères spéciaux. Les URL simples tels que www.4d.com sont également acceptés. Cependant, il est généralement préférable d utiliser des caractères standard. Résultat La fonction retourne 0 si elle a été correctement exécutée et un code d erreur dans le cas contraire. 8 4D Live Window
Description des commandes Web_GetURL Web_GetURL (zone; url) Code d erreur url Texte URL courant La commande Web_GetURL retourne dans url l URL actuellement affiché dans la zone 4D Live Window. Résultat La fonction retourne 0 si elle a été correctement exécutée et un code d erreur dans le cas contraire. Web_Back Web_Back (zone) Code d erreur La commande Web_Back appelle la fonction Précédente du navigateur, provoquant le réaffichage de l URL précédent dans la zone. Résultat La fonction retourne 0 si elle a été correctement exécutée et un code d erreur dans le cas contraire. Web_Forward Web_Forward (zone) Code d erreur La commande Web_Back appelle la fonction Suivante du navigateur dans la zone, annulant l exécution de la fonction Précédente. Si la fonction Précédente n avait pas été appelée auparavant, le commande ne fait rien. 4D Live Window 9
Web_GetContent Web_GetContent (zone; source) Code d erreur source BLOB Code source de la page La commande Web_GetContent retourne le code source de la page principale sous forme de BLOB. Résultat La fonction retourne 0 si elle a été correctement exécutée et un code d erreur dans le cas contraire. Web_SetPreferences Web_SetPreferences (zone; sélecteur; valeurnum; valeurchaine) Code d erreur sélecteur Entier long Code de sélecteur de préférence valeurnum Entier long Numérique à définir valeurchaine Alpha Texte à définir La commande Web_SetPreferences vous permet de modifier divers fonctionnements du plug-in 4D Live Window. Note: Dans la version 1.0 de 4D Live Window, le paramètre valeurchaine n est pas utilisé, passez une chaîne vide "" dans ce paramètre. Sélecteur Code Valeurs possibles Web_kResize 1 0=désactiver le redimensionnement ; 1=activer le redimensionnement Web_kVisible 2 0=cacher le navigateur ; 1=montrer le navigateur Web_kResize Mac OS uniquement : lorsque la zone du plug-in est redimensionnée, certains sites web (notamment maps.google.com) exécutent des scripts Javascript afin de recalculer la position relative des éléments. 10 4D Live Window
Codes d erreurs Ce principe peut conduire à des dysfonctionnements de l application 4D si le site était déjà affiché. Pour éviter ce problème, par défaut la zone de navigation est de taille fixe (non redimensionnable). Dans tous les cas la zone du navigateur n est pas redimensionnée automatiquement sauf lors de l affichage initial (la fenêtre est ouverte avant que le site Web soit chargé). Si vous affichez du code HTML (ou des documents PDF) sans Javascript, vous pouvez réactiver les fonctions de redimensionnement à l aide de cette option. Dans ce cas, il est prudent de ne pas permettre à l utilisateur de saisir un URL manuellement. Cette option n a pas d effet sous Windows. Web_kVisible La commande 4D CHOIX VISIBLE ne masque pas totalement la zone car le navigateur répond directement aux événements tels que le déplacement de la souris ou les redessinements initiés par le Javascript. Par conséquent, il est nécessaire pour masquer/montrer la zone du navigateur d utiliser conjointement les commandes CHOIX VISIBLE et Web_SetPreferences. Résultat La fonction retourne 0 si elle a été correctement exécutée et un code d erreur dans le cas contraire. Exemple $err:=web_setpreferences(mazoneweb;1;1;"") ` rétablissement du redimensionnement Codes d erreurs Toutes les commandes du plug-in 4D Live Window retournent 0 si leur exécution a été correcte. Les codes d erreurs possibles sont les suivants : -15001 La zone spécifiée n est pas une zone 4D Live Window -15002 Paramètre invalide -15003 Erreur interne 4D Live Window 11