Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

  1. Visão Geral
  2. Exemplo de utilização
  3. Tela Atualiza DW
    1. Outras Ações / Ações relacionadas
  4. Tela Atualiza DW
    1. Principais Campos e Parâmetros
  5. Tabelas utilizadas

01. VISÃO GERAL

Atualizar a versão do ambiente Data Warehouse (DW) possibilitando o acompanhamento dos status da atualização em tempo real.

...

  • A aplicação deve ser executada em um sistema operacional homologado.
  • É necessário ter o .Net NET Framework v44.78 ou superior instalado.
  • É necessário ter o Oracle Client 32-bit com o arquivo tnsnames.ora configurado.
  • É necessário que o owner CONSINCO tenha privilégio ao dicionário de dados do Oracle (“select any dictionary”).
  • É desejável que o owner CONSINCO tenha privilégio para encerramento de sessões (“alter system kill”).
  • Para usuários não administradores que não tenham permissão de alterar o arquivo Consinco.ini, o Windows pode replicar o arquivo para o diretório Virtual Store (%UserProfile%\AppData\Local\VirtualStore) e gerar confusão no apontamento do banco de dados da aplicação.
  • A partir da versão 21.02 é necessário que a versão do ERP seja igual ou superior à versão do DW para executar a atualização.

Passo a passo

Para utilizar a aplicação faça o login informando o usuário e senha de acesso.

O campo ‘Conexão’ informará em qual base de dados será feito o login. As conexões exibidas para seleção são as que estão cadastradas no Consinco Menu.

Primeiro Acesso

No primeiro acesso a aplicação, será verificado se os parâmetros de conexão com a base de dados do DW estão configurados. Caso não estejam, será solicitado que os dados de conexão sejam informados, conforme mensagem abaixo.

...

Se houver objetos inválidos na base, ao fazer o login, será exibido uma mensagem de aviso, conforme imagem abaixo. Verifique se são objetos oficiais, e, se necessário, reporte-os ao suporte ConsincoTOTVS Varejo Supermercados.

Nota

É importante que não haja objetos inválidos, mas isso não impede que a atualização seja executada.

...

Durante o processo de atualização será exibido o status da execução, informando o andamento total e por tarefas.

Image Removed

Total: Exibe o andamento do total de arquivos da versão.

...

Ao finalizar a atualização, se houver objetos inválidos, será exibida uma mensagem de aviso. Verifique se são objetos oficiais, e, se necessário, reporte-os ao suporte TOTVS Varejo Supermercados. É importante que não haja objetos inválidos no banco de dados.

Image RemovedImage Added

Histórico de Execução

A aplicação exibirá o histórico de execução de cada arquivo, informando o tempo da execução e se houve ou não falhas durante a execução do arquivo. Se ocorrem falhas durante a execução da atualização, elas serão exibidas em tela conforme imagem abaixo.

Image RemovedImage Added

Em caso de dúvidas, reporte as falhas ao suporte ConsincoTOTVS Varejo Supermercados. É possível exportar as falhas para um arquivo único compactado para envio ao suporte por meio do botão ‘Exportar’.

Image RemovedImage Added

Algumas falhas são obsoletas e, na maioria das vezes, são irrelevantes, pois indicam que os objetos já foram criados (como por exemplo, índices, colunas ou tabelas) e ou não demandam nenhum tipo de análise do suporte.

Por padrão, as falhas obsoletas não são exibidas, para consultá-las clique na opção ‘Mostrar falhas obsoletas’, conforme imagem abaixo.

Image RemovedImage Added

Histórico de Atualizações

O histórico ficará gravado na base de dados, para consultá-lo acesse o botão ‘Histórico de Atualização’, escolha a atualização e clique na lupa ou dê duplo clique na linha para visualizar o log de erros.

Image RemovedImage Added

Serão exibidos os logs de erros gerados durante a execução da atualização selecionada.

Image RemovedImage Added

Para consultar os detalhes do erro, selecione a linha e dê duplo clique na coluna ‘Comando’ ou na coluna ‘Falha’, conforme exemplo abaixo.

Image RemovedImage Added

É possível salvar os logs com as falhas em arquivo texto, caso seja necessário encaminhá-las para o suporte. Para exportar as falhas, clique no botão ‘Salvar Relatório’.

Image RemovedImage Added

Selecione a pasta em seu computador onde serão armazenados os arquivos.
Se deseja exportar apenas os erros críticos, na mensagem ‘Exportar somente erros críticos?’, clique em ‘Sim’.

Image Removed

Uma mensagem final será exibida informando que a exportação foi concluída.

Image Removed

03. TELA Atualiza DW

Outras Ações / Ações relacionadas

Não há.

04. TELA Atualiza DW

Principais Campos e Parâmetros

Não há.

05. TABELAS UTILIZADAS

Não há.

...

Image Added

Execução em modo silencioso

A aplicação pode ser inicializada com passagem de parâmetros conforme descrito abaixo:

  • autoexec
    Usado para que a execução se inicie sem interação humana, ou seja, execução silenciosa.
  • salvalog
    Usado para informar a geração de log da aplicação. Serão criados arquivos na pasta Logs, no mesmo diretório da aplicação, tendo como padrão o nome como “log_ddMMyyyyHHmmss.json”.
  • -c <servidor> <usuário> <senha>
    Para informar a conexão com a base de dados, deve-se utilizar o marcador -c seguido do servidor, usuário e senha, nessa ordem e sempre com essas informações. A aplicação irá buscar no TNSNAMES os dados de conexão, então é preciso que o arquivo esteja configurado corretamente.
  • tipoAmbiente=<ambiente>
    Usado para informar se o ambiente é de Produção ou Homologação. Se o parâmetro não for informado, será considerado ambiente de produção. Valores possíveis: P (produção) ou H (homologação).

Os parâmetros podem ser informados em qualquer ordem, exceto o parâmetro de conexão que, ao informar o marcador, deve seguir a ordem estabelecida na documentação. Os dados de conexão são obrigatórios.

Ao executar em modo silencioso, um ícone de sistema irá exibir as informações atuais da execução, conforme imagem abaixo.

Image Added

Os arquivos de log gerados, seguem o modelo de exemplo abaixo.

Bloco de código
firstline1
titlelog_20210208114056.json
linenumberstrue
collapsetrue
{
  "nomeExecutavel": "AtualizaDW.exe",
  "id": 1,
  "sistemaOperacional": {
    "nome": "Windows 10 Pro",
    "versao": "10.0.19042.0",
    "build": "19042",
    "release": "2009"
  },   "nivel": "Alerta", 
"dominio": "SP01",
"nomeMaquina": "RBPN019403893",
"nomeUsuario": "vitor.gilioli",
"dataHora": "08/02/2021 11:40:56",
"mensagem": "Atualização finalizada com algumas falhas.\nTempo decorrido de atualização: 00:02:19",
"detalhes": "",
"stack": "",
"palavrasChave": [ ".net", "inicialização", "framework" ]
}
Bloco de código
firstline1
titlelog_20210208150746.json
linenumberstrue
collapsetrue
{
  "nomeExecutavel": "AtualizaDW.exe",
  "id": 1,
  "sistemaOperacional": {
    "nome": "Windows 10 Pro",
    "versao": "10.0.19042.0",
    "build": "19042",
    "release": "2009"
  },
  "nivel": "Erro",
  "dominio": "SP01",
  "nomeMaquina": "RBPN019403893",
  "nomeUsuario": "vitor.gilioli",
  "dataHora": "08/02/2021 15:07:46",
  "mensagem": "Não é permitido abrir mais de uma instância pois o módulo já esta sendo executado.\n\nTerminal: RBPN019403893\nUsuário O.S: vitor.gilioli",
  "stack": "",
  "palavrasChave": [ "consinco", "atualiza", "versão", "aplicação", "DW" ]
}
Bloco de código
firstline1
titlelog_20210208151109.json
linenumberstrue
collapsetrue
{
  "nomeExecutavel": "AtualizaDW.exe",
  "id": 0,
  "sistemaOperacional": {
    "nome": "Windows 10 Pro",
    "versao": "10.0.19042.0",
    "build": "19042",
    "release": "2009"
  },
  "nivel": "Sucesso",
  "dominio": "SP01",
  "nomeMaquina": "RBPN019403893",
  "nomeUsuario": "vitor.gilioli",
  "dataHora": "08/02/2021 15:11:09",
  "mensagem": "Atualização finalizada.\nTempo decorrido de atualização: 00:02:19",
  "stack": "",
  "palavrasChave": [ "consinco", "atualiza", "sucesso", "atualização", "DW" ]
}

Exemplo de chamada

"AtualizaDW.exe" autoexec salvalog -c orapd devupdate devupdate tipoAmbiente=P

Código de Saída

A aplicação irá lançar um código de saída (exitCode) com o valor 0, caso tenha finalizado a execução com sucesso ou o valor 1 caso tenha apresentado algum erro durante a execução. Para ambas as situações, se for passado o parâmetro salvalog, a aplicação irá gerar sempre o arquivo de log referente ao momento de encerramento da aplicação, seja por sucesso ou erro.