Configuración de ContextHub configuring-contexthub
ContextHub es un marco de trabajo para almacenar, manipular y presentar datos de contexto. Para obtener más información sobre ContextHub, consulte la documentación para desarrolladores. ContextHub reemplaza a Client Context en la IU táctil.
Configure las variables ContextHub para controlar si aparece en el modo de vista previa, crear tiendas de ContextHub y añadir módulos de interfaz de usuario mediante la interfaz de usuario táctil optimizada.
Desactivación de ContextHub disabling-contexthub
AEM De forma predeterminada, ContextHub está habilitado en una instalación de. ContextHub se puede deshabilitar para evitar que se cargue js/css y se inicialice.
- Utilice el CRXDE Lite para establecer la propiedad
disabled
hasta true bajo/libs/settings/cloudsettings/legacy/contexthub
/etc/cloudsettings
hasta:/libs/settings/cloudsettings
/conf/global/settings/cloudsettings
/conf/<tenant>/settings/cloudsettings
Mostrar y ocultar la interfaz de usuario de ContextHub showing-and-hiding-the-contexthub-ui
Configure el servicio OSGi de Adobe Granite ContextHub para mostrar u ocultar el IU de ContextHub en sus páginas. El PID de este servicio es com.adobe.granite.contexthub.impl.ContextHubImpl.
Para configurar el servicio, puede usar el complemento Consola web o use un Nodo JCR en el repositorio:
- Consola web: Para mostrar la interfaz de usuario, seleccione la propiedad Mostrar IU. Para ocultar la interfaz de usuario, borre la propiedad Ocultar interfaz de usuario.
- Nodo JCR: Para mostrar la interfaz de usuario, establezca el valor booleano
com.adobe.granite.contexthub.show_ui
propiedad atrue
. Para ocultar la interfaz de usuario, establezca la propiedad enfalse
.
AEM Al mostrar la interfaz de usuario de ContextHub, solo aparece en las páginas de instancias de autor de la. La interfaz de usuario no aparece en las páginas de instancias de publicación.
Adición de modos y módulos de IU de ContextHub adding-contexthub-ui-modes-and-modules
Configure los modos y módulos de interfaz de usuario que aparecen en la barra de herramientas de ContextHub en el modo de vista previa:
- Modos de IU: grupos de módulos relacionados
- Módulos: widgets que exponen datos de contexto de un almacén y permiten a los autores manipular el contexto
Los modos de interfaz de usuario aparecen como una serie de iconos en la parte izquierda de la barra de herramientas. Cuando se seleccionan, los módulos de un modo de interfaz de usuario aparecen a la derecha.
Los iconos son referencias de Biblioteca de iconos de Coral UI.
Adición de un modo de IU adding-a-ui-mode
Añada un modo de interfaz de usuario para agrupar módulos de ContextHub relacionados. Al crear el modo de IU, se indica el título y el icono que aparecen en la barra de herramientas de ContextHub.
-
En el carril del Experience Manager, haga clic en Herramientas > Sitios > Context Hub.
-
Haga clic en el contenedor de configuración predeterminado.
-
Haga clic en Configuración de ContextHub.
-
Haga clic en el botón Crear y, a continuación, en Modo de IU de Context Hub.
-
Proporcione valores para las siguientes propiedades:
- Título del modo de IU: título que identifica el modo de IU
- Icono de modo: el selector para Icono de Coral UI para utilizar, por ejemplo,
coral-Icon--user
- Habilitado: seleccione esta opción para mostrar el modo de IU en la barra de herramientas de ContextHub
-
Haga clic en Guardar.
Adición de un módulo de IU adding-a-ui-module
Agregue un módulo de IU de ContextHub a un modo de IU para que aparezca en la barra de herramientas de ContextHub para obtener una vista previa del contenido de la página. Al agregar un módulo de IU, se crea una instancia de un tipo de módulo registrado con ContextHub. Para agregar un módulo de interfaz de usuario, debe conocer el nombre del tipo de módulo asociado.
AEM proporciona un tipo de módulo de interfaz de usuario base, así como varios tipos de módulos de interfaz de usuario de ejemplo en los que puede basar un módulo de interfaz de usuario. En la tabla siguiente se proporciona una breve descripción de cada uno. Para obtener información sobre el desarrollo de un módulo de IU personalizado, consulte Creación de módulos de IU de ContextHub.
Las propiedades del módulo de interfaz de usuario incluyen una configuración detallada en la que puede proporcionar valores para propiedades específicas del módulo. Proporcione la configuración detallada en formato JSON. La columna Tipo de módulo de la tabla proporciona vínculos a información sobre el código JSON necesario para cada tipo de módulo de interfaz de usuario.
-
En el carril del Experience Manager, haga clic en Herramientas > Sitios > ContextHub.
-
Haga clic en el contenedor de configuración al que desee agregar un módulo de interfaz de usuario.
-
Haga clic o escriba la Configuración de ContextHub a la que desea agregar el módulo de interfaz de usuario.
-
Haga clic en el modo de interfaz de usuario al que está agregando el módulo de interfaz de usuario.
-
Haga clic en el botón Crear y, a continuación, en Módulo de IU de ContextHub (genérico).
-
Proporcione valores para las siguientes propiedades:
- Título del módulo de IU: un título que identifica el módulo de IU
- Tipo de módulo: el tipo de módulo
- Habilitado: seleccione esta opción para mostrar el módulo de IU en la barra de herramientas de ContextHub
-
(Opcional) Para anular la configuración de almacén predeterminada, introduzca un objeto JSON para configurar el módulo de interfaz de usuario.
-
Haga clic en Guardar.
Creación de una tienda de ContextHub creating-a-contexthub-store
Cree un almacén de ContextHub para conservar los datos de usuario y acceder a ellos según sea necesario. Las tiendas de ContextHub se basan en candidatos de tiendas registradas. Cuando cree el almacén, necesitará el valor del storeType con el que se registró el candidato del almacén. (Consulte Crear candidatos de tienda personalizados.)
Configuración detallada de la tienda detailed-store-configuration
Al configurar un almacén, la propiedad Configuración detallada permite proporcionar valores para las propiedades específicas del almacén. El valor se basa en config
parámetro del almacén init
función. Por lo tanto, si debe proporcionar este valor y el formato del valor dependen del almacén.
El valor de la propiedad Detail Configuration es un config
en formato JSON.
Candidatos de tienda de muestra sample-store-candidates
AEM proporciona los siguientes candidatos de tienda de muestra en los que puede basar una tienda.
-
En el carril del Experience Manager, haga clic en Herramientas > Sitios > ContextHub.
-
Haga clic en el contenedor de configuración predeterminado.
-
Haga clic en Configuración de Contexthub
-
Para agregar una tienda, haga clic en el icono Crear y, a continuación, haga clic en Configuración de tienda de ContextHub.
-
Proporcione valores para las propiedades de configuración básicas y haga clic en Siguiente:
- Título de configuración: El título que identifica la tienda
- Tipo de tienda: Valor de la propiedad storeType del candidato de almacén en el que se va a basar el almacén
- Requerido: Seleccionar
- Habilitado: Seleccione para activar la tienda
-
(Opcional) Para anular la configuración de almacén predeterminada, introduzca un objeto JSON en el cuadro Configuración detallada (JSON).
-
Haga clic en Guardar.
Ejemplo: Uso de un servicio JSONP example-using-a-jsonp-service
Este ejemplo ilustra cómo configurar un almacén y mostrar los datos en un módulo de interfaz de usuario. En este ejemplo, el servicio MD5 del sitio jsontest.com se utiliza como fuente de datos para una tienda. El servicio devuelve el código hash MD5 de una cadena determinada, en formato JSON.
Se configura un almacén contexthub.generic-jsonp para que almacene datos para la llamada de servicio https://md5.jsontest.com/?text=%22text%20to%20md5%22
. El servicio devuelve los siguientes datos, que se muestran en un módulo de interfaz de usuario:
{
"md5": "919a56ab62b6d5e1219fe1d95248a2c5",
"original": "\"text to md5\""
}
Crear un almacén de contexthub.generic-jsonp creating-a-contexthub-generic-jsonp-store
El candidato del almacén de muestra contexthub.generic-jsonp permite recuperar datos de un servicio JSONP o un servicio web que devuelve datos JSON. Para este candidato a tienda, utilice la configuración de tienda para proporcionar detalles acerca del servicio JSONP que se va a utilizar.
El init función del ContextHub.Store.JSONPStore
La clase JavaScript define una config
objeto que inicializa este candidato de almacén. El config
el objeto contiene un service
que incluye detalles sobre el servicio JSONP. Para configurar el almacén, proporcione el service
en formato JSON como valor de la propiedad Detail Configuration.
Para guardar datos del servicio MD5 del sitio jsontest.com, utilice el procedimiento de Creación de una tienda de ContextHub mediante las siguientes propiedades:
-
Título de configuración: md5
-
Tipo de tienda: contexthub.generic-jsonp
-
Requerido: Seleccionar
-
Habilitado: Seleccionar
-
Configuración detallada (JSON):
code language-xml { "service": { "jsonp": false, "timeout": 1000, "ttl": 1800000, "secure": false, "host": "md5.jsontest.com", "port": 80, "params":{ "text":"text to md5" } } }
Adición de un módulo de IU para los datos md5 adding-a-ui-module-for-the-md-data
Agregue un módulo de interfaz de usuario a la barra de herramientas de ContextHub para mostrar los datos almacenados en el almacén md5 de ejemplo. En este ejemplo, el módulo contexthub.base se utiliza para producir el siguiente módulo de interfaz de usuario:
Utilice el procedimiento de Adición de un módulo de IU para agregar el módulo de IU a un modo de IU existente, como el modo de IU de Perona de ejemplo. Para el módulo de interfaz de usuario, utilice los siguientes valores de propiedad:
-
Título de módulo de IU: MD5
-
Tipo de módulo: contexthub.base
-
Configuración detallada (JSON):
code language-xml { "icon": "coral-Icon--data", "title": "MD5 Converstion", "storeMapping": { "md5": "md5" }, "template": "<p> {{md5.original}}</p>; <p>{{md5.md5}}</p>" }
Depuración de ContextHub debugging-contexthub
Se puede habilitar un modo de depuración para ContextHub para permitir la resolución de problemas. El modo de depuración se puede habilitar mediante la configuración de ContextHub o mediante CRXDE.
Mediante la configuración via-the-configuration
Edite la configuración de ContextHub y marque la opción Depurar
- En el carril, haga clic en Herramientas > Sitios > ContextHub
- Haga clic en el valor predeterminado Contenedor de configuración
- Seleccione el Configuración de ContextHub y haga clic en Editar elemento seleccionado
- Clic Depurar y haga clic en Guardar
Mediante CRXDE via-crxde
Utilice el CRXDE Lite para establecer la propiedad debug
hasta true en:
/conf/global/settings/cloudsettings
o/conf/<tenant>/settings/cloudsettings
debug property
es /libs/settings/cloudsettings/legacy/contexthub
.Modo silencioso silent-mode
El modo silencioso suprime toda la información de depuración. A diferencia de la opción de depuración normal, que se puede establecer de forma independiente para cada configuración de ContextHub, el modo silencioso es una configuración global que tiene prioridad sobre cualquier configuración de depuración en el nivel de configuración de ContextHub.
Esto resulta útil en la instancia de publicación, donde no desea depurar ninguna información. Como es una configuración global, se habilita mediante OSGi.
- Abra el Configuración de la consola web Adobe Experience Manager en
http://<host>:<port>/system/console/configMgr
- Buscar por Adobe Granite ContextHub
- Haga clic en la configuración Adobe Granite ContextHub para editar sus propiedades
- Marque la opción Modo silencioso y haga clic en Guardar
Recuperación de las configuraciones de ContextHub después de actualizar recovering-contexthub-configurations-after-upgrading
Cuando un AEM actualizar a la Cuando se realiza, se realiza una copia de seguridad de las configuraciones de ContextHub y se almacenan en una ubicación segura. Durante la actualización, se instalan las configuraciones predeterminadas de ContextHub, sustituyendo las configuraciones existentes. La copia de seguridad es necesaria para conservar los cambios o adiciones realizados.
Las configuraciones de ContextHub se almacenan en una carpeta denominada contexthub
en los siguientes nodos:
/conf/global/settings/cloudsettings
/conf/<tenant>/settings/cloudsettings
Después de una actualización, la copia de seguridad se almacena en una carpeta denominada contexthub
debajo de un nodo denominado:
/conf/global/settings/cloudsettings/default-pre-upgrade_yyyymmdd_xxxxxxx
o/conf/<tenant>/settings/cloudsettings/default-pre-upgrade_yyyymmdd_xxxxxxx
El yyyymmdd
parte del nombre del nodo es la fecha en la que se realizó la actualización.
Para recuperar las configuraciones de ContextHub, utilice CRXDE Lite para copiar los nodos que representan sus tiendas, modos de interfaz de usuario y módulos de interfaz de usuario desde debajo de default-pre-upgrade_yyyymmdd_xxxxxx
nodo a continuación:
/conf/global/settings/cloudsettings
o/conf/<tenant>/settings/cloudsettings