Show Menu
TÓPICOS×

Adicionando o ContextHub a páginas e acessando lojas

Adicione o ContextHub às suas páginas para ativar os recursos do ContextHub e para vincular às bibliotecas do ContextHub Javascript
A API Javascript do ContextHub fornece acesso aos dados de contexto que o ContextHub gerencia. Esta página descreve resumidamente os principais recursos da API para acessar e manipular dados de contexto. Siga os links para a documentação de referência da API para ver informações detalhadas e exemplos de código.

Adicionar o ContextHub a um componente de página

Para ativar os recursos do ContextHub e para vincular às bibliotecas do ContextHub Javascript, inclua o componente contexthub na head seção da página. O código JSP do componente de página se parece com o seguinte exemplo:
<head>
   <sling:include path="contexthub" resourceType="granite/contexthub/components/contexthub" />
</head>

Observe que também é necessário configurar se a barra de ferramentas do ContextHub aparece no modo de Visualização. Consulte Mostrar e ocultar a interface do usuário do ContextHub.

Sobre as Lojas do ContextHub

Use os armazenamentos do ContextHub para persistir nos dados de contexto. O ContextHub fornece os seguintes tipos de lojas que formam a base de todos os tipos de lojas:
Todos os tipos de armazenamento são extensões da ContextHub.Store.Core classe. Para obter informações sobre como criar um novo tipo de armazenamento, consulte Criação de armazenamentos personalizados. Para obter informações sobre tipos de armazenamento de amostra, consulte Amostra de candidatos à loja do ContextHub.

Modos de persistência

Os armazenamentos do Context Hub usam um dos seguintes modos de persistência:
  • ​Local: Usa HTML5 localStorage para persistir os dados. O armazenamento local é persistente no navegador entre sessões.
  • ​Sessão: Usa HTML5 sessionStorage para persistir os dados. O armazenamento da sessão é mantido durante a sessão do navegador e está disponível para todas as janelas do navegador.
  • ​Cookie: Usa o suporte nativo do navegador a cookies para armazenamento de dados. Os dados do cookie são enviados para e do servidor em solicitações HTTP.
  • ​Window.name: Usa a propriedade window.name para persistir nos dados.
  • ​Memória: Usa um objeto Javascript para persistir os dados.
Por padrão, o Context Hub usa o modo de persistência Local. Se o navegador não suportar ou permitir HTML5 localStorage, a persistência da sessão será usada. Se o navegador não oferecer suporte ou permitir o HTML5 sessionStorage, a persistência de Window.name será usada.

Armazenamento de dados

Internamente, armazene formulários de dados em uma estrutura em árvore, permitindo que valores sejam adicionados como tipos primários ou objetos complexos. Quando objetos complexos são adicionados a armazenamentos, as propriedades de objetos formam ramificações na árvore de dados. Por exemplo, o seguinte objeto complexo é adicionado a uma loja vazia com o nome de local:
Object {
   number: 321,
   data: {
      city: "Basel",
      country: "Switzerland",
      details: {
         population: 173330,
         elevation: 260
      }
   }
}

A estrutura em árvore dos dados de armazenamento pode ser conceitualizada da seguinte maneira:
/
|- number
|- data
      |- city
      |- country
      |- details
            |- population
            |- elevation

A estrutura em árvore define itens de dados no armazenamento como pares de chave/valor. No exemplo acima, a chave /number corresponde ao valor 321 , e a chave /data/country corresponde ao valor Switzerland .

Manipulação de objetos

O ContextHub fornece a ContextHub.Utils.JSON.tree classe para manipular objetos Javascript. Use as funções dessa classe para manipular objetos Javascript antes de adicioná-los a uma loja ou depois de obtê-los de uma loja.
Além disso, a ContextHub.Utils.JSON classe fornece funções para serialização de objetos em strings e desserialização de strings em objetos. Use essa classe para manipular dados JSON para suportar navegadores que não incluem nativamente as funções JSON.parse e JSON.stringify .

Interação com as armazenamentos do ContextHub

Use o objeto ContextHub Javascript para obter uma loja como um objeto Javascript. Depois de obter o objeto store, é possível manipular os dados que ele contém. Use a função getAllStores ou a getStore função para obter a loja.

Acessar dados da loja

A classe ContexHub.Store.Core Javascript define várias funções para interagir com dados de armazenamento. As seguintes funções armazenam e recuperam vários itens de dados contidos em objetos:
Os itens de dados individuais são armazenados como um conjunto de pares de chave/valor. Para armazenar e recuperar valores, especifique a chave correspondente:
Observe que os candidatos a armazenamento personalizado podem definir funções adicionais que fornecem acesso aos dados de armazenamento.
Por padrão, o ContextHub não está ciente do logon atualmente usado em servidores de publicação e esses usuários são considerados pelo ContextHub como "Anônimos".
Você pode tornar o ContextHub ciente dos usuários conectados carregando o repositório de perfis conforme implementado no site de referência We.Retail. Consulte o código relevante no GitHub aqui .

Eventos do ContextHub

O ContextHub inclui uma estrutura de evento que permite que você reaja automaticamente para armazenar eventos. Cada objeto store contém um ContextHub.Utils.Eventing objeto que está disponível como eventing propriedade do armazenamento. Use a função on ou once para vincular uma função Javascript a um evento de loja.

Uso do Context Hub para Manipular Cookies

A API Javascript do Context Hub fornece suporte entre navegadores para lidar com cookies de navegadores. O ContextHub.Utils.Cookie namespace define várias funções para criar, manipular e excluir cookies.

Determinando segmentos resolvidos do ContextHub

O mecanismo de segmento ContextHub permite determinar quais segmentos registrados são resolvidos no contexto atual. Use a função getResolvedSegments da ContextHub.SegmentEngine.SegmentManager classe para recuperar segmentos resolvidos. Em seguida, use a função getName ou getPath da ContextHub.SegmentEngine.Segment classe para testar um segmento.

Segmentos instalados

Os segmentos do ContextHub são instalados abaixo do /conf/we-retail/settings/wcm/segments nó.
  • feminino
  • fêmea acima de 30
  • fêmea com menos de 30 anos
  • masculino
  • masculino-acima de 30
  • macho-menor-30
  • order-value-75-to-100
  • order-value-over-100
  • acima de 30
  • verão
  • fêmea de verão
  • verão-fêmea com mais de 30
  • verão-fêmea com menos de 30 anos
  • homem do verão
  • verão-homem-acima-30
  • verão-homem-menor-30
  • Menor de 30
  • inverno
  • fêmea de inverno
  • inverno-fêmea-acima de 30
  • inverno-fêmea com menos de 30 anos
  • macho de inverno
  • inverno-homem-acima-30
  • inverno-macho-menor de 20
As regras usadas para resolver esses segmentos são resumidas da seguinte forma:
  • Feminino ou masculino é determinado a partir do item de gender dados da loja de perfis .
  • A idade é determinada a partir do item de dados de idade do repositório de perfis.
  • A estação é determinada a partir do item de dados de latitude do repositório de geolocalização e do item de dados de mês do repositório de informações de surferências.
Os segmentos instalados são fornecidos como configurações de referência para ajudá-lo a criar sua própria configuração dedicada ao seu projeto e, como tal, não devem ser usados diretamente.

Registrando mensagens de depuração para o ContextHub

Configure o serviço OSGi do Adobe Granite ContextHub (PID = com.adobe.granite.contexthub.impl.ContextHubImpl ) para registrar mensagens de Depuração detalhadas que são úteis ao desenvolver.
Para configurar o serviço, você pode usar o Console da Web ou usar um nó JCR no repositório :
  • Console da Web: Para registrar mensagens de Depuração, selecione a propriedade Depuração.
  • Nó JCR: Para registrar mensagens de Depuração, defina a com.adobe.granite.contexthub.debug propriedade booleana como true .

Consulte uma visão geral da estrutura do ContextHub

O ContextHub fornece uma página de diagnósticos onde você pode ver uma visão geral da estrutura do ContextHub.