Instalação

Você se deparou com alguma problema na instalação de pacotes(Sources, Forms, etc) ?

Cenários

  • Arquivo não atualizado após instalação;
  • Arquivo sobrescrito indevidamente após instalação(final);
  • O processo da instalação falha com informações de erro;
  • A instalação é cancelada/abortada abruptamente.

Se a situação enfrentada se parece com algumas das situações apresentadas acima, verifique as sessões abaixo de Troubleshooting.

Troubleshooting (Q&A)

Cenário 1

Após a instalação ou atualização de um pacote, meu arquivo não foi instalado/atualizado.

O arquivo esperado está no pacote disponível no apps? - caso a informação esperada não esteja no pacote, o problema está no ambiente de origem do pacote ou na geração do mesmo. Verifique a seção Problemas com Pacotes.

Cenário 2

Meu arquivo está presente no pacote instalado/atualizado mas a informação não é atualizada no ambiente.

Através da interface gráfica no Settings, é possível verificar os arquivos que foram instalados:

Detalhe do histórico/log de instalação no Instance Settings

Existe alguma informação nessa interface referente ao arquivo que não foi instalado/atualizado? Nos logs de aplicação existe alguma informação referente a instalação de seu arquivo?

Caso o seu arquivo esteja listado, ou nos logs, com a informação de "skipped", verifique se o seu arquivo ou módulo está com as configurações de "Final" definidas corretamente.

📘

Versões

Até as versões 2.6 da plataforma, existe uma informação referente a versão do componente, essa informação é incrementada automaticamente pela plataforma e é levada em consideração no momento da instalação do pacote.

O seu arquivo está com a versão incrementada? Se o seu arquivo, já modificado possui o mesmo número de versão do componente instalado no ambiente você pode estar com uma versão de Studio incorreta para a sua versão de plataforma.

Sempre utilize as versões recomendadas das bibliotecas, conforme informação exibida no Instance Settings.

Cenário 3

Após atualizações no ambiente, um arquivo de meu projeto foi modificado indevidamente.

Verifique se o seu arquivo(ou módulo) está devidamente marcado com a opção "Final".

Cenário 4

O processo da instalação falha com uma stacktrace de erro.

Nos logs, é possível identificar algum problema de FK?
(Exemplo, uma FK que não pôde ser instalada por problemas na base de dados)

Se sim, é necessário avaliar o conteúdo já presente na base de dados e que está afetando a instalação da FK e corrigir a base de dados.

Nos logs, é possível identificar algum problema de ALTER COLUMN?
(Exemplo, um campo que teve seu tipo ou tamanho modificado e não pode ser alterado)

Se sim, é necessário avaliar o conteúdo já presente na base de dados para que o comando de modificação possa ser executado sem problemas.

Outras Situações

Caso a sua solução não esteja descrita acima, favor abrir uma issue contendo as seguintes informações.

  • Verifique que todos os componentes (Studio, Scheduler, etc...) estão atualizados em seu ambiente.
  • Descrição do problema
  • Endereço(URL) do ambiente;
  • Informações do Pacote (título/versão do que está sendo instalado);
  • Resultado da consulta na CORE_APPINSTALL;
  • Logs do servidor ativo no momento da instalação do pacote (3 horas antes e 3 horas após o momento da instalação);
SELECT TOP 50 
    ID_APPINSTALL
  , DS_APPKEY
  , DS_APPID
  , DS_APPVERSION
  , DO_STATUS
  , DT_BEGIN
  , TX_SOURCE 
FROM CORE_APPINSTALL (NOLOCK) 
ORDER BY 1 DESC

Updated 2 years ago

Instalação


Você se deparou com alguma problema na instalação de pacotes(Sources, Forms, etc) ?

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.