Implementación de un manifiesto personalizado – Asistencia

Puede utilizar este artículo para implementar un manifiesto personalizado para los usuarios de Rainbow. Descubrirá la diferencia entre la implementación a través de la consola de administración y la importación local, cómo funciona la prioridad de implementación y cómo eliminar un manifiesto cuando sea necesario.

Descripción general

Un «custo-manifest» es un archivo JSON que personaliza la interfaz de Rainbow para sus usuarios: botones de acción, llamadas a la API, aplicaciones integradas, widgets… Una vez implementado, se aplica automáticamente cada vez que se inicia el cliente de Rainbow.

Requisitos de licencia: Las extensiones del manifiesto personalizado (botones de acción, llamadas a la API, aplicaciones integradas, widgets) requieren una licencia Business o superior. Sin una licencia Business, solo son disponibles los eventos de PBX (supervisión de llamadas entrantes y salientes).

Existen dos modos de implementación:

Modo	Quién	Ámbito	Prioridad
Consola de administración	Usted, desde la consola de administración	Todos los clientes de usuario (Web + Escritorio, todas las sesiones)	Tiene prioridad
Importación local	Usuario final	Únicamente el equipo o el navegador utilizado para la importación	Se anula mediante la implementación desde la consola de administración

Nota: La implementación por parte del administrador siempre tiene prioridad. Si se asigna un manifiesto a través de la consola, este sustituye a cualquier importación local y la opción «Importar/Exportar» desaparece del cliente Rainbow.

Desactivación de la importación local: Puede desactivar la opción «Importar/Exportar» para sus usuarios a través de los perfiles: Empresa → Perfiles → [perfil] → Permisos → Manifiesto personalizado. Una vez desactivada, la opción desaparece del menú del cliente y solo se aplica el manifiesto asignado desde la consola de administración.

Implementación a través de la consola de administración

Este es el método recomendado para el entorno de producción. Se carga el manifiesto una sola vez y, a continuación, Rainbow lo aplica automáticamente a todos los usuarios pertinentes.

Pantalla de configuración

El manifiesto y los dominios de confianza se configuran en el mismo lugar:

Empresa → Información → Personalización

Consola de Rainbow — Empresa → Información → Personalización

Importación a la consola

Vaya a Empresa → Información → Personalización → Custo-manifest
Haga clic en «Importar» y seleccione el archivo .json o .zip
Compruebe que el manifiesto aparece en la lista

Asignar a los usuarios

Existen dos métodos de asignación:

Por usuario individual

Vaya a Miembro → Información → Manifiesto personalizado
Seleccione el manifiesto que desee aplicar

Por perfil de usuario

Vaya a Empresa → Perfiles
Edite el perfil → sección «Manifiesto de cliente»
Seleccione el manifiesto; se aplicará a todos los miembros del perfil

Mediante aprovisionamiento masivo (importación CSV o sincronización LDAP)

La asignación del «custo-manifest» puede incluirse en una importación masiva de CSV o en la sincronización LDAP
El campo correspondiente en el archivo CSV es «AppCustomisationTemplate»
En LDAP, el atributo seleccionado es también «AppCustomisationTemplate»

Nota: Este método resulta especialmente adecuado para asignar un manifiesto a un gran número de usuarios en una sola operación.

Aplicación por parte del cliente

El manifiesto implementado se descarga automáticamente la próxima vez que se inicie el cliente. No es necesaria ninguna acción por parte de sus usuarios.

Web: el manifiesto se carga al inicio de cada sesión. Por lo tanto, una actualización surtirá efecto en el siguiente inicio de sesión.

Ordenador de sobremesa: el manifiesto se descarga al iniciar la aplicación.

Dominios de confianza

Antes de la implementación, compruebe que todos los orígenes de URL a los que se hace referencia en el manifiesto estén declarados en:

Empresa → Información → Personalización → Dominios de Custo-manifest

Sin esta declaración, se muestra una advertencia en el momento de la carga y las extensiones fallan de forma silenciosa. Consulte el artículo «Seguridad de red y dominios de confianza para extensiones de manifiesto personalizado».

Actualización de un manifiesto implementado

Modifique el manifiesto

Edite el archivo JSON localmente
En la consola: Empresa → Personalización → Custo-manifest → Reemplazar
Importe la nueva versión

La versión anterior queda sustituida. Los clientes la descargarán la próxima vez que inicien el sistema.

Nota: No existe un sistema de versiones automático en la consola de Rainbow. Conserve las versiones anteriores localmente para poder revertir los cambios si fuera necesario.

Forzar la recarga (Web)

En Rainbow Web, al borrar la caché del navegador o al cerrar sesión y volver a iniciarla, se fuerza la recarga del manifiesto.

Eliminar el manifiesto

Para eliminar el manifiesto de uno de sus usuarios: vaya a Miembro → Información → Manifiesto personalizado y seleccione «Sin manifiesto». El cliente volverá a su estado predeterminado la próxima vez que se inicie.

Importación local (desarrollo y pruebas)

La importación local permite a un usuario cargar un manifiesto directamente en su cliente Rainbow sin pasar por la consola de administración. Se recomienda para la fase de desarrollo y las pruebas previas a la implementación.

Ámbito limitado: un manifiesto importado localmente solo se aplica al equipo o al navegador utilizado para la importación. No se transfiere al usuario a otras estaciones de trabajo o sesiones.

Importación en Rainbow Desktop

Abra Rainbow Desktop
Vaya a Configuración → Telefonía → Personalización
Haga clic en «Importar» y seleccione el archivo .json o .zip
El manifiesto se aplica de inmediato

Para obtener una plantilla de inicio: haga clic en «Exportar» antes de realizar cualquier importación; Rainbow generará un archivo de ejemplo que contiene todos los puntos de extensión compatibles.

Importación en Rainbow Web

La importación local en Rainbow Web sigue el mismo procedimiento que en la versión de escritorio (menú Ajustes → Personalización), pero se limita al navegador que se esté utilizando en ese momento.

Configuración heredada mediante la CLI

Procedimiento obsoleto: se recomienda la implementación mediante la consola de administración. La implementación centralizada tiene prioridad sobre este modo de configuración heredado de la versión de escritorio y resulta más fácil de gestionar.

Para integraciones más antiguas de Rainbow Desktop, se podía proporcionar un manifiesto en el momento de la instalación mediante la opción de configuración /Custom.

RainbowSetup.exe /Custom=C:\ruta\al\manifest.json

Cuando se utiliza este modo, la opción Importar/Exportar queda oculta para el usuario final. Si posteriormente un administrador asigna un manifiesto a través de la consola de administración de Rainbow, el manifiesto implementado de forma centralizada tendrá prioridad.

Problemas habituales

El manifiesto no se aplica

Causa probable	Cómo comprobarlo	Solución
El manifiesto no está asignado al usuario	Consola → Miembro → Manifiesto de cliente	Asigne el manifiesto
El cliente no se ha reiniciado	—	Pida al usuario que reinicie Rainbow
JSON no válido	Herramientas de desarrollador → Consola → errores durante la carga	Valide el JSON (herramienta en línea o Rainbow Generator)
Importación local desactivada por el administrador	Falta la opción de importación/exportación	Utilice la implementación del administrador

Aparece una advertencia al cargar el manifiesto

El manifiesto hace referencia a una URL cuyo origen no está declarado en los dominios de confianza.

Solución: declare el origen en Empresa → Personalización → Dominios de manifiestos personalizados.

Advertencia: descartar la advertencia no soluciona el problema; las extensiones afectadas fallarán de forma silenciosa en tiempo de ejecución.

Las extensiones no aparecen en el cliente

Causa probable	Solución
Se ha asignado el manifiesto, pero no se ha reiniciado el cliente	Reinicie Rainbow
El punto de extensión no es compatible con el cliente (Web frente a Escritorio)	Compruebe la compatibilidad de los puntos de extensión (Web/escritorio) en la documentación
Se ha alcanzado el número máximo de acciones (3 por punto de extensión)	Reduzca el número de acciones en el manifiesto
La importación local ha sido anulada por el manifiesto de administrador	Comportamiento esperado: el manifiesto de administrador tiene prioridad

La importación local no es posible (la opción aparece desactivada o no está disponible)

El administrador ha desactivado la importación local a través del perfil. Póngase en contacto con el administrador de Rainbow para obtener acceso o solicite la implementación a través de la consola.

Lista de comprobación para la implementación previa a la producción

JSON validado (sin errores de sintaxis, «version»: «2», «jsonType» presente)
Manifiesto probado mediante importación local en Rainbow Desktop y Web
Todos los orígenes de URL declarados en los dominios de Custo-manifest
Si hay recursos locales: archivo ZIP creado con el archivo «custo-manifest.json» en la raíz
Manifiesto asignado a los usuarios o perfiles correctos en la consola