Saltar para o conteúdo principal
Versão: 20

Página da Web

Usando as guias na página Web, você pode configurar vários aspectos do servidor Web integrado de 4D (segurança, inicialização, conexões, serviços Web, etc.). Para obter mais informações sobre como o servidor Web 4D funciona, consulte Servidor Web. Para obter mais informações sobre os serviços Web 4D, consulte o capítulo Publicação e uso de Serviços Web.

Configuração

Informações de publicação

Iniciar o servidor Web no arranque

Indica se o servidor Web será iniciado ao iniciar a aplicação 4D. Essa opção é descrita na seção Administração do servidor Web.

Ativar HTTP

Indica se o servidor web vai ou não aceitar conexões não seguras. Ver Ativar HTTP.

Porta HTTP

Número da porta IP (TCP) de escuta para HTTP. Ver Porta HTTP.

Endereço IP

Endereço IP em que o servidor web 4D vai receber solicitações HTTP (4D local e 4D Server). Consulte Endereço IP para ouvir.

Ativar HTTPS

Indica se o servidor web vai ou não aceitar conexões seguras. Consulte Habilitar HTTPS.

Porta HTTPS

Permite modificar o número da porta TCP/IP usada pelo servidor Web para as conexões HTTP seguras sobre TLS (protocolo HTTPS). Ver Porta HTTPS.

Permitir o acesso ao banco de dados através de URLs 4DSYNC

Nota de compatibilidade: esta opção é obsoleta. Para acesso ao banco de dados através de HTTP, agora é recomendado usar as funcionalidades de armazenamento remoto do ORDA e solicitações REST.

Caminhos

Raiz HTML predefinida

Define a localização padrão dos arquivos do site e indicar o nível hierárquico no disco acima do qual os arquivos não serão acessíveis. Ver Carpeta raiz.

Página inicial predefinida

Designar uma página inicial padrão para o servidor Web. Veja Página inicial padrão.

Options (I)

Cache

Usar o cache Web 4D

Ativar o cache da página Web. Ver Cache.

Tamanho da cache das Páginas

Define o tamanho da cache. Ver Cache.

Limpar cache

A qualquer momento, você pode limpar o cache das páginas e imagens que ele contém (se, por exemplo, você tiver modificado uma página estática e quiser recarregá-la no cache). At any moment, you can clear the cache of the pages and images that it contains (if, for example, you have modified a static page and you want to reload it in the cache). A cache é então imediatamente limpa.

Também pode utilizar o URL especial /4DCACHECLEAR.

Processo Web

Essa área permite configurar como o servidor Web tratará as sessões de usuário e seus processos associados.

A opção Legacy sessions só está disponível para compatibilidade em bancos de dados/projetos criados com versões do 4D anteriores ao 4D v18 R6.

Sessões escaláveis (sessões multi-processo)

Quando seleciona esta opção (recomendado), uma sessão de usuário é gerenciada através de um objeto Session. Consulte a página Sessões usuário.

Sem sessões

Quando essa opção é selecionada, o servidor Web não oferece nenhum suporte específico para as sessões usuário. As solicitações sucessivas dos clientes Web são sempre independentes e nenhum contexto é mantido no servidor.

Neste modo, pode configurar parâmetros do servidor Web adicionais:

Sessões herdadas (sessões de processo único)

Nota de compatibilidade: essa opção só está disponível em bancos de dados/projetos criados com uma versão 4D anterior ao 4D v18 R6.

Esta opção permite o gerenciamento de sessões de usuário legadas pelo servidor 4D HTTP. Este mecanismo é descrito na secção Gerenciamento de sessões Web (Legado). Veja Manter Sessão.

Quando selecionado, a opção Reutilizar contextos temporários (4D no modo remoto) é marcada automaticamente (e bloqueada).

Processos Web em simultâneo máximo

Não disponível com sessões expansíveis.

Limite estritamente superior de processos Web em simultâneo. Veja Processos Web em simultâneo máximo.

Reutilização de contextos temporários

Não disponível com sessões expansíveis.

Permite otimizar a operação do servidor Web 4D no modo remoto. Veja Reutilizar contextos temporários no modo remoto).

Utilizar processos preemptivos

Não disponível com sessões expansíveis.

Permite processos web preemptivos nas suas aplicações compiladas. Quando usar processos preventivos for selecionado, A elegibilidade de seu código relacionado à Web (incluindo etiquetas 4D e métodos de banco de dados web) para a execução preventiva será avaliada durante a compilação. Para obter mais informações, consulte Uso de processos Web preemptivos.

Essa opção não se aplica a sessões dimensionáveis, processos REST (modo compilado) e processos de serviço Web (servidor ou cliente). Consulte Ativação do modo preemptivo para o servidor Web.

Tempo limite do processo inativo

Não disponível com sessões expansíveis.

Permite que você defina o tempo limite máximo antes de fechar os processos inativos da Web no servidor. Veja Tempo de processo inativo.

Palavras-passe Web

Defina o sistema de autenticação que você deseja aplicar ao seu servidor Web. São propostas três opções:

Custom (default) Passwords with BASIC protocol Passwords with DIGEST protocol

É recomendado usar a autenticação personalizada. Veja o capítulo Autenticação na documentação Desenvolvimento Web.

Opções (II)

Conversão texto

Enviar diretamente caracteres expandidos

Ver Propriedades obsoletas.

Standard Set

Defina o conjunto de caracteres a serem usados pelo servidor Web 4D. Ver Conjunto de caracteres.

Ligações Keep-Alive

Ver Propriedades obsoletas.

Parâmetros CORS

Ativar CORS

Ativa o serviço Cross-origin resource sharing (CORS). Ver Ativar CORS.

Nomes de domínio/Métodos HTTP permitidos

Lista de hosts e métodos permitidos para o serviço CORS. Ver Parâmetros CORS.

Registo (tipo)

Formato do histórico

Inicia ou interrompe o registro das solicitações recebidas pelo servidor da Web 4D no arquivo logweb.txt e define seu formato. Consulte Registro de logs.

A ativação e a desativação do arquivo de histórico de solicitações também podem ser realizadas por programação usando o comando WEB SET OPTION.

O menu de formato do histórico oferece as seguintes opções:

  • Sem arquivo de registro: quando esta opção for selecionada, 4D não irá gerar um arquivo de registro de solicitações.

  • CLF (Common Log Format): quando esta opção for selecionada, o log de pedidos é gerado no formato CLF. Com o formato CLF, cada linha do arquivo representa uma solicitação, como:
    host rfc931 usuário [DD/MMM/AAAA:HH:MM:SS] "solicitação" estado tamanho
    Cada campo é separado por um espaço e cada linha termina com a sequência CR/LF (caractere 13, caractere 10).

    • host: endereço IP do cliente (ex. 192.100.100.10)
    • rfc931: informação não é gerada por 4D, é sempre - (um sinal de menos)
    • usuário: nome de usuário como ele está autenticado, ou então é - (um sinal menos). Se o nome de usuário contiver espaços, eles serão substituídos por _ (um sublinhado).
    • DD: dia, MMM: uma abreviação de 3 letras para o nome do mês (Jan, Feb,...), YYYY: ano, HH: hora, MM: minutos, SS: segundos

A data e a hora são locais para o servidor.

  • petição: petição enviada pelo cliente (por exemplo, GET /index.htm HTTP/1.0)
  • estado: resposta dada pelo servidor.
  • length: tamanho dos dados devolvidos (exceto o cabeçalho HTTP) ou 0.

Nota: por razões de desempenho, as operações são salvas em uma memória temporária em pacotes de 1Kb antes de serem escritas em disco. As operações também são gravadas no disco se nenhuma solicitação tiver sido enviada a cada 5 segundos. Os valores possíveis de estado são os seguintes: 200: OK 204: No contents 302: Redirection 304: Not modified 400: Incorrect request 401: Authentication required 404: Not found 500: Internal error O formato CLF não pode ser personalizado.

  • DLF (Combined Log Format): quando esta opção é selecionada, o registro de solicitações é gerado no formato DLF. O formato DLF é semelhante ao formato CLF e usa a mesma estrutura. Simplesmente adiciona dois campos HTTP adicionais no final de cada solicitação: Referer e User-agent.

    • Referer: contém o URL da página que aponta para o documento solicitado.
    • User-agent: contém o nome e a versão do navegador ou software cliente que origina a solicitação.

O formato DLF não pode ser personalizado.

  • ELF (Extended Log Format): quando essa opção é selecionada, o registro da solicitação é gerado no formato ELF. O formato ELF está muito difundido no mundo dos navegadores HTTP. Ele pode ser usado para criar registros sofisticados que atendam a necessidades específicas. Por esse motivo, o formato ELF pode ser personalizado: é possível escolher os campos a serem registrados, bem como sua ordem de inserção no arquivo.

  • WLF (WebStar Log Format): quando essa opção é selecionada, o registro da solicitação é gerado no formato WLF. O formato WLF foi desenvolvido especificamente para o servidor 4D WebSTAR. Ele é semelhante ao formato ELF, com apenas alguns campos adicionais. Tal como o formato ELF, pode ser personalizado.

Configuring the fields When you choose the ELF (Extended Log Format) or WLF (WebStar Log Format) format, the "Weg Log Token Selection" area displays the fields available for the chosen format. You will need to select each field to be included in the log. To do so, check the desired fields. You will need to select each field to be included in the log. To do so, check the desired fields.

Nota: não é possível selecionar duas vezes o mesmo campo.

A tabela a seguir lista os campos disponíveis para cada formato (em ordem alfabética) e descreve seu conteúdo:

CampoELFWLFValor
BYTES_RECEIVEDXNúmero de bytes recebidos pelo servidor
BYTES_SENTXXNúmero de bytes enviados pelo servidor ao cliente
C_DNSXXEndereço IP do DNS (ELF: campo idêntico ao campo C_IP)
C_IPXXEndereço IP do cliente (por exemplo, 192.100.100.10)
CONNECTION_IDXNúmero de identificação da ligação
CS(COOKIE)XXInformações sobre as cookies contidas na petição HTTP
CS(HOST)XXCampo Host do pedido HTTP
CS(REFERER)XXURL da página que aponta para o documento solicitado
CS(USER_AGENT)XXInformações sobre o software e o sistema operacional do cliente
CS_SIPXXEndereço IP do servidor
CS_URIXXURI onde o pedido é efectuado
CS_URI_QUERYXXParâmetros da consulta
CS_URI_STEMXXParte da solicitação sem parâmetros de consulta
DATEXXDDD: dia, MMM: abreviação de 3 letras por mês (jan, fev, etc.), YYYY: ano
METHODXXMétodo HTTP utilizado para o pedido enviado ao servidor
PATH_ARGSXParâmetros CGI: cadeia de caracteres localizada após o caractere "$"
STATUSXXResposta fornecida pelo servidor
TIMEXXHH: hora, MM: minutos, SS: segundos
TRANSFER_TIMEXXTempo solicitado pelo servidor para gerar a resposta
USERXXNome do usuário se estiver autenticado; caso contrário, - (sinal de menos).
Se o nome do usuário contiver espaços, eles serão substituídos por _ (sublinhado)
URLXURL solicitado pelo cliente

As datas e horas são indicadas em GMT.

Histórico (backup)

Configure the automatic backup parameters for the request log. Configure the automatic backup parameters for the request log. First you must choose the frequency (days, weeks, etc.) or the file size limit criterion by clicking on the corresponding radio button. Configure the automatic backup parameters for the request log. First you must choose the frequency (days, weeks, etc.) or the file size limit criterion by clicking on the corresponding radio button. Você deve então especificar o momento exato do backup, se necessário.

  • Sem Backup: a função de backup agendada está desativada.

  • A cada X hora(s): esta opção é utilizada para programar backups de forma horária. Pode digitar um valor entre 1 e 24.

    • iniciando em: usado para definir a hora em que o primeiro backup começará.
  • A cada X dia(s) às X: esta opção é usada para programar backups diários. Introduza 1 se pretender efetuar uma cópia de segurança diária. Quando essa opção estiver marcada, você deve indicar a hora em que o backup deve ser iniciado.

  • A cada X semana(s), dia em X: essa opção é usada para programar backups semanais. Digite 1 se quiser realizar o backup 1 vez por semana. Digite 1 se quiser realizar o backup 1 vez por semana. Enter 1 if you want to perform a weekly backup. Por exemplo, você pode usar essa opção para definir dois backups semanais: um às quartas-feiras e outro às sextas-feiras.

  • A cada X mês(es), dia X às X: essa opção é usada para programar backups mensais. Digite 1 se quiser realizar uma cópia de segurança mensal. Digite 1 se quiser realizar uma cópia de segurança mensal.

  • A cada X MB: essa opção é usada para programar backups com base no tamanho do arquivo de registro de solicitações atual. Um backup é acionado automaticamente quando o arquivo atinge o tamanho definido. Pode definir um limite de tamanho de 1, 10, 100 ou 1000 MB.

No caso de backups programados, se o servidor Web não foi iniciado quando o backup estava programado para ocorrer, na próxima inicialização o 4D considera o backup como falho e aplica as configurações apropriadas, definidas nas Propriedades.

Serviços Web

As opções dessa guia são usadas para ativar e configurar os serviços da Web para o projeto 4D, tanto para a publicação (lado do servidor) quanto para a assinatura (lado do cliente).

Para obter mais informações sobre o suporte de serviços Web em 4D, consulte o capítulo Publicação e uso de serviços Web.

Servidor

Essa área contém várias opções relacionadas ao uso de 4D como um "servidor" de serviços da Web, ou seja, a publicação de métodos projeto na forma de serviços Web.

  • Autorizar peticiones de servicios web: esta opção permite que você inicialize a publicação de Serviços Web. Se essa opção não tiver sido marcada, o 4D recusará solicitações SOAP e não gerará um WSDL, mesmo que os métodos tenham o atributo Publicado no WSDL. Quando essa opção está marcada, 4D cria o arquivo WSDL.
  • Nome do Serviço Web: esta área permite que você altere o "nome genérico" do Serviço Web. Esse nome é usado para diferenciar os serviços no nível do servidor SOAP (quando o servidor publica vários serviços Web diferentes), bem como nos diretórios de serviços Web. Por padrão, 4D usa o nome A_WebService.
  • Espaço de nome dos serviços web: essa área é usada para alterar o namespace dos serviços da Web publicados por 4D. Cada serviço Web publicado na Internet deve ser único. A singularidade dos nomes dos Serviços Web é assegurada pelo uso de namespaces XML. Um namespace é uma cadeia de caracteres arbitrária usada para identificar um conjunto de tags XML de forma exclusiva. Normalmente, o namespace começa com a URL da empresa (http://mycompany.com/mynamespace). Nesse caso, não é indispensável ter algo em particular no URL indicado; o que importa é que a cadeia de caracteres usada seja exclusiva. Por padrão, o 4D usa o seguinte namespace: http://www.4d.com/namespace/default.

Em conformidade com o padrão XML para nomes de etiquetas, as cadeias de caracteres usadas não devem conter espaços nem começar com um número. Além disso, para evitar qualquer risco de incompatibilidade, recomendamos que você não use nenhum caractere estendido (como caracteres acentuados).

Cliente

Essa área contém várias opções relacionadas ao uso de 4D como um "cliente" de serviços Web, ou seja, a assinatura de serviços publicados na rede.

  • Prefixo dos métodos criados pelo assistente: esta área permite que você altere o prefixo adicionado automaticamente por 4D ao nome dos métodos proxy gerados pelo Assistente de Serviços Web. Os métodos do projeto de proxy formam um link entre a aplicação 4D e o servidor de Serviços Web. Por padrão, 4D usa o prefixo "proxy_".

Funcionalidades Web

Essa página contém as opções usadas para ativar e controlar recursos atacantes da Web, como o servidor REST.

Publicação

Expor como servidor REST

Inicia e pára o servidor REST. Ver Configuração do servidor REST.

Acesso

Essa opção específica um grupo de usuários 4D que está autorizado a estabelecer o link para o banco de dados 4D usando solicitações REST. Consulte Configuração do acesso REST.

Web Studio

Ativar o acesso ao estúdio Web

Ativa o acesso geral ao Web studio. Continua a ser necessário configurá-lo em cada nível de projeto.