4D v16.3

WA SET EXTERNAL LINKS FILTERS

Página Inicial

 
4D v16.3
WA SET EXTERNAL LINKS FILTERS

WA SET EXTERNAL LINKS FILTERS 


 

WA SET EXTERNAL LINKS FILTERS ( {* ;} objeto ; arrFiltro ; permitirArrRecusar ) 
Parâmetro Tipo   Descrição
Operador in Se especificado, objeto é um nome de objeto (string); se omitido, objeto é uma variável
objeto  Objeto de formulário in Nome objeto (se * for especificado) ou Variável (se * é omitido)
arrFiltro  Array string in Array filtros
permitirArrRecusar  Array booleano in Allow-deny array

O comando WA SET EXTERNAL LINKS FILTERS permite estabelecer um ou mais filtros de links externos para a zona web designada pelos parâmetros * e objeto. Os filtros de links externos determinam se um URL associado a página atual através um link deve ser aberto na área web ou no navegador web por padrão da máquina.

Quando o usuário clicar em um link na página atual, 4D consulta a lista dos filtros externos com o objetivo de verificar a URL solicitado deve ser aberto no navegador da máquina. Se for assim, a página correspondente a URL é mostrada no navegador web e  se gera o evento de formulário On Open External Link. Do contrário (o funcionamento por padrão), a página correspondente a URL se mostra na área web. A avaliação da URL está baseada no conteúdo dos arrays arrFiltro e permitirArrRecusar.

Os arrays arrFiltro e permitirArrRecusar devem estar sincronizados.

  • Cada linha do array arrFiltro deve conter um URL a filtrar. Pode utilizar * como coringa para substituir um ou mais caracteres.
  • Cada linha correspondente no array permitirArrRecusar deve conter um booleano indicando se a URL deve ser aberta na área web (True) ou no navegador web (False).

Se houver uma contradição a nível da configuração (a mesma URL é ao mesmo tempo autorizada e recusada), a última configuração é levada em consideração.

Para desativar o filtro das URL, chame o comando e passe os arrays vazio ou passe, respectivamente os valores "*" e True nos últimos elementos dos arrays arrFiltro e permitirArrRecusar.

Importante
: o filtro estabelecido pelo comando WA SET URL FILTERS é levado em consideração antes do comando WA SET EXTERNAL LINKS FILTERS. Isto significa que se um URL é recusado por um filtro do comando WA SET URL FILTERS, não poderá ser aberto no navegador mesmo se for definido explicitamente pelo comando WA SET EXTERNAL LINKS FILTERS (ver exemplo 2).

Este exemplo provoca a abertura de sites em navegadores externos:

 ARRAY STRING(0;$filtros;0)
 ARRAY BOOLEAN($PermitirRecusar;0)
 
 APPEND TO ARRAY($filtros;"*www.google.*") `Selecionar "google"
 APPEND TO ARRAY($PermitirRecusar;False)
  `False: este link será aberto em um navegador externo
 APPEND TO ARRAY($filtros;"*www.apple.*")
 APPEND TO ARRAY($PermitirRecusar;False)
  `False: este link será aberto em um navegador externo
 WA SET EXTERNAL LINKS FILTERS(MinhaWArea;$filtros;$PermitirRecusar)

Este exemplo combina os filtros de sites e de links externos:

 ARRAY STRING(0;$filtros;0)
 ARRAY BOOLEAN($PermitirRecusar;0)
 APPEND TO ARRAY($filtros;"*www.google.*") `Selecionar "google"
 APPEND TO ARRAY($PermitirRecusar;False`Link negado
 WA SET URL FILTERS(MinhaWArea;$filtros;$PermitirRecusar)
 
 ARRAY STRING(0;$filtros;0)
 ARRAY BOOLEAN($PermitirRecusar;0)
 APPEND TO ARRAY($filtros;"*www.google.*") `Selecionar "google"
 APPEND TO ARRAY($PermitirRecusar;False)
  `False: este link deve ser aberto em um navegador externo mas este parâmetro
  `não tem efeito porque o link será bloqueado pelo filtro da URL.
 WA SET EXTERNAL LINKS FILTERS(MinhaWArea;$filtros;$PermitirRecusar)



Ver também 

WA GET EXTERNAL LINKS FILTERS
WA SET URL FILTERS

 
PROPRIEDADES 

Produto: 4D
Tema: Área Web
Número 1032

 
HISTÓRIA 

Criado por: 4D v11 SQL Release 2

 
ARTICLE USAGE

Manual de linguagem 4D ( 4D v16)
Manual de linguagem 4D ( 4D v16.1)
Manual de linguagem 4D ( 4D v16.2)
Manual de linguagem 4D ( 4D v16.3)