Personalizar
Construtor do painel de tarefas
Desenha o painel de tarefas que os teus utilizadores abrem a partir do friso — arrasta blocos para separadores, dá-lhe a tua marca com as tuas cores e logótipo, e publica alterações em cada livro aberto sem precisares de reimplementar.
7 min de leitura
O painel de tarefas não é fixo. Em Resources → Taskpane de cada ambiente, um construtor de arrastar e largar permite-te organizá-lo em separadores, preencher cada separador com blocos e dar marca a todo o painel para combinar com o teu produto — diretamente numa pré-visualização em direto que representa exatamente o que o Excel vai mostrar. Tudo o que constróis aqui viaja pelo mesmo canal de configuração em direto que as tuas funções e ligações: guarda-o, e fica disponível em cada livro aberto sem reimplementação.
Separadores
Um layout é um ou mais separadores, cada um com uma lista ordenada de blocos. Adiciona um separador, arrasta-o para o reordenar, dá-lhe uma etiqueta e escolhe um ícone — um glifo selecionado ou uma imagem carregada. Com um único separador, o Excel não mostra nenhuma barra de separadores; adiciona um segundo e a barra aparece automaticamente.
Blocos
Constrói cada separador arrastando blocos da paleta para a pré-visualização em direto, ou clica para adicionar um. Cada bloco é editável no próprio local — faz duplo clique num bloco de texto para editar o seu conteúdo diretamente na tela.
| Field | Type | Description |
|---|---|---|
headingOptional | Título | Um título de secção. Escolhe o nível, o alinhamento e uma cor opcional. |
textOptional | Texto | Um parágrafo com alinhamento, um tamanho de letra selecionado e uma cor opcional. |
imageOptional | Imagem | Uma imagem da biblioteca de recursos da tua organização, com texto alternativo, alinhamento e largura. |
calloutOptional | Destaque | Uma caixa de aviso colorida num de quatro tons — info, sucesso, aviso ou perigo. |
linkOptional | Botão de ligação | Um botão que abre um URL externo, com estilo primário, contorno ou subtil — ou apresentado como um mosaico compacto com ícone para filas de ações rápidas. |
dividerOptional | Separador visual | Uma simples linha horizontal. |
spacerOptional | Espaçador | Espaço vertical — pequeno, médio ou grande. |
signinOptional | Início de sessão | O cartão de início de sessão ligado ao fornecedor de autenticação do teu suplemento — inerte quando o teu suplemento é de acesso aberto. |
functionListOptional | Lista de funções | Uma lista com título das tuas funções publicadas; o utilizador clica numa para a inserir. |
functionButtonOptional | Botão de função | Um botão que insere uma única função com um clique — só podes atribuir funções sem parâmetros obrigatórios. Uma função que precise de dados de entrada fica atrás de um botão Abrir caixa de diálogo. Também pode apresentar-se como um mosaico compacto com ícone; coloca mosaicos lado a lado num bloco de colunas (2–4 colunas) para uma fila de ações rápidas. |
uploadRangeOptional | Carregar intervalo | Um botão que lê o intervalo selecionado pelo utilizador — ou toda a tabela à volta dele — e o carrega através de uma das tuas funções de escrita. Por predefinição a primeira linha passa a ser os nomes das colunas, e os intervalos grandes seguem em blocos seguros de repetir, por isso voltar a clicar depois de uma falha parcial substitui em vez de duplicar. |
functionResultOptional | Resultado de função | Corre uma função de leitura como o utilizador com sessão iniciada e mostra o resultado como uma tabela dentro do painel, nunca na grelha — «Os meus carregamentos», «Partilhado comigo» e outras vistas por utilizador quando a ligação usa um modo de autenticação com token de utilizador. Corre sozinho quando o painel abre, oferece um controlo de atualização, e recebe uma função, um título opcional e valores de argumento fixos. |
templateListOptional | Lista de modelos | Uma lista com título dos teus modelos de livro; um clique insere todas as folhas. |
gridViewListOptional | Lista de tabelas/PivotTables | As Tabelas e PivotTables configuradas para este ambiente; cada entrada transborda a sua função de origem e transforma o resultado numa Tabela ou PivotTable real do Excel. |
sectionOptional | Secção | Um cartão que agrupa outros blocos, com um único nível de profundidade — uma secção pode conter qualquer bloco exceto outra secção. |
O modelo inicial usa mais alguns blocos
O modelo inicial incorporado reproduz o painel de quatro separadores por defeito do agent, por isso também usa um bloco explorador de funções, um bloco de estado em direto e um bloco de endpoints. Não precisas de os adicionar tu mesmo a menos que estejas a construir um layout do zero — existem para que o modelo inicial seja uma cópia fiel da interface incorporada do agent. O explorador de funções pode alternativamente apresentar-se como uma lista simples — cada função numa fila com o seu próprio distintivo de ícone colorido — em vez de grupos por módulo expansíveis.
Secções
Uma secção é um cartão que agrupa blocos — coloca um título, algum texto e um botão dentro de uma para a destacar visualmente do resto do separador. As secções têm um único nível de profundidade: uma secção pode conter qualquer outro bloco exceto outra secção.
Marca e tema
O painel Brand controla o aspeto de todo o painel de tarefas, aplicado de forma consistente em cada separador:
| Field | Type | Description |
|---|---|---|
accentOptional | cor | Cor de destaque da marca usada em botões, ligações e realces. |
fontOptional | system | sans | serif | mono | Família tipográfica base do painel. |
corner radiusOptional | sharp | rounded | round | Arredondamento dos cantos de cartões, botões e campos. |
densityOptional | compact | cozy | roomy | Espaçamento entre blocos. |
modeOptional | light | dark | inherit | Esquema de cores; light é a predefinição para que a pré-visualização corresponda sempre ao Excel, e inherit segue o próprio tema do anfitrião Excel. |
backgroundOptional | color | gradient | image | Uma cor sólida, um gradiente de duas cores num ângulo selecionado, ou uma imagem carregada. |
headerOptional | title, subtitle, logo, status | Uma barra de marca opcional acima dos separadores, com título, subtítulo, um indicador de estado de ligação em direto e um logótipo — uma marca selecionada, uma imagem carregada ou um monograma do título. |
Modelos iniciais e o recurso incorporado
Quando o painel de tarefas de um ambiente nunca foi guardado, o construtor abre com um modelo inicial pronto que reproduz o painel de quatro separadores incorporado do agent (Functions, Templates, Status, Resources) — assim começas a editar um painel de tarefas real e funcional, não uma tela em branco. Usa "Start from template" para voltar a um modelo inicial, ou copia o layout guardado de outro ambiente como o teu rascunho.
Sem layout guardado, sem painel em falta
Se nunca guardares um layout num ambiente, o seu agent recorre ao mesmo painel de quatro separadores incorporado que sempre teve — os teus utilizadores nunca ficam com um painel de tarefas em branco.
Publicação
Guarda o teu layout e ele viaja no próximo snapshot de configuração do agent — o mesmo canal em direto que as tuas funções e ligações usam. Não há alteração do manifesto nem reimplementação: cada painel de tarefas que um utilizador tenha aberto recebe o novo layout na próxima vez que o abrir.
Botões do friso
Controlos personalizados do friso que abrem o painel de tarefas, executam uma função ou lançam uma caixa de diálogo.
Marca branca
Substitui todas as marcas ConnXL pelo teu próprio nome, ícone e marca.
Usar funções no Excel
Como se comportam o explorador de funções e os modelos do painel para os teus utilizadores finais.
Mutual TLS (mTLS)
O agent autentica-se neste backend inscrevendo-se para obter o seu próprio certificado de cliente mTLS — não há chave de API, nem token de portador para configurar em tempo de execução, nem nenhum modo de autenticação alternativo. Nunca tens de criar ou lidar com o certificado tu mesmo; o agent gera a sua própria chave e obtém-na assinada durante a inscrição.
Botões do friso
Adiciona botões personalizados ao friso do Excel que abrem o teu painel de tarefas, executam uma das tuas funções ou lançam uma caixa de diálogo — colocados num separador incorporado ou no teu próprio separador com marca.