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