Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: DI-2168

Definir Cookie

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

Nota
titleObservação

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


Image Added

Figura 1 - Bloco Definir Cookie


Informações

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

Compatibilidade

  • Bloco cliente: cronapi.util.setCookie()

Retorno

Bloco sem retorno.

Parâmetros

Chave

NomeTipoDocChaveTexto

Chave do cookie a ser criado.

Valor
  • Posição: 1
  • Inglês: Key
  • Tipo: Texto / String
  • Exemplo: "cookie1"

Valor

Texto

Valor do cookie a ser criado.

  • Posição: 2
  • Inglês: Value
  • Tipo: Texto / String
  • Exemplo: "Cronapp"

Unidade de medida

Data e hora

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:
      ExpiraçãoInteiro
        • 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

      Tempo

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

      Compatibilidade

      Image Removed Cliente

      • Posição: 4
      • Inglês: Expires
      • Tipo: Inteiro / Integer
      • Exemplo: 10

      Exemplo

      Na função da figura abaixo (Figura 1), a variável "item" recebe o bloco Definir Cookie com os atributos Chave, Valor, Unidade de medida e Expiração.

      Image Removed

      Figura 1 - Definindo o cookie

      , definimos o nome do cookie como "meuCookie", cujo valor é "Cronapp" e tem um tempo de expiração de 20 segundos.


      Image Added

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


      Podemos

      Em seguida, pode-se

      visualizar o cookie criado na aba Application(Figura 2.1) das ferramentas de desenvolvedor do navegador.

      Image Removed


      Image Added

      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 acessados 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.

    Image Removed

    Figura 3  - Unidade de medida de tempo