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

Versão principal LimeSurvey 7

Esta página apresenta uma visão geral das principais alterações introduzidas com o LimeSurvey 7 e contém ligações para as páginas de documentação relevantes.

  Esta informação aplica-se sobretudo à LimeSurvey Community Edition (CE).

Principais alterações no LimeSurvey 7

Estrutura modificada das tabelas de respostas e dos nomes de campos

O LimeSurvey 7 introduz uma reorganização estrutural na forma como as tabelas de respostas e os nomes de campos são gerados. Esta alteração melhora a consistência e torna a plataforma mais fácil de manter e expandir.

Pesquise mais detalhes aqui: Reestruturação dos nomes de campos e das tabelas de respostas - LimeSurvey 7

Novo editor de perguntas

O LimeSurvey 7 introduz também um novo editor de perguntas com uma interface de utilizador atualizada e fluxos de trabalho melhorados para criar e gerir perguntas.

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

Alterações na API RemoteControl

As respostas da API RemoteControl 2 foram melhoradas, devolvendo códigos de erro além do texto do erro. Consulte a documentação da API RemoteControl 2 para conhecer estas alterações. Dependendo da forma como trata os valores devolvidos, isto deverá ser retrocompatível - no entanto, pode não ser tratado corretamente na sua implementação.

Pesquise mais detalhes aqui: API RemoteControl 2

Alterações de fuso horário

Na versão 6 e anteriores, os carimbos de data/hora registados 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 definição 'Diferença horária' é migrada, se possível, e todos os carimbos de data/hora registados a partir daí são guardados como UTC. Os carimbos de data/hora antigos não são migrados. É possível definir um fuso horário global por omissão nas Configurações globais e um fuso horário individual para cada utilizador. Estes aplicam-se apenas à apresentação dos dados. A exportação e a API RemoteControl só aceitam/fornecem os carimbos de data/hora em bruto.

Temas de inquéritos personalizados

Todos os temas de inquéritos compatíveis com o LS6 permanecerão ativos após a atualização. Se o tema do inquérito for incompatível com o LS6, será desinstalado e as Opções de tema nas Configurações globais, de grupo e do inquérito serão reinicializadas para o novo valor por omissão.

Estratégia de atualização:

1. Exporte o tema do inquérito da aplicação antiga
2. Antes de o importar para a nova aplicação, certifique-se de que a tag de compatibilidade está definida corretamente: https://manual.limesurvey.org/Extension_compatibility#Survey_themes
3. Importe-o para a nova aplicação
4. Verifique o código que personalizou para o tema do inquérito e atualize-o de acordo com a nova versão da aplicação que pretende utilizar.
5. Exporte da nova aplicação o seu tema de inquérito personalizado já atualizado
6. Após a atualização, os seus temas de inquéritos compatíveis com o LS6 permanecerão ativos, enquanto os temas mais antigos serão desinstalados.
7. Se optar por atualizar um tema de inquérito, pode agora importá-lo. Depois de confirmar que foi atualizado corretamente, pode optar por eliminar o antigo.

Temas de administração personalizados

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

para aplicações alojadas por si:

1. Antes de copiar o tema de administração para a nova aplicação, certifique-se de que 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 personalizou para o tema de administração e atualize-o de acordo com a nova versão da aplicação que pretende utilizar.
4. Após atualizar a aplicação antiga, o nosso novo tema de administração é apresentado por predefinição. Para atualizar o tema de administração instalado anteriormente, pode:
   • Atualizar manualmente o código do tema de administração atualmente marcado como incompatível
   • Eliminar o tema de administração antigo e instalar o novo, que atualizou previamente no seu ambiente de teste.

para utilizadores Cloud:
Contacte o nosso suporte.

Temas de perguntas personalizados

Os temas de perguntas personalizados que não correspondam à versão atual não podem ser instalados, mas continuarão ativos após a atualização. Pode encontrar mais informações sobre os temas de perguntas aqui: Temas de perguntas. É provável que o JavaScript personalizado inserido no tema do inquérito ou em qualquer uma das perguntas de um inquérito também deixe de funcionar.

Atualizar o seu tema da pergunta personalizado:

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

Atualizar um tema que não é seu:
Verifique se existe uma atualização disponível no site ou junto do programador que o disponibilizou

Plugins personalizados

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

para aplicações alojadas por si:

1. Verifique se o plugin pode ser instalado na nova versão.
2. Atualize o plugin ou contacte o autor do plugin para que o atualize.
3. Substitua manualmente o plugin pelos novos ficheiros na sua aplicação, o que preservará as configurações, ou desinstale a versão antiga e reinstale a nova versão; neste caso, todas as configurações terão de ser introduzidas novamente.

para utilizadores Cloud:

1. O LimeSAML permanecerá ativo
2. Verifique se o plugin pode ser instalado na nova versão.
3. Atualize o código do plugin ou contacte o autor do plugin para que o atualize.
4. Opções de instalação:
   • Desinstale a versão antiga e reinstale a nova versão (todas as configurações serão perdidas e terão de ser aplicadas novamente)
   • Contacte 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 (recomenda-se 8.3)
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 do URL	get ou path	path, necessário para o novo editor

Não precisa de Node.js nem de npm. O novo editor está incluído no pacote do LimeSurvey e está pronto a utilizar.

Faça uma cópia de segurança completa dos seus ficheiros e da sua base de dados antes de começar e teste primeiro a atualização numa cópia da sua instalação. Depois de a atualização ser executada, não há forma de voltar atrás, exceto restaurando essa cópia de segurança.

Planeie uma janela de manutenção. O LimeSurvey coloca o site em Modo de manutenção enquanto a base de dados está a ser atualizada e, em instalações com muitos dados das respostas, isto pode demorar algum tempo.

Recomendado: utilize o nosso serviço ComfortUpdate

A forma mais fácil e segura de atualizar é utilizar o nosso serviço ComfortUpdate. Este transfere e instala a nova versão por si, pelo que não tem de substituir ficheiros manualmente.

Se preferir atualizar manualmente, siga antes os passos abaixo.

Atualização manual

1. Faça uma cópia de segurança dos seus ficheiros e da base de dados e coloque o site em Modo de manutenção.
2. Conserve os seguintes ficheiros 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 ficheiros carregados, temas de utilizador e plugins de utilizador
   • a pasta plugins/, se instalou plugins nela manualmente
3. Transfira o pacote do LimeSurvey 7 e atualize a instalação utilizando um dos seguintes métodos:
   1. Elimine primeiro os ficheiros antigos. Retire os ficheiros indicados acima do caminho, elimine tudo o resto na sua pasta do LimeSurvey, descompacte o novo pacote nessa pasta e volte a colocar os ficheiros conservados.
   2. Ou copie os novos ficheiros por cima dos antigos. Descompacte o novo pacote por cima da sua instalação existente e deixe-o substituir o que já lá está, sem alterar os ficheiros indicados acima.
4. Com qualquer uma das opções, utilize o novo .htaccess do pacote, uma vez que o da versão 6.x não funciona com o novo editor. Depois, esvazie tmp/runtime/ para que não fiquem dados em cache da versão 6.
5. Defina o formato do URL como path em application/config/config.php.
6. Certifique-se de que o seu servidor web serve diretamente a pasta /editor/ e passa o cabeçalho Authorization para o PHP. Mais detalhes: Novo editor de perguntas no LimeSurvey 7
7. Execute a atualização da Base de Dados. O LimeSurvey deteta a versão antiga da base de dados e propõe a sua atualização. Confirme e deixe que termine sem a interromper.
8. Quando terminar, desative o Modo de manutenção e percorra 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 necessita, um a 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, quotas, e-mails e o URL de saída.

Resolução de problemas

Mensagem "Action needed" sobre o formato do URL. O formato do URL continua a ser get. Altere-o para path e limpe tmp/runtime/.

O editor é carregado mas permanece vazio. O cabeçalho Authorization não está a chegar 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 utiliza um tema que não se baseia no fruity_twentythree. Mude o tema ou continue no editor clássico.

Um plugin causa erros depois de ser reativado. Não é compatível com o LimeSurvey 7. Desative-o e consulte o respetivo responsável.

Notas

Cada alteração importante está documentada na sua própria página. Isto ajuda a manter a documentação focada e facilita a pesquisa da informação relevante para a sua configuração.