Sintaxe de ligações DDE do Gol 5.0

DDE (Dynamic Data Exchange) é o protocolo para troca de informações entre aplicativos no Windows. Através do DDE você pode usar informações do sistema Enfoque Cotações em outros programas (Excel, Visual Basic, Access etc), com atualização em tempo real. Este documento descreve o uso do servidor DDE do Gol 5.0. Os exemplos de fórmulas são para o MS Excel.

Gol serve DDE nos formatos TEXT, SILK e XLTABLE (formato nativo do Excel). A definição de uma ligação DDE inclui três partes: Aplicativo, Tópico e Ítem. O aplicativo é 'GOL'. O servidor DDE do Gol suporta 4 tópicos: ATIVO , COTação, SERIE e FORMULA. O Item varia com o tópico, conforme descrito abaixo.

Um link do tópico ATIVO consiste em um conjunto de cotações precedidas do código. Para colocar, por exemplo, o ativo GOLD no Excel:

A combinação de teclas [Ctrl-Shift-Enter] indica ao EXCEL que a fórmula deve ser inserida em uma matriz de células.
O resultado será:

Ou seja, um conjunto completo de informações sobre o ativo escolhido. A partir daí, as informações serão atualizadas on line. Para identificar o conteúdo das várias células de um ATIVO, use os cabeçários de Ativos.

No caso de link no formato TEXT, as cotações são separadas pelo caracter TAB. Neste caso, as cotações podem ser fornecidas em notação científica (default) ou com separador decimal, conforme configurado no GolEngine.

Para poder identificar o que contém cada célula de um ATIVO na planilha, dois ativos especiais são pré-definidos. Estes ativos contém os cabeçários de ações e mercadorias. Para usá-los no Excel, selecione algumas células na horizontal e digite:

=GOL|ATIVO!ACOES [Ctrl] [Shift] [Enter]
ou
=GOL|ATIVO!MERCS [Ctrl] [Shift] [Enter]

Isso mostrará os cabeçalhos para ações e mercadorias. No caso de mercadorias, o resultado na planilha será:

Em outros aplicativos, a sintaxe das ligaçoes DDE pode ser diferente. Consulte o Manual do programa que você usa para mais informações. Observe que, não importa qual programa você esteja usando, a definição de um link DDE sempre exige 3 partes: aplicativo, tópico e item.

Tipos de cotações válidos para uso em links do tipo COT e ATIVO. Notar que alguns tipos são válidos para apenas alguns ativos.

ULT	Último preço negociado	MED	Preço médio (1)
VAR	Variação do ativo (3)	AJU	Ajuste (2)
MAX	Preço máximo	VARAJU	variação % em relação ao ajuste (2)
MIN	Preço mínimo	VENC	Data do vencimento para opções e futuros (2)
HOR	Hora do último	OCn	Resumo - Preço da oferta de compra n (4,5,1)
FEC	Fechamento anterior	NOCn	Resumo - Numero de ofertas de compra n (4,5,1)
ABE	Abertura de hoje	QOCn	Resumo - Qde oferta de compra n (4,5,1)
QUL	Quantidade do último	OVn	Resumo - Preço da oferta de venda n (4,5,1)
NEG	Número de negócios	NOVn	Resumo - Numero de ofertas de venda n (4,5,1)
OCP	Melhor oferta de compra	QOVn	Resumo - Qde oferta de venda n (4,5,1)
VOC	Vol. da oferta de compra	LCCn	Livro - Núm. da corretora da oferta de compra n (4,6,1)
OVD	Melhor oferta de venda	LCCSn	Livro - Nome da corr. da oferta de compra n (4,6,7,1)
VOV	Vol. da oferta de venda	LQCn	Livro - Quantidade da oferta de compra n (4,6,1)
QTT	Quantidade total (títulos)	LPCn	Livro - Preço da oferta de compra n (4,6,1)
VARPTS	Variação em pontos	LCVn	Livro - Núm. da corretora da oferta de venda n (4,6,1)
VARPCT	Variação percentual	LCVSn	Livro - Nome da corr. da oferta de venda n (4,6,7,1)
MAXPTS	Máximo em pontos	LQVn	Livro - Quantidade da oferta de venda n (4,6,1)
MINPTS	Mínimo em pontos	LPVn	Livro - Preço da oferta de venda n (4,6,1)
MAXPCT	Máximo em %	ESPEC	Nome do ativo por extenso (7)
MINPCT	Mínimo em %	AJA	Ajuste anterior
CORC	num da corr. compradora	LOTE	lote mínimo negociado
CORV	num da corr. vendedora	FCOT	forma de cotação (R$/ X ações)
NAA	Número de altas (índices)	MAX52	Preço máximo das ultimas 52 semanas
NAB	Número de baixas (índices)	MIN52	Preço mínimo das ultimas 52 semanas
NAN	Número de estáveis (índices)	VOLFA	Volume financeiro anterior
VOLF	Volume financeiro de hoje	VH30	Volatilidade histórica de 30 dias (8)
DTUL	Data do ultimo negócio	VH45	Volatilidade histórica de 45 dias (8)
QTA	Qde total anterior	VH60	Volatilidade histórica de 60 dias (8)
TIPO	Tipo do papel	VH252	Volatilidade histórica de 252 dias (um ano) (8)
PMA	Preço médio anterior	PAPEL	Código do papel associado (p/ opções e futuros)
VARANO	Variação % no ano	NCC	Nome da corretora compradora (7)
VARMES	Variação % no mes	NCV	Nome da corretora vendedora (7)
VAR12	Variação nos últimos 12 meses	SETOR	Setor de atuação (7)
PERCP	% do tempo de pregão decorrida	SEG	Segmento de atuação (7)
VFPRJ	Volume fin. projetado para hoje	SUBS	Sub-segmento de atuação (7)
QTPRJ	Qde total projetada para hoje	DMX52	Data do máximo de 52 semanas
NSAQUES	Num de saques até venc. (BMF)	DMN52	Data do mínimo de 52 semanas
NDIASC	Num de dias corridos até vencimento (BMF)
NDIASU	Num de dias úteis até venc.(BMF)

No Gol 5.0, a sintaxe do tópico ATIVO foi expandida para permitir maior controle sobre os tipos mostrados na planilha. Caso você deseje especificar a lista de tipos do ativo retornados, digite o código do ativo seguido da lista de tipos separados por pontos, conforme o exemplo abaixo:

=GOL|ATIVO!IBOV.ESPEC.ULT.HOR.OCP.OVD

Isso retorna a matriz de tipos do ativo IBOV, conforme especificado. Observar que :

Você pode criar um range de células com mais de uma linha. Para isso use o tipo especial 'L' para pular para a próxima linha. O tipo 'B´ pula uma célula na horizontal. Exemplo:

Naturalmente que, no Excel, é necessário selecionar um range de 3 x 3 celulas, digitar a fórmula e completar com [Ctrl-Shift-Enter]. O processo é o mesmo para qualquer matriz de células e é necessário saber o tamanho do range de antemão.

Esse recurso de multiplas linhas é particularmente útil para mostrar o livro de ofertas online. Exemplo:

=GOL|ATIVO!tnlp4.espec.ult.L.lccs1.lqc1.lpc1.L. lccs2.lqc2.lpc2.L.lccs3.lqc3.lpc3.L.lccs4.lqc4.lpc4. L.L.lcvs1.lqv1.lpv1.L.lcvs2.lqv2.lpv2.L.lcvs3. lqv3.lpv3.L.lcvs4.lqv4.lpv4

Trabalhar com essas fórmulas grandes é tedioso e pode induzir erros de digitação. Por isso o Gol 5.0 introduziu a possibilidade de definir conjuntos de tipos nomeados. O conceito é simples: voce define uma lista de tipos que usa com freqüência e dá um nome a esta lista. Depois, basta digitar o código do ativo seguido do nome da lista. Exemplo:

Neste exemplo, as duas fórmula abaixo são equivalentes, embora a primeira seja muito mais simples de digitar:

LIVRO=ESPEC.ULT.VAR.L.LCCS1.LQC1.LPC1.L.LCCS2.LQC2.LPC2.L.LCCS3.LQC3.LPC3.L.CS4.LQC4.LPC4.L.
LCCS5.LQC4.LPC5.L.L.LCVS1.LQV1.LPV1.L.LCVS2.LQV2.LPV2.L.L.CVS3.LQV3.LPV3.L.LCVS4.LQV4.LPV4.L.
LCCS5.LQC4.LPC5

Os conjuntos de tipos são definidos no arquivo de configuração DDECotSets.txt, carregado no inicio do programa Gol. Com relação a DDECotSets.txt, observar que:

Dica: Para simplificar o processo de criação de links DDE no Excel, a Enfoque criou uma planilha com dois macros que digitam a fórmula e formatam as células. Essa planilha, juntamente com o arquivo de configuração DDECotSets.txt podem ser baixados pelo link abaixo:

> GOLDDEEXCEL.ZIP - 20 kb

Instruçoes de uso:

1- Unzipe o arquivo e coloque o arquivo DDECotSets.txt no diretório do GOL.

2- Coloque a planilha EnfoqueMacros.xls na pasta Meus Documentos. Se quiser que essa planilha seja carregada automaticamernte na inicialização do Excel, coloque-a na pasta \Office\XLStart\

3- Use nível de segurança médio ou baixo nos macros do Excel (médio recomendado). Para ajustar isso, use a opção do menu Ferramentas, Macros, Segurança.

4- Com o Gol funcionando, carregue a planilha EnfoqueMacros.xls no Excel. Aceite a execução do macro de inicialização. Um item Enfoque deverá aparecer no menu do Excel.

5- Crie uma nova planilha, mantendo a planilha EnfoqueMacros minimizada.

6- Para criar um flash de ativos formatado, digite o codigo de um ativo em uma célula e dê Enter

7- Ponha o cursor do Excel na célula com o código do ativo e use a opção Enfoque no menu do Excel ou as combinações teclas de atalho abaixo para disparar o macro de formatação:

[Ctrl-Shift-F] - Cria um flash (detalhe) do ativo
[Ctrl-Shift-L] - Cria o livro de ofertas (ações Bovespa)

Isso completará a fórmula e formatará o range de células na planilha. Esses macros foram desenvolvidos e testados no Office XP.

O tópico COT permite o uso de uma cotação de um ativo em fórmulas do EXCEL. Ao contrário do tópico ATIVO, os ítens do tópico COT devem ser usados em uma única célula. Exemplos:

A mesma sintaxe de fórmulas dos Ativos formulas e da calculadora do GOL, pode ser usada a partir de outros programas que suportem a comunicação DDE. Isto permite o acesso a ativos online e a bancos de dados históricos no formato Enfoque Sistemas (*.LP).

Na fórmula do Excel que segue, é calculada a valorização do ativo euspp desde a data 3/1/94 até hoje. =GOL|FORMULA!'euspp/euspp[3/1/94]'

É uma fórmula que mistura cotação online com dados históricos extraídos do arquivo EUSPP.LP. Observe que a fórmula está entre aspas. Isto por que nela aparecem letras que tem um significado semântico especial para o Excel.

Além dos objetos (ativos, series), voce pode incluir nas suas planilhas alguns resultados exibidos em páginas do Terminal Enfoque. Especificamente, páginas com modelo teórico de opções e livros de ofertas. Esses links são exportados via DDE como tabelas de valores, em forma tabular. Para incluir um grid em uma planilha faça:

1- Selecione um conjunto de celulas no Excel, de tamanho suficiente para conter o grid em questão (ou pelo menos o numero de linhas que você quer mostrar)

Esse procedimento cria um link atualizado em tempo real na planilha. Voce pode então usar os valores das células em suas fórmulas. Lembre-se de manter a página correspondente aberta no Enfoque enquanto estiver atualizando o Excel.

Histórico:
maio/05 - incluido topico GRID - ofr
jun/07 - adicionei novos tipos - ofr