4D Doc Center : PROCESS 4D TAGS

4D v14.3

PROCESS 4D TAGS


PROCESS 4D TAGS ( dadosEntrada ; dadosSaida )

Parâmetro	Tipo	Descrição
dadosEntrada	Texto, BLOB	Dados que contém as etiquetas HTML a processar
dadosSaida	Texto, BLOB	Dados processados

Descrição

O comando PROCESS 4D TAGS provoca o processamento por 4D das etiquetas HTML 4D contidas em dadosEntrada (campo ou variável de tipo Texto ou BLOB) e retorna os dados resultantes em dadosSaida.

Este comando permite efetuar um processo no código HTML etiquetado sem que seja necessário que o servidor web envie uma página HTML utilizando um comando do tipo SEND HTML BLOB ou que uma página com sufixo “.shtml” seja pedida através de uma URL. Não é necessário iniciar o servidor web de 4D.

Passe os dados que contém as etiquetas a processar no parâmetro dadosEntrada. Este parâmetro pode ser um campo ou uma variável de tipo Texto ou BLOB. Lembre que se seu banco funcionar em modo compatibilidade ASCII, o tipo BLOB é preferível já que o número de carateres é ilimitado (o tipo texto está limitado a 32000). Se seu banco funcionar em modo padrão (Unicode), o tipo Texto é geralmente suficiente (os parâmetros podem receber até 2 GB de texto).

Nota de compatibilidade: A partir da versão 12 de 4D, quando utilizar parâmetros de tipo BLOB, o comando considera automaticamente que o conjunto de carateres utilizado por os BLOBs é MacRomam. Para maior eficiência, se recomenda utilizar os parâmetros de tipo Texto para os quais os processos se realizam em modo Unicode.

Todas as etiquetas HTML de 4D são compatíveis (4DTEXT, 4DHTML, 4DSCRIPT, 4DLOOP, etc.), mesmo quando não tiver iniciado o servidor web.

Nota: Quando utilizar a etiqueta 4DINCLUDE fora do marco do servidor web (processo web):

Com 4D em modo local ou 4D Server, a pasta por padrão é a pasta que contém o arquivo de estrutura do banco,
Com 4D em modo remoto, a pasta por padrão é a pasta que contém a aplicação 4D.

Depois da execução do comando, o parâmetro dadosSaida recebe os dados do parâmetro dadosEntrada, junto com o resultado do processo das etiquetas HTML 4D que contém, quando aplicável. Se dadosEntrada não contiver etiquetas HTML 4D, o conteúdo de dadosSaida é idêntico ao de dadosEntrada.

O parâmetro dadosSaida pode ser um campo ou uma variável, mas deve ser do mesmo tipo que o parâmetro dadosEntrada.

Este comando torna possível o armazenamento no banco dos valores resultantes de um processo de etiquetas HTML antes de que sejam enviados.

Igualmente permite analizar as etiquetas HTML 4D aparte do uso do servidor web. Em particular, pode utilizá-lo para enviar através 4D Internet Commands e-mails em formato HTML que contenham os processos e/ou referências aos dados contidos no banco.

Nota: A partir da versão 11 de 4D, este comando já não chama ao On Web Authentication Database Method.

Exemplo

Este exemplo carrega um documento de tipo 'template', processa as etiquetas que contiver e depois o guarda:

 C_BLOB($Blob_x)

 C_BLOB($blob_out)

 C_TEXT($inputText_t)

 C_TEXT($outputText_t)

 

 DOCUMENT TO BLOB("meutemplate.txt";$Blob_x)

 $inputText_t:=BLOB to text($Blob_x;UTF8 text without length)

 PROCESS 4D TAGS($inputText_t;$outputText_t)

 TEXT TO BLOB($outputText_t;$blob_out;UTF8 text without length)

 BLOB TO DOCUMENT($document;$blob_out)