Orientar o usuário configurar o ambiente de Portal voltado para utilização de projetos customizados do mesmo do nosso portfolio.
Necessário que o ambiente tenha criado ou atualizado as pastas, para isso executar o Restore em sua maquina. 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.
Com o ambiente atualizado/criado e IIS configurado de acordo com os manuais acima, deve atualizar o seguinte diretório local C:\RM\Legado\{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.
- Lib DN-TFS: Copiar ultima versão de artefatos Web da Lib DN
- Pasta ambiente Local: Colar a copia de artefatos em ambiente local respeitando o caminho de diretório do TFS
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">
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
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:
- 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
- Para realizar a configuração do Projeto Instalador acesse:
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.
- Crie uma pasta com a estrutura mesma estrutura em que os arquivos customizados ficam no Portal: FrameHTML e Corpore.Net
- Compile o projeto que você deseja gerar o instalador
- 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
- Copie os arquivos e cole na pasta FrameHtml/Bin criada no passo 1
- Repita o passo 3 para a pasta Corpore.Net e cole na pasta criada Corpore.Net/Bin
- 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 )
- Compacte a pasta que você criou para a geração do instalador
- Acesse:
- 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