Atualização da versão 6 para a 7

Versão principal do LimeSurvey 7

Esta página oferece uma visão geral das principais mudanças introduzidas com o LimeSurvey 7 e links para as páginas de documentação relevantes.

  Estas informações aplicam-se principalmente à LimeSurvey Community Edition (CE).

Principais mudanças no LimeSurvey 7

Estrutura modificada da tabela de respostas e dos nomes de campo

O LimeSurvey 7 introduz uma limpeza estrutural na forma como as tabelas de respostas e os nomes de campo são gerados. Essa mudança melhora a consistência e facilita a manutenção e a expansão da plataforma.

Veja mais detalhes aqui: Refatoração dos nomes de campo e da tabela de respostas - LimeSurvey 7

Novo editor de perguntas

O LimeSurvey 7 também introduz um novo editor de perguntas, com uma interface de usuário atualizada e fluxos de trabalho aprimorados para criar e gerenciar perguntas.

Veja mais detalhes aqui: Novo editor de perguntas no LimeSurvey 7

Mudanças na API RemoteControl

As respostas da API RemoteControl 2 foram aprimoradas e agora retornam códigos de erro, além do texto do erro. Consulte a documentação da API RemoteControl 2 para conhecer essas mudanças. Dependendo de como você trata os valores retornados, isso deve ser compatível com versões anteriores; no entanto, pode não ser tratado corretamente na sua implementação.

Veja mais detalhes aqui: API RemoteControl 2

Mudanças de fuso horário

Na versão 6 e anteriores, os registros de data e hora não tinham fuso horário definido e dependiam da data/hora do servidor. Com a migração para a versão 7, a antiga configuração 'Diferença de horário' é migrada, se possível, e todos os registros de data e hora a partir de então são gravados em UTC. Os registros antigos não são migrados. É possível definir um fuso horário global padrão nas definições globais, e um fuso horário individual pode ser definido por usuário. Eles se aplicam apenas à exibição dos dados. A exportação e a API RemoteControl só aceitam/fornecem os registros de data e hora brutos.

Temas de questionário personalizados

Todos os temas de questionário compatíveis com o LS6 continuarão ativos após a atualização. Se o tema de questionário era incompatível com o LS6, ele será desinstalado, e as opções de tema nas configurações globais, de grupo e do questionário serão reinicializadas para o novo padrão.

Estratégia de atualização:

1. Exporte o tema de questionário da aplicação antiga
2. Antes de importá-lo na nova aplicação, verifique se a tag de compatibilidade está definida corretamente: https://manual.limesurvey.org/Extension_compatibility#Survey_themes
3. Importe-o na nova aplicação
4. Verifique o código que você personalizou no tema de questionário e atualize-o de acordo com a nova versão da aplicação que deseja usar.
5. Exporte da nova aplicação o seu tema de questionário personalizado e atualizado
6. Após a atualização, os temas de questionário compatíveis com o LS6 continuarão ativos, enquanto os temas mais antigos serão desinstalados.
7. Se optar por atualizar um tema de questionário, você poderá importá-lo agora. Depois de confirmar que ele foi atualizado corretamente, você poderá excluir o antigo.

Temas de administração personalizados

O tema de administração padrão será ativado por padrão. Os temas personalizados permanecerão intactos, mas não poderão ser reativados a menos que sejam atualizados.

para aplicações hospedadas por você mesmo:

1. Antes de copiar o tema de administração para a nova aplicação, verifique se a tag de compatibilidade está definida corretamente: https://manual.limesurvey.org/Extension_compatibility#Admin_themes
2. Copie o tema de administração existente da aplicação antiga para a nova aplicação https://manual.limesurvey.org/Custom_Admin_Themes
3. Verifique o código que você personalizou no tema de administração e atualize-o de acordo com a nova versão da aplicação que deseja usar.
4. Após atualizar a aplicação antiga, o nosso novo tema de administração é exibido por padrão. Para atualizar o tema de administração instalado anteriormente, você pode:
   • Atualizar manualmente o código do tema de administração atualmente marcado como incompatível
   • Excluir o tema de administração antigo e instalar o novo, que você atualizou antes no seu ambiente de teste.

para usuários do Cloud:
Entre em contato com o nosso suporte.

Temas de perguntas personalizados

Os temas de perguntas personalizados que não correspondem à versão atual não podem ser instalados, mas continuarão ativos após a atualização. Mais informações sobre temas de perguntas podem ser encontradas aqui: Temas de perguntas. O JavaScript personalizado inserido no tema do questionário ou em qualquer uma das perguntas de um questionário provavelmente também deixará de funcionar.

Atualizando o seu tema de pergunta personalizado:

1. Baixe o tema de pergunta de um site ou exporte o tema de pergunta atual
2. Antes do carregamento, verifique se a compatibilidade do seu tema de pergunta personalizado está definida corretamente
3. Tente carregar o seu tema de pergunta na nova aplicação.
4. Se for um tema de pergunta criado por você, faça os ajustes necessários
5. Após o carregamento bem-sucedido, verifique se o tema de pergunta é exibido e funciona como esperado.

Atualizando um tema que não é seu:
Verifique se há uma atualização disponível no site ou com o desenvolvedor que o forneceu

Plugins personalizados

Os plugins personalizados que não correspondem à versão atual serão desativados durante o processo de atualização.

para aplicações hospedadas por você mesmo:

1. Verifique se o plugin pode ser instalado na nova versão.
2. Atualize o plugin ou entre em contato com o autor do plugin para que ele o atualize.
3. Substitua manualmente o plugin pelos novos arquivos na sua aplicação, o que preservará as configurações, ou desinstale a versão antiga e reinstale a nova; nesse caso, todas as configurações precisarão ser inseridas novamente.

para usuários do Cloud:

1. O LimeSAML continuará ativo
2. Verifique se o plugin pode ser instalado na nova versão.
3. Atualize o código do plugin ou entre em contato com o autor do plugin para que ele o atualize.
4. Opções de instalação:
   • Desinstalar a versão antiga e reinstalar a nova (todas as configurações serão perdidas e precisarão ser aplicadas novamente)
   • Entrar em contato com o suporte para atualizar o plugin sem perder os dados de configuração

Requisitos

	LimeSurvey 6	LimeSurvey 7
PHP	7.4 ou superior	8.1 ou superior (8.3 recomendado)
MySQL	8.0 ou superior	8.0 ou superior
MariaDB	10.3.38 ou superior	10.3.38 ou superior
PostgreSQL	12 ou superior	14 ou superior
MSSQL	2016 ou superior	2019 ou superior
Formato da URL	get ou path	path, necessário para o novo editor

Você não precisa de Node.js nem de npm. O novo editor está incluído no pacote do LimeSurvey e está pronto para uso.

Faça um backup completo dos seus arquivos e do seu banco de dados antes de começar e teste primeiro a atualização em uma cópia da sua instalação. Depois que a atualização for executada, não há como voltar atrás, a não ser restaurando esse backup.

Planeje uma janela de manutenção. O LimeSurvey coloca o site em modo de manutenção enquanto o banco de dados está sendo atualizado e, em instalações com muitos dados de respostas, isso pode levar algum tempo.

Recomendado: use o nosso serviço ComfortUpdate

A maneira mais fácil e segura de atualizar é usar o nosso serviço ComfortUpdate. Ele baixa e instala a nova versão para você, de modo que você não precisa substituir nenhum arquivo manualmente.

Se preferir atualizar manualmente, siga os passos abaixo.

Atualização manual

1. Faça backup dos seus arquivos e do banco de dados e coloque o site em modo de manutenção.
2. Mantenha os seguintes arquivos e pastas da sua instalação antiga:
   • application/config/config.php
   • application/config/security.php
   • application/config/allowed_hosts.php
   • a pasta upload/, que contém os seus arquivos carregados, os temas de usuário e os plugins de usuário
   • a pasta plugins/, se você instalou plugins nela manualmente
3. Baixe o pacote do LimeSurvey 7 e atualize a instalação usando um dos seguintes métodos:
   1. Exclua primeiro os arquivos antigos. Mova os arquivos listados acima para outro local, exclua todo o resto do diretório do LimeSurvey, descompacte o novo pacote nele e coloque de volta os arquivos mantidos.
   2. Ou copie os novos arquivos por cima dos antigos. Descompacte o novo pacote sobre a sua instalação existente e deixe que ele sobrescreva o que já estiver lá, sem alterar os arquivos listados acima.
4. Em qualquer das opções, use o novo .htaccess do pacote, pois o da versão 6.x não funciona com o novo editor. Depois, esvazie tmp/runtime/ para que não restem dados em cache da versão 6.
5. Defina o formato da URL como path em application/config/config.php.
6. Certifique-se de que o seu servidor web serve a pasta /editor/ diretamente e repassa o cabeçalho Authorization ao PHP. Mais detalhes: Novo editor de perguntas no LimeSurvey 7
7. Execute a atualização do banco de dados. O LimeSurvey detecta a versão mais antiga do banco de dados e se oferece para atualizá-lo. Confirme e deixe o processo terminar sem interrompê-lo.
8. Quando terminar, desative o modo de manutenção e siga a lista de verificação abaixo.

Após a atualização

• Verifique o número da versão no rodapé das páginas de administração.

• Reative os plugins de que você precisa, um por um.

• Abra um inquérito e confirme que o novo editor é carregado.

• Execute uma resposta de teste completa em cada inquérito ativo, abrangendo condições, cotas, e-mails e a URL final.

Solução de problemas

Mensagem "Action needed" sobre o formato da URL. O formato da URL ainda é get. Altere-o para path e limpe tmp/runtime/.

O editor é carregado, mas permanece vazio. O cabeçalho Authorization não está chegando ao PHP.

/editor/ mostra uma página do LimeSurvey ou um erro "Não encontrado". Verifique a configuração do seu servidor web e certifique-se de que a pasta /editor/ é servida diretamente, em vez de ser encaminhada através do LimeSurvey.

"You cannot use this theme with the new question editor". O inquérito usa um tema que não é baseado em fruity_twentythree. Troque o tema ou continue no editor clássico.

Um plugin causa erros depois de ser reativado. Ele não é compatível com o LimeSurvey 7. Desative-o e consulte o seu mantenedor.

Notas

Cada mudança importante está documentada em sua própria página. Isso ajuda a manter a documentação focada e facilita encontrar as informações relevantes para a sua configuração.