Cette fonction permet d'ouvrir une URL, soit dans une fenêtre popup, soit dans une iframe insérée dans le document actuel.
Attention : cette fonction doit être utilisée dans la partie client du programme.
Domaine d'application
Client Adélia Cloud.
Paramètres
ALPHA (n) |
Titre |
Titre de la page. |
ALPHA (n) |
URL |
URL du document lié. |
ALPHA (n) |
Options |
Options, sous la forme d'une liste d'attributs clé[=valeur] séparés par des virgules. Valeurs particulières: si inline = *VRAI, l'option "target" doit être fournie et prendre comme valeur l'identifiant du div dans lequel l'iframe sera créée. Les autres options sont les attributs de la balise <iframe>. si inline = *FAUX,
|
BOOL |
Inline |
Indique si la page doit être ouverte en ligne dans un div (*VRAI, dans ce cas le champ options doit spécifier l'id du div), ou dans une fenêtre popup. |
BOOL |
CodeRetour |
Code retour de l'opération : *VRAI si l'appel de la fonction a réussi. *FAUX dans le cas contraire. Le code retour indique que la fenêtre popup ou le document intégré (<iframe>) a été créé, mais pas que le document a été chargé correctement. |
Remarques :
- Si vous ouvrez l'URL "inline", l'iframe crée remplacera le contenu complet du div spécifié en comme cible.
- Certains sites (ex: google.com) ont une politique de sécurité interdisant l'ouverture du document dans une <iframe>. Dans ce cas le contenu de la frame est vide, mais aucune information d'erreur n'est renvoyée.
- Selon la configuration de votre navigateur, il est possible que la fenêtre popup soit créée dans un nouvel onglet, et qu'une ou plusieurs des options spécifiées dans le paramètre "Options" soit ignorées par le navigateur.
Voir la documentation en ligne de window.open (https://developer.mozilla.org/en-US/docs/Web/API/Window.open) pour les restrictions et les valeurs possibles du champ "Options" (paramètre "features" de la fonction).
Par exemple
Titre = 'DOC_EN_LIGNE'
URL = 'http://docserver.domain.com/doc/index.html'
Options = 'target=doc_element_id,sandbox="allow-same-origin",seamless'
APPELER_DLL 'VATOOLBX.DLL' 'VaToolBxCloudOpenURL' Titre URL Options *VRAI CodeRetour
Liste des fonctions de la DLL VaToolBx par thème