Personalização › Personalização da interface web › Variáveis de servidor › Variáveis de propriedade

Variáveis de propriedade

As variáveis de propriedade representam uma propriedade do arquivo de configuração web.cfg. Você pode acessar qualquer entrada no arquivo web.cfg (incluindo as entradas definidas pelo usuário) dentro de um arquivo de modelo HTML com o prefixo “$prop”.

Por exemplo, uma das linhas de web cfg, que especifica o número de entradas exibidas em uma única página de um formulário de lista, é a seguinte:

ListPageLength 10

É possível fazer referência a essa variável em um modelo em HTML com a especificação:

$prop.ListPageLength

Se usar a marca especial <PDM_INCLUDE> para incorporar outro arquivo em um arquivo de modelo, você poderá especificar propriedades adicionais como atributos da marca <PDM_INCLUDE>. É possível fazer referência a essas propriedades do arquivo incluído do mesmo modo que com as propriedades de web cfg. Uma propriedade especificada como um atributo de <PDM_INCLUDE> que tenha o mesmo nome de uma propriedade de web cfg substituirá a propriedade de web cfg no arquivo incluído.

Por exemplo, a seguinte marca <PDM_INCLUDE> cria uma propriedade chamada $prop.menubar que pode ser mencionada no arquivo std_body.htmpl:

<PDM_INCLUDE FILE=std_body.htmpl menubar=no>

Observação: é possível fazer referência à propriedade do arquivo de configuração xxx de duas formas: $prop.xxx ou $SESSION.xxx. Ambos retornam o mesmo valor. No entanto, a sintaxe $prop.xxx é preferida porque envolve menos sobrecarga do servidor.

Além das propriedades de web cfg, há várias propriedades predefinidas que podem ser acessadas com $prop. São elas:

$prop.browser

Uma sequência de caracteres que identifica o navegador em uso. Para o Internet Explorer, será “IE”.

$prop.combo_name

Uma sequência de caracteres que contém o nome do usuário atual, no formato “sobrenome, nome, nome_do_meio”.

$prop.factory

Uma sequência de caracteres que contém a fábrica associada ao formulário atual, como “cr” para solicitações ou “iss” para ocorrências.

$prop.FID

Uma sequência de caracteres que contém a ID numérica do formulário atual.

$prop.form_name

Uma sequência de caracteres que contém o nome do modelo em HTML atual, no formato xxx.htmpl.

$prop.form_name_1

Uma sequência de caracteres que contém a subsequência do nome do formulário antes do primeiro sublinhado. Por exemplo, para o formulário detail_chg_edit.htmpl, form_name_1 seria “detail”.

$prop.form_name_2

Uma sequência de caracteres que contém a subsequência do nome do formulário depois do primeiro sublinhado e antes do último sublinhado (ou ponto). Por exemplo, para o formulário detail_chg_edit.htmpl, form_name_2 seria “chg”.

$prop.form_name_3

Uma sequência de caracteres que contém a subsequência do nome do formulário depois do último sublinhado e antes do ponto. Por exemplo, no caso do formulário detail_chg_edit.htmpl, o form_name_3 será “edit”. Para o formulário de detalhes da combinação, que tenha o nome do arquivo do formulário detail_xxx.htmpl, $prop.form_name_3 será definido para a exibição atual: “ro” ou “edit”.

$prop.release

Uma sequência de caracteres que contém o nível de versão do formulário. A instrução PDM_PRAGMA contém mais detalhes sobre essa propriedade.

$prop.SID

Uma sequência de caracteres que contém a ID numérica da sessão atual.

$prop.sitemod

Uma sequência de caracteres que contém o nome de modificação do formulário definido pelo site. A instrução PDM_PRAGMA contém mais detalhes sobre essa propriedade.

$prop.user_type

Uma sequência de caracteres que contém os itens “analista”, “cliente”, “funcionário” ou “convidado”.

$prop.version

Uma sequência de caracteres que contém a versão do formulário. A instrução PDM_PRAGMA contém mais detalhes sobre essa propriedade.

Mais informações:

PDM_PRAGMA: especificar informações do servidor