Personalizar
Constructor del panel de tareas
Diseña el panel de tareas que tus usuarios abren desde la cinta de opciones — arrastra bloques a las pestañas, dale tu propia marca con colores y logo, y publica los cambios en cada libro abierto sin necesidad de un redespliegue.
7 min de lectura
El panel de tareas no es fijo. En Resources → Taskpane de cada entorno, un constructor de arrastrar y soltar te permite organizarlo en pestañas, rellenar cada pestaña con bloques y dar marca a todo el panel para que combine con tu producto — directamente en una vista previa en vivo que renderiza exactamente lo que Excel mostrará. Todo lo que construyes aquí viaja por el mismo canal de configuración en vivo que tus funciones y conexiones: guárdalo, y estará disponible en cada libro abierto sin un redespliegue.
Pestañas
Un diseño es una o más pestañas, cada una con una lista ordenada de bloques. Añade una pestaña, arrástrala para reordenarla, dale una etiqueta y elige un icono — un glifo curado o una imagen subida. Con una sola pestaña, Excel no muestra ninguna barra de pestañas; añade una segunda y la barra de pestañas aparece automáticamente.
Bloques
Construye cada pestaña arrastrando bloques desde la paleta a la vista previa en vivo, o haz clic para añadir uno. Cada bloque es editable in situ — haz doble clic en un bloque de texto para editar su contenido directamente en el lienzo.
| Field | Type | Description |
|---|---|---|
headingOptional | Encabezado | Un título de sección. Elige el nivel, la alineación y un color opcional. |
textOptional | Texto | Un párrafo con alineación, un tamaño de fuente curado y un color opcional. |
imageOptional | Imagen | Una imagen de la biblioteca de recursos de tu organización, con texto alternativo, alineación y ancho. |
calloutOptional | Nota destacada | Un cuadro de aviso tintado en uno de cuatro tonos — info, éxito, aviso o peligro. |
linkOptional | Botón de enlace | Un botón que abre una URL externa, con estilo primario, contorno o sutil — o mostrado como un mosaico compacto con icono para filas de acciones rápidas. |
dividerOptional | Separador | Una simple línea horizontal. |
spacerOptional | Espaciador | Espacio vertical — pequeño, mediano o grande. |
signinOptional | Inicio de sesión | La tarjeta de inicio de sesión vinculada al proveedor de autenticación de tu complemento — inerte cuando tu complemento es de acceso abierto. |
functionListOptional | Lista de funciones | Una lista con título de tus funciones publicadas; el usuario hace clic en una para insertarla. |
functionButtonOptional | Botón de función | Un botón que inserta una única función con un solo clic — solo se pueden asignar funciones sin parámetros obligatorios. Una función que necesita datos de entrada va detrás de un botón Abrir diálogo. También puede mostrarse como un mosaico compacto con icono; coloca mosaicos lado a lado en un bloque de columnas (2–4 columnas) para una fila de acciones rápidas. |
uploadRangeOptional | Subir rango | Un botón que lee el rango seleccionado por el usuario — o toda la tabla que lo rodea — y lo sube a través de una de tus funciones de escritura. Por defecto la primera fila pasa a ser los nombres de columna, y los rangos grandes se envían por trozos seguros de reintentar, de modo que volver a hacer clic tras un fallo parcial reemplaza en lugar de duplicar. |
functionResultOptional | Resultado de función | Ejecuta una función de lectura como el usuario que ha iniciado sesión y muestra el resultado como una tabla dentro del panel, nunca en la cuadrícula — «Mis subidas», «Compartido conmigo» y demás vistas por usuario cuando la conexión usa un modo de autenticación con token de usuario. Se ejecuta solo al abrirse el panel, ofrece un control de refresco y recibe una función, un título opcional y valores de argumento fijos. |
templateListOptional | Lista de plantillas | Una lista con título de tus plantillas de libro; un clic inserta todas las hojas. |
gridViewListOptional | Lista de tablas/PivotTables | Las tablas y PivotTables configuradas para este entorno; cada entrada desborda su función de origen y convierte el resultado en una Tabla o PivotTable real de Excel. |
sectionOptional | Sección | Una tarjeta que agrupa otros bloques, con un solo nivel de profundidad — una sección puede contener cualquier bloque salvo otra sección. |
La plantilla inicial usa algunos bloques más
La plantilla inicial integrada reproduce el panel de cuatro pestañas por defecto del agent, así que también usa un bloque explorador de funciones, un bloque de estado en vivo y un bloque de endpoints. No necesitas añadirlos tú mismo salvo que construyas un diseño desde cero — existen para que la plantilla inicial sea una copia fiel de la interfaz integrada del agent. El explorador de funciones puede alternativamente mostrarse como una lista plana — cada función como una fila con su propia insignia de icono a color — en lugar de grupos por módulo plegables.
Secciones
Una sección es una tarjeta que agrupa bloques — coloca un encabezado, algo de texto y un botón dentro de una para diferenciarla visualmente del resto de la pestaña. Las secciones tienen un solo nivel de profundidad: una sección puede contener cualquier otro bloque salvo otra sección.
Marca y tema
El panel Brand controla el aspecto de todo el panel de tareas, aplicado de forma consistente en cada pestaña:
| Field | Type | Description |
|---|---|---|
accentOptional | color | Acento de marca usado en botones, enlaces y resaltados. |
fontOptional | system | sans | serif | mono | Familia tipográfica base del panel. |
corner radiusOptional | sharp | rounded | round | Redondez de las esquinas de tarjetas, botones y campos. |
densityOptional | compact | cozy | roomy | Espaciado entre bloques. |
modeOptional | light | dark | inherit | Esquema de color; light es el valor por defecto para que la vista previa siempre coincida con Excel, e inherit sigue el propio tema del anfitrión Excel. |
backgroundOptional | color | gradient | image | Un color sólido, un degradado de dos colores con un ángulo curado, o una imagen subida. |
headerOptional | title, subtitle, logo, status | Una barra de marca opcional encima de las pestañas, con título, subtítulo, un punto de estado de conexión en vivo y un logo — una marca curada, una imagen subida o un monograma del título. |
Plantillas iniciales y el respaldo integrado
Cuando el panel de tareas de un entorno nunca se ha guardado, el constructor se abre con una plantilla inicial ya lista que reproduce el panel de cuatro pestañas integrado del agent (Functions, Templates, Status, Resources) — así empiezas a editar un panel de tareas real y funcional, no un lienzo en blanco. Usa "Start from template" para volver a una plantilla inicial, o copia el diseño guardado de otro entorno como tu borrador.
Sin diseño guardado, sin panel ausente
Si nunca guardas un diseño en un entorno, su agent recurre al mismo panel de cuatro pestañas integrado que siempre ha tenido — tus usuarios nunca se quedan con un panel de tareas en blanco.
Publicación
Guarda tu diseño y viajará en el siguiente snapshot de configuración del agent — el mismo canal en vivo que usan tus funciones y conexiones. No hay cambio de manifiesto ni redespliegue: cada panel de tareas que un usuario tenga abierto recoge el nuevo diseño la próxima vez que lo abra.
Botones de la cinta
Controles personalizados de la cinta que abren el panel de tareas, ejecutan una función o lanzan un diálogo.
Marca blanca
Sustituye cada marca de ConnXL por tu propio nombre, icono y marca.
Usar las funciones en Excel
Cómo se comportan el explorador de funciones y las plantillas del panel para tus usuarios finales.
Mutual TLS (mTLS)
El agent se autentica ante este backend inscribiéndose para obtener su propio certificado de cliente mTLS — no hay clave de API, ni token de portador que configurar en tiempo de ejecución, ni ningún modo de autenticación alternativo. Nunca tienes que crear ni manejar el certificado tú mismo; el agent genera su propia clave y la hace firmar durante la inscripción.
Botones de la cinta
Añade botones personalizados a la cinta de opciones de Excel que abran tu panel de tareas, ejecuten una de tus funciones o lancen un diálogo — colocados en una pestaña integrada o en tu propia pestaña con marca.