Guia para instalação da Loja demonstração
Índice Capítulo 1... 3 Analisando a loja exemplo... 3 Capítulo 2... 6 Instalação da Loja... 6 Página 2 de 7
Capítulo 1 Analisando a loja exemplo No arquivo Loja_demonstracao.zip estão os arquivos da loja exemplo que serão utilizados para todos os métodos de pagamento na loja de demonstração. No diretório raíz estão os arquivos que devem ser adaptados às necessidades de sua loja. Nos subdiretórios dados e lib estão arquivos que não devem ser alterados sem orientação da Scopus. Note que a página mais importante neste exemplo (RemoteDemo) é a DadosCompra.ASP, que é a página que vai preparar os dados para enviar ao Módulo de Pagamento do SPS. Os arquivos listados acima possuem a seguinte funcionalidade: 1) Default.htm: Apenas redireciona para Default.asp. Página 3 de 7
2) Default.asp: Página inicial da loja. Cria um número de pedido, monta uma cesta de compras e salva na base dados da loja, que é o arquivo DemoPost.mdb armazenado dentro do subdiretório dados. 3) Basket.asp: Apresenta a cesta de compras e o link para continuar com o processo de compra. 4) Shipping.asp: Apresenta o seletor de endereços para que o cliente entre com os dados de entrega. Como alternativa, a página oferece um link para uma página que substitui o Address Selector por um formulário simples. 5) Shipping_Form.asp: Página alternativa ao AddressSelector da Microsoft. Apresenta um formulário para que o cliente entre com os dados do endereço de entrega. 6) Save_Shipping.asp: Salva os dados do pedido e os dados do cliente na base de dados. 7) Metodo_Pagto.asp: Apresenta as formas de pagamento disponíveis para a loja. É a partir desta página, inclusive, que começa a integração de uma loja com sistema de pagamento. 8) DadosCompra.asp: É a página mais importante da integração. Se, o sistema usado pela loja não for ASP, o desenvolvedor terá que criar uma página semelhante à apresentada neste kit. A página é curta, não devendo apresentar problemas de conversão para outras linguagens. No caso de conversão desta página, a página I_StringFunctions.asp que se encontra dentro do diretório lib também deverá ser traduzida. 9) I_browser.asp: Implementa uma função que devolve qual navegador está sendo usado. 10) I_Format.asp: Esta página apenas mostra o cabeçalho das páginas da loja, juntamente com o nome da mesma. 11) Global.asa: Arquivo que guarda a string de conexão da base dados da loja. Por favor, altere este caminho para que a loja encontre a base de dados (DemoPost.mdb) corretamente. 12) Falha.asp: Página que apresenta mensagem de erro em caso de falha no processo de compra. 13) Confirma.asp: Página de confirmação de compra. Apresenta os dados da compra, assim como a assinatura digital. Dentro do diretório lib, estão localizadas mais 5 arquivos de apoio ao funcionamento da loja, como mostra a figura abaixo: Página 4 de 7
Os arquivos listados acima possuem as seguintes funcionalidades: 1) I_addrsel_js.asp: Funções adicionais em JavaScript para trabalhar com o AddressSelector. 2) I_CurrencyFunctions.asp: Esta página implementa funções para formatar valores para reais, com R$ na frente do valor e duas casas para os centavos. 3) I_StringFunctions.asp: Página que implementa funções adicionais para formatar a descrição da compra, formatar a assinatura digital retornada pelo sistema e descrição dos códigos de erro. Neste último caso, note que a função responsável abre uma conexão com a base de dados e apresenta a descrição do erro. Esta página é indispensável para o funcionamento da loja. Por isso, se o desenvolvedor estiver traduzindo a loja para outra linguagem esta página também deverá se re-escrita. A figura a seguir mostra o fluxo das páginas: Página 5 de 7
Capítulo 2 Instalação da Loja A instalação da loja demonstração refere-se á loja construída em ASP e distribuída neste pacote como exemplo. Esta instalação é direcionada para a plataforma Windows NT, Internet Information Server 4 e Base de dados em Access. Vale lembrar que os diretórios citados aqui são apenas uma sugestão, cabendo ao desenvolvedor escolher o melhor local para a instalação da loja. Cópia dos arquivos Os arquivos da loja. Abrindo o diretório da loja, deverá obter a estrutura de diretórios mostrada na figura abaixo: Dentro do diretório InetPub do servidor que vai abrigar a loja de exemplo, crie um diretório com o nome RemoteDemo, como o mostrado na figura a seguir: Página 6 de 7
Abra o Internet Service manager e expanda o nível do Internet Information Server, conforme imagem a seguir: Crie um diretório virtual RemoteDemo apontando para o diretório no qual os arquivos da loja foram criados. Neste exemplo, C:\InetPub\wwwroot\RemoteDemo\ Atenção especial deve ser dada ao arquivo Global.asa. Antes de começar a operação da loja, abra este arquivo no Notepad. Note que o número de estabelecimento e a string de conexão com a base de dados estão colocados como variáveis de aplicação. Caso a loja tenha sido instalada em um diretório diferente do mencionado neste exemplo, altere a string para que atenda às suas condições. No nosso exemplo, a string de conexão é driver={microsoft Access Driver (*.mdb)};dbq=c:\inetpub\wwwroot\remotedemo\dados\demopost.mdb. Esta base de dados é utilizada apenas para uso da loja de exemplo, não sendo gravado nada de uso do módulo de pagamento. Os dados pertinentes ao módulo de pagamento serão gravados nas bases de dados do servidor do Módulo Único de Pagamento. Note ainda que o número do estabelecimento também está incluído como uma variável de aplicação. Substitua este número pelo número de estabelecimento de testes que lhe for fornecido. IMPORTANTE: Para o correto funcionamento da loja demonstração, após a instalação, é necessária a leitura de dos Guias de integração (disponíveis para download), já que nesses manuais constam informações necessárias para o correto funcionamento das formas de pagamento (disponíveis nesta loja de exemplo). Página 7 de 7