/
Definir Cookie ( Servidor ) / Set Cookie ( Server )

Definir Cookie ( Servidor ) / Set Cookie ( Server )

Define um cookie no navegador do usuário para a aplicação corrente. 

 

Figura 1 - Bloco Definir Cookie

Os parâmetros Apenas Http e Seguro foram incorporados ao bloco a partir da versão 2.9.6-SP.28. Em projetos anteriores a essa versão, esses parâmetros serão por padrão definidos como "false". Para utilizar o bloco atualizado, será necessário arrastá-lo novamente da categoria Util para a área no Editor de Bloco de programação.

Também é possível definir os cookies a partir do bloco cliente: Definir Cookies (cliente). 

Compatibilidade

  • Bloco servidor: cronapi.util.Operations.setCookie()

Retorno

Bloco sem retorno.

Parâmetros

Chave

Chave do cookie a ser criado.

  • Posição: 1

  • Inglês: Key

  • Tipo: Texto / String

  • Exemplo: "CookieServer"

Valor

Valor do cookie a ser criado.

  • Posição: 2

  • Inglês: Value

  • Tipo: Texto / String

  • Exemplo: "CronappServer"

Unidade de medida

Unidade de medida de tempo passada como parâmetro.

  • Posição: 3

  • Inglês: Measurement unit

  • Tipo: Data e Hora / Date and Hour

  • Exemplo: Minutos

  • Opções:

    • Segundos: define o tempo de expiração do cookie em segundos.

    • Minutos: define o tempo de expiração do cookie em minutos.

    • Horas: define o tempo de expiração do cookie em horas.

    • Dias: define o tempo de expiração do cookie em dias.

Expiração

Define o tempo de expiração do cookie para o intervalo definido.

  • Posição: 4

  • Inglês: Expires

  • Tipo: Inteiro / Integer

  • Exemplo: 10

Apenas Http

Determina se um cookie é acessível exclusivamente pelo servidor, impedindo que scripts JavaScript tenham acesso aos dados armazenados no cookie, tornando-os mais protegidos. Para mais detalhes, consulte a documentação de referência.

  • Posição: 5

  • Inglês: Only Http

  • Tipo: Lógico / Boolean

  • Exemplo: "Sim"

Seguro

Define se o cookie deve ser transmitido apenas por meio de uma conexão segura (HTTPS). Para mais detalhes, consulte a documentação de referência.

  • Posição: 6

  • Inglês: Secure

  • Tipo: Lógico / Boolean

  • Exemplo: "Sim"

Exemplo

Na função da figura abaixo, definimos o nome do cookie como "CookieServer", cujo valor é "CronappServer", com um tempo de expiração de 20 segundos. Os parâmetros Apenas Http e Seguro estão definidos como "Sim".

Figura 2 - Função de definição de cookie

Podemos visualizar o cookie criado na aba Application (Figura 2.1) das ferramentas de desenvolvedor do navegador. Observe que os parâmetros HttpOnly e Secure estão marcados com o valor "check" (destaque 1), indicando que foram definidos como verdadeiro no bloco.

 

Figura 2.1 - Cookie criado no navegador do usuário

Nesta página