version 11.2
WA FIXER FILTRES LIENS EXTERNES ({*; }objet; tabFiltres; tabAutorisRefus)
Paramètre | Type | Description | |
* | * | Si spécifié, objet est un nom d'objet (chaîne) | |
Si omis, objet est une variable | |||
objet | Objet de formulaire | Nom d'objet (si * est spécifié) ou | |
Variable (si * est omis) | |||
tabFiltres | Tableau chaîne | Tableau de filtres | |
tabAutorisRefus | Tableau Booléen | Tableau autoriser-refuser |
Description
La commande WA FIXER FILTRES LIENS EXTERNES permet de mettre en place un ou plusieurs filtre(s) de liens externes pour la zone Web désignée par les paramètres * et objet. Les filtres de liens externes déterminent si un URL associé à la page courante via un lien doit être ouvert dans la zone Web ou dans le navigateur Web par défaut de la machine.
Lorsque l'utilisateur clique sur un lien dans la page courante, 4D consulte la liste des filtres de liens externes afin de vérifier si l'URL demandé doit être ouvert dans le navigateur de la machine. Si c'est le cas, la page correspondant à l'URL est affichée dans le navigateur Web et l'événement formulaire Sur ouverture lien externe est généré (cf. commande Evenement formulaire). Sinon (fonctionnement par défaut), la page correspondant à l'URL est affichée dans la zone Web. L'évaluation de l'URL est basée sur le contenu des tableaux tabFiltres et tabAutorisRefus.
Les tableaux tabFiltres et tabAutorisRefus doivent être synchronisés.
Chaque ligne du tableau tabFiltres doit contenir un URL devant être filtré. Vous pouvez utiliser le * comme joker de remplacement pour un ou plusieurs caractère(s).
Chaque ligne correspondante dans le tableau tabAutorisRefus doit contenur un booléen indiquant si l'URL doit être ouvert dans la zone Web (Vrai) ou dans le navigateur Web (Faux).
En cas de contradiction au niveau des paramétrages (autorisation et refus d'un même URL), le paramétrage pris en compte est le dernier.
Pour désactiver le filtrage des URLs, appelez la commande en lui passant des tableaux vides ou en passant respectivement les valeurs "*" et Vrai dans la dernière ligne des tableaux tabFiltres et tabAutorisRefus.
Important : Le filtrage établi par la commande WA FIXER FILTRES URL est pris en compte avant celui de WA FIXER FILTRES LIENS EXTERNES. Cela signifie que si un URL est refusé à cause d'un filtre de la commande WA FIXER FILTRES URL, il ne pourra pas être ouvert dans un navigateur même s'il est explicitement défini par la commande WA FIXER FILTRES LIENS EXTERNES (cf. exemple 2).
Exemples
(1) Cet exemple provoquera l'ouverture de sites dans des navigateurs externes :
TABLEAU ALPHA(0;$filters;0) TABLEAU BOOLEEN($AllowDeny;0) AJOUTER A TABLEAU($filters;"*www.google.*") `Sélectionner "google" AJOUTER A TABLEAU($AllowDeny;Faux) `Faux : ce lien sera ouvert dans un navigateur externe AJOUTER A TABLEAU($filters;"*www.apple.*") AJOUTER A TABLEAU($AllowDeny;Faux) `Faux : ce lien sera ouvert dans un navigateur externe WA FIXER FILTRES LIENS EXTERNES(MaZoneW;$filters;$AllowDeny)
(2) Cet exemple combine des filtrages de sites et de liens externes :
TABLEAU ALPHA(0;$filters;0) TABLEAU BOOLEEN($AllowDeny;0) AJOUTER A TABLEAU($filters;"*www.google.*") `Sélectionner "google" AJOUTER A TABLEAU($AllowDeny;Faux) `Interdire ce lien WA FIXER FILTRES URL(MaZoneW;$filters;$AllowDeny) TABLEAU ALPHA(0;$filters;0) TABLEAU BOOLEEN($AllowDeny;0) AJOUTER A TABLEAU($filters;"*www.google.*") `Sélectionner "google" AJOUTER A TABLEAU($AllowDeny;Faux) `Faux : ce lien devrait être ouvert dans un navigateur externe, mais ce paramétrage est sans effet car le lien sera bloqué `du fait du filtrage d'URL. WA FIXER FILTRES LIENS EXTERNES(MaZoneW;$filters;$AllowDeny)
Référence
WA FIXER FILTRES URL, WA LIRE FILTRES LIENS EXTERNES.