Conteúdo Conteúdo dos arquivos ASCII Configurando o programa The Downloader Convertendo os arquivos ASCII Comentários finais Os arquivos gerados pelo Conversor Spero encontram-se em um formato denominado ASCII Text e devem ser convertidos para o formato do programa MetaStock, também chamado de formato MetaStock, a fim de atualizar a pasta de cotações das ações da BOVESPA. Para isto, deve ser utilizado o programa The Downloader, o qual acompanha o programa MetaStock. Neste tutorial, irei explicar, em detalhes, o conteúdo dos arquivos ASCII e como fazer, passo a passo, a sua conversão manual para o formato MetaStock.
Os arquivos gerados pelo Conversor Spero encontram-se em um formato denominado ASCII Text e devem ser convertidos para o formato do programa MetaStock, também chamado de formato MetaStock, a fim de atualizar a pasta de cotações das ações da BOVESPA. Para isto, deve ser utilizado o programa The Downloader, o qual acompanha o programa MetaStock.
Neste tutorial, irei explicar, em detalhes, o conteúdo dos arquivos ASCII e como fazer, passo a passo, a sua conversão manual para o formato MetaStock.
Conteúdo dos Arquivos ASCII
Os arquivos BDI que a BOVESPA disponibiliza diariamente no seu site (http://www.bovespa.com.br) trazem uma infinidade de informações sobre o que aconteceu no pregão da BOVESPA (quem quiser conhecer em detalhes o BDI basta transferir o layout do arquivo que está disponível na página de cotações do site da BOVESPA); entre as informações do BDI há as cotações de diversos mercados de papéis: do lote padrão; a termo; de concordatárias; de direitos e recibos; de bônus privados; de apólices, bônus e títulos públicos; de opções de compra e de venda; de exercícios de opções de compra e de venda; de fundos e certificados; de debêntures; do mercado fracionário, entre outros menos comuns. Os arquivos ASCII gerados pelo conversor Spero tratam, individualmente, os seguintes mercados: Lote Padrão. Concordatárias. Direitos e Recibos. Bônus Privados. Fundos e Certificados. Termo. Opções de Compra. Opções de Venda. Fracionário. Para estes mercados, os arquivos ASCII contêm todos os códigos dos papéis que tiveram volume negociado maior do que zero. Além dos mercados acima, os arquivos ASCII contêm os dados diários dos índices BOVESPA - Ibovespa - de energia elétrica - IEE - e Brasil - IBX. As informações, para cada papel, contidas nos arquivos ASCII são: Ticker, ou o código do papel. Data do pregão. Cotação de abertura. Cotação máxima. Cotação mínima. Cotação de fechamento. Volume. No caso do ticker, para a geração dos arquivos ASCII, há a opção de se utilizar um código diferente do oficial dado pela BOVESPA ao papel, aqui chamado de formato "proprietário do Spero". Idealmente deveria ser utilizado, no formato MetaStock, o código oficial como o código do papel e o nome da empresa ou ação como o nome do papel. O formato MetaStock aceita as duas informações: symbol (código) e name (nome). Entretanto, o programa conversor The Downloader não aceita repassar estas duas informações, do formato ASCII para o formato MetaStock; o formato ASCII aceita apenas a informação do ticker que, ao ser levada para o formato MetaStock, torna-se tanto o symbol como o name do papel. Esta é uma limitação do formato ASCII utilizado pelo Downloader. Assim, uma vez que não é possível diferenciar, via conversão, o symbol do name, e é difícil reconhecer muitos papéis apenas pelo seu código oficial, foi criada uma regra de geração dos tickers que mistura o nome da empresa/ação com o código do papel. O tamanho final do ticker assim criado está limitado ao máximo de 14 caracteres, limitação esta da informação de symbol do formato MetaStock (a informação de name aceita uma quantidade maior de caracteres). É interessante saber que o Downloader não altera o valor do name, ao atualizar as cotações, se (a) o papel já existir no diretório de cotações e (b) se o name existente for diferente do valor do ticker repassado pelo arquivo intermediário (arquivo ASCII) gerado pelo conversor. O Downloader repassa o valor do ticker para o name apenas quando ele cria, do zero, um novo papel no diretório de cotações. Portanto, se o usuário do MetaStock/Downloader quiser, utilizando o Downloader, dar um name diferente para seus papéis (isso deve ser feito um a um, via Downloader) do valor do ticker originalmente criado, não haverá problema pois este novo valor de name não será, futuramente, alterado pelas atualizações do Downloader, com base nos arquivos ASCII gerados pelo conversor. O valor de name pode ter bem mais do que apenas 14 caracteres e pode descrever melhor o papel. As regras de criação dos tickers, quando optado pelo formato proprietário, dos arquivos ASCII gerados pelo Spero, são as seguintes: o código oficial do papel, que possui de 4 a 8 caracteres, ocupa os caracteres finais do ticker, sem qualquer alteração. os caracteres iniciais do ticker contêm, dentro da limitação de 14 caracteres, o que for possível informar sobre o nome da empresa/ação. entre a primeira parte do ticker (o que couber do nome da empresa/ação) e a segunda (o código oficial do papel) é colocado, como separador, o sinal de sublinhado "_". se o nome da empresa/ação contiver brancos eles são eliminados antes de fazer parte do início do ticker. se o papel não pertencer ao lote padrão é acrescentado um mnemônico do tipo de papel na primeira letra do ticker, a saber: c_ para as Concordatárias, r_ para os Direitos e Recibos, u_ para os Fundos e Certificados, b_ para os Bônus Privados, t_ para o mercado a Termo, o_ para as Opções de Compra, v_ para as Opções de Venda e f_ para o mercado Fracionário. Os demais dados contidos nos arquivos ASCII, como as cotações de abertura, fechamento, máxima e mínima são auto explicativos. Com relação aos dados de volume, eles podem corresponder tanto aos valores totais negociados em reais como às quantidades totais de ações negociadas, do respectivo papel, dependendo da configuração do usuário. Abaixo segue um extrato de um arquivo ASCII onde podem ser observados exemplos de tickers criados conforme as regras acima. <TICKER>,<PER>,<DTYYMMDD>,<TIME>,<OPEN>,<HIGH>,<LOW>,<CLOSE>,<VOL>,<O/I> IBOVESPA,D,980403,0,11854,11855,11493,11634,859177208,0 IEE,D,980403,0,2901,2906,2832,2846,55160509,0 IBX,D,980403,0,2328,2330,2270,2286,889846800,0 ACESITA_ACES3,D,980403,0,2.01,2.12,1.98,2.05,2105619,0 BELGOMIN_BELG4,D,980403,0,73.00,73.00,70.00,72.00,340096,0 CIMBRASI_SPCI4,D,980403,0,1.85,1.85,1.85,1.85,44400,0 FCATAGUA_FLCL5,D,980403,0,2.20,2.25,2.20,2.23,71493,0 LIGHTPAR_LIPR3,D,980403,0,301.00,304.00,298.00,302.00,2608086,0 SABESP_SBSP3,D,980403,0,260.00,265.00,260.00,260.00,2710236,0 SADIACON_SCON4,D,980403,0,0.84,0.85,0.83,0.85,1531560,0 TELEBRAS_TELB4,D,980403,0,143.00,143.30,138.52,141.50,526200324,0 r_TELEB_TELB10,D,980403,0,143.00,147.00,139.00,147.00,3293292,0 b_BRASI_BBAS11,D,980403,0,3.60,3.75,3.25,3.40,806984,0 o_TELE_TELBD59,D,980403,0,46.51,46.51,42.21,42.21,4310000,0
Para estes mercados, os arquivos ASCII contêm todos os códigos dos papéis que tiveram volume negociado maior do que zero. Além dos mercados acima, os arquivos ASCII contêm os dados diários dos índices BOVESPA - Ibovespa - de energia elétrica - IEE - e Brasil - IBX.
As informações, para cada papel, contidas nos arquivos ASCII são:
No caso do ticker, para a geração dos arquivos ASCII, há a opção de se utilizar um código diferente do oficial dado pela BOVESPA ao papel, aqui chamado de formato "proprietário do Spero". Idealmente deveria ser utilizado, no formato MetaStock, o código oficial como o código do papel e o nome da empresa ou ação como o nome do papel. O formato MetaStock aceita as duas informações: symbol (código) e name (nome). Entretanto, o programa conversor The Downloader não aceita repassar estas duas informações, do formato ASCII para o formato MetaStock; o formato ASCII aceita apenas a informação do ticker que, ao ser levada para o formato MetaStock, torna-se tanto o symbol como o name do papel. Esta é uma limitação do formato ASCII utilizado pelo Downloader. Assim, uma vez que não é possível diferenciar, via conversão, o symbol do name, e é difícil reconhecer muitos papéis apenas pelo seu código oficial, foi criada uma regra de geração dos tickers que mistura o nome da empresa/ação com o código do papel. O tamanho final do ticker assim criado está limitado ao máximo de 14 caracteres, limitação esta da informação de symbol do formato MetaStock (a informação de name aceita uma quantidade maior de caracteres).
É interessante saber que o Downloader não altera o valor do name, ao atualizar as cotações, se (a) o papel já existir no diretório de cotações e (b) se o name existente for diferente do valor do ticker repassado pelo arquivo intermediário (arquivo ASCII) gerado pelo conversor. O Downloader repassa o valor do ticker para o name apenas quando ele cria, do zero, um novo papel no diretório de cotações. Portanto, se o usuário do MetaStock/Downloader quiser, utilizando o Downloader, dar um name diferente para seus papéis (isso deve ser feito um a um, via Downloader) do valor do ticker originalmente criado, não haverá problema pois este novo valor de name não será, futuramente, alterado pelas atualizações do Downloader, com base nos arquivos ASCII gerados pelo conversor. O valor de name pode ter bem mais do que apenas 14 caracteres e pode descrever melhor o papel.
As regras de criação dos tickers, quando optado pelo formato proprietário, dos arquivos ASCII gerados pelo Spero, são as seguintes:
Os demais dados contidos nos arquivos ASCII, como as cotações de abertura, fechamento, máxima e mínima são auto explicativos. Com relação aos dados de volume, eles podem corresponder tanto aos valores totais negociados em reais como às quantidades totais de ações negociadas, do respectivo papel, dependendo da configuração do usuário.
Abaixo segue um extrato de um arquivo ASCII onde podem ser observados exemplos de tickers criados conforme as regras acima.
O formato do arquivo ASCII segue as instruções contidas na Ajuda do programa The Downloader. Se alguém quiser conhecer maiores detalhes sobre o formato, procure pelo tema ASCII Source File Layout, no conteúdo da Ajuda online do programa ou por ASCII: converting data, no índice da Ajuda do Downloader.
Nota Importante O conteúdo dos arquivos ASCII, conforme descrito neste tópico, pode sofrer alterações em função da personalização das opções de conversão selecionadas pelo usuário do conversor Spero, no diálogo de "Configuração da Conversão". Para maiores detalhes, após ler este Guia, consulte o Manual do Usuário do Conversor.
Configurando o Programa The Downloader Antes de converter os arquivos ASCII para o formato MetaStock, você precisa configurar adequadamente as opções de conversão do Downloader. Esta configuração deve ser feita uma única vez. Mesmo que você vá utilizar o acionamento remoto do Downloader, via conversor, é importante que, antes, você compreenda o processo de conversão e selecione as opções de conversão disponíveis no Downloader. Primeiramente, execute o programa The Downloader. Ele pode ser executado a partir do seu ícone próprio ou de dentro do MetaStock. Nota As figuras aqui mostradas referem-se à versão 6.0 do Downloader; entretanto, as diferenças em relação às versões mais modernas (por exemplo, a 6.52) são tão pequenas que é possível seguir este guia sem dificultar a compreensão. Já com o Downloader aberto, chame o diálogo de conversão Convert Securities. Você pode chamá-lo clicando no botão Convert, na barra de ferramentas (Toolbar), ou clicando no menu Tools e depois selecionando a opção Convert... . Deve aparecer um diálogo igual ao mostrado abaixo. As caixas de texto e as caixas de opções podem estar pré-preenchidas de forma diferente; você aprenderá como configurá-las no próximo tópico. No diálogo Convert Securities, clique no botão Options... para chamar o diálogo de opções de conversão Conversion Options. Ele está mostrado abaixo. O diálogo Conversion Options tem duas fichas: Source e Destination. Clique na aba da ficha Source, caso ela já não esteja ativa Na ficha Source, certifique-se de que a caixa First date: tenha uma data digitada nela (teoricamente, a data da ação mais antiga do seu diretório de ações; pode ser qualquer data anterior a essa também); certifique-se de que Use today's date esteja selecionado e que a Periodicity esteja selecionada como Dayly; Traverse source folders NÃO deve estar selecionado; é indiferente o que estiver constando em Message Limits assim como em Minutes per bar:, que provavelmente deve estar "acinzentado", ou seja, desabilitado, não selecionável. Clique na aba da ficha Destination para ativá-la.
Antes de converter os arquivos ASCII para o formato MetaStock, você precisa configurar adequadamente as opções de conversão do Downloader. Esta configuração deve ser feita uma única vez. Mesmo que você vá utilizar o acionamento remoto do Downloader, via conversor, é importante que, antes, você compreenda o processo de conversão e selecione as opções de conversão disponíveis no Downloader.
Primeiramente, execute o programa The Downloader. Ele pode ser executado a partir do seu ícone próprio ou de dentro do MetaStock.
Nota As figuras aqui mostradas referem-se à versão 6.0 do Downloader; entretanto, as diferenças em relação às versões mais modernas (por exemplo, a 6.52) são tão pequenas que é possível seguir este guia sem dificultar a compreensão.
Já com o Downloader aberto, chame o diálogo de conversão Convert Securities. Você pode chamá-lo clicando no botão Convert, na barra de ferramentas (Toolbar), ou clicando no menu Tools e depois selecionando a opção Convert... .
Deve aparecer um diálogo igual ao mostrado abaixo. As caixas de texto e as caixas de opções podem estar pré-preenchidas de forma diferente; você aprenderá como configurá-las no próximo tópico.
No diálogo Convert Securities, clique no botão Options... para chamar o diálogo de opções de conversão Conversion Options. Ele está mostrado abaixo.
O diálogo Conversion Options tem duas fichas: Source e Destination. Clique na aba da ficha Source, caso ela já não esteja ativa
Na ficha Source, certifique-se de que a caixa First date: tenha uma data digitada nela (teoricamente, a data da ação mais antiga do seu diretório de ações; pode ser qualquer data anterior a essa também); certifique-se de que Use today's date esteja selecionado e que a Periodicity esteja selecionada como Dayly; Traverse source folders NÃO deve estar selecionado; é indiferente o que estiver constando em Message Limits assim como em Minutes per bar:, que provavelmente deve estar "acinzentado", ou seja, desabilitado, não selecionável.
Nesta ficha, certifique-se de que Append data to end of file, Replace matching dates e Create new files estejam todos selecionados; Traverse destination folders NÃO deve estar selecionado; as opções de Fields to output são indiferentes (provavelmente devem estar "acinzentadas", ou seja, desabilitadas).
Com relação à opção Include Open & Open Interest, fica a seu critério selecioná-la ou não. Caso ela seja selecionada as informações de cotações de abertura dos papéis serão incluídas na base de dados em formato MetaStock; caso contrário, obviamente que não. Você somente teria motivo para não incluir as informações de abertura se pretender trabalhar com índices ou linhas de estudo que não necessitem delas. Normalmente, até mesmo por precaução quanto ao que você pode querer no futuro, deixe esta opção ticada.
Clique no botão OK para sair do diálogo Conversion Options e retornar ao diálogo Convert Securities. Clique no botão Cancel e saia deste último diálogo, ou passe para o próximo tópico para efetuar a sua primeira conversão.
Nota Mesmo que você opte por clicar no botão Cancel, após ter seguido todos os passos acima, você não estará cancelando as opções de conversão; elas já foram gravadas pelo Downloader no momento em que você clicou OK para sair do diálogo Conversion Options. Se estas opções não forem posteriormente alteradas manualmente, não será mais preciso se preocupar pois elas não se alteram por si só.
Convertendo os Arquivos ASCII
Para prosseguir com o este tutorial, precisamos fazer algumas suposições: vamos supor que você tenha uma pasta de trabalho (diretório, para os saudosistas) chamada Ibovespa, ligada ao seu diretório raiz do drive C:\; vamos supor que esta pasta Ibovespa tenha duas pastas ligadas a ela (subdiretórios) denominadas PRNs e DATs. A pasta PRNs terá por objetivo armazenar os arquivos ASCII que você gerou utilizando o conversor Spero; a pasta DATs será a pasta com as cotações da BOVESPA já convertidas para o formato MetaStock, ou seja, o diretório de cotações. A nossa suposta árvore de diretórios fica mais ou menos assim, no painel esquerdo do Windows Explorer:
Nota Importante Os nomes para as pastas de trabalho aqui sugeridos são meramente exemplificativos e servem apenas para explicar o processo manual de conversão do arquivo ASCII para o formato MetaStock. Ao utilizar o conversor Spero para automatizar o processo, você não terá a opção de escolher alguns dos nomes destes diretórios pois eles estarão estritamente ligados ao diretório onde o conversor foi instalado que é chamado de diretório de trabalho. Veja maiores detalhes no manual do conversor.
Coloque os arquivos ASCII gerados pelos conversor, na pasta C:\Ibovespa\PRNs\. Você pode colocar um ou vários arquivos ao mesmo tempo. O arquivo intermediário ASCII, que você colocou na pasta C:\Ibovespa\PRNs\ deve ter a extensão .PRN, ou seja, deve ter a seguinte estrutura de nome: Bdinmmdd.PRN, onde Bdin é um prefixo constante, mm significa o mês de referência e dd, o dia do mês.
Com as opções de conversão do Downloader já corretamente configuradas e os arquivos ASCII, gerados pelo conversor, já no diretório mencionado, para dar início ao processo de conversão acione novamente o diálogo de conversão do Downloader, Convert Securities, caso ele já não esteja ativo.
O diálogo de conversão possui dois grupos de informações: o grupo superior, denominado Source, e o inferior, denominado Destination. Ambos contêm exatamente as mesmas informações: tipo de arquivo (File type:), pasta ou diretório (Folder:), nome do arquivo (File name:) e um botão Procurar (Browse...). No primeiro grupo você preencherá as informações relativas aos arquivos de origem, ou arquivos fonte, no caso os arquivos ASCII gerados pelo conversor; o segundo grupo serve para você passar ao Downloader as informações dos arquivos de destino, no nosso caso, os arquivos em formato MetaStock.
No grupo Source, selecione, na caixa de opções File type:, o tipo ASCII Text. Clique no botão Browse... para acionar o diálogo de escolha dos arquivos de origem, Choose Source Files:
No diálogo Choose Source Files utilize a caixa de opções Examinar e direcione o foco do diálogo para o diretório C:\Ibovespa\PRNs\, onde encontram-se os arquivos ASCII; utilize a caixa de opções Arquivos do tipo: para selecionar o tipo ASCII Files (*.PRN), conforme mostrado na figura acima.
Uma vez enxergando os arquivos ASCII no quadro central do diálogo, selecione o arquivo ASCII que deseja converter; você pode também, utilizando as teclas Shift ou Control, ao mesmo tempo em que clica com o botão do mouse, fazer escolhas múltiplas, ou seja, de conversão de vários arquivos ASCII no mesmo processo, ao mesmo tempo.
Tendo selecionado os arquivos ASCII de interesse, seus nomes aparecerão na caixa de texto Nome do arquivo:. Se a escolha foi múltipla, os nomes aparecerão entre aspas. Clique no botão Abrir para sair deste diálogo.
De volta ao Convert Securities, no grupo Destination, selecione, na caixa de opções File type:, o tipo MetaStock. Na caixa de texto Folder: você deve digitar o nome completo da pasta de trabalho onde quer que as ações, já convertidas para o formato MetaStock, sejam armazenadas; em nosso exemplo, você deve digitar C:\Ibovespa\DATs\ . Não se preocupe em diferenciar letras maiúsculas de minúsculas. Se não quiser digitar, clique no botão Browse..., do grupo Destination, para acionar o diálogo de seleção do diretório de destino, Save, utilize a caixa de opções Salvar em:, direcione o foco do diálogo para o diretório C:\Ibovespa\DATs\ e clique no botão Save para sair deste diálogo.
O diálogo Convert Securities deve estar semelhante ao mostrado abaixo:
Pronto! Clique no botão OK e aguarde até que o Downloader faça e termine o seu trabalho. Nesse meio tempo o Downloader apresenta o diálogo de status da conversão, Convert Status.
A conversão de um arquivo ASCII leva alguns bons segundos, mesmo em computadores mais velozes, pois o Downloader tem de abrir e fechar centenas de arquivos, o que significa trabalho mecânico do disco rígido e contra isso não há Pentium II/III que resolva. A conversão de vários arquivos ASCII, ao mesmo tempo, aumenta proporcionalmente o tempo total de conversão. Se for uma conversão inicial, ou seja, direcionada para um diretório vazio, a conversão será mais lenta que as seguintes pois, nesta primeira conversão, o Downloader precisará não só abrir e fechar centenas de arquivos mas, também, criá-los.
Assim que o Downloader finaliza as conversões, ele apresenta um relatório de conversão, o Conversion Report, que merece alguma atenção.
O ponto mais importante do relatório é a mensagem que aparece no quadro Status Conversion: DEVE aparecer a mensagem Data Converted And Stored, comprovando que a conversão foi finalizada com absoluto sucesso.
Nota Avançada Se a mensagem acima não aparecer significa que algum erro ocorreu durante a conversão. Foge ao escopo deste tutorial informar o que deve ser feito, caso isto ocorra. Apenas como passo inicial, verifique, no quadro Securities, quais ações tiveram erro durante a conversão; elas terão um X vermelho ou um triângulo amarelo do lado esquerdo do nome, e não o tique verde. Selecione as ações, uma por vez, e clique no botão Details... para ter um relatório do erro. A partir daí, é por sua conta. Afirmo apenas que dificilmente, se ocorrer algum erro, ele será por culpa do arquivo ASCII; mas, por desencargo de consciência, você pode dar uma olhada dentro do arquivo ASCII, utilizando qualquer editor de texto, e verificar se o formato dele está de fato em acordo com as especificações do Downloader.
Com isso finaliza-se a conversão. Clique no botão Close para fechar o relatório de conversão, feche o Downloader, se não for mais utilizá-lo, execute o programa MetaStock e abra as ações, que se encontram na pasta de ações C:\Ibovespa\DATs\, para análise, diversão e ganhar muito dinheiro.
Numa próxima conversão manual, supondo que os arquivos ASCII sejam armazenados sempre na mesma pasta, você não precisaria preencher todo o diálogo de conversão novamente. Ele já estará pré-preenchido com as informações da última conversão realizada e você terá de atualizar apenas o nome do arquivo ASCII.
Comentários Finais
O tutorial acima tentou demonstrar como fazer uma conversão manual de um ou mais arquivos ASCII para o formato MetaStock. Na realidade, utilizando o conversor Spero, é possível - e desejável - automatizar todo o processo, desde a transferência do BDI zipado do site da Bovespa para o seu computador, via Internet, até a conversão final para o formato MetaStock, feita pelo Downloader, passando pela geração do arquivo ASCII Text e, opcionalmente, pelo armazenamento do BDI zipado em um diretório específico. O domínio do conhecimento de uma conversão manual é útil para compreender o que o conversor está fazendo e é necessário para quando você quiser fazer conversões múltiplas, ou seja, de mais de um arquivo ASCII ao mesmo tempo, via Downloader.
Os programas The Downloader e MetaStock têm um limite máximo de armazenamento de 2000 ações, em uma mesma pasta de trabalho. Como os arquivos ASCII gerados pelo conversor contêm informações de vários mercados, entre eles os de opções de compra e venda, há a possibilidade de, ao longo do tempo (um bom tempo...), o limite ser atingido. Por este motivo, você deve ficar atento a esta limitação, caso não efetue limpezas periódicas na pasta de ações. A Equis International, responsável pelo programa MetaStock, recomenda que se trabalhe com, no máximo, mil ações em uma mesma pasta de trabalho, pois, segundo ela, acima deste quantitativo há perda significativa de desempenho.
Agora que você já entendeu o que é e como utilizar um arquivo ASCII gerado pelo conversor Spero, aconselha-se a buscar maiores informações sobre o processo de automatização e funcionamento do conversor e o trabalho conjunto com o programa The DownLoader, no Manual do Usuário do Conversor Spero.
Atualizado em 25 de março de 2000.André Viol
Início
© 1998-2000 André Viol. Todos os direitos reservados.
