Fábrica de Software TOTVS BH

Atalhos

Páginas filhas
  • Configuração de Ambiente de Portal(Antigo/Novo) para Projetos Customizados

Versões comparadas

Versão antiga 8

changes.mady.by.user Pedro Henrique Rosa de Souza

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user Ana Carolina Eleuterio Abras

Gravado em

Chave

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

Configuração de Ambiente de Portal(Antigo/Novo) para Projetos Customizados

       

Índice
exclude.*ndice

Objetivo

Orientar o usuário configurar o ambiente de Portal voltado para utilização de projetos customizados do mesmo do nosso portfolio.

Toggle Cloak
idPreRequisitos
Pré-Requisitos


Cloak
idPreRequisitos

Necessário ter que o ambiente tenha criado ou atualizado as pastas ou atualizado, para isso executar o Restore em sua maquina. Segue o link da pagina do TDN do Restore para realização do processo, clique aqui. Dentro da pagina pode seguir a parte do Acesse o passo a passo e comece a usar,do manual   Acesse a pagina TOTVS Restore e verifique se os requisitos estão de acordo. Caso todos os requisitos tenham sido cumpridos acesse a pagina do Utilização do Novo Restore para realização do processo.

Com o ambiente criado ou atualizado é necessário realizar a configuração do portal (Antigo/Novo). Segue o link da pagina de configuração de portal do produto, clique aqui.


Configuração IIS

Caso não tiver o IIS criado ou configurado de acordo com o manual seguir os passos abaixo:

  •  Adicionar Aplicativo

Criar novos aplicativos para o Corpore.net e FrameHTML dentro do Default Web Site

  • Alias: Nome de seu novo Aplicativo;
  • Caminho Físico: Diretório de onde contempla sua pasta de ambiente do Corpore.net ou FrameHTML;
  • Autenticação pass-through: Autenticação para o diretório do aplicativo (Configuração de autenticação pode ser pelo usuário de rede).

Importante

Para casos em que estiver utilizando uma base de cliente ter atenção em relação a necessidade de alteração do caminho URL de acesso ao Portal RM ou Definir o endereço do FrameHTML nos itens 01 e 02 do manual de configuração de portal do produto, pois caso o cliente estiver em utilização da base e tiver alteração do endereço pode ter problema de acesso para o mesmo.


Após estiver com Com o ambiente atualizado/criado e IIS configurado de acordo com os manuais acima, deve atualizar o seguinte diretório local C:\RM\Legado\12.1.32{VERSÃOAMBIENTE}\FrameHTML\Web\App\Edu\PortalEducacional\js\cst-customizacao com o arquivo cst-customizacao.route.js, onde esta implementado todas as rotas dos projetos customizados(Para este procedimento pode pegar a ultima versão do caminho $/Customizacao/CustomizacaoRM/CNI/DN/0.Producao/_Principal/LibDN/Web/FrameHTML/web/app/Edu/PortalEducacional/js/cst-customizacao e colar no ambiente local). Este arquivo de rotas esta dentro da Lib DN. Sem o arquivo em seu ambiente todas as customizações voltadas para o DN Web não irão carregar sua customização corretamente no portal.

Caso dentro do diretório web da Lib DN-TFS tiver outros artefatos, deve seguir mesmo caminho copiar e colar em ambiente local.

  1. Lib DN-TFS: Copiar ultima versão de artefatos Web da Lib DN
  2. Pasta ambiente Local: Colar a copia de artefatos em ambiente local respeitando o caminho de diretório do TFS         

         


Importante

Este procedimento e voltado para a FrameHTML ou seja para o portal novo.

Toggle Cloak
idCriarMenuPortal
Criação Menu Portal (Novo/Antigo)


Cloak
idCriarMenuPortal

Feito a criação/atualização do ambiente para alguns projetos tem a ocorrência de criação de menus para o Portal Aluno ou Portal do Professor. Para esta ocorrência possui em projetos a necessidade de execução de script de criação para a tabela GMENUCUSTOM e GMENUHTML. A partir da execução do script pode ser verificado no RM se o mesmo possui sua criação de menu tanto para o portal novo quanto antigo.


Imagem dos Portais


Exemplar do projeto Fase Empresa - Portal Novo


Tela de Edição do Fase Empresa


Exemplar do projeto Fase Empresa - Portal Antigo


Tela de Edição do Fase Empresa - Portal Antigo


Toggle Cloak
idDebugPortalAntigo
Debug Portal Antigo


Cloak
idDebugPortalAntigo

Caso o desenvolvedor quiser realizar o debug no portal antigo de alguma customização mas o mesmo não está ocorrendo com sucesso, verificar no arquivo Web.config a tag compilation. Por padrão na geração ou atualização de ambiente do Corpore.Net a tag e criada desta forma:

<compilation defaultLanguage="c#" debug="false" targetFramework="4.7">

Para realizar o debug somente altere o valor da propriedade debug para true.

<compilation defaultLanguage="c#" debug="true" targetFramework="4.7">

Toggle Cloak
idProjetosCustomizados
Projetos Customizados WEB - DN


Cloak
idProjetosCustomizados

De acordo com o escopo do projeto, pode haver na pasta WEB as subpastas Corpore.Net e FrameHtml. Copie e cole os arquivos do TFS de acordo com o seu escopo.

Exemplar do projeto Fase Empresa TFS

No exemplo do projeto do Fase Empresa o mesmo possui customização Web nos dois portais antigo e novo (Corpore.Net, FrameHtml).



Imagem de Copia de Arquivos para a pasta Corpore.net do projeto de acordo com o TFS

Imagem de Copia de Arquivos para a pasta FrameHTML do projeto de acordo com o TFS

Imagem de Copia de Arquivos para a pasta FrameHTML do projeto de acordo com o TFS


Toggle Cloak
idGeracaoProjInstalador
Geração de Novo Projeto Instalador - Portal da Fábrica


Cloak
idGeracaoProjInstalador

Este manual tem como objetivo auxiliar na criação e cadastro de um novo projeto no portal da fábrica para a geração de instaladores.

Para cadastrar um novo projeto instalador e para que ele apareça também no Hefesto (mais utilizado para gerador de instalador WEB) siga os seguintes passos:

  1. Lembre-se de fazer o check-in de todos os arquivos do projeto pois durante a geração do instalador ele faz um GET no projeto através do caminho adicionado na variável "Caminho do projeto no TFS" durante a configuração do Projeto Instalador
  2. Para realizar a configuração do Projeto Instalador acesse:

teste

Imagem da tela Cadastro de um novo Projeto Instalador

Cadastro novo Projeto Instalador

  • Descrição: Nome do Projeto do Instalador
  • Cliente: nome ou sigla do cliente
  • Caminho TFS do Projeto: Caminho base do projeto do TFS. Ex.: ($/Customizacao-BH/CNI/FIEP/0.Producao/Principal/Oficina)
  • Caminho TFS da Solution do Visual Studio: Caminho para a Solution do Projeto no TFS. Ex.: ($/Customizacao-BH/CNI/FIEP/0.Producao/Principal/Oficina/Win)
  • Nome da Solution do Visual Studio: Nome exatamente igual à solution do projeto
  • Caminho para arquivos de terceiros: Informar o caminho do TFS caso exista arquivos que não fazem parte do projeto e que devem estar dentro do instalador junto com as DLLs. Ex: Scripts do Executor
  • Versão: Informar qual a versão do RM as DLLs foram compiladas (Essa versão é importante para os projetos da engenharia que são referenciados nos projetos).
  • Marcar a opção Executa Sonar Qube

Projetos Referenciados


PS: Os projetos devem ser colocados em ordem de dependência, ou seja, caso um projeto dependa do outro para compilar, o mesmo deve estar abaixo do projeto que ele precisa da dependência na lista

Geração Instalador WIN

Após a criação do Projeto Instalador ou caso já exista pode seguir para a geração dos instaladores.

A geração de instaladores é mais simples, basta acessar:


Após abrir o portal irá aparecer o formulário para preencher qual o projeto que você deseja gerar o instalador conforme as imagens abaixo:

Neste formulário você vai preencher o cliente e depois o Projeto, selecione sempre o projeto com o NOMEDOPROJETO + Win

Depois de preencher basta clicar em Gerar Instalador e caso ocorra algum erro na geração você receberá um e-mail informando qual o erro, se der certo você também receberá um e-mail informando que ocorreu corretamente e o link para central de downloads do instalador.

Geração de Instalador WEB

Para facilitar a geração do instalador pegue como base os arquivos de algum instalador já gerado anteriormente, pois você vai precisar preparar os arquivos para a geração do instalador.

  1. Crie uma pasta com a estrutura mesma estrutura em que os arquivos customizados ficam no Portal: FrameHTML e Corpore.Net
  2. Compile o projeto que você deseja gerar o instalador
  3. Na pasta que possui a sua instalação RM copie todos os Arquivos que começam com "RM.Cst" no caminho: RM/Legado-ou-Atual/Versão/FrameHtml/Bin
  4. Copie os arquivos e cole na pasta FrameHtml/Bin criada no passo 1
  5. Repita o passo 3 para a pasta Corpore.Net e cole na pasta criada Corpore.Net/Bin
  6. Caso existam páginas de portal as mesmas devem ficar na mesma estrutura dentro das pastas FrameHTML e CorporeRM. Ex: (FrameHTML\web\app\Cst\CNI_DN\fase-empresa ou ) 
  7. Compacte a pasta que você criou para a geração do instalador
  8. Acesse:
  9. Informe todas as informações necessárias para gerar o instalador assim como na geração WIN

Informe o nome do cliente, versão, Projeto e versão do instalador

10. Avance e selecione TIPO DE INSTALAÇÃO como WebForms

11. Caso queira altere o texto que irá aparecer no seu instalador

12. Nessa parte use a caixa de upload para adicionar a pasta com os arquivos .Zip que você criou nos passos anteriores e após o upload clique em visualizar os Arquivos Selecionados

Após executar todo esse processo basta clicar em Gerar Instalador

Informações
iconfalse
Informações
iconfalse

Produto: Customizações

Versão: 11.80 ou Superiores
Informações
iconfalse

Data: 

Informações
iconfalse
titleAutores

Pedro Henrique Rosa de Souza