¶ 1. Visão Geral
A funcionalidade de Recursos no T6 permite que administradores gerenciem os idiomas de tradução da aplicação diretamente pelo painel nativo do PowerPlanning, sem necessidade de implantação de código ou reinicialização do servidor.
Anteriormente, as traduções eram compiladas junto à aplicação, tornando qualquer adição ou customização de idioma dependente de um novo ciclo de release. Com esta funcionalidade, administradores autorizados podem adicionar novos idiomas personalizados, atualizar traduções existentes e remover idiomas não mais necessários — tudo de forma imediata e centralizada.
O painel exibe todos os idiomas disponíveis, tanto os idiomas nativos (Inglês, Português e Espanhol) quanto qualquer idioma personalizado carregado pela organização.
¶ 1.1. Pré-Requisitos
Para acessar e utilizar o painel de Recursos, o usuário deverá estar em um Grupo Global com a seguinte Funcionalidade de Administrador habilitada:
Na atualização, esta permissão é concedida automaticamente a todos os administradores multi-app ativos.
¶ 2. Funcionalidades
O painel de Recursos oferece quatro capacidades principais:
-
Download de template de tradução — disponível para os idiomas nativos (Inglês, Português e Espanhol). Permite baixar um arquivo Excel pré-preenchido como base para a criação de um novo idioma personalizado;
-
Upload de idioma personalizado — permite carregar um arquivo Excel com as traduções de um novo idioma. O idioma é identificado automaticamente pelo nome do arquivo e as traduções são aplicadas imediatamente, sem reinicialização;
-
Download de idioma customizado existente — para idiomas já carregados, permite baixar o arquivo Excel com as traduções atualmente armazenadas, facilitando edições e atualizações;
-
Exclusão de idioma customizado — remove um idioma customizado do banco de dados após confirmação. Idiomas Base não podem ser excluídos.
Idiomas Base (Inglês, Português e Espanhol) não podem ser substituídos por envio nem excluídos.
¶ 3. Utilização
No menu principal do T6, clique no ícone de menu (☰) no canto superior esquerdo, expanda a seção Configurações e selecione Recursos:
Será aberto o painel de Recursos, exibindo a listagem de todos os idiomas disponíveis. O subtítulo do painel indica o número total de culturas cadastradas:
Cada linha da listagem apresenta:
- Cultura — código da cultura (ex.:
en,pt,es); - Nome — nome nativo do idioma (ex.: English, português, español);
- Tipo — Base para idiomas nativos compilados na aplicação, ou Customizada para idiomas carregados via upload.
¶ 3.1. Baixar Template de Tradução
Use esta opção para gerar um arquivo Excel base para tradução de um novo idioma personalizado.
1. Na linha de um idioma Base, clique no ícone de download (↓);
- O painel será atualizado com os campos Base (idioma de referência, preenchido automaticamente) e Idioma:
2. Selecione o Idioma de destino no campo correspondente;
3. Opcionalmente, informe uma Região para a variante regional (ex.: France para Francês da França);
4. Clique em DOWNLOAD para baixar o arquivo Excel;
- O arquivo gerado possui uma coluna de referência com os valores do idioma base e uma coluna de tradução pré-preenchida. O tradutor deve alterar apenas os termos que diferem do idioma base.
Ao efetuar o download de um idioma Customizado já existente, a coluna de tradução virá pré-preenchida com as traduções já armazenadas no banco de dados.
¶ 3.2. Enviar um Idioma Personalizado
1. No painel de Recursos, clique no botão Enviar:
- O seletor de arquivos do sistema operacional será aberto, filtrado para arquivos Excel (
.xlsx).
2. Selecione o arquivo .xlsx com as traduções do novo idioma;
- O envio é iniciado automaticamente após a seleção do arquivo, sem etapa adicional de confirmação.
- O código do idioma é identificado a partir do nome do arquivo (ex.: o arquivo
fr-FR.xlsxserá importado como o idiomafr).
3. Aguarde a conclusão do envio;
- Em caso de sucesso, a listagem de culturas é recarregada automaticamente e as traduções do novo idioma passam a ser servidas imediatamente pela aplicação. Uma mensagem de confirmação é exibida no idioma do usuário atual.
- Em caso de falha, uma notificação de erro é exibida com o motivo.
Restrições de envio:
Não é possível sobrescrever os idiomas Base (Inglês, Português e Espanhol);
Códigos de idioma com mais de 10 caracteres são rejeitados.
¶ 3.3. Baixar um Idioma Customizado Existente
1. Na linha de um idioma Customizado, clique no ícone de download (↓);
- O download do arquivo Excel é iniciado imediatamente, sem sub-painel;
- O arquivo virá pré-preenchido com as traduções atualmente armazenadas para aquele idioma.
2. Edite o arquivo conforme necessário e realize um novo envio para atualizar as traduções.
¶ 3.4. Excluir um Idioma Customizado
1. Na linha de um idioma Customizado, clique no ícone de exclusão (🗑);
- Um diálogo de confirmação será exibido com a mensagem "Você realmente deseja remover este item?":
2. Clique em SIM para confirmar a exclusão ou NÃO para cancelar;
- Ao confirmar, o idioma é removido do banco de dados e a listagem é atualizada automaticamente.
Se algum usuário estiver com o idioma excluído como idioma salvo em suas preferências, a aplicação fará o fallback automaticamente para o Inglês.
¶ 4. Alterando a cultura do sistema
Após realizar o upload de um novo idioma customizado, os usuários podem alterar a cultura do sistema para utilizar o novo idioma, sem necessidade de reinicialização.
- Clique no ícone de menu (☰) no canto superior esquerdo;
- Nas opções de configuração do usuário, clique em Opções;
- Será aberto um painel lateral com as preferências do usuário. Localize o campo Idioma e clique no dropdown para exibir a lista de idiomas disponíveis;
- Selecione o idioma desejado e clique em Salvar para aplicar a alteração.
A aplicação será recarregada automaticamente para refletir a nova cultura selecionada, as traduções do idioma customizado passarão a ser exibidas imediatamente.
É possível inclusive customizar idiomas que não contêm caracteres semelhantes ao idioma base, como o Japonês (
ja), utilizando o template de um idioma base e editando as traduções conforme necessário.
¶ 5. Q&A
Perguntas Frequentes
1. Preciso reiniciar o servidor após fazer upload de um novo idioma?
Não. As traduções carregadas via upload são servidas imediatamente pela aplicação, sem necessidade de reinicialização ou novo deploy.
2. Posso substituir ou excluir os idiomas Base (Inglês, Português, Espanhol)?
Não. Os idiomas Base são protegidos e não podem ser sobrescritos por envio nem excluídos pelo painel.
3. O que acontece com usuários que estavam usando um idioma personalizado que foi excluído?
A aplicação detecta automaticamente que o idioma salvo não existe mais e faz o fallback para o Inglês na próxima sessão do usuário.
4. Como o sistema identifica o idioma a partir do arquivo enviado?
O código do idioma é extraído diretamente do nome do arquivo. Por exemplo, ao enviar o arquivo fr.xlsx, o sistema registra o idioma com o código fr (français). Certifique-se de nomear o arquivo com o código de cultura correto antes do envio (ex.: de.xlsx para Alemão, it.xlsx para Italiano).
5. Qual é o limite de tamanho para o código do idioma no nome do arquivo?
Códigos de idioma com mais de 10 caracteres são rejeitados pelo sistema.
6. Onde a permissão "Gerenciar Recursos" é configurada?
A permissão deve ser habilitada em um Grupo Global, na aba de Funcionalidades de Administrador. Consulte a página Funcionalidades e Permissões para mais detalhes.
7. Por que o botão DOWNLOAD fica desabilitado no sub-painel de template?
O botão DOWNLOAD permanece desabilitado até que um idioma de destino seja selecionado no campo Idioma do sub-painel. Selecione o idioma desejado e o botão será habilitado automaticamente.