Tutorial do Development Center para o Video Online utilizando o Microsoft Visual Basic

Transcrição

1 IBM DB2 Universal Database Tutorial do Development Center para o Video Online utilizando o Microsoft Visual Basic Versão 8

2

3 IBM DB2 Universal Database Tutorial do Development Center para o Video Online utilizando o Microsoft Visual Basic Versão 8

4 Antes de utilizar estas informações e o produto suportado por elas, leia as informações gerais na seção Avisos. Este documento contém informações de propriedade da IBM. Ele é fornecido mediante um acordo de licença e protegido pela lei de direitos autorais. As informações contidas nesta publicação não incluem nenhuma garantia de produto, e as declarações fornecidas neste manual não devem ser interpretadas como tal. Você pode solicitar publicações da IBM online ou através do representante local da IBM. v Para solicitar publicações online, acesse o IBM Publications Center no endereço v Para encontrar o representante local da IBM, acesse o IBM Directory of Worldwide Contacts no endereço Quando o Cliente envia seus comentários, concede direitos não-exclusivos à IBM para usá-los ou distribuí-los da maneira que achar conveniente, sem que isso implique em qualquer compromisso ou obrigação para com o Cliente. Copyright International Business Machines Corporation Todos os direitos reservados.

5 Índice Sobre o tutorial Antes de iniciar Visão geral do produto Convenções utilizadas neste tutorial Introdução ao aplicativo IBM Video Online para e-business Cenário comercial Arquitetura em multicamada Camada de dados Camada de controle Camada de interface Resumo Lição 1: Ativar o banco de dados para recuperar conjuntos de registro XML Ponto de verificação Lição 2: Criando o projeto do Visual Basic e lançando o IBM DB2 Development Add-In Etapa 1: Registrando o IBM DB2 Development Add-In Etapa 2: Configurando o projeto do Visual Basic Etapa 3: Preparando o provedor OLE DB.. 14 Etapa 4: Iniciando o IBM DB2 Development Add-In Etapa 5: Incluindo e testando uma conexão do banco de Dados Etapa 6: Criando e preenchendo o banco de dados Ponto de verificação Lição 3: Criando as UDFs Etapa 1: Criando a UDF TitleAvailability.. 19 Etapa 2: Criando a UDF XWishedTitles Etapa 3: Importando a UDF TitleRating Ponto de verificação Lição 4: Criando e importando os procedimentos armazenados da lista de pedidos Etapa 1: Criando o procedimento armazenado XWishedTitlesAdd Etapa 2: Importando três procedimentos armazenados da lista de pedidos Ponto de verificação Lição 5: Incluindo o módulo do utilitário do banco de dados Etapa 1: Incluindo um módulo DBUtil Etapa 2: Incluindo o código de conexão ADO 31 Etapa 3: Incluindo o código de comando ADO 32 Ponto de verificação Resumo Informações adicionais Avisos Marcas Contato com a IBM Informações sobre o Produto Copyright IBM Corp iii

6 iv IBM DB2 Universal Database : Tutorial do Development Center para o Video Online utilizando o Microsoft Visual Basic

7 Sobre o tutorial Bem-vindo ao tutorial do IBM DB2 Universal Database Development Center para Video Online utilizando o Microsoft Visual Basic. O tutorial do Development Center guia você através das tarefas básicas do Development Center utilizando o IBM DB2 Development Add-In com o Microsoft Visual Basic. As tarefas o levam através das etapas para gerar um aplicativo real para um cenário verdadeiro, uma locadora de vídeos. O IBM DB2 Development Add-In é utilizado para exibir o poder e a funcionalidade do DB2 Development Center. O add-in também gera a solução de amostra do IBM Video Online para e-business. Este tutorial descreve a arquitetura de solução da amostra. Além disso, este tutorial explica como utilizar o DB2 Development Center Add-In para o Microsoft Visual Basic para desenvolver uma camada de dados. Mais informações sobre a solução de amostra completa estão disponíveis no endereço Este tutorial deverá levar aproximadamente duas horas para ser concluído. Antes de iniciar Antes de iniciar o tutorial, você precisa de alguns conhecimentos como pré-requisito sobre os conceitos e ferramentas que este tutorial utiliza. Conhecimentos de pré-requisito: v Conhecimento fundamental sobre ADO (Active Data Objects) v Conhecimento fundamental de uma extensão do COM+ (Component Object Model) v Conceitos sobre banco de dados relacional v Conhecimento fundamental de SQL v Conhecimento fundamental do Microsoft Visual Basic Além disso, certifique-se de que seu computador possui os requisitos mínimos de software: v IBM DB2 Universal Database para Windows, Versão 8.1 ou posterior v IBM DB2 Universal Database Enterprise Server Edition v IBM DB2 Application Development Client, Versão 8.1 ou posterior v Microsoft Visual Basic, Versão 6.0 ou posterior Copyright IBM Corp

8 v MDAC (Microsoft Data Access Components), Versão 2.6 ou posterior Salve e descompacte videoonline.zip para sua unidade C. Você pode encontrar videoonline.zip nas seguintes localizações: v Se a documentação HTML foi instalada com o DB2: <db2 inst directory>\doc\htmlcd\<locale>\tutr\db2td\videoonline.zip v Se a documentação HTML foi instalada com o CD HTML: <cd unidade>:\program Files\sqllib\doc\htmlcd\<locale>\tutr\db2td \videoonline.zip em que: v <locale> é o locale (tal como en_us) v <cd unidade> é a unidade de CD (tal como unidade C) Certifique-se de expandir todas as subpastas ao descompactar os arquivos. Todos os arquivos que você precisa para concluir este tutorial estão incluídos no videoonline.zip. Visão geral do produto O IBM Video Online para e-business é uma fachada de loja eletrônica de locação de vídeos online que pode interagir com o IBM Video Central for e-business. O Video Central éorepositório de dados business-to-business e provedor de serviços Web para aplicativos registrados de locação de vídeos baseados na Web. O Video Online também pode agir como um aplicativo independente ou pode funcionar com o Video Central para atender as crescentes necessidades de negócios de uma típica locadora de vídeos. Convenções utilizadas neste tutorial Este tutorial utiliza convenções tipográficas no texto para ajudá-lo a distinguir entre os nomes dos controles e texto que você digita. Por exemplo: v Os itens de menu estão em negrito: Clique em Menu > Opção de menu. v Botões de comando e opções de seleção na interface do aplicativo estão em negrito: Clique no Nome do Botão. v O texto que você digita está na fonte de exemplo: Este é o texto que você digita. v Os nomes de arquivo ou diretório também estão na fonte de exemplo:...\sqllib\spb\projects\file.mdb 2 IBM DB2 Universal Database : Tutorial do Development Center para o Video Online utilizando o Microsoft Visual Basic

9 Introdução ao aplicativo IBM Video Online para e-business Nesta lição, você aprenderá sobre o cenário comercial da solução de amostra e o projeto de arquitetura do Video Online. Cenário comercial O IBM Video Online para e-business é uma fachada de loja eletrônica de locação de vídeos online (aplicativo de e-commerce business to consumer). Este tipo de aplicativo Web pode ser um negócio independente ou pode ser uma extensão de uma locadora de vídeos física existente que deseja aumentar sua receita e base de clientes estabelecendo uma presença na Web. Esta solução utiliza as vantagens de uma combinação da tecnologia IBM e Microsoft incluindo o IBM DB2, IBM DB2 Development Center, IBM DB2 Development Add-In para Microsoft Visual Basic, XML (extensible Markup), XLS (extensible Stylesheet Language), COM+ (Component Object Model), ADO (Active Data Objects) e ASP (Active Server Pages). Esta solução de e-business permite que clientes façam qualquer uma das seguintes tarefas fácil e rapidamente, 24 horas por dia, em casa ou no escritório: v Registrar-se como um novo membro v Exibir e atualizar seu perfil de registro v Exibir o histórico de locações e títulos pendentes atuais v Exibir e atualizar a lista de títulos reservados para entrega automática quando o título estiver disponível v Exibir e atualizar a lista de títulos pedidos para notificação futura quando o título estiver disponível v Exibir uma lista de lançamentos a chegar, últimas novidades e títulos populares v Exibir uma lista de títulos recomendados baseados em pesquisas de inteligência de negócios v Exibir informações detalhadas sobre cada título alugado v Pesquisar por títulos alugados v Avaliar títulos alugados utilizando resenhas e classificações cinco estrelas Os clientes não precisam mais ir até a locadora, procurar nos corredores pelo filme que eles querem, esperar na fila para alugar o vídeo ou retornar para a locadora para devolver o filme. Ao efetuar login, os clientes podem utilizar um poderoso mecanismo de pesquisa para localizar vídeos rapidamente Copyright IBM Corp

10 baseados em uma variedade de critérios de pesquisa, alugar um vídeo com poucos cliques e ter o vídeo entregue em sua caixa de correio em alguns dias. A devolução de um vídeo também é conveniente. Os clientes simplesmente colocam o vídeo no pacote pré-endereçado e selado que vem com o vídeo e o deixam na caixa de correio. O site oferece recursos adicionais incluindo biografias sobre atores, diretores e roteiristas; críticas e outras resenhas; e um histórico pessoal de locações. Arquitetura em multicamada Esta solução IBM Video Online para e-business é gerada em um estilo de multicamada. Existem três camadas lógicas, cada uma podendo ser fisicamente hospedada em um servidor de aplicativos ou uma fazenda de servidores de aplicativos. Estas camadas são a camada de dados, a camada de controle e a camada de interface. A separação lógica destas camadas simplifica o desenvolvimento de aplicativos. Em vez de criar um grande aplicativo, você cria componentes de software reutilizáveis modulares que podem ser facilmente mantidos e ampliados para acomodar novos requisitos. Este tutorial é focado na construção apenas da camada de dados, mas é importante aprender sobre a solução completa para que você possa colocar as tarefas do tutorial no contexto de um grande aplicativo. Na base do aplicativo está a camada de dados, também denominada camada de acesso a dados, onde o banco de dados reside. A camada de dados executa consultas de acesso a dados e atualizações e impõe integridade referencial de dados e consistência de dados. Os resultados da consulta desta camada são encaminhados para a camada de controle como conjuntos de resultados XML, que podem ser fragmentos de HTML. A camada de controle é a camada intermediária e é, algumas vezes, referida em outros aplicativos como a camada de lógica de negócios. Esta camada impõe regras de negócios e envia os pedidos de dados da camada de interface para a camada de dados. Quando necessário, a camada de controle utiliza XSL para transformar os conjuntos de resultados XML da camada de dados em fragmentos de HTML. Estes fragmentos de HTML são combinados para produzir grandes segmentos de HTML que a camada de interface pode utilizar. A camada de interface superior também é referida como a camada de apresentação em outros aplicativos. Esta camada fornece a interface de usuário Web em HTML executando ASPs (Active Server Pages) que contém scripts Visual Basic. A camada de interface não lê os dados anexados ao HTML. 4 IBM DB2 Universal Database : Tutorial do Development Center para o Video Online utilizando o Microsoft Visual Basic

11 A apresentação visual dos dados é gerenciada através de duas camadas: v A camada de interface que gerencia o layout geral da página, HTML estática e imagens estáticas. v A camada de controle que executa a transformação de XML para HTML e o armazenamento opcional do HTML em cache. As regras de negócios da solução também são gerenciadas através de duas camadas: Introdução ao aplicativo IBM Video Online para e-business 5

12 v A camada de controle que impõe as regras de segurança de negócios incluindo acesso a dados e funcionalidade. v A camada de dados que utiliza a integridade referencial de banco de dados, verificações de limitações e disparos para garantir que as regras de dados relacionais de negócios sejam cumpridas. Camada de dados A camada de dados possui diversos objetos COM+ com um ou mais métodos. Cada método estabelece tipicamente uma conexão ao banco de dados, chama o SQL ou os procedimentos armazenados necessários, desconecta da conexão com o banco de dados e, então, retorna o conjunto de resultados, se aplicável, para a camada de controle no formato de um documento XML. Você criará alguns objetos COM+ na Lição 5. O ADO facilita a comunicação entre o servidor do banco de dados e os objetos e métodos da camada de dados. Para transmissão de dados XML gerados como um resultado da consulta ao banco de dados, a camada de dados chama o procedimento armazenado de XML utilizando um objeto de comando ADO. O procedimento armazenado de XML chama o procedimento armazenado do SQL real, converte os conjuntos de resultados SQL em um documento XML e retorna o documento XML como um parâmetro de saída. O documento XML retorna para a camada de dados como um parâmetro de saída do comando ADO. Para transmitir dados XML requeridos para a atualização do banco de dados, a camada de dados chama o procedimento armazenado SQL utilizando um objeto de comando ADO, transmitindo no documento XML como um parâmetro de saída. O procedimento armazenado SQL utiliza a função definida pelo usuário (UDF) da tabela XML para converter os dados XML em dados SQL tabulares. Esses dados tabulares são, então, utilizados no processo de atualização do banco de dados. Na Lição 1, você irá preparar o banco de dados e nas Lições 2, 3e4,você irá criar UDFs, bem como criar e depurar procedimentos armazenados. Adicionalmente, utilizando COM+ e ADO, você poderá utilizar um conjunto de conexões com o banco de dados. O custo das chamadas individuais de conexão e desconexão é minimizado porque o objeto precisa, apenas, manter ou liberar uma conexão com o banco de dados a partir do conjunto de conexões com o banco de dados previamente estabelecido. Camada de controle A camada de controle, como a camada de dados, é formada por um número de objetos COM+. Cada objeto possui um ou mais métodos que, geralmente, pertencem às duas principais categorias de lógica de negócios a seguir: v Métodos de consulta de dados v Métodos de manipulação de dados Métodos de consulta de dados 6 IBM DB2 Universal Database : Tutorial do Development Center para o Video Online utilizando o Microsoft Visual Basic

13 Estes métodos são responsáveis por retornar um ou mais blocos de dados HTML para a camada de interface. Os métodos de consulta de dados recuperam, em primeiro lugar, o bloco de dados apropriado da cache HTML opcional. Se uma entrada for encontrada, o bloco de dados HTML é retornado ao solicitador. Se uma entrada não for encontrada, o método executará as seguintes ações: 1. Inicie o método da camada de dados apropriado para recuperar o documento de dados XML, utilizando os parâmetros de entrada requeridos. 2. Recupere o documento XLS requerido da cache XSL. 3. Aplique transformações XSL nos documentos de dados XML para converter os dados XML em um bloco de dados HTML (fragmento). 4. Insira o bloco de dados HTML de maneira assíncrona na cache opcional HTML. 5. Retorne o bloco de dados HTML para o solicitador. O processo permanece o mesmo, independente do tipo de bloco de dados que é solicitado. A única diferença é que, alguns blocos não são armazenados em cache porque seu conteúdo é muito dinâmico para o armazenamento em cache ser praticável. Além disso, um método pode tratar vários blocos de dados para reduzir o número de chamadas de permuta entre as diversas camadas. Os métodos responsáveis pelo retorno dos elementos de página da Web esquerdo, principal e direito para a camada de interface são exemplos de métodos que tratam vários blocos de dados. Métodos de manipulação de dados Os métodos de manipulação de dados são responsáveis pela atualização da conta do usuário e podem incluir ou remover entradas da lista de pedidos ou da lista de reservas, classificar e avaliar títulos ou atualizar informações da conta. Um método de manipulação de dados executa as seguintes ações: 1. Inicia o método de camada de dados apropriado para atualizar o banco de dados. 2. Se a atualização falhar, retorna um código de falha. 3. Se a atualização for bem-sucedida, exclui de maneira assíncrona todas as entradas de bloco de dados HTML armazenados em cache aplicáveis que são invalidados devido à atualização e retorna um código de êxito. Há um nível de complexidade incluído quando um método trata de mais de um elemento de dados. Por exemplo, quando vários títulos são incluídos simultaneamente à lista de pedidos, o método AddWishList deve tratar de todos os títulos. Para acomodar as informações adicionais, os parâmetros do método podem ser representados em um documento XML que descreve os elementos de dados. Introdução ao aplicativo IBM Video Online para e-business 7

14 Camada de interface A camada de interface utiliza várias Active Server Pages para montar as diversas partes das páginas da Web do Video Online. Os componentes desta camada são fisicamente hospedados pelo servidor de aplicativos Web e residem, tipicamente, atrás de um firewall da Internet. A camada de interface apresenta a interface do aplicativo, gerencia o layout geral da página da Web e fornece navegação entre as páginas da Web. Layout da página da Web As páginas da Web são uma combinação de blocos de dados HTML dinâmicos e estáticos. Os blocos estáticos incluem conteúdos como o layout básico da página, imagens e textos e controles permanentes. Instruções de inclusões do servidor ASP são utilizadas para implementar estes blocos estáticos. Blocos HTML dinâmicos são blocos de HTML que contêm dados anexados que são criados dinamicamente na demanda. Estes blocos dinâmicos são recuperados da camada de controle utilizando as chamadas de método COM+. O layout básico da página da Web inclui: v A área superior que contém o logotipo do site e o banner, seção de boas vindas ao membro e os controles de navegação superiores do site v A área da esquerda que contém controles de pesquisa e todos os links de navegação que estão relacionados ao conteúdo exibido na área central v A área central que contém as informações que são solicitadas pelo membro, como listas de títulos e listas expandidas ou informações sobre o elenco e equipe técnica v A área da direita que contém informações sobre a conta do membro, incluindo a lista de títulos recomendados do cliente, fila de títulos reservados, lista de títulos pedidos, títulos pendentes e um log de atividades que rastreia as ações do membro enquanto o cliente está visitando o site v A área inferior que contém informações de aplicativos e texto jurídico 8 IBM DB2 Universal Database : Tutorial do Development Center para o Video Online utilizando o Microsoft Visual Basic

15 Sessão de informações e segurança Os clientes do site da Web do Video Online podem visualizar a maior parte do conteúdo do site independente de efetuarem login. É atribuído uma combinação de senha e ID de usuário exclusivo para os clientes que se registrarem como sócios. O gerenciamento da sessão ASP na camada de interface armazena o identificador de login do membro, LoginID, no objeto da sessão. Os clientes devem ativar os cookies em seus navegadores da Web. Após o LoginID ser salvo na sessão, um cliente pode recuperar e atualizar dados específicos da conta. Mecanismos de segurança adicionais, como criptografia e validação de ponto de origem podem ser utilizados para assegurar atualizações de conta regulares e atualizações de conta sensíveis, como alteração de cartão de crédito ou informações sobre endereço. Você pode utilizar SSL (secure sockets layer) para criptografar dados sensíveis. Com validação de ponto de origem, você pode assegurar que o computador cliente é o mesmo que o computador que emitiu a solicitação de login. Os dois métodos podem ser utilizados para prevenir o spoofing da identidade e que o cookie cliente e os dados HTML sejam ignorados. A criptografia e a validação criam um tempo de resposta adicional. Conteúdo estático da Web Dados estáticos acessados são, freqüentemente, replicados do banco de dados principal do Video Online e armazenados no servidor Web como texto simples Introdução ao aplicativo IBM Video Online para e-business 9

16 ou arquivos de imagem para recuperação rápida. Imagens do título do vídeo são exemplos de dados estáticos que são mantidos localmente no servidor Web. Resumo A arquitetura do Video Online é baseada em um modelo de formação de camada lógica de três camadas. Com o balanceamento do trabalho entre as três camadas, o aplicativo aproveita as vantagens da mais recente tecnologia para atender às necessidades do negócio. A camada de dados é a única camada com acesso direto e conhecimento do banco de dados do Video Online. Solicitações de informações e atualizações são primeiramente transmitidas da camada de interface para a camada de controle, onde as solicitações de chamada de método da camada de dados apropriadas são determinadas e enviadas para a camada de dados. A seguir, a camada de dados executa a consulta ou atualização solicitada e retorna as informações para a camada de controle no formato XML. Em seguida, a camada de controle transforma o XML em HTML conforme necessário, combina vários fragmentos HTML nas grandes seções e retorna as seções HTML para a camada de interface. 10 IBM DB2 Universal Database : Tutorial do Development Center para o Video Online utilizando o Microsoft Visual Basic

17 Lição 1: Ativar o banco de dados para recuperar conjuntos de registro XML O objetivo desta lição é configurar a amostra do banco de dados do Video Online e preparar o ambiente do banco de dados para o desenvolvimento de aplicativos em lições futuras. Comandos batch foram criados para este tutorial para simplificar algumas destas tarefas. Nesta lição, você ativará o banco de dados para XML. Para recuperar conjuntos de registros XML, você precisa criar um conjunto de UDFs (user-defined functions). As UDFs de banco de dados requeridas, as quais permitirão que você recupere os conjuntos de registros formatados em XML, serão criadas utilizando o comando vosetupxml.bat. Para ativar o banco de dados: 1. Abra a janela de comandos do DB2. 2. No diretório videoonline\db, digite vosetupxml.bat. Ponto de verificação Você criou a UDF no banco de dados. Você pode utilizar a janela de comandos do DB2 para verificar se a UDF foi criada e se está funcionando corretamente. Para verificar se as UDFs foram criadas corretamente: 1. Abra a janela de comandos do DB2. 2. No diretório videoonline\db, digite vocheckxml.bat. Após executar o vocheckxml.bat, você deve ver o seguinte resultado em sua janela de comandos do DB2: O Comando SQL foi concluído com êxito. Se as UDFs não foram criadas corretamente, execute vosetupxml.bat novamente e procure por erros. Copyright IBM Corp

18 12 IBM DB2 Universal Database : Tutorial do Development Center para o Video Online utilizando o Microsoft Visual Basic

19 Lição 2: Criando o projeto do Visual Basic e lançando o IBM DB2 Development Add-In O objetivo desta lição é criar um projeto do Visual Basic, lançar o IBM DB2 Development Add-In e criar as tabelas do Video Online requeridas. Posteriormente, você utilizará o Add-in para criar UDFs e procedimentos armazenados no banco de dados DB2 e gerar o código ADO para os objetos de Conexão e Comando, para que o aplicativo Visual Basic possa interagir com o banco de dados. Esta interação ocorre através da utilização de objetos COM+. Etapa 1: Registrando o IBM DB2 Development Add-In O processo para instalação ou registro do IBM DB2 Development Add In depende de onde você instalou o Microsoft Visual Basic antes de ter instalado o DB2. Após o Add-in ser registrado com êxito, você pode começar a utilizá-lo em seus ambientes de desenvolvimento do Visual Basic. Para registrar o IBM DB2 Development Add In: v Se o Visual Basic foi instalado antes do DB2, a instalação do DB2 registrará automaticamente o IBM DB2 Development Add In. v Se o Visual Basic foi instalado depois do DB2, digite o seguinte comando em uma linha de comandos: db2vscmd register Etapa 2: Configurando o projeto do Visual Basic Antes de criar as UDFs, você precisa criar um novo projeto ActiveX e ativar o IBM DB2 Development Add In. Após o Add-in ser ativado, vários recursos do Development Center estarão disponíveis no ambiente Microsoft Visual Basic. Para configurar um novo projeto do Visual Basic: 1. Criar um novo projeto do Visual Basic: a. Inicie o Microsoft Visual Basic. A janela New Project é aberta. b. Clique em ActiveX DLL. c. Clique em Open. Na janela Project Explorer, você pode ver os módulo de classe Project1 e Class1. d. Na janela Project Explorer, clique em Project1 (Project1). Copyright IBM Corp

20 e. Na janela Properties, renomeie Project1 para IVOEBDL e pressione Enter. Você verá a alteração do nome na janela Properties, na janela Project Explorer e na janela Code. 2. Incluir o arquivo de classe Wishlist.cls ao projeto: a. Na janela Project Explorer, clique com o botão direito em IVOEBDL e clique em Add > Add File. A janela Add File é aberta. b. Selecione o arquivo videoonline\vb\wishlist.cls. c. Clique em Open. 3. Remover Class1: a. Na janela Project Explorer, clique com o botão direito em Class1 (Class1) e clique em Project > Remove Class1. A janela Microsoft Visual Basic é aberta. b. Clique em No. 4. Salvar seu novo projeto: a. Clique em File > Save Project As. b. Vá para o diretório videoonline. c. Clique em Save. Se a janela de alerta Source Safe Control for aberta, clique em No. Etapa 3: Preparando o provedor OLE DB A seguir, será necessário configurar o provedor OLE DB no Microsoft Visual Basic. O provedor OLE DB é o link entre o banco de dados e o aplicativo. Microsoft OLE DB é um conjunto de interfaces OLE/COM que fornece aplicativos com acesso uniforme a dados armazenados em diversas origens de informações. Existem consumidores OLE DB e provedores OLE DB. Um consumidor OLE DB é todo sistema ou aplicativo que utiliza interfaces OLE DB. Um provedor OLE DB é um componente que expõe interfaces OLE DB. Utilizando o ADO para acessar dados a partir de um provedor OLE DB simplifica muito o desenvolvimento de aplicativos porque o ADO oculta as complexidades herdadas das interfaces do provedor OLE DB. Com o Provedor IBM OLE DB, o DB2 pode agir como um provedor OLE DB. Este suporte fornece aos aplicativos baseados em OLE DB a habilidade de extrair ou consultar dados do DB2 utilizando a interface OLE nativa. Adicionalmente, os consumidores OLE DB podem acessar dados em um servidor DB2 Universal Database. Para configurar o provedor OLE DB no Microsoft Visual Basic: 1. Clique em Project > References. A janela References IVOEBDL.vbp é aberta. 14 IBM DB2 Universal Database : Tutorial do Development Center para o Video Online utilizando o Microsoft Visual Basic

21 2. Selecione Microsoft ActiveX Data Objects 2.6 Library. Se você possui uma versão recente (como Microsoft ActiveX Data Objects 2.7 Library) instalada, selecione-a. Se precisar fazer o download do MDAC 2.6 ou posterior, você poderá instalá-lo a partir do endereço 3. Clique em OK. Consulte Informações Adicionais para obter mais informações sobre o provedor IBM OLE DB. Etapa 4: Iniciando o IBM DB2 Development Add-In Para iniciar o IBM DB2 Development Add In: Clique em Add-Ins > IBM DB2 Development Add In. A exibição do DB2 Development pode levar alguns segundos para ser aberta. Quando a Exibição do DB2 Development abrir, você verá o projeto IVOEBDL. Agora você está pronto para iniciar a criação de procedimentos armazenados e UDFs que são necessárias para o seu aplicativo Video Online utilizando o IBM DB2 Development Add In. Nota: É recomendável que você não maximize a janela do Visual Basic porque alguns diálogos e assistentes que são lançados pelo DB2 Development Add-In podem abrir atrás da janela do Visual Basic. Etapa 5: Incluindo e testando uma conexão do banco de Dados Utilize o assistente Incluir Conexão do Banco de Dados para incluir uma conexão do banco de dados ao seu projeto. Para incluir uma conexão utilizando o assistente Incluir Conexão do Banco de Dados: 1. Na Exibição do DB2 Development, clique com o botão direito em IVOEBDL, e clique em Incluir Conexão. O assistente Incluir Conexão do Banco de Dados é aberto. 2. Na página Conexão, especifique o alias de banco de dados que deseja utilizar para sua conexão e seu ID de usuário e senha: a. No campo Alias, especifique SAMPLE. b. Selecione a caixa de opção Utilizar seu ID de usuário e senha atuais. c. Clique em Avançar. 3. Na página Filtro, especifique se deseja filtrar os objetos em sua conexão: a. Selecione a caixa de opção Filtrar utilizando os critérios especificados. Lição 2: Criando o projeto do Visual Basic e lançando o IBM DB2 Development Add-In 15

22 b. No campo Esquema, selecione Igual aos nomes e digite VO no campo de texto. c. Clique em Avançar. 4. Na página Opções, especifique o esquema SQL para a conexão do banco de dados: a. No campo Esquema SQL ou ID SQL, digite VO. b. Clique em Concluir. O banco de dados Amostra é incluído à exibição do DB2 Development. As mensagens sobre a conexão do banco de dados são exibidas na página Mensagens da Exibição de Saída. Agora você está pronto para iniciar a criação de UDFs e procedimentos armazenados que são necessários para seu aplicativo Video Online. Etapa 6: Criando e preenchendo o banco de dados Este tutorial fornece scripts para executar todas as tarefas envolvidas na criação e preenchimento do banco de dados de amostra do Video Online. Este scripts estão incluídos no videoonline.zip. O script vosetupdb.bat conecta-se ao banco de dados e cria tabelas. Em seguida, o script carrega os dados de amostra em cada tabela. O banco de dados do Video Online é criado e preenchido pelo script. Para criar um banco de dados completo: 1. Abra a janela de comandos do DB2. 2. No diretório videoonline\db, digite vosetupdb.bat. Os scripts podem levar alguns segundos para concluir todas as etapas. Você pode consultar os arquivos em videoonline\db\data\msg para verificar mensagens indicando se o conteúdo do tutorial foi criado e preenchido com êxito. 16 IBM DB2 Universal Database : Tutorial do Development Center para o Video Online utilizando o Microsoft Visual Basic

23 Ponto de verificação Você criou o esquema VO e associou as tabelas e índices no banco de dados Amostra. Você pode utilizar o DB2 Development Add-In para verificar se o esquema e as tabelas foram corretamente criadas e se os dados foram carregados. Para verificar se as tabelas foram criadas e preenchidas: 1. Na Exibição do DB2 Development, expanda o banco de dados Amostra. 2. Clique com o botão direito em Tabelas e clique em Atualizar. Você verá cinco tabelas listadas na Exibição do DB2 Development. 3. Clique com o botão direito em qualquer uma das tabelas e clique em Conteúdo de Amostra. Se as tabelas não foram criadas e preenchidas corretamente, execute novamente videoonline\db\vosetupdb.bat e procure por erros. Na Exibição do DB2 Development, clique com o botão direito em IVOEBDL e clique em Salvar. Lição 2: Criando o projeto do Visual Basic e lançando o IBM DB2 Development Add-In 17

24 18 IBM DB2 Universal Database : Tutorial do Development Center para o Video Online utilizando o Microsoft Visual Basic

25 Lição 3: Criando as UDFs O objetivo desta lição é criar duas UDFs e importar uma UDF. Estas UDFs executam a funcionalidade necessária para o recurso de títulos da solução de amostra do Video Online e pode ser gerada para recursos adicionais. Você irá construir cada uma das funções utilizando o IBM DB2 Development Add-In no Microsoft Visual Basic. O Add-in utiliza os assistentes e janelas do Development Center para criar e importar UDFs. Em cada caso, a instrução SQL é fornecida de modo que você possa focar-se nas tarefas em vez da lógica do aplicativo. Etapa 1: Criando a UDF TitleAvailability Agora que seu projeto está configurado e a conexão está incluída, você está pronto para criar as UDFs necessárias. As UDFs são extensões ou inclusões às funções internas existentes da linguagem SQL. Uma UDF pode ser uma escalar, que retorna um único valor cada vez que é chamada, uma função de coluna, que é um conjunto transmitido de valores semelhantes e retorna um único valor para o conjunto, uma função de linha, que retorna a linha ou uma função de tabela, que retorna uma tabela. Uma UDF pode ser uma função de coluna apenas quando ela tem origem em uma função de coluna existente. Nesta etapa, você criará uma UDF escalar denominada TitleAvailability. Esta UDF determina se um título de filme está no estoque ou fora do estoque e recupera o ícone apropriado quando é fornecido um número de identificação do título. Procedimentos armazenados que retornam uma lista de pedidos do cliente utilizarão esta UDF para retornar a disponibilidade dos títulos. Para abrir o assistente Criar Função SQL Definida pelo Usuário: 1. Na Exibição do DB2 Development, clique com o botão direito em Funções Definidas pelo Usuário e selecione Nova. A janela Novo Objeto é aberta. 2. Clique em Função Definida pelo Usuário no painel esquerdo. 3. Clique em SQL no painel direito. 4. Clique em OK. O assistente Criar Função SQL Definida pelo Usuário é aberto. Para criar a UDF utilizando o assistente: 1. Na página Nome, especifique um nome para a UDF: a. No campo Nome, digite VO.TitleAvailability. Copyright IBM Corp

26 b. Clique em Avançar. 2. Na página Definição, especifique as definições para definir a UDF: a. Na linha de opção Instrução clique em. A janela Instrução SQL é aberta. b. Para criar uma instrução SQL e definir os parâmetros para a UDF, substitua a instrução SQL padrão, digitando a seguinte instrução SQL na caixa de texto: SELECT CASE WHEN INCOUNT > 0 THEN in.gif ELSE out.gif END CASE FROM VO.TITLE WHERE VO.TITLE.TITLEID = TID Esta instrução SQL utiliza TID como um parâmetro de entrada e verifica se há alguma cópia do título no estoque. Se houver pelo menos uma cópia do filme, a imagem em estoque é retornada. Se não houver cópias disponíveis, a imagem fora do estoque é retornada. c. Clique em OK para fechar a janela Instrução SQL. Você pode consultar a instrução SQL revisada na página Definição. d. No campo Tipo de Saída, especifique Escalar como valor. e. Clique em Avançar. 20 IBM DB2 Universal Database : Tutorial do Development Center para o Video Online utilizando o Microsoft Visual Basic

27 3. Na página Retornar Tipo de Dados, especifique o tipo de dados que você deseja que a UDF retorne: a. No campo Tipo de SQL, especifique VARCHAR. b. No campo Comprimento, digite 10. c. Clique em Avançar. 4. Na página Parâmetros, especifique os parâmetros para a UDF: a. Clique em Incluir. A janela Incluir Parâmetro é aberta. b. No campo Nome, digite TID. c. No campo Tipo de SQL, especifique Inteiro. d. Clique em OK. Você verá o parâmetro TID na página Parâmetros. e. Clique em Concluir. Você pode ver sua nova UDF na pasta Funções Definidas pelo Usuário na Exibição do DB2 Development. As mensagens sobre a construção são exibidas na página Mensagens da Exibição de Saída. Você irá executar e testar esta UDF no procedimento de ponto de verificação no final da lição. Etapa 2: Criando a UDF XWishedTitles Nesta etapa, você criará uma tabela UDF denominada XWishedTitles. Baseada em um XML VARCHAR, esta UDF chama outras funções do DB2 para recuperar uma lista de IDs. Para abrir o assistente Criar Função de Tabela XML: 1. Na Exibição do DB2 Development, clique com o botão direito em Funções Definidas pelo Usuário e clique em Nova. A janela Novo Objeto é aberta. 2. Clique em Função Definida pelo Usuário no painel esquerdo. 3. Clique em XML no painel direito. 4. Clique em OK. O assistente Criar Função de Tabela XML é aberto. Para criar a UDF utilizando o assistente: 1. Na página Nome, especifique o nome da tabela UDF. a. No campo Nome, digite VO.XWishedTitles em que VO é o esquema e XWishedTitles é o nome da UDF XML UDF que você está criando. b. Clique em Avançar. c. Clique em Avançar. 2. Na página Descrição do Documento XML, especifique o caminho absoluto para o elemento de tabela no documento XML e o caminho para os elementos de linha relativos ao elemento da tabela: a. No campo Caminho absoluto para elemento da tabela, digite \\AddWishedTitles\Titles. Lição 3: Criando as UDFs 21

28 b. Em Caminho relativo para elemento da linha, digite Title. c. Clique em Avançar. 3. Na página Definição de Coluna, clique em Incluir. A janela Incluir Definição de Coluna é aberta. 4. No campo Caminho relativo, digite TitleID. 5. No campo Tipo de SQL, especifique INTEGER. 6. Clique em OK. 7. Clique em Concluir. Você pode ver sua nova UDF na pasta Funções Definidas pelo Usuário na Exibição do DB2 Development. As mensagens sobre a construção são exibidas na página Mensagens da Exibição de Saída. Você irá executar e testar esta UDF no procedimento de ponto de verificação no final da lição. Etapa 3: Importando a UDF TitleRating Nesta etapa, você importará uma UDF escalar denominada TitleRating. Esta UDF é utilizada para converter um valor de deslocamento de TitleRating para um nome de ícone de classificação cinco estrelas. Para abri o assistente Importar: 22 IBM DB2 Universal Database : Tutorial do Development Center para o Video Online utilizando o Microsoft Visual Basic

29 1. Na Exibição DB2 Development, clique com o botão direito em Funções Definidas pelo Usuário e clique em Importar. A janela Função Definida pelo Usuário é aberta. 2. Clique em Sistema de Arquivos no painel esquerdo. 3. Clique em Arquivo Fonte no painel direito. 4. Clique em OK. O assistente Importar é aberto. Para importar a UDF utilizando o assistente: 1. Na página Arquivo Fonte, clique em na opção de linha Instrução, de modo que você possa selecionar o arquivo que deseja importar. A janela Escolher é aberta. 2. Selecione o arquivo videoonline\db\ddl\titlerating.db2. 3. Clique em Escolher. 4. No assistente Importar, clique em Avançar. 5. Clique em Avançar. 6. Clique em Concluir. Você pode ver sua nova UDF na pasta Funções Definidas pelo Usuário na Exibição do DB2 Development. As mensagens sobre a construção são exibidas na página Mensagens da Exibição de Saída. Você irá executar e testar esta UDF no procedimento de ponto de verificação no final da lição. Ponto de verificação Nesta lição, você criou e construiu três UDFs. Você pode verificar se as UDFs estão corretas, executando cada uma delas. Para executar cada UDF: 1. Para executar a UDF TitleAvailability: a. Na Exibição do DB2 Development, clique com o botão direito no nome da UDF e clique em Executar. A janela Especificar Valores de Parâmetros é aberta. b. No campo Valor, digite 1. c. Clique em OK. Após ter executado a UDF, consulte a Exibição de Saída para ver os resultados. Quaisquer mensagens indicando êxito ou falha são exibidas na página Resultados. Você deve ver in.gif como o resultado. 2. Para executar XWishedTitles: Lição 3: Criando as UDFs 23

30 a. Na Exibição do DB2 Development, clique com o botão direito no nome da UDF e clique em Executar. A janela Especificar Valores de Parâmetros é aberta. b. No campo Valpr, digite: <AddWishedTitles><Titles><Title><TitleID>101</TitleID> </Title></Titles></AddWishedTitles> c. Clique em OK. Após ter executado a UDF, consulte a Exibição de Saída para ver os resultados. Quaisquer mensagens indicando o êxito ou falha são exibidas na página Mensagens. Você deve ver 101 como o resultado. 3. Para executar TitleRating: a. Na Exibição do DB2 Development, clique com o botão direito no nome da UDF e clique em Executar. A janela Especificar Valores de Parâmetros é aberta. b. No campo Valor, digite 1. c. Clique em OK. Após ter executado a UDF, consulte a Exibição de Saída para ver os resultados. Quaisquer mensagens indicando o êxito ou falha são exibidas na página Mensagens. Você deve ver 10.gif como o resultado. Na Exibição do DB2 Development, clique com o botão direito em IVOEBDL e clique em Salvar. 24 IBM DB2 Universal Database : Tutorial do Development Center para o Video Online utilizando o Microsoft Visual Basic

31 Lição 4: Criando e importando os procedimentos armazenados da lista de pedidos O objetivo desta lição é criar um procedimento armazenado e importar três procedimentos armazenados utilizados para implementar a funcionalidade da lista de pedidos. Você irá criar e importar procedimentos armazenados que consultam e atualizam registros no banco de dados. Etapa 1: Criando o procedimento armazenado XWishedTitlesAdd O procedimento armazenado XWishedTitlesAdd utiliza uma instrução de inserção SQL para incluir um ou mais títulos à lista de pedidos do cliente. Você criará o procedimento armazenado XWishedTitlesAdd utilizando um assistente. A tabela XWishedTitles UDF é utilizada para extrair os IDs do título do documento XML de entrada. Para abrir o assistente Criar Procedimento Armazenado SQL: 1. Na Exibição do DB2 Development, clique com o botão direito em Procedimentos Armazenados e clique em Novo. A janela Novo Objeto é aberta. 2. Clique em Procedimento Armazenado no painel esquerdo. 3. Clique em SQL no painel direito. 4. Clique em OK. O assistente Criar Procedimento Armazenado SQL é aberto. Para criar o procedimento armazenado utilizando o assistente: 1. Na página Nome, especifique um nome para o procedimento armazenado: a. No campo Nome, digite VO.XWishedTitlesAdd, emquevo é o esquema e XWishedTitlesAdd é o nome do procedimento armazenado que você está criando. b. Clique em Avançar. 2. Na página Definição, especifique as definições para definir o procedimento armazenado: a. No campo Conjunto de resultados, especifique Nenhum. b. Clique em Avançar. 3. Na página Parâmetros, especifique os parâmetros para o procedimento armazenado. a. Clique em Incluir. A janela Incluir Parâmetro é aberta. b. Clique em Entrada para definir o modo de Parâmetro como entrada. Copyright IBM Corp

32 c. No campo Nome, digite MID. d. No campo Tipo de SQL, especifique Inteiro. e. Clique em Aplicar. O parâmetro MID é exibido na página Parâmetros. 4. Inclua o parâmetro de entrada TITLES. a. No campo Nome, digite TITLES. b. No campo Tipo de SQL, especifique VARCHAR. c. No campo Comprimento, digite d. Clique em OK. O parâmetro TITLES é exibido na página Parâmetros. e. Clique em Avançar. 5. Na página Opções, especifique as opções para criação e construção dos procedimentos armazenados: a. Limpe a caixa de opção Gerar porque você modificará o procedimento armazenado utilizando o editor. b. Clique em Concluir. Você pode ver seu novo procedimento armazenado na pasta Procedimento Armazenado na Exibição do DB2 Development. Para modificar o procedimento armazenado utilizando o editor: 1. Na Exibição do DB2 Development, clique com o botão direito em XWishedTitlesAdd e clique em Editar Origem. O editor é aberto. 2. Na janela de edição, substitua o código gerado do corpo do procedimento armazenado copiando e colando ou digitando a seguinte instrução SQL: Substitua apenas o código de P1:Begin para End P1. P1: BEGIN DECLARE MYERRORCODE CHAR(5); DECLARE SQLSTATE CHAR(5); DECLARE SQLCODE INT; DECLARE TID INT; DECLARE at_end INT DEFAULT 0; DECLARE cursor1 CURSOR FOR SELECT TitleID FROM TABLE (VO.XWishedTitles(Titles)) AS T; DECLARE CONTINUE HANDLER FOR SQLEXCEPTION SET MYERRORCODE = SQLSTATE; DECLARE CONTINUE HANDLER FOR not found SET at_end = 1; OPEN cursor1; FETCH cursor1 INTO TID; WHILE (at_end = 0) DO INSERT INTO VO.WISHEDTITLES ( CUSTOMERID, TITLEID, DATEADDED ) VALUES ( MID, TID, CURRENT DATE ); 26 IBM DB2 Universal Database : Tutorial do Development Center para o Video Online utilizando o Microsoft Visual Basic

33 FETCH cursor1 INTO TID; END WHILE; CLOSE cursor1; END P1 3. Clique em Arquivo > Salvar Objeto. 4. Feche o editor. 5. Na Exibição do DB2 Development, clique com o botão direito em XWishedTitlesAdd e clique em Gerar. Você pode ver o novo procedimento armazenado na pasta Procedimentos Armazenados na Exibição do DB2 Development. As mensagens sobre a construção são exibidas na página Mensagens da Exibição de Saída. Você irá executar e testar os procedimentos armazenados no final da lição. Etapa 2: Importando três procedimentos armazenados da lista de pedidos Os procedimentos armazenados da lista de pedidos utilizam uma consulta SQL para retornar informações detalhadas sobre todos os títulos em uma lista de pedidos do membro. Os resultados desta consulta são exibidos no painel principal da interface da Web. Você importará três procedimentos armazenados da listas de pedidos (GetWishedTitles, GetNonWishedTitles e XGetWishedTitles) utilizando um assistente. Lição 4: Criando e importando os procedimentos armazenados da lista de pedidos 27

34 Para abrir o assistente Importar: 1. Na Exibição do DB2 Development, clique com o botão direito em Procedimento Armazenado e clique em Importar. A janela Importar Procedimento Armazenado é aberta. 2. Clique em Sistema de Arquivos no painel esquerdo. 3. Clique em Arquivo Fonte no painel direito. 4. Clique em OK. O assistente Importar é aberto. Para importar o procedimento armazenado utilizando o assistente: 1. Na página Arquivo Fonte, clique em na opção de linha Instrução, de modo que você possa selecionar o arquivo que deseja importar. A janela Escolher é aberta. 2. Selecione o arquivo videoonline\db\ddl\getwishedtitles.db2. 3. Clique em Escolher. 4. No assistente Importar, clique em Avançar. 5. Clique em Avançar. 6. Clique em Concluir. Repita o processo para importar mais dois procedimentos armazenados: v GetNonWishedTitles.db2 v XGetWishedTitles.db2 Você pode ver o novo procedimento armazenado na pasta Procedimentos Armazenados na Exibição do DB2 Development. As mensagens sobre a construção são exibidas na página Mensagens da Exibição de Saída. Você irá executar e testar os procedimentos armazenados no final da lição. Ponto de verificação Para verificar se os seus procedimentos armazenados funcionam corretamente, você pode executar cada procedimento armazenado e verificar suas mensagens e resultados. Siga estas etapas para o procedimento armazenado XWishedTitlesAdd: 1. Na Exibição do DB2 Development, clique com o botão direito no procedimento armazenado e clique em Executar. A janela Especificar Valores de Parâmetros é aberta. 2. No campo Valor para MID, digite No campo Valor para Titles, digite <AddWishedTitles><Titles><Title><TitleID>5</TitleID> </Title></Titles></AddWishedTitles> 28 IBM DB2 Universal Database : Tutorial do Development Center para o Video Online utilizando o Microsoft Visual Basic

35 4. Clique em OK. Siga estas etapas para os procedimentos armazenados GetWishedTitles, GetNonWishedTitle e XGetWishedTitles: 1. Na Exibição do DB2 Development, clique com o botão direito no procedimento armazenado e clique em Executar. 2. No campo Valor para MID, digite Clique em OK. A Exibição de Saída é aberta e você verá a página Mensagens indicando que os procedimentos armazenado foram executados com êxito. Clique na página Resultados da Exibição de Saída para ver os resultados dos procedimentos armazenados. Na Exibição do DB2 Development, clique com o botão direito em IVOEBDL e clique em Salvar. Lição 4: Criando e importando os procedimentos armazenados da lista de pedidos 29

36 30 IBM DB2 Universal Database : Tutorial do Development Center para o Video Online utilizando o Microsoft Visual Basic

37 Lição 5: Incluindo o módulo do utilitário do banco de dados O objetivo desta lição é criar um novo módulo do utilitário do banco de dados (DBUtil) em seu projeto do Visual Basic. O IBM DB2 Development Add-In automatiza a maior parte deste processo para você. Este módulo fornece conexões do banco de dados para outros módulos de classe no aplicativo. Etapa 1: Incluindo um módulo DBUtil Primeiramente, você deve incluir um módulo vazio em seu projeto do Visual Basic. Para incluir um novo módulo: 1. Na janela Project Explorer, clique com o botão direito em IVOEBDL, e clique em Add > Module. O bloco de notas Add Module é aberto. 2. Clique em Open. A janela IVOEBDL Module1 (Code) é aberta. Uma pasta Modules é incluída à janela Project Explorer. 3. Na janela Properties, renomeie Module1 para DBUtil e pressione Enter. Você verá a alteração do nome do módulo na janela Properties, na janela Project Explorer e na janela Code. Etapa 2: Incluindo o código de conexão ADO Agora que você possui um módulo, você pode incluir o código que irá criar o objeto de conexão ADO de modo que você possa conectar à sua amostra do seu banco de dados. Este código deve ser incluído no módulo e em cada procedimento armazenado. Para utilizar o IBM DB2 Development Add-In para criar o código de conexão ADO: 1. Na janela Project Explorer, clique duas vezes em DBUtil. 2. Na Exibição do DB2 Development, clique com o botão direito em Amostra e clique em Incluir Código de Conexão ADO. A função Sample_Get Connection é inserida no módulo. Copyright IBM Corp

38 3. Na janela Project Explorer, clique com o botão direito em DBUtil e clique em Save DBUtil. A janela Save File As é aberta. 4. Clique em Save. Etapa 3: Incluindo o código de comando ADO Agora que você possui um módulo, você pode incluir o código que irá criar e chamar um objeto de comando ADO. Para utilizar o IBM DB2 Development Add-In para criar o código de comando ADO: 1. Coloque seu cursor no final do código gerado. 2. Na Exibição do DB2 Development, clique com o botão direito em XWishedTitlesAdd e clique em Incluir código de comando ADO. O código de comando é incluído no final do módulo DBUtil. 3. Na janela Project Explorer, clique com o botão direito em DBUtil e clique em Save DBUtil. A janela Save File As é aberta. 4. Clique em Save. Repita as etapas 1a4para os seguintes procedimentos armazenados: v GetNonWishedTitles v XGetWishedTitles Você criou e salvou o módulo de conexão ADO com êxito. 32 IBM DB2 Universal Database : Tutorial do Development Center para o Video Online utilizando o Microsoft Visual Basic