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: TAutoUpdaterGnreOptions);
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:
TAutoUpdaterGnreOptions
| Valor | Descrição | Valor OCX |
| auGnreReiniciarAplicacao | 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 |
| auGnreNaoAtualizarRTMs | 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 |
| auGnreNaoMostrarProgresso | 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 | TAutoUpdaterGnreOptions | 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
spdGnre.AtualizarVersao('1.1.1.1', []);
spdGnre.AtualizarVersao('1.1.1.1', [auGnreReiniciarAplicacao, auGnreNaoMostrarProgresso]);
C#
spdGnre.AtualizarVersao("1.1.1.1", (short) AutoUpdaterGnre.auGnreReiniciarAplicacao + (short) AutoUpdaterGnre.auGnreNaoMostrarProgresso);
ou
spdGnre.AtualizarVersao("1.1.1.1", 1 + 2);
Visual Basic 6
Gnre.AtualizarVersao("1.1.1.1", auGnreNaoAtualizarRTMs + auGnreNaoMostrarProgresso)
ou
Gnre.AtualizarVersao("1.1.1.1", 1 + 2 + 4);
Obs.: No segundo modo o valor deve ser obtido na tabela TAutoUpdaterGnreOptions 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.