Pular para o conteúdo principal

Apêndice II. Notas em Nuvem

Criando uma Nota​

Existem várias maneiras de criar uma nota em nuvem:

  1. Usando um Modelo .csv: Baixe o modelo aqui ou crie um arquivo .csv do zero.
  2. Usando o Modelo do Google Sheets: Acesse o modelo aqui.
  3. Criando uma Nota Personalizada no Bookmap e Exportando-a:
    • Este método é menos preferível porque as notas em nuvem e as notas personalizadas não são idênticas.
    • As notas em nuvem incluem uma coluna Diâmetro, enquanto as notas personalizadas não.

Descrição das Colunas de Notas​

Vamos revisar os principais recursos das notas em nuvem. Cada nota inclui as seguintes colunas:

  • Comando de Automap:
    Este comando é opcional e permite o uso do arquivo de notas para o mesmo instrumento em diferentes fornecedores de dados. Consulte a seção abaixo para mais detalhes.
  • Símbolo:
    O símbolo para o qual a nota será exibida.
    • Use o alias completo (por exemplo, ESH5.CME@RITHMIC) para precisão, ou apenas o símbolo (ESH5) se o automapeamento estiver habilitado.
  • Nível de Preço:
    O nível de preço ao qual a nota corresponde.
  • Nota:
    O texto da nota.
  • Cor do Primeiro Plano:
    A cor do texto em hexadecimal (por exemplo, #FFFFFF para branco).
  • Cor de Fundo:
    A cor de fundo em hexadecimal (por exemplo, #000000 para preto).
  • Diâmetro:
    Especifica quantos níveis a nota abrange. Por exemplo:
    • Um diâmetro de 3 significa que a nota abrange 3 níveis (1 nível acima e 1 abaixo do nível especificado).
    • Um diâmetro par (por exemplo, 4) resulta em mais níveis abaixo do que acima (por exemplo, 1 nível acima e 2 níveis abaixo).
  • Alinhamento do Texto:
    Alinhe o texto como esquerda, centro ou direita.
  • Desenhar Linha Horizontal no Preço da Nota:
    Se definido como TRUE, uma linha horizontal será desenhada no nível de preço especificado.

Considerações Importantes ao Criar uma Nota​

  • Certifique-se de que o arquivo esteja no formato CSV, com valores separados por vírgulas (não por ponto e vírgula ou outros separadores).
  • Use um ponto como separador decimal.
    • O Microsoft Office pode usar configurações regionais, o que pode causar problemas. Verifique o formato do arquivo abrindo-o como texto.
  • O símbolo e o nível de preço no arquivo devem corresponder ao formato na sua plataforma e no gráfico do Bookmap.
  • Campos opcionais (por exemplo, cor do texto, cor de fundo, alinhamento do texto) usarão valores padrão se deixados em branco.
  • Os valores de cor podem ser fornecidos como códigos hexadecimais (por exemplo, #FFFFFF) ou como nomes (por exemplo, "branco").
  • Considere arquivar sua nota no formato .gz (GZIP) que o Bookmap reconhece automaticamente. Arquivar é recomendado quando um arquivo contém mais de algumas dezenas de linhas e é distribuído por uma rede.

Usando o Comando Automap​

Automap é útil se você quiser importar ou compartilhar suas notas para o mesmo instrumento em diferentes fornecedores de dados. Em vez de listar o mesmo instrumento de diferentes fornecedores de dados, como mostrado abaixo:

Symbol,Price Level,Note,Foreground Color,Background Color,Text Alignment,Diameter,Draw Note Price Horizontal Line
ESH5.CME@BMD,5980,Venda,#ffffff,#FF0000,esquerda,,  
ESH5.CME@RITHMIC,5940,Compra,#ffffff,#FF0000,esquerda,,  
ESH5.CME@BMD,5980,Venda,#ffffff,#FF0000,esquerda,,`  
ESH5.CME@RITHMIC,5940,Compra,#ffffff,#FF0000,esquerda,,

Você pode encurtar usando #automap assim:

#automap RITHMIC,,,,,,,
Symbol,Price Level,Note,Foreground Color,Background Color,Text Alignment,Diameter,Draw Note Price Horizontal Line
ESH5,5980,Venda,#ffffff,#FF0000,esquerda,,  
ESH5,5940,Compra,#ffffff,#FF0000,esquerda,,

Notas para Usar o Automap:

  • É melhor usar fornecedores de dados incluídos no pacote de instalação do Bookmap (por exemplo, RITHMIC ou DxFeed). Para provedores instalados separadamente, o nome será assim EXT:com.bookmap.datadelivery.client.BookmapDataProvider e você precisa garantir que o adaptador de dados correspondente seja instalado por seus usuários.
  • Somente os fornecedores de dados que identificam instrumentos apenas pelo símbolo são suportados (por exemplo, o IB não pode ser usado, pois identifica os instrumentos por símbolo+exchange+tipo).
  • Se o automapeamento estiver habilitado, você deve usar o nome do símbolo que corresponde àquela plataforma na coluna de símbolos (por exemplo, ESH5, não ESH5.CME).
  • O automapeamento baseia-se em uma lista de símbolos mantida pelo Bookmap. Entre em contato com o suporte se algo estiver faltando.
  • Símbolos que não existirem para a plataforma especificada na diretiva automap não serão remapeados.

Carregando um Arquivo .csv​

Após criar o arquivo, envie-o para o seu local de nuvem preferido. Abaixo estão alguns métodos:

  1. Usando o Seu Próprio VPS ou Hospedagem:
    1. Este método é confiável, mas requer configuração adequada. Certifique-se de que o servidor permita links diretos e suporte clientes Java.
  2. Usando o GitHub:
    1. Crie um repositório, carregue o arquivo e obtenha o link bruto clicando no botão apropriado (por exemplo, https://raw.githubusercontent.com/svyatoslav-toder/cloud-notes-test/main/notes.csv).
    2. O GitHub é mais amigável para desenvolvedores em comparação com o OneDrive ou o Google Drive, tornando-o uma opção confiável.
  3. Usando Google Drive:
    1. Envie o arquivo, defina as permissões e copie o link para o arquivo.
    2. Use este serviço para gerar o link direto.

Notas:

  • Envie arquivos para servidores que fornecem links diretos. Um link direto baixa o arquivo imediatamente, sem redirecionamento. Por exemplo:
  • Um link http→https contará como um redirecionamento. Use o link https se o servidor redirecionar automaticamente.
  • Garanta permissões de arquivo adequadas para evitar problemas de acesso.
  • Esteja ciente de que o Google pode bloquear links em certas condições, tornando esse método menos de 100% confiável.

Usando Google Sheets​

Você pode criar uma nota usando o Google Sheets seguindo este modelo de exemplo:

  1. Vá para Arquivo > Compartilhar > Publicar na web.
  2. Selecione .csv no menu suspenso para o documento inteiro.
  3. Clique em Publicar para gerar um link direto.

Notas:

Esteja ciente de que o Google pode bloquear links em certas condições, tornando esse método menos de 100% confiável.

Última atualização em