Tempo aproximado para leitura: 00:03:00 min
Dúvida
Como realizar o upload de programas no Datasul, utilizando a ferramenta de upload?
Ambiente
Cloud - Linha Datasul - Todas as versões
Solução
A ferramenta de Upload tem por finalidade facilitar o processo de publicação de programas específicos e especiais na estrutura do Cloud da Totvs. Para realizar upload de programas especiais e específicos utilizando a ferramenta de upload, siga o passo a passo a seguir:
1 – Para realizar o upload de programas, execute o FTC005 em pesquisar , ou via menu Cloud - Ferramentas, Tarefas, Upload de Programas conforme abaixo:
2 - Com o programa Upload aberto, você pode selecionar o tipo de ação que deseja realizar como:
Progress - Específicos/Customizados (Fontes) => Publicação dos programas específicos, novos programas específicos, correções ou melhorias em programas já publicados anteriormente.
Progress - Liberação Especial (Compilados) => Publicação de programas complementares enviados pela Totvs, fix adicionais expeditos para correção de erros.
Tomcat - WebApps Customizações THF (.war) => Publicação de arquivos do tipo (.war) que consiste em customizações para a arquitetura TOMCAT.
Tomcat - Datasul-report (Relatórios) => Publicação de arquivos referente à geração de relatórios dentro do ERP da Linha Datasul da TOTVS, para diversos módulos como contabilidade, custos, produção e fluxo de caixa.
Durante a abertura do programa será realizada uma validação de todos os servidores do ambiente para garantir que o processo atualize toda a estrutura do produto. Esta etapa leva um tempo e no painel inferior da ferramenta, você pode acompanhar os testes sendo realizado. Cada servidor validado, gera uma informação de OK ao término da validação. Quando toda a estrutura estiver testada a ferramenta será liberada para o uso.
Utilização para publicação de específicos:
Para atualização de específicos Progress, temos duas opções de envio de programa: "Compilar" e "Copiar". Com a opção "Compilar", o programa específico será compilado pela ferramenta antes de subirmos o problema para a estrutura do Cloud. A opção "Copiar" faz apenas a cópia do programa. Esta opção de "Copiar" deve ser utilizada quando o desenvolvedor deseja enviar os arquivos compilados (arquivos .p/.w/.wrx com o seu respectivo .r) ou para programa que foi liberado em formato encriptado (.r).
Caso o programa específico necessite de compilação caractere (programas que serão executados em uma interface caractere como coletor de dados via FTP ou SFTP), é preciso marcar a opção "Compilação WinChar(Caracter)".
A opção "V6Display" é utilizada para liberação de programas do Datasul Saúde, que necessitam de compilação com uma opção especial liberada no compilador.
No programa FTC005 temos duas informações com relação a estrutura de diretórios "Diretório Cloud" que se trata do diretório de publicação dos arquivos no Cloud da Totvs e "Diretório Upload", onde vamos apontar de onde os arquivos serão carregados para a estrutura do Cloud.
Para o "Diretório Upload", selecione uma pasta onde estão os arquivos que serão enviados para a estrutura do Cloud, são os arquivos que estão sendo ajustados no caso de específicos e liberações especiais.
Importante que a estrutura do "Diretório Upload" reflita a mesma estrutura das pastas no Cloud com diretórios e subdiretórios. Para publicar um programa que está dentro de uma subpasta exemplo, no "Diretório Cloud" o programa está na pasta /prghur/esp/espfp0001.p você deve ter a mesma estrutura na pasta "Diretório Upload".
Para entender a estrutura de pastas que estão configuradas no Cloud, basta acessar o botão de "LUPA" do "Diretório Cloud"
Ao selecionar a LUPA será aberta a estrutura dos arquivos dentro do Cloud, onde estão os arquivos específicos ou especiais.
A pasta do ambiente é a informação da estrutura (p=produção, t=teste e q=Homologação) os demais diretórios são a estrutura dos programas e subpastas.
Para publicar o programa na pasta correta, quando indicarmos o diretório de UPLOAD, devemos ter a mesma estrutura da pasta e subpastas do diretório de específicos.
A pasta de "Liberação Especial", não deve conter as pastas /EMS2/FND/EMS5/HCM/GP, apenas os subpastas e programas liberados. Exemplo, na liberação de um programa especial de correção que foi enviado pela TOTVS, ao descompactar o programa podemos ter a estrutura EMS2/ccp/ccpXXXX.r, a publicação no diretório de liberações especiais deve ficar como ccp/ccpXXXXX.r. Com isso basta baixar os pacotes no "Diretório Upload" sem a pasta EMS2 e fazer o processo de Iniciar o Upload.
Para montarmos o ambiente de trabalho, onde faremos os ajustes e desenvolvimento de novos programas (Diretório Upload), podemos fazer a importação da estrutura de pastas a partir do botão de LUPA no Diretório Cloud, basta clicar nas pastas e fazer o download das pastas e programas.
Com esta ação, toda a pasta de programas específicos será baixada para o diretório V:\CLOUD (diretório local na máquina do usuário). Importante ficarmos atentos porque a pasta de programas específicos pode ser grande e levará algum tempo para baixarmos toda a estrutura. Se você estiver trabalhando em um único arquivo, recomendamos que você faça o upload apenas da estrutura que você está trabalhando.
Com os arquivos que quero trabalhar na minha máquina ou na máquina de desenvolvimento do Cloud, é possível fazer o ajuste no programa e fazer o processo de upload com a compilação do programa.
Para o processo de Upload serão feitas algumas perguntas que devem ser respondidas para o avanço da atividade.
Você pode associar o processo de upload a um ticket para questão de organização do motivo do processo de upload.
Você pode fazer backup dos programas que serão carregados. Sugerimos que seja escolhida uma pasta adicional para fazer o processo de backup para não criarmos uma pasta de backup dentro da estrutura de programas específicos ou especiais (exemplo: V:\temp\bkp). Em caso de necessidade de restauração de algum componente específico, basta limpar o "Diretório Upload" e copiar a pasta e arquivo que você pretende restaurar do backup.
Feito o processo de backup, é feita a compilação dos programas e será solicitada confirmação da copia dos arquivos para a estrutura.
Após o processo de upload do programa você pode novamente avaliar a LUPA e identificar se o programa foi compilado corretamente.
Os pacotes fechados (sem arquivos fontes) enviados por canais de desenvolvimento Totvs, parceiros TOTVS ou terceiros (geniality, xmlloader, etc) devem ser carregados sem compilação através da opção de Copiar.
Como não teremos arquivos fontes envolvidos no processo, apenas arquivos compilados neste cenário, não há necessidade de execução do compilador apenas faremos a cópia.
A estrutura de pastas e subpastas deve ser respeitada para que não tenhamos duplicidade de pastas no ambiente.
Utilização para publicação de especiais:
Reforçando o entendimento sobre publicação de especiais, vamos imaginar o cenário onde você recebeu de alguma área de suporte da Totvs (Financeiro, RH, Estoque, Materiais, etc) um pacote complementar de correção ou de negócio e precisa publicar este pacote na estrutura de programas do Datasul.
Para esta ação você deverá descompactar o pacote no "Diretório Upload" sem a estrutura de área do pacote (pasta EMS2/EMS5/HCM/GP/EAI/EAI2/CRM) e fazer o processo de upload da "Liberação Especial".
Perceba que o "Diretório Cloud" neste caso mudou apontando para a pasta onde estão publicados os pacotes complementares do Datasul.
Também podemos utilizar a LUPA para avaliar a estrutura e identificar algum pacote anteriormente publicado. E também a possível exclusão do programa via ação de exclusão.
Caso de uso: Recebemos via chamado um pacote complementar para baixarmos na estrutura Datasul (lib_20744899_12.1.2403.6.zip).
Ao descompactarmos o pacote foi criada uma pasta com o nome do arquivo baixado (lib_20744899_12.1.2403.6) nesta pasta foi descompactado o diretório e o programa .r liberado (ecp/ec0003b.r).
Copiamos para o "Diretório Upload" a pasta ecp/ec0003b.r e subimos o arquivo.
A pasta utilizada para o processo de Upload do arquivo contem apenas o pacote liberado. Por segurança, você pode criar uma pasta na máquina local apenas para a publicação de especiais.
Será solicitada a opção de associação com algum ticket para efeito de controle e o se deseja fazer o backup dos programas caso já exista alguma liberação especial.
Após subir o pacote especial, você pode pela opção de LUPA no "Diretório Cloud" conferir o pacote publicado.
Utilização para publicação de Customizações THF (.war)
Para a publicação de arquivos do tipo (.war) que consiste em customizações para a arquitetura TOMCAT, selecione a opção "Tomcat - WebApps Customizações THF (.war)".
Para o "Diretório Upload", selecione a pasta onde estão os arquivos com extensão (.war) que serão enviados para a estrutura do Cloud.
A estrutura do "Diretório Upload" não tem um especificação, basta que os arquivos do tipo mencionados acima estejam dentro da pasta selecionada. Importante que não tenham arquivos de outras extensões.
Arquivos do tipo (.war):
Para entender a estrutura de pastas que estão configuradas no Cloud, basta acessar o botão de "LUPA" do "Diretório Cloud"
Utilização para publicação de relatórios (Datasul-report)
Para a publicação de arquivos do tipo TOTVS Datasul-report que refere-se à funcionalidade de geração de relatórios dentro do sistema de gestão empresarial (ERP) TOTVS Datasul, selecione a opção "Tomcat - Datasul-report (Relatórios)".
Para o "Diretório Upload", selecione o local onde estão os sub-diretórios do diretório datasul-report que serão enviados para a estrutura do Cloud.
Importante que a estrutura do "Diretório Upload" reflita a mesma estrutura das pastas no Cloud com diretórios e subdiretórios.
Para publicar um programa que está dentro de uma subpasta exemplo, no "Diretório Cloud" o programa está na pasta /datasul-report/cdp você deve ter a mesma estrutura na pasta "Diretório Upload". Neste caso deve ser selecionada até a pasta datasul-report.
Menu principal
Abaixo são apresentadas as opções do menu da ferramenta.
Ajuda -> Documentação do uso da ferramenta de Upload.
Alias -> Lista os alias configurados no ambiente e quando necessário permite a configuração/criação de novo alias.
Log -> Os registro das ações são listas nessa opção.
Propath -> Permite visualizar a ordem do propath e em casos específicos de compilação é possível realizar a alteração.
Exemplo de um caso:
Sessão -> Nesta opção são listadas as principais informações de sessão em caso de alguma necessidade de debug do uso da ferramenta.
0 Comentários