Você pode posicionar os seguintes comandos WFS no arquivo site.wfs ou no perfil de nó de um servidor específico.

<EXIT>

<INCLUDE> filename
                    

<CONDITIONAL_INCLUDE> filename
                    

<SET> variable (option)

<CALL> function(parm1,...)

<IF> variable operator value 
<ELSE>
<ENDIF>

<IFDEF> variable 
<ELSE>
<ENDIF>

<IFNDEF> variable 
<ELSE>
<ENDIF>

<SENDVAR> name={constant|&value}
<ENDSENDVAR>

Ao codificar comandos WFS, você pode utilizar a sintaxe a seguir.

<! >
#

<! This is a comment.> 
# This is also a comment.

\\=

long_string = this is a \\=
very long string that \\=
needs multiple lines 

\n

value = 
{constant|&variable}

long_string = this is a 
long_string = &long_string very long string 
long_string = &long_string that requires 
multiple lines

Quando uma barra invertida (\) for utilizada como o caracter de escape, você pode:

• Incluir um delimitador de strings, como aspas simples ('), como parte do valor dentro da string. Se você preceder o caractere com uma barra invertida (\), ele será interpretado como um dado e não como um delimitador de fim de string.
• Incluir uma barra invertida (\) como parte do valor dentro da string. Você pode inserir uma segunda barra invertida (\\) à frente da primeira (\).

Quando uma barra invertida (\) é utilizada como um caractere de escape, ela não é incluída nos cálculos com base no comprimento da string. Uma string de cinco caracteres e um caracter de escape cabem em uma variável de cinco caracteres.

As variáveis do Cliente WebFOCUS fornecem a você controle sobre a exibição de diversos relatórios na mesma página HTML com diversos quadros sem a necessidade da sintaxe HTML FRAME. Também permite que você conecte vários relatórios com um único Sumário (TOC). Você pode utilizar estas variáveis para exibir formatos diferentes de relatórios, como HTML e PDF, em uma única página de início. Para afetar a saída de solicitações retornando ao Reporting Server do WebFOCUS, emita a sintaxe a seguir no Reporting Server do WebFOCUS:

-TYPE WEBFOCUS CGIVAR variable = value
          

onde:

Variável

É o nome da variável do Cliente WebFOCUS.

valor

Especifica o valor da variável do Cliente WebFOCUS

Para obter mais informações sobre os nomes de variáveis e possíveis variáveis do Cliente WebFOCUS, consulte o manual Como Desenvolver Aplicativos de Relatório.

Você pode incorporar arquivos externos no processamento padrão do WFS. O comando <INCLUDE> a seguir permite que outro arquivo do WFS seja chamado a partir de arquivos padrão do WFS. O arquivo personalizado deve existir para que o processamento continue.

<INCLUDE> filename
          

onde:

Nome do arquivo

É o nome do arquivo a ser incluído para processamento do WFS.

Observação: <CONDITIONAL_INCLUDE> filename trabalha da mesma maneira que o <INCLUDE> filename, exceto pelo fato de que o arquivo não precisa existir.

O comando <SET> a seguir permite a validação e o controle das variáveis do Cliente do WebFOCUS passadas de um cookie ou formulário:

<SET> variable (option)

onde:

Variável

É o nome da variável do Cliente WebFOCUS.

Opção

Podem ser um dos seguintes:

pass

Especifica que a variável será tratada como uma variável ampersand do Gerente de Diálogo no Reporting Server do WebFOCUS. Este é o valor padrão.

dontpass

Especifica que a variável não será passada para o Reporting Server do WebFOCUS.

protect

Especifica que a variável não pode ser configurada do navegador.

Observação: As variáveis IBIF_focexec and IBIF_ex não devem ser restringidas com a opção protect. Fazer isso impediria que o WebFOCUS executasse o procedimento.

number

Especifica que a variável só pode ser numérica.

alfabético

Especifica que a variável só pode conter caracteres alfanuméricos (0-9, a-z) e pontos finais (.).

string

Especifica que todos os caracteres são válidos.

comprimento=n

Configura o comprimento máximo de uma variável em caracteres. O comprimento é ilimitado por padrão.

O plug-in do Servlet do WebFOCUS pode ser habilitado através da configuração da variável WFEXT como o nome de classe ibi.webfoc.WFEXTDefault no arquivo cgivars.vars.

1. Conecte-se ao WebFOCUS como um administrador e selecione Console Administrativo no menu Administração.
2. Selecione Configuração, Configurações do Cliente e, em seguida, Plug-in.
3. Se o nome da classe ibi.webfoc.WFEXTDefault não estiver exibido como o valor da variável WFEXT, insira-o e clique em Salvar.

Observação: Apenas um plug-in pode estar ativo por vez. Caso seja necessário adicionar funções, você deve estender esta classe para incluí-las, com o objetivo de não perder o acesso aos métodos fornecidos nesta classe.

O comando <CALL> a seguir chama um plug-in do WebFOCUS.

<CALL> routine(parm1,parm2) 
<IF> RETCODE NE "returncodevalue"
# insert your code here
<ENDIF>

onde:

<CALL>

É o nome do comando que chama o plug-in do Servlet WebFOCUS.

rotina

Define o nome da função a ser chamada (por exemplo, a segurança ou CopyHTTPCookieToWFVar).

(parm1,parm2)

São os parâmetros de saída do plug-in WebFOCUS. Qualquer plug-in do WebFOCUS pode conter um máximo de dez parâmetros de entrada. O buffer de saída é passado, mas não contribui para o número máximo de parâmetros de entrada.

RETCODE

É o status da chamada do método.

returncodevalue

É o valor que você está comparando com o que o plug-in retorna (por exemplo, 0).

A declaração <IF> a seguir verifica de forma condicuional as variáveis do Cliente do WebFOCUS.

<IF> variable operator value 
<ELSE>
<ENDIF>

onde:

Variável

É qualquer variável do Cliente WebFOCUS.

Operador

Pode ser configurado como EQ, NE, CONTAINS, OR ou AND.

valor

Aplicável a qualquer variável ou constante do Cliente WebFOCUS.

Você pode utilizar a declaração <IF> a seguir para garantir que a página para conexão do WebFOCUS seja chamada.

Se você adicionar upper à variável WFS, o valor é verificado como se possuísse caracteres em caixa alta. Isto permite que você verifique o valor que o usuário inseriu sem se preocupar com o caso.

A declaração <IF> a seguir garante que qualquer valor inseirdo seja tratado como caixa alta.

<IF> ABC.upper EQ "Y" OR ABC.upper EQ "YES"
DEF = &GHI
<ENDIF>

A declaração <IF> a seguir garante que qualquer valor inseirdo seja tratado sem distinção entre maiúsculas e minúsculas.

<IF> IBIC_server.upper EQ "EDASERV"
# INSERT YOUR CODE HERE....
<ENDIF>

A declaração <IF> a seguir verifica se a constante .ibi.com está contida na variável HTTP_HOST do Cliente do WebFOCUS.

<IF> HTTP_HOST contains ".ibi.com"
# INSERT YOUR CODE HERE....
<ENDIF>

A declaração <IFDEF> a seguir verifica a existência de uma variável de Cliente do WebFOCUS.

<IFDEF> variable 
<ELSE>
<ENDIF>

onde:

Variável

É qualquer variável do Cliente WebFOCUS.

No exemplo a seguir, se a variável _ON_NT existir, PATH_SEP será configurado como um ponto e vírgula (;). Se a variável _ON_NT não existir, PATH_SEP é configurado com dois pontos (:).

<IFDEF> _ON_NT
PATH_SEP=; 
<ELSE> PATH_SEP=: 
<ENDIF>

A declaração <IFNDEF> a seguir verifica se uma variável do Cliente do WebFOCUS não existe.

<IFNDEF> variable 
<ELSE>
<ENDIF>

onde:

Variável

É qualquer variável do Cliente WebFOCUS.

O comando <SET> envia variáveis para o Servidor de Relatório do WebFOCUS para uso com procedimentos do servidor. Certas variáveis personalizadas são enviadas para o Servidor de Relatório WebFOCUS automaticamente. Esta sintaxe é utilizada para variáveis que não são enviadas automaticamente para o Servidor de Relatório.

<SET> name = {constant|&variable} (pass)

onde:

nome

É uma variável do Gerente de Diálogo a ser utilizada pelo Reporting Server do WebFOCUS.

constante

É um valor literal. Se você incluir aspas ("), estas serão incluídas como parte da variável. Aplicável a qualquer variável do Cliente WebFOCUS.

&Variável

É um marcador de posição para um valor. Aplicável a qualquer variável do Cliente WebFOCUS.