Upgrade de PHC CS Desktop para a versão 28
Este artigo tem como objetivo auxiliar na instalação de upgrade das gamas:
Corporate para Corporate;
Advanced para Advanced;
Enterprise para Enterprise.
Para que o processo de upgrade seja executado de uma forma simples e célere, deve ter em atenção que o procedimento pode ser diferente, caso o computador já tenha tido alguma instalação PHC da v19 ou posteriores.
Desta forma, tenha as seguintes considerações:
- PC que não tenha tido uma instalação PHC CS Desktop:
Deve ser executado o Setup Base mais recente que se encontra no seguinte caminho do FTP:
../Pub/Setups/Setups_Base/v28/
NOTA IMPORTANTE: Pressupõe-se que esteja previamente instalado, e em correto funcionamento, a versão do Setup base da versão 17 ou 18. Veja mais informação aqui.
É importante mencionar que esta operação deverá ser exclusivamente realizada por um utilizador de sistema operativo que tenha privilégios de administrador do PC onde o PHC CS Desktop será executado.
Upgrade passo a passo
Passo 1 - Salvaguarda no processo de upgrade
Passo 2 - Transferência dos ficheiros do FTP
Passo 3 - Criação da diretoria onde vai colocar o executável
Passo 4 - Correr o executável da v28
Passo 5 - Verificação do nº máximo de campos
Passo 6 - Execução do Assistente de Instalação e Manutenção
Passo 7 - Instalação de acessos
Passo 8 - Upgrade no CS desktop Manufactor (caso exista)
1. Salvaguarda no processo de upgrade
Por questões de segurança deverá fazer um backup total à base de dados, como salvaguarda em caso de uma eventual anomalia durante o processo de upgrade.
Esse backup pode ser efetuado de 2 formas:
a) Acedendo, ainda na versão anterior, ao menu Supervisor > Tratamento de Base de dados > Backup de Base de dados.
Pode consultar aqui como o fazer.
b) Ou via SQL Express ou SQL Server, na ferramenta gráfica Management Studio.
Observe como efetuar o backup por esta opção aqui.
2. Transferência dos ficheiros do FTP
Partindo do pressuposto que estamos no PC Servidor, onde se encontra a BD, devemos na pasta de instalação PHC existente, copiar o executável PHC CS Desktop da v28 mais recente disponível no FTP no caminho: ../ftp.phc.pt/Pub/Exes/, assim como o aplicativo phcservice.exe, e o manual da gama em causa que pode descarregar no FTP no caminho: ../ftp.phc.pt/Pub/Manuais/;
Nota importante:
Uma vez que não existe o conceito de execução de setup da v28, não deve ser desinstalada a versão anterior, nem se deve eliminar a pasta da instalação, uma vez que utilizaremos essa pasta para o upgrade da v28, assim como em upgrades futuros.
Deve ser garantido que no Sistema Operativo, apenas existe uma instalação de “PHC CS xx” (em que xx é um número de versão) e de “PHC Controls for CS” (e eventualmente PHC Addin Outlook, PHC CS Manufactor, PHC CS XL, também apenas uma de cada).
3. Criação da diretoria onde vai colocar o executável
Criar um atalho do executável da v28 no ambiente de trabalho do utilizador, e simultaneamente, para garantir a rápida atualização dos executáveis em todos os postos de uma rede, o administrador de sistema pode facilmente garantir uma dinâmica de atualização automática.
Na prática terá que criar no servidor uma diretoria partilhada por todos os utilizadores, com acesso de leitura. Deve ser copiado para esta diretoria, o novo executável retirado do FTP, de acordo com a gama e versão. Nesta diretoria pode também encontrar-se o manual da aplicação cuja denominação é determinada pela gama, como por exemplo Phcadvanced.chm para a gama Advanced.
Também é importante referir que neste momento, para quem utiliza o método de Licenciamento por Internet, neste momento ao atualizar a aplicação "pexec.exe", “cexec.exe” ou “exec.exe”, quando executar a aplicação PHC CS através do atalho criado e configurado para abrir e verificar se os ficheiros colocados numa pasta de partilha são mais recentes, e se forem colocados nesse local os ficheiros “infophc.ins” e “internetkey.dbf”, a aplicação irá substituir os ficheiros locais pelos atuais de modo a ficar com os mais recentes, neste caso a aplicação verifica da seguinte forma:
- Quando os tamanhos dos ficheiros que estão nos postos são diferentes dos que estão na pasta de partilha, a aplicação copia sempre os ficheiros;
- Quando os tamanhos dos ficheiros que estão nos postos são iguais aos do que estão na pasta de partilha, a aplicação verifica a data e, caso esta seja superior a aplicação, copia os ficheiros, caso seja inferior não copia;
- Quando os tamanhos dos ficheiros que estão nos postos são iguais aos do que estão na pasta de partilha, a aplicação verifica a data e, caso esta também seja igual a aplicação, verifica a hora dos mesmos, nesse momento caso os ficheiros da pasta de partilha tenham uma hora mais recente copia os ficheiros.
Para saber como realizar este procedimento, veja aqui como o fazer.
4. Correr o executável da v28
Executar o aplicativo PHC CS Desktop (ex: phcadvanced.exe). Ao executar, em qualquer das formas indicadas no ponto 2, o PHC CS Desktop verifica que ainda não foram registados, ou ainda não existem os ficheiros de componentes externos ao software, correspondentes à nova versão, coloca os ficheiros na diretoria, e regista os mesmos.
Os componentes instalados, quando executa pela 1ª vez o executável de uma nova versão, são:
- Componentes XFRX, que servem para a geração, e assinatura (este último apenas com o módulo PHC CS Documentos Eletrónicos desktop), dos ficheiros PDF no PHC, nomeadamente os seguintes ficheiros:
hndlib.dll
xfrxlib.fll
xfrxlib.fxp
zlib.dll
xfrx.sign.net.exe
Localização: Na diretoria de instalação do PHC (Ex: C:\PHCXX).
- ChilkatAx-9.5.0-win32, componente responsável para a produção de Documentos eletrónicos.
Localização: Na diretoria de instalação do PHC (Ex: C:\PHCXX).
- Componente System.app, que serve para o correto funcionamento dos gráficos PHC.
Localização: Na diretoria de instalação do PHC (Ex: C:\PHCXX).
- Componente para envio de email e visualização de previsão meteorológica no PHC CS, nomeadamente o seguinte ficheiro:
Redemption.dll
Localização: Na diretoria de instalação do PHC (Ex: C:\PHCXX).
- Componente QRCoderGEN.dll que serve para a correta impressão do QR Code:
Localização: Na diretoria de instalação do PHC (Ex: C:\PHCXX).
Nota: Existem outros componentes necessários ao correto funcionamento do PHC CS, que são instalados pelo Setup, e que ficam instalados na diretoria C:\Program Files (x86)\PHC\PHC Controls for CS:
- richtextedit, que serve para editar as notas às Demonstrações Financeiras;
- ppayments, que serve para obter os pagamentos Paypal;
- socialnetphc, que serve para ligar a aplicação PHC às redes sociais;
- sharenetphc, que serve para ligar a aplicação PHC à Dropbox;
- mailnetphc, que serve para ligar a aplicação PHC ao MailChimp;
- assinaturasqualificadas, que serve para utilizar o módulo PHC CS Assinaturas Qualificadas.
Tendo utilizado a V19 ou posteriores nessas máquinas, os mesmos já se encontram instalados.
NOTA IMPORTANTE:
Se por algum motivo existir a necessidade de efetuar a reinstalação dos componentes numa máquina, pode fazê-lo da seguinte forma:
- No “Run” do seu Windows escreva:
C:\diretoria de instalação\executável PHC “SETUP” diretoria de instalação
Ex: C:\PHC28\phcadvanced.exe "SETUP" c:\phc28
Caso a diretoria de instalação contenha espaços ou acentuação, já teremos que escrever desta forma:
Ex: C:\PHC 28\phcadvanced.exe "SETUP" “c:\phc28”
- Pressione o botão “OK”.
Com o parâmetro “SETUP” serão reinstalados os componentes acima referidos, observando-se na aplicação uma régua de progressão de instalação dos mesmos.
5. Verificação do nº máximo de campos
Ao entrar no software PHC com o novo executável da v28, é despoletada a rotina que é executada apenas no primeiro acesso à aplicação PHC CS Desktop, que avisa o utilizador da entrada numa nova versão de software PHC CS Desktop, e analisa se existem tabelas que, pela utilização de campos de utilizador, irão ficar com mais de 254 campos após o upgrade.
No caso de existirem tabelas que iriam ficar com mais de 254 campos, é apresentado um relatório com as tabelas em causa;
Caso contrário, siga para o Passo 6.
Nota importante:
Caso obtenha a mensagem da imagem acima, observe como pode contornar esta situação:
Verificar se o parâmetro “Não instala campos de ligação a tabela dos módulos Clinica e estações de Serviço (tem de Reconstruir as tabelas CL, FT2 e BO2)” estará ativo.
Não estando e não possuindo nenhum dos módulos mencionados deverá ativá-lo, sair da aplicação e voltar a entrar.
Posteriormente, ao nível da "Instalação e Manutenção" deverá selecionar as tabelas CL, FT2 e BO2, e escolher a opção "reconstruir tabelas (não recomendado)" para que os campos referentes aos módulos clínica e estações de serviço deixem de existir nas tabelas.
Se eventualmente detetar que se trata de uma outra tabela, ou apesar do passo anterior, as mesmas tabelas manterem mais do que 264 campos, então, deverão primeiro proceder a uma cópia das mesmas para manter a tabela original com os registos corretos. Para isso, poderá através de uma query TSQL, copiar toda uma tabela e a sua estrutura para uma tabela de backup.
Exemplo:
Select * into auxtabela from tabela
Assim, terá criado uma tabela auxtabela com os registos da tabela pretendida.
Depois deverá eliminar os registos em excesso no ecrã "Campos de utilizador" para que no decorrer do processo de upgrade não lhe dê o erro de "Too Many Columns".
Após este processo deverá na "Instalação e Manutenção" selecionar as tabelas das quais eliminou campos de utilizador, e escolher a opção reconstruir tabelas (não recomendado), para que os campos eliminados sejam efetivamente eliminados da tabela.
De seguida, deverá fazer o upgrade e no fim deste deverá criar os campos anteriormente eliminados numa segunda tabela associada à primeira (este processo só deve ser feito para tabelas que têm segundas tabelas auxiliares, do tipo FT e FT2, BO e BO2, PE e PE2, etc.).
Assim, se o campo foi eliminado na tabela FT e esta já atingiu o seu limite, o campo de utilizador será eliminado na tabela FT antes do upgrade, e depois deste será criado na tabela FT2.
Havendo equivalência entre o stamp da tabela principal e a segunda tabela associada, poderá mediante query fazer a atualização dos dados nesta tabela, tendo como base a cópia da tabela original (auxtabela) criada no início deste processo.
Deverá de seguida fazer as correções necessárias às páginas de utilizador, alteração da propriedade variável do objeto nos objetos onde era invocado o campo de utilizador e a qualquer implementação que possa existir nessa base de dados (Ex: regras, valores por defeito, eventos, etc.).
Exemplo:
A minha tabela FT apresenta a mensagem no upgrade, porque tem dois campos que vão ultrapassar os 254 campos. Supondo que esses campos se chamam u_extraum e u_extradois.
Passo 1: Fazer cópia da tabela FT (query TSQL - query analyser);
select * into ftaux from ft
Passo 2: Eliminar estes campos na tabela de "Campos de Utilizador";
Passo 3: Na "Instalação e Manutenção" selecionar a tabela FT e escolher a opção "reconstruir tabelas (não recomendado)";
Passo 4: Fazer o upgrade à tabela FT para a nova versão;
Passo 5: Na nova versão, criar os campos u_extraum e u_extradois na tabela FT2 e atualizar esta tabela;
Passo 6: Passar a informação da cópia da FT original para os campos novos em FT2 (query TSQL);
update FT2 set ft2.u_extraum=(select u_extraum from ftaux where ftaux.ftstamp=ft2.ft2stamp)
update FT2 set ft2.u_extradois=(select u_extradois from ftaux where ftaux.ftstamp=ft2.ft2stamp)
Passo 7: Atualizar/rever todo o desenvolvimento implementado com base na referência dos campos ft.u_extraum e ft.u_extradois para substituir por ft2.u_extraum e ft2.u_extradois (páginas de utilizador e código de implementação diverso).
6. Execução do Assistente de Instalação e Manutenção
De seguida, caso o nº de campos se encontre dentro dos limites, ser-lhe-á apresentado o ecrã "Assistente de Instalação e Manutenção", funcionalidade imprescindível ao correto upgrade de versão, já que vai permitir executar as diversas ações relacionadas com a manutenção das tabelas da Base de dados.
Assim, no primeiro ecrã que nos surge deveremos escolher a opção Automática, e pressionar o botão Próximo.
No ecrã seguinte, as opções necessárias já estão selecionadas e encontram-se em modo de leitura, basta pressionar o botão Próximo.
Nota: A opção Atualizar tabela dicionário de dados só está disponível se tiver PHC CS Web.
Nota importante: No Assistente de Instalação e Manutenção, a opção Automática vai verificar as tabelas que precisam de ser atualizadas de acordo com a última versão do executável registado na base de dados do utilizador, e executa os passos de manutenção apenas para essas tabelas, registando esta informação na tabela tabversao, que vai ser atualizada com todas as tabelas dos módulos licenciados na ficha de proteção, e com indicação de datas de alterações de triggers e indexes que constam no executável da v28.
Quando é executado o Assistente de Instalação e Manutenção automaticamente, pela primeira vez, são realizadas todas as operações de manutenção para todas as tabelas. Essa mesma indicação é apresentada ao utilizador quando clica na opção Automática no respetivo assistente, recorrendo a uma mensagem para o efeito.
Importante: Na aquisição de um novo módulo esta opção não garante a integridade de todas as tabelas do módulo. Neste caso é necessário recorrer à Instalação e Manutenção para as tabelas do módulo em questão. Alternativamente, pode usar o assistente, mas em modo Personalizado.
7. Instalação de acessos
Depois de terminar o assistente de instalação, devem ser instalados os acessos aos utilizadores, pela opção Instalar acessos.
Esta opção pode ser feita diretamente no ecrã de "Instalação e "Manutenção, ou logo no "Assistente de Instalação e Manutenção", aquando do passo anterior.
Depois de seguidos todos os passos anteriores, o utilizador está apto a entrar de forma segura na nova v28.
8. Upgrade no PHC CS desktop Manufactor (caso exista)
Partindo do pressuposto que todos os passos acima foram efetuados, na presença do PHC CS desktop Manufactor, existe também aqui alguma informação que deve ser seguida:
- A necessidade de executar setup segue as mesmas regras acima já referidas.
- O executável deverá ser recolhido, da mesma forma que também foi referida acima.
- O executável deverá ser colocado, na pasta já existente do Manufactor.
- Ao entrar na aplicação com o executável da nova versão, a aplicação irá efetuar de forma automática a Manutenção necessária às Base de Dados, tanto para uma Base de dados Unificada, como para uma Base de Dados isolada.
Após conclusão desta rotina a aplicação estará pronta a ser usada.
NOTA ADICIONAL:
Para o correto funcionamento da aplicação, devem ser observados os seguintes pontos:
1. O ODBC deve ser o mais atual tendo em conta a versão do SQL do cliente
Exemplos:
SQL 2008 R2 – SQL Native Client 10.0
SQL 2012, SQL 2014, SQL 2016 – SQL Native Client 11.0
SQL 2017 - ODBC Driver 13 for SQL Server
SQL 2019 - ODBC Driver 17 for SQL Server
2. A propriedade "Compatibility Level" da Base de Dados, seja o mais atual tendo em conta a versão do SQL do cliente, para validar essa informação deve, no nó "Databases" do Managament Studio, selecionar a Base de Dados em questão, com o botão direito do rato sobre a BD escolher a opção "Properties", selecionar depois na lista de opções a opção "Options", existe aqui a opção "Compatibility level" que deve ser verificada, e eventualmente alterada.
3. A Collation do servidor seja SQL_Latin1_General_CP1_CI_AI e é também necessário que a Collation da base de dados seja exatamente a mesma.
Para validar essa informação deve, no selecionar o nome da instância SQL, com o botão direito do rato sobre o nome, escolher a opção "Proprerties", selecionar depois na lista de opções a opção "Options", observa a propriedade "Server Collation".
Para validar a collation da Base de Dados, no nó "Databases" do Managament Studio, selecionar a BD em questão, com o botão direito do rato sobre a BD escolher a opção "Proprerties", selecionar depois na lista de opções a opção "Options", e verificar a propriedade "Collation".