Como criar projetos em ASP.NET 2.0

Como criar projetos em ASP.NET 2.0 VERSÃO: 1.0 Data: 04/04/2009 Rua do Ouvidor, 97 6 andar Centro CEP: 20040-030 Rio de Janeiro RJ - Telefax: +55 21 2509-0332 http://www.sv.com.br

1. Introdução Este manual tem a finalidade ensinar a criar um projeto do início usando a arquitetura e padrões adotados pela SV para execução de projetos na plataforma ASP.NET na linguagem C#. Os projetos podem ser criados usando as bases de dados SQL Server 2000, Oracle 8i e Oracle 9. Estamos levando em consideração que já foi criada uma base de dados no banco de dados escolhido para o projeto e que a mesma está modelada de forma correta tendo as devidas chaves primárias em cada tabela e com os devidos relacionamentos aplicados entre tabelas. Outro ponto importante é que na modelagem devem ser aplicados os padrões de modelagem da SV. Caso não esteja no padrão da SV terão que ser customizados novos templates para esta base que está fora do padrão. 2. Softwares Utilizados Mygeneration 1.3 Visual Studio 2008 3. Criando a Base do Projeto com o MyGeneration O MyGeneration é utilizado para gerar as classes de negócios, de acesso a dados e as stored procedures com base em templates da arquitetura doodas. Mais informações sobre a arquitetura em: http://www.mygenerationsoftware.com/portal/doodads/overview/tabid/63/de fault.aspx Referência rápida do doodas: http://www.mygenerationsoftware.com/doodads/doodadsquickrefcsharp.pdf Documentação Online: http://www.mygenerationsoftware.com/portal/documentation/doodads/tabid/ 66/Default.aspx a) Abra o MyGeneration e vá em File > Default Settings b) Na aba Connection escolha o driver do banco de dados que deseja utilizar. No campo abaixo, coloque a connection string que deve ser utilizada para se conectar ao banco de dados. a. Para SQL Server: Provider=SQLOLEDB.1;Data Source=SERVIDOR;Initial Catalog=BANCO;User Id=USUARIO;Password=SENHA; b. Para Oracle: c) Na parte de Language Mapping,no campo Language escolha o C#.

d) Na parte de Database Target Mapping, no campo DbTarget escolha: a. Para SQL Server: SqlClient b. Para Oracle: c. Para Postgre: Npgsql e) Clique no botão Teste Connection. Se tudo estiver correto a mensagem que deve aparecer é Connection Successful! Conforme a figura 1. Figura 1 f) Na parte Saved Connections escreva um nome para sua conexão e clique no botão Save. Na próxima vez que precisar usar este banco de dados para gerar alguma classe basta escolher a sessão salva e clicar no botão Load. Figura 2 Itens a,b,c,d e f

g) Vá agora para aba Templates. No campo Default Template Path coloque o caminho K:\_Templates_Programacao\dOOdas\Padrao_SV\. Esta etapa é importante porque você está optando por utilizar os templates que estão na nossa rede. Estes templates podem ser atualizados por uma questão de melhoria contínua. Desta forma, você está garantindo que sempre estará utilizando a última versão dos templates do padrão da SV. Nota: Caso ache necessário realizar uma melhoria no template, submeta a gerência para que possamos realizar testes com a melhoria sugeria. Depois de homologada será acoplada ao template geral usado por todos. h) Ainda na aba Templates e no campo Default Output Path e coloque um diretório de arquivos temporários em sua máquina. Você também pode usar o diretório default do MyGeneration. É neste diretório que as classes geradas por ele serão gravadas. Caso mude, clique no botão Save depois. i) Feche agora a janela Default Settings no X logo acima do botão Cancel. j) Na lateral esquerda da janela existe a palheta de templates chamada de Templates Browser. Clique nela para expandir e depois clique na tachinha para deixar ela fixa. Verifique se o segundo botão da palheta ( )não está acionado. Devem ser exibidos os templates pelo Namespace e não por File. A pasta SV não deve ser exibida. Confira na figura 3. Figura 3 k) Clique na pasta doodads para expandir e depois clique na pasta C#. Clique duas vezes para abrir o template doodads Business Entity. O template será aberto com cinco abas conforme a figura 4.

Figura 4 l) Logo abaixo do menu, na barra de ferramentas existe o botão Play (seta verde) para executar o template. Clique nele. Será aberta uma tela. m) Preencha o campo Namespace com o valor DataAccess usando caixa alta e baixa exatamente como está escrito aqui. No campo Select a database já deve vir selecionado o banco de onde você pretende gerar as classes. Caso não esteja, selecione o banco correto. As tabelas do banco selecionado serão exibidas abaixo no campo Select tables. Escolha usando a tecla CTRL do seu teclado as tabelas que você quer gerar as classes. Marque os campos Prefix the File with an underscore e Trim spaces from output filename. Confira a figura 5. Clique em OK depois. Quando terminar a geração dos templates a aba Output será exibida.

Figura 5 n) Agora clique duas vezes sobre o template doodads Concrete Class. Logo abaixo do menu, na barra de ferramentas existe o botão Play (seta verde) para executar o template. Clique nele. Será aberta uma tela. Preencha o campo Namespace com o valor Business usando caixa alta e baixa exatamente como está escrito aqui. No campo Select a database já deve vir selecionado o banco de onde você pretende gerar as classes. Caso não esteja, selecione o banco correto. As tabelas do banco selecionado serão exibidas abaixo no campo Select tables. Escolha usando a tecla CTRL do seu teclado as tabelas que você quer gerar as classes. Clique no botão OK. Quando terminar a geração dos templates a aba Output será exibida. Confira a figura 6.

Figura 6 o) Agora clique duas vezes sobre o template doodads Business View. p) Este passo agora deve ser executado somente se a base de dados for SQL Server. Volte na palheta de templates e clique em Microsoft SQL Server. Clique duas vezes sobre o template doodads Stored Procedures. Logo abaixo do menu, na barra de ferramentas existe o botão Play (seta verde) para executar o template. Clique nele. Será aberta uma tela. No campo Select a database já deve vir selecionado o banco de onde você pretende gerar as classes. Caso não esteja, selecione o banco correto. As tabelas do banco selecionado serão exibidas abaixo no campo Select tables. Escolha usando a tecla CTRL do seu teclado as tabelas que você quer gerar as classes. Clique no botão OK. Quando terminar a geração dos templates a aba Output será exibida. Confira a figura 7.

Figura 7 Nota: Caso você esteja fazendo a manutenção em um sistema que está construído neste padrão,você deve marcar a opção Use ALTER procudures. Isto porque as stored procedures desta tabela já existem no banco de dados, logo se você rodar o script criado sem esta opção marcada ocorrerá um erro informando que você está tentando criar stored procedures que já existem no banco. q) Este passo agora deve ser executado somente se a base de dados for Oracle. 4. Criando o Projeto com o Visual Studio 2008 a) Abra o Visual Studio 2008. b) Abaixo do menu File existe um ícone na forma de globo. Clique na seta ao lado dele e escolha a opção New Web Site ou use as teclas de atalho Shift + Alt + N. Será aberta uma janela. No combo superior direito troque de.net Framework 3.5 para.net Framework 2.0. No item Visual Studio installed templates escolha a opção ASP.NET Web Site. Certifique-se que o local de criação do projeto seja C:\inetpub\wwwroot\NOME_DO_PROJETO. Na opção

Language verifique se a opção escolhida é a Visual C#. Confira a figura 8. Clique em no botão Ok. Figura 8 c) Assim que o VS 2008 terminar de criar o projeto, feche a página Default.aspx que estará aberta. Abra o Windows Explorer e vá até a pasta da rede K:\_Templates_Programacao\AspNet_2.0\Aplicacao\. Selecione todo o conteúdo desta pasta e copie. Volte ao VS2008. No canto superior direito da tela está a palheta Solution Explorer. Expanda ela e clique ta tachinha para fixá-la. Clique com o botão direito do seu mouse em cima da raiz do seu Website. Escolha a opção Paste do menu que será aberto. Quando o VS 2008 pergunta se quer sobrescrever arquivos existentes, diga sempre que SIM. Confira a figura 9 de como o seu projeto deve ficar.

Figura 9 d) Ainda na palheta de Solution Explorer, abra a pasta bin. Nela haverá duas pastas. Uma chama Oracle e outra chamada SQLServer. De acordo com o banco de dados a ser usado o conteúdo da pasta deve ser movido para a pasta bin e as demais pastas devem ser apagadas. Exemplo: Se o projeto é com SQL Server, copie o conteúdo desta pasta para a basta Bin. Apague a pasta SQL Server e Oracle. e) Ainda na palheta de Solution Explorer, abra a pasta bin. Nela haverá duas pastas. Uma chama Oracle e outra chamada SQLServer. De acordo com o banco de dados a ser usado o conteúdo da pasta deve ser movido para a pasta bin e as demais pastas devem ser apagadas. Exemplo: Se o projeto é com SQL Server, copie o conteúdo desta pasta para a basta Bin. Apague a pasta SQL Server e Oracle. MESMA ROTINA PARA BASEENTITY NA PASTA APPCODE_DATAACCESS. f) Vamos agora voltar a pasta onde foram criadas as classes pelo MyGeneration. Selecione os arquivos que estão com prefixo underscore _ acrescido do nome das tabelas do banco de dados e com a extensão (.cs). Copie estes arquivos. Volte ao VS 2008 e na palheta Solution Explorer expanda a pasta App_Code e depois a pasta DataAccess. Cole os arquivos selecionados na pasta do MyGeneration para esta pasta DataAccess. g) Vamos novamente à pasta onde foram criadas as classes pelo MyGeneration. Selecione desta vez os arquivos que possuem o nome das tabelas do banco de dados com a extensão (.cs). Copie estes arquivos. Volte ao VS 2008 e na palheta Solution Explorer expanda a pasta App_Code e depois a pasta Business. Cole os arquivos selecionados na pasta do MyGeneration para esta pasta Business. Confira a figura 10 para verificar como fica após a execução destes dois últimos intens.

Figura 10 h) Vamos agora testar para ver se o projeto apresenta algum erro de compilação para podermos passar para a próxima fase. Vá no menu Build e clique na opção Build Web Site. O resultado deve ser a mensagem abaixo: Validation Complete ========== Build: 1 succeeded or up-to-date, 0 failed, 0 skipped ========== NOTA: Porque no item A criamos uma aplicação do tipo WebSite? 5. Criando as Stored Procedures no Banco de Dados A arquitetura doodas é baseada em Stored Procedures. Para cada tabela são criadas cinco Stored Procedures. A composição do nome de cada Stored Procedure é: prefixo proc_ + Nome da Tabela + Função. Abaixo mostramos o exemplo de cada uma das cinco e explicamos suas funções. proc_nome_tabelaloadbyprimarykey Responsável por carregar os registros pela chave primária da tabela; proc_nome_tabelaloadall Responsável por carregar todos os registros da tabela; proc_nome_tabelaupdate Responsável por fazer o update de um registro na tabela;

proc_nome_tabelainsert Responsável por fazer a inserção de um registro na tabela; proc_nome_tabeladelete Responsável por apagar um registro na tabela; Procedimento para Projetos em SQL Server a) Abra o SQL Server Enterprise Manager. Entre no servidor sql01.sv.com.br. Caso ele ainda não esteja configurado basta registrar um novo servidor com o endereço sql01.sv.com.br. Na autenticação escolha a opção The Windows account information I use to logon to my computer [My Windows Authentication]. Acessado o servidor navegue até o banco de dados do projeto e clique no item Tables. Caso o acesso ao banco do projeto seja negado abra uma tarefa no Tasker no projeto SV Suporte Interno solicitando acesso ao banco com a unidade Configuração de Aplicativo e a tarefa Gerência de Configuração. b) Com as tabelas listadas em seu monitor, vá no item Tools do menu e escolha a opção SQL Query Analyser. A ferramenta será aberta já no banco do projeto. Vá no item File do menu e escolha a opção Open. Navegue até a pasta onde foram criadas as classes do MyGeneration. Escolha o arquivo MicrosoftSQL_ALL.SQL e clique no botão Open. O script de criação de todas as stored procedures será aberto na ferramenta. Nota 1: Caso você esteja fazendo a manutenção em um sistema que está construído neste padrão, não utilize o arquivo MicrosoftSQL_ALL.SQL. No momento da utilização do template de criação das stored procedures (item 3p) são criados arquivos com script SQL para cada tabela (nome_tabela.sql) e o arquivo MicrosoftSQL_ALL.SQL que possui o script de todas as tabelas selecionadas no momento de execução do template. Nota 2: Repare assim que carregar o arquivo no SQL Query Analyser que o script gerado pela ferramenta possui no início os comandos: USE [NOME DO BANCO] GO Quando tivermos que enviar este script em um pacote para o cliente, seja uma nova instalação ou uma manutenção, temos que remover estes dois comandos, pois não sabemos qual o nome do banco de dados que o cliente usa. c) Agora que o script está carregado no SQL Query Analyser, devemos então executá-lo para a criação das stored procedures no banco do projeto. Clique no ícone para executar o script (seta verde) ou use as teclas CTRL+E. Você deve receber a mensagem que cada stored procedure foi criada com sucesso. Procedimento para Projetos em Oracle

6. Criando o Interfaces CRUD e DataGrid com o MyGeneration As interfaces CRUD (Create, Read, Update, Delete) e DataGrid são as interfaces básicas para a criação da aplicação. A partir delas que iremos programar a aplicação do cliente conforme as especificações do projeto. As interfaces DataGrid são criadas com o nome da tabela sem o prefixo TB_. Exemplo: A interface DataGrid de uma tabela chamada TB_EMPRESA será EMPRESA.aspx. As interfaces CRUD são criadas com o nome da tabela sem o prefixo TB_ + o sufixo _Edicao. Exemplo: A interface CRUD de uma tabela chamada TB_EMPRESA será EMPRESA_Edicao.aspx. Nota: O motivo da adoção do padrão do nome dos arquivos das interfaces não serem exatamente iguais aos das tabelas é somente para não deixar que uma pessoa má intencionada em invadir o banco de dados do projeto descubra facilmente o nome da tabela. a) Para não gerar confusão, vá à pasta de saída dos templates do MyGeneration e apague todos os arquivos que foram gerados no item 3. b) Abra o MyGeneration. Na palheta de templates (Templates Browser), certifique-se que o segundo botão ( ) esteja acionado. Ele exibe os templates por File ao invés de exibir por Namespace. A pasta SV deve passar a ser exibida. Expanda a pasta SV e depois a pasta CRUD_AspNet_2.0. Confira a figura 11.

Figura 11 c) Clique duas vezes no template SV.Add_Edit.vbgen. Logo abaixo do menu, na barra de ferramentas, existe o botão Play (seta verde) para executar o template. Clique nele. Será aberta uma tela. Certifique-se de que o campo Namespace do BLL esteja com o valor Business (com a grafia exata escrita aqui) e que o campo Nome do Diretório das Páginas esteja com o valor ui (com a grafia exata escrita aqui). Confira a figura 12.

Figura 12 d) Selecione todas as tabelas e clique no botão Ok. Quando terminar a geração dos templates a aba Output será exibida. e) Abra agora o template SV.DataGrid.vbgen. Execute o template apertando a seta verde do menu. Será aberta uma tela. Certifique-se de que o campo Namespace do BLL esteja com o valor Business (com a grafia exata escrita aqui) e que o campo Nome do Diretório das Páginas esteja com o valor ui (com a grafia exata escrita aqui). Selecione as tabelas que deseja e dê OK. Confira a figura 13.

Figura 13 f) Abra agora o template SV.DataGrid-view.vbgen. Nota: Não devemos usar estes templates quanado é uma manutenção 7. Implementando as Interfaces CRUD no Projeto Depois de cridos os arquivos de interface com a utilização dos templates (item 6) devemos colocar os arquivos dentro do projeto. a) Vá à pasta de saída dos templates do MyGeneration, selecione e copie todos os arquivos gerados no item 6. b) Retorno ao Visual Studio 2008 ou reabra ele e carregue o projeto caso tenha fechado. c) Na palheta Solution Explorer expanda a pasta ui. Cole dentro dela os arquivos copiados que estão em memória. Para se certificar que está tudo correto, vá ao item Build menu e clique na opção Build Web Site para compilar o projeto.

Caso você tenha seguido corretamente os processos o projeto será compilado sem erros a e mensagem abaixo deve ser exibida: Validation Complete ========== Build: 1 succeeded or up-to-date, 0 failed, 0 skipped ========== Nota: Esclarecer erros prováveis Cópia ou base. d) Vamos agora realizar as configurações necessárias para o projeto rodar na máquina. Abra o arquivo web.config que fica no raiz do site. Este arquivo é um arquivo de configuração do projeto. e) Configure a chave connectionstring com as informações do banco de dados do projeto. f) Configure a chave wwwpath com o caminho virtual do projeto. O valor desta chave é igual ao nome do projeto que você deu no item 4b acrescido do barra (/) ao final. g) Configure a chave titulosite com o nome do projeto. Exemplo: Projeto de Teste. h) Configure a chave DiretorioTemplateEmail com o caminho correto da pasta de template de emails. Se você seguiu todos as passos precisará apenas trocar a parte NOME_PROJETO pelo nome do projeto que você criou no item 4b. 8. Estrutura do Projeto TEXTO DE INTRODUÇÃO EXPLICANDO A ARQUITETURA DO PROJETO a) App_Code\Util\Crypto.cs b) App_Code\Util\feedback.cs c) App_Code\Util\Funcoes.cs d) App_Code\Util\MailTemplate.cs e) App_Code\Util\MasterMessage.cs f) App_Code\Util\WebConfig.cs g) controle h) css i) erro j) js k) ui

l) Interface (arquivos da interface) Explicar o Advanced Erros.