Definir cookie
Define o um cookie no navegador do usuário para a aplicação corrente.
| Nota | ||
|---|---|---|
| ||
Os blocos de Definir Cookie, tanto cliente como servidor, criam o cookie no mesmo lugar: navegador do usuário, por isso um sobrescreve o outro se a chave for a mesma. |
Parâmetros de Entrada
Figura 1 - Bloco Definir Cookie
| Nota |
|---|
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. |
| Informações |
|---|
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
Valordo 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
Tempode expiração do cookie para o intervalo definido
Compatibilidade
Servidor
Exemplo
Na função abaixo (Figura 1), a variável "item" recebe o bloco Definir Cookie com os atributos Chave, Valor, Unidade de medida e Expiração.
Figura 1 - Definindo o cookie
.
- Posição: 4
- Inglês: Expires
- Tipo: Inteiro / Integer
- Exemplo: 10
| Âncora | ||||
|---|---|---|---|---|
|
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"
| Âncora | ||||
|---|---|---|---|---|
|
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
Em seguida, pode-sevisualizar o cookie criado na aba Application (Figura 2.1) das ferramentas de
Desenvolvedordesenvolvedor 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
| Índice |
|---|
Sobre Cookie
Os cookies são arquivos criados pelos sites que o usuário visita e são salvos no computador dele. A principal utilidade do cookie é fornecer informações que deixam a navegação personalizada permitindo, por exemplo, a recuperação de algo que foi digitado antes, lembrar que um usuário está logado em um site, registrar os sites que foram acessado e até mesmo as informações pesquisadas.
Quando os cookies são utilizados para coletar dados pessoais, conforme a LGPD (Lei Geral de Proteção de Dados), eles devem sem autorizados pelo usuário.
Sobre Unidade de medida
Representa a unidade de medida do tempo a ser definido até a expiração do cookie, conforme os valores (Figura 3) abaixo:
- Segundos;
- Minutos;
- Horas;
- Dias.