AtualizarVersao(aVersao, aOpcoes)
Esse método serve para realizar o download e a instalação da atualização do componente no ambiente do cliente final, facilitando assim a atualização da Software House.
Atenção! Para utilizar este método deve ser previamente configurado o Gerenciador da Suíte de Componentes (Como configurar o Gerenciador da Suíte de Componentes ?)
Método
Componente BPL
AtualizarVersao(aVersao: String, aOpcoes: TAutoUpdaterReinfOptions);
OCX
AtualizarVersao(aVersao: String, aOpcoes: short);
Por padrão a atualização da aplicação será por completa, atualizando esquemas, templates, inis e rtms nas pastas configuradas no componente. Porém para facilitar alguns processos foi criado algumas opções que o componente aceita, como essas abaixo:
TAutoUpdaterReinfOptions
Valor | Descrição | Valor OCX |
auReinfReiniciarAplicacao | Ao passar essa propriedade para o método, quando finalizar a atualização do componente ele irá iniciar novamente a aplicação que chamou. Ou seja iniciando novamente o sistema. | 1 |
auReinfNaoAtualizarRTMs | Ao passar essa propriedade para o método, quando for realizar a atualização não será atualizado os RTMs do componente, normalmente essa propriedade será utilizada quando a Software House possuir RTMs personalizados. | 2 |
auReinfNaoMostrarProgresso | Quando é iniciado a atualização irá subir uma janela com o progresso da atualização que está sendo realizada, porém quando passar essa propriedade essa janela não será mostrada realizando a atualização sem feedback visual. | 4 |
Parâmetros
Componente BPL
Argumento | Tipo | Detalhes |
aVersao | String | Versão para a qual deseja ser atualizado o componente |
aOpcoes | TAutoUpdaterReinfOptions | Opções que deseja ser configuradas para a atualização conforme a necessidade da Software House, ou pode utilizar o padrão passando o array vazio [] |
Componente OCX
Argumento | Tipo | Detalhes |
aVersao | String | Versão para a qual deseja ser atualizado o componente |
aOpcoes | Short | Opções que deseja ser configuradas para a atualização conforme a necessidade da Software House, ou pode utilizar o padrão passando 0 na OCX |
Retorno
O método AtualizarVersao retorna true quando é encontrado a versão solicitada e false quando não encontra a versão solicitada.
Obs.: Quando o retorno for false, ele retornará um status na requisição que está na tabela abaixo para identificar o motivo da falha na atualização:
Códigos de retorno
Código | Tipo | Descrição |
500 | Erro | Aplicação Suíte de Componentes não esta em execução |
Exemplos
Delphi
spdReinf.AtualizarVersao('1.1.1.1', []);
spdReinf.AtualizarVersao('1.1.1.1', [auReinfReiniciarAplicacao, auReinfNaoMostrarProgresso]);
C#
spdReinf.AtualizarVersao("1.1.1.1", (short) AutoUpdaterReinf.auReinfReiniciarAplicacao + (short) AutoUpdaterReinf.auReinfNaoMostrarProgresso);
ou
spdReinf.AtualizarVersao("1.1.1.1", 1 + 2);
Visual Basic 6
Reinf.AtualizarVersao("1.1.1.1", auReinfNaoAtualizarRTMs + auReinfNaoMostrarProgresso)
ou
Reinf.AtualizarVersao("1.1.1.1", 1 + 2 + 4);
Obs.: No segundo modo o valor deve ser obtido na tabela TAutoUpdaterReinfOptions na coluna Valor OCX. Caso não deseje passar nenhuma opção informar 0
Notas
- Esta funcionalidade está disponível somente para contratos que possuem ativo o modulo Suíte de Componentes
Comentários
0 comentário
Artigo fechado para comentários.